Community integration: a Symfony bundle for Jev #9

Community integration: a Symfony bundle for Jev

Sharing a community integration in case it is useful to list, along the lines of the "Community" request in typesafe-sdk-js#7. It is unofficial and not affiliated with TypeSafe.

vbcherepanov/jev-symfony-bundle (Apache-2.0, PHP 8.4+, Symfony 7.4 / 8.x, on Packagist):

composer require vbcherepanov/jev-symfony-bundle

• A typed client for POST /v1/systemone and GET /v1/models on Symfony HttpClient. Retries match the official SDKs: 408/429/5xx with retry-after-ms / Retry-After up to 60 s, and X-TypeSafe-Retry-Count on retries.
• Validator constraints, e.g. #[JevNoul('Is this spam?', max: 0.2)] on a form field, and #[JevChoice] with a minimum confidence.
• Messenger fan-out, Workflow guards decided by a noul/choice answer, a web-profiler panel (questions, probabilities, confidence, tokens, request ids), and jev:models / jev:ask console commands.
• A fake client for application tests. The Flex recipe (Add recipe for vbcherepanov/jev-symfony-bundle symfony/recipes-contrib#2064) turns it on under when@test.

It handles the API details I ran into while building it, several of which I reported here:

• numeric choice labels and question ids stay JSON objects;
• all three detail shapes are parsed (Docs report: request-body validation returns 400, but the API reference documents 422 #1);
• 401 and 403 both map to an authentication error (A missing API key returns 403, but the docs say 401, and the SDKs then raise PermissionDenied instead of AuthenticationError #8);
• release_date is accepted as a date or a timestamp (GET /v1/models: release_date is a full timestamp, but the OpenAPI schema promises YYYY-MM-DD #7);
• Score levels are checked against the enforced limit of 10 (Score level limits: the API enforces at most 10 levels, but the OpenAPI schema has no maximum, and a single level is accepted #6);
• the API key is never echoed into error messages (typesafe-sdk-python#9, typesafe-sdk-js#14).

Covered by 205 tests and PHPStan at max level; CI runs PHP 8.4/8.5 × Symfony 7.4/8.0. A live smoke test against the API runs locally when TYPESAFE_API_KEY is set.