miakapi 3.0.31 → 4.0.0-alpha.0

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":"AAAA,OAAO,SAAS,EAAE,EAAoC,MAAM,IAAI,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAS9C,MAAM,gBAAgB,GAAG,SAAS,CAAC;AACnC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAOxC,SAAS,YAAY,CAAC,IAAa;IACjC,IAAI,IAAI,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,KAAK,KAAK,IAAI;WACb,OAAO,KAAK,KAAK,QAAQ;WACzB,OAAO,IAAI,KAAK;WAChB,KAAK,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,eAAe;IACV,OAAO,CAAY;IACnB,SAAS,CAAiB;IAC1B,OAAO,CAAc;IACrB,MAAM,CAAgB;IAC/B,aAAa,CAA2B;IACxC,YAAY,CAA0C;IACtD,aAAa,GAAG,KAAK,CAAC;IACtB,SAAS,GAAG,KAAK,CAAC;IAElB,YAAY,MAAiB,EAAE,QAAwB,EAAE,MAAmB;QAC1E,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;YAC7B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAEQ,OAAO,GAAG,GAAS,EAAE;QAC5B,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;IACzB,CAAC,CAAC;IAEO,UAAU,GAAG,CAAC,IAAa,EAAE,QAAiB,EAAQ,EAAE;QAC/D,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC,CAAC;YAC7E,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEO,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAc,EAAQ,EAAE;QACzD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC;IAEO,QAAQ,GAAG,CAAC,KAAc,EAAQ,EAAE;QAC3C,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC;IAEO,QAAQ,GAAG,GAAS,EAAE;QAC7B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC,CAAC;IAEF,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAiB;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU;eACnC,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,KAAK,CAAC,UAAU,GAAG,gBAAgB,EAAE,CAAC;YACvE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;gBACpE,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS;oBAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7E,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,GAAG,UAAU;QACpC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;aAC5E,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU;YAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IACtF,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAC,OAAO,CACX,GAAW,EACX,QAAwB,EACxB,MAAmB,EACnB,QAA0C;QAE1C,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,MAAM,CAAC;QACxC,MAAM,OAAO,GAAyB;YACpC,eAAe,EAAE,KAAK;YACtB,gBAAgB,EAAE,oBAAoB;YACtC,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,iBAAiB,EAAE,KAAK;SACzB,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,eAAe,CACjC,IAAI,SAAS,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAClD,QAAQ,EACR,MAAM,CACP,CAAC;QACF,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,MAAM,gBAAgB;IACX,MAAM,CAAiB;IAEhC,YAAY,QAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM;QACJ,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,aAAa,GAAG,IAAI,eAAe,EAAE,CAAC;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa;QACb,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACrB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,CAAC,QAAoB,EAAE,OAAe,EAAE,EAAE,CAAC,CACnD,IAAI,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CACxC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/internal/state.d.ts

@@ -0,0 +1,21 @@
+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;
+}
+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>;
+    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;CACzB;AAgBD,qBAAa,YAAa,YAAW,gBAAgB;;IAKnD,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,CAsD9F;IAED,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAgBjC;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CASjE;IAED,YAAY,IAAI,IAAI,CAMnB;IAED,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAMpC;CAOF"}

package/dist/internal/state.js

@@ -0,0 +1,133 @@
+import { LIMITS, Opcode } from '../protocol/codec.js';
+import { cancelled, relayFailure, unavailable, outcomeUnknown } from './errors.js';
+import { createDeferred } from './resources.js';
+import { validateDeclarationOptions, validateOperationOptions, validateStateEntries, validateStateMutations, } from './validation.js';
+function requestId(frame) {
+    const value = frame.payload[0];
+    return typeof value === 'number' && Number.isSafeInteger(value) ? value : undefined;
+}
+export class StateManager {
+    #host;
+    #declarations;
+    #pending = new Map();
+    constructor(host, declarations) {
+        this.#host = host;
+        this.#declarations = declarations;
+    }
+    declare(entries, options = {}) {
+        const signal = validateDeclarationOptions(options, 'state declaration');
+        return this.#declarations.declareState(validateStateEntries(entries), signal);
+    }
+    set(mutations, options = {}) {
+        const validated = validateStateMutations(mutations);
+        const signal = validateOperationOptions(options, 'state operation');
+        if (signal?.aborted === true)
+            return Promise.reject(cancelled('not_dispatched'));
+        const session = this.#host.readySession();
+        const active = this.#host.activeDeclarations();
+        if (session === undefined || active === undefined)
+            return Promise.reject(unavailable());
+        if (this.#pending.size >= LIMITS.declarationsPerCoordinator) {
+            return Promise.reject(unavailable('State mutation concurrency limit is reached'));
+        }
+        const wireMutations = validated.map((mutation) => {
+            const pathId = active.stateIds.get(mutation.path);
+            if (pathId === undefined)
+                throw new TypeError(`State path ${mutation.path} is not active`);
+            return 'delete' in mutation
+                ? [pathId, 1]
+                : [pathId, 0, mutation.value];
+        });
+        const id = this.#host.nextRequestId();
+        const deferred = createDeferred();
+        const pending = {
+            deferred,
+            epoch: session.welcome.epoch.slice(),
+            handedOff: false,
+            abandoned: false,
+        };
+        if (signal !== undefined) {
+            const abort = () => {
+                if (!this.#pending.has(id))
+                    return;
+                if (pending.handedOff) {
+                    pending.abandoned = true;
+                    this.#removeAbort(pending);
+                    deferred.reject(outcomeUnknown());
+                }
+                else {
+                    this.#pending.delete(id);
+                    deferred.reject(cancelled('not_dispatched'));
+                }
+            };
+            pending.signal = signal;
+            pending.abort = abort;
+            signal.addEventListener('abort', abort, { once: true });
+        }
+        this.#pending.set(id, pending);
+        pending.handedOff = true;
+        void session.send({
+            opcode: Opcode.StateSet,
+            payload: [id, session.welcome.epoch, wireMutations],
+        }).then(() => undefined, () => {
+            if (this.#pending.get(id) !== pending)
+                return;
+            this.#pending.delete(id);
+            this.#removeAbort(pending);
+            deferred.reject(unavailable('State mutation was not handed to the transport'));
+        });
+        return deferred.promise;
+    }
+    handleFrame(frame) {
+        if (frame.opcode !== Opcode.StateSetOk)
+            return false;
+        const id = requestId(frame);
+        if (id === undefined)
+            throw new TypeError('STATE_SET_OK has no request ID');
+        const pending = this.#pending.get(id);
+        if (pending === undefined)
+            throw new TypeError('STATE_SET_OK is not correlated');
+        const epoch = frame.payload[1];
+        if (!(epoch instanceof Uint8Array)
+            || epoch.length !== pending.epoch.length
+            || epoch.some((value, index) => value !== pending.epoch[index])) {
+            throw new TypeError('STATE_SET_OK uses a stale epoch');
+        }
+        this.#pending.delete(id);
+        this.#removeAbort(pending);
+        if (!pending.abandoned)
+            pending.deferred.resolve(Object.freeze({ outcome: 'applied' }));
+        return true;
+    }
+    handleError(id, code, retryable) {
+        const pending = this.#pending.get(id);
+        if (pending === undefined)
+            return false;
+        this.#pending.delete(id);
+        this.#removeAbort(pending);
+        if (!pending.abandoned) {
+            pending.deferred.reject(relayFailure(code, retryable, 'not_dispatched'));
+        }
+        return true;
+    }
+    disconnected() {
+        for (const pending of this.#pending.values()) {
+            this.#removeAbort(pending);
+            pending.deferred.reject(pending.handedOff ? outcomeUnknown() : unavailable());
+        }
+        this.#pending.clear();
+    }
+    stop(failure) {
+        for (const pending of this.#pending.values()) {
+            this.#removeAbort(pending);
+            pending.deferred.reject(pending.handedOff ? outcomeUnknown() : failure);
+        }
+        this.#pending.clear();
+    }
+    #removeAbort(pending) {
+        if (pending.signal !== undefined && pending.abort !== undefined) {
+            pending.signal.removeEventListener('abort', pending.abort);
+        }
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/internal/state.js.map

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

package/dist/internal/user-calls.d.ts

@@ -0,0 +1,27 @@
+import type { BrowserCallHandle, BrowserCallOptions, BrowserCalls } from '../browser-api.js';
+import { type Frame } from '../protocol/codec.js';
+import { type BrowserClientError } from './browser-errors.js';
+import type { BrowserRuntime } from './runtime.js';
+import type { UserRelaySession } from './user-session.js';
+export interface UserCallHost {
+    readySession(): UserRelaySession | undefined;
+    send(frame: Frame): Promise<void>;
+    nextCallId(): number;
+    nextLocalCallId(): number;
+    runtime(): BrowserRuntime;
+    emitFailure(failure: BrowserClientError): void;
+    transportFailure(error: Error): void;
+    functionDictionarySynchronized(): void;
+}
+export declare class UserCallManager implements BrowserCalls {
+    #private;
+    constructor(host: UserCallHost);
+    beginSession(epoch: Uint8Array): void;
+    start(rawOptions: BrowserCallOptions): BrowserCallHandle;
+    handleFrame(frame: Frame): boolean;
+    handleError(id: number, code: number, retryable: boolean): boolean;
+    handleResponseError(id: number, code: number, retryable: boolean): boolean;
+    disconnected(): void;
+    stop(): void;
+}
+//# sourceMappingURL=user-calls.d.ts.map

package/dist/internal/user-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-calls.d.ts","sourceRoot":"","sources":["../../src/internal/user-calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAkB,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,WAAW,YAAY;IAC3B,YAAY,IAAI,gBAAgB,GAAG,SAAS,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,IAAI,MAAM,CAAC;IACrB,eAAe,IAAI,MAAM,CAAC;IAC1B,OAAO,IAAI,cAAc,CAAC;IAC1B,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACrC,8BAA8B,IAAI,IAAI,CAAC;CACxC;AAoCD,qBAAa,eAAgB,YAAW,YAAY;;IASlD,YAAY,IAAI,EAAE,YAAY,EAE7B;IAED,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAMpC;IAED,KAAK,CAAC,UAAU,EAAE,kBAAkB,GAAG,iBAAiB,CA2EvD;IAED,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAiEjC;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAajE;IAED,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAIzE;IAED,YAAY,IAAI,IAAI,CASnB;IAED,IAAI,IAAI,IAAI,CASX;CA4FF"}