ausus/persistence-sql

L3 PersistenceDriver — SQL implementation of RFC-002 via PDO (SQLite/MySQL/Postgres). Includes SchemaDeriver + DatabaseAuditSink.

Maintainers

Package info

github.com/adonko3xBitters/persistence-sql

Homepage

pkg:composer/ausus/persistence-sql

Statistics

Installs: 2

Dependents: 2

Suggesters: 0

Stars: 0

Open Issues: 0

0.1.0 2026-05-19 10:16 UTC

This package is auto-updated.

Last update: 2026-05-20 02:01:38 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.