ray/input-query

Added

• Native validation for #[Input] array and #[Input] array|null parameters before invoking constructors or methods.
• Ray\InputQuery\Exception\InvalidInputTypeException with structured context for input parameter type errors.

Fixed

• #[Input(item: ...)] array now rejects scalar containers and invalid items instead of silently normalizing them or leaking TypeError.

Compatibility

• Existing public method signatures are unchanged.
• Invalid scalar values for native array input are now reported with InvalidInputTypeException.

Added

• Native array validation for #[Input] array and #[Input] array|null parameters before invoking constructors or methods
• InvalidInputTypeException with structured context for input parameter type errors

Fixed

• #[Input(item: ...)] array now rejects scalar containers and invalid items instead of silently normalizing them or leaking TypeError

Added

• Support direct nested array input for object parameters, such as author => ['name' => 'John'].

Compatibility

• First stable release of Ray.InputQuery.

Added

• Support direct nested array input for object parameters, such as author => ['name' => 'John']

Improved

• Enhanced nested query handling for bracketed object creation

This release improves the handling of nested query parameters when creating objects with bracketed notation, providing better support for complex nested data structures.

Full Changelog: 0.2.0...0.3.0

Improved

• Enhanced nested query handling for bracketed object creation

Added

• ToArrayInterface and ToArray implementation for flattening objects to flat associative arrays

Features

• Convert nested Input objects to flat arrays for SQL parameter binding
• Preserve arrays for SQL IN clauses (Aura.Sql compatible)
• Recursive flattening with property conflict resolution
• Test coverage: 104 tests, 340 assertions
• PHP 8.1+ compatibility

🤖 Generated with Claude Code

Added

• ToArrayInterface and ToArray implementation for flattening objects to flat associative arrays

Ray.InputQuery 0.1.0

Initial release of Ray.InputQuery - Structured input objects from HTTP with 100% test coverage.

Features

• Declarative Input Handling: Use #[Input] attributes to define input structure
• Automatic Type Conversion: Converts string inputs to appropriate PHP types
• Nested Object Support: Automatically creates nested objects from flat data (e.g., assigneeId, assigneeName → UserInput object)
• DI Integration: Seamlessly integrates with dependency injection containers
• File Upload Support: Optional integration with koriym/file-upload package
• Framework Agnostic: Works with any PHP framework or standalone

Installation

composer require ray/input-query

For file upload support:

composer require koriym/file-upload

Documentation

• README
• Framework Integration Guide
• Full Documentation

Requirements

• PHP 8.1 or higher
• ray/di ^2.18
• symfony/polyfill-php83 ^1.28
• koriym/file-upload ^0.2.0 (optional)

See CHANGELOG.md for detailed changes.

Added

• Initial release of Ray.InputQuery
• Core InputQuery class for transforming flat HTTP data into structured PHP objects
• #[Input] attribute for marking query-sourced parameters
• #[InputFile] attribute for file upload handling
• Automatic prefix-based nesting (e.g., assigneeId, assigneeName → UserInput object)
• Type-safe scalar conversion leveraging PHP's type system
• Full dependency injection integration with Ray.Di
• Support for arrays and ArrayObject collections
• Optional file upload functionality with FileUploadFactory
• NullUploadFactory for projects without file upload requirements
• Comprehensive documentation and examples
• 100% test coverage
• Framework integration guide for Laravel, Symfony, CakePHP, Yii, BEAR.Sunday, and Slim
• Demo applications including CSV processing and file upload examples

Features

• Declarative Input Handling: Use attributes to define input structure
• Automatic Type Conversion: Converts string inputs to appropriate PHP types
• Nested Object Support: Automatically creates nested objects from flat data
• DI Integration: Seamlessly integrates with dependency injection containers
• File Upload Support: Optional integration with koriym/file-upload package
• Framework Agnostic: Works with any PHP framework or standalone

Requirements

• PHP 8.1 or higher
• ray/di ^2.18
• symfony/polyfill-php83 ^1.28
• koriym/file-upload ^0.2.0 (optional, for file upload support)