Installation

composer require type-lang/mapper

Quick Start

use TypeLang\Mapper\Mapping\MapType;
class ExampleObject
{
 public function __construct(
 #[MapType('list<non-empty-string>')]
 public readonly array $names,
 ) {}
}
$mapper = new \TypeLang\Mapper\Mapper();
$result = $mapper->normalize(
 new ExampleObject(['Example'])
);
// Expected Result:
//
// array:1 [
// "names" => array:1 [
// 0 => "Example"
// ]
// ]
$result = $mapper->denormalize([
 'names' => ['first', 'second']
], ExampleObject::class);
// Expected Result:
//
// ExampleObject {#324
// +names: array:2 [
// 0 => "first"
// 1 => "second"
// ]
// }
$result = $mapper->denormalize([
 'names' => ['first', 'second', ''],
], ExampleObject::class);
// Expected Result:
//
// InvalidFieldTypeValueException: Passed value of field "names" must be of type
// list<non-empty-string>, but array(3)["first", "second", ""] given at $.names[2]

Benchmarks

object<ExampleObject>{
 name: string,
 items: list<ExampleObject>
}

Denormalization

Normalization