@airterm/protocol 0.2.0 → 0.3.0

package/dist/outbound-queue.js.map

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

package/dist/p2p.d.ts

@@ -0,0 +1,37 @@
+import { type InnerFrame } from './framing.js';
+export declare const P2P_FEATURE: "p2p-v1";
+export declare const P2P_MIN_BUFFER_BYTES: number;
+export declare const P2P_NEGOTIATION_MS = 10000;
+export declare const P2P_RECOVERY_MS = 30000;
+export declare const DEFAULT_STUN_URLS: string[];
+export type P2PMessage = {
+    type: 'accept';
+    id: string;
+    attempt: boolean;
+} | {
+    type: 'configure';
+    id: string;
+    stun: string[];
+} | {
+    type: 'offer' | 'answer';
+    id: string;
+    sdp: string;
+} | {
+    type: 'candidate';
+    id: string;
+    candidate: string;
+    mid: string;
+} | {
+    type: 'ready' | 'barrier' | 'commit' | 'committed' | 'fallback' | 'decline' | 'detach' | 'ping' | 'pong';
+    id: string;
+};
+export declare function validateStunUrls(value: unknown): string[];
+export declare function decodeP2PMessage(payload: Uint8Array): P2PMessage;
+export declare function p2pFrame(message: P2PMessage): InnerFrame;
+/** A negotiation is bounded in both directions, including rejected messages. */
+export declare class SignalingBudget {
+    #private;
+    consume(payload: Uint8Array): P2PMessage;
+}
+export declare function directConnectionId(pairing: string, id: string): string;
+//# sourceMappingURL=p2p.d.ts.map

package/dist/p2p.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p2p.d.ts","sourceRoot":"","sources":["../src/p2p.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,eAAO,MAAM,WAAW,EAAG,QAAiB,CAAC;AAC7C,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAC/C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,eAAO,MAAM,iBAAiB,UAAmC,CAAC;AAClE,MAAM,MAAM,UAAU,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACjE;IACI,IAAI,EACE,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,UAAU,GACV,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAGR,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAkBzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAmDhE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAIxD;AAED,gFAAgF;AAChF,qBAAa,eAAe;;IAGjB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU;CASlD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAItE"}

package/dist/p2p.js

@@ -0,0 +1,91 @@
+import { InnerFrameType } from './framing.js';
+export const P2P_FEATURE = 'p2p-v1';
+export const P2P_MIN_BUFFER_BYTES = 512 * 1024;
+export const P2P_NEGOTIATION_MS = 10_000;
+export const P2P_RECOVERY_MS = 30_000;
+export const DEFAULT_STUN_URLS = ['stun:stun.l.google.com:19302'];
+const encoder = new TextEncoder();
+export function validateStunUrls(value) {
+    if (!Array.isArray(value) ||
+        value.length > 4 ||
+        value.some((url) => typeof url !== 'string' ||
+            url.length > 256 ||
+            !/^stun:(?:[a-zA-Z0-9.-]+|\[[a-fA-F0-9:]+\])(?::[0-9]{1,5})?$/.test(url) ||
+            (/:([0-9]+)$/.test(url) &&
+                (Number(url.match(/:([0-9]+)$/)?.[1]) < 1 ||
+                    Number(url.match(/:([0-9]+)$/)?.[1]) > 65535))))
+        throw new Error('Expected up to four STUN URLs without credentials.');
+    return [...value];
+}
+export function decodeP2PMessage(payload) {
+    if (payload.byteLength > 34 * 1024)
+        throw new Error('P2P message exceeds limit.');
+    const value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(payload));
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('Invalid P2P message.');
+    const v = value;
+    if (typeof v.id !== 'string' || !/^[a-f0-9]{32}$/.test(v.id))
+        throw new Error('Invalid negotiation ID.');
+    const id = v.id;
+    switch (v.type) {
+        case 'accept':
+            if (typeof v.attempt !== 'boolean')
+                break;
+            return { type: v.type, id, attempt: v.attempt };
+        case 'configure':
+            return { type: v.type, id, stun: validateStunUrls(v.stun) };
+        case 'offer':
+        case 'answer':
+            if (typeof v.sdp !== 'string' ||
+                encoder.encode(v.sdp).length > 32 * 1024 ||
+                !/^v=0\r?\n/.test(v.sdp) ||
+                !/^m=application /m.test(v.sdp) ||
+                /^m=(?!application )/m.test(v.sdp))
+                break;
+            return { type: v.type, id, sdp: v.sdp };
+        case 'candidate':
+            if (typeof v.candidate !== 'string' ||
+                encoder.encode(v.candidate).length > 2048 ||
+                !/^candidate:/.test(v.candidate) ||
+                typeof v.mid !== 'string' ||
+                v.mid.length > 64)
+                break;
+            return { type: v.type, id, candidate: v.candidate, mid: v.mid };
+        case 'ready':
+        case 'barrier':
+        case 'commit':
+        case 'committed':
+        case 'fallback':
+        case 'decline':
+        case 'detach':
+        case 'ping':
+        case 'pong':
+            return { type: v.type, id };
+    }
+    throw new Error('Invalid P2P message.');
+}
+export function p2pFrame(message) {
+    const payload = encoder.encode(JSON.stringify(message));
+    decodeP2PMessage(payload);
+    return { type: InnerFrameType.P2PControl, ptyId: 0, sequence: 0n, payload };
+}
+/** A negotiation is bounded in both directions, including rejected messages. */
+export class SignalingBudget {
+    #bytes = 0;
+    #candidates = 0;
+    consume(payload) {
+        this.#bytes += payload.byteLength;
+        if (this.#bytes > 256 * 1024)
+            throw new Error('Signaling budget exceeded.');
+        const message = decodeP2PMessage(payload);
+        if (message.type === 'candidate' && ++this.#candidates > 64)
+            throw new Error('Too many ICE candidates.');
+        return message;
+    }
+}
+export function directConnectionId(pairing, id) {
+    if (!pairing || !/^[a-f0-9]{32}$/.test(id))
+        throw new Error('Invalid direct connection binding.');
+    return JSON.stringify(['airterm-direct-v1', pairing, id]);
+}
+//# sourceMappingURL=p2p.js.map

package/dist/p2p.js.map

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

package/dist/peer-transport.d.ts

@@ -0,0 +1,31 @@
+import { type InnerFrame } from './framing.js';
+import { type RtcAdapterFactory } from './direct-negotiation.js';
+/** Per-pairing policy. The caller owns relay reconnect and browser-page attempt policy. */
+export declare class PeerTransport {
+    #private;
+    private readonly options;
+    constructor(options: {
+        browser: boolean;
+        sessionId: string;
+        psk: Uint8Array;
+        pairing: string;
+        factory: RtcAdapterFactory;
+        stun: string[];
+        relay: (frame: InnerFrame) => Promise<void>;
+        frame: (frame: InnerFrame) => void;
+        accepted: () => void;
+        busy: () => boolean;
+        freeze: (frozen: boolean) => void;
+        pressure: (paused: boolean) => void;
+        changed: (direct: boolean) => void;
+        fallback: () => void;
+    });
+    get direct(): boolean;
+    get frozen(): boolean;
+    accept(attempt: boolean): void;
+    send(frame: InnerFrame): Promise<void>;
+    receive(frame: InnerFrame): void;
+    fallback(): void;
+    close(): void;
+}
+//# sourceMappingURL=peer-transport.d.ts.map

package/dist/peer-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-transport.d.ts","sourceRoot":"","sources":["../src/peer-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,yBAAyB,CAAC;AAIjC,2FAA2F;AAC3F,qBAAa,aAAa;;IAUlB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,UAAU,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,iBAAiB,CAAC;QAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;QACnC,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,IAAI,EAAE,MAAM,OAAO,CAAC;QACpB,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;QAClC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;QACpC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;QACnC,QAAQ,EAAE,MAAM,IAAI,CAAC;KACxB;IAEL,IAAW,MAAM,IAAI,OAAO,CAE3B;IACD,IAAW,MAAM,IAAI,OAAO,CAE3B;IACM,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAY9B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAyDhC,QAAQ,IAAI,IAAI;IAKhB,KAAK,IAAI,IAAI;CAoDvB"}

package/dist/peer-transport.js

@@ -0,0 +1,155 @@
+import { InnerFrameType } from './framing.js';
+import { DirectNegotiation, } from './direct-negotiation.js';
+import { decodeP2PMessage, p2pFrame } from './p2p.js';
+import { TransportHandoff } from './transport-handoff.js';
+/** Per-pairing policy. The caller owns relay reconnect and browser-page attempt policy. */
+export class PeerTransport {
+    options;
+    #id;
+    #negotiation;
+    #handoff;
+    #closed = false;
+    #configured = false;
+    #startedAt = performance.now();
+    #disabled = false;
+    #timer;
+    constructor(options) {
+        this.options = options;
+    }
+    get direct() {
+        return this.#handoff?.direct ?? false;
+    }
+    get frozen() {
+        return this.#handoff?.frozen ?? false;
+    }
+    accept(attempt) {
+        if (!this.options.browser || this.#id || this.#closed)
+            return;
+        this.#startedAt = performance.now();
+        this.#id = Array.from(crypto.getRandomValues(new Uint8Array(16)), (byte) => byte.toString(16).padStart(2, '0')).join('');
+        this.options.accepted();
+        this.#disabled = !attempt;
+        this.#send({ type: 'accept', id: this.#id, attempt });
+        if (attempt)
+            this.#timer = setTimeout(() => this.#abandon(), 10000);
+    }
+    send(frame) {
+        if (this.#closed)
+            return Promise.reject(new Error('Peer transport closed.'));
+        return this.#handoff
+            ? this.#handoff.send(frame)
+            : this.options.relay(frame);
+    }
+    receive(frame) {
+        if (this.#closed)
+            return;
+        if (frame.type !== InnerFrameType.P2PControl) {
+            if ((frame.type === InnerFrameType.OutputAck ||
+                frame.type === InnerFrameType.RecoveryComplete) &&
+                !this.#id)
+                throw new Error('Recovery was not negotiated.');
+            if (this.#handoff)
+                this.#handoff.receive(frame, 'relay');
+            else
+                this.options.frame(frame);
+            return;
+        }
+        const message = decodeP2PMessage(frame.payload);
+        if (message.type === 'accept' && !this.options.browser && !this.#id) {
+            this.#startedAt = performance.now();
+            this.#id = message.id;
+            this.options.accepted();
+            this.#disabled = !message.attempt;
+            if (message.attempt) {
+                this.#start(this.options.stun);
+                this.#send({
+                    type: 'configure',
+                    id: message.id,
+                    stun: this.options.stun,
+                });
+            }
+            return;
+        }
+        if (!this.#id || message.id !== this.#id)
+            throw new Error('Unexpected peer negotiation.');
+        if (message.type === 'configure' &&
+            this.options.browser &&
+            !this.#configured &&
+            !this.#disabled) {
+            clearTimeout(this.#timer);
+            this.#start(message.stun);
+            return;
+        }
+        if (message.type === 'offer' ||
+            message.type === 'answer' ||
+            message.type === 'candidate') {
+            if (this.#disabled)
+                return;
+            if (!this.#negotiation)
+                throw new Error('Direct transport was not negotiated.');
+            this.#negotiation.receive(frame.payload);
+            return;
+        }
+        if (this.#disabled)
+            return;
+        if (this.#handoff)
+            this.#handoff.receive(frame, 'relay');
+        else if (message.type === 'decline')
+            this.#abandon();
+        else
+            throw new Error('Unexpected peer control message.');
+    }
+    fallback() {
+        if (this.#closed)
+            return;
+        if (this.#handoff)
+            this.#handoff.fail();
+        else
+            this.#abandon();
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        clearTimeout(this.#timer);
+        this.#handoff?.close();
+        this.#negotiation?.close();
+    }
+    #start(stun) {
+        this.#configured = true;
+        this.#handoff = new TransportHandoff(this.#id, this.options.browser, {
+            relay: this.options.relay,
+            busy: this.options.busy,
+            freeze: this.options.freeze,
+            changed: this.options.changed,
+            frame: this.options.frame,
+            abandoned: () => this.#abandon(),
+            fallback: () => {
+                this.#negotiation?.close();
+                this.options.fallback();
+            },
+        });
+        this.#negotiation = new DirectNegotiation(this.#id, this.options.browser, this.options, this.options.factory, {
+            signal: this.options.relay,
+            ready: (connection) => this.#handoff?.ready(connection),
+            frame: (frame) => this.#handoff?.receive(frame, 'direct'),
+            pressure: this.options.pressure,
+            failed: () => this.#handoff?.fail(),
+        });
+        this.#negotiation.start(stun, Math.max(1, 10000 - (performance.now() - this.#startedAt)));
+    }
+    #abandon() {
+        clearTimeout(this.#timer);
+        this.#disabled = true;
+        this.#negotiation?.close();
+        this.#handoff?.close();
+        this.#handoff = undefined;
+        this.options.freeze(false);
+        this.options.pressure(false);
+        this.options.changed(false);
+    }
+    #send(message) {
+        void this.options.relay(p2pFrame(message)).catch(() => this.fallback());
+    }
+}
+//# sourceMappingURL=peer-transport.js.map

package/dist/peer-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-transport.js","sourceRoot":"","sources":["../src/peer-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,cAAc,CAAC;AAC/D,OAAO,EACH,iBAAiB,GAEpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAmB,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,2FAA2F;AAC3F,MAAM,OAAO,aAAa;IAUD;IATrB,GAAG,CAAqB;IACxB,YAAY,CAAgC;IAC5C,QAAQ,CAA+B;IACvC,OAAO,GAAG,KAAK,CAAC;IAChB,WAAW,GAAG,KAAK,CAAC;IACpB,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAC/B,SAAS,GAAG,KAAK,CAAC;IAClB,MAAM,CAA4C;IAClD,YACqB,OAehB;QAfgB,YAAO,GAAP,OAAO,CAevB;IACF,CAAC;IACJ,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC;IAC1C,CAAC;IACD,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC;IAC1C,CAAC;IACM,MAAM,CAAC,OAAgB;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAC9D,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CACjB,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,EAC1C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAC/C,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACtD,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;IACM,IAAI,CAAC,KAAiB;QACzB,IAAI,IAAI,CAAC,OAAO;YACZ,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,QAAQ;YAChB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACM,OAAO,CAAC,KAAiB;QAC5B,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,EAAE,CAAC;YAC3C,IACI,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,SAAS;gBACpC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,CAAC;gBACnD,CAAC,IAAI,CAAC,GAAG;gBAET,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;;gBACpD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO;QACX,CAAC;QACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAClE,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;YAClC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC/B,IAAI,CAAC,KAAK,CAAC;oBACP,IAAI,EAAE,WAAW;oBACjB,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;iBAC1B,CAAC,CAAC;YACP,CAAC;YACD,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,GAAG;YACpC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,IACI,OAAO,CAAC,IAAI,KAAK,WAAW;YAC5B,IAAI,CAAC,OAAO,CAAC,OAAO;YACpB,CAAC,IAAI,CAAC,WAAW;YACjB,CAAC,IAAI,CAAC,SAAS,EACjB,CAAC;YACC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO;QACX,CAAC;QACD,IACI,OAAO,CAAC,IAAI,KAAK,OAAO;YACxB,OAAO,CAAC,IAAI,KAAK,QAAQ;YACzB,OAAO,CAAC,IAAI,KAAK,WAAW,EAC9B,CAAC;YACC,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC3B,IAAI,CAAC,IAAI,CAAC,YAAY;gBAClB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC5D,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,OAAO;QACX,CAAC;QACD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;aACpD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;;YAChD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC7D,CAAC;IACM,QAAQ;QACX,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;;YACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IACM,KAAK;QACR,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,CAAC,IAAc;QACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;YAClE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACvB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;YAChC,QAAQ,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,IAAI,iBAAiB,CACrC,IAAI,CAAC,GAAI,EACT,IAAI,CAAC,OAAO,CAAC,OAAO,EACpB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,OAAO,CAAC,OAAO,EACpB;YACI,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YAC1B,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC;YACvD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YACzD,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE;SACtC,CACJ,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,KAAK,CACnB,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAC7D,CAAC;IACN,CAAC;IACD,QAAQ;QACJ,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,OAAmB;QACrB,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC;CACJ"}

package/dist/transport-handoff.d.ts

@@ -0,0 +1,25 @@
+import { type InnerFrame } from './framing.js';
+import type { EncryptedConnection } from './transport.js';
+export declare class TransportHandoff {
+    #private;
+    readonly id: string;
+    private readonly browser;
+    private readonly events;
+    constructor(id: string, browser: boolean, events: {
+        relay: (frame: InnerFrame) => Promise<void>;
+        busy: () => boolean;
+        freeze: (frozen: boolean) => void;
+        changed: (direct: boolean) => void;
+        fallback: () => void;
+        abandoned: () => void;
+        frame: (frame: InnerFrame) => void;
+    });
+    get direct(): boolean;
+    get frozen(): boolean;
+    ready(connection: EncryptedConnection): void;
+    send(frame: InnerFrame): Promise<void>;
+    receive(frame: InnerFrame, path: 'relay' | 'direct'): void;
+    fail(): void;
+    close(): void;
+}
+//# sourceMappingURL=transport-handoff.d.ts.map

package/dist/transport-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-handoff.d.ts","sourceRoot":"","sources":["../src/transport-handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAS1D,qBAAa,gBAAgB;;IASrB,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFd,EAAE,EAAE,MAAM,EACF,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE;QACrB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,EAAE,MAAM,OAAO,CAAC;QACpB,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;QAClC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;QACnC,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;KACtC;IAEL,IAAW,MAAM,IAAI,OAAO,CAE3B;IACD,IAAW,MAAM,IAAI,OAAO,CAE3B;IACM,KAAK,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAU5C,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI;IA4F1D,IAAI,IAAI,IAAI;IAcZ,KAAK,IAAI,IAAI;CA0DvB"}

package/dist/transport-handoff.js

@@ -0,0 +1,207 @@
+import { InnerFrameType } from './framing.js';
+import { decodeP2PMessage, p2pFrame } from './p2p.js';
+export class TransportHandoff {
+    id;
+    browser;
+    events;
+    #phase = 'relay';
+    #direct;
+    #peerReady = false;
+    #heartbeat;
+    #lastPong = 0;
+    #timer;
+    #poll;
+    constructor(id, browser, events) {
+        this.id = id;
+        this.browser = browser;
+        this.events = events;
+    }
+    get direct() {
+        return this.#phase === 'direct';
+    }
+    get frozen() {
+        return ['barrier', 'committing', 'closed'].includes(this.#phase);
+    }
+    ready(connection) {
+        if (this.#phase !== 'relay') {
+            this.fail();
+            return;
+        }
+        this.#direct = connection;
+        this.#phase = 'waiting';
+        this.#timer = setTimeout(() => this.fail(), 30000);
+        this.#waitForTransfers();
+    }
+    send(frame) {
+        if (frame.type === InnerFrameType.OutputAck)
+            return this.events.relay(frame);
+        if (this.frozen)
+            return Promise.reject(new Error('Transport handoff has paused input.'));
+        return this.direct
+            ? this.#direct.send(frame)
+            : this.events.relay(frame);
+    }
+    receive(frame, path) {
+        if (this.#phase === 'closed')
+            return;
+        if (frame.type !== InnerFrameType.P2PControl) {
+            if (frame.type === InnerFrameType.OutputAck && path === 'relay') {
+                this.events.frame(frame);
+                return;
+            }
+            if ((this.direct ? 'direct' : 'relay') !== path ||
+                this.#phase === 'committing') {
+                this.fail();
+                return;
+            }
+            this.events.frame(frame);
+            return;
+        }
+        try {
+            const message = decodeP2PMessage(frame.payload);
+            if (message.id !== this.id)
+                throw new Error('Stale handoff');
+            if ((message.type === 'ping' || message.type === 'pong') &&
+                path === 'direct' &&
+                this.direct) {
+                if (message.type === 'pong')
+                    this.#lastPong = performance.now();
+                else
+                    void this.#direct
+                        .send(p2pFrame({ type: 'pong', id: this.id }))
+                        .catch(() => this.fail());
+                return;
+            }
+            if (message.type === 'ready' &&
+                !this.browser &&
+                path === 'relay' &&
+                (this.#phase === 'relay' || this.#phase === 'waiting') &&
+                !this.#peerReady) {
+                this.#peerReady = true;
+            }
+            else if (message.type === 'barrier' &&
+                path === 'relay' &&
+                this.#phase === 'waiting' &&
+                this.browser &&
+                !this.events.busy()) {
+                this.#beginBarrier();
+                void this.events
+                    .relay(p2pFrame({ type: 'barrier', id: this.id }))
+                    .catch(() => this.fail());
+            }
+            else if (message.type === 'barrier' &&
+                path === 'relay' &&
+                this.#phase === 'barrier' &&
+                !this.browser) {
+                this.#phase = 'committing';
+                void this.#direct
+                    .send(p2pFrame({ type: 'commit', id: this.id }))
+                    .catch(() => this.fail());
+            }
+            else if (message.type === 'commit' &&
+                path === 'direct' &&
+                this.browser &&
+                this.#phase === 'barrier') {
+                this.#phase = 'committing';
+                void this.#direct
+                    .send(p2pFrame({ type: 'committed', id: this.id }))
+                    .then(() => this.#activate())
+                    .catch(() => this.fail());
+            }
+            else if (message.type === 'committed' &&
+                path === 'direct' &&
+                !this.browser &&
+                this.#phase === 'committing') {
+                this.#activate();
+            }
+            else if (message.type === 'fallback' && path === 'relay')
+                this.#recover();
+            else if (message.type === 'decline' &&
+                path === 'relay' &&
+                ['relay', 'waiting'].includes(this.#phase))
+                this.#abandon();
+            else
+                throw new Error('Unexpected handoff message');
+        }
+        catch {
+            this.fail();
+        }
+    }
+    fail() {
+        if (this.#phase === 'closed')
+            return;
+        if (this.#phase === 'relay' || this.#phase === 'waiting') {
+            void this.events
+                .relay(p2pFrame({ type: 'decline', id: this.id }))
+                .catch(() => { });
+            this.#abandon();
+        }
+        else {
+            void this.events
+                .relay(p2pFrame({ type: 'fallback', id: this.id }))
+                .catch(() => { });
+            this.#recover();
+        }
+    }
+    close() {
+        clearInterval(this.#heartbeat);
+        clearTimeout(this.#timer);
+        clearTimeout(this.#poll);
+        this.#phase = 'closed';
+        this.#direct?.close();
+    }
+    #beginBarrier() {
+        this.#phase = 'barrier';
+        clearTimeout(this.#timer);
+        clearTimeout(this.#poll);
+        this.events.freeze(true);
+        this.#timer = setTimeout(() => this.fail(), 2000);
+    }
+    #waitForTransfers() {
+        if (this.#phase !== 'waiting')
+            return;
+        if (!this.events.busy() && (this.browser || this.#peerReady)) {
+            if (this.browser) {
+                void this.events
+                    .relay(p2pFrame({ type: 'ready', id: this.id }))
+                    .catch(() => this.fail());
+                return;
+            }
+            this.#beginBarrier();
+            void this.events
+                .relay(p2pFrame({ type: 'barrier', id: this.id }))
+                .catch(() => this.fail());
+            return;
+        }
+        this.#poll = setTimeout(() => this.#waitForTransfers(), 25);
+    }
+    #activate() {
+        if (this.#phase !== 'committing')
+            return;
+        clearTimeout(this.#timer);
+        this.#phase = 'direct';
+        this.events.freeze(false);
+        this.events.changed(true);
+        this.#lastPong = performance.now();
+        this.#heartbeat = setInterval(() => {
+            if (performance.now() - this.#lastPong >= 6000) {
+                this.fail();
+                return;
+            }
+            void this.#direct
+                .send(p2pFrame({ type: 'ping', id: this.id }))
+                .catch(() => this.fail());
+        }, 2000);
+    }
+    #abandon() {
+        this.close();
+        this.events.freeze(false);
+        this.events.abandoned();
+    }
+    #recover() {
+        this.close();
+        this.events.freeze(true);
+        this.events.fallback();
+    }
+}
+//# sourceMappingURL=transport-handoff.js.map

package/dist/transport-handoff.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,38 @@
+import { type InnerFrame } from './framing.js';
+import { type NoiseTransportOptions } from './noise.js';
+/** One ordered binary connection. Owners deliver incoming messages and closure. */
+export interface BinaryTransport {
+    readonly bufferedAmount: number;
+    write(bytes: Uint8Array, done: (error?: Error | null) => void): void;
+    close(): void;
+}
+export declare class WebSocketTransport implements BinaryTransport {
+    private readonly buffered;
+    private readonly send;
+    private readonly stop;
+    constructor(buffered: () => number, send: BinaryTransport['write'], stop: () => void);
+    get bufferedAmount(): number;
+    write(bytes: Uint8Array, done: (error?: Error | null) => void): void;
+    close(): void;
+}
+export interface EncryptedConnectionEvents {
+    onSecure?: () => void;
+    onFrame?: (frame: InnerFrame) => void;
+    onBackpressure?: (paused: boolean) => void;
+    onFailure: (error: Error) => void;
+}
+/** Owns ciphers and encrypts only when the bounded scheduler actually writes. */
+export declare class EncryptedConnection {
+    #private;
+    private readonly transport;
+    private readonly options;
+    private readonly events;
+    constructor(transport: BinaryTransport, options: NoiseTransportOptions, events: EncryptedConnectionEvents);
+    get complete(): boolean;
+    get pendingBytes(): number;
+    start(): void;
+    receive(bytes: Uint8Array): void;
+    send(frame: InnerFrame): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,UAAU,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxE,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IACrE,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,qBAAa,kBAAmB,YAAW,eAAe;IAElD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,QAAQ,EAAE,MAAM,MAAM,EACtB,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,MAAM,IAAI;IAErC,IAAW,cAAc,IAAI,MAAM,CAElC;IACM,KAAK,CACR,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GACrC,IAAI;IAGA,KAAK,IAAI,IAAI;CAGvB;AAED,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC;AAED,iFAAiF;AACjF,qBAAa,mBAAmB;;IAKxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,yBAAyB;IAiBtD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IACD,IAAW,YAAY,IAAI,MAAM,CAEhC;IACM,KAAK,IAAI,IAAI;IAGb,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAUhC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,KAAK,IAAI,IAAI;CAavB"}