swagger_parser

• Fixes dart_mappable enum generation for JSON Schema type lists by quoting
  non-numeric JSON values (#468).

• Fixes dart_mappable enum generation for JSON Schema type lists by quoting non-numeric JSON values (#468).

• Add preserve_schema_casing option to preserve original casing of schema-derived identifiers, defaults to false for backwards compatibility, which normalises to PascalCase
• Fix crash when a multipart/form-data request body references a schema without properties
• Fix nullable handling for single-element allOf, oneOf, and anyOf schemas with sibling nullable: true
• Fix missing imports for nested union properties in Freezed discriminated-union variants

• Adds preserve_schema_casing option to preserve original casing of schema-derived identifiers, defaults to false for backwards compatibility, which normalises to PascalCase.
• Fixes crash when a multipart/form-datarequest body references a schema withoutproperties.
• Fixes nullable handling for single-element allOf, oneOf, and anyOf schemas with sibling nullable: true.
• Fixes missing imports for nested union properties in Freezed discriminated-union variants.

• Fix escaping $unknown in generated enum toJson error messages
• Fix generated code when using json_serializable
• Fix default enum values for dart_mappable
• Add README section about Server-Sent Events

• Fixes escaping $unknownin generated enumtoJson error messages.
• Fixes generated code when using json_serializable.
• Fixes default enum values for dart_mappable.
• Adds README section about Server-Sent Events.

• Allow standard dart_mappable serializer method naming convention
• Fix default values for Enums in forms
• Fix errors with corrector

• Allows standard dart_mappable serializer method naming convention.
• Fixes default values for Enums in forms.
• Fixes errors with corrector.

• Support for streaming & SSE
• Fix preserve property names and required modifiers in properties blocks
• Fix API path definitions are incorrectly converted to PascalCase

• Adds support for streaming & SSE.
• Fixes preserve property names and required modifiers in properties blocks.
• Fixes API path definitions are incorrectly converted to PascalCase.

• Add field_parsers option for setting field parsers for JSON serializable

• Adds field_parsers option for setting field parsers for JSON serializable.

• Add include_paths option for filtering endpoints by paths
• Add generate_urls_constants option for generating URL constants for all endpoints

• Adds include_paths option for filtering endpoints by paths.
• Adds generate_urls_constants option for generating URL constants for all endpoints.

• Fixes client methods returning ModelNameUnioninstead ofModelNameSealed for oneOf types (#393).

• Handle request body name generation case when request body is declared within request
• Fix incorrect deserialization syntax for undiscriminated unions (Freezed serializer)

• Handles request body name generation case when request body is declared within request.
• Fixes incorrect deserialization syntax for undiscriminated unions (Freezed serializer).

• Add replacement_rules_for_raw_schema option for raw schema objects replacement rules

• Adds replacement_rules_for_raw_schema option for raw schema objects replacement rules.

• Fixes missing import for MultipartFile(#408).
• Fixes refs in components.responses.

• Add use_flutter_compute option for Flutter isolate-based multithreading support
  • Generates @RestApi(parser: Parser.FlutterCompute) annotation in Retrofit clients
  • Generates top-level serialization functions in each DTO model file following Retrofit's naming convention
  • Works with all serializers: freezed, json_serializable, dart_mappable

swagger_parser:
  use_flutter_compute: true

• Adds use_flutter_compute option for Flutter isolate-based multithreading support.
  • Generates @RestApi(parser: Parser.FlutterCompute) annotation in Retrofit clients.
  • Generates top-level serialization functions in each DTO model file following Retrofit's naming convention.
  • Works with all serializers: freezed, json_serializable, dart_mappable.

swagger_parser:
  use_flutter_compute: true

• Adds add_openapi_metadata(defaultfalse) to generate OpenAPI tags, operationId, and externalDocsUrlconstants for each endpoint; whenextras_parameter_by_defaultistrue, the metadata is also prefilled into Dio extras—handy for interceptors and logging without overwriting user-supplied extras.
• Uses fully-qualified default extras values (e.g. BannerApi.findAllBannersOpenapiExtras) so generated implementations can access the static metadata constants.

swagger_parser:
  extras_parameter_by_default: true
  add_openapi_metadata: true

abstract class PetsClient {
  static const Map<String, dynamic> listPetsOpenapiExtras =
      <String, dynamic>{
    'openapi': <String, dynamic>{
      'tags': <String>['pets'],
      'operationId': 'listPets',
      'externalDocsUrl': 'https://docs.example.com/pets',
    },
  };

  @GET('/pets')
  Future<void> listPets({
    // defaults to the OpenAPI metadata; merge with your own extras if needed
    @Extras() Map<String, dynamic>? extras =
        PetsClient.listPetsOpenapiExtras,
    @DioOptions() RequestOptions? options,
  });
}

# https://openapi.sepc/pets/listPets

• Fixes enum name values being an int returned in a toString.

• Fixes enum names generation.

• Adds infer_required_from_nullable.

infer_required_from_nullable: true

Schema without required array:
- id: type: integer → required int id
- name: type: string → required String name
- desc: type: string, nullable: true → String? desc

• Fixes nullable array item types generation.

• Adds includeIfNullhandling, disabled by default; setinclude_if_null: true to enable it.

• Fixes CHANGELOG duplication.

• Adds complete support for sealed classes (oneOf/anyOf) with the json_serializable serializer.
  • WARNING: Undiscriminated sealed classes use O(n) try-catch deserialization where n is the number of variants.
  • RECOMMENDED: Adds discriminator properties to your OpenAPI specification for O(1) performance.
  • Adds support for sealed classes fallback for failed decoding.
• Adds complete support for sealed classes (oneOf/anyOf) with the dart_mappable serializer.
  • WARNING: Undiscriminated sealed classes use O(n) try-catch deserialization where n is the number of variants.
  • RECOMMENDED: Adds discriminator properties to your OpenAPI specification for O(1) performance.
  • Adds support for sealed classes fallback for failed decoding.
• Adds dart_mappable_convenient_whenoption to control union type generation fordart_mappable serializer.
  • dart_mappable_convenient_when: truegenerates legacywhen<T>, maybeWhen<T> methods.
  • dart_mappable_convenient_when: false (default) generates sealed classes for better type safety.
• Adds the @Deprecated()annotation to thewhen<T>andmaybeWhen<T> methods for dart_mappable; use Dart pattern matching instead.
• Fixes duplicate unknownenum values fordart_mappable when unknown_enum_value: true is enabled.
• Fixes nullable discriminator union handling.

• Fixes resolve inline schemas nested within tagged operations.

• Adds support for merging all generated code into single output file using the merge_outputs option.

Features

• Adds support for non-discriminated unions (oneOf/anyOf without a discriminator).
• Filters out unused schemas when using include_tagsorexclude_tags.

Fixes

• Fixes the client name for untagged paths to properly fall back to the configured fallback_client instead of client.
• Fixes the fallback_clientconfiguration to default tofallbackinstead ofdefault to avoid conflicts with the Dart default keyword in the generated code.
• Fixes OpenAPI spec parsing to correctly preserve casing for SCREAMING_SNAKE_CASE.
• Fixes filtering so paths without tags are filtered out when include_tags is specified.

• Fixes documentation.
• Fixes ensure consistent file naming for tags with alphanumeric suffixes.

• Allows filtering generated client endpoints by tags.
• Adds a fallback client for endpoints without tags (#271).

• Fixes collisions between untagged endpoints and endpoints tagged Client that caused generated clients to overwrite each other.

• Aligns default value handling for parameters according to OpenAPi Spec https://swagger.io/docs/specification/v3_0/describing-parameters/#default-parameter-values.

• Adds a toStringoverride fordart_mappable.
• Makes dart_mappable toJson return a string.

• Allows using MultipartFileinstead ofFile in multipart requests, to support usage on web.

• Adds an enum toString() override that provides a JSON value to third-party consumers such as Retrofit.

• Adds the $valuesDefined getter to filter out unknown values automatically.

• Deduplicates property names for allOfschemas that mixrefandproperties, preventing naming overlaps.

• Fixes typedeftransparency that causes import errors when generatingjson_serializable classes; see google/json_serializable#1124.

• Removes duplicate parameters in dataclass(#322).

• Fixes detection of nullable list with non-null items vs nullable list with nullable items(#323).
• Requires Dart 3.6 or later.

• Fixes error with client parameters with $(#262).

• Updates dart_mappable template.

• Adds support for allOf composition and xOf (#239).
• Fixes nullable handling (#251).
• Makes list with null in items nullable.

• Adds supports for freezed 3.

• Adds supports oneOf polymorphic types with dart_mappable (#290).

• Adds x-enumNames(#289).
• Fixes errors with nullable in enums (#216).
• Fixes duplicate class generation when using discriminator (#300).

• Fixes errors with config(#293, #296).

• Adds use_x_nullable parameter to config(#295).
• Fixes error with config(#296).

• Fixes config properties inheritance with multi-scheme URLs(#293).

• Adds support for union types oneOf(#265, #286).
• Fixes config property inheritance.

• Fixes errors with config parsing.

• Adds validation params to generated freezed classes.
• Fixes errors with empty schema properties(#280).

• Fixes replacement rules for OpenAPI v2(#266).
• Adds x-nullable field for null definition in OpenAPI v2(#268).

• Fixes generation with anyOf, oneOfandallOf properties(#260).

• Adds version getter to root client:

final version = RestClient.version;

• Adds dio_options_parameter_by_default.

• Removes support of BigInt in Dart for int64 types.

• Adds support for int64 types.

• Fixes errors with nullable: false.
• Fixes same property name conflict(#235).

• Handles empty enum value case (#238).
• Fixes replacement rules.
• Adds support for nullable lists and maps.
• Removes the required_by_default config parameter; behavior now matches required_by_default: false.
• Requires Dart 3.4.

• Fixes unnecessary null types with required_by_default: false.
• Fixes generation of class parameters that are set directly from the request specification (#224).
• Fixes changing case and applying replacement rules to class names (#223).
• Generates maps with additionalProperties correctly (#214).

• Adds MappableField to dart_mappable template.

• Fixes error with nullable in multipart (#211).

• Adds new config parameter extras_parameter_by_default from retrofit 4.1.0 for (#208).
• Fixes errors (#190), (#192) and (#195).

• Fixes errors with required_by_default.

• Adds a temporary fix for #110.
• Ignores parameters start with x- for (#185).
• Fixes parameter type (#186.
• Fixes handle $ref (#187) and (#183).

• Adds new exceptions to export.
• Fixes file name from schemeUrl.