Laravel Dto Laravel Package

Added

• Laravel 13 support

Added

• Laravel 12 support

Removed

• PHP 8.1 support
• Laravel 9 and 10 support

Added

• Command make:dto now opens the file after is generated

Changed

• extended-php dependency replaced with extended-laravel (required to use OpensGeneratedFiles trait on the make:dto command)

Changed

• New dependency name replaced laravel-helpers with extended-php

Fixed

• Filtering reset keys to numeric when string needed

Fixed

• Filtering on collections with not null data

Fixed

• Filtering on collections with not null data

Added

• Improve model morph mapping sending multiple IDs and their matches types. Documentation link

Added

• DataTransferObjects now have dump and dd methods

Fixed

• toArray method not returning everything when DTOs where used on the request and later on reused. Caveat: Only one DTO per request until v4 refactor

Added

• Laravel 11 support
• Collected data transfer objects now mapped properly using fromArray

Fixed

• From request context with DTO's filled method not working properly

Fixed

• Route resolution on the model's logic (resolveRouteBindingQuery)

Fixed

• Route binding when nested DTO is being used with same parameter key as route binding

Changed

• Models route binding now uses Eloquent's Model resolveRouteBindingQuery method
• Models uses default routing key (getRouteKeyName) only when BindModel PHP attribute doesn't have the using argument

Fixed

• Routes binding models through DTOs now are injected back to route parameters (to be reused in every other part of the software)

Fixed

• BackedEnum typed properties with union types falling back to original value

Fixed

• laravel-helpers package version constraints so it doesn't conflict with any other package that uses it in the same way (or even the root project)

Fixed

• Serialisation using old BindModelUsing instead of new BindModel attribute

Added

• JSON strings to collections (arrays or Illuminate's Collection instances)

Fixed

• Regression introduced by morphs fix using abstract Model class

Fixed

• Morph binding using generic Illuminate's model class (not instantiable), fallbacks to Relation::morphMap

Fixed

• Passing through with no type casting already matching typed properties (enums, objects, etc...)

Fixed

• Enums parsing when one is being passed to DTOs (thanks @coclav 🎉) [#6]

Added

• Morph support for data transfer objects model properties and collection properties. For e.g: public Film|Post $taggable, public string $taggableType
• Simplificated OpenSoutheners\LaravelDto\Attributes\BindModel attribute grouping all the model binding options.
• Support for OpenSoutheners\LaravelDto\Attributes\BindModel attribute in morph properties, which can be also used to customise the type key name. For e.g. from the same example from above:

#[BindModel(
  using: [Post::class => 'slug'],
  with: [Post::class => 'tags', Film::class => ['tags', 'posts']],
  morphTypeKey: 'tagType'
)]
public Film|Post $taggable,
public string $tagType

Changed

• Replace all #[BindModelUsing('attribute')] to #[BindModel(using: 'attribute')] in your code (take in mind it must not be repeated under the same property)
• Replace all #[BindModelWith(['relation1', 'relation2'])] to #[BindModel(with: ['relation1', 'relation2'])] in your code (take in mind it must not be repeated under the same property)

Added

• OpenSoutheners\LaravelDto\Attributes\WithDefaultValue attribute to set default value
• #[WithDefaultValue(Authenticatable::class)] will set as default value the authenticated user (Auth::user())

Fixed

• Now \stdClass properties get properly serialised as multidimensional arrays

Added

• TypeScript .d.ts generation command with --declarations option

Changed

• Default TypeScript types generation command options now have some of them on the config file

Fixed

• Config file now is exposed to be published using vendor:publish --provider="OpenSoutheners\\LaravelDto\\ServiceProvider" or vendor:publish --tag="config" commands
• Non typed properties when nullable or not while TypeScript types generation

Fixed

• Keys normalisation on types generator (snake case when enabled from config)
• Types generator when empty collections

Added

• Serialisation for DTO objects so now they can be sent to queued jobs
• dto:typescript command for generating TypeScript types based on your application's DTOs

Fixed

• Sending multiple values (for e.g. 1,2,5) on a collection with BindModelUsing attribute or custom model's getRouteKeyName method now works querying all models
• make:dto command now does not generate a ValidatedDataTransferObject with request static method on it

Fixed

• Request option for make:dto command when sent without a value fails

Fixed

• make:dto with _id ending properties

Fixed

• Fix make:dto command when validated form request sent with properties that has children items like array.*.item

Fixed

• DataTransferObject::toArray when DTO constructed fromArray is getting request stuff, it doesn't get all properties

Fixed

• make:dto with request option doesn’t add class string to static method

Fixed

• make:dto command with validated requests sent to option

Fixed

• Validation not applied for ValidatedDataTransferObject interface DTOs

Changed

• ValidatedDataTransferObject interface is no longer resolved, instead DataTransferObject class will be the one resolved (for those DTOs that doesn't have a FormRequest class on them, validated form data)

Changed

• Better error reporting when DTO class is being bound to a controller

Fixed

• Collections does not get mapped when Illuminate's collection has been sent to DTO

Changed

• Model binding defaults to primary key instead of Model::getRouteKeyName() (which should be used for those coming from routes instead)
• Route bound models are using specified attributes instead of default to IDs (model's primary keys). For e.g. posts/{post:slug} will use slug on the DTO query

Fixed

• BindModelUsing now uses the attribute on the binding query

Added

• OpenSoutheners\LaravelDto\Attributes\BindModelUsing property PHP attribute class for use attribute to do the binding/serialisation

Fixed

• Issue mapping custom objects from data collections (native arrays or Illuminate's collections)

Added

• make:dto --request command now accepts empty request option to create empty base DTO class with empty request method

Fixed

• make:dto --request now fill request method properly

Fixed

• Collections binding models were returning model instance instead of array or Illuminate\Support\Collection with the models inside
• DataTransferObject::filled() method now checks within route parameters as well as sent request body data if is within request context
• DataTransferObject::toArray() method now returns arrays with nested toArray calls when collections or models

Added

• php artisan make:dto --request='App\Http\Requests\PostCreateFormRequest' PostCreateData will now fill the request part and all properties for you with their types (experimental)
• Map arrays or json strings into generic objects (\stdClass) or custom objects (using their classes)
• Map string dates into Illuminate\Support\Carbon or Carbon\Carbon or Carbon\CarbonImmutable instances

Fixed

• Laravel collections not being mapped properly
• Arrays not mapping properly when not containing strings (arrays with arrays inside)

Added

• Command option --request to create ValidatedDataTransferObject with request method in it.

Added

• Add binding resolution so DataTransferObjects can act as validated requests using ValidatedDataTransferObject interface
• Add authenticated user “automagical” binding to DataTransferObject property when possible (need to be typed as Authenticatable illuminate's contract)

Changed

• Now route parameters are merged into DataTransferObjects when running within requests context

Fixed

• Minor issue, now doesn't query when sending model instance using DataTransferObject::fromArray() method

Changed

• Properties returned from toArray are now snake cased (from myPropertyName to my_property_name)
• Improved toArray to return just some modified properties (from defaults)

Added

• toArray method to DTOs

Fixed

• BindModelWith attribute on collection typed properties

Added

• Introducing mapped types using docblock [@param](https://github.com/param) type like the following: [@param](https://github.com/param) array<\App\Models\MyModel> $models or [@param](https://github.com/param) \Illuminate\Support\Collection<\App\Models\MyModel> $models
• Optional normalisation option for properties names (workspace_id to workspace, post_tags to postTags, etc) to package config file (publish using command php artisan vendor:publish --provider="OpenSoutheners\LaravelDto\ServiceProvider")
• Attribute OpenSoutheners\LaravelDto\Attributes\NormaliseProperties to use in some DTO classes that needs properties normalisation (when globally disabled from config)
• Attribute OpenSoutheners\LaravelDto\Attributes\BindModelWith to bind to model with relationships included

Changed

• Now using symfony/property-info for better property assertion (so many bugs and inconsistencies on promoted properties in PHP8+ assertions)

Changed

• DataTransferObject::fromArray now uses initialize method instead of withDefaults (internal change, shouldn't affect anything)

Changed

• DataTransferObject::filled method refactored with better logic

Added

• DataTransferObject::fromRequest() method shortcut (does same as DataTransferObject::fromArray($request->validated()) or DataTransferObject::fromArray($request->all()))

Added

• make:dto command to generate data transfer object classes

Added

• Initial release!