Storage

Append-only persistence for Business Transactions, Trust Records, and policies.

[AVAILABLE] for memory and supabase. Declared but unimplemented for postgres/sqlite, see below.

Providers, precisely

// packages/storage/src/StorageFactory.ts
switch (configuration.provider) {
  case "memory":   return new MemoryStorageProvider();
  case "supabase": return new SupabaseStorageProvider();
  case "postgres": throw new Error("Postgres storage provider not implemented.");
  case "sqlite":   throw new Error("SQLite storage provider not implemented.");
}

StorageConfiguration.provider accepts "memory" | "supabase" | "postgres" | "sqlite" as a type, but only the first two have a real class behind them. Setting PARMANA_STORAGE=postgres or sqlite throws immediately at startup, by design (fails closed rather than silently falling back).

Provider	Status	Notes
memory	[AVAILABLE]	In-process, non-persistent. Used throughout this site’s live examples (PARMANA_STORAGE=memory) so they have no external dependency.
supabase	[AVAILABLE] (source), not independently re-verified in this audit	SupabaseStorageProvider, SupabaseBusinessTransactionRepository, SupabaseExecutionTrustRecordRepository. This repo’s committed .env defaults to this.
postgres	Declared, not implemented	Throws at startup.
sqlite	Declared, not implemented	Throws at startup.

What’s stored

packages/storage/src/repositories/: ExecutionRepository, VerificationRepository, CryptoProofRepository, plus per-provider BusinessTransactionRepository and ExecutionTrustRecordRepository implementations, the append-only ledger backing every Execution Trust Record.

Configuration

PARMANA_STORAGE=memory     # or supabase

PARMANA_STORAGE is the only variable read. An older DATABASE_PROVIDER variable existed briefly as a second, disconnected path to the same setting and is now retired: if it’s present in the environment, config loading fails at startup naming PARMANA_STORAGE as the replacement, rather than silently ignoring it. 8 tests, packages/storage/test/.

See @parmana/storage for the package’s full export list if you’re consuming it directly rather than through the default server.