Skip to content
pgxsinkit

Retention

Retention = "persistent" | "ephemeral"

Defined in: packages/contracts/src/config.ts:67

Retention for a synced table (ADR-0021): whether its local copy is durable.

  • persistent (default) — the durable PGlite backend with a resumable subscription-state.
  • ephemeral — the table’s whole per-table local cluster (read cache, overlay, journal, sequence, views, reconcile trigger/function) is emitted as TEMP, so reads and writes leave no durable trace. Consequence: no durable offline write queue — pair a must-not-lose write with a pessimistic flush (ADR-0022).

Like SubscriptionTiming, a property of the consistency group: every table in a group agrees.