@airterm/protocol 0.2.0 → 0.4.0

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":"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"}

package/dist/relay-usage.d.ts

@@ -0,0 +1,13 @@
+import { InnerFrameType } from './framing.js';
+export interface RelayUsage {
+    usedBytes: number;
+    limitBytes: number;
+    resetsAt: string;
+    restricted: boolean;
+    blocked: boolean;
+    retryAt: number;
+    requiresPairing?: boolean;
+}
+export declare function decodeRelayUsage(value: Record<string, unknown>): RelayUsage;
+export declare function isRelayCoordination(type: InnerFrameType): boolean;
+//# sourceMappingURL=relay-usage.d.ts.map

package/dist/relay-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-usage.d.ts","sourceRoot":"","sources":["../src/relay-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAQ3E;AACD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAIjE"}

package/dist/relay-usage.js

@@ -0,0 +1,18 @@
+import { InnerFrameType } from './framing.js';
+export function decodeRelayUsage(value) {
+    if (!Number.isSafeInteger(value.usedBytes) || value.usedBytes < 0 ||
+        !Number.isSafeInteger(value.limitBytes) || value.limitBytes <= 0 ||
+        typeof value.resetsAt !== 'string' || !Number.isFinite(Date.parse(value.resetsAt)) ||
+        typeof value.restricted !== 'boolean' || typeof value.blocked !== 'boolean' ||
+        !Number.isSafeInteger(value.retryAt) || value.retryAt <= 0)
+        throw new Error('Invalid relay usage state.');
+    if (value.requiresPairing !== undefined && typeof value.requiresPairing !== 'boolean')
+        throw new Error('Invalid pairing recovery flag.');
+    return { ...(value.requiresPairing === undefined ? {} : { requiresPairing: value.requiresPairing }), usedBytes: value.usedBytes, limitBytes: value.limitBytes, resetsAt: value.resetsAt, restricted: value.restricted, blocked: value.blocked, retryAt: value.retryAt };
+}
+export function isRelayCoordination(type) {
+    return [InnerFrameType.SessionDescription, InnerFrameType.SessionClose, InnerFrameType.P2PControl,
+        InnerFrameType.OutputAck, InnerFrameType.RecoveryComplete, InnerFrameType.TransferCancel,
+        InnerFrameType.ProtocolError, InnerFrameType.PtyExit].includes(type);
+}
+//# sourceMappingURL=relay-usage.js.map

package/dist/relay-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-usage.js","sourceRoot":"","sources":["../src/relay-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU9C,MAAM,UAAU,gBAAgB,CAAC,KAA8B;IAC3D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,IAAK,KAAK,CAAC,SAAoB,GAAG,CAAC;QACzE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,IAAK,KAAK,CAAC,UAAqB,IAAI,CAAC;QAC5E,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3E,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,IAAK,KAAK,CAAC,OAAkB,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC1H,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACzI,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAA0B,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAmB,EAAE,UAAU,EAAE,KAAK,CAAC,UAAoB,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAiB,EAAE,CAAC;AACrT,CAAC;AACD,MAAM,UAAU,mBAAmB,CAAC,IAAoB;IACpD,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,cAAc,CAAC,YAAY,EAAE,cAAc,CAAC,UAAU;QAC7F,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,gBAAgB,EAAE,cAAc,CAAC,cAAc;QACxF,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC"}

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,39 @@
+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;
+    allowFrames(predicate: (frame: InnerFrame) => boolean): 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;;IAMxB,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,WAAW,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,GAAG,IAAI;IAI5D,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,KAAK,IAAI,IAAI;CAavB"}

package/dist/transport.js

@@ -0,0 +1,92 @@
+import { decodeInnerFrame, encodeInnerFrame, } from './framing.js';
+import { NoiseTransport } from './noise.js';
+import { OutboundQueue } from './outbound-queue.js';
+export class WebSocketTransport {
+    buffered;
+    send;
+    stop;
+    constructor(buffered, send, stop) {
+        this.buffered = buffered;
+        this.send = send;
+        this.stop = stop;
+    }
+    get bufferedAmount() {
+        return this.buffered();
+    }
+    write(bytes, done) {
+        this.send(bytes, done);
+    }
+    close() {
+        this.stop();
+    }
+}
+/** Owns ciphers and encrypts only when the bounded scheduler actually writes. */
+export class EncryptedConnection {
+    transport;
+    options;
+    events;
+    #noise;
+    #queue;
+    #closed = false;
+    #allowed = () => true;
+    constructor(transport, options, events) {
+        this.transport = transport;
+        this.options = options;
+        this.events = events;
+        this.#noise = new NoiseTransport(options);
+        this.#queue = new OutboundQueue(() => transport.bufferedAmount, (frame, done) => transport.write(this.#noise.encrypt(encodeInnerFrame(frame)), done), (paused) => events.onBackpressure?.(paused), (error) => {
+            this.close();
+            events.onFailure(error);
+        });
+    }
+    get complete() {
+        return !this.#closed && this.#noise.complete;
+    }
+    get pendingBytes() {
+        return this.#queue.pendingBytes;
+    }
+    start() {
+        if (this.options.initiator && !this.#closed)
+            this.#writeHandshake();
+    }
+    receive(bytes) {
+        if (this.#closed)
+            return;
+        if (!this.#noise.complete) {
+            this.#noise.readHandshake(bytes);
+            if (!this.options.initiator)
+                this.#writeHandshake();
+            if (this.complete)
+                this.events.onSecure?.();
+        }
+        else {
+            this.events.onFrame?.(decodeInnerFrame(this.#noise.decrypt(bytes)));
+        }
+    }
+    allowFrames(predicate) {
+        this.#allowed = predicate;
+        this.#queue.discard((frame) => !predicate(frame));
+    }
+    send(frame) {
+        if (!this.#allowed(frame))
+            return Promise.reject(new Error('Monthly relay allowance exhausted.'));
+        if (!this.complete)
+            return Promise.reject(new Error('Encrypted transport is not ready.'));
+        return this.#queue.send(frame);
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#queue.close();
+    }
+    #writeHandshake() {
+        this.transport.write(this.#noise.writeHandshake(), (error) => {
+            if (error && !this.#closed) {
+                this.close();
+                this.events.onFailure(error);
+            }
+        });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/vault.d.ts

@@ -0,0 +1,51 @@
+export declare const VAULT_VERSION = 1;
+export declare const VAULT_PRF_INPUT: Uint8Array<ArrayBuffer>;
+export interface VaultContext {
+    accountId: string;
+    generation: number;
+}
+export interface SealedValue {
+    nonce: string;
+    ciphertext: string;
+}
+export interface VaultEnvelope extends VaultContext {
+    version: 1;
+    publicKey: string;
+    privateKey: SealedValue;
+    primary: SealedValue & {
+        mode: "passphrase" | "passkey";
+        salt: string;
+        credentialId?: string;
+    };
+    recovery: SealedValue & {
+        salt: string;
+    };
+}
+export interface SessionEnvelope extends VaultContext {
+    version: 1;
+    ciphertext: string;
+}
+export declare const randomVaultBytes: (length?: number) => Uint8Array;
+export declare function vaultKdf(secret: Uint8Array, salt: string, identity: VaultContext, purpose: string): Promise<Uint8Array>;
+export declare function sealVaultValue(data: Uint8Array, secret: Uint8Array, identity: VaultContext, purpose: string): Promise<SealedValue>;
+export declare function openVaultValue(value: SealedValue, secret: Uint8Array, identity: VaultContext, purpose: string): Promise<Uint8Array>;
+export declare function createRecoveryCode(): Promise<string>;
+export declare function decodeRecoveryCode(code: string): Promise<Uint8Array>;
+export declare function validateVaultEnvelope(value: unknown): asserts value is VaultEnvelope;
+export declare function publicKeyFingerprint(publicKey: string): Promise<string>;
+export declare function createVault(identity: VaultContext, primary: {
+    mode: "passphrase" | "passkey";
+    salt: string;
+    credentialId?: string;
+}, wrappingKey: Uint8Array, recoveryCode: string): Promise<{
+    envelope: VaultEnvelope;
+    vaultKey: Uint8Array;
+    privateKey: CryptoKey;
+}>;
+export declare function unlockVault(envelope: VaultEnvelope, wrappingKey: Uint8Array, recovery?: boolean): Promise<{
+    vaultKey: Uint8Array;
+    privateKey: CryptoKey;
+}>;
+export declare function encryptAccountSession(publicKey: string, identity: VaultContext, sessionId: string, rootSecret: string): Promise<SessionEnvelope>;
+export declare function decryptAccountSession(privateKey: CryptoKey, envelope: SessionEnvelope, identity: VaultContext, sessionId: string): Promise<string>;
+//# sourceMappingURL=vault.d.ts.map