@earendil-works/chord 1.4.0 → 1.5.1

package/dist/cluster.js

@@ -1,230 +0,0 @@
-import { ChordError } from "./errors.js";
-import { beginReload, endReload, reloadError } from "./reload.js";
-import { toWireError } from "./wire.js";
-// Cross-host reload, coordinated by the server (the host without a parent):
-//   server: prepare itself and send `prepare` to every synced child host; collect votes
-//   all ok: the server installs its new code version, sends `commit` to every child, and only then starts what may make
-// new-code-version calls (tasks, listener and registry callbacks). Links are FIFO, so a child commits before it
-//           can receive any frame of a root started in the new code version.
-//   any failure or missed vote deadline: `abort` everywhere; each host rolls back to where it was.
-// Clients (browsers) are not participants: they see shape/reset pushes, or `upgrade_required`.
-// A child that connects behind the server's code version is fenced and reconciled with the same protocol.
-let reloadSeq = 0;
-const modulesFor = (remote, hostName) => {
-    let best;
-    for (const entry of Object.entries(remote ?? {})) {
-        if (hostName?.startsWith(entry[0]) && (best === undefined || entry[0].length > best[0].length))
-            best = entry;
-    }
-    return [...(best?.[1] ?? [])];
-};
-/** A vote, or its rejection after `deadline` milliseconds. */
-function awaitVote(connection, id, deadline) {
-    let timer;
-    const vote = new Promise((resolve, reject) => {
-        connection.votes.set(id, { resolve, reject });
-        timer = setTimeout(() => {
-            connection.votes.delete(id);
-            reject(new ChordError("aborted", `votes missing after ${deadline} ms`, { reason: "vote_deadline" }));
-        }, deadline);
-    });
-    return vote.finally(() => clearTimeout(timer));
-}
-export async function runClusterReload(host, plugins, options) {
-    // Participants are the children in step now. Fenced children (behind, being reconciled) reconcile to the new code
-    // version afterwards; a child whose hello arrives while the reload runs is synced or reconciled once it ends
-    // (`HostImpl.peerHello`).
-    const synced = [...host.connections].filter((connection) => connection.role === "downstream" && connection.peer.kind === "host" && connection.open && connection.synced);
-    const codeVersion = host.peekNextCodeVersion();
-    const reload = await beginReload(host, plugins, options, codeVersion);
-    try {
-        // Retire first: its `retire` frames reach every child before `prepare` (FIFO), so a child never retires a code
-        // version this host still runs roots of.
-        await reload.waitForRetirement();
-        const participants = synced.filter((connection) => connection.open);
-        const id = ++reloadSeq;
-        const deadline = options.voteDeadline ?? (options.gateDeadline ?? 5000) + (options.retireDeadline ?? 5000) + 5000;
-        const votes = participants.map((connection) => {
-            const name = connection.name ?? "child";
-            const vote = awaitVote(connection, id, deadline);
-            connection.send({
-                t: "prepare",
-                reload: id,
-                codeVersion,
-                plugins: modulesFor(options.remote, name),
-                options: {
-                    remove: modulesFor(options.remoteRemove, name),
-                    gateDeadline: options.gateDeadline,
-                    retireDeadline: options.retireDeadline,
-                },
-            });
-            return vote.then((report) => [name, report], (error) => {
-                const cause = reloadError(error);
-                throw new ChordError(cause.code, `${name}: ${cause.message}`, { cause, reason: cause.reason });
-            });
-        });
-        let local = false;
-        const results = await Promise.allSettled([
-            reload.prepare().then(() => {
-                local = true;
-            }),
-            ...votes,
-        ]);
-        const failed = results.find((result) => result.status === "rejected");
-        if (failed !== undefined) {
-            for (const connection of participants) {
-                connection.votes.delete(id);
-                connection.send({ t: "abort", reload: id });
-            }
-            if (local)
-                await reload.rollback();
-            throw failed.reason;
-        }
-        const report = reload.commit(() => {
-            for (const connection of participants) {
-                connection.send({ t: "commit", reload: id });
-                connection.peerCodeVersion = codeVersion;
-            }
-        });
-        host.rememberRemoteModules(options.remote, options.remoteRemove);
-        const children = {};
-        for (const result of results.slice(1)) {
-            if (result.status !== "fulfilled")
-                continue;
-            const [name, child] = result.value;
-            if (child !== undefined)
-                children[name] = child;
-        }
-        return { ...report, children };
-    }
-    finally {
-        endReload(host);
-    }
-}
-/**
- * Brings a child that connected behind this host's code version up to it: a reload of the child's modules (the ones
- * cluster reloads gave its name) to this host's current code version, prepared, voted and committed like a cluster
- * reload. Until then the child is fenced: nothing is routed to it. The child's old code is never relabeled as a newer
- * code version.
- */
-export async function reconcileChild(host, connection) {
-    for (;;) {
-        if (!connection.open)
-            return;
-        // Not during a reload of this host: the child is not one of its participants, so whatever it would be synced to
-        // now may be superseded by that reload's commit. Recheck once it ended.
-        if (host.reloading) {
-            await host.whenReloadEnded();
-            continue;
-        }
-        const codeVersion = host.current.id;
-        if (connection.peerCodeVersion === codeVersion) {
-            connection.markSynced(codeVersion);
-            host.announceRetired(connection);
-            return;
-        }
-        // Before `prepare`: the child's prepare first retires its previous code version, which waits for this permission.
-        host.announceRetired(connection);
-        const id = ++reloadSeq;
-        const vote = awaitVote(connection, id, 30_000);
-        connection.send({
-            t: "prepare",
-            reload: id,
-            codeVersion,
-            plugins: modulesFor(host.remoteModules, connection.name),
-            options: { remove: modulesFor(host.remoteRemoved, connection.name) },
-        });
-        await vote;
-        if (host.current.id !== codeVersion) {
-            // This host moved on meanwhile: abort and try again with the newer code version.
-            connection.send({ t: "abort", reload: id });
-            continue;
-        }
-        connection.send({ t: "commit", reload: id });
-        connection.peerCodeVersion = codeVersion;
-    }
-}
-/**
- * The child side: prepare and vote, then wait for the server's commit or abort. An abort or a lost parent link can
- * arrive at any point: while loading modules, while preparing (pending opens close themselves when they complete),
- * or after the vote. The operation is unwound once its pending work settles, and the reload slot is freed.
- */
-export class ChildReloads {
-    #host;
-    #operation;
-    constructor(host) {
-        this.#host = host;
-    }
-    handle(connection, frame) {
-        if (frame.t === "prepare") {
-            if (this.#operation !== undefined) {
-                const error = new ChordError("unavailable", "a reload is already running", { reason: "reload_running" });
-                connection.send({ t: "vote", reload: frame.reload, error: toWireError(error) });
-                return;
-            }
-            const operation = { id: frame.reload, reload: undefined, state: "loading", cancelled: false };
-            this.#operation = operation;
-            this.#run(operation, connection, frame).catch((error) => this.#host.report(error));
-            return;
-        }
-        const operation = this.#operation;
-        if (operation === undefined || operation.id !== frame.reload)
-            return;
-        if (frame.t === "abort") {
-            this.#cancel(operation);
-            return;
-        }
-        if (operation.state !== "prepared")
-            return;
-        this.#operation = undefined;
-        try {
-            operation.reload?.commit();
-        }
-        finally {
-            endReload(this.#host);
-        }
-    }
-    /** The parent link died: nobody will commit, so roll back (now, or once pending work settles). */
-    parentLost() {
-        if (this.#operation !== undefined)
-            this.#cancel(this.#operation);
-    }
-    #cancel(operation) {
-        operation.cancelled = true;
-        if (operation.state !== "prepared") {
-            // Loading or preparing: make prepare fail now; #run unwinds when it settles.
-            operation.reload?.rollback().catch((error) => this.#host.report(error));
-            return;
-        }
-        this.#operation = undefined;
-        operation.reload
-            ?.rollback()
-            .catch((error) => this.#host.report(error))
-            .finally(() => endReload(this.#host));
-    }
-    async #run(operation, connection, frame) {
-        const cancelled = () => new ChordError("aborted", "reload aborted by the server", { reason: "aborted" });
-        try {
-            operation.reload = await beginReload(this.#host, frame.plugins, frame.options, frame.codeVersion);
-            if (operation.cancelled)
-                throw cancelled();
-            operation.state = "preparing";
-            await operation.reload.prepare();
-            if (operation.cancelled)
-                throw cancelled();
-            operation.state = "prepared";
-            connection.send({ t: "vote", reload: frame.reload, report: operation.reload.summary() });
-        }
-        catch (error) {
-            if (operation.reload !== undefined) {
-                await operation.reload.rollback().catch((cleanup) => this.#host.report(cleanup));
-                endReload(this.#host);
-            }
-            if (this.#operation === operation)
-                this.#operation = undefined;
-            if (!operation.cancelled)
-                connection.send({ t: "vote", reload: frame.reload, error: toWireError(error) });
-        }
-    }
-}
-//# sourceMappingURL=cluster.js.map

package/dist/cluster.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../src/cluster.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAsD,WAAW,EAAE,MAAM,aAAa,CAAC;AACtH,OAAO,EAAc,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD,4EAA4E;AAC5E,wFAAwF;AACxF,wHAAwH;AACxH,gHAAgH;AAChH,6EAA6E;AAC7E,mGAAmG;AACnG,+FAA+F;AAC/F,0GAA0G;AAE1G,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB,MAAM,UAAU,GAAG,CAAC,MAA+B,EAAE,QAA4B,EAAY,EAAE;IAC9F,IAAI,IAA6C,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAClD,IAAI,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,IAAI,GAAG,KAAK,CAAC;IAC9G,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,8DAA8D;AAC9D,SAAS,SAAS,CAAC,UAAsB,EAAE,EAAU,EAAE,QAAgB;IACtE,IAAI,KAAgD,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrD,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACvB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5B,MAAM,CAAC,IAAI,UAAU,CAAC,SAAS,EAAE,uBAAuB,QAAQ,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QACtG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,IAAc,EACd,OAA6B,EAC7B,OAAsB;IAEtB,kHAAkH;IAClH,6GAA6G;IAC7G,0BAA0B;IAC1B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAC1C,CAAC,UAAU,EAAE,EAAE,CACd,UAAU,CAAC,IAAI,KAAK,YAAY,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,MAAM,CAC5G,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACtE,IAAI,CAAC;QACJ,+GAA+G;QAC/G,yCAAyC;QACzC,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC;QAClH,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC;YACxC,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;YACjD,UAAU,CAAC,IAAI,CAAC;gBACf,CAAC,EAAE,SAAS;gBACZ,MAAM,EAAE,EAAE;gBACV,WAAW;gBACX,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;gBACzC,OAAO,EAAE;oBACR,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;oBAC9C,YAAY,EAAE,OAAO,CAAC,YAAY;oBAClC,cAAc,EAAE,OAAO,CAAC,cAAc;iBACtC;aACD,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,IAAI,CACf,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAkC,CAAU,EAC/D,CAAC,KAAc,EAAE,EAAE;gBAClB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;gBACjC,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAChG,CAAC,CACD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACxC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC1B,KAAK,GAAG,IAAI,CAAC;YACd,CAAC,CAAC;YACF,GAAG,KAAK;SACR,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QACtE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;gBACvC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,KAAK;gBAAE,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,MAAM,CAAC,MAAM,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;YACjC,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;gBACvC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7C,UAAU,CAAC,eAAe,GAAG,WAAW,CAAC;YAC1C,CAAC;QACF,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAiC,EAAE,CAAC;QAClD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,SAAS;YAC5C,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,KAAoD,CAAC;YAClF,IAAI,KAAK,KAAK,SAAS;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,UAAsB;IAC1E,SAAS,CAAC;QACT,IAAI,CAAC,UAAU,CAAC,IAAI;YAAE,OAAO;QAC7B,gHAAgH;QAChH,wEAAwE;QACxE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC7B,SAAS;QACV,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,IAAI,UAAU,CAAC,eAAe,KAAK,WAAW,EAAE,CAAC;YAChD,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YACnC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YACjC,OAAO;QACR,CAAC;QACD,kHAAkH;QAClH,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC;QACvB,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/C,UAAU,CAAC,IAAI,CAAC;YACf,CAAC,EAAE,SAAS;YACZ,MAAM,EAAE,EAAE;YACV,WAAW;YACX,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,IAAI,CAAC;YACxD,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;SACpE,CAAC,CAAC;QACH,MAAM,IAAI,CAAC;QACX,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,WAAW,EAAE,CAAC;YACrC,iFAAiF;YACjF,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5C,SAAS;QACV,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7C,UAAU,CAAC,eAAe,GAAG,WAAW,CAAC;IAC1C,CAAC;AACF,CAAC;AAUD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,CAAW;IACzB,UAAU,CAA6B;IAEvC,YAAY,IAAc;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,UAAsB,EAAE,KAA4D;QAC1F,IAAI,KAAK,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,aAAa,EAAE,6BAA6B,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACzG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAChF,OAAO;YACR,CAAC;YACD,MAAM,SAAS,GAAmB,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAC9G,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5F,OAAO;QACR,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM;YAAE,OAAO;QACrE,IAAI,KAAK,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO;QACR,CAAC;QACD,IAAI,SAAS,CAAC,KAAK,KAAK,UAAU;YAAE,OAAO;QAC3C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC;YACJ,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;gBAAS,CAAC;YACV,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IAED,kGAAkG;IAClG,UAAU;QACT,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAC,SAAyB;QAChC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC;QAC3B,IAAI,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACpC,6EAA6E;YAC7E,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACjF,OAAO;QACR,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,SAAS,CAAC,MAAM;YACf,EAAE,QAAQ,EAAE;aACX,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACnD,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CACT,SAAyB,EACzB,UAAsB,EACtB,KAAuC;QAEvC,MAAM,SAAS,GAAG,GAAe,EAAE,CAClC,IAAI,UAAU,CAAC,SAAS,EAAE,8BAA8B,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC;YACJ,SAAS,CAAC,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YAClG,IAAI,SAAS,CAAC,SAAS;gBAAE,MAAM,SAAS,EAAE,CAAC;YAC3C,SAAS,CAAC,KAAK,GAAG,WAAW,CAAC;YAC9B,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,SAAS,CAAC,SAAS;gBAAE,MAAM,SAAS,EAAE,CAAC;YAC3C,SAAS,CAAC,KAAK,GAAG,UAAU,CAAC;YAC7B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC1F,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC/D,IAAI,CAAC,SAAS,CAAC,SAAS;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3G,CAAC;IACF,CAAC;CACD","sourcesContent":["import type { Connection } from \"./connection.ts\";\nimport { ChordError } from \"./errors.ts\";\nimport type { HostImpl, PluginRef } from \"./host.ts\";\nimport { beginReload, endReload, type Reload, type ReloadOptions, type ReloadReport, reloadError } from \"./reload.ts\";\nimport { type Frame, toWireError } from \"./wire.ts\";\n\n// Cross-host reload, coordinated by the server (the host without a parent):\n//   server: prepare itself and send `prepare` to every synced child host; collect votes\n//   all ok: the server installs its new code version, sends `commit` to every child, and only then starts what may make\n// new-code-version calls (tasks, listener and registry callbacks). Links are FIFO, so a child commits before it\n//           can receive any frame of a root started in the new code version.\n//   any failure or missed vote deadline: `abort` everywhere; each host rolls back to where it was.\n// Clients (browsers) are not participants: they see shape/reset pushes, or `upgrade_required`.\n// A child that connects behind the server's code version is fenced and reconciled with the same protocol.\n\nlet reloadSeq = 0;\n\nconst modulesFor = (remote: ReloadOptions[\"remote\"], hostName: string | undefined): string[] => {\n\tlet best: [string, readonly string[]] | undefined;\n\tfor (const entry of Object.entries(remote ?? {})) {\n\t\tif (hostName?.startsWith(entry[0]) && (best === undefined || entry[0].length > best[0].length)) best = entry;\n\t}\n\treturn [...(best?.[1] ?? [])];\n};\n\n/** A vote, or its rejection after `deadline` milliseconds. */\nfunction awaitVote(connection: Connection, id: number, deadline: number): Promise<unknown> {\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\tconst vote = new Promise<unknown>((resolve, reject) => {\n\t\tconnection.votes.set(id, { resolve, reject });\n\t\ttimer = setTimeout(() => {\n\t\t\tconnection.votes.delete(id);\n\t\t\treject(new ChordError(\"aborted\", `votes missing after ${deadline} ms`, { reason: \"vote_deadline\" }));\n\t\t}, deadline);\n\t});\n\treturn vote.finally(() => clearTimeout(timer));\n}\n\nexport async function runClusterReload(\n\thost: HostImpl,\n\tplugins: readonly PluginRef[],\n\toptions: ReloadOptions,\n): Promise<ReloadReport> {\n\t// Participants are the children in step now. Fenced children (behind, being reconciled) reconcile to the new code\n\t// version afterwards; a child whose hello arrives while the reload runs is synced or reconciled once it ends\n\t// (`HostImpl.peerHello`).\n\tconst synced = [...host.connections].filter(\n\t\t(connection) =>\n\t\t\tconnection.role === \"downstream\" && connection.peer.kind === \"host\" && connection.open && connection.synced,\n\t);\n\tconst codeVersion = host.peekNextCodeVersion();\n\tconst reload = await beginReload(host, plugins, options, codeVersion);\n\ttry {\n\t\t// Retire first: its `retire` frames reach every child before `prepare` (FIFO), so a child never retires a code\n\t\t// version this host still runs roots of.\n\t\tawait reload.waitForRetirement();\n\t\tconst participants = synced.filter((connection) => connection.open);\n\t\tconst id = ++reloadSeq;\n\t\tconst deadline = options.voteDeadline ?? (options.gateDeadline ?? 5000) + (options.retireDeadline ?? 5000) + 5000;\n\t\tconst votes = participants.map((connection) => {\n\t\t\tconst name = connection.name ?? \"child\";\n\t\t\tconst vote = awaitVote(connection, id, deadline);\n\t\t\tconnection.send({\n\t\t\t\tt: \"prepare\",\n\t\t\t\treload: id,\n\t\t\t\tcodeVersion,\n\t\t\t\tplugins: modulesFor(options.remote, name),\n\t\t\t\toptions: {\n\t\t\t\t\tremove: modulesFor(options.remoteRemove, name),\n\t\t\t\t\tgateDeadline: options.gateDeadline,\n\t\t\t\t\tretireDeadline: options.retireDeadline,\n\t\t\t\t},\n\t\t\t});\n\t\t\treturn vote.then(\n\t\t\t\t(report) => [name, report as ReloadReport | undefined] as const,\n\t\t\t\t(error: unknown) => {\n\t\t\t\t\tconst cause = reloadError(error);\n\t\t\t\t\tthrow new ChordError(cause.code, `${name}: ${cause.message}`, { cause, reason: cause.reason });\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\t\tlet local = false;\n\t\tconst results = await Promise.allSettled([\n\t\t\treload.prepare().then(() => {\n\t\t\t\tlocal = true;\n\t\t\t}),\n\t\t\t...votes,\n\t\t]);\n\t\tconst failed = results.find((result) => result.status === \"rejected\");\n\t\tif (failed !== undefined) {\n\t\t\tfor (const connection of participants) {\n\t\t\t\tconnection.votes.delete(id);\n\t\t\t\tconnection.send({ t: \"abort\", reload: id });\n\t\t\t}\n\t\t\tif (local) await reload.rollback();\n\t\t\tthrow failed.reason;\n\t\t}\n\t\tconst report = reload.commit(() => {\n\t\t\tfor (const connection of participants) {\n\t\t\t\tconnection.send({ t: \"commit\", reload: id });\n\t\t\t\tconnection.peerCodeVersion = codeVersion;\n\t\t\t}\n\t\t});\n\t\thost.rememberRemoteModules(options.remote, options.remoteRemove);\n\t\tconst children: Record<string, ReloadReport> = {};\n\t\tfor (const result of results.slice(1)) {\n\t\t\tif (result.status !== \"fulfilled\") continue;\n\t\t\tconst [name, child] = result.value as readonly [string, ReloadReport | undefined];\n\t\t\tif (child !== undefined) children[name] = child;\n\t\t}\n\t\treturn { ...report, children };\n\t} finally {\n\t\tendReload(host);\n\t}\n}\n\n/**\n * Brings a child that connected behind this host's code version up to it: a reload of the child's modules (the ones\n * cluster reloads gave its name) to this host's current code version, prepared, voted and committed like a cluster\n * reload. Until then the child is fenced: nothing is routed to it. The child's old code is never relabeled as a newer\n * code version.\n */\nexport async function reconcileChild(host: HostImpl, connection: Connection): Promise<void> {\n\tfor (;;) {\n\t\tif (!connection.open) return;\n\t\t// Not during a reload of this host: the child is not one of its participants, so whatever it would be synced to\n\t\t// now may be superseded by that reload's commit. Recheck once it ended.\n\t\tif (host.reloading) {\n\t\t\tawait host.whenReloadEnded();\n\t\t\tcontinue;\n\t\t}\n\t\tconst codeVersion = host.current.id;\n\t\tif (connection.peerCodeVersion === codeVersion) {\n\t\t\tconnection.markSynced(codeVersion);\n\t\t\thost.announceRetired(connection);\n\t\t\treturn;\n\t\t}\n\t\t// Before `prepare`: the child's prepare first retires its previous code version, which waits for this permission.\n\t\thost.announceRetired(connection);\n\t\tconst id = ++reloadSeq;\n\t\tconst vote = awaitVote(connection, id, 30_000);\n\t\tconnection.send({\n\t\t\tt: \"prepare\",\n\t\t\treload: id,\n\t\t\tcodeVersion,\n\t\t\tplugins: modulesFor(host.remoteModules, connection.name),\n\t\t\toptions: { remove: modulesFor(host.remoteRemoved, connection.name) },\n\t\t});\n\t\tawait vote;\n\t\tif (host.current.id !== codeVersion) {\n\t\t\t// This host moved on meanwhile: abort and try again with the newer code version.\n\t\t\tconnection.send({ t: \"abort\", reload: id });\n\t\t\tcontinue;\n\t\t}\n\t\tconnection.send({ t: \"commit\", reload: id });\n\t\tconnection.peerCodeVersion = codeVersion;\n\t}\n}\n\n/** One prepare the child received, registered before its first await so an abort or disconnect is never lost. */\ninterface ChildOperation {\n\treadonly id: number;\n\treload: Reload | undefined;\n\tstate: \"loading\" | \"preparing\" | \"prepared\";\n\tcancelled: boolean;\n}\n\n/**\n * The child side: prepare and vote, then wait for the server's commit or abort. An abort or a lost parent link can\n * arrive at any point: while loading modules, while preparing (pending opens close themselves when they complete),\n * or after the vote. The operation is unwound once its pending work settles, and the reload slot is freed.\n */\nexport class ChildReloads {\n\treadonly #host: HostImpl;\n\t#operation: ChildOperation | undefined;\n\n\tconstructor(host: HostImpl) {\n\t\tthis.#host = host;\n\t}\n\n\thandle(connection: Connection, frame: Extract<Frame, { t: \"prepare\" | \"commit\" | \"abort\" }>): void {\n\t\tif (frame.t === \"prepare\") {\n\t\t\tif (this.#operation !== undefined) {\n\t\t\t\tconst error = new ChordError(\"unavailable\", \"a reload is already running\", { reason: \"reload_running\" });\n\t\t\t\tconnection.send({ t: \"vote\", reload: frame.reload, error: toWireError(error) });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst operation: ChildOperation = { id: frame.reload, reload: undefined, state: \"loading\", cancelled: false };\n\t\t\tthis.#operation = operation;\n\t\t\tthis.#run(operation, connection, frame).catch((error: unknown) => this.#host.report(error));\n\t\t\treturn;\n\t\t}\n\t\tconst operation = this.#operation;\n\t\tif (operation === undefined || operation.id !== frame.reload) return;\n\t\tif (frame.t === \"abort\") {\n\t\t\tthis.#cancel(operation);\n\t\t\treturn;\n\t\t}\n\t\tif (operation.state !== \"prepared\") return;\n\t\tthis.#operation = undefined;\n\t\ttry {\n\t\t\toperation.reload?.commit();\n\t\t} finally {\n\t\t\tendReload(this.#host);\n\t\t}\n\t}\n\n\t/** The parent link died: nobody will commit, so roll back (now, or once pending work settles). */\n\tparentLost(): void {\n\t\tif (this.#operation !== undefined) this.#cancel(this.#operation);\n\t}\n\n\t#cancel(operation: ChildOperation): void {\n\t\toperation.cancelled = true;\n\t\tif (operation.state !== \"prepared\") {\n\t\t\t// Loading or preparing: make prepare fail now; #run unwinds when it settles.\n\t\t\toperation.reload?.rollback().catch((error: unknown) => this.#host.report(error));\n\t\t\treturn;\n\t\t}\n\t\tthis.#operation = undefined;\n\t\toperation.reload\n\t\t\t?.rollback()\n\t\t\t.catch((error: unknown) => this.#host.report(error))\n\t\t\t.finally(() => endReload(this.#host));\n\t}\n\n\tasync #run(\n\t\toperation: ChildOperation,\n\t\tconnection: Connection,\n\t\tframe: Extract<Frame, { t: \"prepare\" }>,\n\t): Promise<void> {\n\t\tconst cancelled = (): ChordError =>\n\t\t\tnew ChordError(\"aborted\", \"reload aborted by the server\", { reason: \"aborted\" });\n\t\ttry {\n\t\t\toperation.reload = await beginReload(this.#host, frame.plugins, frame.options, frame.codeVersion);\n\t\t\tif (operation.cancelled) throw cancelled();\n\t\t\toperation.state = \"preparing\";\n\t\t\tawait operation.reload.prepare();\n\t\t\tif (operation.cancelled) throw cancelled();\n\t\t\toperation.state = \"prepared\";\n\t\t\tconnection.send({ t: \"vote\", reload: frame.reload, report: operation.reload.summary() });\n\t\t} catch (error) {\n\t\t\tif (operation.reload !== undefined) {\n\t\t\t\tawait operation.reload.rollback().catch((cleanup: unknown) => this.#host.report(cleanup));\n\t\t\t\tendReload(this.#host);\n\t\t\t}\n\t\t\tif (this.#operation === operation) this.#operation = undefined;\n\t\t\tif (!operation.cancelled) connection.send({ t: \"vote\", reload: frame.reload, error: toWireError(error) });\n\t\t}\n\t}\n}\n"]}

package/dist/connection.d.ts

@@ -1,270 +0,0 @@
-import { type Encoder } from "./delta/index.ts";
-import type { HostImpl } from "./host.ts";
-import { type Link } from "./link.ts";
-import { RefImpl } from "./object.ts";
-import type { RemoteBinding, RemoteChannel } from "./remote.ts";
-import type { StateEvent } from "./types.ts";
-import { type Frame, type RootRef } from "./wire.ts";
-export interface LinkOptions {
-    /** Milliseconds between pings (default 15000). */
-    readonly pingInterval?: number;
-    /** Close the link when nothing arrived for this long (default 45000). Everything held through it is released. */
-    readonly pingTimeout?: number;
-    /**
-     * Unacknowledged frame bytes (JSON text length) beyond which state frames wait for the peer (default 256 KiB). Only
-     * applies when both ends acknowledge frames and the link reports sizes; `Infinity` never holds state back.
-     */
-    readonly window?: number;
-    /**
-     * Bytes of state ops that may wait for the peer on this link (default 4 windows). Beyond, the oldest waiting streams
-     * are replaced by their current value (a reset), so memory stays bounded however long the peer stalls.
-     */
-    readonly pendingCap?: number;
-    /**
-     * The peer speaks another link protocol version (`peer`: undefined if it did not say): the link closes, and should
-     * not be reconnected with the same code. A browser reloads its page, for instance.
-     */
-    readonly onProtocolMismatch?: (versions: {
-        readonly local: number;
-        readonly peer: number | undefined;
-    }) => void;
-}
-type StateFrame = Extract<Frame, {
-    t: "state";
-}>;
-/**
- * How a waiting stream recovers when its ops must be dropped: the provider resends the current value as a reset at
- * flush; a relay (which has no value) asks downstream for one.
- */
-type Overflow = {
-    readonly resend: () => void;
-} | {
-    readonly resync: () => void;
-};
-export interface AcceptOptions<P = unknown> extends LinkOptions {
-    /** The principal of whatever connects, from the app's authenticator. Every request on the link acts as it. */
-    readonly principal: P;
-    /**
-     * What the peer is, decided here and never by its `hello`: `client` (default; a browser: no roots, no code versions,
-     * not a reload participant, not addressable) or `host` (a child host; needs `name`).
-     */
-    readonly kind?: "host" | "client";
-    /** A child host's name: its hello must match, and it is reachable `at` this name. */
-    readonly name?: string;
-    /** On `invalidatePrincipal`: a new principal keeps the link, `undefined` closes it (default: close). */
-    restamp?(principal: P): P | undefined;
-    /**
-     * Calls the peer may have in progress on this link (default: no limit). Further ones never run: they are answered
-     * at once with `unavailable` (reason `too_many_calls`), and the link stays open.
-     */
-    readonly maxCalls?: number;
-}
-export interface Peer {
-    readonly kind: "host" | "client";
-    /** Configured (downstream hosts) or announced by the trusted parent (upstream). */
-    readonly name: string | undefined;
-}
-/** A state member's stream to the consumer: its subscription and delta encoder. */
-interface Feed {
-    unsubscribe: () => void;
-    encoder: Encoder;
-    /** Events that arrived while a unit or reset was being built (replayed after it is sent). */
-    buffer: StateEvent<unknown>[] | undefined;
-}
-/** A hold the peer made on this host and serves locally. */
-interface ServedLocal {
-    readonly kind: "local";
-    readonly id: number;
-    readonly ref: RefImpl;
-    readonly principal: unknown;
-    /** The client connection it comes from (see `Frame` hold `origin`); undefined for a host's own holds. */
-    readonly origin: string | undefined;
-    /** The consumer wants state (hold without `state: false`, or `sub`). */
-    wantsState: boolean;
-    /** The consumer had values before (re-hold): its first unit waits for the window like any other. */
-    readonly again: boolean;
-    /** A unit was sent. */
-    unitSent: boolean;
-    /** The members whose snapshot the consumer has, with their streams. */
-    readonly feeds: Map<string, Feed>;
-}
-/** A hold the peer made on this host: served locally or relayed to another link. */
-type Served = ServedLocal | {
-    readonly kind: "relay";
-    readonly relay: RelayRef;
-};
-type Pending = {
-    readonly resolve: (value: unknown) => void;
-    readonly reject: (error: unknown) => void;
-};
-/**
- * A hold relayed from an origin link to a downstream link. It owns everything done through it: state and calls queued
- * while the route resolves, and the downstream twins once forwarded. `close` undoes all of it exactly once (cancels
- * calls downstream, drops what waits for the origin, releases the downstream hold, rejects waiters).
- */
-export declare class RelayRef {
-    #private;
-    readonly origin: Connection;
-    readonly frame: Extract<Frame, {
-        t: "hold";
-    }>;
-    readonly principal: unknown;
-    /** The client connection the hold comes from (forwarded downstream); undefined for a host's own holds. */
-    readonly originTag: string | undefined;
-    /** The origin's authorization generation when the hold arrived; a revocation bumps it. */
-    readonly generation: number;
-    down: Connection | undefined;
-    downId: number;
-    closed: boolean;
-    /** The origin wants state (forwarded as `state: false`, `sub`, `unsub`). */
-    stateWanted: boolean;
-    /** The members of the first unit, still to forward past the origin's window. */
-    urgent: Set<string> | undefined;
-    /** Members whose ops this relay dropped: downstream ops are ignored until their reset arrives. */
-    readonly awaiting: Set<string>;
-    readonly calls: Map<number, RelayCall>;
-    constructor(origin: Connection, frame: Extract<Frame, {
-        t: "hold";
-    }>, principal: unknown, originTag: string | undefined);
-    get originId(): number;
-    get client(): boolean;
-    /** Still authorized as it was when it arrived. */
-    get current(): boolean;
-    /** The downstream connection once the route resolved; rejects if the relay closes first. */
-    ready(): Promise<Connection>;
-    /** Forwards the hold to `down`. */
-    open(down: Connection): void;
-    /** The origin starts or stops the hold's state. */
-    wantState(wanted: boolean): void;
-    /**
-     * The origin could not keep up and dropped what waited for member `m` (or asked for it again): ask downstream for a
-     * reset, and ignore its ops until the reset arrives.
-     */
-    resync(m: string): void;
-    /** A shape from downstream: forwarded at once; the members of the first unit then skip the origin's window. */
-    shape(frame: Extract<Frame, {
-        t: "shape";
-    }>): void;
-    /** A state frame from downstream. */
-    state(frame: StateFrame): void;
-    /**
-     * Closes the relay. `releaseDown`: the downstream hold is still there (origin released, disconnected, or was
-     * revoked): cancel its calls and release it. `notify`: tell the origin the hold is gone.
-     */
-    close(error: unknown, options: {
-        readonly releaseDown: boolean;
-        readonly notify: boolean;
-    }): void;
-}
-/** One relayed call: settles once, by result, cancellation or the relay closing; removes both mappings. */
-export declare class RelayCall {
-    #private;
-    readonly relay: RelayRef;
-    readonly originId: number;
-    readonly downId: number;
-    constructor(relay: RelayRef, originId: number, downId: number, pending: Pending);
-    finish(error: unknown, value?: unknown): void;
-    /** Cancels downstream (when the downstream hold still exists) and settles with `error`. */
-    cancel(error: unknown, forward: boolean): void;
-}
-/**
- * One end of a link on a host: consumer of remote references, provider for the peer's holds, and relay.
- *
- * State
- * -----
- *
- * A hold implies the state of its variant (unless it says `state: false`). The provider answers with a unit: the shape,
- * then a snapshot of each state member the consumer does not have yet (`shape.state` lists them), then the members'
- * ops and resets. A reload or a variant change sends another unit with the members that are new; members that left the
- * variant stop. The consumer applies a shape once its snapshots are here (`RemoteBinding`).
- *
- * Flow control
- * ------------
- *
- * Problem: state is pushed as fast as it changes, but a peer may read slowly (a phone behind a relay), and a relay may
- * hide that: Cloudflare forwards to browsers without backpressure. Everything sent then queues in front of the next
- * call result. Example: a browser opens three long transcripts (500 KiB of snapshots each) over a 5 Mbit/s path; a
- * result sent next waits 2.4 s, and the snapshot of a transcript the user already left is still sent in full.
- *
- * Solution: the peer acknowledges what it processed (`ack`, a cumulative frame count), and the sender counts the sizes
- * of the frames not yet acknowledged. While they exceed the window, state waits here in slots, flushed in creation
- * order as acknowledgements come:
- * - a member's stream has one slot: ops are appended (encoded batches of one stream may be concatenated, see
- *   `encoder`), a snapshot, reset or error replaces it;
- * - a hold's unit has one slot, built lazily from the current values when it is sent, so a newer unit merges into it;
- *   while it waits, the members it introduces have no stream yet.
- *
- * The first unit of a hold that is not a re-hold (`again`) is sent at once, past the window: a `get` waits for it, and
- * must not wait behind other holds' state. Results, shapes, gone, reload control and pings are sent at once too: they
- * are bounded by the requests the peer makes. Hence the one ordering exception of a link: while state waits, a result
- * can arrive before state changes made before it. Frames of one stream stay in order.
- *
- * Waiting ops are capped per link (`pendingCap`): beyond, the oldest streams are replaced by their current value (a
- * reset built at flush), or, on a relay, by a reset asked of the provider (`resync`), so memory stays bounded however
- * long the peer stalls. The window bounds what is unacknowledged when a frame is sent, so one frame (a large snapshot)
- * may exceed it. Both hellos must announce `acks`; with an older peer nothing is acknowledged and nothing waits. Links
- * that do not report sizes (IPC) never fill the window.
- */
-export declare class Connection implements RemoteChannel {
-    #private;
-    readonly host: HostImpl;
-    readonly link: Link;
-    /** `upstream`: the link to this host's parent. `downstream`: a link this host accepted. */
-    readonly role: "upstream" | "downstream";
-    readonly peer: Peer;
-    /** A client connection's opaque id: holds that come over it (directly or relayed) carry it as their `origin`. */
-    readonly originId: string | undefined;
-    principal: unknown;
-    readonly restamp: ((principal: unknown) => unknown | undefined) | undefined;
-    /** Bumped when the stamped principal is revoked or re-stamped: relays from before are refused. */
-    generation: number;
-    /** The code version a downstream host peer runs (from its hello, then from commits). */
-    peerCodeVersion: number | undefined;
-    /** A downstream host peer is usable once it runs this host's current code version (see `HostImpl.peerHello`). */
-    synced: boolean;
-    /** Code versions this child announced while behind this host (fenced): this host never ran them. */
-    readonly fencedCodeVersions: Set<number>;
-    readonly remotes: Map<number, RemoteBinding>;
-    readonly calls: Map<number, Pending>;
-    readonly served: Map<number, Served>;
-    readonly incoming: Map<number, AbortController>;
-    readonly relayedRefs: Map<number, RelayRef>;
-    readonly relayedCalls: Map<number, RelayCall>;
-    /** Reload votes awaited from this (child) peer. */
-    readonly votes: Map<number, Pending>;
-    constructor(host: HostImpl, link: Link, config: {
-        readonly role: "upstream" | "downstream";
-        readonly principal: unknown;
-        readonly peer: Peer;
-        readonly originId?: string;
-        readonly restamp?: (principal: unknown) => unknown | undefined;
-        readonly maxCalls?: number;
-    } & LinkOptions);
-    get open(): boolean;
-    /** The peer's name: configured for downstream hosts, announced by the parent upstream. */
-    get name(): string | undefined;
-    send(frame: Frame): void;
-    /** Sends a state frame, or keeps it waiting (see the class comment). */
-    sendState(frame: StateFrame, overflow: Overflow): void;
-    /** Forgets what waits for a stream that ended. */
-    dropState(hold: number, m: string): void;
-    /** Forgets everything that waits for a hold (released, closed, or its state stopped). */
-    dropHoldState(hold: number): void;
-    /** What waits for the peer: slots and bytes of ops (for tests and diagnostics). */
-    get waiting(): {
-        readonly slots: number;
-        readonly bytes: number;
-    };
-    nextId(): number;
-    /** Resolves once the peer is usable (a host peer runs this host's code version); rejects if the link closes first. */
-    whenSynced(): Promise<void>;
-    markSynced(codeVersion: number): void;
-    /** Revokes the stamped principal: relays made under it close at once (also those still resolving a route). */
-    revoke(next: unknown | undefined): void;
-    hold(binding: RemoteBinding, again: boolean): number;
-    release(id: number): void;
-    wantState(hold: number, wanted: boolean): void;
-    call(hold: number, member: string, args: unknown, root: RootRef | undefined, signal: AbortSignal): Promise<unknown>;
-}
-export {};
-//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

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