@earendil-works/chord 1.4.0 → 1.5.0

package/dist/next/host/routines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routines.js","sourceRoot":"","sources":["../../../src/next/host/routines.ts"],"names":[],"mappings":"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","sourcesContent":["// Routines (§14): the standing behaviour an object or a facet declares, `self.on(source, fn)` and `self.onLive(fn)`.\n// They start once their owner went live and stop when it ends (their ctx aborted, the drain waits for running calls);\n// each call gets its own ctx; a call that throws is reported and called again after a backoff.\n\nimport type { Context } from \"../../context/index.ts\";\nimport { type Op, PendingOps } from \"../../delta/index.ts\";\nimport type { JsonValue } from \"../../json.ts\";\nimport {\n\tNativeWatch,\n\ttype NativeWatchable,\n\ttype NativeWatchCall,\n\ttype Watchable,\n\ttype WatchCall,\n\ttype WatchEnd,\n} from \"../../watch.ts\";\nimport type { Principal } from \"../data/index.ts\";\nimport { NativeSource, Source } from \"../state/internal.ts\";\nimport { nextDelay } from \"./backoff.ts\";\nimport { CallContext, type Caller, type Ctx } from \"./ctx.ts\";\nimport type { AnyHost, Position } from \"./host.ts\";\nimport { resolveWatchable } from \"./reference.ts\";\nimport { sleep } from \"./sleep.ts\";\n\n/**\n * Where routines run: their owner's label (for reports), its host, whom their calls act for, and the context of their\n * calls, aborted when the owner ends. `admit` adds a running call to the owner's drain.\n */\nexport type RoutineOwner = {\n\treadonly label: string;\n\treadonly host: AnyHost;\n\treadonly caller: Caller;\n\treadonly context: Context;\n\t/**\n\t * Adds a running call to the drain; `cleanup` (its bookkeeping) runs once, when it settles or when the attempt ends\n\t * with it still running.\n\t */\n\tadmit(running: Promise<unknown>, cleanup: () => void): void;\n};\n\n/**\n * A routine's handler of a JSON source: the value call (the value, the ops since the previous call, whether the\n * source's document was retired since then) and the call's ctx. Failures are not calls of a handler (design §11): the\n * routine waits for the next value.\n */\nexport type OnHandler<T, C extends Ctx = Ctx> = (call: WatchValueCall<T>, ctx: C) => void | Promise<void>;\n\n/** A JSON watch's value call: what an `on` handler gets. */\nexport type WatchValueCall<T> = Extract<WatchCall<T>, { readonly kind: \"value\" }>;\n\n/** A native watch's value call. */\nexport type NativeWatchValueCall<T> = Extract<NativeWatchCall<T>, { readonly kind: \"value\" }>;\n\n/** A routine's handler of a native source: the value call (the value) and the call's ctx. */\nexport type OnNativeHandler<T, C extends Ctx = Ctx> = (call: NativeWatchValueCall<T>, ctx: C) => void | Promise<void>;\n\n/** An `onLive` routine: called once its owner is live. */\nexport type OnLiveHandler<C extends Ctx = Ctx> = (ctx: C) => void | Promise<void>;\n\n/** What the declarations of an owner (`on`, `onLive`) take; part of the factory's `self` and the facet's. */\nexport interface RoutineDeclarations<P extends Principal = Principal> {\n\t/**\n\t * A routine over `source`: `fn` gets its current value first (ops `[[\"r\", value]]`), then one call per change,\n\t * never overlapping: changes during a call fold into one next call (the newest value, the ops since the previous\n\t * call, `retired` when any of them was a retirement). After a call that threw, it is called again with the whole\n\t * newest value (`retired` again if the call that threw had it) after a backoff (1 s doubling to 60 s), or at once on\n\t * a change during the backoff. Ends with its source. A JSON watchable is one whose watch is Chord's shared `Watch`\n\t * (every Chord and Durable source).\n\t */\n\ton<T>(source: Watchable<T>, fn: OnHandler<T, Ctx<P>>): void;\n\t/**\n\t * A routine over a native source (a registry value, `ref.state`): one whose watch is Chord's shared `NativeWatch`.\n\t * As above without ops: after a busy call, one call with the newest value.\n\t */\n\ton<T>(source: NativeWatchable<T>, fn: OnNativeHandler<T, Ctx<P>>): void;\n\t/**\n\t * A routine called once its owner is live. Returning ends it; a throw is reported and restarts it after a backoff\n\t * (1 s doubling to 60 s, reset after a run of a minute); the owner's end aborts its ctx.\n\t */\n\tonLive(fn: OnLiveHandler<Ctx<P>>): void;\n}\n\n/** A declared routine: its kind and position in reports (`{ kind: \"on\", position: 2 }`), its source and its handler. */\ntype Declaration =\n\t| {\n\t\t\treadonly kind: \"on\";\n\t\t\treadonly at: Position;\n\t\t\treadonly source: Watchable<unknown> | NativeWatchable<unknown>;\n\t\t\treadonly fn: (...args: never[]) => void | Promise<void>;\n\t  }\n\t| { readonly kind: \"onLive\"; readonly at: Position; readonly fn: OnLiveHandler };\n\n/** How one routine call ended. */\ntype Called = { readonly kind: \"done\" } | { readonly kind: \"failed\"; readonly error: unknown };\n\nconst DONE: Called = { kind: \"done\" };\n\n/** What `#failing` says of a source failed now. */\nconst FAILING = { kind: \"failed\" } as const;\n\n/** One run of an `onLive` that lasted this long resets its backoff. */\nconst LONG_RUN = 60_000;\n\n/** An owner's routines: declared while its factory (or setup) runs, started once when it went live. */\nexport class Routines {\n\treadonly #declared: Declaration[] = [];\n\t#ons = 0;\n\t#lives = 0;\n\n\t/** Declares `on(source, fn)`; whether the source is JSON or native is decided by its watch (`OnRoutine`). */\n\ton(source: Watchable<unknown> | NativeWatchable<unknown>, fn: (...args: never[]) => void | Promise<void>): void {\n\t\tthis.#declared.push({ kind: \"on\", at: { kind: \"on\", position: ++this.#ons }, source, fn });\n\t}\n\n\t/** Whether nothing was declared. */\n\tget empty(): boolean {\n\t\treturn this.#declared.length === 0;\n\t}\n\n\t/** Declares `onLive(fn)`. */\n\tonLive(fn: OnLiveHandler): void {\n\t\tthis.#declared.push({ kind: \"onLive\", at: { kind: \"onLive\", position: ++this.#lives }, fn });\n\t}\n\n\t/**\n\t * Starts every routine for `owner`, which went live; they stop when its context is aborted. A routine whose\n\t * synchronous start ends the owner (an `onLive` releasing its last reference) starts none of the later ones.\n\t */\n\tstart(owner: RoutineOwner): void {\n\t\tfor (const declaration of this.#declared) {\n\t\t\tif (owner.context.abortSignal?.aborted) return;\n\t\t\tif (declaration.kind === \"on\") void new OnRoutine(owner, declaration).start();\n\t\t\telse void live(owner, declaration);\n\t\t}\n\t}\n}\n\n/**\n * Runs `onLive`'s handler until it returns or its owner ends; a throw is reported and the handler restarts after the\n * backoff.\n */\nasync function live(owner: RoutineOwner, { at, fn }: Extract<Declaration, { kind: \"onLive\" }>): Promise<void> {\n\tlet delay: number | undefined;\n\twhile (!owner.context.abortSignal?.aborted) {\n\t\tconst started = Date.now();\n\t\tconst called = await call(owner, fn);\n\t\tif (called.kind === \"done\" || owner.context.abortSignal?.aborted) return;\n\t\tfailed(owner, at, called.error);\n\t\tdelay = nextDelay(Date.now() - started >= LONG_RUN ? undefined : delay);\n\t\ttry {\n\t\t\tawait sleep(delay, owner.context);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t}\n}\n\n/**\n * Runs one routine call under its own ctx (its `ctx.get` references released when it settles), admitted to the owner's\n * drain before the handler runs: a handler may end its own owner before its first await. Resolves with how it ended;\n * never rejects.\n */\nfunction call(owner: RoutineOwner, invoke: (ctx: Ctx) => void | Promise<void>): Promise<Called> {\n\tconst ctx = new CallContext(owner.context, owner.caller, owner.host);\n\tconst settled = Promise.withResolvers<Called>();\n\towner.admit(settled.promise, () => ctx.settle());\n\tconst finish = (called: Called): void => {\n\t\tctx.settle();\n\t\tsettled.resolve(called);\n\t};\n\t// Plugin code: a synchronous throw becomes the rejection.\n\t(async () => invoke(ctx))().then(\n\t\t() => finish(DONE),\n\t\t(error: unknown) => finish({ kind: \"failed\", error }),\n\t);\n\treturn settled.promise;\n}\n\n/** Reports a failed routine call or source. */\nfunction failed(owner: RoutineOwner, routine: Position, error: unknown): void {\n\towner.host.report({ kind: \"routine_failed\", object: owner.label, routine, error });\n}\n\n/**\n * Where an `on` routine stands. `starting`: taking its watch; `idle`: waiting for a change; `calling`: a call runs\n * (changes meanwhile wait, folded, for the next); `settling`: a call succeeded while changes arrived, and the next one\n * waits for one macrotask, so every value its watch still buffers (a native watch replays them one per microtask) is\n * taken first; `backoff`: the last call threw and its timer calls again, unless a change during the backoff calls\n * first; `ended`: its watch ended (the owner ended, or the source ended or failed).\n */\ntype OnState =\n\t| { readonly kind: \"starting\" | \"idle\" | \"calling\" | \"ended\" }\n\t| { readonly kind: \"settling\" | \"backoff\"; readonly timer: ReturnType<typeof setTimeout> };\n\n/**\n * What the next call's ops are relative to: `none` before the first call and after a throw (the handler may not have\n * applied what it got: the next call gets the whole value), `last` after a call that succeeded.\n */\ntype Basis = \"none\" | \"last\";\n\n/**\n * One `on` routine. Its watch's listener never throws (a throwing listener would end the watch) and never waits: it\n * keeps the newest frame, folding JSON ops, and the routine makes one call at a time from it, the first call and the\n * retries after a throw through the same pending frame.\n */\nclass OnRoutine {\n\treadonly #owner: RoutineOwner;\n\treadonly #declaration: Extract<Declaration, { kind: \"on\" }>;\n\t#state: OnState = { kind: \"starting\" };\n\t/** A native source's watch yields values without ops; decided by its watch's class. */\n\t#native = false;\n\t/** The newest value no call got yet. */\n\t#pending: { readonly value: unknown } | undefined;\n\t/** The ops of the frames since the last call (JSON sources), folded. */\n\treadonly #ops = new PendingOps();\n\t/** One of the frames since the last call was a retirement (JSON sources). */\n\t#retired = false;\n\t#basis: Basis = \"none\";\n\t/** The value of the last call: a retry after a throw calls with it. */\n\t#last: unknown;\n\t/** The last call reported a retirement: a retry after a throw reports it again. */\n\t#lastRetired = false;\n\t#delay: number | undefined;\n\t/** The source failed after its last value: no call until its next value (a retry waits too). */\n\t#failed = false;\n\n\tconstructor(owner: RoutineOwner, declaration: Extract<Declaration, { kind: \"on\" }>) {\n\t\tthis.#owner = owner;\n\t\tthis.#declaration = declaration;\n\t}\n\n\t/**\n\t * Takes the watch and calls with its value. On a failed Chord source it waits for its first good value instead (a\n\t * source that never had one is followed until it has). A source that cannot be watched otherwise is reported; an\n\t * owner or source that ended meanwhile ends the routine. Never rejects.\n\t */\n\tasync start(): Promise<void> {\n\t\tconst { source, at } = this.#declaration;\n\t\tlet failing = this.#failing();\n\t\twhile (failing?.kind === \"no_value\") {\n\t\t\tif (!(await this.#firstValue(failing.source))) {\n\t\t\t\tthis.#state = { kind: \"ended\" };\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Asked again: a failure may have followed the first value before this resumed (one receive turn).\n\t\t\tfailing = this.#failing();\n\t\t}\n\t\tlet watch: Awaited<ReturnType<typeof source.watch>>;\n\t\ttry {\n\t\t\twatch = await source.watch(this.#owner.context);\n\t\t} catch (error) {\n\t\t\tthis.#state = { kind: \"ended\" };\n\t\t\tif (!this.#aborted()) failed(this.#owner, at, error);\n\t\t\treturn;\n\t\t}\n\t\tthis.#native = watch instanceof NativeWatch;\n\t\tvoid watch.closed.then((end) => this.#end(end));\n\t\ttry {\n\t\t\t// Both listeners return at once.\n\t\t\twatch.start((call: WatchCall<unknown> | NativeWatchCall<unknown>) => {\n\t\t\t\tif (call.kind === \"value\") this.#frame(call);\n\t\t\t\telse this.#failure();\n\t\t\t\treturn Promise.resolve();\n\t\t\t});\n\t\t} catch {\n\t\t\t// The watch ended while it was taken (the owner or the source ended): `closed` says how.\n\t\t\treturn;\n\t\t}\n\t\t// A watch opened on a failed source holds its last good value, a stale one: its first call is the failure.\n\t\tif (failing?.kind === \"failed\") {\n\t\t\tthis.#state = { kind: \"idle\" };\n\t\t\treturn;\n\t\t}\n\t\tthis.#pending = { value: watch.value };\n\t\tthis.#next();\n\t}\n\n\t/**\n\t * Whether the source is a Chord source failed now (`failed`), or a JSON one with no value yet (`no_value`, with the\n\t * source to follow); `undefined` otherwise (Durable's views tell their failures through their watches).\n\t */\n\t#failing(): { readonly kind: \"failed\" } | { readonly kind: \"no_value\"; readonly source: Source } | undefined {\n\t\tconst declared = this.#declaration.source;\n\t\t// A native source opens its watch at its last good value while failed (a registry whose `compose` threw): its\n\t\t// first call is the failure, not that stale value.\n\t\tif (declared instanceof NativeSource) return declared.start().kind === \"failed\" ? FAILING : undefined;\n\t\tlet source: unknown;\n\t\ttry {\n\t\t\tsource = resolveWatchable(this.#declaration.source);\n\t\t} catch {\n\t\t\t// Not bound or ended: the watch says so.\n\t\t\treturn undefined;\n\t\t}\n\t\tif (!(source instanceof Source)) return undefined;\n\t\tlet start: ReturnType<Source[\"start\"]>;\n\t\ttry {\n\t\t\tstart = source.start();\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t\tif (start.kind === \"value\") return undefined;\n\t\treturn start.last === undefined ? { kind: \"no_value\", source } : { kind: \"failed\" };\n\t}\n\n\t/**\n\t * Follows `source`, failed with no value, until its first good value (`true`), or until it or the owner ends\n\t * (`false`): a subscriber of its own, since a watch has nothing to start at.\n\t */\n\t#firstValue(source: Source): Promise<boolean> {\n\t\tconst signal = this.#owner.context.abortSignal;\n\t\treturn new Promise((resolve) => {\n\t\t\tconst done = (got: boolean): void => {\n\t\t\t\tsource.unsubscribe(subscriber);\n\t\t\t\tsignal?.removeEventListener(\"abort\", aborted);\n\t\t\t\tresolve(got);\n\t\t\t};\n\t\t\tconst subscriber = {\n\t\t\t\tadvance: (call: WatchCall<JsonValue>) => {\n\t\t\t\t\tif (call.kind === \"value\") done(true);\n\t\t\t\t},\n\t\t\t\tend: () => done(false),\n\t\t\t\tendAfterDelivery: () => done(false),\n\t\t\t};\n\t\t\tconst aborted = (): void => done(false);\n\t\t\tsignal?.addEventListener(\"abort\", aborted, { once: true });\n\t\t\tif (signal?.aborted) aborted();\n\t\t\telse source.subscribe(subscriber);\n\t\t});\n\t}\n\n\t/**\n\t * The source failed: what was pending goes (a value a failure followed is stale), a pending retry or settle is\n\t * dropped, and the next call waits for the next value, as a whole value; a running call runs on.\n\t */\n\t#failure(): void {\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"ended\") return;\n\t\tthis.#failed = true;\n\t\tthis.#pending = undefined;\n\t\tthis.#ops.take();\n\t\tthis.#basis = \"none\";\n\t\tif (state.kind === \"backoff\" || state.kind === \"settling\") {\n\t\t\tclearTimeout(state.timer);\n\t\t\tthis.#state = { kind: \"idle\" };\n\t\t}\n\t}\n\n\t/**\n\t * A frame of the watch: kept as the newest; it is called at once when nothing runs or waits, during a backoff too\n\t * (the backoff ends); while a call runs or settles it waits for the next call.\n\t */\n\t#frame(call: WatchValueCall<unknown> | NativeWatchValueCall<unknown>): void {\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"ended\") return;\n\t\tthis.#failed = false;\n\t\tthis.#pending = { value: call.value };\n\t\tif (!this.#native) {\n\t\t\t// A JSON watch's call, as its class decided.\n\t\t\tconst { ops, retired } = call as WatchValueCall<unknown>;\n\t\t\tthis.#ops.push(ops);\n\t\t\tif (retired) this.#retired = true;\n\t\t}\n\t\tif (state.kind === \"backoff\") clearTimeout(state.timer);\n\t\tif (state.kind === \"backoff\" || state.kind === \"idle\") this.#next();\n\t}\n\n\t/** Makes the next call from the pending frame, if there is one and the owner still runs; otherwise idles. */\n\t#next(): void {\n\t\tconst pending = this.#pending;\n\t\tif (pending === undefined || this.#aborted()) {\n\t\t\tthis.#state = { kind: \"idle\" };\n\t\t\treturn;\n\t\t}\n\t\tthis.#pending = undefined;\n\t\tconst { value } = pending;\n\t\tthis.#state = { kind: \"calling\" };\n\t\tthis.#last = value;\n\t\tvoid call(this.#owner, this.#invocation(value)).then((called) => this.#called(called));\n\t}\n\n\t/**\n\t * The handler's call with `value`: a native one with the value alone, a JSON one with the folded ops or the whole\n\t * value, and whether a retirement came since the last call.\n\t */\n\t#invocation(value: unknown): (ctx: Ctx) => void | Promise<void> {\n\t\tconst { fn } = this.#declaration;\n\t\t// The overloads typed `fn` for its source's kind, which the watch decided.\n\t\tif (this.#native) return (ctx) => (fn as OnNativeHandler<unknown>)({ kind: \"value\", value }, ctx);\n\t\tconst taken = this.#ops.take();\n\t\t// A JSON source's values are JSON.\n\t\tconst ops: readonly Op[] =\n\t\t\tthis.#basis === \"none\" || taken.kind === \"replace\" ? [[\"r\", value as JsonValue]] : taken.ops;\n\t\tconst retired = this.#retired;\n\t\tthis.#retired = false;\n\t\tthis.#lastRetired = retired;\n\t\treturn (ctx) => (fn as OnHandler<unknown>)({ kind: \"value\", value, ops, retired }, ctx);\n\t}\n\n\t/**\n\t * A call settled. After a success the next frame's ops build on it, and changes that arrived during the call are\n\t * called after one macrotask (`settling`). After a throw (reported) the backoff always starts, also when changes\n\t * arrived during the call (a handler that changes its own source and throws would feed itself otherwise); its timer\n\t * calls with the newest value, or the last call's, as a whole value.\n\t */\n\t#called(called: Called): void {\n\t\tif (this.#state.kind === \"ended\") return;\n\t\tif (called.kind === \"done\") {\n\t\t\tthis.#basis = \"last\";\n\t\t\tthis.#delay = undefined;\n\t\t\tif (this.#pending === undefined) this.#state = { kind: \"idle\" };\n\t\t\telse this.#state = { kind: \"settling\", timer: setTimeout(() => this.#next(), 0) };\n\t\t\treturn;\n\t\t}\n\t\tif (this.#aborted()) return;\n\t\tfailed(this.#owner, this.#declaration.at, called.error);\n\t\tthis.#basis = \"none\";\n\t\t// The handler may not have applied the retirement either.\n\t\tif (this.#lastRetired) this.#retired = true;\n\t\tthis.#delay = nextDelay(this.#delay);\n\t\t// The source failed meanwhile: the retry waits for its next value, never the stale last one.\n\t\tif (this.#failed) {\n\t\t\tthis.#state = { kind: \"idle\" };\n\t\t\treturn;\n\t\t}\n\t\tconst timer = setTimeout(() => {\n\t\t\tthis.#pending ??= { value: this.#last };\n\t\t\tthis.#next();\n\t\t}, this.#delay);\n\t\tthis.#state = { kind: \"backoff\", timer };\n\t}\n\n\t/** The watch ended: the owner ended (aborted), or the source ended (no report) or failed (reported once). */\n\t#end(end: WatchEnd): void {\n\t\tconst state = this.#state;\n\t\tthis.#state = { kind: \"ended\" };\n\t\tif (state.kind === \"settling\" || state.kind === \"backoff\") clearTimeout(state.timer);\n\t\tthis.#pending = undefined;\n\t\tthis.#ops.take();\n\t\tthis.#retired = false;\n\t\tif (end.kind === \"failed\" && !this.#aborted()) failed(this.#owner, this.#declaration.at, end.error);\n\t}\n\n\t#aborted(): boolean {\n\t\treturn this.#owner.context.abortSignal?.aborted === true;\n\t}\n}\n"]}

package/dist/next/host/sleep.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from "../../context/index.ts";
+/**
+ * Resolves after `ms` milliseconds; rejects with the abort reason once `context` is aborted, clearing its timer and
+ * listener. Delays above the timer limit (2^31-1 ms) are chained timers.
+ */
+export declare function sleep(ms: number, context: Context): Promise<void>;
+/** Resolves once `context` is aborted (never without an abort signal); leaves no listener behind. */
+export declare function untilAborted(context: Context): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/next/host/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/next/host/sleep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAKtD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBjE;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5D"}

package/dist/next/host/sleep.js

@@ -0,0 +1,40 @@
+// Waiting helpers for routines, jobs and handlers (§14): `sleep(ms, ctx)` and `untilAborted(ctx)`, which end with
+// their context, leaving no timer or listener behind. Portable: timers and `AbortSignal` only.
+/** The longest delay one timer takes (a longer one fires at once). */
+const MAX_TIMER = 2 ** 31 - 1;
+/**
+ * Resolves after `ms` milliseconds; rejects with the abort reason once `context` is aborted, clearing its timer and
+ * listener. Delays above the timer limit (2^31-1 ms) are chained timers.
+ */
+export function sleep(ms, context) {
+    const signal = context.abortSignal;
+    if (signal?.aborted)
+        return Promise.reject(signal.reason);
+    const { promise, resolve, reject } = Promise.withResolvers();
+    let timer;
+    const abort = () => {
+        clearTimeout(timer);
+        reject(signal?.reason);
+    };
+    const wait = (left) => {
+        timer = setTimeout(() => {
+            if (left > MAX_TIMER)
+                return wait(left - MAX_TIMER);
+            signal?.removeEventListener("abort", abort);
+            resolve();
+        }, Math.min(left, MAX_TIMER));
+    };
+    signal?.addEventListener("abort", abort, { once: true });
+    wait(ms);
+    return promise;
+}
+/** Resolves once `context` is aborted (never without an abort signal); leaves no listener behind. */
+export function untilAborted(context) {
+    const signal = context.abortSignal;
+    if (signal === undefined)
+        return new Promise(() => { });
+    if (signal.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => signal.addEventListener("abort", () => resolve(), { once: true }));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/next/host/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/next/host/sleep.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,+FAA+F;AAI/F,sEAAsE;AACtE,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,OAAgB;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACnC,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAC;IACnE,IAAI,KAAgD,CAAC;IACrD,MAAM,KAAK,GAAG,GAAS,EAAE;QACxB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE;QACnC,KAAK,GAAG,UAAU,CACjB,GAAG,EAAE;YACJ,IAAI,IAAI,GAAG,SAAS;gBAAE,OAAO,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;YACpD,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5C,OAAO,EAAE,CAAC;QACX,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CACzB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC","sourcesContent":["// Waiting helpers for routines, jobs and handlers (§14): `sleep(ms, ctx)` and `untilAborted(ctx)`, which end with\n// their context, leaving no timer or listener behind. Portable: timers and `AbortSignal` only.\n\nimport type { Context } from \"../../context/index.ts\";\n\n/** The longest delay one timer takes (a longer one fires at once). */\nconst MAX_TIMER = 2 ** 31 - 1;\n\n/**\n * Resolves after `ms` milliseconds; rejects with the abort reason once `context` is aborted, clearing its timer and\n * listener. Delays above the timer limit (2^31-1 ms) are chained timers.\n */\nexport function sleep(ms: number, context: Context): Promise<void> {\n\tconst signal = context.abortSignal;\n\tif (signal?.aborted) return Promise.reject(signal.reason);\n\tconst { promise, resolve, reject } = Promise.withResolvers<void>();\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\tconst abort = (): void => {\n\t\tclearTimeout(timer);\n\t\treject(signal?.reason);\n\t};\n\tconst wait = (left: number): void => {\n\t\ttimer = setTimeout(\n\t\t\t() => {\n\t\t\t\tif (left > MAX_TIMER) return wait(left - MAX_TIMER);\n\t\t\t\tsignal?.removeEventListener(\"abort\", abort);\n\t\t\t\tresolve();\n\t\t\t},\n\t\t\tMath.min(left, MAX_TIMER),\n\t\t);\n\t};\n\tsignal?.addEventListener(\"abort\", abort, { once: true });\n\twait(ms);\n\treturn promise;\n}\n\n/** Resolves once `context` is aborted (never without an abort signal); leaves no listener behind. */\nexport function untilAborted(context: Context): Promise<void> {\n\tconst signal = context.abortSignal;\n\tif (signal === undefined) return new Promise(() => {});\n\tif (signal.aborted) return Promise.resolve();\n\treturn new Promise((resolve) => signal.addEventListener(\"abort\", () => resolve(), { once: true }));\n}\n"]}

package/dist/next/host/staging.d.ts

@@ -0,0 +1,94 @@
+import type { Context } from "../../context/index.ts";
+import type { Watchable } from "../../watch.ts";
+import type { Contract, ParamsOf } from "../contracts/index.ts";
+import type { Principal } from "../data/index.ts";
+import type { AnyDefinition } from "../documents/internal.ts";
+import type { JobDefinition } from "../jobs/index.ts";
+import type { Registry, RegistryProvider } from "../registries/index.ts";
+import type { TableDefinition } from "../store/table.ts";
+import { type Facet, type FacetContribution } from "./facet.ts";
+import type { ChordObject, Served } from "./object.ts";
+import type { Presence } from "./presence.ts";
+/** A plugin's facet as `load` and `reload` take it: its name (its `package.json` name) and its facet. */
+export type PluginFacet<P extends Principal = Principal> = {
+    readonly name: string;
+    readonly facet: Facet<P>;
+};
+/** A registry a staged plugin serves: the defining plugin, the token and its provider. */
+export type StagedRegistry = {
+    readonly plugin: string;
+    readonly registry: Registry<unknown, unknown>;
+    readonly provider: RegistryProvider<unknown, unknown>;
+};
+/** One plugin's setup, run and checked: what it serves and contributes, nothing published yet. */
+export type StagedPlugin = {
+    readonly name: string;
+    /** The served types by name, each with its plugin, factory, provider (its `accepts` checked) and `linger`. */
+    readonly types: ReadonlyMap<string, Served>;
+    /** The served registries by name. */
+    readonly registries: ReadonlyMap<string, StagedRegistry>;
+    /** The facet contributions, in the setup's order. */
+    readonly contributions: readonly FacetContribution[];
+};
+/** A plugin set's staged plugins, merged: what they serve, by name, and each plugin's own table. */
+export type Staged = {
+    readonly types: Map<string, Served>;
+    readonly registries: Map<string, StagedRegistry>;
+    readonly plugins: Map<string, StagedPlugin>;
+};
+/** What staging needs of its host: whom it acts as, where it lives, and its presence lists for setups. */
+export type StagingHost = {
+    readonly principal: Principal | undefined;
+    readonly address: unknown;
+    references<C extends Contract>(Type: C): Watchable<readonly Presence<C, Principal>[]>;
+};
+/** Whether `name` is a valid plugin name: an npm package name, scoped or not (the plugins component checks it too). */
+export declare function isPluginName(name: string): boolean;
+/** A staged table with nothing in it. */
+export declare function emptyStaged(): Staged;
+/**
+ * Runs one plugin's setup and checks what it declared: its name (an npm name), a type or registry it serves twice, a
+ * remote type on a host without a principal or address, every provider's `accepts` (`checkAccepts`) and every registry
+ * provider's shape. Throws the first error, naming the plugin.
+ */
+export declare function stagePlugin<P extends Principal>({ name, facet }: PluginFacet<P>, host: StagingHost): StagedPlugin;
+/**
+ * Merges `plugin` into `staged`; a type or registry another plugin serves there already refuses it (its error
+ * returned, nothing merged).
+ */
+export declare function addStaged(staged: Staged, plugin: StagedPlugin): Error | undefined;
+/** What a recorded factory declared: what a reload's fate and checks need, nothing activated. */
+export type Recorded = {
+    /** How many natives it opens (`self.open`). */
+    readonly natives: number;
+    readonly documents: readonly AnyDefinition[];
+    readonly tables: readonly TableDefinition[];
+    readonly jobs: readonly JobDefinition<unknown, unknown, unknown>[];
+    readonly contributions: readonly Registry<unknown, unknown>[];
+    /** Its requests: the types it gets (`self.get`, with their checked params) and the registries it reads (`self.registry`). */
+    readonly requests: readonly Request[];
+};
+/** A recorded request, with the contract version it was made at: a type and its params, or a registry. */
+export type Request = {
+    readonly kind: "type";
+    readonly contract: Contract;
+    readonly params: ParamsOf<Contract>;
+} | {
+    readonly kind: "registry";
+    readonly registry: Registry<unknown, unknown>;
+};
+/**
+ * Runs `served`'s factory for `object` (its params and principal) against a recording `self` and returns what it
+ * declared. Every declaration check an attempt makes runs, without effects (declared twice; persisted data in a type
+ * without a stable identity, on a host without a store, or claimed by another owner; contributions outside
+ * host-lifetime objects, or twice; `retryOn` sources that do not outlive the attempt; params; a document or job
+ * declared at an older version than the object's, or at its version with another schema); a throw is the factory's.
+ * Handles it hands out are inert, except registry values (the host's own, which `retryOn` checks by kind).
+ */
+export declare function recordFactory(object: ChordObject, served: Served, context: Context): Recorded;
+/**
+ * Whether `recorded`'s tables are at a version newer than `object`'s store has them: their eager migration runs at an
+ * activation, so the object restarts instead of swapping (§4).
+ */
+export declare function migratesTables(object: ChordObject, recorded: Recorded): boolean;
+//# sourceMappingURL=staging.d.ts.map

package/dist/next/host/staging.d.ts.map

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

package/dist/next/host/staging.js

@@ -0,0 +1,302 @@
+// Staging (slice 7b §2; per plugin, decision "Per plugin at startup and reload"): each plugin's setup runs into a table of
+// its own (the types it serves with their providers, the registries it serves, its facet contributions) with `load`'s
+// checks, merged into the staged table beside the live one, where a type or registry another plugin serves already
+// fails the plugin; and an object's new factory run against a recording `self`, which keeps what the factory declares
+// (natives, documents, tables, jobs, contributions, requests with their contract versions) and activates, binds and
+// opens nothing, so a reload decides each object's fate, and which plugins keep their old code, before its commit.
+// `load` stages its facets the same way and publishes them.
+import { contractData } from "../contracts/internal.js";
+import { bindProvider, checkParams } from "../data/internal.js";
+import { checkProvider } from "../registries/internal.js";
+import { tableSqlName } from "../store/sql.js";
+import { setUp } from "./facet.js";
+import { retrySource } from "./retry-on.js";
+/** An npm package name, scoped or not. */
+const PLUGIN_NAME = /^(?:@[a-z0-9~-][a-z0-9._~-]*\/)?[a-z0-9~-][a-z0-9._~-]*$/;
+/** Whether `name` is a valid plugin name: an npm package name, scoped or not (the plugins component checks it too). */
+export function isPluginName(name) {
+    return PLUGIN_NAME.test(name);
+}
+/** A staged table with nothing in it. */
+export function emptyStaged() {
+    return { types: new Map(), registries: new Map(), plugins: new Map() };
+}
+/**
+ * Runs one plugin's setup and checks what it declared: its name (an npm name), a type or registry it serves twice, a
+ * remote type on a host without a principal or address, every provider's `accepts` (`checkAccepts`) and every registry
+ * provider's shape. Throws the first error, naming the plugin.
+ */
+export function stagePlugin({ name, facet }, host) {
+    if (!isPluginName(name))
+        throw new Error(`"${name}" is not a valid plugin name`);
+    // The host's presence lists are typed for its `P`.
+    const references = host.references;
+    const types = new Map();
+    const registries = new Map();
+    try {
+        const { served, contributions } = setUp(name, facet, references);
+        for (const entry of served)
+            stageEntry(name, entry, types, registries, host);
+        return { name, types, registries, contributions };
+    }
+    catch (error) {
+        throw named(error, `plugin "${name}"`);
+    }
+}
+/**
+ * Merges `plugin` into `staged`; a type or registry another plugin serves there already refuses it (its error
+ * returned, nothing merged).
+ */
+export function addStaged(staged, plugin) {
+    for (const name of plugin.types.keys()) {
+        const other = staged.types.get(name);
+        if (other !== undefined)
+            return new Error(`plugin "${plugin.name}": ${name} is served twice (plugin "${other.plugin}")`);
+    }
+    for (const name of plugin.registries.keys()) {
+        const other = staged.registries.get(name);
+        if (other !== undefined) {
+            return new Error(`plugin "${plugin.name}": registry ${name} is served twice (plugin "${other.plugin}")`);
+        }
+    }
+    for (const [name, served] of plugin.types)
+        staged.types.set(name, served);
+    for (const [name, registry] of plugin.registries)
+        staged.registries.set(name, registry);
+    staged.plugins.set(plugin.name, plugin);
+    return undefined;
+}
+/** Stages one served entry of `plugin` into its tables: a registry's provider, or a type as `Served`. */
+function stageEntry(plugin, entry, types, registries, host) {
+    if (entry.kind === "registry") {
+        const { registry, provider } = entry;
+        if (registries.has(registry.name))
+            throw new Error(`registry ${registry.name} is served twice`);
+        checkProvider(registry.name, provider);
+        registries.set(registry.name, { plugin, registry, provider });
+        return;
+    }
+    const { contract, factory, options } = entry;
+    if (types.has(contract.name))
+        throw new Error(`${contract.name} is served twice`);
+    // A client serves only local types (§3): a remote object is owned by a principal of the host serving it.
+    if (contract.kind === "remote" && host.principal === undefined) {
+        throw new Error(`${contract.name}: a host without a principal serves only local types`);
+    }
+    // A remote object lives on the host its `hostAddress` names: only a host with an address can be that host.
+    if (contract.kind === "remote" && host.address === undefined) {
+        throw new Error(`${contract.name}: a host without an address serves only local types`);
+    }
+    const provider = bindProvider(contract, options.accepts ?? {});
+    const common = { plugin, provider, linger: options.linger ?? 0 };
+    // The contract's kind decides the factory's signature and the contract's shape.
+    const served = contract.kind === "local"
+        ? {
+            ...common,
+            kind: "local",
+            contract: contract,
+            factory: factory,
+            hostLifetime: contractData(contract).params.fields.length === 0,
+        }
+        : {
+            ...common,
+            kind: "remote",
+            contract: contract,
+            factory: factory,
+        };
+    types.set(contract.name, served);
+}
+/**
+ * Runs `served`'s factory for `object` (its params and principal) against a recording `self` and returns what it
+ * declared. Every declaration check an attempt makes runs, without effects (declared twice; persisted data in a type
+ * without a stable identity, on a host without a store, or claimed by another owner; contributions outside
+ * host-lifetime objects, or twice; `retryOn` sources that do not outlive the attempt; params; a document or job
+ * declared at an older version than the object's, or at its version with another schema); a throw is the factory's.
+ * Handles it hands out are inert, except registry values (the host's own, which `retryOn` checks by kind).
+ */
+export function recordFactory(object, served, context) {
+    const recording = new RecordingSelf(object, served, context);
+    // A recording `self` takes every declaration a factory makes, its handles inert.
+    const self = recording;
+    try {
+        if (served.kind === "local")
+            served.factory(object.params, self);
+        // A remote object's identity has its principal.
+        else
+            served.factory(object.params, object.principal, self);
+    }
+    catch (error) {
+        throw named(error, `plugin "${served.plugin}", ${object.label}`);
+    }
+    finally {
+        recording.declaring = false;
+    }
+    return recording.recorded;
+}
+/** A staging error naming where it happened (`what`): its message prefixed, the error itself its cause. */
+function named(error, what) {
+    const message = error instanceof Error ? error.message : String(error);
+    return new Error(`${what}: ${message}`, { cause: error });
+}
+/**
+ * The value of every handle a recording `self` hands out: any property or call gives it again, and it is never a
+ * thenable. Typed `never` (a cast: it stands for every handle type, and nothing reads it as one).
+ */
+const INERT = new Proxy(() => { }, {
+    get: (_target, property) => (property === "then" ? undefined : INERT),
+    apply: () => INERT,
+});
+/** A factory's `self` during staging: it records declarations and checks them; it activates nothing. */
+class RecordingSelf {
+    declaring = true;
+    #object;
+    #served;
+    #context;
+    #natives = 0;
+    #documents = new Map();
+    #tables = new Map();
+    #jobs = new Map();
+    #contributions = new Map();
+    #requests = [];
+    constructor(object, served, context) {
+        this.#object = object;
+        this.#served = served;
+        this.#context = context;
+    }
+    get recorded() {
+        return {
+            natives: this.#natives,
+            documents: [...this.#documents.values()],
+            tables: [...this.#tables.values()],
+            jobs: [...this.#jobs.values()],
+            contributions: [...this.#contributions.values()],
+            requests: this.#requests,
+        };
+    }
+    state(definition) {
+        this.#assertDeclaring("state");
+        const what = `state "${definition.name}"`;
+        if (this.#documents.has(definition.name))
+            throw new Error(`${this.#object.label}: ${what} is declared twice`);
+        if (definition.persist)
+            this.#assertClaimable(what, ["chord"]);
+        this.#object.documents.check(definition);
+        this.#documents.set(definition.name, definition);
+        return INERT;
+    }
+    table(definition) {
+        this.#assertDeclaring("table");
+        const store = this.#assertPersistable(`table "${definition.name}"`);
+        if (this.#tables.has(definition.name)) {
+            throw new Error(`${this.#object.label}: table "${definition.name}" is declared twice`);
+        }
+        const object = this.#object;
+        store.claims.assertTable(tableSqlName(object.served.contract.name, definition.name), object);
+        this.#tables.set(definition.name, definition);
+        return INERT;
+    }
+    derive() {
+        this.#assertDeclaring("derive");
+        return INERT;
+    }
+    get(Type, params) {
+        this.#assertDeclaring("get");
+        const checked = checkParams(Type, params, this.#context);
+        this.#requests.push({ kind: "type", contract: Type, params: checked.params });
+        return INERT;
+    }
+    registry(R) {
+        this.#assertDeclaring("registry");
+        this.#requests.push({ kind: "registry", registry: R });
+        // The host's own value (an attempt declares the same one): `retryOn` checks its kind.
+        return this.#object.host.registryRecord(R.name).value(R.version);
+    }
+    writable() {
+        this.#assertDeclaring("writable");
+        return INERT;
+    }
+    retryOn(...sources) {
+        this.#assertDeclaring("retryOn");
+        for (const source of sources)
+            retrySource(source, this.#object.label);
+    }
+    contribute(R) {
+        this.#assertDeclaring("contribute");
+        const served = this.#served;
+        const { label } = this.#object;
+        // R21: plugin code is bundled without type checks.
+        if (served.kind !== "local" || !served.hostLifetime) {
+            throw new Error(`${label}: self.contribute is valid only in a local type with empty params`);
+        }
+        if (this.#contributions.has(R.name))
+            throw new Error(`${label}: registry ${R.name} is contributed to twice`);
+        this.#contributions.set(R.name, R);
+    }
+    open() {
+        this.#assertDeclaring("open");
+        this.#natives++;
+        return INERT;
+    }
+    tx() {
+        throw new Error(`${this.#object.label}: self.tx runs in calls, not in a factory`);
+    }
+    follow() {
+        this.#assertDeclaring("follow");
+        return INERT;
+    }
+    on() {
+        this.#assertDeclaring("on");
+    }
+    onLive() {
+        this.#assertDeclaring("onLive");
+    }
+    job(definition) {
+        this.#assertDeclaring("job");
+        const object = this.#object;
+        if (this.#jobs.has(definition.name))
+            throw new Error(`${object.label}: job "${definition.name}" is declared twice`);
+        if (definition.persist !== undefined) {
+            this.#assertClaimable(`job "${definition.name}"`, ["chord.jobs", "chord.job-states"]);
+        }
+        object.checkJob(definition);
+        this.#jobs.set(definition.name, definition);
+        return INERT;
+    }
+    /** Persisted data needs a stable identity (P3) and the host's store, as an attempt checks; returns the store. */
+    #assertPersistable(what) {
+        const served = this.#served;
+        const { host, label } = this.#object;
+        if (served.kind !== "local" || contractData(served.contract).params.fields.length > 0) {
+            throw new Error(`${label}: ${what}: persist needs a stable identity (a local type with empty params)`);
+        }
+        if (host.store === undefined)
+            throw new Error(`${label}: ${what}: persist needs a store`);
+        return host.store;
+    }
+    /** Persisted documents in `namespaces`: as `#assertPersistable`, and not claimed by another owner. */
+    #assertClaimable(what, namespaces) {
+        const store = this.#assertPersistable(what);
+        const object = this.#object;
+        for (const namespace of namespaces)
+            store.claims.assertDocuments(object.served.contract.name, namespace, object);
+    }
+    #assertDeclaring(declaration) {
+        if (!this.declaring)
+            throw new Error(`${this.#object.label}: self.${declaration} is valid only in the factory`);
+    }
+}
+/**
+ * Whether `recorded`'s tables are at a version newer than `object`'s store has them: their eager migration runs at an
+ * activation, so the object restarts instead of swapping (§4).
+ */
+export function migratesTables(object, recorded) {
+    const { store } = object.host;
+    if (store === undefined)
+        return false;
+    const owner = object.served.contract.name;
+    return recorded.tables.some((table) => {
+        const stored = store.table(tableSqlName(owner, table.name));
+        return stored !== undefined && stored.version < table.version;
+    });
+}
+//# sourceMappingURL=staging.js.map

package/dist/next/host/staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.js","sourceRoot":"","sources":["../../../src/next/host/staging.ts"],"names":[],"mappings":"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","sourcesContent":["// Staging (slice 7b §2; per plugin, decision \"Per plugin at startup and reload\"): each plugin's setup runs into a table of\n// its own (the types it serves with their providers, the registries it serves, its facet contributions) with `load`'s\n// checks, merged into the staged table beside the live one, where a type or registry another plugin serves already\n// fails the plugin; and an object's new factory run against a recording `self`, which keeps what the factory declares\n// (natives, documents, tables, jobs, contributions, requests with their contract versions) and activates, binds and\n// opens nothing, so a reload decides each object's fate, and which plugins keep their old code, before its commit.\n// `load` stages its facets the same way and publishes them.\n\nimport type { Context } from \"../../context/index.ts\";\nimport type { Watchable } from \"../../watch.ts\";\nimport type { Contract, ParamsOf } from \"../contracts/index.ts\";\nimport { contractData } from \"../contracts/internal.ts\";\nimport type { Principal } from \"../data/index.ts\";\nimport { bindProvider, checkParams } from \"../data/internal.ts\";\nimport type { AnyDefinition } from \"../documents/internal.ts\";\nimport type { JobDefinition } from \"../jobs/index.ts\";\nimport type { Registry, RegistryProvider } from \"../registries/index.ts\";\nimport { checkProvider, type RegistryValueSource } from \"../registries/internal.ts\";\nimport { tableSqlName } from \"../store/sql.ts\";\nimport type { ChordStore } from \"../store/store.ts\";\nimport type { TableDefinition } from \"../store/table.ts\";\nimport type { StoreSelf } from \"./attempt.ts\";\nimport { type Facet, type FacetContribution, type ServedEntry, setUp } from \"./facet.ts\";\nimport type { ChordObject, LocalContract, RemoteContract, Served } from \"./object.ts\";\nimport type { Presence } from \"./presence.ts\";\nimport { retrySource } from \"./retry-on.ts\";\n\n/** A plugin's facet as `load` and `reload` take it: its name (its `package.json` name) and its facet. */\nexport type PluginFacet<P extends Principal = Principal> = { readonly name: string; readonly facet: Facet<P> };\n\n/** A registry a staged plugin serves: the defining plugin, the token and its provider. */\nexport type StagedRegistry = {\n\treadonly plugin: string;\n\treadonly registry: Registry<unknown, unknown>;\n\treadonly provider: RegistryProvider<unknown, unknown>;\n};\n\n/** One plugin's setup, run and checked: what it serves and contributes, nothing published yet. */\nexport type StagedPlugin = {\n\treadonly name: string;\n\t/** The served types by name, each with its plugin, factory, provider (its `accepts` checked) and `linger`. */\n\treadonly types: ReadonlyMap<string, Served>;\n\t/** The served registries by name. */\n\treadonly registries: ReadonlyMap<string, StagedRegistry>;\n\t/** The facet contributions, in the setup's order. */\n\treadonly contributions: readonly FacetContribution[];\n};\n\n/** A plugin set's staged plugins, merged: what they serve, by name, and each plugin's own table. */\nexport type Staged = {\n\treadonly types: Map<string, Served>;\n\treadonly registries: Map<string, StagedRegistry>;\n\treadonly plugins: Map<string, StagedPlugin>;\n};\n\n/** What staging needs of its host: whom it acts as, where it lives, and its presence lists for setups. */\nexport type StagingHost = {\n\treadonly principal: Principal | undefined;\n\treadonly address: unknown;\n\treferences<C extends Contract>(Type: C): Watchable<readonly Presence<C, Principal>[]>;\n};\n\n/** An npm package name, scoped or not. */\nconst PLUGIN_NAME = /^(?:@[a-z0-9~-][a-z0-9._~-]*\\/)?[a-z0-9~-][a-z0-9._~-]*$/;\n\n/** Whether `name` is a valid plugin name: an npm package name, scoped or not (the plugins component checks it too). */\nexport function isPluginName(name: string): boolean {\n\treturn PLUGIN_NAME.test(name);\n}\n\n/** A staged table with nothing in it. */\nexport function emptyStaged(): Staged {\n\treturn { types: new Map(), registries: new Map(), plugins: new Map() };\n}\n\n/**\n * Runs one plugin's setup and checks what it declared: its name (an npm name), a type or registry it serves twice, a\n * remote type on a host without a principal or address, every provider's `accepts` (`checkAccepts`) and every registry\n * provider's shape. Throws the first error, naming the plugin.\n */\nexport function stagePlugin<P extends Principal>({ name, facet }: PluginFacet<P>, host: StagingHost): StagedPlugin {\n\tif (!isPluginName(name)) throw new Error(`\"${name}\" is not a valid plugin name`);\n\t// The host's presence lists are typed for its `P`.\n\tconst references = host.references as <C extends Contract>(Type: C) => Watchable<readonly Presence<C, P>[]>;\n\tconst types = new Map<string, Served>();\n\tconst registries = new Map<string, StagedRegistry>();\n\ttry {\n\t\tconst { served, contributions } = setUp(name, facet, references);\n\t\tfor (const entry of served) stageEntry(name, entry, types, registries, host);\n\t\treturn { name, types, registries, contributions };\n\t} catch (error) {\n\t\tthrow named(error, `plugin \"${name}\"`);\n\t}\n}\n\n/**\n * Merges `plugin` into `staged`; a type or registry another plugin serves there already refuses it (its error\n * returned, nothing merged).\n */\nexport function addStaged(staged: Staged, plugin: StagedPlugin): Error | undefined {\n\tfor (const name of plugin.types.keys()) {\n\t\tconst other = staged.types.get(name);\n\t\tif (other !== undefined)\n\t\t\treturn new Error(`plugin \"${plugin.name}\": ${name} is served twice (plugin \"${other.plugin}\")`);\n\t}\n\tfor (const name of plugin.registries.keys()) {\n\t\tconst other = staged.registries.get(name);\n\t\tif (other !== undefined) {\n\t\t\treturn new Error(`plugin \"${plugin.name}\": registry ${name} is served twice (plugin \"${other.plugin}\")`);\n\t\t}\n\t}\n\tfor (const [name, served] of plugin.types) staged.types.set(name, served);\n\tfor (const [name, registry] of plugin.registries) staged.registries.set(name, registry);\n\tstaged.plugins.set(plugin.name, plugin);\n\treturn undefined;\n}\n\n/** Stages one served entry of `plugin` into its tables: a registry's provider, or a type as `Served`. */\nfunction stageEntry(\n\tplugin: string,\n\tentry: ServedEntry,\n\ttypes: Map<string, Served>,\n\tregistries: Map<string, StagedRegistry>,\n\thost: StagingHost,\n): void {\n\tif (entry.kind === \"registry\") {\n\t\tconst { registry, provider } = entry;\n\t\tif (registries.has(registry.name)) throw new Error(`registry ${registry.name} is served twice`);\n\t\tcheckProvider(registry.name, provider);\n\t\tregistries.set(registry.name, { plugin, registry, provider });\n\t\treturn;\n\t}\n\tconst { contract, factory, options } = entry;\n\tif (types.has(contract.name)) throw new Error(`${contract.name} is served twice`);\n\t// A client serves only local types (§3): a remote object is owned by a principal of the host serving it.\n\tif (contract.kind === \"remote\" && host.principal === undefined) {\n\t\tthrow new Error(`${contract.name}: a host without a principal serves only local types`);\n\t}\n\t// A remote object lives on the host its `hostAddress` names: only a host with an address can be that host.\n\tif (contract.kind === \"remote\" && host.address === undefined) {\n\t\tthrow new Error(`${contract.name}: a host without an address serves only local types`);\n\t}\n\tconst provider = bindProvider(contract, options.accepts ?? {});\n\tconst common = { plugin, provider, linger: options.linger ?? 0 };\n\t// The contract's kind decides the factory's signature and the contract's shape.\n\tconst served: Served =\n\t\tcontract.kind === \"local\"\n\t\t\t? {\n\t\t\t\t\t...common,\n\t\t\t\t\tkind: \"local\",\n\t\t\t\t\tcontract: contract as LocalContract,\n\t\t\t\t\tfactory: factory as Extract<Served, { kind: \"local\" }>[\"factory\"],\n\t\t\t\t\thostLifetime: contractData(contract).params.fields.length === 0,\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\t...common,\n\t\t\t\t\tkind: \"remote\",\n\t\t\t\t\tcontract: contract as RemoteContract,\n\t\t\t\t\tfactory: factory as Extract<Served, { kind: \"remote\" }>[\"factory\"],\n\t\t\t\t};\n\ttypes.set(contract.name, served);\n}\n\n/** What a recorded factory declared: what a reload's fate and checks need, nothing activated. */\nexport type Recorded = {\n\t/** How many natives it opens (`self.open`). */\n\treadonly natives: number;\n\treadonly documents: readonly AnyDefinition[];\n\treadonly tables: readonly TableDefinition[];\n\treadonly jobs: readonly JobDefinition<unknown, unknown, unknown>[];\n\treadonly contributions: readonly Registry<unknown, unknown>[];\n\t/** Its requests: the types it gets (`self.get`, with their checked params) and the registries it reads (`self.registry`). */\n\treadonly requests: readonly Request[];\n};\n\n/** A recorded request, with the contract version it was made at: a type and its params, or a registry. */\nexport type Request =\n\t| { readonly kind: \"type\"; readonly contract: Contract; readonly params: ParamsOf<Contract> }\n\t| { readonly kind: \"registry\"; readonly registry: Registry<unknown, unknown> };\n\n/**\n * Runs `served`'s factory for `object` (its params and principal) against a recording `self` and returns what it\n * declared. Every declaration check an attempt makes runs, without effects (declared twice; persisted data in a type\n * without a stable identity, on a host without a store, or claimed by another owner; contributions outside\n * host-lifetime objects, or twice; `retryOn` sources that do not outlive the attempt; params; a document or job\n * declared at an older version than the object's, or at its version with another schema); a throw is the factory's.\n * Handles it hands out are inert, except registry values (the host's own, which `retryOn` checks by kind).\n */\nexport function recordFactory(object: ChordObject, served: Served, context: Context): Recorded {\n\tconst recording = new RecordingSelf(object, served, context);\n\t// A recording `self` takes every declaration a factory makes, its handles inert.\n\tconst self = recording as unknown as StoreSelf;\n\ttry {\n\t\tif (served.kind === \"local\") served.factory(object.params, self);\n\t\t// A remote object's identity has its principal.\n\t\telse served.factory(object.params, object.principal!, self);\n\t} catch (error) {\n\t\tthrow named(error, `plugin \"${served.plugin}\", ${object.label}`);\n\t} finally {\n\t\trecording.declaring = false;\n\t}\n\treturn recording.recorded;\n}\n\n/** A staging error naming where it happened (`what`): its message prefixed, the error itself its cause. */\nfunction named(error: unknown, what: string): Error {\n\tconst message = error instanceof Error ? error.message : String(error);\n\treturn new Error(`${what}: ${message}`, { cause: error });\n}\n\n/**\n * The value of every handle a recording `self` hands out: any property or call gives it again, and it is never a\n * thenable. Typed `never` (a cast: it stands for every handle type, and nothing reads it as one).\n */\nconst INERT: never = new Proxy(() => {}, {\n\tget: (_target, property) => (property === \"then\" ? undefined : INERT),\n\tapply: () => INERT,\n}) as never;\n\n/** A factory's `self` during staging: it records declarations and checks them; it activates nothing. */\nclass RecordingSelf {\n\tdeclaring = true;\n\treadonly #object: ChordObject;\n\treadonly #served: Served;\n\treadonly #context: Context;\n\t#natives = 0;\n\treadonly #documents = new Map<string, AnyDefinition>();\n\treadonly #tables = new Map<string, TableDefinition>();\n\treadonly #jobs = new Map<string, JobDefinition<unknown, unknown, unknown>>();\n\treadonly #contributions = new Map<string, Registry<unknown, unknown>>();\n\treadonly #requests: Request[] = [];\n\n\tconstructor(object: ChordObject, served: Served, context: Context) {\n\t\tthis.#object = object;\n\t\tthis.#served = served;\n\t\tthis.#context = context;\n\t}\n\n\tget recorded(): Recorded {\n\t\treturn {\n\t\t\tnatives: this.#natives,\n\t\t\tdocuments: [...this.#documents.values()],\n\t\t\ttables: [...this.#tables.values()],\n\t\t\tjobs: [...this.#jobs.values()],\n\t\t\tcontributions: [...this.#contributions.values()],\n\t\t\trequests: this.#requests,\n\t\t};\n\t}\n\n\tstate(definition: AnyDefinition): never {\n\t\tthis.#assertDeclaring(\"state\");\n\t\tconst what = `state \"${definition.name}\"`;\n\t\tif (this.#documents.has(definition.name)) throw new Error(`${this.#object.label}: ${what} is declared twice`);\n\t\tif (definition.persist) this.#assertClaimable(what, [\"chord\"]);\n\t\tthis.#object.documents.check(definition);\n\t\tthis.#documents.set(definition.name, definition);\n\t\treturn INERT;\n\t}\n\n\ttable(definition: TableDefinition): never {\n\t\tthis.#assertDeclaring(\"table\");\n\t\tconst store = this.#assertPersistable(`table \"${definition.name}\"`);\n\t\tif (this.#tables.has(definition.name)) {\n\t\t\tthrow new Error(`${this.#object.label}: table \"${definition.name}\" is declared twice`);\n\t\t}\n\t\tconst object = this.#object;\n\t\tstore.claims.assertTable(tableSqlName(object.served.contract.name, definition.name), object);\n\t\tthis.#tables.set(definition.name, definition);\n\t\treturn INERT;\n\t}\n\n\tderive(): never {\n\t\tthis.#assertDeclaring(\"derive\");\n\t\treturn INERT;\n\t}\n\n\tget(Type: Contract, params: unknown): never {\n\t\tthis.#assertDeclaring(\"get\");\n\t\tconst checked = checkParams(Type, params, this.#context);\n\t\tthis.#requests.push({ kind: \"type\", contract: Type, params: checked.params });\n\t\treturn INERT;\n\t}\n\n\tregistry(R: Registry<unknown, unknown>): RegistryValueSource {\n\t\tthis.#assertDeclaring(\"registry\");\n\t\tthis.#requests.push({ kind: \"registry\", registry: R });\n\t\t// The host's own value (an attempt declares the same one): `retryOn` checks its kind.\n\t\treturn this.#object.host.registryRecord(R.name).value(R.version);\n\t}\n\n\twritable(): never {\n\t\tthis.#assertDeclaring(\"writable\");\n\t\treturn INERT;\n\t}\n\n\tretryOn(...sources: readonly unknown[]): void {\n\t\tthis.#assertDeclaring(\"retryOn\");\n\t\tfor (const source of sources) retrySource(source, this.#object.label);\n\t}\n\n\tcontribute(R: Registry<unknown, unknown>): void {\n\t\tthis.#assertDeclaring(\"contribute\");\n\t\tconst served = this.#served;\n\t\tconst { label } = this.#object;\n\t\t// R21: plugin code is bundled without type checks.\n\t\tif (served.kind !== \"local\" || !served.hostLifetime) {\n\t\t\tthrow new Error(`${label}: self.contribute is valid only in a local type with empty params`);\n\t\t}\n\t\tif (this.#contributions.has(R.name)) throw new Error(`${label}: registry ${R.name} is contributed to twice`);\n\t\tthis.#contributions.set(R.name, R);\n\t}\n\n\topen(): never {\n\t\tthis.#assertDeclaring(\"open\");\n\t\tthis.#natives++;\n\t\treturn INERT;\n\t}\n\n\ttx(): never {\n\t\tthrow new Error(`${this.#object.label}: self.tx runs in calls, not in a factory`);\n\t}\n\n\tfollow(): never {\n\t\tthis.#assertDeclaring(\"follow\");\n\t\treturn INERT;\n\t}\n\n\ton(): void {\n\t\tthis.#assertDeclaring(\"on\");\n\t}\n\n\tonLive(): void {\n\t\tthis.#assertDeclaring(\"onLive\");\n\t}\n\n\tjob(definition: JobDefinition<unknown, unknown, unknown>): never {\n\t\tthis.#assertDeclaring(\"job\");\n\t\tconst object = this.#object;\n\t\tif (this.#jobs.has(definition.name))\n\t\t\tthrow new Error(`${object.label}: job \"${definition.name}\" is declared twice`);\n\t\tif (definition.persist !== undefined) {\n\t\t\tthis.#assertClaimable(`job \"${definition.name}\"`, [\"chord.jobs\", \"chord.job-states\"]);\n\t\t}\n\t\tobject.checkJob(definition);\n\t\tthis.#jobs.set(definition.name, definition);\n\t\treturn INERT;\n\t}\n\n\t/** Persisted data needs a stable identity (P3) and the host's store, as an attempt checks; returns the store. */\n\t#assertPersistable(what: string): ChordStore {\n\t\tconst served = this.#served;\n\t\tconst { host, label } = this.#object;\n\t\tif (served.kind !== \"local\" || contractData(served.contract).params.fields.length > 0) {\n\t\t\tthrow new Error(`${label}: ${what}: persist needs a stable identity (a local type with empty params)`);\n\t\t}\n\t\tif (host.store === undefined) throw new Error(`${label}: ${what}: persist needs a store`);\n\t\treturn host.store;\n\t}\n\n\t/** Persisted documents in `namespaces`: as `#assertPersistable`, and not claimed by another owner. */\n\t#assertClaimable(what: string, namespaces: readonly string[]): void {\n\t\tconst store = this.#assertPersistable(what);\n\t\tconst object = this.#object;\n\t\tfor (const namespace of namespaces) store.claims.assertDocuments(object.served.contract.name, namespace, object);\n\t}\n\n\t#assertDeclaring(declaration: string): void {\n\t\tif (!this.declaring) throw new Error(`${this.#object.label}: self.${declaration} is valid only in the factory`);\n\t}\n}\n\n/**\n * Whether `recorded`'s tables are at a version newer than `object`'s store has them: their eager migration runs at an\n * activation, so the object restarts instead of swapping (§4).\n */\nexport function migratesTables(object: ChordObject, recorded: Recorded): boolean {\n\tconst { store } = object.host;\n\tif (store === undefined) return false;\n\tconst owner = object.served.contract.name;\n\treturn recorded.tables.some((table) => {\n\t\tconst stored = store.table(tableSqlName(owner, table.name));\n\t\treturn stored !== undefined && stored.version < table.version;\n\t});\n}\n"]}