openapi_sdk_gen changelog

2.6.3 #

explicit_nulls applies only to schemas referenced from operation request bodies. Those optional nullable fields use JsonNullable<T> (undefined, of(value), of(null)). patch(Map) remains for dynamic payloads. Generated models/json_nullable.dart.

2.6.2 #

explicit_nulls DTOs no longer accept PATCH/nullable fields on the public constructor (passing null used to clear those fields). Set them via fromJson or patch instead.
Add generated patch factory alias for explicit_nulls json_serializable DTOs.

2.6.1 #

Stop treating optional properties as nullable. JSON null is recorded only when the schema allows it (nullable, x-nullable when use_x_nullable is on, or a null union member).
explicit_nulls now tracks only those nullable fields. Other optional fields omit null, including dynamic and when include_if_null is off.
Promote optional List<T?> and Map<String, dynamic> fields, and optional request parameters (including ones with defaults), so the Dart type stays nullable when the value itself cannot be JSON null.
Null-check freezed validators on optional fields that were promoted to a nullable Dart type.

2.6.0 #

Skip path-item summary, description, and $ref instead of crashing.
Throw on circular allOf instead of recursing forever.
Stop treating every field as required when one property uses allOf.
Collapse scalar $ref unions, including OpenAPI 3.1 type arrays, to string typedefs.
Infer a discriminator mapping from schema names when mapping is omitted.
Expand allOf multipart bodies into form parts.
Resolve components/responses $refs before choosing the return type.
Treat additionalProperties: true as Map<String, dynamic>.
Keep inherited field requiredness on a single-$ref allOf wrapper.
Keep $refs pointed at the schema whose key was actually renamed when two names share a PascalCase form.
Decode optional nested explicit_nulls fields in json_serializable instead of passing the raw JSON value through _omit.
Escape $, \, and ' in explicit_nulls JSON key lookups.
Promote optional dart_mappable fields to nullable, and stop marking optional union properties as required.
Apply include_if_null to optional fields that were promoted to nullable.
Return the wire type from dart_mappable enum toJson().
Keep the original JSON on freezed fallback union variants, and rename factory names that are Dart keywords.
Keep Retrofit parameters that share a name by suffixing later ones with their location.
Omit the generated-file banner when mark_files_as_generated is false.
Exit 2 when any schema fails to generate.

2.5.3 #

Generate string typedefs for scalar unions (anyOf string|integer and type: ["string", "number"]) instead of empty classes or dynamic.

2.5.2 #

Fix literal default values on nullable $ref properties that point at non-enum schemas.

2.5.1 #

Fix literal default values on $ref properties that point at non-enum schemas.
Fix _omit sentinel placement so it is emitted after the part directive in explicit_nulls json_serializable DTOs.

2.5.0 #

Add explicit_nulls so optional fields keep PATCH omit-vs-null semantics in json_serializable toJson().

2.4.0 #

Fix json_serializable union deserializers to match non-string discriminator value.

2.3.2 #

Fix discriminated and undiscriminated union wrapper classes to honor include_if_null annotations on nullable fields.

2.2.0 #

Fix handle nullable multipart properties, byte-as-string type mapping, and enum keyword protection.
Fix remove Base64Converter from all templates, update golden files for byte-as-String.
Fix enum toJson returns raw type instead of String for non-string enums.

2.0.4 #

Add support for Rust serde(tag = 'discriminator_key') discriminator pattern of enums
Add support for x-enum-varnames extension (OpenAPI Generator style custom enum names)
Add support for x-enum-descriptions extension (doc comments for enum values)
Fix enum default value resolution when using x-enumNames or x-enum-varnames

2.0.3 #

Fix missing @JsonKey/@MappableField annotation when field names are renamed due to Dart reserved word conflicts in discriminated/undiscriminated union wrapper classes

2.2.0 #

Support for Rust/utoipa discriminator pattern in oneOf schemas
- Detects oneOf with allOf items containing $ref + anonymous discriminator object
- Automatically extracts discriminator property from inline objects with single-value enums
- Generates proper sealed/union classes for utoipa-style OpenAPI specs
Code formatting with dart_style (page_width: 80, trailing_commas: preserve)

2.1.0 #

SSE streaming support via text/event-stream content type
Binary streaming via application/octet-stream or x-streaming: true
Auto-detect discriminator for oneOf/anyOf from single-value enum properties
Simplified union class names (removed "Union" suffix and typedef wrapper)

2.0.2 #

Packages updated
Documentation improvements

2.0.1 #

Minor documentation fixes

2.0.0 #

Complete Rework #

Complete rework and refactor of swagger_parser with enhanced architecture, improved code organization, better maintainability and extensibility.

Removed Features #

The following features are no longer available:

Kotlin Support (language parameter): Multi-language support removed. Package now focuses exclusively on Dart code generation.
Replacement Rules (replacement_rules parameter): Regex-based name transformation removed in favor of improved automatic naming and conflict resolution. The generator now provides stable, predictable naming with built-in conflict detection and resolution, eliminating the need for user-defined regex transformations. Update your OpenAPI schema with proper component names instead of relying on post-generation transformations.

Simplified Configuration #

The following configuration options have been removed as they are now handled automatically with better defaults:

use_freezed3: Removed. Freezed 3.x is now the standard version supported.
use_multipart_file: Removed. File types are now handled automatically: MultipartFile for multipart requests, Uint8List for binary data in regular requests/responses. The dart:io File type is no longer used.
enums_to_json: Removed. Enum serialization now follows standard serializer patterns automatically.
enums_parent_prefix: Removed. Enum naming follows standard Dart conventions.
dart_mappable_convenient_when: Removed. Use Dart 3+ pattern matching instead of legacy when/maybeWhen methods.
fallback_client renamed to default_client: More intuitive naming for the client handling untagged endpoints.

Changed Defaults #

use_x_nullable: Changed from false to true (now respects x-nullable extension by default)
export_file: Changed from true to false

Migration Notes #

replacement_rules: The improved automatic naming system now handles name normalization and conflict resolution consistently. If you relied on replacement rules, update your OpenAPI schema component names to match your desired output. This ensures stable, predictable code generation.
language: kotlin: If you need Kotlin generation, consider using a Kotlin-specific OpenAPI generator such as openapi-generator.
Most other configurations will work without changes

1.34.0 #

includeIfNull handling, turned off by default, use include_if_null=true to enable

1.33.0 #

Support correct processing of nested allOf classes

1.32.1 #

Fix CHANGELOG duplication

1.32.0 #

Add complete sealed classes(oneOf/anyOf) support for json_serializeble serializer
- WARNING: Undiscriminated sealed classes use O(n) try-catch deserialization where n is the number of variants
- RECOMMENDED: Add discriminator properties to your OpenAPI specification for O(1) performance
- Add support for sealed classes fallback for failed decoding
Add complete sealed classes(oneOf/anyOf) support for dart_mappable serializer
- WARNING: Undiscriminated sealed classes use O(n) try-catch deserialization where n is the number of variants
- RECOMMENDED: Add discriminator properties to your OpenAPI specification for O(1) performance
- Add support for sealed classes fallback for failed decoding
Add dart_mappable_convenient_when option to control union type generation for dart_mappable serializer
- dart_mappable_convenient_when: true - generates legacy when<T>, maybeWhen<T> methods
- dart_mappable_convenient_when: false (default) - generates sealed classes for better type safety
Add @Deprecated() annotation to when<T>, maybeWhen<T> method with dart_mappable. Use dart pattern matching
Fix creating duplicated unknown property enum with dart_mappable and unknown_enum_value: true
Fix for handle nullable discriminator unions properly

1.30.1 #

Fix resolve inline schemas nested within tagged operations

1.30.0 #

Add support for merging all generated code into single output file using the merge_outputs option

1.29.0 #

Features #

Add support for non-discriminated unions (oneOf/anyOf without a discriminator)
Filter out unused schemas when using include_tags or exclude_tags

Fixes #

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

1.28.0 #

Fix documentation
Fix ensure consistent file naming for tags with alphanumeric suffixes

1.27.0 #

Allow to filter the generation of endpoints in a client by tags
Allow to define a fallback client for endpoints that do not have a tag - fixes [#271]

1.26.4 #

Allow the use of single MultipartFile arguments in multipart requests (requires retrofit_generator 10.0.1 or later)

1.26.3 #

Fix for the bug when untagged endpoints and tagged as Client will override each other which results in Client tagged overwritten during file creation

1.26.2 #

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

1.26.1 #

dart_mappable toString override
dart_mappable toJson return string

1.26.0 #

Add support for Freezed fallbackUnion parameter

1.25.1 #

Fix broken dart_mappable enum

1.25.0 #

Allow using MultipartFile instead of File in multipart requests, to support usage on web.

1.24.6 #

proper handling of binary responses aka file downloads, picked up from https://github.com/trevorwang/retrofit.dart/issues/503

1.24.5 #

enum toString() override implementation to provide a json value for third party consumers like retrofit

1.24.4 #

added generation of getter $valuesDefined to automatically filter out unknown values useful when we would like to list only values that we are aware about

1.24.3 #

Fixes allOf case when a mix of ref and properties could unintentionally result in naming overlap now we are deduplicating properties by name

1.24.2 #

Fixes typedef transparency which results in import errors when generating json_serializable classes read more details here https://github.com/google/json_serializable.dart/issues/1124

1.24.1 #

Remove duplicate parameters in dataclass(#322)

1.24.0 #

Fix detection of nullable list with non null items vs nullable list with nullable items(#323)
Bump Dart SDK to 3.6

1.23.2 #

Fixed error with client parameters with $(#262)

1.23.1 #

Update dart_mappable template

1.23.0 #

Support for allOf composition and xOf (#239)
Nullable fixes (#251)
Make list with null in items nullable

1.22.1 #

Add supports for freezed 3

1.22.0 #

Add supports oneOf polymorphic types with dart_mappable (#290)

1.21.4 #

Add x-enumNames(#289)
Fixed errors with nullable in enums (#216)
Fixed duplicate class generation when using discriminator (#300)

1.21.3 #

Fixed errors with config(#293, #296)

1.21.2 #

Add use_x_nullable parameter to config(#295)
Fixed error with config(#296)

1.21.1 #

Fixed config properties inheritance with multi-scheme urls(#293)

1.21.0 #

Add support for union types oneOf(#265, #286)
Fixed config property inheritance

1.20.1 #

Fixed errors with config parsing

1.20.0 #

Add validation params to generated freezed classes
Fixed errors with empty schema properties(#280)

1.19.2 #

Fix replacement rules for OpenAPI v2(#266)
Add x-nullable field for null definition in OpenAPI v2(#268)

1.19.1 #

Fix generation with anyOf, oneOf and allOf properties(#260)

1.19.0 #

Add version getter to root client:

final version = RestClient.version;

Add dio_options_parameter_by_default

1.18.3 #

Remove support of BigInt in Dart for int64 types

1.18.2 #

Added support for int64 types

1.18.1 #

Fix errors with nullable: false
Fix same property name conflict(#235)

1.18.0 #

Handle empty enum value case (#238)
Some fixes for the replacement rules
Support for nullable lists and maps
Remove config parameter required_by_default, behaviour is now consistent required_by_default: false
Requires Dart 3.4

1.17.3 #

Fixed unnecessary null types with required_by_default: false
Fixed generation of class parameters that are set directly from the request specification (#224)
Fixed changing case and applying replacement rules to class names (#223)
Maps with additionalProperties are now generated correctly (#214)

1.17.2 #

Add MappableField to dart_mappable template

1.17.1 #

Fixed error with nullable in multipart (#211)

1.17.0 #

Add new config parameter extras_parameter_by_default from retrofit 4.1.0 for (#208)
Fixed errors (#190), (#192) and (#195)

1.16.4 #

Fixed errors with required_by_default

1.16.3 #

Temporary fix for (#110)
Ignore parameters start with x- for (#185)
Fixed parameter type (#186
Fixed handle $ref (#187) and (#183)

1.16.2 #

Add new exceptions to export
Fixed file name from schemeUrl

1.16.1 #

Fix swagger_parser_pages (https://carapacik.github.io/swagger_parser)

1.16.0 #

Wrapping collections variable introduced replacing arrayDepth and mapType: this variable presents a list of all collections wrapping a type and will resolve them in order of appearance (#128)
Fixed error with required_by_default (#168)
Refactor config and rename parameters:
- squash_clients to merge_clients
- enums_prefix to enums_parent_prefix
- skipp_parameters to skipped_parameters
Remove config parameter put_in_folder

1.15.5 #

Support schema url without extension (#160)

1.15.4 #

Fix docs

1.15.3 #

Fixed errors with Object body in retrofit client (#110)

1.15.2 #

Fixed errors with enum names (#163), (#164)

1.15.1 #

Support for generation multipart request with ref (#154)

1.15.0 #

Add new config parameter required_by_default
Added template for E2E tests

1.14.2 #

Fixed errors with multipart (#144)

1.14.1 #

Removed check that would avoid generating a map when additional properties has a $ref value

1.14.0 #

Fixed error with empty content type
Fixed retrofit template
Remove special characters from tags
Add new config parameter skip_parameters
Extract schemes from url (#150)

1.13.1 #

Fixed error with path-level parameters cause crash (#147)
Fixed dart:io import in template

1.13.0 #

Added support for dart_mappable
Changed freezed schema property to json_serializer, which can be set to freezed, dart_mappable or json_serializable (default).
Fixed enum generation name that are defined inside an array

1.12.2 #

Fixes enum duplicate names (#140)

1.12.1 #

Fixed error with ref in a case other than PascalCase (#139)

1.12.0 #

Add new config parameter export_file

1.11.3 #

Fixed error with annotating client methods with the first specified content type header in OpenAPI V2 schemes if the specified one is not the default.

1.11.2 #

Add description of request parameters to the code docs

1.11.1 #

Fixed ref component being wrongly labeled as map
Fixed map components being assigned an import despite not needing one

1.11.0 #

Added unknown value to all enums to maintain backwards compatibility when adding new values on the backend
Add new config parameter unknown_enum_value (dart only) (#106)
Add new config parameter default_content_type
Support String values with spaces for enums (#127)

1.10.6 #

Fixed map objects parsing as separate entities (#124)

1.10.5 #

Fixed error with parsing dictionary objects (#113)

1.10.4 #

Fixed error with additionalProperties (#114)

1.10.3 #

Add new config parameter original_http_response (dart only) (#115)

1.10.2 #

Fix error in body with name in dart template

1.10.1 #

Fix error with query parameter named body (#108)

1.10.0 #

Support for generating schemes by url (see example)
Add new config parameter schema_url
Add new config parameter schema_from_url_to_file
Add new config parameter prefer_schema_source

1.9.2 #

Fix error with required in clients (#101)

1.9.1 #

Handling incorrect names for classes, enums and methods.
Additional name for unnamed models (#98)
Support for deprecated annotations for methods

1.9.0 #

Added display of generation statistics for each scheme and total
The command to start generation has been changed to dart run swagger_parser
Fix error with required params in unnamed classes (#98)
Fix error with missing File import (#101)

1.8.0 #

Multiple schemes support (see example)
Support for specifying nullable types via anyOf
Edit root client template
Add new config parameter root_client_name
Add new config parameter name
Add new config parameter put_in_folder
Add new config parameter squash_clients
Rename root_interface to root_client
Rename squish_clients to put_clients_in_folder

1.7.0 #

Add new config parameter mark_files_as_generated
Support of default values for ref enum types
Type support in one-element allOf, anyOf and oneOf

1.6.3 #

Fix error with allOf results in the schema with type object (#91)

1.6.2 #

Fix grouping words for abbreviations when special characters are present
Fix replacement type for enum classes
Takes case in replacement

1.6.1 #

Add summary of the methods to the code docs
Fix indents for multiline code docs
Add support for root client code docs

1.6.0 #

Add new config parameter path_method_name

1.5.3 #

Fix error with imports in dto component (#86)

1.5.2 #

Fix grouping words for acronyms and abbreviations (#85)

1.5.1 #

Fixed method name generation in a language other than English (#83)

1.5.0 #

Requires Dart 3.0 or later

1.4.0 #

By default value nullable and not required for process default values (#76)
Add support for common parameters for various paths (#78)

1.3.5 #

Fix default enum values in dto (#79)

1.3.4 #

Enum prefix only for variable type now

1.3.3 #

Fix error with unnamed classes uniques names (#74)

1.3.2 #

Fix error with replacement rules in allOf

1.3.1 #

Fix error with allOf (#72)

1.3.0 #

Add possibility to add enum prefix from parent component (#29). Change enums_prefix to true to enable this option

1.2.4 #

Fixed names for negative enum values

1.2.3 #

Fixed rename for enums (#69)

1.2.2 #

Fixed error with parse nullable item in array (#68)

1.2.1 #

Updated retrofit_generator dependency to 7.0.8 and added config option to generate .toJson() methods in enums (retrofit_generator will use .toJson() instead of .name in this case)

1.2.0 #

Updated retrofit_generator dependency to 7.0.7 and consequently removed unused .toJson() generated methods in enums

1.1.0 #

Add regex replacement for generated class names
Fixed error with null raw parameter in OpenApi v2 (#63)

1.0.7 #

Fixed classes as body parameters (#61)

1.0.6 #

Fixed generation default enum values (#58)
Add new keywords to check the name of variables

1.0.5 #

Fixed generation default enum values in client (#56)

1.0.4 #

Fixed parsing Body in OpenApi v2 (#53)
Add multiline comments (#54)
Fixed items name in enum generation (#55)

1.0.3 #

Fixed error with default value in dart json_serializable generation

1.0.2 #

Fixed error with application/x-www-form-urlencoded (#45)

1.0.1 #

Fixed error with nullable in array (#43)

1.0.0+1 #

Add root_interface option to web interface
Add topics

1.0.0 #

Require Dart >= 2.19
Add support for description annotation
Add root_interface option to generate root interface for all Clients
Refactor code related to nullable

0.10.3 #

Now uses ref to identify return type of client method if type also exists

0.10.2 #

defaultValue in dart class now generates in constructor
Fixed error with empty client_postfix

0.10.1 #

Fixed error with servers in requests (#32)
Use operationId for method name(if such a field exists)

0.10.0 #

Fixed error with enum values not parsed in object properties
Use 2xx codes if code 200 not found
nullable types are now supported

0.9.1 #

Use JsonEnum and JsonValue on generated enum

0.9.0 #

Single ref sibling elements are now defined as typedefs instead of generating excess classes
Fixed error with Null type with empty type in schema

0.8.1 #

Added DateTime to the format for processing types (#16)

0.8.0 #

Support for dio 5
Downgraded the lower bound of dependencies to support Flutter 3.0
Complete templates for Kotlin

0.7.0 #

Fixed error with import for File type
Add support for additionalProperties annotations
Fixed templates
Fixed error with yaml files

0.6.4 #

Update example
Remove implicit_dynamic field for analyzer

0.6.3 #

Fixed error with return type in rest client

0.6.2 #

Update docs

0.6.1 #

Fixed error with Multipart file type in retrofit
Update dart api docs
Update web interface

0.6.0 #

Add support for yaml files
BREAKING: Rename json_path in pubspec.yaml to schema_path

0.5.1 #

Fixed problem with default value in freezed template

0.5.0 #

Objects are now recognized and are being generated as DTOs
Fixed some problems with defaultValue
Fixed some problems with return type
Fixed some problems with naming parameters whose names are similar to dart keywords

0.4.1 #

Fixed a problem with parameters whose names are similar to dart keywords
Fixed a problem with postfix in file import

0.4.0 #

Add support for default annotations
Add enum support for dart
Fixed errors with Multipart
Fixed errors with Kotlin types

0.3.1 #

Fixed error with @ in url path
Fixed the problem with number type to map double
Fixed the problem with object type to map Dart Object
Updates the README with instructions and steps to generate the code

0.3.0 #

Add support for required annotations
Fixed error with rest client parameters type in OpenApi v2

0.2.4 #

Fixed error with . and , in url path

0.2.3 #

Fixed error in MultiPart with single $ref

0.2.2 #

Remove swagger_parser section from pubspec.yaml
Update dependencies in example

0.2.1 #

Fixed README
Fixed workflow files

0.2.0 #

Fixed errors with generation of data classes containing allOf
Fixed errors with templates
Add web interface for package https://carapacik.github.io/swagger_parser
Add generator tests

0.1.0 #

Initial release

openapi_sdk_gen 2.6.3 openapi_sdk_gen: ^2.6.3 copied to clipboard

Metadata

2.6.3 #

2.6.2 #

2.6.1 #

2.6.0 #

2.5.3 #

2.5.2 #

2.5.1 #

2.5.0 #

2.4.0 #

2.3.2 #

2.2.0 #

2.0.4 #

2.0.3 #

2.2.0 #

2.1.0 #

2.0.2 #

2.0.1 #

2.0.0 #

Complete Rework #

Removed Features #

Simplified Configuration #

Changed Defaults #

Migration Notes #

1.34.0 #

1.33.0 #

1.32.1 #

1.32.0 #

1.30.1 #

1.30.0 #

1.29.0 #

Features #

Fixes #

1.28.0 #

1.27.0 #

1.26.4 #

1.26.3 #

1.26.2 #

1.26.1 #

1.26.0 #

1.25.1 #

1.25.0 #

1.24.6 #

1.24.5 #

1.24.4 #

1.24.3 #

1.24.2 #

1.24.1 #

1.24.0 #

1.23.2 #

1.23.1 #

1.23.0 #

1.22.1 #

1.22.0 #

1.21.4 #

1.21.3 #

1.21.2 #

1.21.1 #

1.21.0 #

1.20.1 #

1.20.0 #

1.19.2 #

1.19.1 #

1.19.0 #

1.18.3 #

1.18.2 #

1.18.1 #

1.18.0 #

1.17.3 #

1.17.2 #

1.17.1 #

1.17.0 #

1.16.4 #

1.16.3 #

1.16.2 #

1.16.1 #

1.16.0 #

1.15.5 #

1.15.4 #

openapi_sdk_gen 2.6.3
openapi_sdk_gen: ^2.6.3 copied to clipboard