3neti / settlement-envelope-aui

v1.1.0 2026-09-25 12:09 UTC

Requires

• php: ^8.2
• 3neti/settlement-envelope: ^1.4
• illuminate/contracts: ^12.0 || ^13.0
• illuminate/http: ^12.0 || ^13.0
• illuminate/support: ^12.0 || ^13.0
• nesbot/carbon: ^3.0
• opis/json-schema: ^2.3

Requires (Dev)

• pestphp/pest: ^3.0 || ^4.0

MIT

Published on Packagist.org on 2026-09-25 12:09 UTC

README

3neti/settlement-envelope-aui provides the demonstration-only aui.personal-accident.provisional-cover@1.0.0 integration. It depends on generic 3neti/settlement-envelope contracts, not x-change. The ^1.4 dependency uses the published driver source registry and workflow integration contracts. Install normally through Composer; no local path repository or host-specific override is required.

Public classes live under ThreeNeti\SettlementEnvelopeAui:

• Data\AuiPolicySubmission(array $payload) validates the allowlisted request contract and implements WorkflowSubmission; payload() returns its snapshot.
• Data\AuiPolicyResult implements WorkflowIntegrationResult, exposes typed policy reference, product code, and immutable coverage timestamps, and preserves the existing demonstration response wire format through toArray().
• Services\ParseAuiPolicyResponse::handle() validates the exact response keys, constants, reference, explicit RFC3339 timestamps, and authoritative coverage instants. Invalid responses raise sanitized DomainException errors.
• Services\AuiPolicyTransport takes an HTTP client factory and response parser; submit($submission, $endpoint, $token, $connectTimeout, $timeout) makes one allowlisted JSON POST with bearer authentication and idempotency/fingerprint headers.
• AuiResources::driverPath() and requestSchemaPath() expose passive resources.

Transport permits only HTTPS pipedream.net endpoints and their subdomains, without userinfo, query strings, or fragments. It validates credentials, bounds timeouts to 1–120 seconds, disables redirects, and never retries. Failed HTTP responses and connection errors expose generic messages without raw provider payloads or chained exceptions. Idempotency headers are not a durable ledger.

Laravel automatically discovers SettlementEnvelopeAuiServiceProvider, which registers the bundled driver source and a lazy concrete AuiPolicyTransport binding using the settlement-envelope 1.4 source registry.

Installation makes the workflow discoverable, but does not activate it, register routes, publish configuration, send notifications, or contact a service. The transport is not a generic workflow adapter and is not tagged as one. Hosts still provide their existing orchestration wrapper, credentials, endpoint and timeouts. x-change retains accepted-disposition checks, authorization, payment and evidence handling, persistence, orchestration, and outcome recording. This package does not issue real insurance or authorize any economic action; use synthetic demonstration data only.

Run composer test after installing development dependencies. Tests fake HTTP; they do not call a provider.

To test against an unreleased generic package checkout without modifying vendor, run SETTLEMENT_ENVELOPE_SOURCE=/absolute/path/to/settlement-envelope composer test.