easy_talk 3.0.0 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce558538c73afc10d98c0c6b5e38e68ce033a79d1c212bb91fede27f10fb3523
-  data.tar.gz: e46a7a67b6c1a3209108a800cefca8659381236c23ce14986e971babd874908d
+  metadata.gz: b77760f0bdffbb877509e133194733d397db6e5963b1484543791169db5dc840
+  data.tar.gz: 6e805469940229543c059952dc2311dd9acf7ea89ff45fde8b49b3e4d38dd85d
 SHA512:
-  metadata.gz: b523e6cd50edc0594d98fffdb8a9de0616e5f58a2af435a23e5f4a81ac54b25692cd0bccba71c93eca812022efd298b2a9d654b34e3b8f37301ea8e7b16a4de3
-  data.tar.gz: 7f287df819b0e09ddf5fce9506f045860dea876b0653cf7ede7dfb58e7a1d78e545933946921f0dfb4f1f02709357629f0b071c53e7c4ff945cdcf1908f5c2b6
+  metadata.gz: 5bf66646040995f9de8341e2a4e6ea63ae0c462a0f08f28779244e8eceff958e574042450a9a39cc2ef485e13d6c418e5f71296d6d8cc7e958339f432e84c572
+  data.tar.gz: 4c26c3bee7751682535f154efef1c4adb86cea08be6c6f09f9ebe08d6a2fde5604d71db884aa7f0de91787118f5bbb719028f8071ec4166ba69af7ad0d9b4ff1

data/.rubocop.yml

@@ -114,3 +114,7 @@ Lint/DuplicateBranch:
 
 Gemspec/DevelopmentDependencies:
   Enabled: false
+
+Naming/PredicateMethod:
+  Exclude:
+    - spec/support/schema_validation_matcher.rb

data/.yardopts

@@ -0,0 +1,13 @@
+--readme README.md
+--title "EasyTalk API Documentation"
+--markup markdown
+--output-dir docs/api
+--protected
+--no-private
+--hide-void-return
+--embed-mixins
+lib/**/*.rb
+-
+README.md
+CHANGELOG.md
+CONSTRAINTS.md

data/CHANGELOG.md

@@ -1,3 +1,108 @@
+## [3.2.0] - 2025-12-28
+
+### Added
+
+- **Pluggable Validation Adapter System**: Complete overhaul of the validation layer to make it a distinct, pluggable component (#89)
+  - New `EasyTalk::ValidationAdapters::Base` abstract class defining the adapter interface
+  - New `EasyTalk::ValidationAdapters::Registry` for adapter registration and lookup
+  - New `EasyTalk::ValidationAdapters::ActiveModelAdapter` as the default adapter
+  - New `EasyTalk::ValidationAdapters::NoneAdapter` for schema-only use cases
+  - Per-model validation configuration: `define_schema(validations: false)`, `define_schema(validations: :none)`, or `define_schema(validations: CustomAdapter)`
+  - Per-property validation control with `validate: false` constraint
+  - Global configuration via `config.validation_adapter = :active_model`
+
+- **Schema-Only Module**: New `EasyTalk::Schema` module for schema generation without ActiveModel (#89)
+  - Does not include `ActiveModel::API` or `ActiveModel::Validations`
+  - Ideal for API documentation, OpenAPI specs, and schema-first design
+
+- **Pluggable Type Registry**: Runtime registration of custom types with their corresponding schema builders (#80)
+  - New `EasyTalk::Builders::Registry` class with `register`, `resolve`, `registered?`, `unregister`, `registered_types`, and `reset!` methods
+  - Added `EasyTalk.register_type` convenience method at module level
+  - Added `config.register_type` for configuration block registration
+  - Allows extending EasyTalk with custom types (e.g., Money, GeoPoint) without modifying gem source
+
+- **Robust Type Introspection**: New `TypeIntrospection` module replacing brittle string-based type detection (#83)
+  - Predicate methods: `boolean_type?`, `typed_array?`, `nilable_type?`, `primitive_type?`
+  - Helper methods: `json_schema_type`, `get_type_class`, `extract_inner_type`
+  - Uses Sorbet's type system properly instead of string pattern matching
+
+- **Standardized Validation Error Output**: Helper methods for API-friendly error formats (#88)
+  - **Flat format**: Simple array of field/message/code objects
+  - **JSON Pointer (RFC 6901)**: Paths like `/properties/name`
+  - **RFC 7807**: Problem Details for HTTP APIs
+  - **JSON:API**: Standard JSON:API error format
+  - Instance methods: `validation_errors(format:)`, `validation_errors_flat`, `validation_errors_json_pointer`, `validation_errors_rfc7807`, `validation_errors_jsonapi`
+  - Configuration options: `default_error_format`, `error_type_base_uri`, `include_error_codes`
+
+- **Naming Strategies**: Support for automatic property name transformation (#61)
+  - Built-in strategies: `CAMEL_CASE`, `SNAKE_CASE`
+  - Optional `as:` property constraint for per-property name override
+  - Per-schema configuration: `define_schema { naming_strategy :camel_case }`
+  - Global configuration: `config.naming_strategy = :camel_case`
+
+- **Array Composition Support**: `T::AnyOf`, `T::OneOf`, and `T::AllOf` now work with `T::Array` (#63)
+  - Example: `property :items, T::Array[T::OneOf[ProductA, ProductB]]`
+
+- **Nested Model Validation in Arrays**: Arrays of EasyTalk::Model objects are now recursively validated (#112)
+  - Hash items in arrays are auto-instantiated to model instances
+  - Errors from nested models are merged with indexed paths (e.g., `addresses[0].street`)
+
+### Changed
+
+- **Deprecated `EasyTalk::ValidationBuilder`**: Use `EasyTalk::ValidationAdapters::ActiveModelAdapter` instead (deprecation warning shown on first use)
+
+### Fixed
+
+- **Default Value Assignment**: Default values are now properly assigned during initialization (#72)
+- **Explicit Nil Preservation**: Explicitly passed `nil` values are preserved instead of being replaced with defaults (#79)
+- **Optional Enum Validation**: Allow `nil` for optional properties with enum constraints (#64)
+- **Optional Pattern Validation**: Allow `nil` for optional properties with pattern validation (#65)
+- **Optional Format Validation**: Allow `nil` for optional properties with format validation (email, uri, uuid, etc.) (#75)
+- **Optional Length Validation**: Allow `nil` for optional properties with length constraints (#76)
+- **Schema Definition Mutation**: Avoid mutating schema definition during property building (#95)
+- **Unknown Property Types**: Fail fast with `UnknownPropertyTypeError` instead of silently returning 'object' (#97)
+- **respond_to_missing?**: Fixed `respond_to_missing?` implementation for additional properties (#98)
+- **VALID_OPTIONS Mutation**: Avoid mutating `VALID_OPTIONS` constant in TypedArrayBuilder (#99)
+- **Registry Reset**: `ValidationAdapters::Registry.reset!` now repopulates defaults (#100)
+- **FunctionBuilder Error**: Replace deprecated Instructor error with `EasyTalk::UnsupportedTypeError` (#96)
+- **Missing snake_case Strategy**: Added `SNAKE_CASE` constant to NamingStrategies module (#77)
+
+### Internal
+
+- Extracted shared schema methods into `SchemaMethods` mixin for code reuse between `Model` and `Schema` modules (#103)
+- Centralized built-in type registration in `Builders::Registry` (#102)
+- Added json_schemer for systematic validation testing with custom RSpec matchers
+
+## [3.1.0] - 2025-12-18
+
+### Added
+- **JSON Schema `$schema` Keyword Support**: Added ability to declare which JSON Schema draft version schemas conform to
+  - New `schema_version` configuration option supporting Draft-04, Draft-06, Draft-07, Draft 2019-09, and Draft 2020-12
+  - Global configuration via `EasyTalk.configure { |c| c.schema_version = :draft202012 }`
+  - Per-model override using `schema_version` keyword in `define_schema` block
+  - Support for custom schema URIs
+  - `$schema` only appears at root level (not in nested models)
+  - Default is `:none` for backward compatibility
+
+- **JSON Schema `$id` Keyword Support**: Added ability to provide a unique identifier URI for schemas
+  - New `schema_id` configuration option for setting schema identifiers
+  - Global configuration via `EasyTalk.configure { |c| c.schema_id = 'https://example.com/schema.json' }`
+  - Per-model override using `schema_id` keyword in `define_schema` block
+  - Supports absolute URIs, relative URIs, and URN formats
+  - `$id` only appears at root level (not in nested models)
+  - Default is `nil` for backward compatibility
+
+- **JSON Schema `$ref` and `$defs` Support**: Added ability to reference reusable schema definitions for nested models
+  - New `use_refs` configuration option to globally enable `$ref` for nested EasyTalk models
+  - Global configuration via `EasyTalk.configure { |c| c.use_refs = true }`
+  - Per-property override using `ref: true` or `ref: false` constraint
+  - Nested models are automatically added to `$defs` when `$ref` is enabled
+  - Supports direct model properties, `T::Array[Model]`, and `T.nilable(Model)` types
+  - Nilable models with `$ref` use `anyOf` with `$ref` and `null` type
+  - Multiple references to the same model only create one `$defs` entry
+  - Additional constraints (title, description) can be combined with `$ref`
+  - Default is `false` for backward compatibility (nested schemas are inlined)
+
 ## [3.0.0] - 2025-01-03
 
 ### BREAKING CHANGES