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.

Changed

• Align with the coordinated Ack 1.7.0 beta. This package has no source or public API changes from 1.6.2; compatible dependency minimums are preserved.

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.

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.

Changed

• Updated dependency on ack to v1.0.0-beta.6

Changed

• Updated dependency on ack to v1.0.0-beta.5
• Updated meta and test dependencies to latest versions (#56)

Fixed

• Preserve nullable metadata in firebase ai converter (#36)