transport-io 0.0.1

package/dist/transport/loopback.js

@@ -0,0 +1,98 @@
+class Side {
+    peer;
+    #emitStreamCb;
+    #bidiCb;
+    #datagramCb;
+    // A real transport queues an incoming stream or datagram until the application reads
+    // it. Dispatching immediately would drop anything that arrives before the peer has
+    // registered its handler, which is a race the real thing does not have.
+    #pendingEmit = [];
+    #pendingBidi = [];
+    #pendingDatagrams = [];
+    #resolveClosed;
+    #closedFlag = false;
+    closed;
+    #maxDatagram;
+    constructor(maxDatagram) {
+        this.#maxDatagram = maxDatagram;
+        this.closed = new Promise((res) => {
+            this.#resolveClosed = res;
+        });
+    }
+    async openEmitStream() {
+        const { readable, writable } = new TransformStream();
+        queueMicrotask(() => this.peer.#acceptEmit(readable));
+        return writable;
+    }
+    onEmitStream(cb) {
+        this.#emitStreamCb = cb;
+        while (this.#pendingEmit.length > 0)
+            cb(this.#pendingEmit.shift());
+    }
+    #acceptEmit(r) {
+        if (this.#emitStreamCb === undefined)
+            this.#pendingEmit.push(r);
+        else
+            this.#emitStreamCb(r);
+    }
+    async openBidi() {
+        const up = new TransformStream();
+        const down = new TransformStream();
+        queueMicrotask(() => this.peer.#acceptBidi({ readable: up.readable, writable: down.writable }));
+        return { readable: down.readable, writable: up.writable };
+    }
+    onBidi(cb) {
+        this.#bidiCb = cb;
+        while (this.#pendingBidi.length > 0)
+            cb(this.#pendingBidi.shift());
+    }
+    #acceptBidi(s) {
+        if (this.#bidiCb === undefined)
+            this.#pendingBidi.push(s);
+        else
+            this.#bidiCb(s);
+    }
+    sendDatagram(bytes) {
+        if (this.#closedFlag)
+            return;
+        // Mirrors the real transport: an oversized datagram is accepted and discarded with no
+        // error. Our layer checks the size before ever reaching here.
+        if (bytes.byteLength > this.#maxDatagram)
+            return;
+        const copy = bytes.slice();
+        queueMicrotask(() => this.peer.#acceptDatagram(copy));
+    }
+    onDatagram(cb) {
+        this.#datagramCb = cb;
+        while (this.#pendingDatagrams.length > 0)
+            cb(this.#pendingDatagrams.shift());
+    }
+    #acceptDatagram(b) {
+        if (this.#datagramCb === undefined)
+            this.#pendingDatagrams.push(b);
+        else
+            this.#datagramCb(b);
+    }
+    maxDatagramSize() {
+        return this.#maxDatagram;
+    }
+    reliability() {
+        return 'supports-unreliable';
+    }
+    close(code, reason) {
+        if (this.#closedFlag)
+            return;
+        this.#closedFlag = true;
+        const info = { code, reason };
+        this.#resolveClosed(info);
+        queueMicrotask(() => this.peer.close(code, reason));
+    }
+}
+export function loopbackPair(maxDatagram = 1024) {
+    const a = new Side(maxDatagram);
+    const b = new Side(maxDatagram);
+    a.peer = b;
+    b.peer = a;
+    return [a, b];
+}
+//# sourceMappingURL=loopback.js.map

package/dist/transport/loopback.js.map

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

package/dist/transport/moq.node.d.ts

@@ -0,0 +1,19 @@
+import type { Connection } from './types.ts';
+export interface MoqServerOptions {
+    readonly port: number;
+    readonly host?: string;
+    readonly cert: string;
+    readonly privKey: string;
+}
+export interface MoqListener {
+    readonly port: number;
+    sessions(): AsyncIterable<Connection>;
+    stop(): void;
+}
+export declare function listenMoq(opts: MoqServerOptions): Promise<MoqListener>;
+export interface MoqClientOptions {
+    readonly url: string;
+    readonly certificateHash: Uint8Array;
+}
+export declare function connectMoq(opts: MoqClientOptions): Promise<Connection>;
+//# sourceMappingURL=moq.node.d.ts.map

package/dist/transport/moq.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moq.node.d.ts","sourceRoot":"","sources":["../../src/transport/moq.node.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAyB,UAAU,EAAE,MAAM,YAAY,CAAA;AA0NnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,IAAI,aAAa,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,IAAI,IAAI,CAAA;CACb;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAA;CACrC;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAY5E"}

package/dist/transport/moq.node.js

@@ -0,0 +1,211 @@
+/**
+ * The alternative transport, behind the same seam.
+ *
+ * `@moq/web-transport` is a NAPI-RS binding over a Rust QUIC stack. It is measured flat
+ * on the per-stream churn that costs the reference binding 11.6 KB (D66), but a byte
+ * count establishes exactly one property. This adapter exists so the existing suite can
+ * run against it unchanged and establish the rest.
+ *
+ * Its surface is promise-and-method based rather than WHATWG streams, so the wrapping
+ * here is thicker than in `fails.node.ts`. That is the seam doing its job.
+ *
+ * It depends on the per-platform NAPI packages directly rather than on
+ * `@moq/web-transport`, whose only entry point is raw TypeScript that Node refuses to
+ * strip inside `node_modules`. Those platform packages are published independently, each
+ * declaring `main` at its own `.node` binary, so this is an ordinary dependency and needs
+ * no cooperation from upstream. See D70.
+ */
+import { createRequire } from 'node:module';
+import { TransportError } from '../errors.js';
+import { DATAGRAM_CONSERVATIVE_FLOOR } from '../protocol.js';
+/**
+ * The per-platform NAPI packages, each of which declares `main` pointing at its own
+ * `.node` binary and carries matching `os`/`cpu` fields.
+ *
+ * This is a normal dependency on a published package's declared entry point. It is NOT
+ * the file-path import that made this transport unadoptable: that reached past
+ * `@moq/web-transport`'s `exports` map into its internal layout, which a patch release
+ * could move without a semver signal. These packages are the interface.
+ */
+const PLATFORM_PACKAGES = {
+    'darwin-arm64': '@moq/web-transport-darwin-arm64',
+    'darwin-x64': '@moq/web-transport-darwin-x64',
+    'linux-x64': '@moq/web-transport-linux-x64-gnu',
+    'linux-arm64': '@moq/web-transport-linux-arm64-gnu',
+    'win32-x64': '@moq/web-transport-win32-x64-msvc',
+};
+let cached;
+function native() {
+    if (cached !== undefined)
+        return cached;
+    const key = `${process.platform}-${process.arch}`;
+    const pkg = PLATFORM_PACKAGES[key];
+    if (pkg === undefined) {
+        throw new TransportError('WT_NO_SUPPORT', `no prebuilt QUIC binding for ${key}`, `Supported: ${Object.keys(PLATFORM_PACKAGES).join(', ')}.`);
+    }
+    try {
+        cached = createRequire(import.meta.url)(pkg);
+        return cached;
+    }
+    catch (cause) {
+        throw new TransportError('WT_NO_SUPPORT', `could not load ${pkg}: ${cause.message}`, `Install it: npm install ${pkg}`);
+    }
+}
+const CHUNK = 65536;
+function toReadable(recv) {
+    return new ReadableStream({
+        async pull(controller) {
+            try {
+                const chunk = await recv.read(CHUNK);
+                if (chunk === null) {
+                    controller.close(); // FIN
+                    return;
+                }
+                controller.enqueue(new Uint8Array(chunk));
+            }
+            catch (e) {
+                controller.error(e);
+            }
+        },
+        cancel(reason) {
+            // STOP_SENDING with an explicit code — no message-string parsing needed here.
+            void recv.stop(codeOf(reason)).catch(() => undefined);
+        },
+    });
+}
+function toWritable(send) {
+    return new WritableStream({
+        async write(chunk) {
+            await send.write(Buffer.from(chunk));
+        },
+        async close() {
+            await send.finish(); // FIN, leaving the read side open
+        },
+        abort(reason) {
+            // RESET_STREAM with an explicit code, likewise.
+            void send.reset(codeOf(reason)).catch(() => undefined);
+        },
+    });
+}
+/**
+ * Both `reset` and `stop` take a numeric code directly, so this transport needs no
+ * equivalent of `resetCodeFromError`. That function exists only because the reference
+ * binding drops the specification's `streamErrorCode` and leaves the message string as
+ * the sole carrier.
+ */
+function codeOf(reason) {
+    if (typeof reason === 'number')
+        return reason & 0xff;
+    const m = /code:\s*(\d+)/i.exec(reason instanceof Error ? reason.message : String(reason));
+    return m?.[1] === undefined ? 0 : Number(m[1]) & 0xff;
+}
+class MoqConnection {
+    #s;
+    closed;
+    constructor(session) {
+        this.#s = session;
+        this.closed = session
+            .closed()
+            .then((i) => ({ code: i.closeCode, reason: i.reason }))
+            .catch(() => ({ code: 0, reason: 'closed' }));
+    }
+    async openEmitStream() {
+        return toWritable(await this.#s.openUni());
+    }
+    onEmitStream(cb) {
+        void (async () => {
+            try {
+                for (;;)
+                    cb(toReadable(await this.#s.acceptUni()));
+            }
+            catch {
+                // Session gone; `closed` reports it.
+            }
+        })();
+    }
+    async openBidi() {
+        const bi = await this.#s.openBi();
+        return { readable: toReadable(bi.takeRecv()), writable: toWritable(bi.takeSend()) };
+    }
+    onBidi(cb) {
+        void (async () => {
+            try {
+                for (;;) {
+                    const bi = await this.#s.acceptBi();
+                    cb({ readable: toReadable(bi.takeRecv()), writable: toWritable(bi.takeSend()) });
+                }
+            }
+            catch {
+                // As above.
+            }
+        })();
+    }
+    sendDatagram(bytes) {
+        try {
+            this.#s.sendDatagram(Buffer.from(bytes));
+        }
+        catch {
+            // Whether this throws on oversize is a property of the binding, not something to
+            // rely on: our layer checks the size before ever getting here.
+        }
+    }
+    onDatagram(cb) {
+        void (async () => {
+            try {
+                for (;;)
+                    cb(new Uint8Array(await this.#s.recvDatagram()));
+            }
+            catch {
+                // As above.
+            }
+        })();
+    }
+    maxDatagramSize() {
+        const r = this.#s.maxDatagramSize();
+        return typeof r === 'number' && r > 0 ? r : DATAGRAM_CONSERVATIVE_FLOOR;
+    }
+    /**
+     * This binding speaks HTTP/3 only and exposes no reliability attribute. `undefined` is
+     * the correct answer and is safe: D10 refuses only an explicit `reliable-only`, and
+     * there is no HTTP/2 mapping here to be negotiated into.
+     */
+    reliability() {
+        return undefined;
+    }
+    close(code, reason) {
+        try {
+            this.#s.close(code, reason.slice(0, 1024));
+        }
+        catch {
+            // Already closed.
+        }
+    }
+}
+export async function listenMoq(opts) {
+    const { NapiServer } = native();
+    const host = opts.host ?? '127.0.0.1';
+    const server = NapiServer.bind(`${host}:${opts.port}`, Buffer.from(opts.cert), Buffer.from(opts.privKey));
+    return {
+        port: opts.port,
+        stop: () => server.close(),
+        async *sessions() {
+            for (;;) {
+                const request = await server.accept();
+                if (request === null)
+                    return;
+                yield new MoqConnection(await request.ok());
+            }
+        },
+    };
+}
+export async function connectMoq(opts) {
+    const { NapiClient } = native();
+    const client = NapiClient.withCertificateHashes([Buffer.from(opts.certificateHash)]);
+    try {
+        return new MoqConnection(await client.connect(opts.url));
+    }
+    catch (cause) {
+        throw new TransportError('WT_SESSION_CLOSED', `could not open a session to ${opts.url}: ${cause.message}`, 'Check the server is listening, that UDP reaches it, and that the certificate hash matches.');
+    }
+}
+//# sourceMappingURL=moq.node.js.map

package/dist/transport/moq.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moq.node.js","sourceRoot":"","sources":["../../src/transport/moq.node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AA0C5D;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAqC;IAC1D,cAAc,EAAE,iCAAiC;IACjD,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE,kCAAkC;IAC/C,aAAa,EAAE,oCAAoC;IACnD,WAAW,EAAE,mCAAmC;CACjD,CAAA;AAED,IAAI,MAA6B,CAAA;AACjC,SAAS,MAAM;IACb,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACvC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAA;IACjD,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,cAAc,CACtB,eAAe,EACf,gCAAgC,GAAG,EAAE,EACrC,cAAc,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3D,CAAA;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAc,CAAA;QACzD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CACtB,eAAe,EACf,kBAAkB,GAAG,KAAM,KAAe,CAAC,OAAO,EAAE,EACpD,2BAA2B,GAAG,EAAE,CACjC,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,KAAK,GAAG,KAAK,CAAA;AAEnB,SAAS,UAAU,CAAC,IAAa;IAC/B,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACpC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,UAAU,CAAC,KAAK,EAAE,CAAA,CAAC,MAAM;oBACzB,OAAM;gBACR,CAAC;gBACD,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;YAC3C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,MAAM;YACX,8EAA8E;YAC9E,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACvD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAa;IAC/B,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QACtC,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA,CAAC,kCAAkC;QACxD,CAAC;QACD,KAAK,CAAC,MAAM;YACV,gDAAgD;YAChD,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACxD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,MAAM,CAAC,MAAe;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,GAAG,IAAI,CAAA;IACpD,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1F,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;AACvD,CAAC;AAED,MAAM,aAAa;IACR,EAAE,CAAY;IACd,MAAM,CAAoB;IAEnC,YAAY,OAAmB;QAC7B,IAAI,CAAC,EAAE,GAAG,OAAO,CAAA;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO;aAClB,MAAM,EAAE;aACR,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;aACtD,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,YAAY,CAAC,EAAkD;QAC7D,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH;oBAAS,EAAE,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;IACN,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAA;QACjC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAA;IACrF,CAAC;IAED,MAAM,CAAC,EAAgC;QACrC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,SAAS,CAAC;oBACR,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAA;oBACnC,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;gBAClF,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;IACN,CAAC;IAED,YAAY,CAAC,KAAiB;QAC5B,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,iFAAiF;YACjF,+DAA+D;QACjE,CAAC;IACH,CAAC;IAED,UAAU,CAAC,EAA+B;QACxC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH;oBAAS,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;IACN,CAAC;IAED,eAAe;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAA;QACnC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAA;IACzE,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,MAAc;QAChC,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;CACF;AAeD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAsB;IACpD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAA;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAA;IACrC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAC5B,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,EACtB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EACtB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAC1B,CAAA;IACD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC1B,KAAK,CAAC,CAAC,QAAQ;YACb,SAAS,CAAC;gBACR,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;gBACrC,IAAI,OAAO,KAAK,IAAI;oBAAE,OAAM;gBAC5B,MAAM,IAAI,aAAa,CAAC,MAAM,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;YAC7C,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAsB;IACrD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACpF,IAAI,CAAC;QACH,OAAO,IAAI,aAAa,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CACtB,mBAAmB,EACnB,+BAA+B,IAAI,CAAC,GAAG,KAAM,KAAe,CAAC,OAAO,EAAE,EACtE,4FAA4F,CAC7F,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/transport/parity-suite.d.ts

@@ -0,0 +1,40 @@
+declare const randomPort: () => number;
+import type { Connection } from './types.ts';
+interface Listener {
+    port: number;
+    sessions: () => AsyncIterable<Connection>;
+    stop: () => void;
+}
+export interface UnderTest {
+    /**
+     * Whether a peer's stream reset reaches the responder's `ctx.signal`.
+     *
+     * `false` is a real capability gap, not a preference. moq surfaces STOP_SENDING only on
+     * the next write, and a long-running handler never makes one, so the handler is not
+     * told to stop. The caller still rejects either way — the work just keeps running.
+     */
+    readonly propagatesAbortToHandler: boolean;
+    readonly name: string;
+    readonly port: number;
+    listen: (o: {
+        port: number;
+        host: string;
+        cert: string;
+        privKey: string;
+    }) => Promise<Listener>;
+    connect: (o: {
+        url: string;
+        certificateHash: Uint8Array;
+    }) => Promise<Connection>;
+}
+/**
+ * One transport per process, deliberately.
+ *
+ * Running both bindings' servers concurrently in a single process hangs — verified: each
+ * works alone and both can bind, but sessions on both at once deadlock. That is a
+ * property of running two native QUIC stacks side by side, not of transport-io, and no
+ * deployment would do it. Splitting by process is also better isolation.
+ */
+export declare function runParity(t: UnderTest): Promise<void>;
+export { randomPort };
+//# sourceMappingURL=parity-suite.d.ts.map

package/dist/transport/parity-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity-suite.d.ts","sourceRoot":"","sources":["../../src/transport/parity-suite.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,UAAU,QAAO,MAAmD,CAAA;AAqB1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAU5C,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AACD,MAAM,WAAW,SAAS;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAA;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,CAAC,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IACvB,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,UAAU,CAAA;KAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CAClF;AAuCD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAqF3D;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/transport/parity-suite.js

@@ -0,0 +1,133 @@
+const randomPort = () => 40000 + Math.floor(Math.random() * 20000);
+/**
+ * The parity suite body, shared by one test file per transport.
+ *
+ * A byte count established that `@moq/web-transport` does not leak (D66). It established
+ * nothing else. This establishes the rest: half-close for `call()`, reset for
+ * `AbortSignal`, `maxDatagramSize`, oversized-datagram behaviour, and both lanes end to
+ * end. The reference binding got each of those wrong in specific ways; this is how we
+ * find out which ways the alternative gets them wrong.
+ */
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { createHash, X509Certificate } from 'node:crypto';
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Client } from '../client.js';
+import { defineContract, type$ } from '../contract.js';
+const contract = defineContract({
+    chat: { lane: 'stream', payload: type$() },
+    cursor: { lane: 'datagram', payload: type$() },
+    echo: { lane: 'stream', payload: type$(), returns: type$() },
+    slow: { lane: 'stream', payload: type$(), returns: type$() },
+});
+// Random high ports. A fixed port makes this suite fail for a reason that has nothing to
+// do with the code — an orphan from a previous killed run still holding the socket, which
+// cost an hour to diagnose once already.
+const dir = mkdtempSync(join(tmpdir(), 'parity-'));
+execFileSync('openssl', [
+    'ecparam',
+    '-name',
+    'prime256v1',
+    '-genkey',
+    '-noout',
+    '-out',
+    join(dir, 'k.pem'),
+]);
+execFileSync('openssl', [
+    'req',
+    '-new',
+    '-x509',
+    '-key',
+    join(dir, 'k.pem'),
+    '-out',
+    join(dir, 'c.pem'),
+    '-days',
+    '14',
+    '-subj',
+    '/CN=localhost',
+    '-addext',
+    'subjectAltName=DNS:localhost,IP:127.0.0.1',
+]);
+const cert = readFileSync(join(dir, 'c.pem'), 'utf8');
+const privKey = readFileSync(join(dir, 'k.pem'), 'utf8');
+const certificateHash = createHash('sha256').update(new X509Certificate(cert).raw).digest();
+const settle = async (ms = 400) => {
+    await new Promise((r) => setTimeout(r, ms));
+};
+/**
+ * One transport per process, deliberately.
+ *
+ * Running both bindings' servers concurrently in a single process hangs — verified: each
+ * works alone and both can bind, but sessions on both at once deadlock. That is a
+ * property of running two native QUIC stacks side by side, not of transport-io, and no
+ * deployment would do it. Splitting by process is also better isolation.
+ */
+export async function runParity(t) {
+    const { createServer } = await import('../server.js');
+    const server = createServer({ contract });
+    await server.listen();
+    server.handle('echo', async ({ n }) => ({ n: n * 2 }));
+    let handlerSawAbort = false;
+    server.handle('slow', async (_p, ctx) => {
+        await new Promise((resolve) => {
+            ctx.signal.addEventListener('abort', () => {
+                handlerSawAbort = true;
+                resolve();
+            }, { once: true });
+            // Bounded, so a transport that never delivers the reset fails an assertion instead
+            // of hanging the suite. That distinction cost an afternoon to find.
+            setTimeout(resolve, 3000);
+        });
+        return null;
+    });
+    server.onSession((peer) => {
+        void peer.join('lobby');
+        peer.on('chat', (p) => void server.to('lobby').emit('chat', p));
+        peer.on('cursor', (p) => void server.to('lobby').emit('cursor', p));
+    });
+    const listener = await t.listen({ port: t.port, host: '127.0.0.1', cert, privKey });
+    void (async () => {
+        for await (const conn of listener.sessions())
+            void server.accept(conn).catch(() => undefined);
+    })().catch(() => undefined);
+    const url = `https://127.0.0.1:${t.port}/`;
+    const client = new Client({
+        contract,
+        origin: 0xf0000001,
+        connect: () => t.connect({ url, certificateHash }),
+    });
+    await client.connect();
+    assert.equal(client.getSnapshot().status, 'connected', `${t.name}: connected`);
+    const chat = [];
+    const cursor = [];
+    client.on('chat', (p) => chat.push(p.body));
+    client.on('cursor', (p) => cursor.push(p.n));
+    await settle(600);
+    client.emit('chat', { body: 'reliable' });
+    await settle();
+    assert.deepEqual(chat, ['reliable'], `${t.name}: stream lane`);
+    client.emit('cursor', { n: 7 });
+    await settle();
+    assert.deepEqual(cursor, [7], `${t.name}: datagram lane`);
+    // Half-close for the request, response read to stream close.
+    assert.deepEqual(await client.call('echo', { n: 21 }), { n: 42 }, `${t.name}: call`);
+    // AbortSignal maps to a stream reset. The caller always rejects; whether the reset
+    // reaches the responder is a property of the transport, asserted either way so a
+    // regression in the supported direction is caught.
+    const ac = new AbortController();
+    const pending = client.call('slow', null, { signal: ac.signal });
+    await settle(150);
+    ac.abort();
+    await assert.rejects(pending, `${t.name}: abort rejects the caller`);
+    await settle(900);
+    assert.equal(handlerSawAbort, t.propagatesAbortToHandler, `${t.name}: expected ctx.signal to ${t.propagatesAbortToHandler ? '' : 'NOT '}fire`);
+    // Our layer refuses oversize before the transport can silently discard it.
+    assert.throws(() => client.emit('cursor', { n: 1, pad: 'x'.repeat(4000) }), (e) => e.code === 'WT_DATAGRAM_TOO_LARGE', `${t.name}: oversized datagram refused locally`);
+    client.disconnect();
+    listener.stop();
+    rmSync(dir, { recursive: true, force: true });
+}
+export { randomPort };
+//# sourceMappingURL=parity-suite.js.map

package/dist/transport/parity-suite.js.map

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

package/dist/transport/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The transport seam. Internal — not exported from the package (D21).
+ *
+ * It exists so the reference transport's defects stay in one place: it silently swallows
+ * oversized and blocked datagrams, its error type omits the specification's
+ * `streamErrorCode` so reset codes are only recoverable by parsing a message string, and
+ * it ships a reliability fallback that must be actively disabled.
+ */
+export interface CloseInfo {
+    readonly code: number;
+    readonly reason: string;
+}
+export interface BidiStream {
+    readonly readable: ReadableStream<Uint8Array>;
+    readonly writable: WritableStream<Uint8Array>;
+}
+export interface Connection {
+    /** One long-lived unidirectional stream per direction carries the whole emit lane. */
+    openEmitStream(): Promise<WritableStream<Uint8Array>>;
+    onEmitStream(cb: (readable: ReadableStream<Uint8Array>) => void): void;
+    openBidi(): Promise<BidiStream>;
+    onBidi(cb: (stream: BidiStream) => void): void;
+    sendDatagram(bytes: Uint8Array): void;
+    onDatagram(cb: (bytes: Uint8Array) => void): void;
+    /** A property of the path, not a constant. Queried at send time, never cached. */
+    maxDatagramSize(): number;
+    /**
+     * `undefined` where the runtime does not implement the attribute — which includes the
+     * dominant browser. Treated as "unknown, allowed"; only an explicit 'reliable-only' is
+     * refused. See D10.
+     */
+    reliability(): 'pending' | 'reliable-only' | 'supports-unreliable' | undefined;
+    close(code: number, reason: string): void;
+    readonly closed: Promise<CloseInfo>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,sFAAsF;IACtF,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAA;IACrD,YAAY,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,IAAI,GAAG,IAAI,CAAA;IAEtE,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAA;IAE9C,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACrC,UAAU,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAA;IACjD,kFAAkF;IAClF,eAAe,IAAI,MAAM,CAAA;IAEzB;;;;OAIG;IACH,WAAW,IAAI,SAAS,GAAG,eAAe,GAAG,qBAAqB,GAAG,SAAS,CAAA;IAE9E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;CACpC"}

package/dist/transport/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":""}

package/dist/transport/unreliable.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Wraps a Connection and makes its datagram path behave like a real one: lossy,
+ * reordering, duplicating and delayed, on command.
+ *
+ * Test-only. The plain loopback delivers datagrams reliably and in order, which is
+ * convenient and a lie — every guarantee the datagram lane deliberately does not make
+ * goes unexercised against it. This exists so loss, reordering and duplication are forced
+ * deliberately rather than waited for.
+ *
+ * Streams are passed through untouched: they are reliable and ordered, and pretending
+ * otherwise would test the wrong thing.
+ */
+import type { BidiStream, CloseInfo, Connection } from './types.ts';
+export interface UnreliableOptions {
+    /** Drop the nth datagram, 1-based, for every n in this set. */
+    readonly dropAt?: ReadonlySet<number>;
+    /** Deliver the nth datagram twice. */
+    readonly duplicateAt?: ReadonlySet<number>;
+    /** Hold the nth datagram and release it after the following one. */
+    readonly delayAt?: ReadonlySet<number>;
+}
+export declare class UnreliableConnection implements Connection {
+    #private;
+    constructor(inner: Connection, opts?: UnreliableOptions);
+    get sentCount(): number;
+    sendDatagram(bytes: Uint8Array): void;
+    openEmitStream(): Promise<WritableStream<Uint8Array>>;
+    onEmitStream(cb: (readable: ReadableStream<Uint8Array>) => void): void;
+    openBidi(): Promise<BidiStream>;
+    onBidi(cb: (stream: BidiStream) => void): void;
+    onDatagram(cb: (bytes: Uint8Array) => void): void;
+    maxDatagramSize(): number;
+    reliability(): 'pending' | 'reliable-only' | 'supports-unreliable' | undefined;
+    close(code: number, reason: string): void;
+    get closed(): Promise<CloseInfo>;
+}
+//# sourceMappingURL=unreliable.d.ts.map

package/dist/transport/unreliable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreliable.d.ts","sourceRoot":"","sources":["../../src/transport/unreliable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEnE,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACrC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,qBAAa,oBAAqB,YAAW,UAAU;;IAMrD,YAAY,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,iBAAsB,EAG1D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAmBpC;IAED,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAEpD;IACD,YAAY,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,IAAI,GAAG,IAAI,CAErE;IACD,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAE9B;IACD,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAE7C;IACD,UAAU,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAEhD;IACD,eAAe,IAAI,MAAM,CAExB;IACD,WAAW,IAAI,SAAS,GAAG,eAAe,GAAG,qBAAqB,GAAG,SAAS,CAE7E;IACD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAExC;IACD,IAAI,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,CAE/B;CACF"}