@earendil-works/chord 1.2.0 → 1.3.0

package/dist/cluster.js

@@ -3,12 +3,12 @@ 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 epoch, sends `commit` to every child, and only then starts what may make
-//           new-epoch 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 epoch.
+//   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 epoch is fenced and reconciled with the same protocol.
+// 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;
@@ -31,33 +31,39 @@ function awaitVote(connection, id, deadline) {
     return vote.finally(() => clearTimeout(timer));
 }
 export async function runClusterReload(host, plugins, options) {
-    // Fenced children (behind, being reconciled) are not participants; they reconcile to the new epoch afterwards.
-    const participants = [...host.connections].filter((connection) => connection.role === "downstream" && connection.peer.kind === "host" && connection.open && connection.synced);
-    const epoch = host.peekNextEpoch();
-    const reload = await beginReload(host, plugins, options, epoch);
-    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,
-            epoch,
-            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;
+    // 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;
@@ -77,7 +83,7 @@ export async function runClusterReload(host, plugins, options) {
         const report = reload.commit(() => {
             for (const connection of participants) {
                 connection.send({ t: "commit", reload: id });
-                connection.peerEpoch = epoch;
+                connection.peerCodeVersion = codeVersion;
             }
         });
         host.rememberRemoteModules(options.remote, options.remoteRemove);
@@ -96,36 +102,46 @@ export async function runClusterReload(host, plugins, options) {
     }
 }
 /**
- * Brings a child that connected behind this host's epoch up to it: a reload of the child's modules (the ones
- * cluster reloads gave its name) to this host's current epoch, 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 epoch.
+ * 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 (;;) {
-        const epoch = host.current.id;
         if (!connection.open)
             return;
-        if (connection.peerEpoch === epoch) {
-            connection.markSynced(epoch);
+        // 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,
-            epoch,
+            codeVersion,
             plugins: modulesFor(host.remoteModules, connection.name),
             options: { remove: modulesFor(host.remoteRemoved, connection.name) },
         });
         await vote;
-        if (host.current.id !== epoch) {
-            // This host moved on meanwhile: abort and try again with the newer epoch.
+        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.peerEpoch = epoch;
+        connection.peerCodeVersion = codeVersion;
     }
 }
 /**
@@ -189,7 +205,7 @@ export class ChildReloads {
     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.epoch);
+            operation.reload = await beginReload(this.#host, frame.plugins, frame.options, frame.codeVersion);
             if (operation.cancelled)
                 throw cancelled();
             operation.state = "preparing";

package/dist/cluster.js.map

@@ -1 +1 @@
-{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../src/cluster.ts"],"names":[],"mappings":"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","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 epoch, sends `commit` to every child, and only then starts what may make\n//           new-epoch 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 epoch.\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 epoch 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// Fenced children (behind, being reconciled) are not participants; they reconcile to the new epoch afterwards.\n\tconst participants = [...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 epoch = host.peekNextEpoch();\n\tconst reload = await beginReload(host, plugins, options, epoch);\n\tconst id = ++reloadSeq;\n\tconst deadline = options.voteDeadline ?? (options.gateDeadline ?? 5000) + (options.retireDeadline ?? 5000) + 5000;\n\tconst votes = participants.map((connection) => {\n\t\tconst name = connection.name ?? \"child\";\n\t\tconst vote = awaitVote(connection, id, deadline);\n\t\tconnection.send({\n\t\t\tt: \"prepare\",\n\t\t\treload: id,\n\t\t\tepoch,\n\t\t\tplugins: modulesFor(options.remote, name),\n\t\t\toptions: {\n\t\t\t\tremove: modulesFor(options.remoteRemove, name),\n\t\t\t\tgateDeadline: options.gateDeadline,\n\t\t\t\tretireDeadline: options.retireDeadline,\n\t\t\t},\n\t\t});\n\t\treturn vote.then(\n\t\t\t(report) => [name, report as ReloadReport | undefined] as const,\n\t\t\t(error: unknown) => {\n\t\t\t\tconst cause = reloadError(error);\n\t\t\t\tthrow new ChordError(cause.code, `${name}: ${cause.message}`, { cause, reason: cause.reason });\n\t\t\t},\n\t\t);\n\t});\n\tlet local = false;\n\ttry {\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.peerEpoch = epoch;\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 epoch up to it: a reload of the child's modules (the ones\n * cluster reloads gave its name) to this host's current epoch, prepared, voted and committed like a cluster reload.\n * Until then the child is fenced: nothing is routed to it. The child's old code is never relabeled as a newer epoch.\n */\nexport async function reconcileChild(host: HostImpl, connection: Connection): Promise<void> {\n\tfor (;;) {\n\t\tconst epoch = host.current.id;\n\t\tif (!connection.open) return;\n\t\tif (connection.peerEpoch === epoch) {\n\t\t\tconnection.markSynced(epoch);\n\t\t\treturn;\n\t\t}\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\tepoch,\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 !== epoch) {\n\t\t\t// This host moved on meanwhile: abort and try again with the newer epoch.\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.peerEpoch = epoch;\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.epoch);\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"]}
+{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../src/cluster.ts"],"names":[],"mappings":"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","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,82 +1,152 @@
+import { type Encoder } from "./delta/index.ts";
 import type { HostImpl } from "./host.ts";
-import type { Link } from "./link.ts";
-import { HandleImpl } from "./record.ts";
-import type { RemoteChannel, RemoteHandle, StateSink } from "./remote.ts";
-import type { Principal } from "./types.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;
 }
-export interface AcceptOptions extends LinkOptions {
+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: Principal;
+    readonly principal: P;
     /**
-     * What the peer is, decided here and never by its `hello`: `client` (default; a browser: no roots, no epochs, not
-     * a reload participant, not addressable) or `host` (a child host; needs `name`).
+     * 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). */
-    readonly restamp?: (principal: Principal) => Principal | undefined;
+    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 hold the peer made on this host: served locally or relayed to another link. */
-type Served = {
+/** 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 handle: HandleImpl;
-    readonly principal: Principal;
-    readonly feeds: Set<number>;
-} | {
+    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: RelayHold;
+    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: subscriptions and
- * calls queued while the route resolves, and the downstream twins once forwarded. `close` undoes all of it exactly
- * once (cancels calls downstream, drops subscriptions, releases the downstream hold, rejects waiters).
+ * 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 RelayHold {
+export declare class RelayRef {
     #private;
     readonly origin: Connection;
     readonly frame: Extract<Frame, {
         t: "hold";
     }>;
-    readonly principal: Principal;
-    readonly client: boolean;
+    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>;
-    readonly subs: Map<number, {
-        readonly member: string;
-        downId: number | undefined;
-    }>;
     constructor(origin: Connection, frame: Extract<Frame, {
         t: "hold";
-    }>, principal: Principal, client: boolean);
+    }>, 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 (and what queued meanwhile) to `down`. */
+    /** Forwards the hold to `down`. */
     open(down: Connection): void;
-    subscribe(originSubId: number, member: string): void;
-    unsubscribe(originSubId: number, forward?: boolean): 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.
@@ -89,15 +159,52 @@ export declare class RelayHold {
 /** One relayed call: settles once, by result, cancellation or the relay closing; removes both mappings. */
 export declare class RelayCall {
     #private;
-    readonly relay: RelayHold;
+    readonly relay: RelayRef;
     readonly originId: number;
     readonly downId: number;
-    constructor(relay: RelayHold, originId: number, downId: number, pending: Pending);
+    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 handles, provider for the peer's holds, and relay. */
+/**
+ * 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;
@@ -105,53 +212,59 @@ export declare class Connection implements RemoteChannel {
     /** `upstream`: the link to this host's parent. `downstream`: a link this host accepted. */
     readonly role: "upstream" | "downstream";
     readonly peer: Peer;
-    principal: Principal;
-    readonly restamp: ((principal: Principal) => Principal | undefined) | undefined;
+    /** 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 epoch a downstream host peer runs (from its hello, then from commits). */
-    peerEpoch: number | undefined;
-    /** A downstream host peer is usable once it runs this host's current epoch (see `HostImpl.peerHello`). */
+    /** 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;
-    /** Epochs this child announced while behind this host (fenced): this host never ran them. */
-    readonly fencedEpochs: Set<number>;
-    readonly remotes: Map<number, RemoteHandle>;
+    /** 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 subs: Map<number, (frame: StateSink) => void>;
     readonly served: Map<number, Served>;
     readonly incoming: Map<number, AbortController>;
-    readonly feeds: Map<number, () => void>;
-    /** Origin side of relays: the peer's sub ids that are relayed. */
-    readonly relaySubs: Map<number, RelayHold>;
-    readonly relayedHolds: Map<number, RelayHold>;
+    readonly relayedRefs: Map<number, RelayRef>;
     readonly relayedCalls: Map<number, RelayCall>;
-    readonly relayedSubs: Map<number, {
-        readonly relay: RelayHold;
-        readonly originSubId: number;
-    }>;
     /** Reload votes awaited from this (child) peer. */
     readonly votes: Map<number, Pending>;
     constructor(host: HostImpl, link: Link, config: {
         readonly role: "upstream" | "downstream";
-        readonly principal: Principal;
+        readonly principal: unknown;
         readonly peer: Peer;
-        readonly restamp?: (principal: Principal) => Principal | undefined;
+        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 epoch); rejects if the link closes first. */
+    /** 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(epoch: number): void;
+    markSynced(codeVersion: number): void;
     /** Revokes the stamped principal: relays made under it close at once (also those still resolving a route). */
-    revoke(next: Principal | undefined): void;
-    hold(handle: RemoteHandle): number;
+    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>;
-    sub(hold: number, member: string, sink: (frame: StateSink) => void): number;
-    unsub(id: number): void;
 }
 export {};
 //# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAgB,UAAU,EAAU,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,KAAK,EAAO,SAAS,EAAwB,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,KAAK,KAAK,EAA0B,KAAK,OAAO,EAAe,MAAM,WAAW,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,iHAAiH;IACjH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,8GAA8G;IAC9G,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAClC,qFAAqF;IACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,wGAAwG;IACxG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,SAAS,GAAG,SAAS,CAAC;CACnE;AAED,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,oFAAoF;AACpF,KAAK,MAAM,GACR;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GACnH;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzD,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,CAAC;AAMzG;;;;GAIG;AACH,qBAAa,SAAS;;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,MAAM,SAAK;IACX,MAAM,UAAS;IACf,QAAQ,CAAC,KAAK,yBAAgC;IAC9C,QAAQ,CAAC,IAAI;yBAAsC,MAAM;gBAAU,MAAM,GAAG,SAAS;OAAM;IAG3F,YAAY,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAM1G;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,kDAAkD;IAClD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,4FAA4F;IAC5F,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAM3B;IAED,+DAA+D;IAC/D,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAe3B;IAED,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKnD;IASD,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI,CASrD;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAahG;CACD;AAED,2GAA2G;AAC3G,qBAAa,SAAS;;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAIxB,YAAY,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAO/E;IAED,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAO5C;IAED,2FAA2F;IAC3F,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAI7C;CACD;AAID,yGAAyG;AACzG,qBAAa,UAAW,YAAW,aAAa;;IAC/C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,KAAK,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAChF,kGAAkG;IAClG,UAAU,SAAK;IACf,iFAAiF;IACjF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,0GAA0G;IAC1G,MAAM,EAAE,OAAO,CAAC;IAChB,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,cAAqB;IAS1C,QAAQ,CAAC,OAAO,4BAAmC;IACnD,QAAQ,CAAC,KAAK,uBAA8B;IAC5C,QAAQ,CAAC,IAAI,sBAA2B,SAAS,KAAK,IAAI,EAAI;IAE9D,QAAQ,CAAC,MAAM,sBAA6B;IAC5C,QAAQ,CAAC,QAAQ,+BAAsC;IACvD,QAAQ,CAAC,KAAK,oBAAyB,IAAI,EAAI;IAC/C,kEAAkE;IAClE,QAAQ,CAAC,SAAS,yBAAgC;IAElD,QAAQ,CAAC,YAAY,yBAAgC;IACrD,QAAQ,CAAC,YAAY,yBAAgC;IACrD,QAAQ,CAAC,WAAW;wBAAqC,SAAS;8BAAwB,MAAM;OAAM;IACtG,mDAAmD;IACnD,QAAQ,CAAC,KAAK,uBAA8B;IAE5C,YACC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,IAAI,EACV,MAAM,EAAE;QACP,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;QACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,SAAS,GAAG,SAAS,CAAC;KACnE,GAAG,WAAW,EAoBf;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,0FAA0F;IAC1F,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEvB;IAED,MAAM,IAAI,MAAM,CAEf;IAED,+GAA+G;IAC/G,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1B;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK9B;IAED,8GAA8G;IAC9G,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAQxC;IAUD,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAejC;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGxB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BlH;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,CAK1E;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtB;CAqXD"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}