gemi 0.110.0 → 0.112.0

package/dist/services/change-feed/ChangeFeedManager.d.ts

@@ -0,0 +1,166 @@
+import type { Application } from "../../foundation/Application";
+import type { ChangeFeedDriver, ChangeFeedEvent } from "./ChangeFeedDriver";
+import { type ChangeFeedConfig } from "./config";
+import { type ChangeFeedResponse, type StreamOptions } from "./stream";
+/** The longest channel name, in characters. */
+export declare const MAX_CHANNEL_LENGTH = 255;
+/** This process already holds `maxSubscriptions` subscriptions. */
+export declare class ChangeFeedFullError extends Error {
+    readonly limit: number;
+    constructor(limit: number);
+}
+export type SubscribeOptions = {
+    /**
+     * Where to resume: a cursor string (an SSE event's `id`, or `cursor()`) or
+     * a map of channel to seq. A channel without a position starts at its head,
+     * so it delivers only what is published from now on.
+     */
+    cursor?: string | ReadonlyMap<string, number> | Record<string, number> | null;
+    /** Ends the subscription when it aborts. */
+    signal?: AbortSignal;
+};
+/**
+ * Change feeds: publish "channel K changed", and follow channels from a
+ * cursor, in this process or any other sharing the driver's store.
+ *
+ * ```ts
+ * await ChangeFeed.publish(`site:${site.id}`, { pages: ["/about"] });
+ *
+ * for await (const event of ChangeFeed.subscribe([`site:${site.id}`], { signal })) {
+ *   // { type: "change", channel, seq, data } or { type: "reset", channel, seq }
+ * }
+ * ```
+ *
+ * The driver's log is the truth, and notifications only wake subscribers to
+ * read it. A subscription keeps no queue of its own, only which of its
+ * channels may have moved; it reads the log when its consumer asks for the
+ * next event. So a slow consumer costs nothing while it is behind, and one
+ * that fell further behind than the log keeps gets a `reset`.
+ */
+export declare class ChangeFeedManager {
+    private readonly options;
+    static token: string;
+    readonly driver: ChangeFeedDriver;
+    readonly config: Required<ChangeFeedConfig>;
+    private readonly followers;
+    private readonly all;
+    private listenState;
+    private listening;
+    private retryTimer;
+    private backoffMs;
+    private pollTimer;
+    private polling;
+    constructor(config?: ChangeFeedConfig, options?: {
+        application?: Application;
+    });
+    /** How many subscriptions this process holds. */
+    get subscriptions(): number;
+    /** Whether this process is listening for other processes' publishes. */
+    get isListening(): boolean;
+    /**
+     * Appends `data` (JSON, or nothing) to `channel` and wakes its subscribers,
+     * here and on every instance sharing the store. Resolves to the new seq.
+     *
+     * Inside an ORM transaction nobody is woken before the commit, and nothing
+     * is published if it rolls back. The database driver on Postgres writes on
+     * the transaction itself; every other driver publishes after the commit,
+     * and then this resolves to `null`, since the seq does not exist yet.
+     */
+    publish(channel: string, data?: unknown): Promise<number | null>;
+    /** The latest seq of `channel`, `0` before its first publish. */
+    head(channel: string): Promise<number>;
+    /**
+     * A cursor at the channels' heads, for a view to hand its client so the
+     * client's subscription resumes from what the view showed rather than
+     * from whenever it connected.
+     */
+    cursor(channels: string | readonly string[]): Promise<string>;
+    /**
+     * Follows `channels` from `options.cursor`. Iterate it with `for await`;
+     * breaking out, `close()`, or `options.signal` ends it. Throws
+     * `ChangeFeedFullError` when this process holds `maxSubscriptions` already.
+     */
+    subscribe(channels: string | readonly string[], options?: SubscribeOptions): ChangeFeedSubscription;
+    /**
+     * An SSE response following `channels`, for a route handler that has
+     * already decided the caller may read them:
+     *
+     * ```ts
+     * "/sites/:siteId/changes": this.get(async (req: HttpRequest) => {
+     *   const site = await Site.findUniqueOrThrow({ where: { publicId: req.params.siteId } });
+     *   return ChangeFeed.stream(req, `site:${site.id}`);
+     * }),
+     * ```
+     *
+     * It resumes from the request's `Last-Event-ID`, ends when the client goes
+     * away or the server starts shutting down, and answers `503` with a
+     * `Retry-After` when this process holds `maxSubscriptions` already.
+     */
+    stream<T = unknown>(request: {
+        rawRequest: Request;
+    } | Request, channels: string | readonly string[], options?: StreamOptions): ChangeFeedResponse<T>;
+    /** Ends every subscription and stops listening. For shutdown and tests. */
+    close(): Promise<void>;
+    /** @internal */
+    forget(subscription: ChangeFeedSubscription): void;
+    /**
+     * Reads the heads of every channel this process follows, in one query per
+     * 500 channels, and wakes the subscribers that are behind. Runs every
+     * `pollInterval` while there are subscriptions, and at once whenever
+     * notifications may have been missed. Cheaper than each subscription
+     * re-reading its own log: one query per process, whatever the number of
+     * subscribers.
+     */
+    poll(): Promise<void>;
+    private startPolling;
+    private stopPolling;
+    /** Tells this process's subscribers of `channel` that it reached `seq`. */
+    private wake;
+    private resync;
+    private startListening;
+    private connect;
+}
+/**
+ * One subscriber's view of its channels: where it is in each, which may have
+ * moved, and the few events read from the log but not yet taken.
+ */
+export declare class ChangeFeedSubscription implements AsyncIterableIterator<ChangeFeedEvent> {
+    private readonly manager;
+    private readonly config;
+    private readonly signal?;
+    readonly channels: readonly string[];
+    /** What was delivered: the cursor. */
+    private readonly positions;
+    /** What was read from the log, delivered or still in `pending`. */
+    private readonly readTo;
+    private readonly dirty;
+    private readonly pending;
+    private started;
+    private wakeUp;
+    private closed;
+    private readonly onAbort;
+    constructor(manager: ChangeFeedManager, channels: readonly string[], positions: Map<string, number>, config: Required<ChangeFeedConfig>, signal?: AbortSignal);
+    /** Where the subscription is, as a cursor string. Complete once `ready()` resolved. */
+    get cursor(): string;
+    get isClosed(): boolean;
+    /**
+     * Resolves once every channel has a position: the cursor's, or the head
+     * when it had none. Called by the first `next()`; call it yourself to
+     * read `cursor` before the first event.
+     */
+    ready(): Promise<void>;
+    next(): Promise<IteratorResult<ChangeFeedEvent>>;
+    return(): Promise<IteratorResult<ChangeFeedEvent>>;
+    [Symbol.asyncIterator](): this;
+    /** Ends the subscription. A pending `next()` resolves `done`. */
+    close(): void;
+    /**
+     * @internal `channel` reached `seq`. Before `ready()` set a position the
+     * channel is marked anyway, and read from its head once it has one.
+     */
+    moved(channel: string, seq: number): void;
+    private read;
+    private idle;
+    private wake;
+}
+//# sourceMappingURL=ChangeFeedManager.d.ts.map

package/dist/services/change-feed/ChangeFeedManager.d.ts.map

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

package/dist/services/change-feed/ChangeFeedServiceProvider.d.ts

@@ -0,0 +1,11 @@
+import { ServiceProvider } from "../../support/ServiceProvider";
+export declare class ChangeFeedServiceProvider extends ServiceProvider {
+    register(): void;
+    /**
+     * Ends every subscription and closes the `LISTEN` connection. Streams have
+     * already ended by then: each stops at its next keepalive once the server
+     * starts shutting down, so the request drain does not wait on them.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ChangeFeedServiceProvider.d.ts.map

package/dist/services/change-feed/ChangeFeedServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeFeedServiceProvider.d.ts","sourceRoot":"","sources":["../../../services/change-feed/ChangeFeedServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,QAAQ;IAUR;;;;OAIG;IACG,QAAQ;CAIf"}

package/dist/services/change-feed/DatabaseChangeFeedDriver.d.ts

@@ -0,0 +1,84 @@
+import type { DatabaseConnection } from "../../database/Connection";
+import type { ChangeFeedDriver, ChangeFeedRead } from "./ChangeFeedDriver";
+import { type PostgresListenerFactory } from "./postgresListen";
+export type DatabaseChangeFeedDriverOptions = {
+    /** The heads table: one row per channel. Default `gemi_change_heads`. */
+    headsTable?: string;
+    /** The entries table: the kept log. Default `gemi_changes`. */
+    entriesTable?: string;
+    /** Entries kept per channel. Default `1000`. */
+    retain?: number;
+    /**
+     * The Postgres `NOTIFY` channel that wakes other instances. Default
+     * `gemi_changes`. Instances share a feed only when they use the same one.
+     */
+    notifyChannel?: string;
+    /**
+     * Opens the `LISTEN` connection. Default: Bun's `SQL` on Bun 1.4 and later,
+     * the `postgres` package (an optional peer dependency) before that.
+     */
+    listener?: PostgresListenerFactory;
+};
+type Connection = Pick<DatabaseConnection, "sql" | "dialect"> & Partial<Pick<DatabaseConnection, "name" | "url">>;
+/**
+ * A change feed kept in two tables of the application's database: a head row
+ * per channel holding its latest seq, and the last `retain` entries of each
+ * channel. Works on Postgres and SQLite; MySQL is not supported yet.
+ *
+ * ### Publishing
+ *
+ * A publish raises the channel's head with an upsert and inserts the entry,
+ * in one transaction: the caller's ORM transaction when one is open on this
+ * driver's connection (Postgres only, see `transaction`), its own otherwise.
+ * The upsert locks the head row until that transaction ends, so publishers to
+ * one channel take turns and seqs become visible in order. Publishers to
+ * different channels do not wait for each other.
+ *
+ * ### Across instances
+ *
+ * On Postgres a publish also runs `pg_notify` in the same transaction, which
+ * Postgres delivers only on commit, and only if it commits. `listen` holds
+ * one `LISTEN` connection per process; a reconnect after a drop calls
+ * `onResync`, because notifications sent meanwhile are gone. On SQLite there
+ * is nobody else to tell: one process owns the file.
+ */
+export declare class DatabaseChangeFeedDriver implements ChangeFeedDriver {
+    readonly headsTable: string;
+    readonly entriesTable: string;
+    readonly notifyChannel: string;
+    private readonly sql;
+    private readonly dialect;
+    private readonly connection;
+    private readonly url;
+    private readonly retain;
+    private readonly listener;
+    private sqliteTurn;
+    constructor(connection: Connection, options?: DatabaseChangeFeedDriverOptions);
+    /**
+     * Creates both tables if they do not exist, the same DDL Prisma generates
+     * for the models in the docs. For tests and apps that do not manage their
+     * schema with Prisma.
+     */
+    createTable(): Promise<void>;
+    joinsTransaction(): boolean;
+    publish(channel: string, data: unknown): Promise<number>;
+    private append;
+    heads(channels: readonly string[]): Promise<Map<string, number>>;
+    read(channel: string, after: number, limit: number): Promise<ChangeFeedRead>;
+    listen(onChange: (channel: string, seq: number) => void, onResync: () => void): Promise<{
+        close(): Promise<void>;
+    }>;
+    /**
+     * The ORM transaction a publish should be written on: one open on this
+     * driver's own connection, matched by name as the queue's database driver
+     * matches it. Never on SQLite, where Bun has one connection and a read on
+     * the pool runs inside the open transaction: a subscriber would deliver an
+     * entry that may still roll back, and whose seq would then be reused. There
+     * the manager publishes after the commit instead.
+     */
+    private transaction;
+}
+/** The DDL for both tables, Postgres and SQLite alike. */
+export declare function createTableStatements(heads: string, entries: string): string[];
+export {};
+//# sourceMappingURL=DatabaseChangeFeedDriver.d.ts.map

package/dist/services/change-feed/DatabaseChangeFeedDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseChangeFeedDriver.d.ts","sourceRoot":"","sources":["../../../services/change-feed/DatabaseChangeFeedDriver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAA2B,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEzF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACpC,CAAC;AAIF,KAAK,UAAU,GAAG,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,SAAS,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,UAAU,CAAuC;gBAE7C,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,+BAAoC;IA+BjF;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,gBAAgB,IAAI,OAAO;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YAsB1C,MAAM;IAsBd,KAAK,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAYhE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB5E,MAAM,CACV,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,EAChD,QAAQ,EAAE,MAAM,IAAI,GACnB,OAAO,CAAC;QAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IA4BtC;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAMpB;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAc9E"}

package/dist/services/change-feed/MemoryChangeFeedDriver.d.ts

@@ -0,0 +1,26 @@
+import type { ChangeFeedDriver, ChangeFeedRead } from "./ChangeFeedDriver";
+export type MemoryChangeFeedDriverOptions = {
+    /** Entries kept per channel. Default `1000`. */
+    retain?: number;
+};
+/**
+ * The default driver: each channel's log in this process's memory.
+ *
+ * **One process only.** Another instance publishes to its own memory, and a
+ * subscriber here never hears of it. A restart forgets every channel, and a
+ * client resuming with a cursor from before it gets a `reset`, which is the
+ * right answer: what it showed must be read again. Use the database driver
+ * once there is more than one instance.
+ *
+ * It has no `listen`: the manager wakes this process's subscribers itself
+ * after each publish, and there is nobody else to hear.
+ */
+export declare class MemoryChangeFeedDriver implements ChangeFeedDriver {
+    private readonly logs;
+    private readonly retain;
+    constructor(options?: MemoryChangeFeedDriverOptions);
+    publish(channel: string, data: unknown): Promise<number>;
+    heads(channels: readonly string[]): Promise<Map<string, number>>;
+    read(channel: string, after: number, limit: number): Promise<ChangeFeedRead>;
+}
+//# sourceMappingURL=MemoryChangeFeedDriver.d.ts.map

package/dist/services/change-feed/MemoryChangeFeedDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryChangeFeedDriver.d.ts","sourceRoot":"","sources":["../../../services/change-feed/MemoryChangeFeedDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE5F,MAAM,MAAM,6BAA6B,GAAG;IAC1C,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmE;IACxF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,6BAAkC;IAQjD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAcxD,KAAK,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIhE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAUnF"}

package/dist/services/change-feed/changeFeedDriverContract.d.ts

@@ -0,0 +1,8 @@
+import type { ChangeFeedDriver } from "./ChangeFeedDriver";
+/**
+ * What every `ChangeFeedDriver` promises, run against each by its own test
+ * file. `make` builds a fresh, empty driver keeping `retain` entries per
+ * channel.
+ */
+export declare function changeFeedDriverContract(label: string, make: (retain: number) => Promise<ChangeFeedDriver>): void;
+//# sourceMappingURL=changeFeedDriverContract.d.ts.map

package/dist/services/change-feed/changeFeedDriverContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeFeedDriverContract.d.ts","sourceRoot":"","sources":["../../../services/change-feed/changeFeedDriverContract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,QA2EpD"}

package/dist/services/change-feed/config.d.ts

@@ -0,0 +1,42 @@
+import type { Application } from "../../foundation/Application";
+import type { ChangeFeedDriver } from "./ChangeFeedDriver";
+export interface ChangeFeedConfig {
+    /**
+     * Where the log is kept: `"memory"`, `"database"`, a `ChangeFeedDriver`, or
+     * a function returning one, called once with the application.
+     *
+     * `"memory"` is the default and works for **one process only**: a
+     * subscriber on another instance never hears of a publish here. See
+     * `MemoryChangeFeedDriver`.
+     *
+     * `"database"` keeps it in the `gemi_change_heads` and `gemi_changes`
+     * tables of the default connection, which have to exist, and on Postgres
+     * wakes every instance with `LISTEN`/`NOTIFY`. See
+     * `DatabaseChangeFeedDriver`.
+     */
+    driver?: "memory" | "database" | ChangeFeedDriver | ((application: Application) => ChangeFeedDriver);
+    /**
+     * How often, in milliseconds, a subscription re-reads its channels even
+     * when nothing woke it. A safety net for a notification lost between
+     * instances, and the only way a driver without `listen` hears of other
+     * processes' publishes. Default `30000`.
+     */
+    pollInterval?: number;
+    /**
+     * How many subscriptions this process holds at once. One more is refused
+     * with `ChangeFeedFullError`, which `stream` answers with a `503` and a
+     * `Retry-After`. Default `10000`.
+     */
+    maxSubscriptions?: number;
+    /** How many entries a subscription reads from the log at a time. Default `100`. */
+    batchSize?: number;
+    /**
+     * How often, in milliseconds, `stream` writes a keepalive comment. Bun's
+     * idle timeout closes a silent connection after 10 seconds unless
+     * `SERVER_IDLE_TIMEOUT` says otherwise. Default `5000`.
+     */
+    keepaliveInterval?: number;
+}
+export declare function defineChangeFeedConfig(config: ChangeFeedConfig): ChangeFeedConfig;
+export declare function changeFeedConfigDefaults(): Required<ChangeFeedConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/services/change-feed/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../services/change-feed/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,gBAAgB,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,KAAK,gBAAgB,CAAC,CAAC;IAErG;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEjF;AAED,wBAAgB,wBAAwB,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAQrE"}

package/dist/services/change-feed/cursor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A subscription's position: the last seq it delivered of each channel,
+ * written as a query string, `site%3A42=17&site%3A43=4`.
+ *
+ * One string for every channel of a stream, because it travels as the SSE
+ * event `id`, and the browser sends back only the last one as
+ * `Last-Event-ID`. Readable in a network panel, and safe in a header.
+ */
+export type ChangeFeedCursor = ReadonlyMap<string, number>;
+export declare function encodeCursor(positions: ChangeFeedCursor): string;
+/**
+ * The positions a cursor holds. A malformed one, or one whose seq is not a
+ * whole number of 0 or more, is left out: a channel without a position starts
+ * from its head, which is what a client with no usable cursor should get.
+ */
+export declare function decodeCursor(cursor: string | null | undefined): Map<string, number>;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/services/change-feed/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../services/change-feed/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3D,wBAAgB,YAAY,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAcnF"}

package/dist/services/change-feed/postgresListen.d.ts

@@ -0,0 +1,30 @@
+/**
+ * One `LISTEN` connection: what the database change-feed driver needs from a
+ * Postgres client.
+ *
+ * Bun's `SQL` (1.4 and later) and the `postgres` package share this shape:
+ * `listen` resolves once the server acknowledged the `LISTEN`, and both
+ * reconnect by themselves after the connection drops and call `onListen`
+ * again, which is the moment notifications may have been missed. Measured on
+ * Bun 1.4.2 and postgres 3.4.9 with `pg_terminate_backend`.
+ */
+export type PostgresListener = {
+    listen(channel: string, onNotify: (payload: string) => void, onListen?: () => void): Promise<unknown>;
+    close(): Promise<void>;
+};
+/** Opens a dedicated listening client for `url`. */
+export type PostgresListenerFactory = (url: string) => Promise<PostgresListener>;
+/** Whether this Bun's `SQL` can `LISTEN` (Bun 1.4 and later). */
+export declare function bunCanListen(): boolean;
+/** A one-connection Bun `SQL` client. Needs Bun 1.4 or later. */
+export declare const bunListener: PostgresListenerFactory;
+/**
+ * A one-connection client from the `postgres` package, for Bun 1.3, whose
+ * `SQL` cannot `LISTEN`. The package is an optional peer dependency: install
+ * it in the app (`bun add postgres`) to use the database driver across
+ * instances on Bun 1.3.
+ */
+export declare const postgresPackageListener: PostgresListenerFactory;
+/** Bun's own client when it can listen, the `postgres` package otherwise. */
+export declare const defaultPostgresListener: PostgresListenerFactory;
+//# sourceMappingURL=postgresListen.d.ts.map

package/dist/services/change-feed/postgresListen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresListen.d.ts","sourceRoot":"","sources":["../../../services/change-feed/postgresListen.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACnC,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEjF,iEAAiE;AACjE,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,iEAAiE;AACjE,eAAO,MAAM,WAAW,EAAE,uBAQzB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,uBAyBrC,CAAC;AAOF,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,EAAE,uBAC4B,CAAC"}

package/dist/services/change-feed/stream.d.ts

@@ -0,0 +1,16 @@
+import type { ChangeFeedMessage, ChangeFeedResponse } from "./wire";
+import { type ChangeFeedManager } from "./ChangeFeedManager";
+export type StreamOptions = {
+    /**
+     * Where to resume. Default: the request's `Last-Event-ID` header, then its
+     * `cursor` search parameter, then the channels' heads.
+     */
+    cursor?: string | null;
+    /** How long a client waits before retrying a `503`, in seconds. Default `5`. */
+    retryAfter?: number;
+};
+export type { ChangeFeedMessage, ChangeFeedResponse };
+export declare function changeFeedStream<T>(manager: ChangeFeedManager, request: {
+    rawRequest: Request;
+} | Request, channels: string[], options: StreamOptions): ChangeFeedResponse<T>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/services/change-feed/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../services/change-feed/stream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAuB,KAAK,iBAAiB,EAA+B,MAAM,qBAAqB,CAAC;AAE/G,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAQF,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,aAAa,GACrB,kBAAkB,CAAC,CAAC,CAAC,CA6EvB"}

package/dist/services/change-feed/wire.d.ts

@@ -0,0 +1,20 @@
+import type { ChangeFeedEvent } from "./ChangeFeedDriver";
+declare const changeFeedData: unique symbol;
+/**
+ * The `Response` `ChangeFeed.stream` returns. `T` is the type of the
+ * published `data`, carried only in the type so `useSubscription` can infer
+ * it from the route.
+ */
+export type ChangeFeedResponse<T = unknown> = Response & {
+    readonly [changeFeedData]?: T;
+};
+/**
+ * What a stream sends, one per SSE event. `ready` comes first, once the
+ * subscription knows where it is; its `id` is the cursor to resume from even
+ * if nothing changes before the connection drops.
+ */
+export type ChangeFeedMessage<T = unknown> = ChangeFeedEvent<T> | {
+    type: "ready";
+};
+export {};
+//# sourceMappingURL=wire.d.ts.map

package/dist/services/change-feed/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../services/change-feed/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,GAAG;IAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAE3F;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/services/index.d.ts

@@ -36,6 +36,14 @@ export type { QueueDriver, EnqueueJob, ClaimOptions, ClaimedJob, JobFailure, Job
 export { Job, type JobThrottle, type JobConcurrency } from "./queue/Job";
 export { LockManager, HeldLock, type AcquireOptions, type LockRunResult, } from "./lock/LockManager";
 export { LockLostError, type LockStore } from "./lock/LockStore";
+export { ChangeFeedServiceProvider } from "./change-feed/ChangeFeedServiceProvider";
+export { ChangeFeedManager, ChangeFeedSubscription, ChangeFeedFullError, type SubscribeOptions, } from "./change-feed/ChangeFeedManager";
+export type { ChangeFeedDriver, ChangeFeedEntry, ChangeFeedEvent, ChangeFeedRead, } from "./change-feed/ChangeFeedDriver";
+export { MemoryChangeFeedDriver, type MemoryChangeFeedDriverOptions, } from "./change-feed/MemoryChangeFeedDriver";
+export { DatabaseChangeFeedDriver, type DatabaseChangeFeedDriverOptions, } from "./change-feed/DatabaseChangeFeedDriver";
+export type { PostgresListener, PostgresListenerFactory, } from "./change-feed/postgresListen";
+export { decodeCursor, encodeCursor, type ChangeFeedCursor, } from "./change-feed/cursor";
+export type { ChangeFeedMessage, ChangeFeedResponse, StreamOptions as ChangeFeedStreamOptions, } from "./change-feed/stream";
 export { MemoryLockStore } from "./lock/MemoryLockStore";
 export { DatabaseLockStore, type DatabaseLockStoreOptions, } from "./lock/DatabaseLockStore";
 export { EventServiceProvider } from "./events/EventServiceProvider";
@@ -86,6 +94,7 @@ export { defineMailConfig, mailConfigDefaults, type MailConfig, } from "./email/
 export { defineRouteConfig, apiRouteConfigDefaults, viewRouteConfigDefaults, type RouteConfig, type ApiRouteConfig, type McpRouteConfig, type ViewRouteConfig, } from "./router/config";
 export { defineLogConfig, logConfigDefaults, type LogConfig, } from "./logging/config";
 export { defineQueueConfig, queueConfigDefaults, type QueueConfig, } from "./queue/config";
+export { defineChangeFeedConfig, changeFeedConfigDefaults, type ChangeFeedConfig, } from "./change-feed/config";
 export { defineEventConfig, eventConfigDefaults, type EventConfig, } from "./events/config";
 export { defineImageConfig, imageConfigDefaults, type ImageConfig, } from "./image-optimization/config";
 export { defineScheduleConfig, scheduleConfigDefaults, type ScheduleConfig, } from "./cron/config";

package/dist/services/index.d.ts.map

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