@pg-prime/events 0.0.0-stage → 0.2.0

package/dist/events.d.ts

@@ -0,0 +1,57 @@
+import type { AsyncDisposable_, Db } from 'pg-prime';
+import type { ChannelHandle } from './channel.js';
+import type { ChannelDef, EventsDefinitions, PayloadOf, SubscriptionDef, TopicDef } from './define.js';
+import type { EventsHooks, Hooks } from './hooks.js';
+import type { Statements } from './log/sql.js';
+import type { SubscriptionHandle } from './log/subscription.js';
+import type { TopicHandle } from './log/topic.js';
+export interface EventsConfig<D extends EventsDefinitions> {
+    db: Db;
+    /** Default `'pgprime_events'`. */
+    schema?: string;
+    /** Default true; false only checks the version and throws `SchemaVersionError` when behind. */
+    autoMigrate?: boolean;
+    define?: D;
+    hooks?: EventsHooks;
+}
+export interface Events<D extends EventsDefinitions> extends AsyncDisposable_ {
+    readonly channels: {
+        readonly [K in keyof D['channels']]: ChannelHandle<PayloadOf<D['channels'][K]>>;
+    };
+    readonly topics: {
+        readonly [K in keyof D['topics']]: TopicHandle<PayloadOf<D['topics'][K]>>;
+    };
+    readonly subscriptions: {
+        readonly [K in keyof D['subscriptions']]: SubscriptionHandle<PayloadOf<D['subscriptions'][K]>>;
+    };
+    channel<T>(def: ChannelDef<T>): ChannelHandle<T>;
+    topic<T>(def: TopicDef<T>): TopicHandle<T>;
+    subscription<T>(def: SubscriptionDef<T>): SubscriptionHandle<T>;
+    /** Migrates and upserts the declared topics and subscriptions; required before any `{ tx }` call. */
+    start(): Promise<void>;
+    /** Applies missing schema versions, whatever `autoMigrate` says. */
+    migrate(): Promise<{
+        from: number;
+        to: number;
+    }>;
+    observe(hooks: EventsHooks): () => void;
+    /** Stops every reader and tail this instance started; `db` stays open. */
+    close(): Promise<void>;
+}
+/** What the handles share. */
+export interface Core {
+    readonly db: Db;
+    readonly sql: Statements;
+    readonly hooks: Hooks;
+    /** Readers and tails, closed by `events.close()`. */
+    readonly running: Set<{
+        close(): Promise<void>;
+    }>;
+    topicChannel(topic: string): string;
+    /** Ensures the schema, then upserts the topic, or the subscription with its cursor seeded once. */
+    ready(def: TopicDef<any> | SubscriptionDef<any>): Promise<void>;
+    forget(def: SubscriptionDef<any>): void;
+    assertStarted(what: string): void;
+}
+export declare function pgEvents<const D extends EventsDefinitions = {}>(config: EventsConfig<D>): Events<D>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/events.js

@@ -0,0 +1,99 @@
+import { ConfigError, migrateOwnedSchema, quoteIdentPart } from 'pg-prime';
+import { channelHandle, engineChannel } from './channel.js';
+import { NotStartedError, SchemaVersionError } from './errors.js';
+import { createHooks } from './hooks.js';
+import { BEGINNING, seed } from './log/cursor.js';
+import { MIGRATIONS } from './log/migrations.js';
+import { statements } from './log/sql.js';
+import { subscriptionHandle } from './log/subscription.js';
+import { topicHandle } from './log/topic.js';
+import { ASYNC_DISPOSE } from './util.js';
+export function pgEvents(config) {
+    const { db, define = {} } = config;
+    const schema = config.schema ?? 'pgprime_events';
+    quoteIdentPart(schema);
+    const sql = statements(schema);
+    const hooks = createHooks(config.hooks);
+    let ensuring;
+    let ensured = false;
+    const memo = new Map();
+    const key = (def) => def.kind === 'topic' ? `t/${def.name}` : `s/${def.topic.name}/${def.name}`;
+    const migrate = async (apply) => {
+        try {
+            const r = await migrateOwnedSchema(db, { schema, migrations: MIGRATIONS, apply });
+            if (r.to < MIGRATIONS.length) {
+                throw new SchemaVersionError(`@pg-prime/events: schema ${schema} is at version ${r.to} and this client needs ` +
+                    `${MIGRATIONS.length}. Run events.migrate().`);
+            }
+            ensured = true;
+            return r;
+        }
+        catch (e) {
+            throw e instanceof ConfigError ? new SchemaVersionError(e.message, e) : e;
+        }
+    };
+    const ensure = () => (ensuring ??= migrate(config.autoMigrate !== false).catch((e) => {
+        ensuring = undefined;
+        throw e;
+    }));
+    const core = {
+        db,
+        sql,
+        hooks,
+        running: new Set(),
+        topicChannel: (topic) => engineChannel(schema, 't', topic),
+        ready(def) {
+            const k = key(def);
+            let p = memo.get(k);
+            if (p === undefined) {
+                p = (async () => {
+                    await ensure();
+                    if (def.kind === 'topic') {
+                        return sql.upsertTopic(db, def.name, def.keepMs, def.keepUntilConsumed);
+                    }
+                    await core.ready(def.topic);
+                    const c = def.from === 'beginning'
+                        ? BEGINNING
+                        : await sql.seedNow(db).then((x) => seed(x.xmax, x.xip));
+                    await sql.upsertSubscription(db, def.topic.name, def.name, def.types, c);
+                })();
+                p.catch(() => memo.delete(k));
+                memo.set(k, p);
+            }
+            return p;
+        },
+        forget: (def) => void memo.delete(key(def)),
+        assertStarted(what) {
+            if (!ensured)
+                throw new NotStartedError(what);
+        },
+    };
+    const handles = (defs, f) => Object.freeze(Object.fromEntries(Object.entries(defs ?? {}).map(([k, d]) => [k, f(d)])));
+    const close = async () => {
+        await Promise.all([...core.running].map((r) => r.close()));
+    };
+    return {
+        channels: handles(define.channels, (d) => channelHandle(db, d)),
+        topics: handles(define.topics, (d) => topicHandle(core, d)),
+        subscriptions: handles(define.subscriptions, (d) => subscriptionHandle(core, d)),
+        channel: (def) => channelHandle(db, def),
+        topic: (def) => topicHandle(core, def),
+        subscription: (def) => subscriptionHandle(core, def),
+        async start() {
+            await ensure();
+            for (const d of Object.values(define.topics ?? {}))
+                await core.ready(d);
+            for (const d of Object.values(define.subscriptions ?? {}))
+                await core.ready(d);
+        },
+        migrate: async () => {
+            const r = await migrate(true);
+            ensuring = Promise.resolve(r);
+            return r;
+        },
+        observe: (h) => hooks.observe(h),
+        close,
+        [ASYNC_DISPOSE]: close,
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -0,0 +1,40 @@
+export type InternalKind = 'listen-unavailable' | 'heartbeat-failed' | 'subscription-behind-retention' | 'reader-failed' | 'hook-failed';
+export interface EventsHooks {
+    onPublish?(e: {
+        topic: string;
+        count: number;
+        inTx: boolean;
+    }): void;
+    onDeliver?(e: {
+        topic: string;
+        subscription: string;
+        count: number;
+        durationMs: number;
+    }): void;
+    onRetry?(e: {
+        topic: string;
+        subscription: string;
+        entry: bigint;
+        attempt: number;
+        error: unknown;
+    }): void;
+    onPark?(e: {
+        topic: string;
+        subscription: string;
+        entry: bigint;
+        error: unknown;
+    }): void;
+    onInternal?(e: {
+        kind: InternalKind;
+        message: string;
+        cause?: unknown;
+    }): void;
+}
+/** Fan-out to every observer; a throwing hook is reported as `hook-failed`, never rethrown. */
+export interface Hooks {
+    emit<K extends keyof EventsHooks>(name: K, e: Parameters<NonNullable<EventsHooks[K]>>[0]): void;
+    internal(kind: InternalKind, message: string, cause?: unknown): void;
+    observe(h: EventsHooks): () => void;
+}
+export declare function createHooks(initial?: EventsHooks): Hooks;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,+BAA+B,GAC/B,eAAe,GACf,aAAa,CAAA;AAEjB,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IACpE,SAAS,CAAC,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC/F,OAAO,CAAC,CAAC,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAA;QACb,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,OAAO,CAAA;KACf,GAAG,IAAI,CAAA;IACR,MAAM,CAAC,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IACxF,UAAU,CAAC,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/E;AAED,+FAA+F;AAC/F,MAAM,WAAW,KAAK;IACpB,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC/F,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpE,OAAO,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAAA;CACpC;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,KAAK,CAsBxD"}

package/dist/hooks.js

@@ -0,0 +1,27 @@
+export function createHooks(initial) {
+    const all = new Set(initial === undefined ? [] : [initial]);
+    const hooks = {
+        emit(name, e) {
+            for (const h of all) {
+                try {
+                    ;
+                    h[name]?.call(h, e);
+                }
+                catch (cause) {
+                    if (name === 'onInternal')
+                        continue;
+                    hooks.internal('hook-failed', `@pg-prime/events: the ${name} hook threw.`, cause);
+                }
+            }
+        },
+        internal(kind, message, cause) {
+            hooks.emit('onInternal', cause === undefined ? { kind, message } : { kind, message, cause });
+        },
+        observe(h) {
+            all.add(h);
+            return () => void all.delete(h);
+        },
+    };
+    return hooks;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAc,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACxE,MAAM,KAAK,GAAU;QACnB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,CAAC;oBAAC,CAAC,CAAC,IAAI,CAAwC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBAC9D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,IAAI,KAAK,YAAY;wBAAE,SAAQ;oBACnC,KAAK,CAAC,QAAQ,CAAC,aAAa,EAAE,yBAAyB,IAAI,cAAc,EAAE,KAAK,CAAC,CAAA;gBACnF,CAAC;YACH,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK;YAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9F,CAAC;QACD,OAAO,CAAC,CAAC;YACP,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACV,OAAO,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACjC,CAAC;KACF,CAAA;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { defineChannel, defineSubscription, defineTopic } from './define.js';
+export type { ChannelDef, EventsDefinitions, PayloadOf, RetryOptions, SubscriptionDef, TopicDef, } from './define.js';
+export type { PayloadOptions, StandardSchemaV1 } from './payload.js';
+export { pgEvents } from './events.js';
+export type { Events, EventsConfig } from './events.js';
+export { engineChannel, engineChannelSql } from './channel.js';
+export type { ChannelHandle } from './channel.js';
+export { waker } from './waker.js';
+export type { WakeReason, Waker, WakerOptions } from './waker.js';
+export type { Entry, PublishOptions, TopicHandle } from './log/topic.js';
+export type { BatchHandler, EntryHandler, ReadContext, Reader, RunOptions, SubscriptionHandle, } from './log/subscription.js';
+export type { EventsHooks, InternalKind } from './hooks.js';
+export { EventsLeaseLostError, NotStartedError, PayloadError, SchemaVersionError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5E,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACjE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACxE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,EACN,UAAU,EACV,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { defineChannel, defineSubscription, defineTopic } from './define.js';
+export { pgEvents } from './events.js';
+export { engineChannel, engineChannelSql } from './channel.js';
+export { waker } from './waker.js';
+export { EventsLeaseLostError, NotStartedError, PayloadError, SchemaVersionError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAU5E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE9D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAYlC,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAA"}

package/dist/log/cursor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Position `(xid, id)` plus `pending`: transactions below the position that were still running
+ * when a read stepped over them, each mapped to the last id delivered from it (0: none).
+ */
+export interface Cursor {
+    readonly xid: bigint;
+    readonly id: bigint;
+    readonly pending: ReadonlyMap<bigint, bigint>;
+}
+/**
+ * What a read saw: the last unfiltered `next` row, the last unfiltered `late` row when `late`
+ * filled the read limit (more may follow), and the snapshot's running xids.
+ */
+export interface ReadView {
+    readonly pos: {
+        readonly xid: bigint;
+        readonly id: bigint;
+    } | null;
+    readonly late: {
+        readonly xid: bigint;
+        readonly id: bigint;
+    } | null;
+    readonly running: readonly bigint[];
+}
+export declare const BEGINNING: Cursor;
+/** `from: 'now'`: everything that commits after the snapshot `(xmax, xip)`. */
+export declare function seed(xmax: bigint, xip: readonly bigint[]): Cursor;
+/** The cursor right after acknowledging `e`, one entry of `read`. */
+export declare function advance(c: Cursor, read: ReadView, e: {
+    xid: bigint;
+    id: bigint;
+}): Cursor;
+/** The cursor once everything `read` delivered is acknowledged, even when it delivered nothing. */
+export declare function advanceTo(c: Cursor, read: ReadView): Cursor;
+export declare function encodeCursor(c: Cursor): string;
+export declare function decodeCursor(s: string): Cursor;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/log/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/log/cursor.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAClE,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,eAAO,MAAM,SAAS,EAAE,MAAgD,CAAA;AAExE,+EAA+E;AAC/E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEjE;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQzF;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAa3D;AAMD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9C;AAID,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAW9C"}

package/dist/log/cursor.js

@@ -0,0 +1,58 @@
+import { UsageError } from 'pg-prime';
+export const BEGINNING = { xid: 0n, id: 0n, pending: new Map() };
+/** `from: 'now'`: everything that commits after the snapshot `(xmax, xip)`. */
+export function seed(xmax, xip) {
+    return { xid: xmax, id: 0n, pending: new Map(xip.map((x) => [x, 0n])) };
+}
+/** The cursor right after acknowledging `e`, one entry of `read`. */
+export function advance(c, read, e) {
+    const pending = new Map(c.pending);
+    if (pending.has(e.xid)) {
+        pending.set(e.xid, e.id);
+        return { xid: c.xid, id: c.id, pending };
+    }
+    addRunning(pending, read.running, e.xid);
+    return { xid: e.xid, id: e.id, pending };
+}
+/** The cursor once everything `read` delivered is acknowledged, even when it delivered nothing. */
+export function advanceTo(c, read) {
+    const pending = new Map(c.pending);
+    if (read.pos !== null)
+        addRunning(pending, read.running, read.pos.xid);
+    const running = new Set(read.running);
+    // A finished transaction's entries are all visible, and `late` reads them in (xid, id) order.
+    for (const x of pending.keys()) {
+        if (running.has(x) || (read.late !== null && x > read.late.xid))
+            continue;
+        if (x === read.late?.xid)
+            pending.set(x, read.late.id);
+        else
+            pending.delete(x);
+    }
+    return read.pos === null
+        ? { xid: c.xid, id: c.id, pending }
+        : { xid: read.pos.xid, id: read.pos.id, pending };
+}
+function addRunning(pending, running, below) {
+    for (const x of running)
+        if (x < below && !pending.has(x))
+            pending.set(x, 0n);
+}
+export function encodeCursor(c) {
+    const p = [...c.pending].sort((a, b) => (a[0] < b[0] ? -1 : 1)).map(([x, a]) => `${x}:${a}`);
+    return `${c.xid}.${c.id}${p.length === 0 ? '' : `.${p.join(',')}`}`;
+}
+const CURSOR = /^(\d+)\.(\d+)(?:\.(\d+:\d+(?:,\d+:\d+)*))?$/;
+export function decodeCursor(s) {
+    const m = CURSOR.exec(s);
+    if (m === null) {
+        throw new UsageError(`@pg-prime/events: ${JSON.stringify(s)} is not an Entry.cursor.`);
+    }
+    const pending = new Map();
+    for (const pair of m[3]?.split(',') ?? []) {
+        const [x, a] = pair.split(':');
+        pending.set(BigInt(x), BigInt(a));
+    }
+    return { xid: BigInt(m[1]), id: BigInt(m[2]), pending };
+}
+//# sourceMappingURL=cursor.js.map

package/dist/log/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/log/cursor.ts"],"names":[],"mappings":"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"}

package/dist/log/migrations.d.ts

@@ -0,0 +1,3 @@
+import type { OwnedMigration } from 'pg-prime';
+export declare const MIGRATIONS: readonly OwnedMigration[];
+//# sourceMappingURL=migrations.d.ts.map

package/dist/log/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/log/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,eAAO,MAAM,UAAU,EAAE,SAAS,cAAc,EAqD/C,CAAA"}

package/dist/log/migrations.js

@@ -0,0 +1,55 @@
+export const MIGRATIONS = [
+    {
+        version: 1,
+        name: 'events log',
+        up: (s) => [
+            `create table ${s}.topics (
+        name text primary key,
+        keep_ms bigint,
+        keep_until_consumed boolean not null default false,
+        maint_at timestamptz not null default '-infinity',
+        created_at timestamptz not null default now()
+      )`,
+            `create table ${s}.entries (
+        id bigint generated always as identity primary key,
+        xid xid8 not null default pg_current_xact_id(),
+        topic text not null,
+        type text,
+        key text,
+        payload jsonb not null,
+        headers jsonb,
+        at timestamptz not null default clock_timestamp()
+      )`,
+            `create index entries_cursor on ${s}.entries (topic, xid, id)`,
+            `create index entries_age on ${s}.entries (topic, at)`,
+            `create table ${s}.subscriptions (
+        topic text not null references ${s}.topics (name) on delete cascade,
+        name text not null,
+        types text[],
+        last_xid xid8 not null,
+        last_id bigint not null,
+        pending xid8[] not null default '{}',
+        pending_after bigint[] not null default '{}',
+        token text,
+        lease_until timestamptz,
+        head_id bigint,
+        head_size int not null default 0,
+        head_attempts int not null default 0,
+        head_retry_at timestamptz,
+        updated_at timestamptz not null default now(),
+        primary key (topic, name)
+      ) with (fillfactor = 50)`,
+            `create table ${s}.parked (
+        topic text not null,
+        subscription text not null,
+        entry bigint not null,
+        attempts int not null,
+        error text,
+        parked_at timestamptz not null default clock_timestamp(),
+        primary key (topic, subscription, entry),
+        foreign key (topic, subscription) references ${s}.subscriptions (topic, name) on delete cascade
+      )`,
+        ],
+    },
+];
+//# sourceMappingURL=migrations.js.map

package/dist/log/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/log/migrations.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAA8B;IACnD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,YAAY;QAClB,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACT,gBAAgB,CAAC;;;;;;QAMf;YACF,gBAAgB,CAAC;;;;;;;;;QASf;YACF,kCAAkC,CAAC,2BAA2B;YAC9D,+BAA+B,CAAC,sBAAsB;YACtD,gBAAgB,CAAC;yCACkB,CAAC;;;;;;;;;;;;;;;+BAeX;YACzB,gBAAgB,CAAC;;;;;;;;uDAQgC,CAAC;QAChD;SACH;KACF;CACF,CAAA"}

package/dist/log/sql.d.ts

@@ -0,0 +1,68 @@
+import type { Queryable } from 'pg-prime';
+import type { Cursor, ReadView } from './cursor.js';
+type Q = Queryable<any>;
+export interface EntryRow {
+    readonly id: bigint;
+    readonly xid: bigint;
+    readonly type: string | null;
+    readonly key: string | null;
+    readonly payload: unknown;
+    readonly headers: Record<string, string> | null;
+    readonly at: Date;
+}
+export interface LeaseRow {
+    readonly token: string;
+    readonly cursor: Cursor;
+    readonly types: readonly string[] | null;
+    readonly headId: bigint | null;
+    readonly headSize: number;
+    readonly retryInMs: number;
+}
+export interface NewEntry {
+    readonly type: string | null;
+    readonly key: string | null;
+    readonly headers: Record<string, string> | null;
+    /** Serialized JSON. */
+    readonly payload: string;
+}
+export interface Statements {
+    publish(q: Q, topic: string, channel: string, rows: readonly NewEntry[]): Promise<bigint[]>;
+    seedNow(q: Q): Promise<{
+        xmax: bigint;
+        xip: bigint[];
+    }>;
+    upsertTopic(q: Q, name: string, keepMs: number | null, untilConsumed: boolean): Promise<void>;
+    upsertSubscription(q: Q, t: string, s: string, types: readonly string[] | null, c: Cursor): Promise<void>;
+    lease(q: Q, t: string, s: string, leaseMs: number): Promise<LeaseRow | undefined>;
+    heartbeat(q: Q, t: string, s: string, token: string, leaseMs: number): Promise<boolean>;
+    release(q: Q, t: string, s: string, token: string): Promise<void>;
+    read(q: Q, t: string, c: Cursor, n: number, types: readonly string[] | null): Promise<{
+        view: ReadView;
+        rows: EntryRow[];
+    }>;
+    mark(q: Q, t: string, s: string, token: string, first: bigint, size: number): Promise<number | undefined>;
+    commit(q: Q, t: string, s: string, token: string, c: Cursor): Promise<boolean>;
+    /** The stored cursor, once any transaction updating it has ended. */
+    stored(q: Q, t: string, s: string, token: string): Promise<Cursor | undefined>;
+    nack(q: Q, t: string, s: string, token: string, delayMs: number): Promise<boolean>;
+    park(q: Q, t: string, s: string, token: string, c: Cursor, entry: bigint, attempts: number, error: string | null): Promise<boolean>;
+    maintain(q: Q, t: string, everyMs: number): Promise<{
+        deleted: number;
+        behind: boolean;
+    }>;
+    reset(q: Q, t: string, s: string, c: Cursor): Promise<boolean>;
+    lag(q: Q, t: string, s: string): Promise<{
+        entries: number;
+        oldestAt: Date | null;
+    }>;
+    parked(q: Q, t: string, s: string, limit: number): Promise<(EntryRow & {
+        attempts: number;
+        error: string | null;
+    })[]>;
+    discard(q: Q, t: string, s: string, ids: readonly bigint[]): Promise<number>;
+    remove(q: Q, t: string, s: string): Promise<void>;
+    browse(q: Q, t: string, afterId: bigint, limit: number): Promise<EntryRow[]>;
+}
+export declare function statements(schema: string): Statements;
+export {};
+//# sourceMappingURL=sql.d.ts.map

package/dist/log/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/log/sql.ts"],"names":[],"mappings":"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"}