Add TYPO3 extension support and package search endpoint

[jdevalk]

Summary

• Add typo3-core and typo3-extension to the PackageType enum, aligning with the FAIR protocol extension registry (Add Typo3 support to Protocol Extension Registry fair-protocol#63)
• Add GET /packages/{type} search endpoint with full-text search (tsvector + GIN), tag matching, and trigram fallback for fuzzy results
• Add requires version filter — e.g. ?requires[typo3]=12.4 returns packages with a release requiring TYPO3 <= 12.4
• Make DID document route type constraint dynamic via PackageType::values() so future types are automatically supported
• Add migration with search indexes (tsvector GIN, trigram GiST on name/slug, B-tree on type)
• Use PackageSearchRequest DTO (beacon-hq/bag) for request validation
• Add TYPO3 extension seeder with 10 sample extensions for local testing

Search API

Endpoint: GET /packages/{type}

Parameters:

Param	Type	Description
q	string (optional)	Search query — matches name, slug, description, and tags
requires[key]	string (optional)	Version filter — e.g. requires[typo3]=12.4 or requires[php]=8.1. Returns packages with at least one release whose required version is <= the specified version
page	int (optional, default 1)	Page number
per_page	int (optional, default 24, max 100)	Results per page

Examples:

GET /packages/typo3-extension
GET /packages/typo3-extension?q=gallery
GET /packages/typo3-extension?q=seo&requires[typo3]=12.4
GET /packages/wp-plugin?q=forms&requires[php]=8.1
GET /packages/typo3-extension?per_page=10&page=2

Demo data

A Typo3ExtensionSeeder is included with 10 realistic TYPO3 extensions (News System, Powermail, Solr, Mask, etc.), each with tags and releases that include TYPO3 version requirements (11.5/12.4/13.4).

php artisan db:seed --class=Typo3ExtensionSeeder

Test plan

• Start Docker and run php artisan migrate — new migration applies cleanly
• Run php artisan test tests/Feature/API/FAIR/PackageSearchControllerTest.php — all 11 tests pass
• Run php artisan test — no regressions (157 passed)
• Seed test data: php artisan db:seed --class=Typo3ExtensionSeeder
• curl /packages/typo3-extension returns listing of seeded extensions
• curl /packages/typo3-extension?q=gallery returns matching results
• curl "/packages/typo3-extension?requires[typo3]=12.4" filters by TYPO3 version

🤖 Generated with Claude Code

[chuckadams]

Looks good overall. Using DTOs isn't a hard requirement, but it does help keep the controller and service in sync as the protocol evolves.

[SvenLie]

I would like to filter for TYPO3 (and then it would be also possible for Wordpress) versions.

[jdevalk]

adding filter as suggested by @SvenLie

[SvenLie]

Love it. Thank you! :)