@earendil-works/chord 1.4.0 → 1.5.0

package/dist/sqlite/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/sqlite/node.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\nimport type { StatementSync } from \"node:sqlite\";\nimport { DatabaseSync } from \"node:sqlite\";\nimport type { SqliteDatabase, SqliteExecutor, SqliteValue } from \"./database.ts\";\n\n/** Node SQLite connection settings for a database file. */\nexport type NodeSqliteDatabaseOptions = {\n\t/** SQLite WAL auto-checkpoint threshold. SQLite and this adapter default to 1,000 pages; 0 disables it. */\n\treadonly walAutoCheckpointPages?: number;\n\t/** Time SQLite waits for a competing file lock. SQLite defaults to 0; this adapter defaults to 5,000 ms. */\n\treadonly busyTimeoutMs?: number;\n};\n\nconst DEFAULT_WAL_AUTO_CHECKPOINT_PAGES = 1_000;\nconst DEFAULT_BUSY_TIMEOUT_MS = 5_000;\n\ntype TransactionScope = { active: boolean };\n\nconst ignore = (): void => {};\n\n/**\n * Runs operations in call order. An operation starts immediately when nothing is running or waiting;\n * otherwise it waits for everything before it. An asynchronous operation holds the queue until it settles.\n */\nclass SerialOperationQueue {\n\tprivate tail: Promise<void> = Promise.resolve();\n\tprivate pending = 0;\n\n\trun<T>(operation: () => T): Promise<T> {\n\t\tif (this.pending > 0) return this.enqueue(operation);\n\t\ttry {\n\t\t\treturn Promise.resolve(operation());\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t}\n\n\trunAsync<T>(operation: () => Promise<T>): Promise<T> {\n\t\tif (this.pending > 0) return this.enqueue(operation);\n\t\tthis.pending++;\n\t\t// Publish the barrier before the operation starts, so calls it makes synchronously wait behind it.\n\t\tconst { promise: barrier, resolve: releaseBarrier } = Promise.withResolvers<void>();\n\t\tthis.tail = barrier;\n\t\tlet started: Promise<T>;\n\t\ttry {\n\t\t\tstarted = operation();\n\t\t} catch (error) {\n\t\t\tstarted = Promise.reject(error);\n\t\t}\n\t\treturn started.finally(() => {\n\t\t\tthis.pending--;\n\t\t\treleaseBarrier();\n\t\t});\n\t}\n\n\tprivate enqueue<T>(operation: () => T | Promise<T>): Promise<T> {\n\t\tthis.pending++;\n\t\treturn this.release(this.tail.then(operation));\n\t}\n\n\tprivate release<T>(operation: Promise<T>): Promise<T> {\n\t\tconst settled = operation.finally(() => {\n\t\t\tthis.pending--;\n\t\t});\n\t\tthis.tail = settled.then(ignore, ignore);\n\t\treturn settled;\n\t}\n}\n\n/**\n * Executes SQL on one connection. Prepared statements are cached per connection by SQL text, so the\n * database and its transaction handles share them across transactions.\n */\nabstract class NodeSqliteExecutor implements SqliteExecutor {\n\tprotected readonly database: DatabaseSync;\n\tprotected readonly statements: Map<string, StatementSync>;\n\n\tconstructor(database: DatabaseSync, statements: Map<string, StatementSync>) {\n\t\tthis.database = database;\n\t\tthis.statements = statements;\n\t}\n\n\texec(sql: string): Promise<void> {\n\t\treturn this.runOperation(() => {\n\t\t\tthis.database.exec(sql);\n\t\t});\n\t}\n\n\trun(sql: string, ...params: SqliteValue[]): Promise<void> {\n\t\treturn this.runOperation(() => {\n\t\t\tthis.statement(sql).run(...params);\n\t\t});\n\t}\n\n\tget<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T | undefined> {\n\t\treturn this.runOperation(() => this.statement(sql).get(...params) as T | undefined);\n\t}\n\n\tall<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T[]> {\n\t\treturn this.runOperation(() => this.statement(sql).all(...params) as T[]);\n\t}\n\n\tprotected abstract runOperation<T>(operation: () => T): Promise<T>;\n\n\tprivate statement(sql: string): StatementSync {\n\t\tlet statement = this.statements.get(sql);\n\t\tif (statement === undefined) {\n\t\t\tstatement = this.database.prepare(sql);\n\t\t\tthis.statements.set(sql, statement);\n\t\t}\n\t\treturn statement;\n\t}\n}\n\nclass NodeSqliteTransaction extends NodeSqliteExecutor {\n\tprivate readonly scope: TransactionScope;\n\n\tconstructor(database: DatabaseSync, statements: Map<string, StatementSync>, scope: TransactionScope) {\n\t\tsuper(database, statements);\n\t\tthis.scope = scope;\n\t}\n\n\tprotected async runOperation<T>(operation: () => T): Promise<T> {\n\t\tif (!this.scope.active) throw new Error(\"SQLite transaction handle is no longer active\");\n\t\treturn operation();\n\t}\n}\n\n/** `SqliteDatabase` adapter backed by Node's built-in `node:sqlite`. */\nexport class NodeSqliteDatabase extends NodeSqliteExecutor implements SqliteDatabase {\n\tprivate readonly access = new SerialOperationQueue();\n\tprivate closed = false;\n\n\tconstructor(database: DatabaseSync) {\n\t\tsuper(database, new Map());\n\t}\n\n\ttransaction<T>(callback: (transaction: SqliteExecutor) => Promise<T>): Promise<T> {\n\t\treturn this.access.runAsync(async () => {\n\t\t\tthis.database.exec(\"BEGIN IMMEDIATE\");\n\t\t\tconst scope = { active: true };\n\t\t\ttry {\n\t\t\t\tconst result = await callback(new NodeSqliteTransaction(this.database, this.statements, scope));\n\t\t\t\tscope.active = false;\n\t\t\t\tthis.database.exec(\"COMMIT\");\n\t\t\t\treturn result;\n\t\t\t} catch (error) {\n\t\t\t\tscope.active = false;\n\t\t\t\ttry {\n\t\t\t\t\tthis.database.exec(\"ROLLBACK\");\n\t\t\t\t} catch (rollbackError) {\n\t\t\t\t\tthrow new AggregateError([error, rollbackError], \"SQLite transaction failed and rollback failed\");\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t});\n\t}\n\n\tclose(): Promise<void> {\n\t\treturn this.access.run(() => {\n\t\t\tif (this.closed) return;\n\t\t\tthis.closed = true;\n\t\t\tthis.statements.clear();\n\t\t\ttry {\n\t\t\t\tthis.database.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n\t\t\t} finally {\n\t\t\t\tthis.database.close();\n\t\t\t}\n\t\t});\n\t}\n\n\tprotected runOperation<T>(operation: () => T): Promise<T> {\n\t\treturn this.access.run(operation);\n\t}\n}\n\n/** Open and configure a Node-backed SQLite database facade. */\nexport async function openNodeSqliteDatabase(\n\tpath: string,\n\toptions: NodeSqliteDatabaseOptions = {},\n): Promise<NodeSqliteDatabase> {\n\tconst checkpointPages = options.walAutoCheckpointPages ?? DEFAULT_WAL_AUTO_CHECKPOINT_PAGES;\n\tconst timeout = options.busyTimeoutMs ?? DEFAULT_BUSY_TIMEOUT_MS;\n\tif (path !== \":memory:\") await mkdir(dirname(path), { recursive: true });\n\tconst database = new DatabaseSync(path, { timeout });\n\tconst adapter = new NodeSqliteDatabase(database);\n\ttry {\n\t\tawait adapter.exec(\"PRAGMA journal_mode = WAL\");\n\t\tawait adapter.exec(\"PRAGMA synchronous = NORMAL\");\n\t\tawait adapter.exec(`PRAGMA wal_autocheckpoint = ${checkpointPages}`);\n\t\treturn adapter;\n\t} catch (error) {\n\t\ttry {\n\t\t\tawait adapter.close();\n\t\t} catch {\n\t\t\t// Preserve the configuration failure.\n\t\t}\n\t\tthrow error;\n\t}\n}\n"]}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/sqlite/node.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\nimport type { StatementSync } from \"node:sqlite\";\nimport { DatabaseSync } from \"node:sqlite\";\nimport type { SqliteDatabase, SqliteExecutor, SqliteValue } from \"./database.ts\";\n\n/** Node SQLite connection settings for a database file. */\nexport type NodeSqliteDatabaseOptions = {\n\t/** SQLite WAL auto-checkpoint threshold. SQLite and this adapter default to 1,000 pages; 0 disables it. */\n\treadonly walAutoCheckpointPages?: number;\n\t/** Time SQLite waits for a competing file lock. SQLite defaults to 0; this adapter defaults to 5,000 ms. */\n\treadonly busyTimeoutMs?: number;\n};\n\nconst DEFAULT_WAL_AUTO_CHECKPOINT_PAGES = 1_000;\nconst DEFAULT_BUSY_TIMEOUT_MS = 5_000;\n\ntype TransactionScope = { active: boolean };\n\nconst ignore = (): void => {};\n\n/**\n * Runs operations in call order. An operation starts immediately when nothing is running or waiting;\n * otherwise it waits for everything before it. An asynchronous operation holds the queue until it settles.\n */\nclass SerialOperationQueue {\n\tprivate tail: Promise<void> = Promise.resolve();\n\tprivate pending = 0;\n\n\trun<T>(operation: () => T): Promise<T> {\n\t\tif (this.pending > 0) return this.enqueue(operation);\n\t\ttry {\n\t\t\treturn Promise.resolve(operation());\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t}\n\n\trunAsync<T>(operation: () => Promise<T>): Promise<T> {\n\t\tif (this.pending > 0) return this.enqueue(operation);\n\t\tthis.pending++;\n\t\t// Publish the barrier before the operation starts, so calls it makes synchronously wait behind it.\n\t\tconst { promise: barrier, resolve: releaseBarrier } = Promise.withResolvers<void>();\n\t\tthis.tail = barrier;\n\t\tlet started: Promise<T>;\n\t\ttry {\n\t\t\tstarted = operation();\n\t\t} catch (error) {\n\t\t\tstarted = Promise.reject(error);\n\t\t}\n\t\treturn started.finally(() => {\n\t\t\tthis.pending--;\n\t\t\treleaseBarrier();\n\t\t});\n\t}\n\n\tprivate enqueue<T>(operation: () => T | Promise<T>): Promise<T> {\n\t\tthis.pending++;\n\t\treturn this.release(this.tail.then(operation));\n\t}\n\n\tprivate release<T>(operation: Promise<T>): Promise<T> {\n\t\tconst settled = operation.finally(() => {\n\t\t\tthis.pending--;\n\t\t});\n\t\tthis.tail = settled.then(ignore, ignore);\n\t\treturn settled;\n\t}\n}\n\n/** How many prepared statements one connection keeps. */\nconst STATEMENT_CACHE_LIMIT = 256;\n\n/**\n * Executes SQL on one connection. Prepared statements are cached per connection by SQL text, so the\n * database and its transaction handles share them across transactions. The cache keeps the\n * `STATEMENT_CACHE_LIMIT` most recently used statements, so callers generating SQL of unbounded shapes\n * cannot grow it without bound.\n */\nabstract class NodeSqliteExecutor implements SqliteExecutor {\n\tprotected readonly database: DatabaseSync;\n\tprotected readonly statements: Map<string, StatementSync>;\n\n\tconstructor(database: DatabaseSync, statements: Map<string, StatementSync>) {\n\t\tthis.database = database;\n\t\tthis.statements = statements;\n\t}\n\n\texec(sql: string): Promise<void> {\n\t\treturn this.runOperation(() => {\n\t\t\tthis.database.exec(sql);\n\t\t});\n\t}\n\n\trun(sql: string, ...params: SqliteValue[]): Promise<void> {\n\t\treturn this.runOperation(() => {\n\t\t\tthis.statement(sql).run(...params);\n\t\t});\n\t}\n\n\trunCounted(sql: string, ...params: SqliteValue[]): Promise<number> {\n\t\treturn this.runOperation(() => Number(this.statement(sql).run(...params).changes));\n\t}\n\n\tget<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T | undefined> {\n\t\treturn this.runOperation(() => this.statement(sql).get(...params) as T | undefined);\n\t}\n\n\tall<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T[]> {\n\t\treturn this.runOperation(() => this.statement(sql).all(...params) as T[]);\n\t}\n\n\tprotected abstract runOperation<T>(operation: () => T): Promise<T>;\n\n\tprivate statement(sql: string): StatementSync {\n\t\tconst statements = this.statements;\n\t\tlet statement = statements.get(sql);\n\t\tif (statement !== undefined) {\n\t\t\t// Recency matters only once evictions come near: a small cache keeps one lookup per statement.\n\t\t\tif (statements.size > STATEMENT_CACHE_LIMIT / 2) {\n\t\t\t\tstatements.delete(sql);\n\t\t\t\tstatements.set(sql, statement);\n\t\t\t}\n\t\t\treturn statement;\n\t\t}\n\t\tstatement = this.database.prepare(sql);\n\t\tstatements.set(sql, statement);\n\t\t// A Map iterates in insertion order: its first key is the least recently used statement.\n\t\tif (statements.size > STATEMENT_CACHE_LIMIT) statements.delete(statements.keys().next().value!);\n\t\treturn statement;\n\t}\n}\n\nclass NodeSqliteTransaction extends NodeSqliteExecutor {\n\tprivate readonly scope: TransactionScope;\n\n\tconstructor(database: DatabaseSync, statements: Map<string, StatementSync>, scope: TransactionScope) {\n\t\tsuper(database, statements);\n\t\tthis.scope = scope;\n\t}\n\n\tprotected async runOperation<T>(operation: () => T): Promise<T> {\n\t\tif (!this.scope.active) throw new Error(\"SQLite transaction handle is no longer active\");\n\t\treturn operation();\n\t}\n}\n\n/** `SqliteDatabase` adapter backed by Node's built-in `node:sqlite`. */\nexport class NodeSqliteDatabase extends NodeSqliteExecutor implements SqliteDatabase {\n\tprivate readonly access = new SerialOperationQueue();\n\tprivate closed = false;\n\n\tconstructor(database: DatabaseSync) {\n\t\tsuper(database, new Map());\n\t}\n\n\ttransaction<T>(callback: (transaction: SqliteExecutor) => Promise<T>): Promise<T> {\n\t\treturn this.access.runAsync(async () => {\n\t\t\tthis.database.exec(\"BEGIN IMMEDIATE\");\n\t\t\tconst scope = { active: true };\n\t\t\ttry {\n\t\t\t\tconst result = await callback(new NodeSqliteTransaction(this.database, this.statements, scope));\n\t\t\t\tscope.active = false;\n\t\t\t\tthis.database.exec(\"COMMIT\");\n\t\t\t\treturn result;\n\t\t\t} catch (error) {\n\t\t\t\tscope.active = false;\n\t\t\t\ttry {\n\t\t\t\t\tthis.database.exec(\"ROLLBACK\");\n\t\t\t\t} catch (rollbackError) {\n\t\t\t\t\tthrow new AggregateError([error, rollbackError], \"SQLite transaction failed and rollback failed\");\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t});\n\t}\n\n\tclose(): Promise<void> {\n\t\treturn this.access.run(() => {\n\t\t\tif (this.closed) return;\n\t\t\tthis.closed = true;\n\t\t\tthis.statements.clear();\n\t\t\ttry {\n\t\t\t\tthis.database.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n\t\t\t} finally {\n\t\t\t\tthis.database.close();\n\t\t\t}\n\t\t});\n\t}\n\n\tprotected runOperation<T>(operation: () => T): Promise<T> {\n\t\treturn this.access.run(operation);\n\t}\n}\n\n/** Open and configure a Node-backed SQLite database facade. */\nexport async function openNodeSqliteDatabase(\n\tpath: string,\n\toptions: NodeSqliteDatabaseOptions = {},\n): Promise<NodeSqliteDatabase> {\n\tconst checkpointPages = options.walAutoCheckpointPages ?? DEFAULT_WAL_AUTO_CHECKPOINT_PAGES;\n\tconst timeout = options.busyTimeoutMs ?? DEFAULT_BUSY_TIMEOUT_MS;\n\tif (path !== \":memory:\") await mkdir(dirname(path), { recursive: true });\n\tconst database = new DatabaseSync(path, { timeout });\n\tconst adapter = new NodeSqliteDatabase(database);\n\ttry {\n\t\tawait adapter.exec(\"PRAGMA journal_mode = WAL\");\n\t\tawait adapter.exec(\"PRAGMA synchronous = NORMAL\");\n\t\tawait adapter.exec(`PRAGMA wal_autocheckpoint = ${checkpointPages}`);\n\t\treturn adapter;\n\t} catch (error) {\n\t\ttry {\n\t\t\tawait adapter.close();\n\t\t} catch {\n\t\t\t// Preserve the configuration failure.\n\t\t}\n\t\tthrow error;\n\t}\n}\n"]}

package/dist/watch.d.ts

@@ -0,0 +1,194 @@
+import { type Context } from "./context/index.ts";
+import { type Op } from "./delta/index.ts";
+/**
+ * Terminal result of one watch, tagged by `kind`. A watch ends only for good; a failure its source recovers from is a
+ * `failed` call (`WatchCall`), and the watch stays open.
+ *
+ * - `stopped`: `stop()` was called.
+ * - `aborted`: the context the watch was acquired with was aborted.
+ * - `ended`: the source closed (its owner ended or closed).
+ * - `listener_error`: the listener threw or rejected with `error`.
+ * - `failed`: the source failed for good with `error`.
+ */
+export type WatchEnd = {
+    readonly kind: "stopped" | "aborted" | "ended";
+} | {
+    readonly kind: "listener_error";
+    readonly error: Error;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/**
+ * One call of a JSON watch's listener, and one frame a source hands its watch, tagged by `kind`:
+ *
+ * - `value`: the newest value, the ops that turn the previous value into it, and whether the document the watch follows
+ *   was retired since the previous value call. A retirement does not end the watch: `value` is then what the address
+ *   shows after it (the source decides; a Durable document keeps the last value the watch was given, with no ops), and a
+ *   document created there later arrives as `[["r", value]]`, possibly in the same call.
+ * - `failed`: the source cannot compute its value now, with `error`; the watch stays open, and the next value arrives as
+ *   `[["r", value]]`. `WatchHandle.value` keeps the last value.
+ *
+ * Plain data: the frame's context is the listener's second argument, never part of the call.
+ */
+export type WatchCall<T> = {
+    readonly kind: "value";
+    readonly value: T;
+    readonly ops: readonly Op[];
+    readonly retired: boolean;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/** One call of a native watch's listener: the new value, or a failure its source may recover from, as in `WatchCall`. */
+export type NativeWatchCall<T> = {
+    readonly kind: "value";
+    readonly value: T;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/**
+ * Serialized observation of an immutable value: one listener call at a time; changes made meanwhile arrive folded into
+ * the next call.
+ */
+export interface WatchHandle<T> {
+    /** Acquisition revision before start; latest delivered immutable revision afterward (a `failed` call keeps it). */
+    readonly value: T;
+    /** Install the sole asynchronous listener. Never invokes it inline. */
+    start(listener: (call: WatchCall<T>, context: Context) => Promise<void>): void;
+    /** Idempotently stop future callbacks and return this watch's terminal result. */
+    stop(): Promise<WatchEnd>;
+    /** Settle when the watch terminates; an already-running callback remains caller-owned. */
+    readonly closed: Promise<WatchEnd>;
+}
+/**
+ * A value that changes and can be watched: documents, derives, members of references. Values are immutable by
+ * convention (JSON for state); each watch starts at the current value and then gets the changes, folded while its
+ * listener is busy.
+ */
+export interface Watchable<T> {
+    /** The current value. */
+    readonly value: T;
+    /** A watch holding the current value, then its changes; aborting the context ends it. */
+    watch(context: Context): Promise<WatchHandle<T>>;
+}
+/**
+ * An in-process value that changes and can be watched (it may hold anything, errors and functions included): a change
+ * is a new value by identity, delivered without ops.
+ */
+export interface NativeWatchable<T> {
+    /** The current value. */
+    readonly value: T;
+    /** A watch holding the current value, then one frame per new value; aborting the context ends it. */
+    watch(context: Context): Promise<NativeWatchHandle<T>>;
+}
+/**
+ * Serialized observation of an in-process value: as `WatchHandle`, but each new value is its own call, in order, without
+ * ops.
+ */
+export interface NativeWatchHandle<T> {
+    /** Acquisition value before start; latest delivered value afterward (a `failed` call keeps it). */
+    readonly value: T;
+    /** Install the sole asynchronous listener. Never invokes it inline. */
+    start(listener: (call: NativeWatchCall<T>, context: Context) => Promise<void>): void;
+    /** Idempotently stop future callbacks and return this watch's terminal result. */
+    stop(): Promise<WatchEnd>;
+    /** Settle when the watch terminates; an already-running callback remains caller-owned. */
+    readonly closed: Promise<WatchEnd>;
+}
+type Listener<C> = (call: C, context: Context) => Promise<void>;
+/** A failure call, as both call types have it. */
+type FailedCall = {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/**
+ * The lifecycle both handles share: serialized delivery and termination. A source feeds it and ends it explicitly;
+ * termination drops every reference the watch holds into its source, so a stopped watch that is still referenced keeps
+ * nothing but its last value alive. Subclasses keep what is pending, each call apart from its frame's context, so the
+ * call a listener gets carries nothing but its data.
+ */
+declare abstract class WatchLifecycle<T, C extends {
+    readonly kind: "value";
+    readonly value: T;
+} | FailedCall> {
+    #private;
+    constructor(value: T, detach: () => void, report: (error: unknown) => void);
+    get value(): T;
+    get closed(): Promise<WatchEnd>;
+    start(listener: Listener<C>): void;
+    stop(): Promise<WatchEnd>;
+    /** End the watch `aborted` when `signal` aborts; installed once. */
+    observeAbort(signal: AbortSignal): void;
+    /** End the watch `aborted`: its acquisition context was aborted. */
+    abort(): void;
+    /**
+     * End the watch with `end` at once, dropping what is pending: the source closed (`ended`), or failed for good
+     * (`failed`). A failure the source may recover from is a `failed` call instead (`fail()`).
+     */
+    end(end: WatchEnd): void;
+    /**
+     * The source sends nothing more after its last frames, such as a retirement: take no more frames, deliver what is
+     * pending, then end `ended`, after the running call returns, if one runs. Until then the watch stays attached, so
+     * `end()`, `stop()`, an abort, and a throwing listener still end it first; a watch never started keeps what is
+     * pending until one of them or `start()`.
+     */
+    endAfterDelivery(): void;
+    /** Whether the watch still takes frames: it has not ended, and its source has not ended. */
+    protected get open(): boolean;
+    /** The context of the newest frame the next call covers, or undefined when nothing is pending. */
+    protected abstract get pendingContext(): Context | undefined;
+    /** Take the next call; called only while something is pending. */
+    protected abstract next(): C;
+    /** Drop everything pending and every reference into the source; called once, on termination. */
+    protected abstract release(): void;
+    /** Something became pending: deliver it once started, never inline. */
+    protected pending(): void;
+}
+/**
+ * The watch handle of a JSON source. Frames that arrive before `start()` or while the listener runs wait in one
+ * `PendingOps` queue; the next call gets the newest value, the folded ops of every frame since the previous call (or
+ * `[["r", newest]]` after the queue overflowed), `retired` when any of them was a retirement, and the newest frame's
+ * context. A frame delivered alone is passed on as the source made it. A failure (`fail()`) drops the pending frames and
+ * waits as one `failed` call; a value after it replaces it, and the first value call after a failure is `[["r",
+ * value]]`. `detach` unsubscribes it from its source on termination; `report` gets a listener's throw, which also ends
+ * the watch.
+ */
+export declare class Watch<T> extends WatchLifecycle<T, WatchCall<T>> implements WatchHandle<T> {
+    #private;
+    /**
+     * Queue the frame `call`. A value's ops turn the previous value into it, and `retired` says the document the watch
+     * follows was retired, which the next value call reports however many frames it folds; a failure is `fail()`.
+     */
+    advance(call: WatchCall<T>, context: Context): void;
+    /**
+     * Queue a failure the source may recover from: the pending frames are dropped (`value` keeps the last delivered
+     * value), the listener gets `{ kind: "failed", error }`, and the next value arrives as `[["r", value]]`.
+     */
+    fail(error: unknown, context: Context): void;
+    protected get pendingContext(): Context | undefined;
+    protected next(): WatchCall<T>;
+    protected release(): void;
+}
+/**
+ * The watch handle of a native source: every value in order, one call each; past 100 pending values they collapse to
+ * one, `replace()` or by default the newest value. A failure (`fail()`) drops the pending values and waits as one
+ * `failed` call; a value after it replaces it. `detach` and `report` as for `Watch`.
+ */
+export declare class NativeWatch<T> extends WatchLifecycle<T, NativeWatchCall<T>> implements NativeWatchHandle<T> {
+    #private;
+    constructor(value: T, detach: () => void, report: (error: unknown) => void, replace?: () => T);
+    /** Queue `value`, the source's new value; it replaces a pending failure. */
+    advance(value: T, context: Context): void;
+    /**
+     * Queue a failure the source may recover from: the pending values are dropped (`value` keeps the last delivered
+     * value), and the listener gets `{ kind: "failed", error }`.
+     */
+    fail(error: unknown, context: Context): void;
+    protected get pendingContext(): Context | undefined;
+    protected next(): NativeWatchCall<T>;
+    protected release(): void;
+}
+export {};
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

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

package/dist/watch.js

@@ -0,0 +1,383 @@
+// Watch handles: the watch types and the one implementation of their lifecycle, for JSON and native values.
+import { withoutAbortSignal } from "./context/index.js";
+import { PendingOps } from "./delta/index.js";
+const STOPPED = { kind: "stopped" };
+const ABORTED = { kind: "aborted" };
+const ENDED = { kind: "ended" };
+/**
+ * The lifecycle both handles share: serialized delivery and termination. A source feeds it and ends it explicitly;
+ * termination drops every reference the watch holds into its source, so a stopped watch that is still referenced keeps
+ * nothing but its last value alive. Subclasses keep what is pending, each call apart from its frame's context, so the
+ * call a listener gets carries nothing but its data.
+ */
+class WatchLifecycle {
+    #detach;
+    #report;
+    #closed = Promise.withResolvers();
+    #value;
+    #listener;
+    #started = false;
+    #scheduled = false;
+    #running = false;
+    /** Set by `endAfterDelivery()`: the source sends nothing more; the watch ends `ended` once it delivered the rest. */
+    #ending = false;
+    /** Set once, by `#terminate()`. */
+    #end;
+    #abortSignal;
+    #abortListener;
+    constructor(value, detach, report) {
+        this.#value = value;
+        this.#detach = detach;
+        this.#report = report;
+    }
+    get value() {
+        return this.#value;
+    }
+    get closed() {
+        return this.#closed.promise;
+    }
+    start(listener) {
+        if (this.#started)
+            throw new Error("Watch is already started");
+        if (this.#end !== undefined)
+            throw new Error("Watch is stopped");
+        this.#started = true;
+        this.#listener = listener;
+        this.#schedule();
+    }
+    stop() {
+        this.#terminate(STOPPED);
+        return this.#closed.promise;
+    }
+    /** End the watch `aborted` when `signal` aborts; installed once. */
+    observeAbort(signal) {
+        if (this.#abortSignal !== undefined)
+            throw new Error("Watch abort is already installed");
+        if (this.#end !== undefined)
+            return;
+        this.#abortSignal = signal;
+        this.#abortListener = () => this.abort();
+        signal.addEventListener("abort", this.#abortListener, { once: true });
+        if (signal.aborted)
+            this.abort();
+    }
+    /** End the watch `aborted`: its acquisition context was aborted. */
+    abort() {
+        this.#terminate(ABORTED);
+    }
+    /**
+     * End the watch with `end` at once, dropping what is pending: the source closed (`ended`), or failed for good
+     * (`failed`). A failure the source may recover from is a `failed` call instead (`fail()`).
+     */
+    end(end) {
+        this.#terminate(end);
+    }
+    /**
+     * The source sends nothing more after its last frames, such as a retirement: take no more frames, deliver what is
+     * pending, then end `ended`, after the running call returns, if one runs. Until then the watch stays attached, so
+     * `end()`, `stop()`, an abort, and a throwing listener still end it first; a watch never started keeps what is
+     * pending until one of them or `start()`.
+     */
+    endAfterDelivery() {
+        if (this.#end !== undefined || this.#ending)
+            return;
+        this.#ending = true;
+        if (!this.#running && this.pendingContext === undefined)
+            this.#terminate(ENDED);
+    }
+    /** Whether the watch still takes frames: it has not ended, and its source has not ended. */
+    get open() {
+        return this.#end === undefined && !this.#ending;
+    }
+    /** Something became pending: deliver it once started, never inline. */
+    pending() {
+        if (this.#started)
+            this.#schedule();
+    }
+    #schedule() {
+        if (this.#scheduled || this.#running || this.#end !== undefined)
+            return;
+        this.#scheduled = true;
+        queueMicrotask(() => {
+            this.#scheduled = false;
+            void this.#drain();
+        });
+    }
+    /**
+     * Deliver until nothing is pending; what arrives during a call is taken after it returns. A watch whose source ended
+     * ends once it delivered the rest and its last call returned.
+     */
+    async #drain() {
+        if (this.#running || this.#end !== undefined || !this.#started)
+            return;
+        this.#running = true;
+        try {
+            while (this.#end === undefined) {
+                const listener = this.#listener;
+                if (listener === undefined)
+                    break;
+                const frameContext = this.pendingContext;
+                if (frameContext === undefined) {
+                    if (this.#ending)
+                        this.#terminate(ENDED);
+                    break;
+                }
+                const call = this.next();
+                if (call.kind === "value")
+                    this.#value = call.value;
+                try {
+                    await listener(call, withoutAbortSignal(frameContext));
+                }
+                catch (error) {
+                    if (this.#end === undefined) {
+                        this.#report?.(error);
+                        this.#terminate({ kind: "listener_error", error: toError(error) });
+                    }
+                    break;
+                }
+            }
+        }
+        finally {
+            this.#running = false;
+        }
+    }
+    /**
+     * End the watch, once: detach, drop what is pending and every reference into the source, and settle `closed`. A
+     * callback already running keeps running.
+     */
+    #terminate(end) {
+        if (this.#end !== undefined)
+            return;
+        this.#end = end;
+        const detach = this.#detach;
+        this.#detach = undefined;
+        this.#report = undefined;
+        this.#listener = undefined;
+        this.release();
+        if (this.#abortListener !== undefined)
+            this.#abortSignal?.removeEventListener("abort", this.#abortListener);
+        this.#abortSignal = undefined;
+        this.#abortListener = undefined;
+        detach?.();
+        this.#closed.resolve(end);
+    }
+}
+function toError(error) {
+    if (error instanceof Error)
+        return error;
+    try {
+        return new Error(String(error));
+    }
+    catch {
+        return new Error(Object.prototype.toString.call(error));
+    }
+}
+/**
+ * The watch handle of a JSON source. Frames that arrive before `start()` or while the listener runs wait in one
+ * `PendingOps` queue; the next call gets the newest value, the folded ops of every frame since the previous call (or
+ * `[["r", newest]]` after the queue overflowed), `retired` when any of them was a retirement, and the newest frame's
+ * context. A frame delivered alone is passed on as the source made it. A failure (`fail()`) drops the pending frames and
+ * waits as one `failed` call; a value after it replaces it, and the first value call after a failure is `[["r",
+ * value]]`. `detach` unsubscribes it from its source on termination; `report` gets a listener's throw, which also ends
+ * the watch.
+ */
+export class Watch extends WatchLifecycle {
+    #ops = new PendingOps();
+    /**
+     * The source's call while it is the only frame pending: the call passes it on, with no allocation. A second frame
+     * drops it, so its ops stay only as long as `PendingOps` keeps them (folded, or dropped by an overflow).
+     */
+    #lone;
+    /** The newest frame's value and context, while a call is pending; the context also marks that one is. */
+    #newestValue;
+    #newestContext;
+    /** A pending frame was a retirement. */
+    #retired = false;
+    /** The newest frame was a failure: the next call is this. */
+    #failure;
+    /** A failure came after the last value call: the next value call replaces the root, and ops are not kept. */
+    #replace = false;
+    /**
+     * Queue the frame `call`. A value's ops turn the previous value into it, and `retired` says the document the watch
+     * follows was retired, which the next value call reports however many frames it folds; a failure is `fail()`.
+     */
+    advance(call, context) {
+        if (call.kind === "failed") {
+            this.#fail(call, context);
+            return;
+        }
+        if (!this.open)
+            return;
+        if (this.#replace) {
+            this.#failure = undefined;
+        }
+        else {
+            this.#lone = this.#newestContext === undefined ? call : undefined;
+            this.#ops.push(call.ops);
+        }
+        this.#newestValue = call.value;
+        this.#newestContext = context;
+        if (call.retired)
+            this.#retired = true;
+        this.pending();
+    }
+    /**
+     * Queue a failure the source may recover from: the pending frames are dropped (`value` keeps the last delivered
+     * value), the listener gets `{ kind: "failed", error }`, and the next value arrives as `[["r", value]]`.
+     */
+    fail(error, context) {
+        this.#fail({ kind: "failed", error }, context);
+    }
+    #fail(call, context) {
+        if (!this.open)
+            return;
+        this.#ops.take();
+        this.#lone = undefined;
+        this.#newestValue = undefined;
+        this.#failure = call;
+        this.#newestContext = context;
+        this.#replace = true;
+        this.pending();
+    }
+    get pendingContext() {
+        return this.#newestContext;
+    }
+    next() {
+        // After a failure the call is that failure, or the value after it; otherwise one field read decides.
+        if (this.#replace)
+            return this.#nextAfterFailure();
+        const lone = this.#lone;
+        // Set with the context, which says a frame is pending.
+        const value = this.#newestValue;
+        const batch = this.#ops.take();
+        const retired = this.#retired;
+        this.#lone = undefined;
+        this.#newestValue = undefined;
+        this.#newestContext = undefined;
+        this.#retired = false;
+        // One frame never folds or overflows: its call is the listener's.
+        if (lone !== undefined)
+            return lone;
+        // Values of a JSON watch are JSON; `T` is the source's narrower or wider view of them (e.g. a typed document).
+        const ops = batch.kind === "ops" ? batch.ops : [["r", value]];
+        return { kind: "value", value, ops, retired };
+    }
+    /** The pending failure, or the value after one as a root replacement (no ops were kept since the failure). */
+    #nextAfterFailure() {
+        const failure = this.#failure;
+        this.#newestContext = undefined;
+        if (failure !== undefined) {
+            this.#failure = undefined;
+            return failure;
+        }
+        const value = this.#newestValue;
+        const retired = this.#retired;
+        this.#newestValue = undefined;
+        this.#retired = false;
+        this.#replace = false;
+        return { kind: "value", value, ops: [["r", value]], retired };
+    }
+    release() {
+        this.#ops.take();
+        this.#lone = undefined;
+        this.#newestValue = undefined;
+        this.#newestContext = undefined;
+        this.#retired = false;
+        this.#failure = undefined;
+        this.#replace = false;
+    }
+}
+/** Maximum values retained behind one unavailable native watch listener. */
+const MAX_PENDING_NATIVE_VALUES = 100;
+/**
+ * The watch handle of a native source: every value in order, one call each; past 100 pending values they collapse to
+ * one, `replace()` or by default the newest value. A failure (`fail()`) drops the pending values and waits as one
+ * `failed` call; a value after it replaces it. `detach` and `report` as for `Watch`.
+ */
+export class NativeWatch extends WatchLifecycle {
+    /**
+     * Pending values in order, each followed by its frame's context, from `#head` on. Values are kept raw: the call a
+     * listener gets is built when it is taken, so a value an overflow drops costs no object. A read index instead of
+     * `shift()` takes a backlog in constant time per value; taken slots are cleared at once, the array is emptied once
+     * all of it was taken, and its taken prefix dropped after 100 values.
+     */
+    #pending = [];
+    #head = 0;
+    #replace;
+    /** A pending failure and its frame's context; nothing else is pending meanwhile. */
+    #failure;
+    #failureContext;
+    constructor(value, detach, report, replace) {
+        super(value, detach, report);
+        this.#replace = replace;
+    }
+    /** Queue `value`, the source's new value; it replaces a pending failure. */
+    advance(value, context) {
+        if (!this.open)
+            return;
+        this.#failure = undefined;
+        this.#failureContext = undefined;
+        if (this.#pending.length - this.#head < 2 * MAX_PENDING_NATIVE_VALUES) {
+            this.#pending.push(value, context);
+        }
+        else {
+            this.#pending.length = 0;
+            this.#head = 0;
+            this.#pending.push(this.#replace === undefined ? value : this.#replace(), context);
+        }
+        this.pending();
+    }
+    /**
+     * Queue a failure the source may recover from: the pending values are dropped (`value` keeps the last delivered
+     * value), and the listener gets `{ kind: "failed", error }`.
+     */
+    fail(error, context) {
+        if (!this.open)
+            return;
+        this.#pending.length = 0;
+        this.#head = 0;
+        this.#failure = { kind: "failed", error };
+        this.#failureContext = context;
+        this.pending();
+    }
+    get pendingContext() {
+        // The slot after a value holds its context; past the end it is empty.
+        return this.#failureContext ?? this.#pending[this.#head + 1];
+    }
+    next() {
+        const failure = this.#failure;
+        if (failure !== undefined) {
+            this.#failure = undefined;
+            this.#failureContext = undefined;
+            return failure;
+        }
+        const head = this.#head;
+        const pending = this.#pending;
+        // The slot at `#head` holds a value.
+        const value = pending[head];
+        if (head + 2 === pending.length) {
+            pending.length = 0;
+            this.#head = 0;
+        }
+        else if (head + 2 >= 2 * MAX_PENDING_NATIVE_VALUES) {
+            // A backlog that never drains: drop the taken prefix, at most once per 100 values, so the array stays bounded.
+            pending.copyWithin(0, head + 2);
+            pending.length -= head + 2;
+            this.#head = 0;
+        }
+        else {
+            pending[head] = undefined;
+            pending[head + 1] = undefined;
+            this.#head = head + 2;
+        }
+        return { kind: "value", value };
+    }
+    release() {
+        this.#pending.length = 0;
+        this.#head = 0;
+        this.#replace = undefined;
+        this.#failure = undefined;
+        this.#failureContext = undefined;
+    }
+}
+//# sourceMappingURL=watch.js.map