@earendil-works/chord 1.3.0 → 1.5.0

package/dist/next/remote/remote-object.js

@@ -0,0 +1,411 @@
+// An object held over a link (§7): what one remote reference is bound to on the consumer, across the links of its path
+// (the parent, or a route address). Its state, the replicas of its last bound variant (kept while its link is down),
+// its hold on the path's current link and calls through it.
+import { BACKGROUND_CONTEXT } from "../../context/index.js";
+import { currentVariants, variantNames, variantOrder, } from "../contracts/internal.js";
+import { ChordError } from "../data/index.js";
+import { asChordError, invalid } from "../data/internal.js";
+import { LIVE, LOADING, } from "../host/internal.js";
+import { errorFromWire, jsonPart, parsePart, } from "../link/internal.js";
+import { Replica } from "./replica.js";
+/**
+ * One remote reference's object, owned by its host across the links of its path. It is `loading` until a link's hold
+ * of it is bound, and again whenever that link drops or its relay's upstream starts over; each link holds it with its
+ * own id. Two references are two holds, each member of each with its own Delta decoder.
+ */
+export class RemoteObject {
+    kind = "remote";
+    /** The object in errors: its type, and its params key when it has params. */
+    label;
+    contract;
+    #host;
+    /** What its holds ask for: the params as a part (checked by L1 when the reference was made), the address. */
+    request;
+    /** Whom its reference acts for: named on route links (`actingFor`). */
+    caller;
+    /** Its params, for placing it anew (`retry` after a part past the limits). */
+    #params;
+    /** Its path: the parent's or a route address's; the host's `unplaced` one after a part past the limits. */
+    #path;
+    /** The object whose activation declared the reference (`self.get`): its holds carry its chain while it activates. */
+    #dependent;
+    #state = LOADING;
+    /** The last binding, kept while loading or failed: members keep their last values and watches. */
+    #bound;
+    /** The hold on the path's link while one is open: that link's consumer side and this hold's id on it. */
+    #hold;
+    #binding;
+    #lastFailure;
+    constructor(host, contract, { params, key }, address, caller, path, dependent) {
+        this.#host = host;
+        this.contract = contract;
+        this.label = key === "" ? contract.name : `${contract.name}(${key})`;
+        const { name: type, version, fingerprint } = contract;
+        this.request = {
+            type,
+            version,
+            fingerprint,
+            params: jsonPart(params),
+            address,
+        };
+        this.caller = caller;
+        this.#params = params;
+        this.#path = path;
+        this.#dependent = dependent;
+    }
+    get state() {
+        return this.#state;
+    }
+    /** An object over a link is no blocker of this host's first pass. */
+    get blocksFirstPass() {
+        return false;
+    }
+    /** The error of the last `failed`, until `bound`. */
+    get lastFailure() {
+        return this.#lastFailure;
+    }
+    /** The variant last bound; `undefined` before the first binding. */
+    get variant() {
+        return this.#bound?.variant;
+    }
+    /** Whether its state members have values: bound once. */
+    get hydrated() {
+        return this.#bound !== undefined;
+    }
+    /** Its one reference bound to it. */
+    hold(binding) {
+        this.#binding = binding;
+    }
+    /** The reference was released: the current link's provider is told and the reference's sent calls rejected. */
+    unhold(_binding) {
+        const error = new ChordError({ code: "released", message: `${this.label}: released` });
+        this.#hold?.side.release(this.#hold.id, error);
+        this.#end(error);
+    }
+    /**
+     * Holds on `link`, the path's link now (a first hold, or a re-hold on a new link), with the activation chain of its
+     * dependent while that activates (Q5).
+     */
+    attach(link) {
+        const chain = this.#dependent?.activationChain();
+        this.#hold = { side: link.consumer, id: link.consumer.attach(this, chain) };
+    }
+    /**
+     * Its path's address cannot be reached for now (a route's `resolve` failed, a suspension): `failed { waiting }` with
+     * `error`, still on the path, bound by its next link.
+     */
+    unreachable(error) {
+        this.#lastFailure = error;
+        if (this.#state.kind !== "ended")
+            this.#move({ kind: "failed", cause: { kind: "waiting", error }, retryAt: undefined });
+    }
+    /** The link dropped: loading until a new link's hold is bound (`#startOver`). */
+    dropped(_error) {
+        this.#hold = undefined;
+        this.#startOver();
+    }
+    /**
+     * Calls a method of the bound variant over the link; one outside it fails `invalid/member`. Only a live object is
+     * called: bound on an open link.
+     */
+    async call(method, args, context) {
+        const bound = this.#bound;
+        const hold = this.#hold;
+        const data = bound.methods.get(method);
+        if (data === undefined) {
+            throw invalid("member", `${this.label} (variant ${bound.variant}) has no method "${method}"`);
+        }
+        // Arguments are checked by the provider.
+        return hold.side.call(hold.id, bound.names.methods.indexOf(method), data, args, context);
+    }
+    /**
+     * The replica of `member`; `not_ready` before the first binding, `invalid/member` for a member no binding had (one
+     * a later variant lacks reads its `invalid/member` failure).
+     */
+    member(member) {
+        const bound = this.#bound;
+        if (bound === undefined)
+            throw new ChordError({ code: "not_ready", message: `${this.label}: not bound yet` });
+        const replica = bound.replicas.get(member);
+        if (replica === undefined) {
+            throw invalid("member", `${this.label} (variant ${bound.variant}) has no state member "${member}"`);
+        }
+        return replica;
+    }
+    /**
+     * What its reference follows of `member` (a consumer over a link binds at its own version, mapped at the provider):
+     * the replica while live, a member the bound variant lacks (`invalid/member`); while loading or failed nothing, the
+     * replica (kept until the next binding) giving its last value (rule 5).
+     */
+    followed(member, _version) {
+        const bound = this.#bound;
+        const replica = bound?.replicas.get(member);
+        const state = this.#state;
+        if (state.kind === "live") {
+            if (replica !== undefined)
+                return { kind: "live", source: replica, instance: bound };
+            const message = `${this.label} (variant ${bound?.variant}) has no state member "${member}"`;
+            return { kind: "lacking", error: invalid("member", message) };
+        }
+        if (state.kind === "failed")
+            return { kind: "failed", error: state.cause.error, last: replica, instance: bound };
+        return { kind: "loading", last: replica, instance: bound };
+    }
+    /** Its binding while live (its replicas change); `undefined` while loading or failed. */
+    get attachable() {
+        return this.#state.kind === "live" ? this.#bound : undefined;
+    }
+    /** Keyed members are only in local contracts: no instance to pin a key on. */
+    get instance() {
+        return undefined;
+    }
+    /** Keyed members are only in local contracts (`keyedMember`). */
+    keyedMapping(member) {
+        return this.keyedMember(member);
+    }
+    /** Keyed members are only in local contracts (`keyedMember`). */
+    async pinKey(member) {
+        return this.keyedMember(member);
+    }
+    /** Keyed members are only in local contracts, whose objects are never held over a link (slice 6a §12). */
+    keyedMember(member) {
+        throw invalid("member", `${this.label} has no keyed member "${member}": keyed members are local`);
+    }
+    /** An object over a link activates on another host: it is in no chain here (Q5). */
+    get activationId() {
+        return undefined;
+    }
+    /** An object over a link waits for nothing on this host: no chain of waits (its holds carry the chain, Q5). */
+    pathTo() {
+        return undefined;
+    }
+    /**
+     * `ref.retry()`, as a step of `walk`: a failed object's provider is asked for an attempt with the walk's hop budget,
+     * none left: nothing is sent (a hold it refused is started there again; a parked object there passes it on with one
+     * hop less). One that failed for a part past the link's limits is placed anew and held with a new id, now or on its
+     * path's next link (a `hostAddress` that throws fails it broken again).
+     */
+    retry(walk) {
+        if (this.#state.kind !== "failed")
+            return;
+        if (this.#path === this.#host.unplaced) {
+            this.#place();
+            return;
+        }
+        if (walk.hops > 0)
+            this.#hold?.side.retry(this.#hold.id, walk.hops);
+    }
+    /** Places a reference whose part was past the limits anew, on its path now (a throwing `hostAddress` fails it). */
+    #place() {
+        let path;
+        try {
+            path = this.#host.pathOf(this.contract, this.#params, this.caller.principal);
+        }
+        catch (error) {
+            this.#fail(asChordError(error, this.contract.name));
+            return;
+        }
+        this.#path.detach(this);
+        this.#path = path;
+        this.#move(LOADING);
+        path.attach(this);
+    }
+    /**
+     * A part of its snapshot or of a state change was past the link's limits (`too_large/part`): the hold is released
+     * at the provider, and the reference fails broken with `error`, final: no link holds it again (a reconnect
+     * included) until `retry`.
+     */
+    tooLarge(error) {
+        const hold = this.#hold;
+        if (hold === undefined)
+            return;
+        this.#hold = undefined;
+        hold.side.release(hold.id, error);
+        this.#path.detach(this);
+        this.#path = this.#host.unplaced;
+        this.#path.attach(this);
+        this.#fail(error);
+    }
+    /** Fails broken with `error`: no automatic retry. */
+    #fail(error) {
+        this.#lastFailure = error;
+        this.#move({ kind: "failed", cause: { kind: "broken", error }, retryAt: undefined });
+    }
+    /**
+     * Prepares one entry of a `bound` message (a first binding, a re-hold; a live hold is bound again): the
+     * variant and every state member once, as a value or as failed. Returns what applies it inside the batch of the
+     * whole message: a member it had gets the snapshot as one frame `[["r", value]]` and a fresh decoder, a member
+     * outside the new variant fails (its replica stays, for a later binding that has it again), a new one gets its first
+     * value. Throws on a snapshot that
+     * does not fit (a protocol error), and `too_large/part` for a value past the link's limits, before anything changed.
+     * `wentLive` follows the batch.
+     */
+    prepareBound(entry, link) {
+        const variant = variantOrder(this.contract)[entry.variant];
+        if (variant === undefined)
+            throw new Error(`hold ${entry.hold}: no variant ${entry.variant}`);
+        const data = currentVariants(this.contract).get(variant);
+        const names = variantNames(data);
+        const members = new Map();
+        const add = (index, state) => {
+            const member = names.state[index];
+            if (member === undefined || members.has(member))
+                throw new Error(`hold ${entry.hold}: member ${index} in bound`);
+            members.set(member, state);
+        };
+        // Fresh JSON from the link: state is JSON and never validated (§30).
+        for (const { member, value } of entry.members) {
+            add(member, { kind: "value", value: parsePart(link.openPart(value, link.limits, link.context)) });
+        }
+        for (const { member, error } of entry.failed)
+            add(member, { kind: "failed", error: errorFromWire(error) });
+        if (members.size !== names.state.length)
+            throw new Error(`hold ${entry.hold}: the snapshot misses a member`);
+        return () => {
+            const previous = this.#bound?.replicas;
+            const replicas = new Map();
+            // First: a derive recomputing in this batch reads the new variant through its reference.
+            this.#bound = { variant, methods: data.methods, names, replicas };
+            for (const [member, state] of members) {
+                const replica = previous?.get(member);
+                if (replica === undefined) {
+                    replicas.set(member, new Replica(this.#host.batch, state));
+                }
+                else {
+                    replica.reset(state);
+                    replicas.set(member, replica);
+                }
+            }
+            for (const [member, replica] of previous ?? []) {
+                if (members.has(member))
+                    continue;
+                replica.vanish(invalid("member", `${this.label} (variant ${variant}) has no state member "${member}"`));
+                replicas.set(member, replica);
+            }
+        };
+    }
+    /** After a `bound` message's batch: the reference goes live (its parked calls are sent, a parked dependent goes on). */
+    wentLive() {
+        this.#lastFailure = undefined;
+        this.#move(LIVE);
+    }
+    /**
+     * `failed`: the provider's object failed and no attempt runs (`retryIn`: the rest of its backoff window), or the hold
+     * is unbound there or its object parked on a failed dependency (`waiting`), each new cause a new message. On a bound
+     * hold it unbinds it (slice 7b, model §5): the members keep their last values until the next `bound`.
+     */
+    failed(message) {
+        // A plugin's error a provider failed with is this object's failure, as a ChordError.
+        const error = asChordError(errorFromWire(message.cause.error), this.label);
+        this.#lastFailure = error;
+        const retryAt = message.retryIn === undefined ? undefined : Date.now() + message.retryIn;
+        this.#move({ kind: "failed", cause: { kind: message.cause.kind, error }, retryAt });
+    }
+    /**
+     * `loading`: the provider's object started a new attempt after a failure, or its relay's upstream link dropped
+     * (`#startOver`).
+     */
+    loading() {
+        this.#startOver();
+    }
+    /**
+     * Decodes and applies one entry of a state message (its members by index, each with its ops), without changing
+     * anything yet: returns what adopts it into the replicas, run inside the batch that applies the whole message.
+     * Throws on an entry that does not fit (a protocol error), and `too_large/part` for ops past the link's limits.
+     */
+    prepare({ hold: id, members, failed, retired }, link) {
+        const bound = this.#bound;
+        if (this.#state.kind !== "live" || bound === undefined)
+            throw new Error(`hold ${id}: state before bound`);
+        const replica = (index) => {
+            const name = bound.names.state[index];
+            const found = name === undefined ? undefined : bound.replicas.get(name);
+            if (found === undefined)
+                throw new Error(`hold ${id}: no state member ${index}`);
+            return found;
+        };
+        // Made by the first retirement (rare): no allocation per message otherwise.
+        let retirements;
+        for (const member of retired) {
+            const target = replica(member);
+            retirements ??= new Set();
+            if (retirements.has(target))
+                throw new Error(`hold ${id}: member ${member} retired twice in one state`);
+            retirements.add(target);
+        }
+        const changed = new Set();
+        const updates = members.map(({ member, ops }) => {
+            const target = replica(member);
+            if (changed.has(target))
+                throw new Error(`hold ${id}: member ${member} twice in one state`);
+            changed.add(target);
+            return { target, ...target.decode(parsePart(link.openPart(ops, link.limits, link.context))) };
+        });
+        const failures = failed.map(({ member, error }) => ({ target: replica(member), error: errorFromWire(error) }));
+        return () => {
+            for (const { target, value, ops } of updates)
+                target.adopt(value, ops, retirements?.has(target) === true);
+            for (const { target, error } of failures)
+                target.fail(error);
+            // A retirement without ops (a derive whose value stayed, rule 21): the flag alone, after the failures (a
+            // failed member keeps it for its next value).
+            if (retirements !== undefined) {
+                for (const target of retirements)
+                    if (!changed.has(target))
+                        target.retireAlone();
+            }
+        };
+    }
+    /**
+     * Its principal was revoked on this host (`host.revoke`): released at its provider if it is held there, then ended
+     * with `error` as `lost` does; no later link holds it.
+     */
+    revoke(error) {
+        const hold = this.#hold;
+        this.#hold = undefined;
+        hold?.side.release(hold.id, error);
+        this.lost(error);
+    }
+    /** `gone`, or the host closes: the reference ends, its calls reject with `error`. */
+    lost(error) {
+        const binding = this.#binding;
+        this.#hold?.side.forget(this.#hold.id, error);
+        this.#end(error);
+        binding?.end(error);
+    }
+    /** Ends the object: detached from its path, waits rejected, replicas ended; keeps nothing of its reference. */
+    #end(error) {
+        const bound = this.#bound;
+        this.#state = { kind: "ended", error };
+        this.#binding = undefined;
+        this.#dependent = undefined;
+        this.#hold = undefined;
+        this.#bound = undefined;
+        this.#path.detach(this);
+        for (const replica of bound?.replicas.values() ?? [])
+            replica.end(error);
+    }
+    /**
+     * Loading again until the next binding; the members keep their last values. A drop while it is loading already
+     * changes nothing: a dependent parked on it goes on waiting for the next link's binding (a drop is not a dependency
+     * failure).
+     */
+    #startOver() {
+        const { kind } = this.#state;
+        if (kind !== "ended" && kind !== "loading")
+            this.#move(LOADING);
+    }
+    /** Moves to `state` and tells the reference: its members follow what it shows now (in a batch), then its state. */
+    #move(state) {
+        this.#state = state;
+        const binding = this.#binding;
+        if (binding === undefined)
+            return;
+        if (binding.following)
+            this.#host.batch.within(() => binding.retarget(), BACKGROUND_CONTEXT);
+        else
+            binding.retarget();
+        binding.moved();
+    }
+}
+//# sourceMappingURL=remote-object.js.map

package/dist/next/remote/remote-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-object.js","sourceRoot":"","sources":["../../../src/next/remote/remote-object.ts"],"names":[],"mappings":"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","sourcesContent":["// An object held over a link (§7): what one remote reference is bound to on the consumer, across the links of its path\n// (the parent, or a route address). Its state, the replicas of its last bound variant (kept while its link is down),\n// its hold on the path's current link and calls through it.\n\nimport { BACKGROUND_CONTEXT, type Context } from \"../../context/index.ts\";\nimport type { JsonValue } from \"../../json.ts\";\nimport type { Contract, ParamsOf } from \"../contracts/index.ts\";\nimport {\n\tcurrentVariants,\n\ttype MethodData,\n\ttype VariantNames,\n\tvariantNames,\n\tvariantOrder,\n} from \"../contracts/internal.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { asChordError, invalid } from \"../data/internal.ts\";\nimport {\n\ttype AnyHost,\n\ttype Attachable,\n\ttype Binding,\n\ttype Caller,\n\ttype CheckedParams,\n\ttype ChordObject,\n\ttype Followed,\n\tLIVE,\n\tLOADING,\n\ttype PinnedKey,\n\ttype RefState,\n\ttype RetryWalk,\n\ttype Target,\n} from \"../host/internal.ts\";\nimport {\n\ttype BoundEntry,\n\terrorFromWire,\n\tjsonPart,\n\ttype Message,\n\tparsePart,\n\ttype StateEntry,\n\ttype WireAddress,\n} from \"../link/internal.ts\";\nimport type { DeriveSource } from \"../state/internal.ts\";\nimport type { ConsumerSide } from \"./consumer.ts\";\nimport type { HoldRequest } from \"./hold.ts\";\nimport type { HostLink } from \"./host-link.ts\";\nimport type { Path } from \"./path.ts\";\nimport { type MemberSnapshot, Replica } from \"./replica.ts\";\n\n/** The last binding: its variant, methods, the bound version's names (the wire's indexes) and a replica per member. */\ntype Bound = {\n\treadonly variant: string;\n\treadonly methods: ReadonlyMap<string, MethodData>;\n\treadonly names: VariantNames;\n\treadonly replicas: ReadonlyMap<string, Replica>;\n};\n\n/**\n * One remote reference's object, owned by its host across the links of its path. It is `loading` until a link's hold\n * of it is bound, and again whenever that link drops or its relay's upstream starts over; each link holds it with its\n * own id. Two references are two holds, each member of each with its own Delta decoder.\n */\nexport class RemoteObject implements Target {\n\treadonly kind = \"remote\";\n\t/** The object in errors: its type, and its params key when it has params. */\n\treadonly label: string;\n\treadonly contract: Contract;\n\treadonly #host: AnyHost;\n\t/** What its holds ask for: the params as a part (checked by L1 when the reference was made), the address. */\n\treadonly request: HoldRequest;\n\t/** Whom its reference acts for: named on route links (`actingFor`). */\n\treadonly caller: Caller;\n\t/** Its params, for placing it anew (`retry` after a part past the limits). */\n\treadonly #params: ParamsOf<Contract>;\n\t/** Its path: the parent's or a route address's; the host's `unplaced` one after a part past the limits. */\n\t#path: Path;\n\t/** The object whose activation declared the reference (`self.get`): its holds carry its chain while it activates. */\n\t#dependent: ChordObject | undefined;\n\t#state: RefState = LOADING;\n\t/** The last binding, kept while loading or failed: members keep their last values and watches. */\n\t#bound: Bound | undefined;\n\t/** The hold on the path's link while one is open: that link's consumer side and this hold's id on it. */\n\t#hold: { readonly side: ConsumerSide; readonly id: number } | undefined;\n\t#binding: Binding | undefined;\n\t#lastFailure: ChordError | undefined;\n\n\tconstructor(\n\t\thost: AnyHost,\n\t\tcontract: Contract,\n\t\t{ params, key }: CheckedParams,\n\t\taddress: WireAddress,\n\t\tcaller: Caller,\n\t\tpath: Path,\n\t\tdependent: ChordObject | undefined,\n\t) {\n\t\tthis.#host = host;\n\t\tthis.contract = contract;\n\t\tthis.label = key === \"\" ? contract.name : `${contract.name}(${key})`;\n\t\tconst { name: type, version, fingerprint } = contract;\n\t\tthis.request = {\n\t\t\ttype,\n\t\t\tversion,\n\t\t\tfingerprint,\n\t\t\tparams: jsonPart(params),\n\t\t\taddress,\n\t\t};\n\t\tthis.caller = caller;\n\t\tthis.#params = params;\n\t\tthis.#path = path;\n\t\tthis.#dependent = dependent;\n\t}\n\n\tget state(): RefState {\n\t\treturn this.#state;\n\t}\n\n\t/** An object over a link is no blocker of this host's first pass. */\n\tget blocksFirstPass(): false {\n\t\treturn false;\n\t}\n\n\t/** The error of the last `failed`, until `bound`. */\n\tget lastFailure(): ChordError | undefined {\n\t\treturn this.#lastFailure;\n\t}\n\n\t/** The variant last bound; `undefined` before the first binding. */\n\tget variant(): string | undefined {\n\t\treturn this.#bound?.variant;\n\t}\n\n\t/** Whether its state members have values: bound once. */\n\tget hydrated(): boolean {\n\t\treturn this.#bound !== undefined;\n\t}\n\n\t/** Its one reference bound to it. */\n\thold(binding: Binding): void {\n\t\tthis.#binding = binding;\n\t}\n\n\t/** The reference was released: the current link's provider is told and the reference's sent calls rejected. */\n\tunhold(_binding: Binding): void {\n\t\tconst error = new ChordError({ code: \"released\", message: `${this.label}: released` });\n\t\tthis.#hold?.side.release(this.#hold.id, error);\n\t\tthis.#end(error);\n\t}\n\n\t/**\n\t * Holds on `link`, the path's link now (a first hold, or a re-hold on a new link), with the activation chain of its\n\t * dependent while that activates (Q5).\n\t */\n\tattach(link: HostLink): void {\n\t\tconst chain = this.#dependent?.activationChain();\n\t\tthis.#hold = { side: link.consumer, id: link.consumer.attach(this, chain) };\n\t}\n\n\t/**\n\t * Its path's address cannot be reached for now (a route's `resolve` failed, a suspension): `failed { waiting }` with\n\t * `error`, still on the path, bound by its next link.\n\t */\n\tunreachable(error: ChordError): void {\n\t\tthis.#lastFailure = error;\n\t\tif (this.#state.kind !== \"ended\")\n\t\t\tthis.#move({ kind: \"failed\", cause: { kind: \"waiting\", error }, retryAt: undefined });\n\t}\n\n\t/** The link dropped: loading until a new link's hold is bound (`#startOver`). */\n\tdropped(_error: ChordError): void {\n\t\tthis.#hold = undefined;\n\t\tthis.#startOver();\n\t}\n\n\t/**\n\t * Calls a method of the bound variant over the link; one outside it fails `invalid/member`. Only a live object is\n\t * called: bound on an open link.\n\t */\n\tasync call(method: string, args: unknown, context: Context): Promise<unknown> {\n\t\tconst bound = this.#bound!;\n\t\tconst hold = this.#hold!;\n\t\tconst data = bound.methods.get(method);\n\t\tif (data === undefined) {\n\t\t\tthrow invalid(\"member\", `${this.label} (variant ${bound.variant}) has no method \"${method}\"`);\n\t\t}\n\t\t// Arguments are checked by the provider.\n\t\treturn hold.side.call(hold.id, bound.names.methods.indexOf(method), data, args, context);\n\t}\n\n\t/**\n\t * The replica of `member`; `not_ready` before the first binding, `invalid/member` for a member no binding had (one\n\t * a later variant lacks reads its `invalid/member` failure).\n\t */\n\tmember(member: string): DeriveSource {\n\t\tconst bound = this.#bound;\n\t\tif (bound === undefined) throw new ChordError({ code: \"not_ready\", message: `${this.label}: not bound yet` });\n\t\tconst replica = bound.replicas.get(member);\n\t\tif (replica === undefined) {\n\t\t\tthrow invalid(\"member\", `${this.label} (variant ${bound.variant}) has no state member \"${member}\"`);\n\t\t}\n\t\treturn replica;\n\t}\n\n\t/**\n\t * What its reference follows of `member` (a consumer over a link binds at its own version, mapped at the provider):\n\t * the replica while live, a member the bound variant lacks (`invalid/member`); while loading or failed nothing, the\n\t * replica (kept until the next binding) giving its last value (rule 5).\n\t */\n\tfollowed(member: string, _version: number): Followed {\n\t\tconst bound = this.#bound;\n\t\tconst replica = bound?.replicas.get(member);\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"live\") {\n\t\t\tif (replica !== undefined) return { kind: \"live\", source: replica, instance: bound };\n\t\t\tconst message = `${this.label} (variant ${bound?.variant}) has no state member \"${member}\"`;\n\t\t\treturn { kind: \"lacking\", error: invalid(\"member\", message) };\n\t\t}\n\t\tif (state.kind === \"failed\") return { kind: \"failed\", error: state.cause.error, last: replica, instance: bound };\n\t\treturn { kind: \"loading\", last: replica, instance: bound };\n\t}\n\n\t/** Its binding while live (its replicas change); `undefined` while loading or failed. */\n\tget attachable(): Attachable | undefined {\n\t\treturn this.#state.kind === \"live\" ? this.#bound : undefined;\n\t}\n\n\t/** Keyed members are only in local contracts: no instance to pin a key on. */\n\tget instance(): undefined {\n\t\treturn undefined;\n\t}\n\n\t/** Keyed members are only in local contracts (`keyedMember`). */\n\tkeyedMapping(member: string): never {\n\t\treturn this.keyedMember(member);\n\t}\n\n\t/** Keyed members are only in local contracts (`keyedMember`). */\n\tasync pinKey(member: string): Promise<PinnedKey> {\n\t\treturn this.keyedMember(member);\n\t}\n\n\t/** Keyed members are only in local contracts, whose objects are never held over a link (slice 6a §12). */\n\tkeyedMember(member: string): never {\n\t\tthrow invalid(\"member\", `${this.label} has no keyed member \"${member}\": keyed members are local`);\n\t}\n\n\t/** An object over a link activates on another host: it is in no chain here (Q5). */\n\tget activationId(): undefined {\n\t\treturn undefined;\n\t}\n\n\t/** An object over a link waits for nothing on this host: no chain of waits (its holds carry the chain, Q5). */\n\tpathTo(): undefined {\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * `ref.retry()`, as a step of `walk`: a failed object's provider is asked for an attempt with the walk's hop budget,\n\t * none left: nothing is sent (a hold it refused is started there again; a parked object there passes it on with one\n\t * hop less). One that failed for a part past the link's limits is placed anew and held with a new id, now or on its\n\t * path's next link (a `hostAddress` that throws fails it broken again).\n\t */\n\tretry(walk: RetryWalk): void {\n\t\tif (this.#state.kind !== \"failed\") return;\n\t\tif (this.#path === this.#host.unplaced) {\n\t\t\tthis.#place();\n\t\t\treturn;\n\t\t}\n\t\tif (walk.hops > 0) this.#hold?.side.retry(this.#hold.id, walk.hops);\n\t}\n\n\t/** Places a reference whose part was past the limits anew, on its path now (a throwing `hostAddress` fails it). */\n\t#place(): void {\n\t\tlet path: Path;\n\t\ttry {\n\t\t\tpath = this.#host.pathOf(this.contract, this.#params, this.caller.principal);\n\t\t} catch (error) {\n\t\t\tthis.#fail(asChordError(error, this.contract.name));\n\t\t\treturn;\n\t\t}\n\t\tthis.#path.detach(this);\n\t\tthis.#path = path;\n\t\tthis.#move(LOADING);\n\t\tpath.attach(this);\n\t}\n\n\t/**\n\t * A part of its snapshot or of a state change was past the link's limits (`too_large/part`): the hold is released\n\t * at the provider, and the reference fails broken with `error`, final: no link holds it again (a reconnect\n\t * included) until `retry`.\n\t */\n\ttooLarge(error: ChordError): void {\n\t\tconst hold = this.#hold;\n\t\tif (hold === undefined) return;\n\t\tthis.#hold = undefined;\n\t\thold.side.release(hold.id, error);\n\t\tthis.#path.detach(this);\n\t\tthis.#path = this.#host.unplaced;\n\t\tthis.#path.attach(this);\n\t\tthis.#fail(error);\n\t}\n\n\t/** Fails broken with `error`: no automatic retry. */\n\t#fail(error: ChordError): void {\n\t\tthis.#lastFailure = error;\n\t\tthis.#move({ kind: \"failed\", cause: { kind: \"broken\", error }, retryAt: undefined });\n\t}\n\n\t/**\n\t * Prepares one entry of a `bound` message (a first binding, a re-hold; a live hold is bound again): the\n\t * variant and every state member once, as a value or as failed. Returns what applies it inside the batch of the\n\t * whole message: a member it had gets the snapshot as one frame `[[\"r\", value]]` and a fresh decoder, a member\n\t * outside the new variant fails (its replica stays, for a later binding that has it again), a new one gets its first\n\t * value. Throws on a snapshot that\n\t * does not fit (a protocol error), and `too_large/part` for a value past the link's limits, before anything changed.\n\t * `wentLive` follows the batch.\n\t */\n\tprepareBound(entry: BoundEntry, link: HostLink): () => void {\n\t\tconst variant = variantOrder(this.contract)[entry.variant];\n\t\tif (variant === undefined) throw new Error(`hold ${entry.hold}: no variant ${entry.variant}`);\n\t\tconst data = currentVariants(this.contract).get(variant)!;\n\t\tconst names = variantNames(data);\n\t\tconst members = new Map<string, MemberSnapshot>();\n\t\tconst add = (index: number, state: MemberSnapshot): void => {\n\t\t\tconst member = names.state[index];\n\t\t\tif (member === undefined || members.has(member))\n\t\t\t\tthrow new Error(`hold ${entry.hold}: member ${index} in bound`);\n\t\t\tmembers.set(member, state);\n\t\t};\n\t\t// Fresh JSON from the link: state is JSON and never validated (§30).\n\t\tfor (const { member, value } of entry.members) {\n\t\t\tadd(member, { kind: \"value\", value: parsePart(link.openPart(value, link.limits, link.context)) as JsonValue });\n\t\t}\n\t\tfor (const { member, error } of entry.failed) add(member, { kind: \"failed\", error: errorFromWire(error) });\n\t\tif (members.size !== names.state.length) throw new Error(`hold ${entry.hold}: the snapshot misses a member`);\n\t\treturn () => {\n\t\t\tconst previous = this.#bound?.replicas;\n\t\t\tconst replicas = new Map<string, Replica>();\n\t\t\t// First: a derive recomputing in this batch reads the new variant through its reference.\n\t\t\tthis.#bound = { variant, methods: data.methods, names, replicas };\n\t\t\tfor (const [member, state] of members) {\n\t\t\t\tconst replica = previous?.get(member);\n\t\t\t\tif (replica === undefined) {\n\t\t\t\t\treplicas.set(member, new Replica(this.#host.batch, state));\n\t\t\t\t} else {\n\t\t\t\t\treplica.reset(state);\n\t\t\t\t\treplicas.set(member, replica);\n\t\t\t\t}\n\t\t\t}\n\t\t\tfor (const [member, replica] of previous ?? []) {\n\t\t\t\tif (members.has(member)) continue;\n\t\t\t\treplica.vanish(invalid(\"member\", `${this.label} (variant ${variant}) has no state member \"${member}\"`));\n\t\t\t\treplicas.set(member, replica);\n\t\t\t}\n\t\t};\n\t}\n\n\t/** After a `bound` message's batch: the reference goes live (its parked calls are sent, a parked dependent goes on). */\n\twentLive(): void {\n\t\tthis.#lastFailure = undefined;\n\t\tthis.#move(LIVE);\n\t}\n\n\t/**\n\t * `failed`: the provider's object failed and no attempt runs (`retryIn`: the rest of its backoff window), or the hold\n\t * is unbound there or its object parked on a failed dependency (`waiting`), each new cause a new message. On a bound\n\t * hold it unbinds it (slice 7b, model §5): the members keep their last values until the next `bound`.\n\t */\n\tfailed(message: Extract<Message, { readonly kind: \"failed\" }>): void {\n\t\t// A plugin's error a provider failed with is this object's failure, as a ChordError.\n\t\tconst error = asChordError(errorFromWire(message.cause.error), this.label);\n\t\tthis.#lastFailure = error;\n\t\tconst retryAt = message.retryIn === undefined ? undefined : Date.now() + message.retryIn;\n\t\tthis.#move({ kind: \"failed\", cause: { kind: message.cause.kind, error }, retryAt });\n\t}\n\n\t/**\n\t * `loading`: the provider's object started a new attempt after a failure, or its relay's upstream link dropped\n\t * (`#startOver`).\n\t */\n\tloading(): void {\n\t\tthis.#startOver();\n\t}\n\n\t/**\n\t * Decodes and applies one entry of a state message (its members by index, each with its ops), without changing\n\t * anything yet: returns what adopts it into the replicas, run inside the batch that applies the whole message.\n\t * Throws on an entry that does not fit (a protocol error), and `too_large/part` for ops past the link's limits.\n\t */\n\tprepare({ hold: id, members, failed, retired }: StateEntry, link: HostLink): () => void {\n\t\tconst bound = this.#bound;\n\t\tif (this.#state.kind !== \"live\" || bound === undefined) throw new Error(`hold ${id}: state before bound`);\n\t\tconst replica = (index: number): Replica => {\n\t\t\tconst name = bound.names.state[index];\n\t\t\tconst found = name === undefined ? undefined : bound.replicas.get(name);\n\t\t\tif (found === undefined) throw new Error(`hold ${id}: no state member ${index}`);\n\t\t\treturn found;\n\t\t};\n\t\t// Made by the first retirement (rare): no allocation per message otherwise.\n\t\tlet retirements: Set<Replica> | undefined;\n\t\tfor (const member of retired) {\n\t\t\tconst target = replica(member);\n\t\t\tretirements ??= new Set();\n\t\t\tif (retirements.has(target)) throw new Error(`hold ${id}: member ${member} retired twice in one state`);\n\t\t\tretirements.add(target);\n\t\t}\n\t\tconst changed = new Set<Replica>();\n\t\tconst updates = members.map(({ member, ops }) => {\n\t\t\tconst target = replica(member);\n\t\t\tif (changed.has(target)) throw new Error(`hold ${id}: member ${member} twice in one state`);\n\t\t\tchanged.add(target);\n\t\t\treturn { target, ...target.decode(parsePart(link.openPart(ops, link.limits, link.context))) };\n\t\t});\n\t\tconst failures = failed.map(({ member, error }) => ({ target: replica(member), error: errorFromWire(error) }));\n\t\treturn () => {\n\t\t\tfor (const { target, value, ops } of updates) target.adopt(value, ops, retirements?.has(target) === true);\n\t\t\tfor (const { target, error } of failures) target.fail(error);\n\t\t\t// A retirement without ops (a derive whose value stayed, rule 21): the flag alone, after the failures (a\n\t\t\t// failed member keeps it for its next value).\n\t\t\tif (retirements !== undefined) {\n\t\t\t\tfor (const target of retirements) if (!changed.has(target)) target.retireAlone();\n\t\t\t}\n\t\t};\n\t}\n\n\t/**\n\t * Its principal was revoked on this host (`host.revoke`): released at its provider if it is held there, then ended\n\t * with `error` as `lost` does; no later link holds it.\n\t */\n\trevoke(error: ChordError): void {\n\t\tconst hold = this.#hold;\n\t\tthis.#hold = undefined;\n\t\thold?.side.release(hold.id, error);\n\t\tthis.lost(error);\n\t}\n\n\t/** `gone`, or the host closes: the reference ends, its calls reject with `error`. */\n\tlost(error: ChordError): void {\n\t\tconst binding = this.#binding;\n\t\tthis.#hold?.side.forget(this.#hold.id, error);\n\t\tthis.#end(error);\n\t\tbinding?.end(error);\n\t}\n\n\t/** Ends the object: detached from its path, waits rejected, replicas ended; keeps nothing of its reference. */\n\t#end(error: ChordError): void {\n\t\tconst bound = this.#bound;\n\t\tthis.#state = { kind: \"ended\", error };\n\t\tthis.#binding = undefined;\n\t\tthis.#dependent = undefined;\n\t\tthis.#hold = undefined;\n\t\tthis.#bound = undefined;\n\t\tthis.#path.detach(this);\n\t\tfor (const replica of bound?.replicas.values() ?? []) replica.end(error);\n\t}\n\n\t/**\n\t * Loading again until the next binding; the members keep their last values. A drop while it is loading already\n\t * changes nothing: a dependent parked on it goes on waiting for the next link's binding (a drop is not a dependency\n\t * failure).\n\t */\n\t#startOver(): void {\n\t\tconst { kind } = this.#state;\n\t\tif (kind !== \"ended\" && kind !== \"loading\") this.#move(LOADING);\n\t}\n\n\t/** Moves to `state` and tells the reference: its members follow what it shows now (in a batch), then its state. */\n\t#move(state: RefState): void {\n\t\tthis.#state = state;\n\t\tconst binding = this.#binding;\n\t\tif (binding === undefined) return;\n\t\tif (binding.following) this.#host.batch.within(() => binding.retarget(), BACKGROUND_CONTEXT);\n\t\telse binding.retarget();\n\t\tbinding.moved();\n\t}\n}\n"]}

package/dist/next/remote/replica.d.ts

@@ -0,0 +1,59 @@
+import type { Context } from "../../context/index.ts";
+import { type Op } from "../../delta/index.ts";
+import type { JsonValue } from "../../json.ts";
+import type { ChordError } from "../data/index.ts";
+import { type Batch, Source, type WatchStart } from "../state/internal.ts";
+/** A member as a snapshot has it: a value, or failed. */
+export type MemberSnapshot = {
+    readonly kind: "value";
+    readonly value: JsonValue;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/** One state member of a hold, as the consumer reads and watches it; changed only inside the consumer's batch. */
+export declare class Replica extends Source {
+    #private;
+    constructor(batch: Batch, state: MemberSnapshot);
+    get value(): JsonValue;
+    /** Its value, or while failed its failure and last good value. */
+    start(): WatchStart;
+    /**
+     * The value `wire` (this member's wire ops from one state part) makes, and its ops; changes nothing yet. Throws on
+     * ops that do not fit (a protocol error): an ended member's, and a failed member's other than its recovery, which
+     * the provider sends as `[["r", value]]`.
+     */
+    decode(wire: unknown): {
+        readonly value: JsonValue;
+        readonly ops: readonly Op[];
+    };
+    /**
+     * Adopts the member's new value, the ops that made it and whether the provider's document was retired, in the
+     * current batch (one adoption per member and batch).
+     */
+    adopt(value: JsonValue, ops: readonly Op[], retired: boolean): void;
+    /**
+     * The provider's document was retired with no ops for this member (a derive whose value stayed, rule 21), in the
+     * current batch: the flag alone; while failed it waits for the next value (a failed member's value is never read).
+     */
+    retireAlone(): void;
+    /**
+     * A re-hold's snapshot of the member, in the batch that applies it, with a fresh decoder (the provider's encoder
+     * starts anew with it): a value is one frame `[["r", value]]`, a failed member fails.
+     */
+    reset(state: MemberSnapshot): void;
+    /**
+     * The provider's member failed, in the batch that applies it: reads throw `error`, watches get one failure call and
+     * stay open, derives over it fail; its recovery is `[["r", value]]`.
+     */
+    fail(error: unknown): void;
+    deliver(context: Context): void;
+    /**
+     * The member is not in a newly bound variant, in the batch that binds it: as a failure (`fail`) with `error`; a later
+     * binding of a variant that has it brings it back (`reset`), as on the provider's host.
+     */
+    vanish(error: ChordError): void;
+    /** Its reference ended (outside a batch): reads throw `error`, watches end `ended`. */
+    end(error: ChordError): void;
+}
+//# sourceMappingURL=replica.d.ts.map

package/dist/next/remote/replica.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replica.d.ts","sourceRoot":"","sources":["../../../src/next/remote/replica.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAA2B,KAAK,EAAE,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAYtF,yDAAyD;AACzD,MAAM,MAAM,cAAc,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAIxD,kHAAkH;AAClH,qBAAa,OAAQ,SAAQ,MAAM;;IAUlC,YAAY,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAG9C;IAED,IAAI,KAAK,IAAI,SAAS,CAIrB;IAED,kEAAkE;IAClE,KAAK,IAAI,UAAU,CAIlB;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAA;KAAE,CAShF;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAQlE;IAED;;;OAGG;IACH,WAAW,IAAI,IAAI,CAIlB;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAIjC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAMzB;IAED,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO9B;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAE9B;IAED,uFAAuF;IACvF,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAG3B;CACD"}