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.

Changed

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

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.

Improvements

• AckType: Refined annotation parameters and improved type handling (#50).
• AckField: Improved field annotation correctness (#50).
• Breaking: AckField.required was replaced by requiredMode (AckFieldRequiredMode.auto|required|optional). Migrate @AckField(required: true) to @AckField(requiredMode: AckFieldRequiredMode.required) and required: false to requiredMode: AckFieldRequiredMode.optional.

Improvements

• Documentation: Fixed broken links and added missing API documentation (#57).
• Dependencies: Updated meta dependency to latest version (#56).

• Dependency version bump to align with ack v1.0.0-beta.4.

• 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.