Ack 1.7.0-beta.4

All five packages are aligned at 1.7.0-beta.4: ack, ack_generator, ack_json_schema_builder, ack_mcp_dart, and ack_firebase_ai.

Changes

• Ack.fromJsonSchema() now validates the supported date-time format automatically. Unsupported format labels continue to produce diagnostics.
• Valid timestamps preserve their original text, including fractional precision, UTC offset, and announced leap seconds.
• Ack.string().datetime() now accepts lowercase t and z on announced leap seconds.
• The JSON Schema builder bridge inherits date-time validation when used with ack 1.7.0-beta.4 or later, without a new API or dependency minimum.

final timestamp = Ack.fromJsonSchema({
  'type': 'string',
  'format': 'date-time',
});
timestamp.parse('2024-02-29T12:34:56.123456789+02:00');

Ack's strict JSON Schema importer supports a documented subset; this release does not claim full JSON Schema Draft 2020-12 support.

Upgrading

No new generator or annotation migration is introduced in beta.4. When upgrading from beta.2 or earlier, the beta.3 breaking migrations still apply: annotations moved into ack, @Schemable() is the unified entry point, and JsonKey is no longer re-exported. See the repository changelog for the full migration details.

Validation

The reviewed release commit passed CI, browser tests, release preflight, schema validation, API compatibility checks, and zero-warning publish dry runs for all five packages.

Release commit: 0023d152288fb69b2967d230481fe8b681606d8b.

1.7.0-beta.3

• Remove the ack_annotations package; the annotations ship in ack. Models
  import package:ack/ack.dart (@Schemable, @AckField, @Optional,
  @Required, @NotNull). Files that use constraint annotations or the
  deprecated spellings also import package:ack/annotations.dart, with a
  prefix (as ack) where a name clashes with another type. Format
  annotations move to package:ack/format_annotations.dart.
• @Schemable() is the single annotation for schema-first and class-first
  generation. @AckInfer() and @AckModel() are deprecated and will be
  removed in 2.0.0.
• Rename @Pattern to @Matches. The deprecated Pattern alias stays in
  package:ack/annotations.dart; an unprefixed import of that library hides
  dart:core's Pattern.
• ack no longer depends on json_annotation or re-exports JsonKey. A field
  renamed with @JsonKey(name: ...) imports JsonKey from
  package:json_annotation and the app depends on json_annotation.
  AckModel.jsonSerializable and AckGeneratedJson.config are removed.
• A class-first field whose type declares a static schema resolves to it with
  no annotation, including extension types, enums, and generic types through a
  static schema<A>() method that can receive each type argument's schema.
• The generator rejects input that used to produce wrong or non-compiling
  output: types the annotated library cannot name, mismatched or generic
  @AckField(schema:) functions, non-finite constraint values, @Schemable
  options for the other target, and JsonConverter annotations on class-first
  models.
• Align all five publishable packages at 1.7.0-beta.3. The generator requires
  ack 1.7.0-beta.3.

Breaking

• copyWith on @AckInfer() and @AckModel() models is a getter that returns a typed $ClassCopyWith<Class> interface. A wrongly typed argument is now a compile-time error instead of a runtime TypeError. Omission still keeps the current value, and explicit null still clears a nullable field. Calls such as model.copyWith(name: 'x') are unchanged. Code that tears off copyWith as a function or mocks a model's copyWith method must be updated to use the getter. Arguments statically typed Object or an incompatible type must be narrowed or cast; dynamic arguments still compile.

Changed

• A model extending or implementing another generated class-first model, including an implicit sealed-union branch, exposes a copyWith interface compatible with the parent model's interface.
• A class-first Set field with @MinItems, @MaxItems, or @UniqueItems now requires unique items at the JSON boundary, so the list's item count matches the decoded set. Input with duplicate items, such as ['a', 'a'], now fails validation instead of collapsing into a smaller set, and the JSON Schema declares uniqueItems: true.
• Modern .ack.dart and .ack.g.dart parts start with // ignore_for_file: type=lint and // coverage:ignore-file, so consumer lint rules and coverage reports cover only hand-written source.
• Generated constructors, parsing and JSON members, $ack, and class-first facades now have doc comments.
• Requires ack and ack_annotations ^1.7.0-beta.2.
• Schema descriptions come only from description: or an @description doc tag. This replaces the unreleased development behavior that exported every field doc comment. Untagged prose and // comments never become schema data. Shared AckSchemaInference.applyDescription uses the same rule.

Added

• @AckInfer() models declare static final schema as a shorthand for $ack.modelSchema. The generator omits this member when schema conflicts with a field, discriminator, annotated declaration, or import prefix.
• Class-first generation supports explicit @AckModel and @AckField descriptions, plus single-line @description doc tags. Explicit annotation values take precedence. Class descriptions apply to the wire object and model codec; field descriptions apply only to that property.
• Class-first generation supports the new string format annotations.
• inference.dart exports shared type and constraint inference for other generators. The class-first generator uses this library.

Fixed

• Escape line terminators and other control characters in every generated string literal. @Pattern, discriminator, and key values containing a newline or carriage return now produce valid Dart source.

Ack 1.6.2

This coordinated release publishes ack, ack_annotations, ack_generator, ack_json_schema_builder, ack_mcp_dart, and ack_firebase_ai at version 1.6.2.

Fixed

• Ack.fromJsonSchema() now compiles the standard pattern keyword, restoring import of schemas exported from Ack. It uses an unanchored ECMA-262 search on strings and rejects invalid regular expressions at import time.

Added

• Ack.fromJsonSchema() now accepts the standard propertyNames keyword to validate each object key against its subschema. Both keywords round-trip through Draft-7 export unchanged.

The other five packages are version aligned and have no source or public API changes from 1.6.1. Compatible sibling dependency minimums remain unchanged.

See the publishing guide and changelogs for details.

What changed

• Honor effective nullability consistently across unions, defaults, boundaries, codecs, object properties, and list-item validation.
• Preserve encoder errors and their original stack traces through composite schemas.
• Keep runtime codec constraints out of exported wire schemas and surface them as export warnings.
• Preserve inferred nullability through codecs and transforms without changing the public codec factory API.

All six ACK packages are aligned at 1.6.1. See the core package changelog for compatibility details and migration guidance.

Changed

• Align with the coordinated Ack 1.6 release; this package has no runtime or public API changes from 1.5.0.

Added

• Infer open JSON class-first fields from their Dart types: Object → Ack.any(), Object? → Ack.any().nullable() (with the same presence annotations as String?), List<Object> → Ack.list(Ack.any()), and Map<String, T> → Ack.map(<schema for T>), including Map<String, Object?>. Map fields no longer require @AckField, which still overrides an inferred schema. dynamic, List<Object?>, and non-String map keys stay rejected; the dynamic error now suggests Object?.
• Accept Ack.any() and Ack.map(...) schema-first fields, inferring Object/Object? and Map<String, T>. Ack.any() and Ack.map() model roots stay rejected, including when reached through a variable.

Changed

• Require ack: ^1.5.0, because generated code now uses Ack.map.

Fixed

• Omit the redundant as Object? cast in generated copyWith bodies for Object? fields.
• Infer nullable Ack.map values when the value schema is a variable declared with .nullable(), such as Ack.map(nullableLabel).
• Keep generated code clean under --fatal-infos: fieldless class-first models no longer declare an unused self local, and nullable collection bridges use null-aware access.
• Generate compiling code for nullable class-first Set<T>? fields; the set codec now uses the non-null set type and presence adds nullability.

Ack 1.4.0

Ack 1.4 adds @Optional(), @Required(), and @NotNull() so class-first
models can override JSON key presence independently of whether a present
value may be null. @AckField(presence: ...) remains during migration
and is deprecated for removal in 2.0.0.

• Keep omit-vs-required separate from JSON null acceptance.
• Reject a present JSON null on a nullable Dart field with @NotNull().
• Generate copyWith from the constructor type so optional non-nullable
  codec fields compile and do not receive null.

All six packages use version 1.4.0: ack, ack_annotations, ack_generator,
ack_firebase_ai, ack_json_schema_builder, and ack_mcp_dart.
The runtime, Firebase, JSON Schema, and MCP packages have no runtime or
public API changes from 1.3.0.

Ack 1.3.0

Ack 1.3 adds ack_mcp_dart, a small adapter that uses one ACK input contract for
MCP tool discovery and runtime argument parsing with mcp_dart ^2.4.2.

• Advertise object schemas without maintaining a second schema renderer.
• Apply defaults, refinements, codecs, and typed model construction before tool callbacks.
• Return validation errors while keeping the session usable; suppress exception-backed diagnostics in default errors.
• Support empty-object tools and MCP 2026-07-28, 2025-11-25, and 2025-06-18.

All six packages use version 1.3.0: ack, ack_annotations, ack_generator,
ack_firebase_ai, ack_json_schema_builder, and ack_mcp_dart.
The existing five packages have no runtime or public API changes from 1.2.0,
and compatible dependency minimums remain at ^1.2.0.

Release tooling now uses Melos fixed versions and a shared workspace tag,
compares APIs with 1.2.0, and supports resuming a partially completed publication.

What's Changed

• docs: align contracts and Firebase fixture dependencies by @leoafarias in #126
• docs: clarify safeParse callback errors by @leoafarias in #127
• docs: improve project documentation by @leoafarias in #128
• ci: point workflows at the reusable repo's canonical owner by @leoafarias in #131
• feat(generator): add AckInfer and AckModel generation by @leoafarias in #133
• fix(ack): align numeric validation across platforms by @kauandotnet in #130
• fix(ci): provision pub.dev OIDC credentials by @leoafarias in #135
• fix(ci): preserve Flutter SDK during pub.dev auth by @leoafarias in #136

New Contributors

• @kauandotnet made their first contribution in #130

Full Changelog: v1.1.0...v1.2.0

Ack 1.1.0

Ack 1.1.0 is a correctness-focused release that aligns runtime validation,
generated schemas, and tooling with their documented contracts. It does not
change the public Dart API surface.

Validation and schema fixes

• Keep safeParse non-throwing for recoverable callback exceptions while
  preserving Dart Error values so programming defects remain visible.
• Bound direct, indirect, and wrapper-mediated lazy-schema recursion.
• Decode RFC 3339 date-times that use lowercase t and z separators.
• Validate multipleOf, IPv6, RFC 3339 date-times, range bounds, collection
  limits, unions, and enum definitions consistently with JSON Schema.
• Snapshot factory collections and correct schema/deep-collection equality.
• Preserve conflicting JSON Schema keywords through allOf, and export exact
  list/object sizes with the correct Draft-7 keywords.

Generator and tooling

• Reject nullable list element schemas during generation, matching Ack's
  runtime list contract.
• Use current source_gen diagnostics without undeclared debug-file output.
• Add stable full-output generator coverage.
• Make API checks, changelog updates, workspace setup, and root test orchestration
  fail truthfully instead of producing false-green results.

Behavior changes and migration notes

Although the public API is unchanged, invalid or ambiguous inputs that were
previously accepted may now fail earlier:

• Fix invalid schema definitions reported by construction-time ArgumentErrors.
• Put list nullability on the list (Ack.list(item).nullable()), not its item.
• Treat accumulated floating-point sums deliberately: round first or validate
  integer minor units such as cents before applying multipleOf.
• Refresh snapshots that assert the exact output of toJsonSchema().
• Expect AckException from parse() when a recoverable constraint or
  refinement callback throws; inspect the underlying cause for diagnostics.

See the package changelogs for the complete behavior notes.

Release v1.0.1

This patch hardens recursive schemas built with Ack.lazy against unbounded recursion.

Bug Fixes

• Recursion depth guard for Ack.lazy / LazySchema (#122): recursive schemas now
  enforce a maximum recursion depth (default 100) on parse, runtime validation, and
  encode. Previously, cyclic or arbitrarily deep input could recurse without bound and
  risk a stack overflow. Exceeding the limit now fails fast with a descriptive validation
  error (lazy_max_depth: "Maximum recursion depth (N) exceeded.") instead of crashing.

Improvements

• Ack.lazy(...) accepts an optional maxDepth (default LazySchema.defaultMaxDepth
  = 100; must be >= 1), carried through copyWith, equality, and serialization.
• JSON Schema export warns that the runtime-only maxDepth check can't be expressed via
  $ref and is omitted from the exported schema.

Behavior note: recursion is now capped at depth 100 by default. Structures that
legitimately nest deeper must pass an explicit higher maxDepth.

The other packages (ack_annotations, ack_generator, ack_json_schema_builder,
ack_firebase_ai) are version-aligned to 1.0.1 with no functional changes.

Ack 1.0.0

Ack 1.0.0 is the first stable release of Ack, a schema validation library for Dart and Flutter. Ack helps you validate untrusted data at application boundaries, reuse the same schemas across runtime validation and JSON workflows, and generate typed wrappers when you want stronger ergonomics than map access.

Start with the documentation site or jump straight into the Quickstart Tutorial.

What is included

• Fluent schema definitions for strings, numbers, booleans, objects, lists, enums, literals, unions, discriminated unions, and recursive schemas.
• Validation rules for common constraints such as string length, patterns, email, UUID, URI, numeric ranges, list length, uniqueness, and custom checks.
• Clear error handling through safeParse, SchemaResult, structured paths, and readable validation messages.
• JSON serialization workflows for validating decoded API responses and working with validated data safely.
• Codecs for bidirectional conversion between wire values and Dart runtime values, including dates, datetimes, URIs, durations, enums, and custom conversions.
• Type-safe schema generation with @AckType() for extension types, typed getters, parse, and safeParse.
• JSON Schema export through toJsonSchema() and the reusable schema-model boundary for adapter authors.
• Flutter form validation examples for using Ack schemas in form fields.
• Common recipes for API responses, reusable schemas, composition, enums, and other everyday validation tasks.
• API reference covering the stable surface in one place.

Packages

• ack: core runtime validation library.
• ack_annotations: @AckType() annotation package.
• ack_generator: build_runner generator for typed schema wrappers.
• ack_json_schema_builder: adapter for json_schema_builder.
• ack_firebase_ai: Firebase AI structured-output schema adapter.

For AI agents

Ack also publishes an llms.txt index with a compact overview of the packages, core APIs, code generation workflow, and common examples.

Release quality

This release was validated with the full package test suites, documentation checks, example tests, and pub.dev dry-runs before publishing. All five packages are now available on pub.dev at version 1.0.0.

ack 1.0.0-beta.12

ack

Breaking

• DoubleSchema and NumberSchema now reject non-finite values (NaN, Infinity, -Infinity) during runtime validation by default, aligning numeric schemas with JSON-safe values.
• Removed the retired JSON Schema DTO converter APIs.
• Replaced the interim JSON Schema model-kind API with sealed AckSchemaModel variants and a canonical AckSchema.toSchemaModel() adapter conversion.

Added

• Ack.enumCodec<T extends Enum>(List<T> values) returns a CodecSchema<String, T> wrapping EnumSchema<T>.
• NumberSchemaExtensions adds fluent numeric constraints to Ack.number(): .min, .max, .greaterThan, .lessThan, .positive, .negative, .multipleOf.

Changed

• Discriminated schemas are projected through union-owned discriminator branches.
• Defaults, const values, extension keywords, transformed metadata, composition, and JSON Schema constraints are preserved through the schema-model boundary.

Migration

• Re-run tests for code paths that parse or encode double/num values. If a boundary must accept NaN/infinities, model that value outside the JSON numeric schema path before validation.

ack_annotations

Breaking — Removed AckModel, AckField, and decorator annotations. Only @AckType() remains.

ack_generator

Breaking — Removed class-based schema generation. Only top-level @AckType() schema variables and getters are supported.

ack_firebase_ai

• Added toFirebaseAiResponseJsonSchema() for Firebase AI's GenerationConfig.responseJsonSchema path, plus committed golden fixtures and native fixture corpora.
• Removed typed Firebase AI Schema conversion APIs — use toFirebaseAiResponseJsonSchema() instead.

ack_json_schema_builder

• Routes conversion through ACK's sealed AckSchemaModel boundary and generic Draft-7 JSON Schema renderer; preserves defaults, const values, extension keywords, transformed metadata, and composition.
• Removed the retired JSON Schema DTO converter path.

All five packages are released in lockstep at 1.0.0-beta.12.

chore(release): bump to 1.0.0-beta.11 (#102)

docs: add ack package README for pub.dev (#98)

chore(release): bump to 1.0.0-beta.9 (#88)

• ack@1.0.0-beta.8
• ack_annotations@1.0.0-beta.8
• ack_firebase_ai@1.0.0-beta.8
• ack_generator@1.0.0-beta.8
• ack_json_schema_builder@1.0.0-beta.8

• See release notes for details.

Bug Fixes

• Primitives: Comprehensive fixes for primitives and correctness (#50).

Improvements

• Analyzer: Refactored field analyzer, model analyzer, and schema AST analyzer for correctness (#50).
• Builders: Improved type builder, field builder, and schema builder (#50).
• Generator: Centralized null/default handling in generator output (#65).
• AckType factories: Generate direct schema.parseAs(...) / schema.safeParseAs(...) calls and stop emitting _$ackParse / _$ackSafeParse helpers.

Features

• Doc comments: Support doc comments for schema descriptions (#61). Field and class doc comments are now used to populate schema descriptions.

Bug Fixes

• List types: Resolve list element types with method chain modifiers (#60). Fixed type resolution for complex list schemas with chained method calls.
• AckType casts: Fix @AckType schema ref casts and improve nested schema handling (#59).

Improvements

• Dependencies: Updated ack, ack_annotations, meta and test dependencies to latest versions (#56).

Bug Fixes

• Primitives: Comprehensive fixes for primitive schema generation and correctness.
• Typed list getters: Support Ack.list(schemaRef) for typed list getters (#47).
• Field descriptions: Add field descriptions to generated schema output (#44).
• Extension types: Generate extension types for all AckType schemas; skip for nullable AckType schemas.

Improvements

• Circular dependency handling: Improved circular dependency handling and reduced duplication.
• Analyzer compatibility: Updated for analyzer >=7.x <9 API changes (#41).
• Consolidated naming utilities: Removed duplicate naming utility functions.
• Documentation: Fixed stale documentation for extension type generation.

• REFACTOR: simplify validation workflow by eliminating duplicate nullable handling (#17). (71d694ab)
• REFACTOR: Improved json-schema support (#9). (d4da5d94)
• REFACTOR: consolidate constraint system and enhance validation pipeline (#8). (e6161a39)
• FEAT: add args getter for extension types with additionalProperties (#24). (3bf284ef)
• FEAT: simplify API compatibility checking with Dart script (#14). (d309f2c2)
• FEAT: prepare for 0.3.0-beta.1 release (#11). (af70b357)
• FEAT: Add discriminated union schema support with pattern matching (#6). (9c9aff3c)
• DOCS: Fix API inconsistencies across all documentation (#12). (2c57298b)

• See release notes for details.

• REFACTOR: Improved json-schema support (#9). (d4da5d94)
• REFACTOR: consolidate constraint system and enhance validation pipeline (#8). (e6161a39)
• FEAT: Add dart_mappable integration for seamless field name synchronization (#10). (66adc71c)
• FEAT: Add discriminated union schema support with pattern matching (#6). (9c9aff3c)

2025-06-19

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ack - v0.3.0-beta.1
• ack_example - v0.3.0-beta.2

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• ack_example - v0.3.0-beta.2

• Bump "ack" to 0.2.0-beta.1.

2025-05-02

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ack - v0.2.0