First stable version and the future of the library

[romm]

This topic aims to centralize discussions about the release of the first stable version (check the release notes here).

---

If you have ideas about missing features, please do not hesitate to comment, I'll be glad to read and answer.

[Slamdunk]

Hi, as far as I can tell the only big missing piece of the current Valinor is a Collaborator.
Maintaining such a valuable FOSS all by yourself is a path that only leads to madness, despair and grief 😛

[romm]

Haha, thank you for putting so much trust in the project!

only leads to madness, despair and grief

I hope I'll be able to outlive all of that. 😁

On a more serious note, I agree and would be very pleased if someone wanted to learn the internals of the library to be able to co-maintain it.

For now I know that I am able to free enough time for it, whenever I start to be more busy I'll probably try to find someone.

[shulard]

First, congrats for the stable release ! This is an awesome work that you've done 😉.

[romm]

🤗

[TimWolla]

If you have ideas about missing features

I was thinking about allowing registration of additional “string types” that would desugar into plain PHP strings after validation, somewhat similarly to custom constructors.

Possible use cases include:

• Decoding binary payloads embedded in JSON using b64 or hex encoding.
• Trimming whitespace from a string (e.g. when the data source is the query string, e.g. $_GET).

Example of a workaround that technically more-or-less works, but isn't great, because B64String is not actually a string.

<?php declare(strict_types=1);

use CuyZ\Valinor\Mapper\Source\Source;
use CuyZ\Valinor\MapperBuilder;

require('vendor/autoload.php');

final class B64String {
    private string $s;

    public function __construct(string $s) {
        $this->s = base64_decode($s);
    }

    public function __toString()
    {
        return $this->s;
    }
}

final class Target {
    public function __construct(
        public B64String $b64,
        public string $hex,
        public string $trim,
    ) {
    }
}

$rawJson = <<<'EOT'
{
    "b64": "dGVzdA==",
    "hex": "74657374",
    "trim": " test "
}
EOT;

$result = (new MapperBuilder())
    ->mapper()
    ->map(
        Target::class,
        Source::json($rawJson)
    );

var_dump(strtoupper($result->b64));