Skip to content
pgxsinkit

SubscriptionTiming

SubscriptionTiming = "eager" | "lazy"

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

Subscription timing for a synced table (ADR-0021): when its read-path shape subscribes.

  • eager (default) — subscribed in the boot set, as today.
  • lazy — excluded from boot; subscribed on first query-reference. With persistent retention, first use is a one-time ignition that promotes the table to a normal eager table for subsequent sessions; with ephemeral retention it is session-scoped.

A property of the consistency group: every table sharing a consistencyGroup must agree, since a group’s streams commit atomically together — all up-to-date, then one transaction (ADR-0056) — so it cannot be partly lazy (ADR-0021 §4).