miakapi 3.0.31 → 4.0.0-alpha.1

package/dist/internal/state.js

@@ -0,0 +1,188 @@
+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();
+    #restorations = new Map();
+    #sequence = 0;
+    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();
+        this.#sequence += 1;
+        const pending = {
+            deferred,
+            epoch: session.welcome.epoch.slice(),
+            handedOff: false,
+            abandoned: false,
+            mutations: validated,
+            revision: active.snapshot.revisions.state,
+            sequence: this.#sequence,
+        };
+        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;
+    }
+    /**
+     * 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, active, paths) {
+        const wireMutations = [];
+        for (const path of paths) {
+            const pathId = active.stateIds.get(path);
+            if (pathId !== undefined)
+                wireMutations.push([pathId, 1]);
+        }
+        if (wireMutations.length === 0
+            || this.#pending.size + this.#restorations.size >= LIMITS.declarationsPerCoordinator)
+            return;
+        const id = this.#host.nextRequestId();
+        this.#restorations.set(id, {
+            epoch: session.welcome.epoch.slice(),
+            sequences: this.#declarations.confirmedSequences(paths),
+        });
+        void session.send({
+            opcode: Opcode.StateSet,
+            payload: [id, session.welcome.epoch, wireMutations],
+        }).then(() => undefined, () => {
+            this.#restorations.delete(id);
+        });
+    }
+    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 restoration = this.#restorations.get(id);
+        const pending = this.#pending.get(id);
+        const expectedEpoch = restoration?.epoch ?? pending?.epoch;
+        if (expectedEpoch === undefined)
+            throw new TypeError('STATE_SET_OK is not correlated');
+        const epoch = frame.payload[1];
+        if (!(epoch instanceof Uint8Array)
+            || epoch.length !== expectedEpoch.length
+            || epoch.some((value, index) => value !== expectedEpoch[index])) {
+            throw new TypeError('STATE_SET_OK uses a stale epoch');
+        }
+        if (restoration !== undefined) {
+            this.#restorations.delete(id);
+            return true;
+        }
+        if (pending === undefined)
+            return true;
+        this.#pending.delete(id);
+        this.#removeAbort(pending);
+        // Recorded even when the caller abandoned the promise: the ACK proves the
+        // relay applied it, and a re-declaration must not roll it back.
+        this.#declarations.recordConfirmed(pending.mutations, pending.revision, pending.sequence);
+        if (!pending.abandoned)
+            pending.deferred.resolve(Object.freeze({ outcome: 'applied' }));
+        return true;
+    }
+    handleError(id, code, retryable) {
+        const restoration = this.#restorations.get(id);
+        if (restoration !== undefined) {
+            this.#restorations.delete(id);
+            this.#declarations.restorationRefused(restoration.sequences);
+            this.#host.emitFailure(relayFailure(code, retryable, 'not_dispatched'));
+            return true;
+        }
+        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() {
+        this.#restorations.clear();
+        for (const pending of this.#pending.values()) {
+            this.#removeAbort(pending);
+            pending.deferred.reject(pending.handedOff ? outcomeUnknown() : unavailable());
+        }
+        this.#pending.clear();
+    }
+    stop(failure) {
+        this.#restorations.clear();
+        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"}

package/dist/internal/user-calls.js

@@ -0,0 +1,325 @@
+import { LIMITS, Opcode } from '../protocol/codec.js';
+import { browserCancelled, browserOutcomeUnknown, browserProtocolFailure, browserRelayFailure, browserUnavailable, } from './browser-errors.js';
+import { createDeferred } from './resources.js';
+import { validateBrowserCallOptions, validateProtocolValue } from './validation.js';
+function integer(value, label) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 1) {
+        throw browserProtocolFailure(`${label} is invalid`);
+    }
+    return value;
+}
+function entries(value, label) {
+    if (!Array.isArray(value))
+        throw browserProtocolFailure(`${label} is not an array`);
+    return value;
+}
+function sameEpoch(left, right) {
+    return left !== undefined
+        && right instanceof Uint8Array
+        && right.length === left.length
+        && right.every((value, index) => value === left[index]);
+}
+export class UserCallManager {
+    #host;
+    #functionIds = new Map();
+    #calls = new Map();
+    #locallyCompleted = new Set();
+    #rejectedIncoming = new Set();
+    #epoch;
+    #dictionarySeen = false;
+    constructor(host) {
+        this.#host = host;
+    }
+    beginSession(epoch) {
+        this.#epoch = epoch.slice();
+        this.#functionIds.clear();
+        this.#locallyCompleted.clear();
+        this.#rejectedIncoming.clear();
+        this.#dictionarySeen = false;
+    }
+    start(rawOptions) {
+        const options = validateBrowserCallOptions(rawOptions);
+        const localId = `call:${this.#host.nextLocalCallId()}`;
+        const accepted = createDeferred();
+        const result = createDeferred();
+        void accepted.promise.catch(() => undefined);
+        void result.promise.catch(() => undefined);
+        const inactive = (failure) => {
+            accepted.reject(failure);
+            result.reject(failure);
+            return Object.freeze({ localId, accepted: accepted.promise, result: result.promise, cancel() { } });
+        };
+        if (options.signal?.aborted === true)
+            return inactive(browserCancelled('not_dispatched'));
+        const session = this.#host.readySession();
+        const functionId = this.#functionIds.get(options.function);
+        if (session === undefined || functionId === undefined) {
+            return inactive(browserUnavailable('Call target function is not available in a ready session'));
+        }
+        if (this.#calls.size >= session.welcome.limits.inflightCalls) {
+            return inactive(browserUnavailable('Call concurrency limit is reached'));
+        }
+        const id = this.#host.nextCallId();
+        const pending = {
+            id,
+            localId,
+            session,
+            accepted,
+            result,
+            handedOff: false,
+            wasAccepted: false,
+            terminal: false,
+            cancellationRequested: false,
+            timer: this.#host.runtime().setTimer(() => {
+                this.#cancel(id, false, 'Call deadline expired');
+            }, options.timeoutMs),
+        };
+        if (options.signal !== undefined) {
+            const abort = () => this.#cancel(id, true, 'Call was aborted');
+            pending.signal = options.signal;
+            pending.abort = abort;
+            options.signal.addEventListener('abort', abort, { once: true });
+        }
+        this.#calls.set(id, pending);
+        const handle = Object.freeze({
+            localId,
+            accepted: accepted.promise,
+            result: result.promise,
+            cancel: () => this.#cancel(id, true, 'Call was cancelled'),
+        });
+        queueMicrotask(() => {
+            if (pending.terminal)
+                return;
+            pending.handedOff = true;
+            void session.send({
+                opcode: Opcode.Call,
+                payload: [
+                    id,
+                    0,
+                    null,
+                    functionId,
+                    options.timeoutMs,
+                    options.idempotencyKey ?? null,
+                    0,
+                    options.arguments,
+                ],
+            }).then(() => undefined, () => {
+                if (this.#calls.get(id) === pending) {
+                    this.#fail(pending, browserOutcomeUnknown('Call transport handoff could not be confirmed'), true);
+                }
+            });
+        });
+        return handle;
+    }
+    handleFrame(frame) {
+        if (frame.opcode === Opcode.FunctionDict) {
+            this.#handleDictionary(frame);
+            return true;
+        }
+        if (frame.opcode === Opcode.CallDispatch) {
+            const id = integer(frame.payload[0], 'CALL_DISPATCH.callId');
+            if (this.#rejectedIncoming.has(id)) {
+                throw browserProtocolFailure('CALL_DISPATCH was duplicated');
+            }
+            this.#rememberRejectedIncoming(id);
+            void this.#host.send({
+                opcode: Opcode.CallError,
+                payload: [id, 2000, false, 'Browser call handlers are not available', null],
+            }).catch((error) => {
+                this.#host.transportFailure(error instanceof Error ? error : browserUnavailable());
+            });
+            return true;
+        }
+        if (frame.opcode === Opcode.CallCancel || frame.opcode === Opcode.CallCredit) {
+            const id = integer(frame.payload[0], 'callee callId');
+            if (!this.#rejectedIncoming.has(id)) {
+                throw browserProtocolFailure('Callee call frame is not correlated');
+            }
+            return true;
+        }
+        if (frame.opcode === Opcode.CallAccepted) {
+            const id = integer(frame.payload[0], 'callId');
+            if (this.#locallyCompleted.has(id))
+                return true;
+            const call = this.#call(id);
+            if (call.wasAccepted)
+                throw browserProtocolFailure('CALL_ACCEPTED was duplicated');
+            call.wasAccepted = true;
+            call.accepted.resolve(undefined);
+            return true;
+        }
+        if (frame.opcode === Opcode.CallResult) {
+            const id = integer(frame.payload[0], 'callId');
+            if (this.#locallyCompleted.delete(id))
+                return true;
+            const call = this.#call(id);
+            if (!call.wasAccepted)
+                throw browserProtocolFailure('CALL_RESULT arrived before CALL_ACCEPTED');
+            if (frame.payload[1] !== true) {
+                throw browserProtocolFailure('Streaming CALL_RESULT exceeded zero browser credit');
+            }
+            call.result.resolve(validateProtocolValue(frame.payload[2], 'call result'));
+            this.#finish(call);
+            return true;
+        }
+        if (frame.opcode === Opcode.CallError) {
+            const id = integer(frame.payload[0], 'callId');
+            if (this.#locallyCompleted.delete(id))
+                return true;
+            const call = this.#call(id);
+            const code = integer(frame.payload[1], 'CALL_ERROR.code');
+            const retryable = frame.payload[2];
+            if (typeof retryable !== 'boolean')
+                throw browserProtocolFailure('CALL_ERROR.retryable is invalid');
+            const outcome = code === 1404 || (code === 1405 && call.wasAccepted)
+                ? 'outcome_unknown'
+                : call.wasAccepted ? 'accepted' : 'not_dispatched';
+            const failure = browserRelayFailure(code, retryable, outcome, {
+                kind: 'call', localId: call.localId,
+            });
+            this.#fail(call, failure);
+            this.#host.emitFailure(failure);
+            return true;
+        }
+        return false;
+    }
+    handleError(id, code, retryable) {
+        if (this.#locallyCompleted.delete(id))
+            return true;
+        const call = this.#calls.get(id);
+        if (call === undefined || call.terminal)
+            return false;
+        const outcome = code === 1404 || (code === 1405 && call.wasAccepted)
+            ? 'outcome_unknown'
+            : call.wasAccepted ? 'accepted' : 'not_dispatched';
+        const failure = browserRelayFailure(code, retryable, outcome, {
+            kind: 'call', localId: call.localId,
+        });
+        this.#fail(call, failure);
+        this.#host.emitFailure(failure);
+        return true;
+    }
+    handleResponseError(id, code, retryable) {
+        if (!this.#rejectedIncoming.delete(id))
+            return false;
+        this.#host.transportFailure(browserRelayFailure(code, retryable, 'outcome_unknown'));
+        return true;
+    }
+    disconnected() {
+        for (const call of [...this.#calls.values()]) {
+            this.#fail(call, call.handedOff ? browserOutcomeUnknown() : browserUnavailable());
+        }
+        this.#functionIds.clear();
+        this.#locallyCompleted.clear();
+        this.#rejectedIncoming.clear();
+        this.#dictionarySeen = false;
+        this.#epoch = undefined;
+    }
+    stop() {
+        for (const call of [...this.#calls.values()]) {
+            if (call.handedOff && !call.terminal) {
+                void call.session.send({ opcode: Opcode.CallCancel, payload: [call.id, 1405] })
+                    .catch(() => undefined);
+            }
+            this.#fail(call, call.handedOff ? browserOutcomeUnknown() : browserCancelled('not_dispatched'));
+        }
+        this.#rejectedIncoming.clear();
+    }
+    #handleDictionary(frame) {
+        if (!sameEpoch(this.#epoch, frame.payload[0])) {
+            throw browserProtocolFailure('FUNCTION_DICT uses a stale epoch');
+        }
+        const replace = frame.payload[1];
+        if (typeof replace !== 'boolean')
+            throw browserProtocolFailure('FUNCTION_DICT.replace is invalid');
+        if (!replace && !this.#dictionarySeen) {
+            throw browserProtocolFailure('FUNCTION_DICT addition arrived before a replacement');
+        }
+        const nextFunctionIds = replace ? new Map() : new Map(this.#functionIds);
+        const ids = new Set(nextFunctionIds.values());
+        for (const raw of entries(frame.payload[2], 'FUNCTION_DICT.entries')) {
+            const tuple = entries(raw, 'FUNCTION_DICT entry');
+            const id = integer(tuple[0], 'FUNCTION_DICT.functionId');
+            const name = tuple[1];
+            if (typeof name !== 'string')
+                throw browserProtocolFailure('FUNCTION_DICT.name is invalid');
+            const existing = nextFunctionIds.get(name);
+            if ((existing !== undefined && existing !== id) || (ids.has(id) && existing !== id)) {
+                throw browserProtocolFailure('FUNCTION_DICT reassigns an identifier');
+            }
+            if (existing === undefined && nextFunctionIds.size >= LIMITS.statePathsPerHome) {
+                throw browserProtocolFailure('FUNCTION_DICT exceeds the cumulative function limit');
+            }
+            nextFunctionIds.set(name, id);
+            ids.add(id);
+        }
+        this.#functionIds.clear();
+        for (const [name, id] of nextFunctionIds)
+            this.#functionIds.set(name, id);
+        if (replace) {
+            this.#dictionarySeen = true;
+            this.#host.functionDictionarySynchronized();
+        }
+    }
+    #call(id) {
+        const call = this.#calls.get(id);
+        if (call === undefined || call.terminal)
+            throw browserProtocolFailure('Call frame is not correlated');
+        return call;
+    }
+    #cancel(id, awaitTerminal, message) {
+        const call = this.#calls.get(id);
+        if (call === undefined || call.terminal)
+            return;
+        if (!call.handedOff) {
+            this.#fail(call, browserCancelled('not_dispatched', message));
+            return;
+        }
+        if (call.cancellationRequested) {
+            if (!awaitTerminal)
+                this.#fail(call, browserOutcomeUnknown(message), true);
+            return;
+        }
+        call.cancellationRequested = true;
+        void call.session.send({ opcode: Opcode.CallCancel, payload: [id, 1405] }).then(() => { if (!awaitTerminal)
+            this.#fail(call, browserOutcomeUnknown(message), true); }, () => this.#fail(call, browserOutcomeUnknown(message), true));
+    }
+    #fail(call, failure, remember = false) {
+        if (call.terminal)
+            return;
+        if (!call.accepted.settled)
+            call.accepted.reject(failure);
+        call.result.reject(failure);
+        this.#finish(call);
+        if (remember)
+            this.#rememberLocallyCompleted(call.id);
+    }
+    #finish(call) {
+        call.terminal = true;
+        call.timer.cancel();
+        if (call.signal !== undefined && call.abort !== undefined) {
+            call.signal.removeEventListener('abort', call.abort);
+        }
+        if (this.#calls.get(call.id) === call)
+            this.#calls.delete(call.id);
+    }
+    #rememberLocallyCompleted(id) {
+        this.#locallyCompleted.delete(id);
+        this.#locallyCompleted.add(id);
+        if (this.#locallyCompleted.size <= LIMITS.inflightCalls)
+            return;
+        const oldest = this.#locallyCompleted.values().next().value;
+        if (oldest !== undefined)
+            this.#locallyCompleted.delete(oldest);
+    }
+    #rememberRejectedIncoming(id) {
+        this.#rejectedIncoming.delete(id);
+        this.#rejectedIncoming.add(id);
+        if (this.#rejectedIncoming.size <= LIMITS.inflightCalls)
+            return;
+        const oldest = this.#rejectedIncoming.values().next().value;
+        if (oldest !== undefined)
+            this.#rejectedIncoming.delete(oldest);
+    }
+}
+//# sourceMappingURL=user-calls.js.map

package/dist/internal/user-calls.js.map

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

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

@@ -0,0 +1,36 @@
+import type { BrowserHomeStatus, BrowserReadySession } from '../browser-api.js';
+import { type Frame, type ProtocolValue } from '../protocol/codec.js';
+import type { BrowserRuntime } from './runtime.js';
+export interface UserRelayLimits {
+    readonly frameBytes: number;
+    readonly inflightCalls: number;
+    readonly subscriptions: number;
+    readonly queuedBytes: number;
+}
+export interface UserRelayWelcome {
+    readonly readySession: BrowserReadySession;
+    readonly epoch: Uint8Array;
+    readonly expiresAtMs: number;
+    readonly limits: UserRelayLimits;
+}
+export interface UserRelaySessionCallbacks {
+    frame(frame: Frame): void;
+    closed(code: number, reason: string): void;
+    failed(error: Error): void;
+}
+export declare function parseUserHomeStatus(enrolledValue: ProtocolValue | undefined, coordinatorsValue: ProtocolValue | undefined, stale: boolean): BrowserHomeStatus;
+export declare class UserRelaySession {
+    #private;
+    private constructor();
+    static connect(runtime: BrowserRuntime, homeId: string, relayUrl: string, token: string, signal: AbortSignal, callbacks: UserRelaySessionCallbacks, onCreated: (session: UserRelaySession) => void): Promise<UserRelaySession>;
+    get welcome(): UserRelayWelcome;
+    get bufferedBytes(): number;
+    send(frame: Frame): Promise<void>;
+    startDelivery(): void;
+    close(): void;
+    terminate(): void;
+    waitForTransportClose(): Promise<void>;
+    get transportClosed(): boolean;
+    detach(): void;
+}
+//# sourceMappingURL=user-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-session.d.ts","sourceRoot":"","sources":["../../src/internal/user-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,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;AAyCD,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,iBAAiB,EAAE,aAAa,GAAG,SAAS,EAC5C,KAAK,EAAE,OAAO,GACb,iBAAiB,CASnB;AAoCD,qBAAa,gBAAgB;;IAc3B,OAAO,eAIN;IAED,OAAa,OAAO,CAClB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,yBAAyB,EACpC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;IAED,IAAI,OAAO,IAAI,gBAAgB,CAG9B;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,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrC;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,MAAM,IAAI,IAAI,CAEb;CA+CF"}