@earendil-works/chord 1.5.0 → 1.5.1

package/dist/link/channel.d.ts

@@ -0,0 +1,68 @@
+import type { Context } from "../context/index.ts";
+import type { ChordMetrics } from "../telemetry.ts";
+import type { Link } from "./link.ts";
+import { type Codec, type Message } from "./message.ts";
+/** What the owner of a channel handles. */
+export interface ChannelHandler {
+    /** The peer's `hello` arrived: the link is open. */
+    opened(): void;
+    /**
+     * A checked message after the handshake (never `hello`, `ping` or `pong`). A throw is a protocol error. A promise
+     * (the message waits for an asynchronous inflate) holds every later message until it settles; a rejection is a
+     * protocol error too.
+     */
+    message(message: Message): void | Promise<void>;
+    /** The link closed, from either end; called once. */
+    closed(): void;
+}
+/** What a channel is made with besides its link and handler. */
+type ChannelOptions = {
+    readonly codec: Codec;
+    /** This host's incarnation, sent in `hello`. */
+    readonly incarnation: string;
+    /** How many concurrent calls this side accepts, sent in `hello`. */
+    readonly calls: number;
+    /** Skips the `MESSAGE` check (framing, the codec's decode and the owners' checks still run). */
+    readonly trusted: boolean;
+    /** Where protocol errors go. */
+    readonly report: (error: unknown) => void;
+    /** The host's instruments: the bytes of every encoded message sent and received (`chord.link.bytes`). */
+    readonly metrics: ChordMetrics;
+};
+/**
+ * One end of a link. It sends `hello { protocol, incarnation, calls }` first and nothing else until the peer's arrived
+ * (its own messages wait). Every message is decoded by the link's codec and, unless the link is trusted, checked
+ * against the message schema; a first message that is no `hello` of this codec, a second `hello`, another protocol
+ * version, or a message failing a check closes the link and is reported. The heartbeat: every received message
+ * stamps `lastReceived`; the host's timer calls `tick`, which pings a silent open link and closes a link silent for
+ * too long (the handshake included); a `ping` is answered with `pong` at once. A message the handler handles
+ * asynchronously holds the later ones, `ping` included, until it settles; they are handled in order then, and dropped
+ * when the link closes meanwhile.
+ */
+export declare class Channel {
+    #private;
+    constructor(link: Link, handler: ChannelHandler, options: ChannelOptions, context: Context);
+    /**
+     * Sends `hello` and starts listening: messages that arrived already are handled now, and a link closed already
+     * calls `closed` now; so the handler is complete before it starts.
+     */
+    start(): void;
+    /** The peer's incarnation, from its `hello`; empty before it arrived (nothing else can arrive before it). */
+    get peer(): string;
+    /** How many concurrent calls the peer accepts, from its `hello`; 0 before it arrived. */
+    get peerCalls(): number;
+    get opened(): boolean;
+    get closed(): boolean;
+    /** Sends one message; before the handshake it waits, after the close it is dropped. */
+    send(message: Message): void;
+    close(): void;
+    /**
+     * The heartbeat, at `now`: a link silent for `close` ms (the handshake included) closes; an open one silent for
+     * `ping` ms sends one `ping`. `paused` ms this process did not run before it are no silence: what the peer sent
+     * meanwhile is still unread (timers run before I/O). The silence stays what it was before the pause, at least `ping`
+     * ms, so a dead peer (a dropped TCP connection) is found `close - ping` ms later.
+     */
+    tick(now: number, paused: number, ping: number, close: number): void;
+}
+export {};
+//# sourceMappingURL=channel.d.ts.map

package/dist/link/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/link/channel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,KAAK,KAAK,EAAgB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAEtE,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,MAAM,IAAI,IAAI,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,qDAAqD;IACrD,MAAM,IAAI,IAAI,CAAC;CACf;AAED,gEAAgE;AAChE,KAAK,cAAc,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,yGAAyG;IACzG,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAC/B,CAAC;AAgBF;;;;;;;;;GASG;AACH,qBAAa,OAAO;;IAuBnB,YAAY,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAczF;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAKZ;IAED,6GAA6G;IAC7G,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yFAAyF;IACzF,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,uFAAuF;IACvF,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO3B;IAED,KAAK,IAAI,IAAI,CAEZ;IAED;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQnE;CAoGD"}

package/dist/link/channel.js

@@ -0,0 +1,215 @@
+// A host's end of a link (§3, §22, 2b): the handshake, the link's codec, the checks of every message (skipped on a
+// trusted link), the heartbeat, and messages handled in order while one waits for an asynchronous inflate; a protocol
+// error closes the link. The bytes of every message it encodes and receives are counted (`chord.link.bytes`).
+import { PROTOCOL_VERSION } from "../data/internal.js";
+import { checkMessage } from "./message.js";
+/** `chord.link.bytes`' attributes, made once. */
+const SENT = { direction: "sent" };
+const RECEIVED = { direction: "received" };
+/**
+ * One end of a link. It sends `hello { protocol, incarnation, calls }` first and nothing else until the peer's arrived
+ * (its own messages wait). Every message is decoded by the link's codec and, unless the link is trusted, checked
+ * against the message schema; a first message that is no `hello` of this codec, a second `hello`, another protocol
+ * version, or a message failing a check closes the link and is reported. The heartbeat: every received message
+ * stamps `lastReceived`; the host's timer calls `tick`, which pings a silent open link and closes a link silent for
+ * too long (the handshake included); a `ping` is answered with `pong` at once. A message the handler handles
+ * asynchronously holds the later ones, `ping` included, until it settles; they are handled in order then, and dropped
+ * when the link closes meanwhile.
+ */
+export class Channel {
+    #link;
+    #codec;
+    #handler;
+    #report;
+    #trusted;
+    #context;
+    #state = { kind: "greeting", queued: [] };
+    /** When the last message arrived (`Date.now()`), or the channel was made. */
+    #lastReceived = Date.now();
+    /** Whether a `ping` went out since the last received message. */
+    #pinged = false;
+    /**
+     * Messages received while one is handled asynchronously, in order, and the index of the next to handle; `undefined`
+     * while none waits.
+     */
+    #held;
+    /** Whether a message is being handled asynchronously: the held ones wait. */
+    #waiting = false;
+    #hello;
+    /** Counts the bytes of the encoded messages (sizes the channel has). */
+    #bytes;
+    constructor(link, handler, options, context) {
+        this.#link = link;
+        this.#bytes = options.metrics.counter("chord.link.bytes");
+        this.#codec = options.codec;
+        this.#handler = handler;
+        this.#report = options.report;
+        this.#trusted = options.trusted;
+        this.#context = context;
+        this.#hello = this.#codec.encode({
+            kind: "hello",
+            protocol: PROTOCOL_VERSION,
+            incarnation: options.incarnation,
+            calls: options.calls,
+        });
+    }
+    /**
+     * Sends `hello` and starts listening: messages that arrived already are handled now, and a link closed already
+     * calls `closed` now; so the handler is complete before it starts.
+     */
+    start() {
+        this.#bytes.add(this.#hello.byteLength, SENT);
+        this.#link.send(this.#hello);
+        this.#link.onMessage((bytes) => this.#receive(bytes));
+        this.#link.onClose(() => this.#closed());
+    }
+    /** The peer's incarnation, from its `hello`; empty before it arrived (nothing else can arrive before it). */
+    get peer() {
+        return this.#state.kind === "open" ? this.#state.peer : "";
+    }
+    /** How many concurrent calls the peer accepts, from its `hello`; 0 before it arrived. */
+    get peerCalls() {
+        return this.#state.kind === "open" ? this.#state.calls : 0;
+    }
+    get opened() {
+        return this.#state.kind === "open";
+    }
+    get closed() {
+        return this.#state.kind === "closed";
+    }
+    /** Sends one message; before the handshake it waits, after the close it is dropped. */
+    send(message) {
+        const state = this.#state;
+        if (state.kind === "closed")
+            return;
+        const bytes = this.#codec.encode(message);
+        this.#bytes.add(bytes.byteLength, SENT);
+        if (state.kind === "greeting")
+            state.queued.push(bytes);
+        else
+            this.#link.send(bytes);
+    }
+    close() {
+        this.#link.close();
+    }
+    /**
+     * The heartbeat, at `now`: a link silent for `close` ms (the handshake included) closes; an open one silent for
+     * `ping` ms sends one `ping`. `paused` ms this process did not run before it are no silence: what the peer sent
+     * meanwhile is still unread (timers run before I/O). The silence stays what it was before the pause, at least `ping`
+     * ms, so a dead peer (a dropped TCP connection) is found `close - ping` ms later.
+     */
+    tick(now, paused, ping, close) {
+        if (paused > 0)
+            this.#lastReceived = Math.min(this.#lastReceived + paused, now - ping);
+        const silent = now - this.#lastReceived;
+        if (silent >= close)
+            this.close();
+        else if (silent >= ping && !this.#pinged && this.#state.kind === "open") {
+            this.#pinged = true;
+            this.#link.send(this.#codec.encode({ kind: "ping" }));
+        }
+    }
+    #receive(bytes) {
+        if (this.#state.kind === "closed")
+            return;
+        this.#bytes.add(bytes.byteLength, RECEIVED);
+        this.#lastReceived = Date.now();
+        this.#pinged = false;
+        if (this.#held === undefined)
+            this.#handle(bytes);
+        else
+            this.#held.queue.push(bytes);
+    }
+    /** Handles one received message; one the handler handles asynchronously holds the next until it settles. */
+    #handle(bytes) {
+        const state = this.#state;
+        try {
+            if (state.kind === "greeting") {
+                this.#greet(bytes, state.queued);
+                return;
+            }
+            const message = this.#decode(bytes);
+            if (message.kind === "hello")
+                throw new Error("handshake: a second hello");
+            // Control of the link itself, never queued behind the window.
+            if (message.kind === "ping")
+                this.#link.send(this.#codec.encode({ kind: "pong" }));
+            else if (message.kind !== "pong") {
+                const handling = this.#handler.message(message);
+                if (handling !== undefined)
+                    this.#hold(handling);
+            }
+        }
+        catch (error) {
+            this.#failed(error);
+        }
+    }
+    /** Holds later messages until `handling` settles, then handles them in order (each may hold again). */
+    #hold(handling) {
+        this.#held ??= { queue: [], next: 0 };
+        this.#waiting = true;
+        handling.then(() => {
+            this.#waiting = false;
+            this.#release();
+        }, (error) => this.#failed(error));
+    }
+    /**
+     * The held message was handled: the ones behind it are handled in order, until one holds again (the handled ones are
+     * dropped from the queue then).
+     */
+    #release() {
+        const held = this.#held;
+        if (held === undefined)
+            return;
+        while (held.next < held.queue.length) {
+            if (this.#state.kind !== "open")
+                return;
+            this.#handle(held.queue[held.next++]);
+            if (this.#waiting) {
+                held.queue.splice(0, held.next);
+                held.next = 0;
+                return;
+            }
+        }
+        this.#held = undefined;
+    }
+    /** A protocol error: reported, and the link closes. */
+    #failed(error) {
+        if (this.#state.kind === "closed")
+            return;
+        this.#report(error);
+        this.close();
+    }
+    /** A message from its bytes, checked against the message schema unless the link is trusted. */
+    #decode(bytes) {
+        const message = this.#codec.decode(bytes);
+        return this.#trusted ? message : checkMessage(message, this.#context);
+    }
+    /** The first message: the peer's `hello` in this link's codec and protocol version. */
+    #greet(bytes, queued) {
+        let message;
+        try {
+            message = this.#decode(bytes);
+        }
+        catch (error) {
+            throw new Error(`handshake: the first message is no ${this.#codec.name} message`, { cause: error });
+        }
+        if (message.kind !== "hello")
+            throw new Error(`handshake: ${message.kind} before hello`);
+        if (message.protocol !== PROTOCOL_VERSION) {
+            throw new Error(`handshake: protocol ${message.protocol}, this host speaks ${PROTOCOL_VERSION}`);
+        }
+        this.#state = { kind: "open", peer: message.incarnation, calls: message.calls };
+        for (const bytes of queued)
+            this.#link.send(bytes);
+        this.#handler.opened();
+    }
+    #closed() {
+        if (this.#state.kind === "closed")
+            return;
+        this.#state = { kind: "closed" };
+        this.#held = undefined;
+        this.#handler.closed();
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/link/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/link/channel.ts"],"names":[],"mappings":"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","sourcesContent":["// A host's end of a link (§3, §22, 2b): the handshake, the link's codec, the checks of every message (skipped on a\n// trusted link), the heartbeat, and messages handled in order while one waits for an asynchronous inflate; a protocol\n// error closes the link. The bytes of every message it encodes and receives are counted (`chord.link.bytes`).\n\nimport type { Context } from \"../context/index.ts\";\nimport { PROTOCOL_VERSION } from \"../data/internal.ts\";\nimport type { ChordCounter, ChordMetrics } from \"../telemetry.ts\";\nimport type { Link } from \"./link.ts\";\nimport { type Codec, checkMessage, type Message } from \"./message.ts\";\n\n/** What the owner of a channel handles. */\nexport interface ChannelHandler {\n\t/** The peer's `hello` arrived: the link is open. */\n\topened(): void;\n\t/**\n\t * A checked message after the handshake (never `hello`, `ping` or `pong`). A throw is a protocol error. A promise\n\t * (the message waits for an asynchronous inflate) holds every later message until it settles; a rejection is a\n\t * protocol error too.\n\t */\n\tmessage(message: Message): void | Promise<void>;\n\t/** The link closed, from either end; called once. */\n\tclosed(): void;\n}\n\n/** What a channel is made with besides its link and handler. */\ntype ChannelOptions = {\n\treadonly codec: Codec;\n\t/** This host's incarnation, sent in `hello`. */\n\treadonly incarnation: string;\n\t/** How many concurrent calls this side accepts, sent in `hello`. */\n\treadonly calls: number;\n\t/** Skips the `MESSAGE` check (framing, the codec's decode and the owners' checks still run). */\n\treadonly trusted: boolean;\n\t/** Where protocol errors go. */\n\treadonly report: (error: unknown) => void;\n\t/** The host's instruments: the bytes of every encoded message sent and received (`chord.link.bytes`). */\n\treadonly metrics: ChordMetrics;\n};\n\n/** `chord.link.bytes`' attributes, made once. */\nconst SENT = { direction: \"sent\" } as const;\n\nconst RECEIVED = { direction: \"received\" } as const;\n\n/**\n * Where a channel stands: `greeting` until the peer's `hello`, with what this end sent meanwhile; `open` with the\n * peer's incarnation and call window.\n */\ntype ChannelState =\n\t| { readonly kind: \"greeting\"; readonly queued: Uint8Array[] }\n\t| { readonly kind: \"open\"; readonly peer: string; readonly calls: number }\n\t| { readonly kind: \"closed\" };\n\n/**\n * One end of a link. It sends `hello { protocol, incarnation, calls }` first and nothing else until the peer's arrived\n * (its own messages wait). Every message is decoded by the link's codec and, unless the link is trusted, checked\n * against the message schema; a first message that is no `hello` of this codec, a second `hello`, another protocol\n * version, or a message failing a check closes the link and is reported. The heartbeat: every received message\n * stamps `lastReceived`; the host's timer calls `tick`, which pings a silent open link and closes a link silent for\n * too long (the handshake included); a `ping` is answered with `pong` at once. A message the handler handles\n * asynchronously holds the later ones, `ping` included, until it settles; they are handled in order then, and dropped\n * when the link closes meanwhile.\n */\nexport class Channel {\n\treadonly #link: Link;\n\treadonly #codec: Codec;\n\treadonly #handler: ChannelHandler;\n\treadonly #report: (error: unknown) => void;\n\treadonly #trusted: boolean;\n\treadonly #context: Context;\n\t#state: ChannelState = { kind: \"greeting\", queued: [] };\n\t/** When the last message arrived (`Date.now()`), or the channel was made. */\n\t#lastReceived = Date.now();\n\t/** Whether a `ping` went out since the last received message. */\n\t#pinged = false;\n\t/**\n\t * Messages received while one is handled asynchronously, in order, and the index of the next to handle; `undefined`\n\t * while none waits.\n\t */\n\t#held: { queue: Uint8Array[]; next: number } | undefined;\n\t/** Whether a message is being handled asynchronously: the held ones wait. */\n\t#waiting = false;\n\treadonly #hello: Uint8Array;\n\t/** Counts the bytes of the encoded messages (sizes the channel has). */\n\treadonly #bytes: ChordCounter<\"chord.link.bytes\">;\n\n\tconstructor(link: Link, handler: ChannelHandler, options: ChannelOptions, context: Context) {\n\t\tthis.#link = link;\n\t\tthis.#bytes = options.metrics.counter(\"chord.link.bytes\");\n\t\tthis.#codec = options.codec;\n\t\tthis.#handler = handler;\n\t\tthis.#report = options.report;\n\t\tthis.#trusted = options.trusted;\n\t\tthis.#context = context;\n\t\tthis.#hello = this.#codec.encode({\n\t\t\tkind: \"hello\",\n\t\t\tprotocol: PROTOCOL_VERSION,\n\t\t\tincarnation: options.incarnation,\n\t\t\tcalls: options.calls,\n\t\t});\n\t}\n\n\t/**\n\t * Sends `hello` and starts listening: messages that arrived already are handled now, and a link closed already\n\t * calls `closed` now; so the handler is complete before it starts.\n\t */\n\tstart(): void {\n\t\tthis.#bytes.add(this.#hello.byteLength, SENT);\n\t\tthis.#link.send(this.#hello);\n\t\tthis.#link.onMessage((bytes) => this.#receive(bytes));\n\t\tthis.#link.onClose(() => this.#closed());\n\t}\n\n\t/** The peer's incarnation, from its `hello`; empty before it arrived (nothing else can arrive before it). */\n\tget peer(): string {\n\t\treturn this.#state.kind === \"open\" ? this.#state.peer : \"\";\n\t}\n\n\t/** How many concurrent calls the peer accepts, from its `hello`; 0 before it arrived. */\n\tget peerCalls(): number {\n\t\treturn this.#state.kind === \"open\" ? this.#state.calls : 0;\n\t}\n\n\tget opened(): boolean {\n\t\treturn this.#state.kind === \"open\";\n\t}\n\n\tget closed(): boolean {\n\t\treturn this.#state.kind === \"closed\";\n\t}\n\n\t/** Sends one message; before the handshake it waits, after the close it is dropped. */\n\tsend(message: Message): void {\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"closed\") return;\n\t\tconst bytes = this.#codec.encode(message);\n\t\tthis.#bytes.add(bytes.byteLength, SENT);\n\t\tif (state.kind === \"greeting\") state.queued.push(bytes);\n\t\telse this.#link.send(bytes);\n\t}\n\n\tclose(): void {\n\t\tthis.#link.close();\n\t}\n\n\t/**\n\t * The heartbeat, at `now`: a link silent for `close` ms (the handshake included) closes; an open one silent for\n\t * `ping` ms sends one `ping`. `paused` ms this process did not run before it are no silence: what the peer sent\n\t * meanwhile is still unread (timers run before I/O). The silence stays what it was before the pause, at least `ping`\n\t * ms, so a dead peer (a dropped TCP connection) is found `close - ping` ms later.\n\t */\n\ttick(now: number, paused: number, ping: number, close: number): void {\n\t\tif (paused > 0) this.#lastReceived = Math.min(this.#lastReceived + paused, now - ping);\n\t\tconst silent = now - this.#lastReceived;\n\t\tif (silent >= close) this.close();\n\t\telse if (silent >= ping && !this.#pinged && this.#state.kind === \"open\") {\n\t\t\tthis.#pinged = true;\n\t\t\tthis.#link.send(this.#codec.encode({ kind: \"ping\" }));\n\t\t}\n\t}\n\n\t#receive(bytes: Uint8Array): void {\n\t\tif (this.#state.kind === \"closed\") return;\n\t\tthis.#bytes.add(bytes.byteLength, RECEIVED);\n\t\tthis.#lastReceived = Date.now();\n\t\tthis.#pinged = false;\n\t\tif (this.#held === undefined) this.#handle(bytes);\n\t\telse this.#held.queue.push(bytes);\n\t}\n\n\t/** Handles one received message; one the handler handles asynchronously holds the next until it settles. */\n\t#handle(bytes: Uint8Array): void {\n\t\tconst state = this.#state;\n\t\ttry {\n\t\t\tif (state.kind === \"greeting\") {\n\t\t\t\tthis.#greet(bytes, state.queued);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst message = this.#decode(bytes);\n\t\t\tif (message.kind === \"hello\") throw new Error(\"handshake: a second hello\");\n\t\t\t// Control of the link itself, never queued behind the window.\n\t\t\tif (message.kind === \"ping\") this.#link.send(this.#codec.encode({ kind: \"pong\" }));\n\t\t\telse if (message.kind !== \"pong\") {\n\t\t\t\tconst handling = this.#handler.message(message);\n\t\t\t\tif (handling !== undefined) this.#hold(handling);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthis.#failed(error);\n\t\t}\n\t}\n\n\t/** Holds later messages until `handling` settles, then handles them in order (each may hold again). */\n\t#hold(handling: Promise<void>): void {\n\t\tthis.#held ??= { queue: [], next: 0 };\n\t\tthis.#waiting = true;\n\t\thandling.then(\n\t\t\t() => {\n\t\t\t\tthis.#waiting = false;\n\t\t\t\tthis.#release();\n\t\t\t},\n\t\t\t(error: unknown) => this.#failed(error),\n\t\t);\n\t}\n\n\t/**\n\t * The held message was handled: the ones behind it are handled in order, until one holds again (the handled ones are\n\t * dropped from the queue then).\n\t */\n\t#release(): void {\n\t\tconst held = this.#held;\n\t\tif (held === undefined) return;\n\t\twhile (held.next < held.queue.length) {\n\t\t\tif (this.#state.kind !== \"open\") return;\n\t\t\tthis.#handle(held.queue[held.next++]!);\n\t\t\tif (this.#waiting) {\n\t\t\t\theld.queue.splice(0, held.next);\n\t\t\t\theld.next = 0;\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tthis.#held = undefined;\n\t}\n\n\t/** A protocol error: reported, and the link closes. */\n\t#failed(error: unknown): void {\n\t\tif (this.#state.kind === \"closed\") return;\n\t\tthis.#report(error);\n\t\tthis.close();\n\t}\n\n\t/** A message from its bytes, checked against the message schema unless the link is trusted. */\n\t#decode(bytes: Uint8Array): Message {\n\t\tconst message = this.#codec.decode(bytes);\n\t\treturn this.#trusted ? message : checkMessage(message, this.#context);\n\t}\n\n\t/** The first message: the peer's `hello` in this link's codec and protocol version. */\n\t#greet(bytes: Uint8Array, queued: readonly Uint8Array[]): void {\n\t\tlet message: Message;\n\t\ttry {\n\t\t\tmessage = this.#decode(bytes);\n\t\t} catch (error) {\n\t\t\tthrow new Error(`handshake: the first message is no ${this.#codec.name} message`, { cause: error });\n\t\t}\n\t\tif (message.kind !== \"hello\") throw new Error(`handshake: ${message.kind} before hello`);\n\t\tif (message.protocol !== PROTOCOL_VERSION) {\n\t\t\tthrow new Error(`handshake: protocol ${message.protocol}, this host speaks ${PROTOCOL_VERSION}`);\n\t\t}\n\t\tthis.#state = { kind: \"open\", peer: message.incarnation, calls: message.calls };\n\t\tfor (const bytes of queued) this.#link.send(bytes);\n\t\tthis.#handler.opened();\n\t}\n\n\t#closed(): void {\n\t\tif (this.#state.kind === \"closed\") return;\n\t\tthis.#state = { kind: \"closed\" };\n\t\tthis.#held = undefined;\n\t\tthis.#handler.closed();\n\t}\n}\n"]}

package/dist/link/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/link/errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAgB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,oHAAoH;AACpH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAOnD;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAIxE"}

package/dist/link/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/link/errors.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,OAAO,EAAmB,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD,oHAAoH;AACpH,MAAM,UAAU,SAAS,CAAC,KAAc;IACvC,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;IACzE,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QAClC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC9G,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnE,8CAA8C;IAC9C,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAgC,CAAC,CAAC;AAC3F,CAAC","sourcesContent":["// Errors on the wire: a ChordError's JSON or a plugin's code, message and details; never a stack or a cause.\n\nimport { type ChordError, isChordError, PluginError } from \"../data/index.ts\";\nimport { chordErrorFromJson } from \"../data/internal.ts\";\nimport type { JsonValue } from \"../json.ts\";\nimport type { WireError } from \"./message.ts\";\n\n/** What crosses for a thrown value: a ChordError, a PluginError, or anything else as the plugin code `internal`. */\nexport function wireError(error: unknown): WireError {\n\tif (isChordError(error)) return { kind: \"chord\", error: error.toJSON() };\n\tif (error instanceof PluginError) {\n\t\tconst { code, message, details } = error;\n\t\treturn { kind: \"plugin\", code, message, ...(details === undefined ? {} : { details }) };\n\t}\n\treturn { kind: \"plugin\", code: \"internal\", message: error instanceof Error ? error.message : String(error) };\n}\n\n/** The error a consumer rethrows. A malformed ChordError envelope throws (a protocol error). */\nexport function errorFromWire(error: WireError): ChordError | PluginError {\n\tif (error.kind === \"chord\") return chordErrorFromJson(error.error);\n\t// Fresh JSON from the link: details are JSON.\n\treturn new PluginError(error.code, error.message, error.details as JsonValue | undefined);\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/link/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,KAAK,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/link/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/link/index.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,oEAAoE;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAgB,OAAO,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAa,cAAc,EAAE,MAAM,WAAW,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAsB,aAAa,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["// Links for apps: the link interface adapters implement, the in-memory pair, IPC and WebSocket links, the codecs a link\n// may use, its limits per part and the compressor a host may bring.\n\nexport { binaryCodec } from \"./binary.ts\";\nexport { type IpcPort, ipcLink } from \"./ipc.ts\";\nexport { type Link, memoryLinkPair } from \"./link.ts\";\nexport type { Codec, Message } from \"./message.ts\";\nexport type { Compression, Inflated, PartLimits } from \"./part.ts\";\nexport { describeMessage, textCodec } from \"./text.ts\";\nexport { type WebSocketLike, webSocketLink } from \"./websocket.ts\";\n"]}

package/dist/link/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/link/internal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACN,KAAK,UAAU,EACf,KAAK,EACL,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,WAAW,EAChB,YAAY,EACZ,YAAY,EACZ,KAAK,MAAM,EACX,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,KAAK,IAAI,EACT,KAAK,UAAU,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/link/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/link/internal.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,iFAAiF;AAEjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAuB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAEN,KAAK,EAGL,YAAY,EAGZ,UAAU,EAGV,UAAU,GAGV,MAAM,cAAc,CAAC;AACtB,OAAO,EAEN,YAAY,EACZ,YAAY,EAEZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,GAGT,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC","sourcesContent":["// Links for Chord's layers: a host's end of a link (handshake, codec, checks, heartbeat and in-order handling), the\n// message type, parts with their limits and compression, and errors in messages.\n\nexport { binaryCodec } from \"./binary.ts\";\nexport { Channel, type ChannelHandler } from \"./channel.ts\";\nexport { errorFromWire, wireError } from \"./errors.ts\";\nexport type { Link } from \"./link.ts\";\nexport {\n\ttype BoundEntry,\n\tCHAIN,\n\ttype Codec,\n\ttype ConsumerMessage,\n\tcheckMessage,\n\ttype FailedMember,\n\ttype Message,\n\tNO_RETIRED,\n\ttype OriginMessage,\n\ttype ProviderMessage,\n\tRETRY_HOPS,\n\ttype StateEntry,\n\ttype WireAddress,\n} from \"./message.ts\";\nexport {\n\ttype Compression,\n\tDeflatedPart,\n\tinflateAsync,\n\ttype Limits,\n\tlinkLimits,\n\topenPart,\n\toriginPart,\n\toversized,\n\ttype Part,\n\ttype PartLimits,\n} from \"./part.ts\";\nexport { describeMessage, textCodec } from \"./text.ts\";\nexport { jsonPart, parsePart, parsePayload, payloadPart } from \"./values.ts\";\n"]}

package/dist/link/ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../src/link/ipc.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,IAAI,EAAW,MAAM,WAAW,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,OAAO;IACvB,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC;IAC5E,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IACpE,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACvD,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IAChF,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACnE,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE3C"}

package/dist/link/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../../src/link/ipc.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,iFAAiF;AAEjF,OAAO,EAAa,OAAO,EAAE,MAAM,WAAW,CAAC;AAgB/C;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAa;IACpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,OAAQ,SAAQ,OAAO;IAC5B,uCAAuC;IACvC,KAAK,CAAsB;IAClB,UAAU,GAAG,CAAC,OAAgB,EAAQ,EAAE;QAChD,IAAI,OAAO,YAAY,UAAU;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC,CAAC;IACO,aAAa,GAAG,GAAS,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,GAAG,CAAC,KAAmB,EAAQ,EAAE;QAChD,IAAI,KAAK,KAAK,IAAI;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC,CAAC;IAEF,YAAY,IAAa;QACxB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO;QACR,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,OAAmB;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,IAAI,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,IAAI,EAAE,CAAC;QACb,CAAC;IACF,CAAC;IAED,KAAK;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,oEAAoE;QACpE,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC;IAED,kDAAkD;IAClD,IAAI;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,EAAE,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,EAAE,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;CACD","sourcesContent":["// IPC links (§3): a link over a Node IPC channel, a forked child (`fork` with `serialization: \"advanced\"`) or\n// `process` in the child, typed structurally so Chord imports nothing from Node.\n\nimport { type Link, LinkEnd } from \"./link.ts\";\n\n/**\n * The part of a Node IPC channel a link uses: a `ChildProcess` or the child's `process`. `send` returning `false` is\n * backpressure (the message is queued by Node), not a failure.\n */\nexport interface IpcPort {\n\tsend(message: Uint8Array, callback: (error: Error | null) => void): boolean;\n\ton(event: \"message\", listener: (message: unknown) => void): unknown;\n\ton(event: \"disconnect\", listener: () => void): unknown;\n\tremoveListener(event: \"message\", listener: (message: unknown) => void): unknown;\n\tremoveListener(event: \"disconnect\", listener: () => void): unknown;\n\tdisconnect(): void;\n\treadonly connected: boolean;\n}\n\n/**\n * A link over `port`: each message one `Uint8Array` (V8 serialization keeps it one). It listens from the moment it is\n * made and queues messages until its listener is set, so a child makes it before awaiting its start message; messages\n * that are no `Uint8Array` (the app's own, such as that start message) are not the link's and are skipped. A thrown\n * `send`, an error in its callback or `disconnect` closes the link once; its listeners are removed then.\n */\nexport function ipcLink(port: IpcPort): Link {\n\treturn new IpcLink(port);\n}\n\nclass IpcLink extends LinkEnd {\n\t/** The port while the link is open. */\n\t#port: IpcPort | undefined;\n\treadonly #onMessage = (message: unknown): void => {\n\t\tif (message instanceof Uint8Array) this.deliver(message);\n\t};\n\treadonly #onDisconnect = (): void => this.#end();\n\treadonly #onSent = (error: Error | null): void => {\n\t\tif (error !== null) this.#end();\n\t};\n\n\tconstructor(port: IpcPort) {\n\t\tsuper();\n\t\tthis.#port = port;\n\t\tif (!port.connected) {\n\t\t\tthis.#end();\n\t\t\treturn;\n\t\t}\n\t\tport.on(\"message\", this.#onMessage);\n\t\tport.on(\"disconnect\", this.#onDisconnect);\n\t}\n\n\tsend(message: Uint8Array): void {\n\t\tconst port = this.#port;\n\t\tif (port === undefined) return;\n\t\ttry {\n\t\t\tport.send(message, this.#onSent);\n\t\t} catch {\n\t\t\tthis.#end();\n\t\t}\n\t}\n\n\tclose(): void {\n\t\tconst port = this.#port;\n\t\tif (port === undefined) return;\n\t\tthis.#end();\n\t\t// Disconnecting a channel that is gone already would emit an error.\n\t\tif (port.connected) port.disconnect();\n\t}\n\n\t/** Detaches from the port and closes this end. */\n\t#end(): void {\n\t\tconst port = this.#port;\n\t\tthis.#port = undefined;\n\t\tport?.removeListener(\"message\", this.#onMessage);\n\t\tport?.removeListener(\"disconnect\", this.#onDisconnect);\n\t\tthis.ended();\n\t}\n}\n"]}

package/dist/link/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/link/link.ts"],"names":[],"mappings":"AAEA,8GAA8G;AAC9G,MAAM,WAAW,IAAI;IACpB,8CAA8C;IAC9C,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAC;IACd,0GAA0G;IAC1G,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACpC;AAED,6GAA6G;AAC7G,wBAAgB,cAAc,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAM7C;AAED;;;;GAIG;AACH,8BAAsB,OAAQ,YAAW,IAAI;;IAO5C,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAEzC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC;IAEvB,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CASvD;IAED,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAGlC;IAED,8CAA8C;IAC9C,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAI3C;IAED,sGAAsG;IACtG,SAAS,CAAC,KAAK,IAAI,IAAI,CAQtB;CACD"}

package/dist/link/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/link/link.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAiBvG,6GAA6G;AAC7G,MAAM,UAAU,cAAc;IAC7B,MAAM,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC;IAC3B,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACX,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAgB,OAAO;IAC5B,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,CAA8C;IACvD,yDAAyD;IACzD,OAAO,GAAiB,EAAE,CAAC;IAC3B,cAAc,CAA2B;IAMzC,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,QAAuC;QAChD,4EAA4E;QAC5E,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,uEAAuE;QACvE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO;YACzB,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;IACF,CAAC;IAED,OAAO,CAAC,QAAoB;QAC3B,IAAI,IAAI,CAAC,OAAO;YAAE,QAAQ,EAAE,CAAC;;YACxB,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;IACrC,CAAC;IAED,8CAA8C;IACpC,OAAO,CAAC,OAAmB;QACpC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;;YACxD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,sGAAsG;IAC5F,KAAK;QACd,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,QAAQ,EAAE,EAAE,CAAC;IACd,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAW,SAAQ,OAAO;IAC/B,IAAI,CAAyB;IAE7B,IAAI,CAAC,OAAmB;QACvB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAK,CAAC;QACxB,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAK,CAAC;QACxB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI;QACH,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;CACD","sourcesContent":["// Links (§3): an ordered, bidirectional channel of messages between two hosts, and the in-memory pair.\n\n/** An ordered, bidirectional channel of `Uint8Array` messages between two hosts. Adapters only move bytes. */\nexport interface Link {\n\t/** Sends one message; a no-op once closed. */\n\tsend(message: Uint8Array): void;\n\t/**\n\t * Sets the one listener for incoming messages; messages that arrived earlier are delivered to it first. On a closed\n\t * link it is not kept.\n\t */\n\tonMessage(listener: (message: Uint8Array) => void): void;\n\t/** Closes both ends; messages not delivered yet are dropped. */\n\tclose(): void;\n\t/** Sets the one listener for the close of either end; it runs at once when the link is closed already. */\n\tonClose(listener: () => void): void;\n}\n\n/** Two ends of one link: what one sends, the other receives asynchronously (a microtask later), in order. */\nexport function memoryLinkPair(): [Link, Link] {\n\tconst a = new MemoryLink();\n\tconst b = new MemoryLink();\n\ta.peer = b;\n\tb.peer = a;\n\treturn [a, b];\n}\n\n/**\n * What every link end shares: the one message listener (messages that arrived before it are queued for it), the one\n * close listener, and closing once. Subclasses move the bytes: `deliver` what arrived, `ended` when the transport\n * closed, and implement `send` and `close`.\n */\nexport abstract class LinkEnd implements Link {\n\t#closed = false;\n\t#listener: ((message: Uint8Array) => void) | undefined;\n\t/** Messages that arrived before the listener was set. */\n\t#queued: Uint8Array[] = [];\n\t#closeListener: (() => void) | undefined;\n\n\tabstract send(message: Uint8Array): void;\n\n\tabstract close(): void;\n\n\tget closed(): boolean {\n\t\treturn this.#closed;\n\t}\n\n\tonMessage(listener: (message: Uint8Array) => void): void {\n\t\t// A closed end delivers nothing: keeping the listener would keep its owner.\n\t\tif (this.#closed) return;\n\t\tthis.#listener = listener;\n\t\t// A listener may close the link: what is still queued then is dropped.\n\t\tfor (const message of this.#queued.splice(0)) {\n\t\t\tif (this.#closed) return;\n\t\t\tlistener(message);\n\t\t}\n\t}\n\n\tonClose(listener: () => void): void {\n\t\tif (this.#closed) listener();\n\t\telse this.#closeListener = listener;\n\t}\n\n\t/** A message arrived; dropped once closed. */\n\tprotected deliver(message: Uint8Array): void {\n\t\tif (this.#closed) return;\n\t\tif (this.#listener === undefined) this.#queued.push(message);\n\t\telse this.#listener(message);\n\t}\n\n\t/** Closes this end (once): nothing is delivered any more, and nothing the listeners reach is kept. */\n\tprotected ended(): void {\n\t\tif (this.#closed) return;\n\t\tthis.#closed = true;\n\t\tconst listener = this.#closeListener;\n\t\tthis.#listener = undefined;\n\t\tthis.#closeListener = undefined;\n\t\tthis.#queued = [];\n\t\tlistener?.();\n\t}\n}\n\n/**\n * One end of a memory link. Closing it closes this end at once and the peer a microtask later, as a transport would.\n * Portable: `queueMicrotask` only.\n */\nclass MemoryLink extends LinkEnd {\n\tpeer: MemoryLink | undefined;\n\n\tsend(message: Uint8Array): void {\n\t\tif (this.closed) return;\n\t\tconst peer = this.peer!;\n\t\tqueueMicrotask(() => peer.deliver(message));\n\t}\n\n\tclose(): void {\n\t\tif (this.closed) return;\n\t\tconst peer = this.peer!;\n\t\tthis.#end();\n\t\tqueueMicrotask(() => peer.#end());\n\t}\n\n\t#end(): void {\n\t\tthis.peer = undefined;\n\t\tthis.ended();\n\t}\n}\n"]}