Skip to main content

Packages

AUSUS v1.1.0 publishes 11 Composer packages and 1 npm package. This page is the authoritative list of what each one is — and which ones are reserved names with no code yet.

:::warning Implemented vs reserved Four Composer packages are name reservations only. They contain a composer.json and a README.md but no source code. They are listed here so the namespace is documented and claimed, and remain reserved in v1.1.0. Do not depend on them as functional packages. :::

Implemented — Composer

PackageLayerRole
ausus/kernelL0contracts, value objects, DSL, Compiler
ausus/runtime-defaultL2the Invoker chain
ausus/persistence-sqlL3SQLite persistence driver (reference)
ausus/persistence-postgresL3PostgreSQL persistence driver (production)
ausus/api-httpL4PSR-7/15 HTTP API

ausus/kernel

Layer L0. Contracts and value objects only — no runtime side effects. Defines the metadata graph node types, the Plugin contract, the Compiler, the DSL (DslPlugin, Dsl, Field, Action), the Policy / Effect / Repository / Auditor contracts, the value objects (Tenant, Reference, Actor, …), Ulid, and the exception taxonomy. Every other package depends on it.

ausus/runtime-default

Layer L2. The execution engine: Invoker, PolicyEngine, WorkflowRuntime, EffectDispatcher and the built-in effects, DefaultAuditor, and ProjectionRenderer. Depends on kernel. See The Runtime.

ausus/persistence-sql

Layer L3. The reference SQLite-backed PersistenceDriver: SqlitePersistenceDriver, SqliteRepository, SchemaDeriver, and DatabaseAuditSink. Depends on kernel. See SQL Persistence.

ausus/persistence-postgres

Layer L3. The production PostgreSQL implementation of the same PersistenceDriver contract: PostgresPersistenceDriver, PostgresRepository, PostgresSchemaDeriver, and PostgresAuditSink. Behaviour-compatible with persistence-sql, verified by a continuous cross-driver compatibility gate. Depends on kernel. See SQL Persistence.

ausus/api-http

Layer L4. A PSR-15 Router exposing projections and actions over HTTP, plus ErrorMapper and a minimal Emitter. Depends on kernel and runtime-default. See The HTTP API.

Implemented — template and metapackage

PackageTypeRole
ausus/starterprojectcomposer create-project template — wires the stack and ships the HelloInvoice sample
ausus/standard-stackmetapackagepins the validated v1.1.0 package set; depends on kernel, persistence-sql, runtime-default, api-http

Implemented — npm

PackageRole
@ausus/renderer-reactReact 18/19 renderer for the ViewSchema wire format

ESM-only; react/react-dom are peer dependencies. See The React renderer.

Reserved — name only, no code

These four packages are reserved names. They ship with metadata but no implementation, and remain reserved in v1.1.0.

PackageReserved forPlanned layer
ausus/tenancy-rowa row-level multi-tenancy driverL3
ausus/audit-databasea dedicated database audit sink/driverL3
ausus/auth-bridgethe authentication / actor-resolution bridgeL2–L4
ausus/presentation-defaultthe L5 presentation layer beyond the kernel rendererL5

:::note What this means for you

  • Multi-tenancy is the tenant scoping built into the persistence drivers (persistence-sql / persistence-postgres) — not a separate tenancy-row driver.
  • Auditing is the in-transaction audit sink shipped by the persistence drivers — not the audit-database package.
  • Authentication is not provided — auth-bridge is unwritten. See the security note in The HTTP API. :::

Dependency order

When installing packages by hand, follow the dependency order:

kernel
├─ runtime-default (-> kernel)
├─ persistence-sql (-> kernel)
├─ persistence-postgres (-> kernel)
└─ api-http (-> kernel, runtime-default)
standard-stack (-> kernel, persistence-sql, runtime-default, api-http)
starter (-> kernel, persistence-sql, runtime-default)