*\/ * public array $roles, * ) {} * } * * $user = (new MapperBuilder()) * ->mapper() * ->map(User::class, [ * 'name' => 'John Doe', * 'roles' => '["admin", "editor"]', // mapped to `['admin', 'editor']` * ]); * ``` * * @api */ #[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_PARAMETER)] #[AsConverter] final class MapFromJson { /** * @template T * @param callable(mixed): T $next * @return T */ public function map(string $value, callable $next): mixed { try { $decoded = json_decode($value, associative: true, flags: JSON_THROW_ON_ERROR); } catch (JsonException) { throw MessageBuilder::newError('Value {source_value} is not valid JSON.') ->withCode('invalid_json') ->build(); } return $next($decoded); } }