@earendil-works/chord 1.4.0 → 1.5.0

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

@@ -0,0 +1,30 @@
+import type { ChordError, Principal } from "../data/index.ts";
+/** A request in the index: a reference made here or a hold that arrived over a link. */
+export interface UnboundRequest {
+    /** Whom it acts for: revocation ends the requests of a revoked principal. */
+    readonly principal: Principal | undefined;
+    /** The name it waits for became usable (or the host published): it runs its check again, leaving the index first. */
+    wake(): void;
+    /** It is revoked, or its host closes: it ends with `error` (a hold sends `gone`), leaving the index. */
+    end(error: ChordError): void;
+}
+/** A host's unbound requests by name. */
+export declare class UnboundIndex {
+    #private;
+    /** Indexes `request` under `name` (once; again after a wake). */
+    add(name: string, request: UnboundRequest): void;
+    /** `request` ended or binds: it leaves the index. */
+    delete(name: string, request: UnboundRequest): void;
+    /** The host's publication: every request indexed (by any name) runs its check again, out of the index first. */
+    wakeAll(): void;
+    /**
+     * A reload's publication: the requests indexed under `names` (the types and registries it serves) run their check
+     * again, out of the index first; the others stay (carry-over "Publications wake per name").
+     */
+    wake(names: Iterable<string>): void;
+    /** Every indexed request acting for a principal `revoked` names ends with `error`. */
+    revoke(revoked: (principal: Principal) => boolean, error: ChordError): void;
+    /** The host closed: every indexed request ends with `error`. */
+    close(error: ChordError): void;
+}
+//# sourceMappingURL=unbound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unbound.d.ts","sourceRoot":"","sources":["../../../src/next/host/unbound.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE9D,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,qHAAqH;IACrH,IAAI,IAAI,IAAI,CAAC;IACb,wGAAwG;IACxG,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7B;AAED,yCAAyC;AACzC,qBAAa,YAAY;;IAGxB,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAO/C;IAED,qDAAqD;IACrD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAIlD;IAED,gHAAgH;IAChH,OAAO,IAAI,IAAI,CAId;IAED;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CASlC;IAED,sFAAsF;IACtF,MAAM,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAM1E;IAED,gEAAgE;IAChE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAI7B;CACD"}

package/dist/next/host/unbound.js

@@ -0,0 +1,67 @@
+// The unbound index (dependency model §1, §4): the requests a host decided cannot bind yet, by the name they wait for.
+// Before the host's first publication every request made here, and every hold arriving on its links, waits here
+// (`unpublished`); after it, those its check left unbound (`not_served`, `version`): a reference made here, a hold that
+// arrived over a link and was refused for a name. A publication wakes the requests of the names it serves (`load`'s
+// every one, a reload's those of its names); a request
+// leaves when it ends (released, settled, given up, its link or origin closed, revoked) or binds.
+/** A host's unbound requests by name. */
+export class UnboundIndex {
+    #byName = new Map();
+    /** Indexes `request` under `name` (once; again after a wake). */
+    add(name, request) {
+        let requests = this.#byName.get(name);
+        if (requests === undefined) {
+            requests = new Set();
+            this.#byName.set(name, requests);
+        }
+        requests.add(request);
+    }
+    /** `request` ended or binds: it leaves the index. */
+    delete(name, request) {
+        const requests = this.#byName.get(name);
+        if (requests === undefined || !requests.delete(request))
+            return;
+        if (requests.size === 0)
+            this.#byName.delete(name);
+    }
+    /** The host's publication: every request indexed (by any name) runs its check again, out of the index first. */
+    wakeAll() {
+        const all = [...this.#byName.values()].flatMap((requests) => [...requests]);
+        this.#byName.clear();
+        for (const request of all)
+            request.wake();
+    }
+    /**
+     * A reload's publication: the requests indexed under `names` (the types and registries it serves) run their check
+     * again, out of the index first; the others stay (carry-over "Publications wake per name").
+     */
+    wake(names) {
+        const woken = [];
+        for (const name of names) {
+            const requests = this.#byName.get(name);
+            if (requests === undefined)
+                continue;
+            this.#byName.delete(name);
+            woken.push(...requests);
+        }
+        for (const request of woken)
+            request.wake();
+    }
+    /** Every indexed request acting for a principal `revoked` names ends with `error`. */
+    revoke(revoked, error) {
+        for (const requests of [...this.#byName.values()]) {
+            for (const request of [...requests]) {
+                if (request.principal !== undefined && revoked(request.principal))
+                    request.end(error);
+            }
+        }
+    }
+    /** The host closed: every indexed request ends with `error`. */
+    close(error) {
+        const all = [...this.#byName.values()].flatMap((requests) => [...requests]);
+        this.#byName.clear();
+        for (const request of all)
+            request.end(error);
+    }
+}
+//# sourceMappingURL=unbound.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unbound.js","sourceRoot":"","sources":["../../../src/next/host/unbound.ts"],"names":[],"mappings":"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","sourcesContent":["// The unbound index (dependency model §1, §4): the requests a host decided cannot bind yet, by the name they wait for.\n// Before the host's first publication every request made here, and every hold arriving on its links, waits here\n// (`unpublished`); after it, those its check left unbound (`not_served`, `version`): a reference made here, a hold that\n// arrived over a link and was refused for a name. A publication wakes the requests of the names it serves (`load`'s\n// every one, a reload's those of its names); a request\n// leaves when it ends (released, settled, given up, its link or origin closed, revoked) or binds.\n\nimport type { ChordError, Principal } from \"../data/index.ts\";\n\n/** A request in the index: a reference made here or a hold that arrived over a link. */\nexport interface UnboundRequest {\n\t/** Whom it acts for: revocation ends the requests of a revoked principal. */\n\treadonly principal: Principal | undefined;\n\t/** The name it waits for became usable (or the host published): it runs its check again, leaving the index first. */\n\twake(): void;\n\t/** It is revoked, or its host closes: it ends with `error` (a hold sends `gone`), leaving the index. */\n\tend(error: ChordError): void;\n}\n\n/** A host's unbound requests by name. */\nexport class UnboundIndex {\n\treadonly #byName = new Map<string, Set<UnboundRequest>>();\n\n\t/** Indexes `request` under `name` (once; again after a wake). */\n\tadd(name: string, request: UnboundRequest): void {\n\t\tlet requests = this.#byName.get(name);\n\t\tif (requests === undefined) {\n\t\t\trequests = new Set();\n\t\t\tthis.#byName.set(name, requests);\n\t\t}\n\t\trequests.add(request);\n\t}\n\n\t/** `request` ended or binds: it leaves the index. */\n\tdelete(name: string, request: UnboundRequest): void {\n\t\tconst requests = this.#byName.get(name);\n\t\tif (requests === undefined || !requests.delete(request)) return;\n\t\tif (requests.size === 0) this.#byName.delete(name);\n\t}\n\n\t/** The host's publication: every request indexed (by any name) runs its check again, out of the index first. */\n\twakeAll(): void {\n\t\tconst all = [...this.#byName.values()].flatMap((requests) => [...requests]);\n\t\tthis.#byName.clear();\n\t\tfor (const request of all) request.wake();\n\t}\n\n\t/**\n\t * A reload's publication: the requests indexed under `names` (the types and registries it serves) run their check\n\t * again, out of the index first; the others stay (carry-over \"Publications wake per name\").\n\t */\n\twake(names: Iterable<string>): void {\n\t\tconst woken: UnboundRequest[] = [];\n\t\tfor (const name of names) {\n\t\t\tconst requests = this.#byName.get(name);\n\t\t\tif (requests === undefined) continue;\n\t\t\tthis.#byName.delete(name);\n\t\t\twoken.push(...requests);\n\t\t}\n\t\tfor (const request of woken) request.wake();\n\t}\n\n\t/** Every indexed request acting for a principal `revoked` names ends with `error`. */\n\trevoke(revoked: (principal: Principal) => boolean, error: ChordError): void {\n\t\tfor (const requests of [...this.#byName.values()]) {\n\t\t\tfor (const request of [...requests]) {\n\t\t\t\tif (request.principal !== undefined && revoked(request.principal)) request.end(error);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** The host closed: every indexed request ends with `error`. */\n\tclose(error: ChordError): void {\n\t\tconst all = [...this.#byName.values()].flatMap((requests) => [...requests]);\n\t\tthis.#byName.clear();\n\t\tfor (const request of all) request.end(error);\n\t}\n}\n"]}

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

@@ -0,0 +1,3 @@
+/** A time-ordered UUIDv7. */
+export declare function uuidv7(): string;
+//# sourceMappingURL=uuid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../src/next/host/uuid.ts"],"names":[],"mappings":"AAUA,6BAA6B;AAC7B,wBAAgB,MAAM,IAAI,MAAM,CA0B/B"}

package/dist/next/host/uuid.js

@@ -0,0 +1,38 @@
+// UUIDv7 (§3, code copied from pi-ai's `uuidv7`): time-ordered ids, minted for host incarnations.
+const MAX_SEQUENCE = (1n << 41n) - 1n;
+/** The last timestamp used: a clock going backwards keeps the ids ordered. */
+let lastTimestamp = -1;
+/** A random start, then incremented per id, so ids within one millisecond stay ordered and unique. */
+let sequence;
+/** A time-ordered UUIDv7. */
+export function uuidv7() {
+    const timestamp = Math.max(Date.now(), lastTimestamp);
+    lastTimestamp = timestamp;
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    if (sequence === undefined) {
+        sequence =
+            (BigInt(bytes[1]) << 32n) |
+                (BigInt(bytes[2]) << 24n) |
+                (BigInt(bytes[3]) << 16n) |
+                (BigInt(bytes[4]) << 8n) |
+                BigInt(bytes[5]);
+    }
+    else {
+        if (sequence === MAX_SEQUENCE)
+            throw new RangeError("UUIDv7 generator sequence exhausted");
+        sequence++;
+    }
+    const time = BigInt(timestamp);
+    for (let index = 5; index >= 0; index--)
+        bytes[index] = Number(time >> BigInt((5 - index) * 8)) & 0xff;
+    bytes[6] = 0x70 | Number((sequence >> 37n) & 0x0fn);
+    bytes[7] = Number((sequence >> 29n) & 0xffn);
+    bytes[8] = 0x80 | Number((sequence >> 23n) & 0x3fn);
+    bytes[9] = Number((sequence >> 15n) & 0xffn);
+    bytes[10] = Number((sequence >> 7n) & 0xffn);
+    bytes[11] = Number((sequence & 0x7fn) << 1n) | (bytes[11] & 0x01);
+    const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0"));
+    return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
+}
+//# sourceMappingURL=uuid.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/next/host/uuid.ts"],"names":[],"mappings":"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","sourcesContent":["// UUIDv7 (§3, code copied from pi-ai's `uuidv7`): time-ordered ids, minted for host incarnations.\n\nconst MAX_SEQUENCE = (1n << 41n) - 1n;\n\n/** The last timestamp used: a clock going backwards keeps the ids ordered. */\nlet lastTimestamp = -1;\n\n/** A random start, then incremented per id, so ids within one millisecond stay ordered and unique. */\nlet sequence: bigint | undefined;\n\n/** A time-ordered UUIDv7. */\nexport function uuidv7(): string {\n\tconst timestamp = Math.max(Date.now(), lastTimestamp);\n\tlastTimestamp = timestamp;\n\tconst bytes = new Uint8Array(16);\n\tglobalThis.crypto.getRandomValues(bytes);\n\tif (sequence === undefined) {\n\t\tsequence =\n\t\t\t(BigInt(bytes[1]!) << 32n) |\n\t\t\t(BigInt(bytes[2]!) << 24n) |\n\t\t\t(BigInt(bytes[3]!) << 16n) |\n\t\t\t(BigInt(bytes[4]!) << 8n) |\n\t\t\tBigInt(bytes[5]!);\n\t} else {\n\t\tif (sequence === MAX_SEQUENCE) throw new RangeError(\"UUIDv7 generator sequence exhausted\");\n\t\tsequence++;\n\t}\n\tconst time = BigInt(timestamp);\n\tfor (let index = 5; index >= 0; index--) bytes[index] = Number(time >> BigInt((5 - index) * 8)) & 0xff;\n\tbytes[6] = 0x70 | Number((sequence >> 37n) & 0x0fn);\n\tbytes[7] = Number((sequence >> 29n) & 0xffn);\n\tbytes[8] = 0x80 | Number((sequence >> 23n) & 0x3fn);\n\tbytes[9] = Number((sequence >> 15n) & 0xffn);\n\tbytes[10] = Number((sequence >> 7n) & 0xffn);\n\tbytes[11] = Number((sequence & 0x7fn) << 1n) | (bytes[11]! & 0x01);\n\tconst hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\"));\n\treturn `${hex.slice(0, 4).join(\"\")}-${hex.slice(4, 6).join(\"\")}-${hex.slice(6, 8).join(\"\")}-${hex.slice(8, 10).join(\"\")}-${hex.slice(10).join(\"\")}`;\n}\n"]}

package/dist/next/index.d.ts

@@ -0,0 +1,28 @@
+export * from "./contracts/index.ts";
+export * from "./data/index.ts";
+export * from "./documents/index.ts";
+export * from "./host/index.ts";
+export * from "./jobs/index.ts";
+export * from "./link/index.ts";
+export * from "./registries/index.ts";
+export * from "./state/index.ts";
+/** @internal The store's surface for adapters (slice 6b §2.1). */
+export { type DecodedRow, OwnerTable, StoreOwnerTables } from "./store/adapter.ts";
+/** @internal The sync layer's batch apply (slice 6b §1.6). */
+export { applyBatch } from "./store/apply-batch.ts";
+/** @internal */
+export type { Claimant } from "./store/claims.ts";
+/** @internal */
+export { type DocumentAddress, type DocumentContent, type DocumentEntry, type DocumentHistory, type DocumentPoint, type DocumentRecord, type DocumentScope, findDocument, findDocumentEntry, insertDocument, listDocumentEntries, listDocuments, loadContent, loadDocument, type OwnedDocumentEntry, readDocument, readDocumentEntry, retireRecord, type StoredDocument, writeContent, } from "./store/engine.ts";
+/** @internal */
+export type { WhereNode } from "./store/expression.ts";
+export * from "./store/index.ts";
+/** @internal */
+export type { EncodedRow } from "./store/rows.ts";
+/** @internal */
+export type { Order } from "./store/sql.ts";
+/** @internal */
+export type { StagedWrite, Step } from "./store/step.ts";
+/** @internal */
+export type { ChordStore, SeriesCommit, SeriesResult } from "./store/store.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAGA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,kEAAkE;AAClE,OAAO,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACnF,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,gBAAgB;AAChB,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,gBAAgB;AAChB,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,KAAK,kBAAkB,EACvB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,KAAK,cAAc,EACnB,YAAY,GACZ,MAAM,mBAAmB,CAAC;AAC3B,gBAAgB;AAChB,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,cAAc,kBAAkB,CAAC;AACjC,gBAAgB;AAChB,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,gBAAgB;AAChB,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,gBAAgB;AAChB,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACzD,gBAAgB;AAChB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/next/index.js

@@ -0,0 +1,18 @@
+// Chord v2 (`@earendil-works/chord/next`, experimental): every layer's API for apps, and the store's surface for
+// adapters (Durable's `StoreStorage`), marked internal.
+export * from "./contracts/index.js";
+export * from "./data/index.js";
+export * from "./documents/index.js";
+export * from "./host/index.js";
+export * from "./jobs/index.js";
+export * from "./link/index.js";
+export * from "./registries/index.js";
+export * from "./state/index.js";
+/** @internal The store's surface for adapters (slice 6b §2.1). */
+export { OwnerTable, StoreOwnerTables } from "./store/adapter.js";
+/** @internal The sync layer's batch apply (slice 6b §1.6). */
+export { applyBatch } from "./store/apply-batch.js";
+/** @internal */
+export { findDocument, findDocumentEntry, insertDocument, listDocumentEntries, listDocuments, loadContent, loadDocument, readDocument, readDocumentEntry, retireRecord, writeContent, } from "./store/engine.js";
+export * from "./store/index.js";
+//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,wDAAwD;AAExD,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,kEAAkE;AAClE,OAAO,EAAmB,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACnF,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,gBAAgB;AAChB,OAAO,EAQN,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,YAAY,EAEZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EAEZ,YAAY,GACZ,MAAM,mBAAmB,CAAC;AAG3B,cAAc,kBAAkB,CAAC","sourcesContent":["// Chord v2 (`@earendil-works/chord/next`, experimental): every layer's API for apps, and the store's surface for\n// adapters (Durable's `StoreStorage`), marked internal.\n\nexport * from \"./contracts/index.ts\";\nexport * from \"./data/index.ts\";\nexport * from \"./documents/index.ts\";\nexport * from \"./host/index.ts\";\nexport * from \"./jobs/index.ts\";\nexport * from \"./link/index.ts\";\nexport * from \"./registries/index.ts\";\nexport * from \"./state/index.ts\";\n/** @internal The store's surface for adapters (slice 6b §2.1). */\nexport { type DecodedRow, OwnerTable, StoreOwnerTables } from \"./store/adapter.ts\";\n/** @internal The sync layer's batch apply (slice 6b §1.6). */\nexport { applyBatch } from \"./store/apply-batch.ts\";\n/** @internal */\nexport type { Claimant } from \"./store/claims.ts\";\n/** @internal */\nexport {\n\ttype DocumentAddress,\n\ttype DocumentContent,\n\ttype DocumentEntry,\n\ttype DocumentHistory,\n\ttype DocumentPoint,\n\ttype DocumentRecord,\n\ttype DocumentScope,\n\tfindDocument,\n\tfindDocumentEntry,\n\tinsertDocument,\n\tlistDocumentEntries,\n\tlistDocuments,\n\tloadContent,\n\tloadDocument,\n\ttype OwnedDocumentEntry,\n\treadDocument,\n\treadDocumentEntry,\n\tretireRecord,\n\ttype StoredDocument,\n\twriteContent,\n} from \"./store/engine.ts\";\n/** @internal */\nexport type { WhereNode } from \"./store/expression.ts\";\nexport * from \"./store/index.ts\";\n/** @internal */\nexport type { EncodedRow } from \"./store/rows.ts\";\n/** @internal */\nexport type { Order } from \"./store/sql.ts\";\n/** @internal */\nexport type { StagedWrite, Step } from \"./store/step.ts\";\n/** @internal */\nexport type { ChordStore, SeriesCommit, SeriesResult } from \"./store/store.ts\";\n"]}

package/dist/next/jobs/definition.d.ts

@@ -0,0 +1,96 @@
+import type { Schema, Static } from "../contracts/index.ts";
+import { type Snapshot } from "../contracts/snapshot.ts";
+import type { ChordError, PluginError } from "../data/index.ts";
+import type { JsonObject, StateDefinition } from "../documents/index.ts";
+/** What `defineJob` takes besides the name. */
+export type JobOptions<A extends Schema, R extends Schema, D extends StateDefinition<JsonObject, false, boolean> | undefined> = {
+    /** The job's version; every change of its args, result or state bumps it. */
+    readonly version: number;
+    /** The run's arguments: closed objects, JSON only (`running` carries them), checked at every start. */
+    readonly args: A;
+    /** What `run` returns; not validated. */
+    readonly result: R;
+    /**
+     * A singleton document definition: one document per run, `ctx.state` in `run`, `outcome.state` in `finish`; a
+     * persisted job's is persisted (`persist: true`, its `checkpointWhen`).
+     */
+    readonly state?: D;
+    /** At most this many runs running or finishing per object; a start beyond it rejects `unavailable/busy`. */
+    readonly concurrency?: number;
+    /** Per older version, how its args and result map forwards (used from slice 7 on; checked now). */
+    readonly accepts?: JobAccepts<A, R>;
+    /**
+     * Persists the runs in the object's store (slice 6b; only in `local` types with empty params, P3): how a run cut
+     * off by a crash or a stop resumes, `rerun` (its `run` again: idempotent work) or `abandon` (`finish` gets `failed {
+     * aborted, reason: "restart" }`). Its result is JSON only (no `bytes()`).
+     */
+    readonly persist?: JobPersistence;
+};
+/** How a persisted job's runs resume after a crash or a stop. */
+export type JobPersistence = {
+    readonly resume: "rerun" | "abandon";
+};
+/** Per older version, its mappings forwards: its args to the current args, its result to the current result. */
+export type JobAccepts<A extends Schema = Schema, R extends Schema = Schema> = {
+    readonly [version: number]: {
+        readonly args: (old: never) => Static<A>;
+        readonly result: (old: never) => Static<R>;
+    };
+};
+/** The value of a job's state document: the definition's document, `undefined` without one. */
+type StateOf<D> = D extends StateDefinition<infer T, false, boolean> ? T : undefined;
+/** What a run ended with, as `finish` and `outcome` get it: its args and state, and its result or its error. */
+export type Outcome<A, R, S> = {
+    readonly id: string;
+    readonly args: A;
+    readonly state: S;
+} & ({
+    readonly kind: "done";
+    readonly result: R;
+} | {
+    readonly kind: "failed";
+    readonly error: JobError;
+});
+/**
+ * Why a run failed: `run` threw (reported as `job_failed`; anything but a ChordError or PluginError becomes a
+ * PluginError `internal` with its message), it was aborted (`abort`: `abort(id)`; `restart`: cut off by its attempt's
+ * seal while the object continues, or a persisted run abandoned after a crash; `reload` comes with slice 7), or a
+ * persisted run was cut off five times in a row (`restart_limit`, D6).
+ */
+export type JobError = {
+    readonly kind: "threw";
+    readonly error: ChordError | PluginError;
+} | {
+    readonly kind: "aborted";
+    readonly reason: "abort" | "reload" | "restart";
+} | {
+    readonly kind: "restart_limit";
+    readonly restarts: number;
+};
+/** Declares a job: owned work a call starts that outlives it (§15). */
+export declare function defineJob<const A extends Schema, const R extends Schema, D extends StateDefinition<JsonObject, false, boolean> | undefined = undefined>(name: string, options: JobOptions<A, R, D>): JobDefinition<Static<A>, Static<R>, StateOf<D>>;
+/** A declared job; `A`, `R` and `S` are its args, result and state document (`undefined` without one). */
+export declare class JobDefinition<A, R, S> {
+    readonly name: string;
+    readonly version: number;
+    /** The args schema, Chord's copy; its compiled check is cached by this snapshot. */
+    readonly args: Snapshot;
+    readonly result: Snapshot;
+    readonly state: StateDefinition<JsonObject, false, boolean> | undefined;
+    readonly concurrency: number | undefined;
+    /** The older versions' mappings, checked at declaration; slice 7 maps older runs with them. */
+    readonly accepts: JobAccepts;
+    /** How its runs persist; `undefined` for a job in memory. */
+    readonly persist: JobPersistence | undefined;
+    /** `hash64` of its args', result's and state's normal forms: a stored run of another fingerprint is blocked. */
+    readonly fingerprint: string;
+    /** Type only: the args, result and state types. */
+    readonly "~types"?: {
+        readonly args: A;
+        readonly result: R;
+        readonly state: S;
+    };
+    constructor(name: string, version: number, args: Snapshot, result: Snapshot, state: StateDefinition<JsonObject, false, boolean> | undefined, concurrency: number | undefined, accepts: JobAccepts, persist: JobPersistence | undefined, fingerprint: string);
+}
+export {};
+//# sourceMappingURL=definition.d.ts.map

package/dist/next/jobs/definition.d.ts.map

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

package/dist/next/jobs/definition.js

@@ -0,0 +1,83 @@
+// Job definitions (§15): `defineJob(name, …)`, the checks of a declaration, and the types of what a run ends with.
+import { checkKeys, entriesOf } from "../contracts/declare.js";
+import { checkName, hash64 } from "../contracts/internal.js";
+import { snapshotArguments, snapshotSchema } from "../contracts/snapshot.js";
+/** Declares a job: owned work a call starts that outlives it (§15). */
+export function defineJob(name, options) {
+    // Declaration policy: JavaScript callers reach every check below.
+    checkName(name, "A job name");
+    checkKeys(options, ["version", "args", "result", "state", "concurrency", "accepts", "persist"], name);
+    const { version, state, concurrency, accepts, persist } = options;
+    if (!Number.isSafeInteger(version) || version < 1)
+        throw new Error(`${name}.version: expected a positive integer`);
+    const args = snapshotArguments(options.args, `${name}.args`);
+    if (args.bytes)
+        throw new Error(`${name}.args: job arguments are JSON (running carries them); no bytes()`);
+    const result = snapshotSchema(options.result, `${name}.result`);
+    if (state?.keyed)
+        throw new Error(`${name}.state: expected a singleton document definition`);
+    if (persist !== undefined)
+        checkPersistence(persist, state, result, name);
+    if (concurrency !== undefined && !(Number.isSafeInteger(concurrency) && concurrency > 0)) {
+        throw new Error(`${name}.concurrency: expected a positive integer`);
+    }
+    if (accepts !== undefined)
+        checkJobAccepts(accepts, version, `${name}.accepts`);
+    const fingerprint = hash64(JSON.stringify({ args: args.normal, result: result.normal, state: state?.fingerprint ?? null }));
+    return new JobDefinition(name, version, args, result, state, concurrency, accepts ?? {}, persist, fingerprint);
+}
+/** A persisted job's declaration: a resume rule, a persisted state document (if any), a JSON-only result. */
+function checkPersistence(persist, state, result, name) {
+    checkKeys(persist, ["resume"], `${name}.persist`);
+    const { resume } = persist;
+    if (resume !== "rerun" && resume !== "abandon")
+        throw new Error(`${name}.persist.resume: expected "rerun" or "abandon"`);
+    if (state !== undefined && !state.persist) {
+        throw new Error(`${name}.state: a persisted job's state is a persisted document (persist: true)`);
+    }
+    if (result.bytes)
+        throw new Error(`${name}.result: a persisted job's result is JSON (it is stored); no bytes()`);
+}
+/** Checks an accepts table's shape: older versions only, each with an `args` and a `result` function. */
+function checkJobAccepts(accepts, version, path) {
+    for (const [key, adapter] of entriesOf(accepts, path)) {
+        const older = Number(key);
+        if (!Number.isSafeInteger(older) || older < 1 || older >= version) {
+            throw new Error(`${path}[${key}]: not an older version`);
+        }
+        checkKeys(adapter, ["args", "result"], `${path}[${key}]`);
+        const { args, result } = adapter;
+        if (typeof args !== "function")
+            throw new Error(`${path}[${key}].args: expected a function`);
+        if (typeof result !== "function")
+            throw new Error(`${path}[${key}].result: expected a function`);
+    }
+}
+/** A declared job; `A`, `R` and `S` are its args, result and state document (`undefined` without one). */
+export class JobDefinition {
+    name;
+    version;
+    /** The args schema, Chord's copy; its compiled check is cached by this snapshot. */
+    args;
+    result;
+    state;
+    concurrency;
+    /** The older versions' mappings, checked at declaration; slice 7 maps older runs with them. */
+    accepts;
+    /** How its runs persist; `undefined` for a job in memory. */
+    persist;
+    /** `hash64` of its args', result's and state's normal forms: a stored run of another fingerprint is blocked. */
+    fingerprint;
+    constructor(name, version, args, result, state, concurrency, accepts, persist, fingerprint) {
+        this.name = name;
+        this.version = version;
+        this.args = args;
+        this.result = result;
+        this.state = state;
+        this.concurrency = concurrency;
+        this.accepts = accepts;
+        this.persist = persist;
+        this.fingerprint = fingerprint;
+    }
+}
+//# sourceMappingURL=definition.js.map

package/dist/next/jobs/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/next/jobs/definition.ts"],"names":[],"mappings":"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","sourcesContent":["// Job definitions (§15): `defineJob(name, …)`, the checks of a declaration, and the types of what a run ends with.\n\nimport { checkKeys, entriesOf } from \"../contracts/declare.ts\";\nimport type { Schema, Static } from \"../contracts/index.ts\";\nimport { checkName, hash64 } from \"../contracts/internal.ts\";\nimport { type Snapshot, snapshotArguments, snapshotSchema } from \"../contracts/snapshot.ts\";\nimport type { ChordError, PluginError } from \"../data/index.ts\";\nimport type { JsonObject, StateDefinition } from \"../documents/index.ts\";\n\n/** What `defineJob` takes besides the name. */\nexport type JobOptions<\n\tA extends Schema,\n\tR extends Schema,\n\tD extends StateDefinition<JsonObject, false, boolean> | undefined,\n> = {\n\t/** The job's version; every change of its args, result or state bumps it. */\n\treadonly version: number;\n\t/** The run's arguments: closed objects, JSON only (`running` carries them), checked at every start. */\n\treadonly args: A;\n\t/** What `run` returns; not validated. */\n\treadonly result: R;\n\t/**\n\t * A singleton document definition: one document per run, `ctx.state` in `run`, `outcome.state` in `finish`; a\n\t * persisted job's is persisted (`persist: true`, its `checkpointWhen`).\n\t */\n\treadonly state?: D;\n\t/** At most this many runs running or finishing per object; a start beyond it rejects `unavailable/busy`. */\n\treadonly concurrency?: number;\n\t/** Per older version, how its args and result map forwards (used from slice 7 on; checked now). */\n\treadonly accepts?: JobAccepts<A, R>;\n\t/**\n\t * Persists the runs in the object's store (slice 6b; only in `local` types with empty params, P3): how a run cut\n\t * off by a crash or a stop resumes, `rerun` (its `run` again: idempotent work) or `abandon` (`finish` gets `failed {\n\t * aborted, reason: \"restart\" }`). Its result is JSON only (no `bytes()`).\n\t */\n\treadonly persist?: JobPersistence;\n};\n\n/** How a persisted job's runs resume after a crash or a stop. */\nexport type JobPersistence = { readonly resume: \"rerun\" | \"abandon\" };\n\n/** Per older version, its mappings forwards: its args to the current args, its result to the current result. */\nexport type JobAccepts<A extends Schema = Schema, R extends Schema = Schema> = {\n\treadonly [version: number]: { readonly args: (old: never) => Static<A>; readonly result: (old: never) => Static<R> };\n};\n\n/** The value of a job's state document: the definition's document, `undefined` without one. */\ntype StateOf<D> = D extends StateDefinition<infer T, false, boolean> ? T : undefined;\n\n/** What a run ended with, as `finish` and `outcome` get it: its args and state, and its result or its error. */\nexport type Outcome<A, R, S> = { readonly id: string; readonly args: A; readonly state: S } & (\n\t| { readonly kind: \"done\"; readonly result: R }\n\t| { readonly kind: \"failed\"; readonly error: JobError }\n);\n\n/**\n * Why a run failed: `run` threw (reported as `job_failed`; anything but a ChordError or PluginError becomes a\n * PluginError `internal` with its message), it was aborted (`abort`: `abort(id)`; `restart`: cut off by its attempt's\n * seal while the object continues, or a persisted run abandoned after a crash; `reload` comes with slice 7), or a\n * persisted run was cut off five times in a row (`restart_limit`, D6).\n */\nexport type JobError =\n\t| { readonly kind: \"threw\"; readonly error: ChordError | PluginError }\n\t| { readonly kind: \"aborted\"; readonly reason: \"abort\" | \"reload\" | \"restart\" }\n\t| { readonly kind: \"restart_limit\"; readonly restarts: number };\n\n/** Declares a job: owned work a call starts that outlives it (§15). */\nexport function defineJob<\n\tconst A extends Schema,\n\tconst R extends Schema,\n\tD extends StateDefinition<JsonObject, false, boolean> | undefined = undefined,\n>(name: string, options: JobOptions<A, R, D>): JobDefinition<Static<A>, Static<R>, StateOf<D>> {\n\t// Declaration policy: JavaScript callers reach every check below.\n\tcheckName(name, \"A job name\");\n\tcheckKeys(options, [\"version\", \"args\", \"result\", \"state\", \"concurrency\", \"accepts\", \"persist\"], name);\n\tconst { version, state, concurrency, accepts, persist } = options;\n\tif (!Number.isSafeInteger(version) || version < 1) throw new Error(`${name}.version: expected a positive integer`);\n\tconst args = snapshotArguments(options.args, `${name}.args`);\n\tif (args.bytes) throw new Error(`${name}.args: job arguments are JSON (running carries them); no bytes()`);\n\tconst result = snapshotSchema(options.result, `${name}.result`);\n\tif (state?.keyed) throw new Error(`${name}.state: expected a singleton document definition`);\n\tif (persist !== undefined) checkPersistence(persist, state, result, name);\n\tif (concurrency !== undefined && !(Number.isSafeInteger(concurrency) && concurrency > 0)) {\n\t\tthrow new Error(`${name}.concurrency: expected a positive integer`);\n\t}\n\tif (accepts !== undefined) checkJobAccepts(accepts, version, `${name}.accepts`);\n\tconst fingerprint = hash64(\n\t\tJSON.stringify({ args: args.normal, result: result.normal, state: state?.fingerprint ?? null }),\n\t);\n\treturn new JobDefinition(name, version, args, result, state, concurrency, accepts ?? {}, persist, fingerprint);\n}\n\n/** A persisted job's declaration: a resume rule, a persisted state document (if any), a JSON-only result. */\nfunction checkPersistence(\n\tpersist: unknown,\n\tstate: StateDefinition<JsonObject, false, boolean> | undefined,\n\tresult: Snapshot,\n\tname: string,\n): void {\n\tcheckKeys(persist, [\"resume\"], `${name}.persist`);\n\tconst { resume } = persist as { readonly resume?: unknown };\n\tif (resume !== \"rerun\" && resume !== \"abandon\")\n\t\tthrow new Error(`${name}.persist.resume: expected \"rerun\" or \"abandon\"`);\n\tif (state !== undefined && !state.persist) {\n\t\tthrow new Error(`${name}.state: a persisted job's state is a persisted document (persist: true)`);\n\t}\n\tif (result.bytes) throw new Error(`${name}.result: a persisted job's result is JSON (it is stored); no bytes()`);\n}\n\n/** Checks an accepts table's shape: older versions only, each with an `args` and a `result` function. */\nfunction checkJobAccepts(accepts: unknown, version: number, path: string): void {\n\tfor (const [key, adapter] of entriesOf(accepts, path)) {\n\t\tconst older = Number(key);\n\t\tif (!Number.isSafeInteger(older) || older < 1 || older >= version) {\n\t\t\tthrow new Error(`${path}[${key}]: not an older version`);\n\t\t}\n\t\tcheckKeys(adapter, [\"args\", \"result\"], `${path}[${key}]`);\n\t\tconst { args, result } = adapter as { readonly args?: unknown; readonly result?: unknown };\n\t\tif (typeof args !== \"function\") throw new Error(`${path}[${key}].args: expected a function`);\n\t\tif (typeof result !== \"function\") throw new Error(`${path}[${key}].result: expected a function`);\n\t}\n}\n\n/** A declared job; `A`, `R` and `S` are its args, result and state document (`undefined` without one). */\nexport class JobDefinition<A, R, S> {\n\treadonly name: string;\n\treadonly version: number;\n\t/** The args schema, Chord's copy; its compiled check is cached by this snapshot. */\n\treadonly args: Snapshot;\n\treadonly result: Snapshot;\n\treadonly state: StateDefinition<JsonObject, false, boolean> | undefined;\n\treadonly concurrency: number | undefined;\n\t/** The older versions' mappings, checked at declaration; slice 7 maps older runs with them. */\n\treadonly accepts: JobAccepts;\n\t/** How its runs persist; `undefined` for a job in memory. */\n\treadonly persist: JobPersistence | undefined;\n\t/** `hash64` of its args', result's and state's normal forms: a stored run of another fingerprint is blocked. */\n\treadonly fingerprint: string;\n\t/** Type only: the args, result and state types. */\n\tdeclare readonly \"~types\"?: { readonly args: A; readonly result: R; readonly state: S };\n\n\tconstructor(\n\t\tname: string,\n\t\tversion: number,\n\t\targs: Snapshot,\n\t\tresult: Snapshot,\n\t\tstate: StateDefinition<JsonObject, false, boolean> | undefined,\n\t\tconcurrency: number | undefined,\n\t\taccepts: JobAccepts,\n\t\tpersist: JobPersistence | undefined,\n\t\tfingerprint: string,\n\t) {\n\t\tthis.name = name;\n\t\tthis.version = version;\n\t\tthis.args = args;\n\t\tthis.result = result;\n\t\tthis.state = state;\n\t\tthis.concurrency = concurrency;\n\t\tthis.accepts = accepts;\n\t\tthis.persist = persist;\n\t\tthis.fingerprint = fingerprint;\n\t}\n}\n"]}

package/dist/next/jobs/index.d.ts

@@ -0,0 +1,5 @@
+export { defineJob, type JobAccepts, type JobDefinition, type JobError, type JobOptions, type Outcome, } from "./definition.ts";
+export type { JobCtx, JobHandle, JobImplementation, RunState, StartOptions } from "./job.ts";
+export type { BlockedReason, Run } from "./run.ts";
+export type { RunningEntry } from "./running.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/next/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next/jobs/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,SAAS,EACT,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,OAAO,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7F,YAAY,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/next/jobs/index.js

@@ -0,0 +1,3 @@
+// Jobs for apps: declaring a job, its handle, its runs, their outcomes and `running`.
+export { defineJob, } from "./definition.js";
+//# sourceMappingURL=index.js.map

package/dist/next/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next/jobs/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACN,SAAS,GAMT,MAAM,iBAAiB,CAAC","sourcesContent":["// Jobs for apps: declaring a job, its handle, its runs, their outcomes and `running`.\n\nexport {\n\tdefineJob,\n\ttype JobAccepts,\n\ttype JobDefinition,\n\ttype JobError,\n\ttype JobOptions,\n\ttype Outcome,\n} from \"./definition.ts\";\nexport type { JobCtx, JobHandle, JobImplementation, RunState, StartOptions } from \"./job.ts\";\nexport type { BlockedReason, Run } from \"./run.ts\";\nexport type { RunningEntry } from \"./running.ts\";\n"]}

package/dist/next/jobs/internal.d.ts

@@ -0,0 +1,3 @@
+export { type AnyJobImplementation, type CutReason, Job, type JobOwner } from "./job.ts";
+export { JobRecords, type RecordsOwner } from "./records.ts";
+//# sourceMappingURL=internal.d.ts.map

package/dist/next/jobs/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/next/jobs/internal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,SAAS,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/next/jobs/internal.js

@@ -0,0 +1,4 @@
+// Jobs for Chord's layers: a job's records on its object and the handle an attempt keeps, and what they need.
+export { Job } from "./job.js";
+export { JobRecords } from "./records.js";
+//# sourceMappingURL=internal.js.map

package/dist/next/jobs/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../src/next/jobs/internal.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAE9G,OAAO,EAA6C,GAAG,EAAiB,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC","sourcesContent":["// Jobs for Chord's layers: a job's records on its object and the handle an attempt keeps, and what they need.\n\nexport { type AnyJobImplementation, type CutReason, Job, type JobOwner } from \"./job.ts\";\nexport { JobRecords, type RecordsOwner } from \"./records.ts\";\n"]}