Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.0 - 2026-03-12

Discriminated unions — new :discriminated_union type selects a schema variant based on a discriminator field value, for polymorphic JSON APIs.
Literal type — new :literal type for exact value matching.
Field aliases — :alias option on field definitions maps canonical Elixir keys to different external string keys; the validator checks both names and the transform module can output aliased keys.
Pre-validate hook — schema-level :pre_validate function transforms raw input before standard validation begins.
Per-field validators — :validate option runs custom functions after type checks for field-level logic and transformation.
JSON Schema generation now emits oneOf with discriminator mappings and supports property name overrides for aliases.
New test suites for discriminated unions, field aliases, field validators, and pre-validate hooks.

Added comprehensive documentation guides (getting started, schema definition, validation, JSON schema, JSON serialization, DSPEx integration).
Enhanced ExDoc configuration with grouped extras, module categories, and additional output formatters.
Upgraded jsv dependency from ~> 0.13.1 to ~> 0.16.0.
Upgraded nimble_options from ~> 1.0 to ~> 1.1.
Upgraded ex_doc from ~> 0.34 to ~> 0.40.1.
Upgraded stream_data from ~> 1.1 to ~> 1.3, mix_test_watch to ~> 1.4, excoveralls to ~> 0.18.5, benchee to ~> 1.5.
Updated credo, dialyxir, and supporting libraries to latest stable releases.
Added castore as a test-only dependency for certificate handling.
Replaced length(list) > 0 with list != [] for O(1) emptiness checks in dspex.ex and performance.ex.
Moved preferred_cli_env settings into a dedicated cli/0 function in mix.exs following current Elixir best practices.

String-keyed schema fields and nested object schema DSL (Schema.object/1).
Built-in format types (:date, :datetime, :uuid, :null, {:nullable, type}).
JSON encode/decode helpers with transform pipeline (Sinter.JSON, Sinter.Transform, Sinter.NotGiven).
Example runner examples/run_all.sh and refreshed example suite.

Big-bang refactor of core schema/validation architecture per technical design.
JSON Schema validation now uses jsv 0.13.1 with Draft 2020-12 default and Draft 7 provider support.
Provider JSON Schema generation applies strictness recursively for nested objects.
Schema inference avoids atom leaks by defaulting to string keys.

Switched JSON Schema validation to ex_json_schema v0.11.2.
Updated generated $schema to JSON Schema Draft 7 for validator compatibility.
Removed custom JSON Schema structural validation helpers in favor of meta-schema validation.

Initial release of Sinter
Unified schema definition, validation, and JSON generation for Elixir
Core features:
- Unified schema definition with Sinter.Schema.define/2
- Single validation pipeline with Sinter.Validator.validate/3
- JSON Schema generation with Sinter.JsonSchema.generate/2
- Dynamic schema creation for frameworks like DSPy
- Schema inference from examples
- Schema merging for composition
- Provider-specific JSON Schema optimizations
Convenience helpers:
- validate_type/3 for one-off type validation
- validate_value/4 for single field validation
- validate_many/1 for multiple value validation
Compile-time macro support with use_schema
Comprehensive example suite
Full test coverage
Documentation and API reference