ausus / persistence-sql

v1.1.0 2026-06-12 09:16 UTC

Requires

• php: >=8.3
• ext-pdo: *
• ausus/kernel: ^1.0

Suggests

• ext-pdo_mysql: For MySQL deployments
• ext-pdo_pgsql: For PostgreSQL deployments
• ext-pdo_sqlite: Default driver for V0 smoke tests

MIT

• framework
• persistence
• sql
• pdo
• ausus

Published on Packagist.org on 2026-06-13 18:52 UTC

README

L3 — SQL PersistenceDriver implementation.

Owned RFC surfaces

• RFC-002 — full PersistenceDriver, PersistenceContext, Repository, Identity, Transactions, Optimistic locking, Relations, Filter grammar, Bulk operations, Error taxonomy.
• Schema derivation from Metadata Graph per RFC-012 §3.4.

Capabilities advertised

supportedTenancyStrategies() -> ['row']     # V1 ships row-only
supportsSnapshotReads()      -> true        # Postgres MVCC / MySQL InnoDB
maxNestedSavepoints()        -> 8           # RFC-002 §7.4 minimum
maxBulkTransactionSize()     -> 100000      # configurable
identityShape()              -> 'ulid'      # configurable

Allowed dependencies

• ausus/kernel
• illuminate/database (Eloquent connection only — never exposed across the contract boundary)

Forbidden

• Eloquent return types in any public method.
• Illuminate\Database\Query\Builder exposed to plugins.
• Direct SQL strings accepted as input.