@kairos-es/feed-postgres 0.0.0-stage → 1.0.0-alpha.6

package/dist/esm/lease.js

@@ -0,0 +1,330 @@
+/**
+ * The sync worker's lease on Postgres, in the two kinds `FeedSyncStore`'s doc
+ * describes, chosen in config to suit the infrastructure in front of the
+ * database.
+ *
+ * ## Why there are two
+ *
+ * A worker lease is what keeps a feed's sends to a sink in order: a sink has no
+ * transaction, so a rival worker's stale send lands before any compare-and-set can
+ * catch it (ADR-0019 §5). The two kinds trade the same two things against each
+ * other — what the connection must be, and how long a lapsed worker can go on
+ * sending — and neither wins on both.
+ *
+ * - **`leaseRow`, the default.** The holder and an expiry live on the sink's
+ *   cursor row, taken with a guarded upsert (only when free, expired, or held by
+ *   an advisory worker whose session is gone; see below) and renewed by a
+ *   heartbeat forked into the lease's scope. Every statement is an ordinary short
+ *   one, and the take one short transaction, so it works through a TRANSACTION
+ *   POOLER, which drops session state and so rules out a session lock, and it
+ *   needs no reserved connection. Its cost is a window. `ensureHeld` fails a
+ *   MARGIN before the stored expiry: once the last successful renewal is
+ *   `ttl - margin` old by the worker's own `Clock`, that renewal's expiry, which is
+ *   when a rival may take the row, is at most `margin` away. So a call to the sink
+ *   that `ensureHeld` let through, and that lands within `margin` of that check,
+ *   pauses included, lands before any rival can hold the lease, however its
+ *   renewals have been failing meanwhile, as long as the two workers' clocks
+ *   agree. A call that outlasts the margin, whether it is slow or its worker
+ *   pauses (a long GC pause, a network stall), can land after a rival took over:
+ *   ONE stale call, since the next `ensureHeld` fails; `FeedSyncStore.ts` owns what
+ *   that call costs. The margin is `ttl / 3` unless configured, and must leave the
+ *   heartbeat room under the lease (`heartbeat + margin < ttl`), or `ensureHeld`
+ *   would fail between two renewals that both landed at once. Each renewal is
+ *   bounded by the heartbeat and the next starts on the next tick, and the age
+ *   `ensureHeld` judges runs from when a renewal STARTED. So a renewal that lands
+ *   is at most `heartbeat` late, and the worst age `ensureHeld` meets is
+ *   `heartbeat` plus that latency with every renewal landing, and `2 * heartbeat`
+ *   plus it with one lost. A worker therefore goes on sending, without a single
+ *   failed `ensureHeld`, through renewals that are slow when
+ *   `2 * heartbeat + margin <= ttl`, and through one that fails or hangs when
+ *   `3 * heartbeat + margin <= ttl`. The defaults satisfy the second; the
+ *   construction check enforces only the first's zero-latency form, so a tighter
+ *   config is accepted and trades those guarantees for a shorter `ttl`.
+ * - **`advisoryLock`.** A session `pg_try_advisory_lock` on a connection RESERVED
+ *   from a client the consumer dedicates to it, keyed by a hash of the prefix, the
+ *   feed and the sink. The lock goes when the session goes, and `ensureHeld` asks
+ *   that same session, before every call that changes the sink, whether it still
+ *   holds the lock; any failure to answer is a lost lease. So a process pause
+ *   opens no stale window, since the lock survives it. What a check cannot see is
+ *   the session dying AFTER it: the call it let through is already under way and
+ *   runs to its end, so it can land as late as its whole duration after the session
+ *   died, and after a rival has taken the lock and sent. That is still ONE stale
+ *   call, since the next `ensureHeld` asks a session that is gone, but a sink call
+ *   can be long — a resync's `publish` most of all. The price is a connection per
+ *   running worker, and a connection that is genuinely a SESSION: a transaction
+ *   pooler would hand the lock's session to somebody else between statements. A
+ *   client this package can recognise as one is refused at construction; see
+ *   {@link pooledConnectionFault} for what it can and cannot recognise.
+ *
+ * ## Fencing is the same for both
+ *
+ * Both kinds record the holder on the cursor row, and the cursor compare-and-set
+ * requires it, so a worker whose lease has gone cannot move the cursor whichever
+ * kind it held. Mixing the two kinds on one feed and sink fails safe, because
+ * neither takes the row from a LIVE holder of the other. A lease-row worker takes
+ * over an advisory holder (one with no expiry to lapse) only while it holds that
+ * sink's advisory lock for its own transaction, which a live advisory session
+ * refuses; so a crashed advisory worker, whose scope never closed to clear the row,
+ * does not leave the sink unleasable by every lease-row worker after it. An
+ * advisory worker that wins the lock but finds a lease row unexpired on the row lets
+ * the lock go and fails `LeaseHeld`. Whichever took the row first keeps it while it
+ * lives. The advisory worker likewise takes over an ADVISORY holder recorded on the
+ * row, because holding the lock proves that session is gone; it records itself
+ * from the session that holds the lock, and only while it still does, so a session
+ * that died after its try-lock cannot overwrite the successor that took the lock
+ * from it.
+ */
+import { LeaseHeld, LeaseHolder, LeaseLost } from '@kairos-es/feed';
+import { Clock, Duration, Effect, Option, Random, Redacted, Ref } from 'effect';
+import { unreadable, writeFailed } from "./internal/context.js";
+/** The default lease length. */
+export const DEFAULT_LEASE_TTL = /*#__PURE__*/Duration.seconds(30);
+/**
+ * The default renewal interval: a fifth of the lease. With the default margin, a
+ * third, `3 * heartbeat + margin` is under the `ttl`, so a worker goes on sending,
+ * with no failed `ensureHeld`, through one renewal that fails or hangs. However
+ * many fail, it stops sending a margin before its lease could lapse. The module
+ * doc has the arithmetic.
+ */
+export const DEFAULT_LEASE_HEARTBEAT = /*#__PURE__*/Duration.seconds(6);
+/** A lease row, the default; see the module doc. */
+export const leaseRow = (options = {}) => ({
+  _tag: 'LeaseRow',
+  ttl: options.ttl ?? DEFAULT_LEASE_TTL,
+  heartbeat: options.heartbeat ?? DEFAULT_LEASE_HEARTBEAT,
+  ...(options.margin === undefined ? {} : {
+    margin: options.margin
+  })
+});
+/** A session advisory lock on a dedicated connection; see the module doc. */
+export const advisoryLock = options => ({
+  _tag: 'AdvisoryLock',
+  connection: options.connection
+});
+/**
+ * Why `client` cannot carry a session lock, when this package can tell, or
+ * `undefined`.
+ *
+ * What it can tell is limited to what a client says about where it connects,
+ * which `@effect/sql-pg`'s client exposes as `config` and a generic `SqlClient`
+ * does not. It recognises the two pooler conventions that show in an address: a
+ * Neon pooled endpoint (a host containing `-pooler`), and PgBouncer's default
+ * port, 6432, or a `pgbouncer=true` URL parameter. A pooler on any other address,
+ * or behind a client that exposes nothing, passes; that is a wiring the consumer
+ * owns. The URL is read only to judge it and is never repeated in the message.
+ */
+export const pooledConnectionFault = client => {
+  const config = client.config;
+  if (config === null || typeof config !== 'object') {
+    return undefined;
+  }
+  const {
+    host,
+    port,
+    url
+  } = config;
+  const hosts = typeof host === 'string' ? [host] : [];
+  const ports = typeof port === 'number' ? [port] : [];
+  let pgbouncer = false;
+  const rawUrl = Redacted.isRedacted(url) ? Redacted.value(url) : typeof url === 'string' ? url : undefined;
+  if (typeof rawUrl === 'string') {
+    try {
+      const parsed = new URL(rawUrl);
+      hosts.push(parsed.hostname);
+      if (parsed.port !== '') {
+        ports.push(Number(parsed.port));
+      }
+      pgbouncer = parsed.searchParams.get('pgbouncer') === 'true';
+    } catch {
+      // Not a URL this check can read; the driver will say so itself.
+    }
+  }
+  const signs = [...(hosts.some(h => h.includes('-pooler')) ? ['a "-pooler" host, which is a pooled endpoint'] : []), ...(ports.includes(6432) ? ["port 6432, PgBouncer's default"] : []), ...(pgbouncer ? ['a pgbouncer=true parameter'] : [])];
+  return signs.length === 0 ? undefined : `the advisoryLock connection looks like a transaction pooler (${signs.join('; ')}), which hands a session to other clients between statements and so cannot hold a session lock; give it a direct connection, or use leaseRow`;
+};
+/** A positive, finite duration, or a construction-time throw naming it. */
+const positive = (label, input) => {
+  const decoded = Duration.fromInputUnsafe(input);
+  if (!Duration.isFinite(decoded) || Duration.toMillis(decoded) <= 0) {
+    throw new Error(`feed-postgres: ${label} must be a positive, finite duration`);
+  }
+  return decoded;
+};
+/** A fresh holder id, from `Random`, never the host. */
+const newHolder = kind => Effect.gen(function* () {
+  const high = yield* Random.nextIntBetween(0, 2 ** 31);
+  const low = yield* Random.nextIntBetween(0, 2 ** 31);
+  return LeaseHolder.make(`pg-${kind}:${high.toString(16)}${low.toString(16).padStart(8, '0')}`);
+});
+/**
+ * The advisory lock's name for one feed and sink, hashed server-side into its
+ * key. Package-internal, and the one home of the name: `removeSink` tries the
+ * same lock to tell whether an advisory worker is live, so the two must agree.
+ *
+ * @internal
+ */
+export const advisoryLockName = (context, id) => JSON.stringify(['kairos-es/feed', context.names.schema, context.names.tablePrefix, id.feed, id.sink]);
+/**
+ * The lease-row kind; see the module doc. Throws on a heartbeat not under its ttl,
+ * or a margin that leaves the heartbeat no room under it.
+ */
+const leaseRowAcquirer = (config, sql, context) => {
+  const {
+    statements
+  } = context;
+  const ttl = Duration.toMillis(positive('lease ttl', config.ttl));
+  const heartbeat = positive('lease heartbeat', config.heartbeat);
+  if (Duration.toMillis(heartbeat) >= ttl) {
+    throw new Error('feed-postgres: the lease heartbeat must be shorter than its ttl, or the lease lapses between renewals');
+  }
+  const margin = config.margin === undefined ? ttl / 3 : Duration.toMillis(positive('lease margin', config.margin));
+  if (Duration.toMillis(heartbeat) + margin >= ttl) {
+    throw new Error('feed-postgres: the lease heartbeat plus its margin must be shorter than its ttl, or ensureHeld fails between two renewals that both landed');
+  }
+  // `ensureHeld` fails once the last renewal is this old: its stored expiry is
+  // then at most `margin` away.
+  const usable = ttl - margin;
+  return id => Effect.gen(function* () {
+    const holder = yield* newHolder('row');
+    const now = yield* Clock.currentTimeMillis;
+    const taken = yield* sql.withTransaction(Effect.gen(function* () {
+      // Held to this transaction's end, so an ADVISORY holder on the row can
+      // be taken over only while no advisory session holds its lock, and no
+      // advisory worker can take the lock before this commits.
+      const lock = yield* sql.unsafe(statements.tryAdvisoryXactLock, [advisoryLockName(context, id)]);
+      return yield* sql.unsafe(statements.takeLeaseRow, [id.feed, id.sink, holder, String(now + ttl), String(now), lock[0]?.taken === true]);
+    })).pipe(Effect.mapError(writeFailed('taking the feed lease')));
+    if (taken.length === 0) {
+      return yield* new LeaseHeld(id);
+    }
+    const state = yield* Ref.make({
+      renewedAt: now,
+      lost: false
+    });
+    yield* Effect.addFinalizer(() => Effect.ignore(sql.unsafe(statements.releaseLease, [id.feed, id.sink, holder])));
+    const renew = Effect.gen(function* () {
+      const at = yield* Clock.currentTimeMillis;
+      const renewed = yield* sql.unsafe(statements.renewLeaseRow, [id.feed, id.sink, holder, String(at + ttl)]);
+      if (renewed.length === 0) {
+        yield* Ref.update(state, s => ({
+          ...s,
+          lost: true
+        }));
+      } else {
+        yield* Ref.update(state, s => ({
+          ...s,
+          renewedAt: at
+        }));
+      }
+    }).pipe(
+    // Bounded by the heartbeat, so a renewal that hangs is abandoned in time
+    // for the next tick rather than holding every later one behind it. An
+    // abandoned renewal whose cancel comes too late can still land: it touches
+    // only this holder's own row, never moves its expiry back
+    // (`renewLeaseRow`), and leaves `renewedAt` at the last renewal this fibre
+    // saw land, so `ensureHeld` errs early, never late.
+    Effect.timeoutOption(heartbeat), Effect.flatMap(done => Option.isSome(done) ? Effect.void : Effect.logWarning('feed lease renewal timed out', {
+      feed: id.feed,
+      sink: id.sink
+    })),
+    // A renewal that could not be made is not yet a lost lease: the age
+    // check in `ensureHeld` decides that, a margin before the lease lapses.
+    Effect.catchTag('SqlError', cause => Effect.logWarning('feed lease renewal failed', {
+      feed: id.feed,
+      sink: id.sink,
+      reason: cause.message
+    })));
+    // On a fixed cadence from the take: a renewal never outlasts the interval,
+    // so each one starts on its own tick whatever became of the one before. A
+    // worker that falls behind (a pause) renews once at once, and does not
+    // replay the ticks it missed.
+    const interval = Duration.toMillis(heartbeat);
+    yield* Effect.forkScoped(Effect.gen(function* () {
+      let next = now + interval;
+      while (true) {
+        const at = yield* Clock.currentTimeMillis;
+        if (next > at) {
+          yield* Effect.sleep(Duration.millis(next - at));
+        }
+        yield* renew;
+        next = Math.max(next + interval, yield* Clock.currentTimeMillis);
+      }
+    }));
+    const lease = {
+      holder,
+      ensureHeld: Effect.gen(function* () {
+        const s = yield* Ref.get(state);
+        const at = yield* Clock.currentTimeMillis;
+        if (s.lost || at - s.renewedAt >= usable) {
+          return yield* new LeaseLost(id);
+        }
+      })
+    };
+    return lease;
+  });
+};
+/** The advisory-lock kind; see the module doc. Throws on a recognisably pooled connection. */
+const advisoryLockAcquirer = (config, sql, context) => {
+  const fault = pooledConnectionFault(config.connection);
+  if (fault !== undefined) {
+    throw new Error(`feed-postgres: ${fault}`);
+  }
+  const {
+    connection
+  } = config;
+  const {
+    statements
+  } = context;
+  return id => Effect.gen(function* () {
+    const lockName = advisoryLockName(context, id);
+    const session = yield* connection.reserve.pipe(Effect.mapError(unreadable('reserving the feed lease connection')));
+    const taken = yield* session.execute(statements.tryAdvisoryLock, [lockName], undefined).pipe(Effect.mapError(unreadable('taking the feed advisory lock')));
+    if (taken[0]?.taken !== true) {
+      return yield* new LeaseHeld(id);
+    }
+    yield* Effect.addFinalizer(() => Effect.ignore(session.execute(statements.advisoryUnlock, [lockName], undefined)));
+    const holder = yield* newHolder('advisory');
+    const now = yield* Clock.currentTimeMillis;
+    // On the lock's own session, and conditional on it still holding the lock:
+    // a session that died since the try-lock cannot run it, and one that lost
+    // the lock lands nothing, so neither overwrites a successor's claim.
+    const claimed = yield* session.execute(statements.claimAdvisoryHolder, [id.feed, id.sink, holder, String(now), lockName], undefined).pipe(Effect.mapError(writeFailed('recording the feed lease holder')));
+    if (claimed.length === 0) {
+      // A live lease row holds the sink, or this session no longer holds the
+      // lock, so this worker must not send. The lock
+      // guards nothing now, so it is let go at once rather than when the
+      // caller's scope closes, and another advisory worker may try the moment
+      // that lease row lapses. The finalizer's second unlock then finds nothing
+      // held, which is harmless.
+      yield* Effect.ignore(session.execute(statements.advisoryUnlock, [lockName], undefined));
+      return yield* new LeaseHeld(id);
+    }
+    yield* Effect.addFinalizer(() => Effect.ignore(sql.unsafe(statements.releaseLease, [id.feed, id.sink, holder])));
+    const held = session.execute(statements.holdsAdvisoryLock, [lockName], undefined).pipe(Effect.map(rows => rows[0]?.held === true), Effect.catchTag('SqlError', () => Effect.succeed(false)));
+    const lease = {
+      holder,
+      // Asked of the session that holds the lock, so a dead session cannot
+      // answer, and an unanswered question is a lost lease.
+      ensureHeld: Effect.flatMap(held, yes => yes ? Effect.void : Effect.fail(new LeaseLost(id)))
+    };
+    return lease;
+  });
+};
+/**
+ * Build the acquirer for `config`, checking it first: a `heartbeat` that is not
+ * shorter than its `ttl`, a `margin` that leaves the heartbeat no room under the
+ * `ttl`, or an `advisoryLock` connection recognisably pooled,
+ * throws here, which the store's factory turns into a defect at construction.
+ * The one place the lease kind is dispatched on.
+ *
+ * @internal
+ */
+export const makeAcquireLease = (config, sql, context) => {
+  switch (config._tag) {
+    case 'LeaseRow':
+      return leaseRowAcquirer(config, sql, context);
+    case 'AdvisoryLock':
+      return advisoryLockAcquirer(config, sql, context);
+  }
+};
+//# sourceMappingURL=lease.js.map

package/dist/esm/lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.js","names":["LeaseHeld","LeaseHolder","LeaseLost","Clock","Duration","Effect","Option","Random","Redacted","Ref","unreadable","writeFailed","DEFAULT_LEASE_TTL","seconds","DEFAULT_LEASE_HEARTBEAT","leaseRow","options","_tag","ttl","heartbeat","margin","undefined","advisoryLock","connection","pooledConnectionFault","client","config","host","port","url","hosts","ports","pgbouncer","rawUrl","isRedacted","value","parsed","URL","push","hostname","Number","searchParams","get","signs","some","h","includes","length","join","positive","label","input","decoded","fromInputUnsafe","isFinite","toMillis","Error","newHolder","kind","gen","high","nextIntBetween","low","make","toString","padStart","advisoryLockName","context","id","JSON","stringify","names","schema","tablePrefix","feed","sink","leaseRowAcquirer","sql","statements","usable","holder","now","currentTimeMillis","taken","withTransaction","lock","unsafe","tryAdvisoryXactLock","takeLeaseRow","String","pipe","mapError","state","renewedAt","lost","addFinalizer","ignore","releaseLease","renew","at","renewed","renewLeaseRow","update","s","timeoutOption","flatMap","done","isSome","void","logWarning","catchTag","cause","reason","message","interval","forkScoped","next","sleep","millis","Math","max","lease","ensureHeld","advisoryLockAcquirer","fault","lockName","session","reserve","execute","tryAdvisoryLock","advisoryUnlock","claimed","claimAdvisoryHolder","held","holdsAdvisoryLock","map","rows","succeed","yes","fail","makeAcquireLease"],"sources":["../../src/lease.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": []
+}

package/dist/esm/syncStore.js

@@ -0,0 +1,171 @@
+/**
+ * The Postgres `FeedSyncStore`: every sink's cursor, its parked list and its
+ * worker lease, kept in the source database beside the feed rows (ADR-0019 §10).
+ *
+ * `@kairos-es/feed`'s `FeedSyncStore.ts` owns the contract, and the in-memory feed
+ * is the oracle this store is held to; what is here is how each atomic step the
+ * contract names becomes one transaction or one statement.
+ *
+ * - `casCursor` is ONE transaction: the guarded, holder-fenced cursor update,
+ *   stamped with its `lastAdvance` from this process's `Clock`, and the parked
+ *   list moved with it. A guard that loses fails `CursorSuperseded` inside the
+ *   transaction, which rolls back the parked changes with it, so a park can never
+ *   outlive a refused advance.
+ * - `retryParked` is one transaction that takes the feed lock exclusively before it
+ *   re-stamps the row, so its new `seq` cannot commit out of order with the
+ *   materialisation's own writes (`internal/statements.ts` owns that argument).
+ * - `collectTombstones` is one statement that reads every registered sink's cursor
+ *   and deletes below the lowest, or nothing while any of them has no cursor, so
+ *   no cursor can move between the two.
+ * - `removeSink` is one transaction that first takes the sink's advisory lock for
+ *   its own length, which an advisory worker's session lock refuses, then deletes
+ *   the cursor row only when no live lease row holds it, in the same statement as
+ *   that test, and the parks after it. Both tests are therefore made whichever
+ *   lease kind this store was built with: a sink can be leased by either kind
+ *   (`lease.ts` owns how the two coexist), and the row alone cannot say whether
+ *   an advisory holder's session is alive.
+ * - `describe` is three reads, each its own snapshot, so a figure in it can be a
+ *   batch older or newer than the next. It is a report for an operator, and no
+ *   decision is taken on it.
+ *
+ * One store serves every feed in its prefix: unlike the in-memory feed, whose
+ * store belongs to one feed, a SQL store's state is keyed by feed name in shared
+ * tables, so a single store value is what every worker over the prefix takes.
+ *
+ * Infrastructure faults are `FeedUnreadable` on a read and `FeedWriteFailed` on a
+ * write, never defects, so the driver's supervision backs off and tries again.
+ */
+import { CursorSuperseded, FeedKey, FeedSeq, Generation, LeaseHeld, LeaseHolder, SinkName } from '@kairos-es/feed';
+import { Clock, DateTime, Effect, Option } from 'effect';
+import { SqlClient } from 'effect/sql';
+import { bigintOf, feedContext, unreadable, writeFailed } from "./internal/context.js";
+import { advisoryLockName, leaseRow, makeAcquireLease } from "./lease.js";
+/** A timestamp column read back as epoch milliseconds, or `None` when NULL. */
+const instantOf = ms => ms === null ? Option.none() : Option.some(DateTime.makeUnsafe(Number(ms)));
+const cursorOf = row => row === undefined || row.generation === null || row.seq === null ? Option.none() : Option.some({
+  generation: Generation.make(bigintOf(row.generation)),
+  seq: FeedSeq.make(bigintOf(row.seq))
+});
+const parkedOf = row => ({
+  key: FeedKey.make(row.key),
+  seq: FeedSeq.make(bigintOf(row.seq)),
+  reason: row.reason,
+  parkedAt: DateTime.makeUnsafe(Number(row.parked_at_ms))
+});
+/** Park entries as the `jsonb` parameter the park statement takes; last per key wins. */
+const parkJson = park => {
+  const byKey = new Map();
+  for (const record of park) {
+    byKey.delete(record.key);
+    byKey.set(record.key, record);
+  }
+  return JSON.stringify(Array.from(byKey.values(), record => ({
+    key: record.key,
+    seq: record.seq.toString(),
+    reason: record.reason,
+    parked_at_ms: String(DateTime.toEpochMillis(record.parkedAt))
+  })));
+};
+/**
+ * Build the sync store over the ambient `SqlClient`. Dies at construction on a
+ * malformed config, a lease whose heartbeat is not shorter than its ttl or leaves
+ * no room for its margin, or an `advisoryLock` connection recognisably pooled.
+ * `ensureFeedSchema` must have run.
+ */
+export const makePostgresFeedSyncStore = (options = {}) => Effect.gen(function* () {
+  const sql = (yield* SqlClient.SqlClient).withoutTransforms();
+  const context = feedContext(options.config ?? {});
+  const acquireLease = makeAcquireLease(options.lease ?? leaseRow(), sql, context);
+  const {
+    statements
+  } = context;
+  const readCursor = id => sql.unsafe(statements.selectCursor, [id.feed, id.sink]).pipe(Effect.mapError(unreadable(`reading the cursor of sink '${id.sink}'`)), Effect.map(rows => cursorOf(rows[0])));
+  const casCursor = args => sql.withTransaction(Effect.gen(function* () {
+    const expected = Option.getOrUndefined(args.expected);
+    const now = yield* DateTime.now;
+    const landed = yield* sql.unsafe(statements.casCursor, [args.feed, args.sink, args.holder, args.next.generation.toString(), args.next.seq.toString(), expected === undefined ? null : expected.generation.toString(), expected === undefined ? null : expected.seq.toString(), String(DateTime.toEpochMillis(now))]);
+    if (landed.length === 0) {
+      return yield* new CursorSuperseded({
+        feed: args.feed,
+        sink: args.sink
+      });
+    }
+    const change = args.parked;
+    if (change._tag === 'Replace') {
+      yield* sql.unsafe(statements.clearParked, [args.feed, args.sink]);
+    } else if (change.unpark.length > 0) {
+      yield* sql.unsafe(statements.unparkKeys, [args.feed, args.sink, JSON.stringify(change.unpark)]);
+    }
+    if (change.park.length > 0) {
+      yield* sql.unsafe(statements.parkKeys, [args.feed, args.sink, parkJson(change.park)]);
+    }
+  })).pipe(Effect.catchTag('SqlError', cause => Effect.fail(writeFailed(`moving the cursor of sink '${args.sink}'`)(cause))));
+  const readParked = id => sql.unsafe(statements.selectParked, [id.feed, id.sink]).pipe(Effect.mapError(unreadable(`reading the parked records of sink '${id.sink}'`)), Effect.map(rows => rows.map(parkedOf)));
+  const retryParked = args => sql.withTransaction(Effect.gen(function* () {
+    yield* sql.unsafe(statements.lockFeedExclusive, [args.feed]);
+    const unparked = yield* sql.unsafe(statements.unparkOne, [args.feed, args.sink, args.key]);
+    if (unparked.length === 0) {
+      return false;
+    }
+    yield* sql.unsafe(statements.restampRow, [args.feed, args.key]);
+    return true;
+  })).pipe(Effect.mapError(writeFailed(`retrying parked record '${args.key}' of sink '${args.sink}'`)));
+  const collectTombstones = feed => sql.unsafe(statements.collectTombstones, [feed]).pipe(Effect.mapError(writeFailed(`collecting the tombstones of feed '${feed}'`)), Effect.map(rows => rows.length));
+  const removeSink = id => sql.withTransaction(Effect.gen(function* () {
+    const lock = yield* sql.unsafe(statements.tryAdvisoryXactLock, [advisoryLockName(context, id)]);
+    if (lock[0]?.taken !== true) {
+      return yield* new LeaseHeld(id);
+    }
+    const now = yield* Clock.currentTimeMillis;
+    const cursor = yield* sql.unsafe(statements.deleteCursorUnlessLeased, [id.feed, id.sink, String(now)]);
+    if (cursor.length === 0) {
+      const left = yield* sql.unsafe(statements.cursorExists, [id.feed, id.sink]);
+      if (left.length > 0) {
+        return yield* new LeaseHeld(id);
+      }
+    }
+    const parked = yield* sql.unsafe(statements.deleteSinkParked, [id.feed, id.sink]);
+    return cursor.length > 0 || parked.length > 0;
+  })).pipe(Effect.catchTag('SqlError', cause => Effect.fail(writeFailed(`removing sink '${id.sink}'`)(cause))));
+  const describe = feed => Effect.gen(function* () {
+    const head = yield* sql.unsafe(statements.selectHead, [feed]);
+    const sinks = yield* sql.unsafe(statements.describeSinks, [feed]);
+    const parked = yield* sql.unsafe(statements.describeParked, [feed]);
+    const parkedBySink = new Map();
+    for (const record of parked) {
+      const list = parkedBySink.get(record.sink);
+      if (list === undefined) {
+        parkedBySink.set(record.sink, [parkedOf(record)]);
+      } else {
+        list.push(parkedOf(record));
+      }
+    }
+    const description = {
+      head: FeedSeq.make(bigintOf(head[0]?.head ?? '0')),
+      sinks: sinks.map(row => ({
+        sink: SinkName.make(row.sink),
+        cursor: cursorOf(row),
+        lastAdvance: instantOf(row.last_advance_at_ms),
+        lease: row.lease_holder === null ? Option.none() : Option.some({
+          holder: LeaseHolder.make(row.lease_holder),
+          expiresAt: instantOf(row.lease_expires_at_ms)
+        }),
+        parked: parkedBySink.get(row.sink) ?? [],
+        pending: Number(row.pending)
+      }))
+    };
+    return description;
+  }).pipe(Effect.mapError(unreadable(`describing feed '${feed}'`)));
+  const store = {
+    acquireLease,
+    readCursor,
+    casCursor,
+    readParked,
+    retryParked,
+    collectTombstones,
+    removeSink,
+    describe
+  };
+  return store;
+});
+//# sourceMappingURL=syncStore.js.map

package/dist/esm/syncStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncStore.js","names":["CursorSuperseded","FeedKey","FeedSeq","Generation","LeaseHeld","LeaseHolder","SinkName","Clock","DateTime","Effect","Option","SqlClient","bigintOf","feedContext","unreadable","writeFailed","advisoryLockName","leaseRow","makeAcquireLease","instantOf","ms","none","some","makeUnsafe","Number","cursorOf","row","undefined","generation","seq","make","parkedOf","key","reason","parkedAt","parked_at_ms","parkJson","park","byKey","Map","record","delete","set","JSON","stringify","Array","from","values","toString","String","toEpochMillis","makePostgresFeedSyncStore","options","gen","sql","withoutTransforms","context","config","acquireLease","lease","statements","readCursor","id","unsafe","selectCursor","feed","sink","pipe","mapError","map","rows","casCursor","args","withTransaction","expected","getOrUndefined","now","landed","holder","next","length","change","parked","_tag","clearParked","unpark","unparkKeys","parkKeys","catchTag","cause","fail","readParked","selectParked","retryParked","lockFeedExclusive","unparked","unparkOne","restampRow","collectTombstones","removeSink","lock","tryAdvisoryXactLock","taken","currentTimeMillis","cursor","deleteCursorUnlessLeased","left","cursorExists","deleteSinkParked","describe","head","selectHead","sinks","describeSinks","describeParked","parkedBySink","list","get","push","description","lastAdvance","last_advance_at_ms","lease_holder","expiresAt","lease_expires_at_ms","pending","store"],"sources":["../../src/syncStore.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/withFeed.js

@@ -0,0 +1,44 @@
+import { ProjectionStoreError } from '@kairos-es/read';
+import { Effect } from 'effect';
+import { SqlClient } from 'effect/sql';
+import { contextOf } from "./feed.js";
+import { writeFailed } from "./internal/context.js";
+const sameKey = (left, right) => left.projection === right.projection && left.partition === right.partition;
+/**
+ * `store`, with `resetCheckpoint` for `key` also emptying `feed` and moving its
+ * generation on; see the module doc. Every other key passes through untouched.
+ */
+export const withFeed = (store, feed, key) => Effect.gen(function* () {
+  const context = contextOf(feed);
+  if (context === undefined) {
+    return yield* Effect.die(new Error(`withFeed: feed '${feed.feed}' was not made by makePostgresFeed`));
+  }
+  if (store.durability !== 'durable') {
+    return yield* Effect.die(new Error(`withFeed: feed '${feed.feed}' is written inside the store's commit transaction, and an ephemeral store opens none`));
+  }
+  const {
+    statements
+  } = context;
+  const sql = (yield* SqlClient.SqlClient).withoutTransforms();
+  const bound = yield* sql.unsafe(statements.bindFeed, [feed.feed, key.projection, key.partition]).pipe(Effect.mapError(writeFailed(`binding feed '${feed.feed}'`)));
+  const binding = bound[0];
+  if (binding !== undefined && (binding.projection !== key.projection || binding.partition !== key.partition)) {
+    return yield* Effect.die(new Error(`withFeed: feed '${feed.feed}' is already bound to projection '${binding.projection}' (partition '${binding.partition}'), and one feed serves one materialisation`));
+  }
+  const resetBound = reset => sql.withTransaction(Effect.gen(function* () {
+    yield* sql.unsafe(statements.bumpGeneration, [feed.feed]);
+    yield* store.resetCheckpoint(reset);
+    yield* sql.unsafe(statements.deleteFeedRows, [feed.feed]);
+  })).pipe(Effect.catchTag('SqlError', cause => Effect.fail(new ProjectionStoreError({
+    reason: `resetting projection '${reset.projection}' partition '${reset.partition}' and its feed '${feed.feed}' failed: ${cause.message}`,
+    cause
+  }))));
+  const decorated = {
+    durability: store.durability,
+    readCheckpoint: store.readCheckpoint,
+    commit: store.commit,
+    resetCheckpoint: reset => sameKey(reset, key) ? resetBound(reset) : store.resetCheckpoint(reset)
+  };
+  return decorated;
+});
+//# sourceMappingURL=withFeed.js.map

package/dist/esm/withFeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withFeed.js","names":["ProjectionStoreError","Effect","SqlClient","contextOf","writeFailed","sameKey","left","right","projection","partition","withFeed","store","feed","key","gen","context","undefined","die","Error","durability","statements","sql","withoutTransforms","bound","unsafe","bindFeed","pipe","mapError","binding","resetBound","reset","withTransaction","bumpGeneration","resetCheckpoint","deleteFeedRows","catchTag","cause","fail","reason","message","decorated","readCheckpoint","commit"],"sources":["../../src/withFeed.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}