Merge branch 'master' into upgrade-5.0-start

Author: gibahjoe

README.md

@@ -79,7 +79,7 @@ Annotate a dart class with @Openapi() annotation
     inputSpecFile: 'example/openapi-spec.yaml',
     generatorName: Generator.dart,
     outputDirectory: 'api/petstore_api')
-class Example extends OpenapiGeneratorConfig {}
+class Example {}
 ```
 
 Run
@@ -126,7 +126,7 @@ New:
     cachePath: 'some/preferred/directory/cache.json',
     useNextGen: true
 )
-class Example extends OpenapiGeneratorConfig {}
+class Example {}
 ```
 
 **IMPORTANT** With the new changes comes 2 new annotation properties:

openapi-generator-annotations/lib/src/openapi_generator_annotations_base.dart

@@ -365,6 +365,11 @@ class AdditionalProperties {
   /// Allow the 'x-enum-values' extension for enums
   final bool? useEnumExtension;
 
+  /// With this option enabled, each enum will have a new case, 'unknown_default_open_api',
+  /// so that when the server sends an enum case that is not known by the client/spec,
+  /// they can safely fallback to this case
+  final bool? enumUnknownDefaultCase;
+
   /// Flutter wrapper to use (none|flutterw|fvm)
   final Wrapper wrapper;
 
@@ -387,6 +392,7 @@ class AdditionalProperties {
     this.allowUnicodeIdentifiers = false,
     this.ensureUniqueParams = true,
     this.useEnumExtension = false,
+    this.enumUnknownDefaultCase = true,
     this.prependFormOrBodyParameters = false,
     this.pubAuthor,
     this.pubAuthorEmail,
@@ -407,6 +413,7 @@ class AdditionalProperties {
           allowUnicodeIdentifiers: map['allowUnicodeIdentifiers'] ?? false,
           ensureUniqueParams: map['ensureUniqueParams'] ?? true,
           useEnumExtension: map['useEnumExtension'] ?? true,
+          enumUnknownDefaultCase: map['enumUnknownDefaultCase'] ?? true,
           prependFormOrBodyParameters:
               map['prependFormOrBodyParameters'] ?? false,
           pubAuthor: map['pubAuthor'],
@@ -428,6 +435,7 @@ class AdditionalProperties {
         'allowUnicodeIdentifiers': allowUnicodeIdentifiers,
         'ensureUniqueParams': ensureUniqueParams,
         'useEnumExtension': useEnumExtension,
+        'enumUnknownDefaultCase': enumUnknownDefaultCase,
         'prependFormOrBodyParameters': prependFormOrBodyParameters,
         if (pubAuthor != null) 'pubAuthor': pubAuthor,
         if (pubAuthorEmail != null) 'pubAuthorEmail': pubAuthorEmail,
@@ -512,6 +520,7 @@ class DioProperties extends AdditionalProperties {
       bool sortModelPropertiesByRequiredFlag = true,
       bool sortParamsByRequiredFlag = true,
       bool useEnumExtension = true,
+      bool enumUnknownDefaultCase = true,
       String? sourceFolder,
       Wrapper wrapper = Wrapper.none})
       : super(
@@ -529,6 +538,7 @@ class DioProperties extends AdditionalProperties {
             sortParamsByRequiredFlag: sortParamsByRequiredFlag,
             sourceFolder: sourceFolder,
             useEnumExtension: useEnumExtension,
+            enumUnknownDefaultCase: enumUnknownDefaultCase,
             wrapper: wrapper);
 
   DioProperties.fromMap(Map<String, dynamic> map)
@@ -587,6 +597,7 @@ class DioAltProperties extends AdditionalProperties {
       bool sortModelPropertiesByRequiredFlag = true,
       bool sortParamsByRequiredFlag = true,
       bool useEnumExtension = true,
+      bool enumUnknownDefaultCase = true,
       String? sourceFolder,
       Wrapper wrapper = Wrapper.none})
       : super(
@@ -604,6 +615,7 @@ class DioAltProperties extends AdditionalProperties {
             sortParamsByRequiredFlag: sortParamsByRequiredFlag,
             sourceFolder: sourceFolder,
             useEnumExtension: useEnumExtension,
+            enumUnknownDefaultCase: enumUnknownDefaultCase,
             wrapper: wrapper);
 
   DioAltProperties.fromMap(Map<String, dynamic> map)