3neti / x-rider
Programmable claimant experience layer for post-claim rider messages, redirects, splash, analytics seams, and future campaign runtimes.
Requires
- php: >=8.3
- illuminate/http: ^12.0 || ^13.0
- illuminate/routing: ^12.0 || ^13.0
- illuminate/support: ^12.0 || ^13.0
- mews/purifier: ^3.4
- spatie/laravel-data: ^4.17
- symfony/yaml: ^7.0 || ^8.0
Requires (Dev)
- laravel/pint: ^1.0
- orchestra/testbench: ^10.3 || ^11.0
- pestphp/pest: ^3.8 || ^4.0
- pestphp/pest-plugin-laravel: ^3.2 || ^4.0
README
3neti/x-rider is the claimant experience package for post-claim rider messages, safe redirects, splash/continuation surfaces, analytics seams, and future campaign drivers.
Principle
x-changeowns financial truth.x-riderowns claimant experience.
Initial scope
- Rider DTOs
- Rider experience resolver
- Safe redirect resolver
- Success page shell
- Redirect controller
- Analytics recorder seam
- Future driver contract
Install
composer require 3neti/x-rider php artisan vendor:publish --tag=x-rider-config php artisan vendor:publish --tag=x-rider-drivers php artisan vendor:publish --tag=x-rider-ui
Laravel discovers LBHurtado\XRider\XRiderServiceProvider automatically. The
package owns its configuration, default driver manifests, optional routes, and Vue
runtime source. Publishing creates host overrides; it is not required for the PHP
runtime to resolve the package defaults.
Compatibility
- PHP 8.3 or 8.4
- Laravel 12 or 13
- Node.js 20 or 22 for frontend verification
Safety boundary
- HTML splash content is sanitized before presentation.
- Redirects are denied unless their scheme and host satisfy the configured policy.
- Runtime actions are normalized before execution and unknown actions fail safely.
x-riderpresents the claimant experience only. It does not authorize, settle, redeem, or mutate a Pay Code.
Current integration model
x-change should invoke x-rider only after an accepted claim outcome.
claim accepted
↓
RiderExperienceResolver
↓
Success.vue
↓
RiderRedirectController
Quality gates
composer validate --strict
composer pint
composer test
npm ci
npm run test:frontend
npm audit
composer audit
Hosted verification covers both supported PHP/Laravel lanes and the package-owned Vue runtime.