pushinbr/pam-native-laravel-sync

Production Laravel server protocol and PAM Native transport adapter for offline sync.

v0.1.1 2026-08-01 04:08 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^12.0|^13.0
• illuminate/database: ^12.0|^13.0
• illuminate/http: ^12.0|^13.0
• illuminate/routing: ^12.0|^13.0
• illuminate/support: ^12.0|^13.0
• pushinbr/pam-native: ^0.6.1
• pushinbr/pam-native-sync: ^0.1.0

Requires (Dev)

• orchestra/testbench: ^10.0|^11.0
• phpunit/phpunit: ^11.5.50|^12.5.8|^13.0

BUSL-1.1

Published on Packagist.org on 2026-08-01 04:12 UTC

README

The production Laravel counterpart for pushinbr/pam-native-sync: authenticated incremental pulls, idempotent mutation ingestion, HMAC-signed cursors, conflict responses, collection registration, retention boundaries, and a PAM Native transport adapter.

composer require pushinbr/pam-native-laravel-sync
php artisan vendor:publish --tag=pam-native-sync-config
php artisan migrate

// AppServiceProvider.php
$registry->register('notes', new NotesSyncHandler());

// Mobile application
$engine = new SyncEngine($store, new LaravelSyncTransport($http, $baseUrl));
$engine->synchronize(fn (SyncReport $report) => updateSyncStatus($report));

Publish config/pam-native-sync.php, protect the supplied routes with your authentication middleware, register an explicit handler for every synchronized collection, and keep the HMAC key stable across deploys. Cursor payloads are signed and bounded but are not encrypted; never place secrets inside cursor state.

Laravel 12 and 13 are supported. The integration suite boots a real Testbench application and verifies push idempotency, pull cursors, validation, resources, and conflict flow.