azaharizaman/nexus-laravel-idempotency-adapter

Laravel adapter for Nexus Idempotency (Layer 3): HTTP middleware, database store, replay helpers.

v0.1.0-alpha1 2026-05-05 02:28 UTC

Requires

• php: ^8.3
• azaharizaman/nexus-idempotency: dev-main
• illuminate/console: ^11.0|^12.0
• illuminate/database: ^11.0|^12.0
• illuminate/http: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0
• psr/log: ^3.0

Requires (Dev)

• mockery/mockery: ^1.6
• phpunit/phpunit: ^11.0

MIT

• Nexus Development Team

README

Layer 3 Laravel adapter for azaharizaman/nexus-idempotency: database store, middleware (idempotency), cleanup command, fingerprint helper, and ReplayResponseFactoryInterface hook for HTTP replay.

Install (monorepo / path repo)

Require from the consuming Laravel app:

"azaharizaman/nexus-laravel-idempotency-adapter": "*@dev"

The package auto-registers Nexus\Laravel\Idempotency\Providers\IdempotencyAdapterServiceProvider.

Bind replay responses

Register an implementation of Nexus\Laravel\Idempotency\Contracts\ReplayResponseFactoryInterface (Atomy-Q uses App\Http\Idempotency\IdempotencyReplayResponseFactory).

Middleware order

Use jwt.auth → tenant → idempotency on routes that require Idempotency-Key.

Migrations & config

Migrations load from the package. Optional publish:

php artisan vendor:publish --tag=nexus-idempotency-config

Tests (adapter package)

From adapters/Laravel/Idempotency:

../../../apps/atomy-q/API/vendor/bin/phpunit -c phpunit.xml

(Uses the Atomy-Q API vendor/autoload.php in this monorepo.)