miakapi 3.0.31 → 4.0.0-alpha.1

package/dist/internal/runtime.d.ts

@@ -0,0 +1,34 @@
+import type { Frame } from '../protocol/codec.js';
+export interface SocketHandlers {
+    message(bytes: Uint8Array): void;
+    close(code: number, reason: string): void;
+    error(error: Error): void;
+}
+export interface ManagedSocket {
+    readonly bufferedBytes: number;
+    write(bytes: Uint8Array): Promise<void>;
+    close(code?: number, reason?: string): void;
+    terminate(): void;
+    detach(): void;
+}
+export interface SocketFactory {
+    /** Transfers a created transport to its owner before asynchronous readiness work begins. */
+    connect(url: string, handlers: SocketHandlers, signal: AbortSignal, onSocket?: (socket: ManagedSocket) => void): Promise<ManagedSocket>;
+}
+export interface RuntimeTimer {
+    cancel(): void;
+}
+export interface CoordinatorRuntime {
+    readonly socketFactory: SocketFactory;
+    now(): number;
+    random(): number;
+    setTimer(callback: () => void, delayMs: number): RuntimeTimer;
+}
+export type BrowserRuntime = CoordinatorRuntime;
+export interface SessionTransport {
+    readonly generation: number;
+    readonly epoch: Uint8Array;
+    send(frame: Frame): Promise<void>;
+}
+export declare function delay(runtime: CoordinatorRuntime, delayMs: number, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/internal/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,SAAS,IAAI,IAAI,CAAC;IAClB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,4FAA4F;IAC5F,OAAO,CACL,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,WAAW,EACnB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GACzC,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,GAAG,IAAI,MAAM,CAAC;IACd,MAAM,IAAI,MAAM,CAAC;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC;CAC/D;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CActG"}

package/dist/internal/runtime.js

@@ -0,0 +1,17 @@
+export function delay(runtime, delayMs, signal) {
+    if (signal.aborted)
+        return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+        const timer = runtime.setTimer(() => {
+            signal.removeEventListener('abort', abort);
+            resolve();
+        }, delayMs);
+        const abort = () => {
+            timer.cancel();
+            signal.removeEventListener('abort', abort);
+            reject(signal.reason);
+        };
+        signal.addEventListener('abort', abort, { once: true });
+    });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/internal/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/internal/runtime.ts"],"names":[],"mappings":"AA6CA,MAAM,UAAU,KAAK,CAAC,OAA2B,EAAE,OAAe,EAAE,MAAmB;IACrF,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE;YAClC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/internal/session.d.ts

@@ -0,0 +1,33 @@
+import type { ReadySession } from '../api.js';
+import { type Frame } from '../protocol/codec.js';
+import type { CoordinatorRuntime } from './runtime.js';
+export interface RelayLimits {
+    frameBytes: number;
+    inflightCalls: number;
+    subscriptions: number;
+    queuedBytes: number;
+}
+export interface RelayWelcome {
+    readySession: ReadySession;
+    epoch: Uint8Array;
+    expiresAtMs: number;
+    limits: RelayLimits;
+}
+export interface RelaySessionCallbacks {
+    frame(frame: Frame): void;
+    closed(code: number, reason: string): void;
+    failed(error: Error): void;
+}
+export declare class RelaySession {
+    #private;
+    private constructor();
+    static connect(runtime: CoordinatorRuntime, name: string, relayUrl: string, token: string, signal: AbortSignal, callbacks: RelaySessionCallbacks): Promise<RelaySession>;
+    get welcome(): RelayWelcome;
+    get bufferedBytes(): number;
+    send(frame: Frame): Promise<void>;
+    startDelivery(): void;
+    close(): void;
+    terminate(): void;
+    detach(): void;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/internal/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAEL,KAAK,KAAK,EAEX,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,kBAAkB,EAAiC,MAAM,cAAc,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC5B;AAuDD,qBAAa,YAAY;;IAcvB,OAAO,eAQN;IAED,OAAa,OAAO,CAClB,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAqBvB;IAED,IAAI,OAAO,IAAI,YAAY,CAG1B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAEK,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtC;IAED,aAAa,IAAI,IAAI,CAQpB;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,SAAS,IAAI,IAAI,CAKhB;IAED,MAAM,IAAI,IAAI,CAEb;CAwDF"}

package/dist/internal/session.js

@@ -0,0 +1,199 @@
+import { Opcode, } from '../protocol/codec.js';
+import { CoordinatorProtocolSession } from '../protocol/session.js';
+import { CoordinatorError, protocolFailure } from './errors.js';
+import { createDeferred } from './resources.js';
+function numberField(value, label) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value)) {
+        throw protocolFailure(`${label} is not an integer`);
+    }
+    return value;
+}
+function bytesField(value, label) {
+    if (!(value instanceof Uint8Array))
+        throw protocolFailure(`${label} is not binary`);
+    return value.slice();
+}
+function arrayField(value, label) {
+    if (!Array.isArray(value))
+        throw protocolFailure(`${label} is not an array`);
+    return value;
+}
+function generationForCoordinator(value, name) {
+    const coordinators = arrayField(value, 'WELCOME.coordinators');
+    for (const raw of coordinators) {
+        const entry = arrayField(raw, 'WELCOME.coordinator');
+        if (entry[0] === name)
+            return numberField(entry[1], 'WELCOME.generation');
+    }
+    throw protocolFailure('WELCOME does not contain the authenticated coordinator');
+}
+function parseWelcome(frame, name, connectedAtMs, receivedAtMs) {
+    if (frame.opcode !== Opcode.Welcome)
+        throw protocolFailure('Expected WELCOME');
+    const limits = arrayField(frame.payload[6], 'WELCOME.limits');
+    const expiresAtMs = numberField(frame.payload[7], 'WELCOME.expiresAtMs');
+    if (expiresAtMs <= receivedAtMs)
+        throw protocolFailure('WELCOME expiry is not in the future');
+    return Object.freeze({
+        readySession: Object.freeze({
+            sessionId: numberField(frame.payload[2], 'WELCOME.sessionId'),
+            generation: generationForCoordinator(frame.payload[5], name),
+            connectedAtMs,
+        }),
+        epoch: bytesField(frame.payload[3], 'WELCOME.epoch'),
+        expiresAtMs,
+        limits: Object.freeze({
+            frameBytes: numberField(limits[0], 'WELCOME.maxFrameBytes'),
+            inflightCalls: numberField(limits[1], 'WELCOME.maxInflightCalls'),
+            subscriptions: numberField(limits[2], 'WELCOME.maxSubscriptions'),
+            queuedBytes: numberField(limits[3], 'WELCOME.maxQueuedBytes'),
+        }),
+    });
+}
+export class RelaySession {
+    #name;
+    #callbacks;
+    #now;
+    #protocol = new CoordinatorProtocolSession();
+    #welcome = createDeferred();
+    #socket;
+    #closed = false;
+    #connectedAtMs = 0;
+    #welcomeValue;
+    #deliverFrames = false;
+    #queuedFrameBytes = 0;
+    #queuedFrames = [];
+    constructor(name, callbacks, now) {
+        this.#name = name;
+        this.#callbacks = callbacks;
+        this.#now = now;
+    }
+    static async connect(runtime, name, relayUrl, token, signal, callbacks) {
+        const session = new RelaySession(name, callbacks, () => runtime.now());
+        const handlers = {
+            message: (bytes) => session.#receive(bytes),
+            close: (code, reason) => session.#didClose(code, reason),
+            error: (error) => session.#didFail(error),
+        };
+        try {
+            session.#socket = await runtime.socketFactory.connect(relayUrl, handlers, signal);
+            session.#connectedAtMs = runtime.now();
+            await session.#socket.write(session.#protocol.encode({
+                opcode: Opcode.Hello,
+                payload: [1, 0, 0, 2, token, [name]],
+            }));
+            await session.#welcome.promise;
+            return session;
+        }
+        catch (error) {
+            session.terminate();
+            session.detach();
+            throw error;
+        }
+    }
+    get welcome() {
+        if (this.#welcomeValue === undefined)
+            throw new Error('Relay session is not authenticated');
+        return this.#welcomeValue;
+    }
+    get bufferedBytes() {
+        return this.#socket?.bufferedBytes ?? 0;
+    }
+    async send(frame) {
+        if (this.#closed || this.#socket === undefined)
+            throw new Error('Relay session is closed');
+        if (this.#socket.bufferedBytes > this.welcome.limits.queuedBytes) {
+            throw new RangeError('Relay session outbound queue limit exceeded');
+        }
+        const bytes = this.#protocol.encode(frame);
+        if (bytes.byteLength > this.welcome.limits.frameBytes
+            || this.#socket.bufferedBytes + bytes.byteLength > this.welcome.limits.queuedBytes) {
+            throw new RangeError('Relay session outbound queue limit exceeded');
+        }
+        await this.#socket.write(bytes);
+    }
+    startDelivery() {
+        if (this.#deliverFrames)
+            return;
+        this.#deliverFrames = true;
+        this.#queuedFrameBytes = 0;
+        for (const frame of this.#queuedFrames.splice(0)) {
+            if (this.#closed)
+                break;
+            this.#callbacks.frame(frame);
+        }
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#protocol.close();
+        this.#socket?.close();
+    }
+    terminate() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#protocol.close();
+        this.#socket?.terminate();
+    }
+    detach() {
+        this.#socket?.detach();
+    }
+    #receive(bytes) {
+        if (this.#closed)
+            return;
+        try {
+            const frame = this.#protocol.decode(bytes);
+            if (frame.opcode === Opcode.Welcome) {
+                if (this.#welcomeValue !== undefined)
+                    throw protocolFailure('Relay sent WELCOME twice');
+                this.#welcomeValue = parseWelcome(frame, this.#name, this.#connectedAtMs, this.#now());
+                this.#welcome.resolve(this.#welcomeValue);
+            }
+            else if (!this.#welcome.settled && frame.opcode === Opcode.Fatal) {
+                this.#callbacks.frame(frame);
+                if (!this.#welcome.settled) {
+                    this.#welcome.reject(protocolFailure('Relay sent FATAL before WELCOME'));
+                }
+                this.terminate();
+            }
+            else {
+                if (this.#deliverFrames)
+                    this.#callbacks.frame(frame);
+                else {
+                    this.#queuedFrameBytes += bytes.byteLength;
+                    if (this.#queuedFrames.length >= 256
+                        || this.#queuedFrameBytes > this.welcome.limits.queuedBytes) {
+                        throw protocolFailure('Relay sent too many frames before session activation');
+                    }
+                    this.#queuedFrames.push(frame);
+                }
+            }
+        }
+        catch (error) {
+            const failure = error instanceof CoordinatorError ? error : protocolFailure();
+            this.#welcome.reject(failure);
+            this.#callbacks.failed(failure);
+            this.terminate();
+        }
+    }
+    #didClose(code, reason) {
+        const wasClosed = this.#closed;
+        this.#closed = true;
+        this.#protocol.close();
+        if (!this.#welcome.settled) {
+            this.#welcome.reject(new Error('Relay closed before WELCOME'));
+        }
+        if (!wasClosed)
+            this.#callbacks.closed(code, reason);
+    }
+    #didFail(error) {
+        if (this.#closed)
+            return;
+        this.#welcome.reject(error);
+        this.#callbacks.failed(error);
+        this.terminate();
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/internal/session.js.map

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

package/dist/internal/socket.d.ts

@@ -0,0 +1,6 @@
+import type { CoordinatorRuntime, ManagedSocket, SocketFactory, SocketHandlers } from './runtime.js';
+export declare class WsSocketFactory implements SocketFactory {
+    connect(url: string, handlers: SocketHandlers, signal: AbortSignal, onSocket?: (socket: ManagedSocket) => void): Promise<ManagedSocket>;
+}
+export declare function createProductionRuntime(): CoordinatorRuntime;
+//# sourceMappingURL=socket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/internal/socket.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EAEb,aAAa,EACb,cAAc,EACf,MAAM,cAAc,CAAC;AA2ItB,qBAAa,eAAgB,YAAW,aAAa;IAC7C,OAAO,CACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,WAAW,EACnB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GACzC,OAAO,CAAC,aAAa,CAAC,CAwBxB;CACF;AAcD,wBAAgB,uBAAuB,IAAI,kBAAkB,CAU5D"}

package/dist/internal/socket.js

@@ -0,0 +1,176 @@
+import WebSocket, {} from 'ws';
+import { LIMITS } from '../protocol/codec.js';
+const MAX_QUEUED_BYTES = 1_048_576;
+const HANDSHAKE_TIMEOUT_MS = 10_000;
+const WEBSOCKET_SUBPROTOCOL = 'miakapp';
+function messageBytes(data) {
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    if (Array.isArray(data))
+        return new Uint8Array(Buffer.concat(data));
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+}
+function websocketError(value) {
+    if (value instanceof Error)
+        return value;
+    if (value !== null
+        && typeof value === 'object'
+        && 'error' in value
+        && value.error instanceof Error) {
+        return value.error;
+    }
+    return new Error('WebSocket transport error');
+}
+class WsManagedSocket {
+    #socket;
+    #handlers;
+    #signal;
+    #ready;
+    #resolveReady;
+    #rejectReady;
+    #readySettled = false;
+    #detached = false;
+    constructor(socket, handlers, signal) {
+        this.#socket = socket;
+        this.#handlers = handlers;
+        this.#signal = signal;
+        this.#ready = new Promise((resolve, reject) => {
+            this.#resolveReady = resolve;
+            this.#rejectReady = reject;
+        });
+        socket.on('open', this.#onOpen);
+        socket.on('message', this.#onMessage);
+        socket.on('close', this.#onClose);
+        socket.on('error', this.#onError);
+        signal.addEventListener('abort', this.#onAbort, { once: true });
+    }
+    #onOpen = () => {
+        if (this.#readySettled)
+            return;
+        this.#readySettled = true;
+        this.#resolveReady?.();
+    };
+    #onMessage = (data, isBinary) => {
+        if (this.#detached)
+            return;
+        if (!isBinary) {
+            this.#handlers.error(new Error('Relay sent a non-binary WebSocket message'));
+            this.terminate();
+            return;
+        }
+        this.#handlers.message(messageBytes(data));
+    };
+    #onClose = (code, reason) => {
+        if (!this.#readySettled) {
+            this.#readySettled = true;
+            this.#rejectReady?.(new Error('WebSocket closed before authentication'));
+        }
+        if (!this.#detached)
+            this.#handlers.close(code, reason.toString('utf8'));
+    };
+    #onError = (value) => {
+        const error = websocketError(value);
+        if (!this.#readySettled) {
+            this.#readySettled = true;
+            this.#rejectReady?.(error);
+        }
+        if (!this.#detached)
+            this.#handlers.error(error);
+    };
+    #onAbort = () => {
+        if (!this.#readySettled) {
+            this.#readySettled = true;
+            this.#rejectReady?.(this.#signal.reason);
+        }
+        this.terminate();
+    };
+    ready() {
+        return this.#ready;
+    }
+    get bufferedBytes() {
+        return this.#socket.bufferedAmount;
+    }
+    write(bytes) {
+        if (this.#socket.readyState !== WebSocket.OPEN) {
+            return Promise.reject(new Error('WebSocket is not open'));
+        }
+        if (bytes.byteLength > LIMITS.frameBytes
+            || this.#socket.bufferedAmount + bytes.byteLength > MAX_QUEUED_BYTES) {
+            return Promise.reject(new RangeError('WebSocket outbound queue limit exceeded'));
+        }
+        try {
+            this.#socket.send(bytes, { binary: true, compress: false }, (error) => {
+                if (error instanceof Error && !this.#detached)
+                    this.#handlers.error(error);
+            });
+            return Promise.resolve();
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    }
+    close(code = 1000, reason = 'shutdown') {
+        if (this.#socket.readyState === WebSocket.OPEN)
+            this.#socket.close(code, reason);
+        else if (this.#socket.readyState === WebSocket.CONNECTING)
+            this.#socket.terminate();
+    }
+    terminate() {
+        if (this.#socket.readyState !== WebSocket.CLOSED)
+            this.#socket.terminate();
+    }
+    detach() {
+        if (this.#detached)
+            return;
+        this.#detached = true;
+        this.#signal.removeEventListener('abort', this.#onAbort);
+        this.#socket.off('open', this.#onOpen);
+        this.#socket.off('message', this.#onMessage);
+        this.#socket.off('close', this.#onClose);
+    }
+}
+export class WsSocketFactory {
+    async connect(url, handlers, signal, onSocket) {
+        if (signal.aborted)
+            throw signal.reason;
+        const options = {
+            followRedirects: false,
+            handshakeTimeout: HANDSHAKE_TIMEOUT_MS,
+            maxBufferedChunks: 4_096,
+            maxFragments: 1_024,
+            maxPayload: LIMITS.frameBytes,
+            perMessageDeflate: false,
+        };
+        const managed = new WsManagedSocket(new WebSocket(url, WEBSOCKET_SUBPROTOCOL, options), handlers, signal);
+        onSocket?.(managed);
+        try {
+            await managed.ready();
+            return managed;
+        }
+        catch (error) {
+            managed.terminate();
+            if (onSocket === undefined)
+                managed.detach();
+            throw error;
+        }
+    }
+}
+class NodeRuntimeTimer {
+    #timer;
+    constructor(callback, delayMs) {
+        this.#timer = setTimeout(callback, delayMs);
+    }
+    cancel() {
+        clearTimeout(this.#timer);
+    }
+}
+export function createProductionRuntime() {
+    const socketFactory = new WsSocketFactory();
+    return Object.freeze({
+        socketFactory,
+        now: () => Date.now(),
+        random: () => Math.random(),
+        setTimer: (callback, delayMs) => (new NodeRuntimeTimer(callback, delayMs)),
+    });
+}
+//# sourceMappingURL=socket.js.map

package/dist/internal/socket.js.map

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

package/dist/internal/state.d.ts

@@ -0,0 +1,30 @@
+import type { CoordinatorState, DeclarationOptions, OperationOptions, ProtocolValue, StateMutation, StateReceipt } from '../api.js';
+import { type Frame } from '../protocol/codec.js';
+import type { CoordinatorError } from './errors.js';
+import type { ActiveDeclarations, DeclarationManager } from './declarations.js';
+import type { RelaySession } from './session.js';
+export interface StateHost {
+    readySession(): RelaySession | undefined;
+    activeDeclarations(): ActiveDeclarations | undefined;
+    nextRequestId(): number;
+    emitFailure(failure: CoordinatorError): void;
+}
+export declare class StateManager implements CoordinatorState {
+    #private;
+    constructor(host: StateHost, declarations: DeclarationManager);
+    declare(entries: Readonly<Record<string, ProtocolValue>>, options?: DeclarationOptions): Promise<import('../api.js').DeclarationReceipt>;
+    set(mutations: readonly StateMutation[], options?: OperationOptions): Promise<StateReceipt>;
+    /**
+     * Reapplies acknowledged deletions that an activation just undid, because
+     * `STATE_SYNC` must stage a value for every declared path. One frame per
+     * activation, never retried: if it is lost, the next declaration of the same
+     * slice tries again; if it is refused, the relay's value is taken as the
+     * acknowledged one and the refusal is reported.
+     */
+    restoreDeletions(session: RelaySession, active: ActiveDeclarations, paths: readonly string[]): void;
+    handleFrame(frame: Frame): boolean;
+    handleError(id: number, code: number, retryable: boolean): boolean;
+    disconnected(): void;
+    stop(failure: CoordinatorError): void;
+}
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/internal/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAkB,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjD,MAAM,WAAW,SAAS;IACxB,YAAY,IAAI,YAAY,GAAG,SAAS,CAAC;IACzC,kBAAkB,IAAI,kBAAkB,GAAG,SAAS,CAAC;IACrD,aAAa,IAAI,MAAM,CAAC;IACxB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC9C;AA+BD,qBAAa,YAAa,YAAW,gBAAgB;;IAOnD,YAAY,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAG5D;IAED,OAAO,CACL,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAChD,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,WAAW,EAAE,kBAAkB,CAAC,CAGjD;IAED,GAAG,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0D9F;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAmBlG;IAED,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CA0BjC;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAgBjE;IAED,YAAY,IAAI,IAAI,CAOnB;IAED,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAOpC;CAOF"}