@earendil-works/chord 1.3.0 → 1.5.0

package/dist/next/documents/transaction.js

@@ -0,0 +1,409 @@
+// Transactions (§9, R12, R13): drafts of an object's documents, prepared and adopted in one batch, with Chord's own
+// staged changes (job runs, §15), fenced by the token they run under; they run on the object's line (`line.ts`).
+import { withoutAbortSignal } from "../../context/index.js";
+import { track } from "../../delta/index.js";
+import { ChordError } from "../data/index.js";
+import { asChordError } from "../data/internal.js";
+import { refusalOf } from "../store/refusal.js";
+import { TableChanges } from "../store/table-changes.js";
+import { ROWS_PAGE, TableHandle } from "../store/table-handle.js";
+import { checkReadable } from "./persistence.js";
+const IMMEDIATE = { kind: "immediate" };
+/**
+ * One transaction of an object, under the seal token of whoever runs it (an attempt, a job run's invocation, the
+ * object). Commit prepares every draft (Delta records ops and checks only placed values) and adopts the changed
+ * documents and the staged changes in one batch; drafts are revoked once it settles. Cut at its token's seal, it
+ * discards everything, releases the line and refuses every later use.
+ */
+export class Transaction {
+    #documents;
+    token;
+    #release;
+    #context;
+    #entries = new Map();
+    /** Chord's own staged changes, by their owner (a job); made by the first. */
+    #staged;
+    /**
+     * The store writes, in staging order, and the store they commit to; made by the first (the flag that sends the
+     * commit through the store's step, W12).
+     */
+    #writes;
+    /** The tables written, each with its writes and overlay. */
+    #tables;
+    /** `tx.*` reads underway: a callback settling with one is refused (rule 3, as Durable's). */
+    #pending = 0;
+    /** When its commit reaches the store (a run state's deferred change, D8). */
+    #persistence;
+    #state = "open";
+    /** Rejected by `cut` while the commit waits in the store's queue: its caller is told at once (rule 3). */
+    #queued;
+    constructor(documents, token, release, context, persistence = IMMEDIATE) {
+        this.#documents = documents;
+        this.token = token;
+        this.#release = release;
+        this.#context = context;
+        this.#persistence = persistence;
+    }
+    /**
+     * The store writes of this transaction, which `write`s join (Chord's own documents: a job's run records): made by the
+     * first, which sends the commit through `store`'s step.
+     */
+    stageStore(store) {
+        this.#writes ??= { store, staged: [] };
+        return this.#writes.staged;
+    }
+    /** The object whose transaction this is. */
+    get documents() {
+        return this.#documents;
+    }
+    draft(handle, key = "") {
+        // Not `async`: the draft's promise is returned as it is, without another promise around it (the in-memory path
+        // stays as cheap as before the store); a throw still reaches the caller as a rejection.
+        let slot;
+        let at;
+        // Keyed keys follow the text rules (`KeyedSlot.key`); a singleton's key is always "".
+        try {
+            slot = this.#slotOf(handle);
+            at = key === "" ? key : slot.key(key);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        // The entry is made for this handle's slot, whose documents are `T`.
+        return this.draftSlot(slot, at);
+    }
+    /**
+     * The draft of the document at `key` of `slot` (Chord's own slots, a job's run states). A cold persisted document
+     * is loaded first, inside the transaction (it holds the line); the draft counts as pending until it settles (rule
+     * 3). A warm draft settles at once.
+     */
+    async draftSlot(slot, key) {
+        const entry = this.#entry(slot, key);
+        const persisted = slot.persisted;
+        if (entry.draft !== undefined || entry.retire || persisted?.cold(key) !== true)
+            return this.#begin(entry);
+        this.#pending++;
+        try {
+            await persisted.load(key, this.#context, this.token);
+            this.#assertOpen();
+            return this.#begin(entry);
+        }
+        finally {
+            this.#pending--;
+        }
+    }
+    async retire(handle, key = "") {
+        const slot = this.#slotOf(handle);
+        const at = key === "" ? key : slot.key(key);
+        const entry = this.retireSlot(slot, at);
+        const persisted = slot.persisted;
+        // A cold persisted document is found, not loaded (one read; absent: a no-op, R13); a version or fingerprint
+        // the code cannot read fails the owner as a load would (R15): a retirement of it is no exception.
+        if (entry.found === undefined && persisted?.cold(at)) {
+            const found = await this.#track(persisted.persistence.find(at, this.#context));
+            // Cut meanwhile: its attempt was sealed, and failing the owner now would fail its successor.
+            this.#assertOpen();
+            if (found !== undefined)
+                checkFound(found, persisted, slot);
+            entry.found = found?.stored;
+        }
+    }
+    /** Retires the document at `key` of `slot` when the transaction commits. */
+    retireSlot(slot, key) {
+        const entry = this.#entry(slot, key);
+        entry.draft?.change.abort();
+        entry.draft = undefined;
+        entry.retire = true;
+        return entry;
+    }
+    start(job, args, options = {}) {
+        // Job handles are Chord's own: `self.job` made them.
+        return job.stage(this, args, this.#context, options);
+    }
+    get(table, key) {
+        const handle = this.#handle(table);
+        const changes = this.#tables?.get(handle);
+        const read = changes === undefined ? handle.get(key, this.#context) : changes.get(key, this.#context);
+        // The handle's rows are the table's, typed by `C`.
+        return this.#track(read);
+    }
+    page(table, q, limit, options = {}) {
+        // As in `get`; the query's table is checked against the handle's.
+        const read = this.#handle(table).page(q, limit, this.#context, options);
+        return this.#track(read);
+    }
+    async *rows(table, q) {
+        let after;
+        do {
+            const page = await this.page(table, q, ROWS_PAGE, after === undefined ? {} : { after });
+            yield* page.items;
+            after = page.next;
+        } while (after !== undefined);
+    }
+    put(table, row) {
+        this.#changes(table).put(row);
+    }
+    update(table, key, set) {
+        this.#changes(table).update(key, set);
+    }
+    delete(table, key) {
+        this.#changes(table).delete(key);
+    }
+    updateWhere(table, where, set) {
+        this.#changes(table).updateWhere(where, set);
+    }
+    deleteWhere(table, where) {
+        this.#changes(table).deleteWhere(where);
+    }
+    /** The changes `owner` staged in this transaction, made by `make` on its first use. */
+    stage(owner, make) {
+        this.#assertOpen();
+        this.#staged ??= new Map();
+        let staged = this.#staged.get(owner);
+        if (staged === undefined) {
+            staged = make();
+            this.#staged.set(owner, staged);
+        }
+        // Each owner stages one kind of change, the one its `make` returns.
+        return staged;
+    }
+    /** The changes `owner` staged in this transaction so far, if any. */
+    staged(owner) {
+        // As in `stage`: the owner's own kind.
+        return this.#staged?.get(owner);
+    }
+    /**
+     * Prepares every draft and adopts what changed, and the staged changes, in one batch; nothing when nothing changed.
+     * A document retired and drafted anew is removed, then adopted: its frame carries the retirement. Persisted
+     * documents stage their writes here (rule 8), which sends the commit through the store's step.
+     */
+    commit() {
+        this.#assertOpen();
+        if (this.#pending > 0)
+            throw new Error(`${this.#documents.label}: the callback settled before its pending tx operations`);
+        this.#state = "committing";
+        this.#context.abortSignal?.throwIfAborted();
+        const adoptions = [];
+        for (const entries of this.#entries.values()) {
+            for (const entry of entries.values()) {
+                let prepared = entry.draft?.change.prepare();
+                if (prepared !== undefined && prepared.ops.length === 0) {
+                    prepared.abort();
+                    prepared = undefined;
+                }
+                const { slot, key } = entry;
+                const retires = entry.retire && (slot.current(key) !== undefined || entry.found !== undefined);
+                if (prepared === undefined && !retires)
+                    continue;
+                const persisted = slot.persisted;
+                let stored;
+                if (persisted !== undefined) {
+                    const writes = this.stageStore(persisted.persistence.store);
+                    const was = persisted.stored(key) ?? entry.found;
+                    stored = persisted.stage(key, { prepared, retires }, was, writes, this.#persistence);
+                }
+                adoptions.push({ entry, prepared, retires, stored });
+            }
+        }
+        const writes = this.#writes;
+        if (writes === undefined) {
+            this.#adopt(adoptions);
+            this.#state = "committed";
+            return;
+        }
+        return this.#step(writes.store, writes.staged, adoptions);
+    }
+    /**
+     * Commits through the store's step (§3): admitted while neither cut nor sealed (else `released`, nothing written),
+     * then the documents and staged changes adopted inside the step. Once queued, the caller's abort no longer counts;
+     * a cut while queued rejects `released` at once (the queue drops the entry at its admission, writing nothing).
+     */
+    async #step(store, staged, adoptions) {
+        const fence = {
+            admit: () => {
+                if (this.#state !== "committing" || this.token.sealed)
+                    return false;
+                this.#state = "stepping";
+                return true;
+            },
+            adopt: () => this.#adopt(adoptions),
+        };
+        this.#queued = Promise.withResolvers();
+        try {
+            // The race handles the commit's own later rejection too.
+            await Promise.race([store.commit(staged, fence, withoutAbortSignal(this.#context)), this.#queued.promise]);
+        }
+        catch (error) {
+            if (this.#state === "cut")
+                throw this.#cutError();
+            throw this.#refused(error);
+        }
+        finally {
+            this.#queued = undefined;
+        }
+        this.#state = "committed";
+    }
+    /**
+     * The error a commit the store rejected rejects with (D4): the store's own (`released`, `storage_failed`) as it
+     * is; a refused step classified, an `int` `CHECK` failing only this transaction (`invalid/args`), any other refusal
+     * failing the live object `broken` too (memory and disk disagree).
+     */
+    #refused(error) {
+        const refusal = refusalOf(error, this.#documents.label);
+        if (refusal === undefined)
+            return error;
+        if (refusal.kind === "broken")
+            this.#documents.fail(refusal.error);
+        return refusal.error;
+    }
+    /**
+     * Adopts the changed documents (persisted ones with what the commit stored of them) and the staged changes in one
+     * batch; nothing when nothing changed.
+     */
+    #adopt(adoptions) {
+        const staged = this.#staged;
+        if (adoptions.length === 0 && staged === undefined)
+            return;
+        this.#documents.batch.commit(() => {
+            for (const { entry, prepared, retires, stored } of adoptions) {
+                if (retires)
+                    entry.slot.retire(entry.key);
+                if (prepared === undefined)
+                    continue;
+                entry.slot.adopt(entry.key, entry.draft.tracker, prepared, stored);
+            }
+            for (const each of staged?.values() ?? [])
+                each.adopt();
+        }, this.#context);
+    }
+    /** Aborts every draft and prepared change. */
+    discard() {
+        if (this.#state === "cut")
+            return;
+        this.#state = "discarded";
+        this.#abortDrafts();
+    }
+    /**
+     * Its token was sealed while it held the line: every draft is aborted, the line released, and every later use,
+     * its commit included, throws `released`.
+     */
+    cut() {
+        // A commit admitted to the step runs to its end; one still queued is refused at admission.
+        if (this.#state !== "open" && this.#state !== "committing")
+            return;
+        this.#state = "cut";
+        this.#abortDrafts();
+        this.#release();
+        this.#queued?.reject(this.#cutError());
+    }
+    /** Tells the staged changes how the transaction ended; runs once the object's line is free. */
+    settle() {
+        if (this.#staged === undefined)
+            return;
+        const committed = this.#state === "committed";
+        for (const staged of this.#staged.values()) {
+            if (committed)
+                staged.committed();
+            else
+                staged.discarded();
+        }
+    }
+    #abortDrafts() {
+        for (const entries of this.#entries.values())
+            for (const entry of entries.values())
+                entry.draft?.change.abort();
+    }
+    /** The slot behind a handle of this object, after the handle's version fence (R15). */
+    #slotOf(handle) {
+        // Handles are Chord's own: `self.state` made them.
+        const { slot, version } = handle;
+        slot.definition.assertVersion(version);
+        return slot;
+    }
+    #entry(slot, key) {
+        this.#assertOpen();
+        if (slot.owner !== this.#documents) {
+            throw new Error(`${this.#documents.label}: a transaction drafts only its own object's documents`);
+        }
+        let entries = this.#entries.get(slot);
+        if (entries === undefined) {
+            entries = new Map();
+            this.#entries.set(slot, entries);
+        }
+        let entry = entries.get(key);
+        if (entry === undefined) {
+            entry = { slot, key, draft: undefined, retire: false, found: undefined };
+            entries.set(key, entry);
+        }
+        return entry;
+    }
+    #assertOpen() {
+        if (this.#state === "open")
+            return;
+        if (this.#state === "cut")
+            throw this.#cutError();
+        throw new Error(`${this.#documents.label}: the transaction has settled`);
+    }
+    #cutError() {
+        return new ChordError({
+            code: "released",
+            reason: "discarded",
+            message: `${this.#documents.label}: the transaction was discarded at the seal`,
+        });
+    }
+    /** The handle behind `table`, one of this object's tables (another object's is refused). */
+    #handle(table) {
+        this.#assertOpen();
+        // Plugin code may pass any table: only this object's handles are taken.
+        const handle = table;
+        if (!(handle instanceof TableHandle) || handle.owner.scope !== this.#documents) {
+            throw new Error(`${this.#documents.label}: a transaction writes only its own object's tables`);
+        }
+        handle.assertVersion();
+        return handle;
+    }
+    /** The writes to `table` in this transaction, made by the first. */
+    #changes(table) {
+        const handle = this.#handle(table);
+        this.#tables ??= new Map();
+        let changes = this.#tables.get(handle);
+        if (changes === undefined) {
+            this.#writes ??= { store: handle.store, staged: [] };
+            changes = new TableChanges(handle, this.#writes.staged);
+            this.#tables.set(handle, changes);
+        }
+        return changes;
+    }
+    /** Counts `read` as pending until the operation's promise settles (rule 3). */
+    async #track(read) {
+        this.#pending++;
+        try {
+            return await read;
+        }
+        finally {
+            this.#pending--;
+        }
+    }
+    /** The entry's draft, begun on the current document (or a fresh `initial()`) by the first use. */
+    #begin(entry) {
+        if (entry.draft === undefined) {
+            const { slot, key } = entry;
+            const current = entry.retire ? undefined : slot.current(key);
+            const tracker = current ?? track(slot.initial(this.#context));
+            entry.draft = { tracker, change: tracker.beginChange() };
+        }
+        return entry.draft.change.state;
+    }
+}
+/** Throws, failing `slot`'s owner `broken`, when its definition cannot read the cold document `found` (R15). */
+function checkFound(found, persisted, slot) {
+    try {
+        checkReadable({ version: found.stored.version, fingerprint: found.fingerprint }, persisted.definition.current);
+    }
+    catch (error) {
+        const failure = asChordError(error, slot.owner.label);
+        slot.owner.fail(failure);
+        throw failure;
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/next/documents/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../src/next/documents/transaction.ts"],"names":[],"mappings":"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","sourcesContent":["// Transactions (§9, R12, R13): drafts of an object's documents, prepared and adopted in one batch, with Chord's own\n// staged changes (job runs, §15), fenced by the token they run under; they run on the object's line (`line.ts`).\n\nimport { type Context, withoutAbortSignal } from \"../../context/index.ts\";\nimport { type Change, type Draft, type Prepared, type Tracker, track } from \"../../delta/index.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { asChordError } from \"../data/internal.ts\";\nimport type { JobHandle, Outcome, Run, StartOptions } from \"../jobs/index.ts\";\nimport type { Job } from \"../jobs/internal.ts\";\nimport type { Columns, PutRowOf, RowOf } from \"../store/columns.ts\";\nimport type { Condition, SetOf } from \"../store/expression.ts\";\nimport type { ColumnRefs, Query } from \"../store/query.ts\";\nimport { refusalOf } from \"../store/refusal.ts\";\nimport type { StagedWrite } from \"../store/step.ts\";\nimport type { ChordStore } from \"../store/store.ts\";\nimport type { KeyOf } from \"../store/table.ts\";\nimport { TableChanges } from \"../store/table-changes.ts\";\nimport { type Page, type PageOptions, ROWS_PAGE, type Table, TableHandle } from \"../store/table-handle.ts\";\nimport type { CommitPersistence, JsonObject } from \"./definition.ts\";\nimport type { Documents } from \"./documents.ts\";\nimport type { SealToken } from \"./fence.ts\";\nimport type { Keyed, KeyedHandle, Singleton, SingletonHandle } from \"./handles.ts\";\nimport type { KeyedSlot } from \"./keyed-slot.ts\";\nimport { checkReadable, type FoundDocument, type Stored, type StoredChange } from \"./persistence.ts\";\nimport type { DocumentSlot, PersistedSlot, SingletonSlot } from \"./slot.ts\";\n\n/** What `self.tx` gives its callback. Inside it: only `await tx.*`, no other `self.tx`, no calls to other objects. */\nexport interface Tx {\n\t/** The document's draft: the same one for the same document within one transaction. */\n\tdraft<T extends JsonObject>(handle: SingletonHandle<T>): Promise<Draft<T>>;\n\tdraft<T extends JsonObject>(handle: KeyedHandle<T>, key: string): Promise<Draft<T>>;\n\t/** Retires the document when the transaction commits (its address reads `initial()` again); a no-op when it is absent. */\n\tretire(handle: SingletonHandle<JsonObject>): Promise<void>;\n\tretire(handle: KeyedHandle<JsonObject>, key: string): Promise<void>;\n\t/**\n\t * Starts a run of `job`, one of this object's jobs, with this transaction's other writes (§15): both commit or\n\t * neither. Returns its `Run` at once; a discarded transaction's `Run` rejects `released` from `outcome`. A key of an\n\t * unsettled run (one started earlier in this transaction too) returns that run.\n\t */\n\tstart<A, R, S>(job: JobHandle<A, R, S>, args: A, options?: StartOptions): Run<Outcome<A, R, S>>;\n\t/** The row with `key` as this transaction leaves it (its own `put`, `update`, `delete` overlaid; W10). */\n\tget<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\tkey: KeyOf<C, K>,\n\t): Promise<RowOf<C> | undefined>;\n\t/** A page of committed rows, stable for the transaction (without its own writes). */\n\tpage<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\tq: Query<C, K>,\n\t\tlimit: number,\n\t\toptions?: PageOptions,\n\t): Promise<Page<RowOf<C>>>;\n\t/** Every committed row of `q`, as `page`. */\n\trows<C extends Columns, K extends readonly string[]>(table: Table<C, K>, q: Query<C, K>): AsyncIterable<RowOf<C>>;\n\t/** Writes `row` when the transaction commits (an upsert: the whole row replaced). */\n\tput<C extends Columns, K extends readonly string[]>(table: Table<C, K>, row: PutRowOf<C>): void;\n\t/** Changes the row with `key` when the transaction commits; an absent key changes nothing. */\n\tupdate<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\tkey: KeyOf<C, K>,\n\t\tset: SetOf<C, K> | ((row: ColumnRefs<C>) => SetOf<C, K>),\n\t): void;\n\t/** Deletes the row with `key` when the transaction commits. */\n\tdelete<C extends Columns, K extends readonly string[]>(table: Table<C, K>, key: KeyOf<C, K>): void;\n\t/** Changes every row matching `where` when the transaction commits (one statement, its count recorded). */\n\tupdateWhere<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\twhere: (row: ColumnRefs<C>) => Condition,\n\t\tset: SetOf<C, K> | ((row: ColumnRefs<C>) => SetOf<C, K>),\n\t): void;\n\t/** Deletes every row matching `where` when the transaction commits. */\n\tdeleteWhere<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\twhere: (row: ColumnRefs<C>) => Condition,\n\t): void;\n}\n\n/**\n * Chord's own changes staged in a transaction (a job's run records): adopted in its commit step with the documents,\n * then told how the transaction ended, once the owner's line is free.\n */\nexport interface Staged {\n\t/** Adopts the changes, inside the commit's batch. */\n\tadopt(): void;\n\t/** The transaction committed: the actions after the commit (a run starts, waiters settle). */\n\tcommitted(): void;\n\t/** The transaction was discarded: nothing was adopted. */\n\tdiscarded(): void;\n}\n\n/**\n * What one transaction does with one document: a draft, a retirement, or both (retired, then drafted anew); `found`\n * is what is stored of a cold persisted document it retires without loading (R13).\n */\ntype Entry = {\n\treadonly slot: DocumentSlot;\n\treadonly key: string;\n\tdraft: { readonly tracker: Tracker<JsonObject>; readonly change: Change<JsonObject> } | undefined;\n\tretire: boolean;\n\tfound: Stored | undefined;\n};\n\nconst IMMEDIATE: CommitPersistence = { kind: \"immediate\" };\n\n/**\n * One document change a commit adopts: a removal, a draft's prepared change, or both; and for a persisted document\n * what the commit stores of it.\n */\ntype Adoption = {\n\treadonly entry: Entry;\n\treadonly prepared: Prepared<JsonObject> | undefined;\n\treadonly retires: boolean;\n\treadonly stored: StoredChange | undefined;\n};\n\n/**\n * One transaction of an object, under the seal token of whoever runs it (an attempt, a job run's invocation, the\n * object). Commit prepares every draft (Delta records ops and checks only placed values) and adopts the changed\n * documents and the staged changes in one batch; drafts are revoked once it settles. Cut at its token's seal, it\n * discards everything, releases the line and refuses every later use.\n */\nexport class Transaction implements Tx {\n\treadonly #documents: Documents;\n\treadonly token: SealToken;\n\treadonly #release: () => void;\n\treadonly #context: Context;\n\treadonly #entries = new Map<DocumentSlot, Map<string, Entry>>();\n\t/** Chord's own staged changes, by their owner (a job); made by the first. */\n\t#staged: Map<object, Staged> | undefined;\n\t/**\n\t * The store writes, in staging order, and the store they commit to; made by the first (the flag that sends the\n\t * commit through the store's step, W12).\n\t */\n\t#writes: { readonly store: ChordStore; readonly staged: StagedWrite[] } | undefined;\n\t/** The tables written, each with its writes and overlay. */\n\t#tables: Map<TableHandle, TableChanges> | undefined;\n\t/** `tx.*` reads underway: a callback settling with one is refused (rule 3, as Durable's). */\n\t#pending = 0;\n\t/** When its commit reaches the store (a run state's deferred change, D8). */\n\treadonly #persistence: CommitPersistence;\n\t#state: \"open\" | \"committing\" | \"stepping\" | \"committed\" | \"discarded\" | \"cut\" = \"open\";\n\t/** Rejected by `cut` while the commit waits in the store's queue: its caller is told at once (rule 3). */\n\t#queued: PromiseWithResolvers<never> | undefined;\n\n\tconstructor(\n\t\tdocuments: Documents,\n\t\ttoken: SealToken,\n\t\trelease: () => void,\n\t\tcontext: Context,\n\t\tpersistence: CommitPersistence = IMMEDIATE,\n\t) {\n\t\tthis.#documents = documents;\n\t\tthis.token = token;\n\t\tthis.#release = release;\n\t\tthis.#context = context;\n\t\tthis.#persistence = persistence;\n\t}\n\n\t/**\n\t * The store writes of this transaction, which `write`s join (Chord's own documents: a job's run records): made by the\n\t * first, which sends the commit through `store`'s step.\n\t */\n\tstageStore(store: ChordStore): StagedWrite[] {\n\t\tthis.#writes ??= { store, staged: [] };\n\t\treturn this.#writes.staged;\n\t}\n\n\t/** The object whose transaction this is. */\n\tget documents(): Documents {\n\t\treturn this.#documents;\n\t}\n\n\tdraft<T extends JsonObject>(handle: SingletonHandle<T>): Promise<Draft<T>>;\n\tdraft<T extends JsonObject>(handle: KeyedHandle<T>, key: string): Promise<Draft<T>>;\n\tdraft<T extends JsonObject>(handle: SingletonHandle<T> | KeyedHandle<T>, key = \"\"): Promise<Draft<T>> {\n\t\t// Not `async`: the draft's promise is returned as it is, without another promise around it (the in-memory path\n\t\t// stays as cheap as before the store); a throw still reaches the caller as a rejection.\n\t\tlet slot: SingletonSlot | KeyedSlot;\n\t\tlet at: string;\n\t\t// Keyed keys follow the text rules (`KeyedSlot.key`); a singleton's key is always \"\".\n\t\ttry {\n\t\t\tslot = this.#slotOf(handle);\n\t\t\tat = key === \"\" ? key : slot.key(key);\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t\t// The entry is made for this handle's slot, whose documents are `T`.\n\t\treturn this.draftSlot(slot, at) as Promise<Draft<T>>;\n\t}\n\n\t/**\n\t * The draft of the document at `key` of `slot` (Chord's own slots, a job's run states). A cold persisted document\n\t * is loaded first, inside the transaction (it holds the line); the draft counts as pending until it settles (rule\n\t * 3). A warm draft settles at once.\n\t */\n\tasync draftSlot(slot: DocumentSlot, key: string): Promise<Draft<JsonObject>> {\n\t\tconst entry = this.#entry(slot, key);\n\t\tconst persisted = slot.persisted;\n\t\tif (entry.draft !== undefined || entry.retire || persisted?.cold(key) !== true) return this.#begin(entry);\n\t\tthis.#pending++;\n\t\ttry {\n\t\t\tawait persisted.load(key, this.#context, this.token);\n\t\t\tthis.#assertOpen();\n\t\t\treturn this.#begin(entry);\n\t\t} finally {\n\t\t\tthis.#pending--;\n\t\t}\n\t}\n\n\tretire(handle: SingletonHandle<JsonObject>): Promise<void>;\n\tretire(handle: KeyedHandle<JsonObject>, key: string): Promise<void>;\n\tasync retire(handle: SingletonHandle<JsonObject> | KeyedHandle<JsonObject>, key = \"\"): Promise<void> {\n\t\tconst slot = this.#slotOf(handle);\n\t\tconst at = key === \"\" ? key : slot.key(key);\n\t\tconst entry = this.retireSlot(slot, at);\n\t\tconst persisted = slot.persisted;\n\t\t// A cold persisted document is found, not loaded (one read; absent: a no-op, R13); a version or fingerprint\n\t\t// the code cannot read fails the owner as a load would (R15): a retirement of it is no exception.\n\t\tif (entry.found === undefined && persisted?.cold(at)) {\n\t\t\tconst found = await this.#track(persisted.persistence.find(at, this.#context));\n\t\t\t// Cut meanwhile: its attempt was sealed, and failing the owner now would fail its successor.\n\t\t\tthis.#assertOpen();\n\t\t\tif (found !== undefined) checkFound(found, persisted, slot);\n\t\t\tentry.found = found?.stored;\n\t\t}\n\t}\n\n\t/** Retires the document at `key` of `slot` when the transaction commits. */\n\tretireSlot(slot: DocumentSlot, key: string): Entry {\n\t\tconst entry = this.#entry(slot, key);\n\t\tentry.draft?.change.abort();\n\t\tentry.draft = undefined;\n\t\tentry.retire = true;\n\t\treturn entry;\n\t}\n\n\tstart<A, R, S>(job: JobHandle<A, R, S>, args: A, options: StartOptions = {}): Run<Outcome<A, R, S>> {\n\t\t// Job handles are Chord's own: `self.job` made them.\n\t\treturn (job as unknown as Job).stage(this, args, this.#context, options) as Run<Outcome<A, R, S>>;\n\t}\n\n\tget<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\tkey: KeyOf<C, K>,\n\t): Promise<RowOf<C> | undefined> {\n\t\tconst handle = this.#handle(table);\n\t\tconst changes = this.#tables?.get(handle);\n\t\tconst read = changes === undefined ? handle.get(key, this.#context) : changes.get(key, this.#context);\n\t\t// The handle's rows are the table's, typed by `C`.\n\t\treturn this.#track(read) as Promise<RowOf<C> | undefined>;\n\t}\n\n\tpage<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\tq: Query<C, K>,\n\t\tlimit: number,\n\t\toptions: PageOptions = {},\n\t): Promise<Page<RowOf<C>>> {\n\t\t// As in `get`; the query's table is checked against the handle's.\n\t\tconst read = this.#handle(table).page(q as unknown as Query, limit, this.#context, options);\n\t\treturn this.#track(read) as Promise<Page<RowOf<C>>>;\n\t}\n\n\tasync *rows<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\tq: Query<C, K>,\n\t): AsyncIterable<RowOf<C>> {\n\t\tlet after: string | undefined;\n\t\tdo {\n\t\t\tconst page = await this.page(table, q, ROWS_PAGE, after === undefined ? {} : { after });\n\t\t\tyield* page.items;\n\t\t\tafter = page.next;\n\t\t} while (after !== undefined);\n\t}\n\n\tput<C extends Columns, K extends readonly string[]>(table: Table<C, K>, row: PutRowOf<C>): void {\n\t\tthis.#changes(table).put(row);\n\t}\n\n\tupdate<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\tkey: KeyOf<C, K>,\n\t\tset: SetOf<C, K> | ((row: ColumnRefs<C>) => SetOf<C, K>),\n\t): void {\n\t\tthis.#changes(table).update(key, set);\n\t}\n\n\tdelete<C extends Columns, K extends readonly string[]>(table: Table<C, K>, key: KeyOf<C, K>): void {\n\t\tthis.#changes(table).delete(key);\n\t}\n\n\tupdateWhere<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\twhere: (row: ColumnRefs<C>) => Condition,\n\t\tset: SetOf<C, K> | ((row: ColumnRefs<C>) => SetOf<C, K>),\n\t): void {\n\t\tthis.#changes(table).updateWhere(where, set);\n\t}\n\n\tdeleteWhere<C extends Columns, K extends readonly string[]>(\n\t\ttable: Table<C, K>,\n\t\twhere: (row: ColumnRefs<C>) => Condition,\n\t): void {\n\t\tthis.#changes(table).deleteWhere(where);\n\t}\n\n\t/** The changes `owner` staged in this transaction, made by `make` on its first use. */\n\tstage<S extends Staged>(owner: object, make: () => S): S {\n\t\tthis.#assertOpen();\n\t\tthis.#staged ??= new Map();\n\t\tlet staged = this.#staged.get(owner);\n\t\tif (staged === undefined) {\n\t\t\tstaged = make();\n\t\t\tthis.#staged.set(owner, staged);\n\t\t}\n\t\t// Each owner stages one kind of change, the one its `make` returns.\n\t\treturn staged as S;\n\t}\n\n\t/** The changes `owner` staged in this transaction so far, if any. */\n\tstaged<S extends Staged>(owner: object): S | undefined {\n\t\t// As in `stage`: the owner's own kind.\n\t\treturn this.#staged?.get(owner) as S | undefined;\n\t}\n\n\t/**\n\t * Prepares every draft and adopts what changed, and the staged changes, in one batch; nothing when nothing changed.\n\t * A document retired and drafted anew is removed, then adopted: its frame carries the retirement. Persisted\n\t * documents stage their writes here (rule 8), which sends the commit through the store's step.\n\t */\n\tcommit(): void | Promise<void> {\n\t\tthis.#assertOpen();\n\t\tif (this.#pending > 0)\n\t\t\tthrow new Error(`${this.#documents.label}: the callback settled before its pending tx operations`);\n\t\tthis.#state = \"committing\";\n\t\tthis.#context.abortSignal?.throwIfAborted();\n\t\tconst adoptions: Adoption[] = [];\n\t\tfor (const entries of this.#entries.values()) {\n\t\t\tfor (const entry of entries.values()) {\n\t\t\t\tlet prepared = entry.draft?.change.prepare();\n\t\t\t\tif (prepared !== undefined && prepared.ops.length === 0) {\n\t\t\t\t\tprepared.abort();\n\t\t\t\t\tprepared = undefined;\n\t\t\t\t}\n\t\t\t\tconst { slot, key } = entry;\n\t\t\t\tconst retires = entry.retire && (slot.current(key) !== undefined || entry.found !== undefined);\n\t\t\t\tif (prepared === undefined && !retires) continue;\n\t\t\t\tconst persisted = slot.persisted;\n\t\t\t\tlet stored: StoredChange | undefined;\n\t\t\t\tif (persisted !== undefined) {\n\t\t\t\t\tconst writes = this.stageStore(persisted.persistence.store);\n\t\t\t\t\tconst was = persisted.stored(key) ?? entry.found;\n\t\t\t\t\tstored = persisted.stage(key, { prepared, retires }, was, writes, this.#persistence);\n\t\t\t\t}\n\t\t\t\tadoptions.push({ entry, prepared, retires, stored });\n\t\t\t}\n\t\t}\n\t\tconst writes = this.#writes;\n\t\tif (writes === undefined) {\n\t\t\tthis.#adopt(adoptions);\n\t\t\tthis.#state = \"committed\";\n\t\t\treturn;\n\t\t}\n\t\treturn this.#step(writes.store, writes.staged, adoptions);\n\t}\n\n\t/**\n\t * Commits through the store's step (§3): admitted while neither cut nor sealed (else `released`, nothing written),\n\t * then the documents and staged changes adopted inside the step. Once queued, the caller's abort no longer counts;\n\t * a cut while queued rejects `released` at once (the queue drops the entry at its admission, writing nothing).\n\t */\n\tasync #step(store: ChordStore, staged: readonly StagedWrite[], adoptions: readonly Adoption[]): Promise<void> {\n\t\tconst fence = {\n\t\t\tadmit: () => {\n\t\t\t\tif (this.#state !== \"committing\" || this.token.sealed) return false;\n\t\t\t\tthis.#state = \"stepping\";\n\t\t\t\treturn true;\n\t\t\t},\n\t\t\tadopt: () => this.#adopt(adoptions),\n\t\t};\n\t\tthis.#queued = Promise.withResolvers<never>();\n\t\ttry {\n\t\t\t// The race handles the commit's own later rejection too.\n\t\t\tawait Promise.race([store.commit(staged, fence, withoutAbortSignal(this.#context)), this.#queued.promise]);\n\t\t} catch (error) {\n\t\t\tif (this.#state === \"cut\") throw this.#cutError();\n\t\t\tthrow this.#refused(error);\n\t\t} finally {\n\t\t\tthis.#queued = undefined;\n\t\t}\n\t\tthis.#state = \"committed\";\n\t}\n\n\t/**\n\t * The error a commit the store rejected rejects with (D4): the store's own (`released`, `storage_failed`) as it\n\t * is; a refused step classified, an `int` `CHECK` failing only this transaction (`invalid/args`), any other refusal\n\t * failing the live object `broken` too (memory and disk disagree).\n\t */\n\t#refused(error: unknown): unknown {\n\t\tconst refusal = refusalOf(error, this.#documents.label);\n\t\tif (refusal === undefined) return error;\n\t\tif (refusal.kind === \"broken\") this.#documents.fail(refusal.error);\n\t\treturn refusal.error;\n\t}\n\n\t/**\n\t * Adopts the changed documents (persisted ones with what the commit stored of them) and the staged changes in one\n\t * batch; nothing when nothing changed.\n\t */\n\t#adopt(adoptions: readonly Adoption[]): void {\n\t\tconst staged = this.#staged;\n\t\tif (adoptions.length === 0 && staged === undefined) return;\n\t\tthis.#documents.batch.commit(() => {\n\t\t\tfor (const { entry, prepared, retires, stored } of adoptions) {\n\t\t\t\tif (retires) entry.slot.retire(entry.key);\n\t\t\t\tif (prepared === undefined) continue;\n\t\t\t\tentry.slot.adopt(entry.key, entry.draft!.tracker, prepared, stored);\n\t\t\t}\n\t\t\tfor (const each of staged?.values() ?? []) each.adopt();\n\t\t}, this.#context);\n\t}\n\n\t/** Aborts every draft and prepared change. */\n\tdiscard(): void {\n\t\tif (this.#state === \"cut\") return;\n\t\tthis.#state = \"discarded\";\n\t\tthis.#abortDrafts();\n\t}\n\n\t/**\n\t * Its token was sealed while it held the line: every draft is aborted, the line released, and every later use,\n\t * its commit included, throws `released`.\n\t */\n\tcut(): void {\n\t\t// A commit admitted to the step runs to its end; one still queued is refused at admission.\n\t\tif (this.#state !== \"open\" && this.#state !== \"committing\") return;\n\t\tthis.#state = \"cut\";\n\t\tthis.#abortDrafts();\n\t\tthis.#release();\n\t\tthis.#queued?.reject(this.#cutError());\n\t}\n\n\t/** Tells the staged changes how the transaction ended; runs once the object's line is free. */\n\tsettle(): void {\n\t\tif (this.#staged === undefined) return;\n\t\tconst committed = this.#state === \"committed\";\n\t\tfor (const staged of this.#staged.values()) {\n\t\t\tif (committed) staged.committed();\n\t\t\telse staged.discarded();\n\t\t}\n\t}\n\n\t#abortDrafts(): void {\n\t\tfor (const entries of this.#entries.values()) for (const entry of entries.values()) entry.draft?.change.abort();\n\t}\n\n\t/** The slot behind a handle of this object, after the handle's version fence (R15). */\n\t#slotOf(handle: SingletonHandle<JsonObject> | KeyedHandle<JsonObject>): SingletonSlot | KeyedSlot {\n\t\t// Handles are Chord's own: `self.state` made them.\n\t\tconst { slot, version } = handle as Singleton | Keyed;\n\t\tslot.definition.assertVersion(version);\n\t\treturn slot;\n\t}\n\n\t#entry(slot: DocumentSlot, key: string): Entry {\n\t\tthis.#assertOpen();\n\t\tif (slot.owner !== this.#documents) {\n\t\t\tthrow new Error(`${this.#documents.label}: a transaction drafts only its own object's documents`);\n\t\t}\n\t\tlet entries = this.#entries.get(slot);\n\t\tif (entries === undefined) {\n\t\t\tentries = new Map();\n\t\t\tthis.#entries.set(slot, entries);\n\t\t}\n\t\tlet entry = entries.get(key);\n\t\tif (entry === undefined) {\n\t\t\tentry = { slot, key, draft: undefined, retire: false, found: undefined };\n\t\t\tentries.set(key, entry);\n\t\t}\n\t\treturn entry;\n\t}\n\n\t#assertOpen(): void {\n\t\tif (this.#state === \"open\") return;\n\t\tif (this.#state === \"cut\") throw this.#cutError();\n\t\tthrow new Error(`${this.#documents.label}: the transaction has settled`);\n\t}\n\n\t#cutError(): ChordError {\n\t\treturn new ChordError({\n\t\t\tcode: \"released\",\n\t\t\treason: \"discarded\",\n\t\t\tmessage: `${this.#documents.label}: the transaction was discarded at the seal`,\n\t\t});\n\t}\n\n\t/** The handle behind `table`, one of this object's tables (another object's is refused). */\n\t#handle(table: object): TableHandle {\n\t\tthis.#assertOpen();\n\t\t// Plugin code may pass any table: only this object's handles are taken.\n\t\tconst handle = table;\n\t\tif (!(handle instanceof TableHandle) || handle.owner.scope !== this.#documents) {\n\t\t\tthrow new Error(`${this.#documents.label}: a transaction writes only its own object's tables`);\n\t\t}\n\t\thandle.assertVersion();\n\t\treturn handle;\n\t}\n\n\t/** The writes to `table` in this transaction, made by the first. */\n\t#changes(table: object): TableChanges {\n\t\tconst handle = this.#handle(table);\n\t\tthis.#tables ??= new Map();\n\t\tlet changes = this.#tables.get(handle);\n\t\tif (changes === undefined) {\n\t\t\tthis.#writes ??= { store: handle.store, staged: [] };\n\t\t\tchanges = new TableChanges(handle, this.#writes.staged);\n\t\t\tthis.#tables.set(handle, changes);\n\t\t}\n\t\treturn changes;\n\t}\n\n\t/** Counts `read` as pending until the operation's promise settles (rule 3). */\n\tasync #track<T>(read: Promise<T>): Promise<T> {\n\t\tthis.#pending++;\n\t\ttry {\n\t\t\treturn await read;\n\t\t} finally {\n\t\t\tthis.#pending--;\n\t\t}\n\t}\n\n\t/** The entry's draft, begun on the current document (or a fresh `initial()`) by the first use. */\n\t#begin(entry: Entry): Draft<JsonObject> {\n\t\tif (entry.draft === undefined) {\n\t\t\tconst { slot, key } = entry;\n\t\t\tconst current = entry.retire ? undefined : slot.current(key);\n\t\t\tconst tracker = current ?? track(slot.initial(this.#context));\n\t\t\tentry.draft = { tracker, change: tracker.beginChange() };\n\t\t}\n\t\treturn entry.draft.change.state;\n\t}\n}\n\n/** Throws, failing `slot`'s owner `broken`, when its definition cannot read the cold document `found` (R15). */\nfunction checkFound(found: FoundDocument, persisted: PersistedSlot, slot: DocumentSlot): void {\n\ttry {\n\t\tcheckReadable({ version: found.stored.version, fingerprint: found.fingerprint }, persisted.definition.current);\n\t} catch (error) {\n\t\tconst failure = asChordError(error, slot.owner.label);\n\t\tslot.owner.fail(failure);\n\t\tthrow failure;\n\t}\n}\n"]}

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

@@ -0,0 +1,31 @@
+import { type Context } from "../../context/index.ts";
+import type { JsonValue } from "../../json.ts";
+import { Source } from "../state/internal.ts";
+/** What `host.activity` counts. */
+export type ActivityCounts = {
+    /** Holds arriving over links and served here. */
+    readonly references: number;
+    /** Method calls running on this host, local and remote. */
+    readonly calls: number;
+    /** Running jobs (slice 5). */
+    readonly jobs: number;
+    /** Objects kept live by their type's `linger` after their last reference. */
+    readonly lingering: number;
+};
+/**
+ * `host.activity`. A count marks it changed; while it is watched or derived from, the first change of a microtask turn
+ * schedules one publication, a batch that gives its watches the counts as they are then (`[["r", counts]]`: a slow
+ * watch gets the newest counts) and marks derives over it. Its value is built from the counters when read or
+ * published.
+ */
+export declare class Activity extends Source {
+    #private;
+    get value(): JsonValue;
+    /**
+     * Adds `delta` to the count of `kind`; published with the turn's other changes. Nothing is scheduled while nobody
+     * watches or derives from it: a later watch or derive reads the counts as they are then.
+     */
+    count(kind: keyof ActivityCounts, delta: number): void;
+    deliver(context: Context): void;
+}
+//# sourceMappingURL=activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/next/host/activity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,mCAAmC;AACnC,MAAM,MAAM,cAAc,GAAG;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,MAAM;;IAMnC,IAAI,KAAK,IAAI,SAAS,CAGrB;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASrD;IAED,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAG9B;CACD"}

package/dist/next/host/activity.js

@@ -0,0 +1,40 @@
+// Keep-alive counts (§3, R26): `host.activity`, a JSON watchable of the work keeping a host busy, for the app's
+// supervisor. Counters are kept where the work happens; their changes in one microtask turn are one publication.
+import { BACKGROUND_CONTEXT } from "../../context/index.js";
+import { Source } from "../state/internal.js";
+/**
+ * `host.activity`. A count marks it changed; while it is watched or derived from, the first change of a microtask turn
+ * schedules one publication, a batch that gives its watches the counts as they are then (`[["r", counts]]`: a slow
+ * watch gets the newest counts) and marks derives over it. Its value is built from the counters when read or
+ * published.
+ */
+export class Activity extends Source {
+    #counts = { references: 0, calls: 0, jobs: 0, lingering: 0 };
+    /** The counts as last read, until the next change. */
+    #value;
+    #scheduled = false;
+    get value() {
+        this.#value ??= { ...this.#counts };
+        return this.#value;
+    }
+    /**
+     * Adds `delta` to the count of `kind`; published with the turn's other changes. Nothing is scheduled while nobody
+     * watches or derives from it: a later watch or derive reads the counts as they are then.
+     */
+    count(kind, delta) {
+        this.#counts[kind] += delta;
+        this.#value = undefined;
+        if (this.#scheduled || (!this.watched && this.dependents.size === 0))
+            return;
+        this.#scheduled = true;
+        queueMicrotask(() => {
+            this.#scheduled = false;
+            this.batch.within(() => this.changed(), BACKGROUND_CONTEXT);
+        });
+    }
+    deliver(context) {
+        const value = this.value;
+        this.publish(value, [["r", value]], false, context);
+    }
+}
+//# sourceMappingURL=activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/next/host/activity.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,iHAAiH;AAEjH,OAAO,EAAE,kBAAkB,EAAgB,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAc9C;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,MAAM;IAC1B,OAAO,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACtE,sDAAsD;IACtD,MAAM,CAA6B;IACnC,UAAU,GAAG,KAAK,CAAC;IAEnB,IAAI,KAAK;QACR,IAAI,CAAC,MAAM,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAA0B,EAAE,KAAa;QAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC;YAAE,OAAO;QAC7E,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,cAAc,CAAC,GAAG,EAAE;YACnB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,OAAgB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACD","sourcesContent":["// Keep-alive counts (§3, R26): `host.activity`, a JSON watchable of the work keeping a host busy, for the app's\n// supervisor. Counters are kept where the work happens; their changes in one microtask turn are one publication.\n\nimport { BACKGROUND_CONTEXT, type Context } from \"../../context/index.ts\";\nimport type { JsonValue } from \"../../json.ts\";\nimport { Source } from \"../state/internal.ts\";\n\n/** What `host.activity` counts. */\nexport type ActivityCounts = {\n\t/** Holds arriving over links and served here. */\n\treadonly references: number;\n\t/** Method calls running on this host, local and remote. */\n\treadonly calls: number;\n\t/** Running jobs (slice 5). */\n\treadonly jobs: number;\n\t/** Objects kept live by their type's `linger` after their last reference. */\n\treadonly lingering: number;\n};\n\n/**\n * `host.activity`. A count marks it changed; while it is watched or derived from, the first change of a microtask turn\n * schedules one publication, a batch that gives its watches the counts as they are then (`[[\"r\", counts]]`: a slow\n * watch gets the newest counts) and marks derives over it. Its value is built from the counters when read or\n * published.\n */\nexport class Activity extends Source {\n\treadonly #counts = { references: 0, calls: 0, jobs: 0, lingering: 0 };\n\t/** The counts as last read, until the next change. */\n\t#value: ActivityCounts | undefined;\n\t#scheduled = false;\n\n\tget value(): JsonValue {\n\t\tthis.#value ??= { ...this.#counts };\n\t\treturn this.#value;\n\t}\n\n\t/**\n\t * Adds `delta` to the count of `kind`; published with the turn's other changes. Nothing is scheduled while nobody\n\t * watches or derives from it: a later watch or derive reads the counts as they are then.\n\t */\n\tcount(kind: keyof ActivityCounts, delta: number): void {\n\t\tthis.#counts[kind] += delta;\n\t\tthis.#value = undefined;\n\t\tif (this.#scheduled || (!this.watched && this.dependents.size === 0)) return;\n\t\tthis.#scheduled = true;\n\t\tqueueMicrotask(() => {\n\t\t\tthis.#scheduled = false;\n\t\t\tthis.batch.within(() => this.changed(), BACKGROUND_CONTEXT);\n\t\t});\n\t}\n\n\tdeliver(context: Context): void {\n\t\tconst value = this.value;\n\t\tthis.publish(value, [[\"r\", value]], false, context);\n\t}\n}\n"]}

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

@@ -0,0 +1,49 @@
+import type { JsonValue } from "../../json.ts";
+import { ChordError } from "../data/index.ts";
+import type { Batch } from "../state/batch.ts";
+import { type DeriveSource } from "../state/internal.ts";
+import type { Served } from "./object.ts";
+/** What the mappings of one instance read: its provider, its variant, its own members, its host's batch and reports. */
+export type AdaptedInstance = {
+    readonly served: Served;
+    readonly variant: string | undefined;
+    readonly label: string;
+    readonly batch: Batch;
+    /** The instance's state member `member` (`invalid/member` when its variant has none). */
+    member(member: string): DeriveSource;
+    /** Reports a mapping derive's failure (`derive_failed`). */
+    report(member: string, error: unknown): void;
+};
+/**
+ * Why consumers of the older `version` cannot bind to `served`'s `variant`: a version it does not accept, or a member
+ * of it the provider refuses (`contract_mismatch`); `undefined` when they can.
+ */
+export declare function refusal(served: Served, version: number, variant: string | undefined): ChordError | undefined;
+/** One instance's members as the consumers of one older version read them. */
+export declare class AdaptedMembers {
+    #private;
+    readonly version: number;
+    constructor(instance: AdaptedInstance, version: number);
+    /**
+     * State member `member` as this version reads it, made by the first use; `contract_mismatch` when the provider
+     * refuses it or does not accept this version.
+     */
+    member(member: string): DeriveSource;
+    /**
+     * The document `document` at a key of keyed member `member` as this version reads it: the document itself when
+     * unchanged, else a derive of it through the mapping, shared by its holders; `release` (once per call) lets the last
+     * holder's go. `contract_mismatch` when the provider refuses the member.
+     */
+    key(member: string, document: DeriveSource): {
+        readonly source: DeriveSource;
+        release(): void;
+    };
+    /**
+     * The provider's mapping of keyed member `member`'s documents to this version's shape (`undefined`: unchanged),
+     * counted; throws `contract_mismatch` when the provider refuses it.
+     */
+    keyed(member: string): ((current: JsonValue) => JsonValue) | undefined;
+    /** Its instance ended, or the version's last reference left: its derives go (their watches end with `error`). */
+    detach(error: Error): void;
+}
+//# sourceMappingURL=adapted.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapted.d.ts","sourceRoot":"","sources":["../../../src/next/host/adapted.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAW1C,wHAAwH;AACxH,MAAM,MAAM,eAAe,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,yFAAyF;IACzF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IACrC,4DAA4D;IAC5D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C,CAAC;AAKF;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAc5G;AAED,8EAA8E;AAC9E,qBAAa,cAAc;;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IASzB,YAAY,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAGrD;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAMnC;IAED;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAAC,OAAO,IAAI,IAAI,CAAA;KAAE,CAsC9F;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,GAAG,SAAS,CAErE;IAED,iHAAiH;IACjH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAQzB;CAuED"}