Skip to main content

Packages

AUSUS v0.1.0 publishes 10 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 in v0.1.0 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; they are planned to ship as working code in v0.2.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
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. A SQLite-backed PersistenceDriver: SqlitePersistenceDriver, SqliteRepository, SchemaDeriver, and DatabaseAuditSink. 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 v0.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 in v0.1.0

These four packages are reserved names. They ship in v0.1.0 with metadata but no implementation, and are planned for v0.2.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 in v0.1.0 is the tenant scoping built into persistence-sql — not a separate tenancy-row driver.
  • Auditing in v0.1.0 is DatabaseAuditSink in persistence-sql — 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)
└─ api-http (-> kernel, runtime-default)
standard-stack (-> kernel, persistence-sql, runtime-default, api-http)
starter (-> kernel, persistence-sql, runtime-default)