miakapi 3.0.31 → 4.0.0-alpha.0

package/dist/internal/events.js

@@ -0,0 +1,207 @@
+import { Opcode } from '../protocol/codec.js';
+import { cancelled, outcomeUnknown, relayFailure, safeLog, unavailable } from './errors.js';
+import { createDeferred, ListenerSet } from './resources.js';
+import { targetFields, validateDeclarationOptions, validateEventDeclarations, validateEventPublishOptions, validateProtocolValue, validateStructuredName, } from './validation.js';
+function principal(value) {
+    if (!Array.isArray(value))
+        throw new TypeError('EVENT source is not a principal');
+    const kind = value[0] === 1 ? 'user' : value[0] === 2 ? 'coordinator' : value[0] === 3 ? 'cli' : undefined;
+    if (kind === undefined
+        || typeof value[1] !== 'string'
+        || typeof value[2] !== 'number'
+        || (value[3] !== null && typeof value[3] !== 'string')
+        || (value[4] !== null && typeof value[4] !== 'string')) {
+        throw new TypeError('EVENT source principal is invalid');
+    }
+    return Object.freeze({
+        kind,
+        id: value[1],
+        sessionId: value[2],
+        coordinatorName: value[3],
+        verifiedEmail: value[4],
+    });
+}
+function topicForId(active, id) {
+    for (const [topic, topicId] of active.topicIds) {
+        if (topicId === id)
+            return topic;
+    }
+    return undefined;
+}
+export class EventManager {
+    #host;
+    #declarations;
+    #listeners = new Map();
+    #published = new Map();
+    #eventSessionId;
+    #lastEventId = 0;
+    constructor(host, declarations) {
+        this.#host = host;
+        this.#declarations = declarations;
+    }
+    declare(entries, options = {}) {
+        const signal = validateDeclarationOptions(options, 'event declaration');
+        return this.#declarations.declareEvents(validateEventDeclarations(entries), signal);
+    }
+    publish(topic, value, options = {}) {
+        const validatedTopic = validateStructuredName(topic, 'event topic');
+        const validatedValue = validateProtocolValue(value, 'event value');
+        const validatedOptions = validateEventPublishOptions(options);
+        const signal = validatedOptions.signal;
+        const defaultTarget = Object.freeze({ kind: 'default' });
+        const target = validatedOptions.target === undefined
+            ? defaultTarget
+            : validatedOptions.target;
+        if (signal?.aborted === true) {
+            const sent = createDeferred();
+            const handle = Object.freeze({
+                localId: `event:local:${this.#host.nextLocalEventId()}`,
+                sent: sent.promise,
+            });
+            sent.reject(cancelled('not_dispatched'));
+            return handle;
+        }
+        const session = this.#host.readySession();
+        const active = this.#host.activeDeclarations();
+        const topicId = active?.topicIds.get(validatedTopic);
+        if (session === undefined || active === undefined || topicId === undefined) {
+            const sent = createDeferred();
+            const handle = Object.freeze({
+                localId: `event:local:${this.#host.nextLocalEventId()}`,
+                sent: sent.promise,
+            });
+            sent.reject(unavailable('Event topic is not active in a ready session'));
+            return handle;
+        }
+        const eventId = this.#host.nextEventId();
+        const sessionId = session.welcome.readySession.sessionId;
+        if (this.#eventSessionId !== sessionId) {
+            this.#eventSessionId = sessionId;
+            this.#lastEventId = 0;
+        }
+        this.#lastEventId = eventId;
+        const localId = `event:${sessionId}:${eventId}`;
+        const sent = createDeferred();
+        const handle = Object.freeze({ localId, sent: sent.promise });
+        const pending = { localId, sent, handedOff: false };
+        if (signal !== undefined) {
+            const abort = () => {
+                if (!this.#published.delete(eventId))
+                    return;
+                sent.reject(pending.handedOff ? outcomeUnknown() : cancelled('not_dispatched'));
+            };
+            pending.signal = signal;
+            pending.abort = abort;
+            signal.addEventListener('abort', abort, { once: true });
+        }
+        this.#published.set(eventId, pending);
+        const [targetKind, targetValue] = targetFields(target);
+        pending.handedOff = true;
+        void session.send({
+            opcode: Opcode.Event,
+            payload: [eventId, topicId, targetKind, targetValue, validatedValue],
+        }).then(() => {
+            if (this.#published.get(eventId) !== pending)
+                return;
+            this.#published.delete(eventId);
+            this.#removeAbort(pending);
+            sent.resolve(Object.freeze({ outcome: 'sent' }));
+        }, () => {
+            if (this.#published.get(eventId) !== pending)
+                return;
+            this.#published.delete(eventId);
+            this.#removeAbort(pending);
+            sent.reject(unavailable('Event was not handed to the transport'));
+        });
+        return handle;
+    }
+    subscribe(topic, listener) {
+        const validatedTopic = validateStructuredName(topic, 'event subscription topic');
+        if (typeof listener !== 'function')
+            throw new TypeError('event listener must be a function');
+        let listeners = this.#listeners.get(validatedTopic);
+        if (listeners === undefined) {
+            listeners = new ListenerSet();
+            this.#listeners.set(validatedTopic, listeners);
+        }
+        const unsubscribe = listeners.subscribe(listener);
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            unsubscribe();
+            if (listeners?.size === 0)
+                this.#listeners.delete(validatedTopic);
+        };
+    }
+    handleFrame(frame) {
+        if (frame.opcode !== Opcode.Event)
+            return false;
+        const topicId = frame.payload[1];
+        if (typeof topicId !== 'number')
+            throw new TypeError('EVENT has no topic ID');
+        const active = this.#host.activeDeclarations();
+        if (active === undefined)
+            throw new TypeError('EVENT arrived without active declarations');
+        const topic = topicForId(active, topicId);
+        if (topic === undefined)
+            throw new TypeError('EVENT uses an unknown topic ID');
+        const event = Object.freeze({
+            source: principal(frame.payload[4]),
+            topic,
+            value: validateProtocolValue(frame.payload[5], 'incoming event value'),
+        });
+        this.#listeners.get(topic)?.emit(event, () => {
+            safeLog(this.#host.logger(), { level: 'error', event: 'event_listener_failed' });
+        });
+        return true;
+    }
+    handleError(eventId, code, retryable) {
+        const pending = this.#published.get(eventId);
+        let localId;
+        if (pending === undefined) {
+            if (this.#eventSessionId === undefined || eventId < 1 || eventId > this.#lastEventId) {
+                return false;
+            }
+            localId = `event:${this.#eventSessionId}:${eventId}`;
+        }
+        else {
+            this.#published.delete(eventId);
+            this.#removeAbort(pending);
+            pending.handedOff = true;
+            pending.sent.resolve(Object.freeze({ outcome: 'sent' }));
+            localId = pending.localId;
+        }
+        const failure = relayFailure(code, retryable, 'sent', {
+            kind: 'event',
+            localId,
+        });
+        if (pending === undefined)
+            this.#host.emitFailure(failure);
+        else
+            void pending.sent.promise.then(() => this.#host.emitFailure(failure));
+        return true;
+    }
+    disconnected() {
+        for (const pending of this.#published.values()) {
+            this.#removeAbort(pending);
+            if (!pending.sent.settled) {
+                pending.sent.reject(pending.handedOff ? outcomeUnknown() : unavailable());
+            }
+        }
+        this.#published.clear();
+        this.#eventSessionId = undefined;
+        this.#lastEventId = 0;
+    }
+    stop() {
+        this.disconnected();
+        this.#listeners.clear();
+    }
+    #removeAbort(pending) {
+        if (pending.signal !== undefined && pending.abort !== undefined) {
+            pending.signal.removeEventListener('abort', pending.abort);
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/internal/events.js.map

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

package/dist/internal/presence.d.ts

@@ -0,0 +1,15 @@
+import type { CoordinatorLogger, CoordinatorPresence, PresenceEntry, Unsubscribe } from '../api.js';
+import { type Frame } from '../protocol/codec.js';
+export interface PresenceHost {
+    logger(): CoordinatorLogger | undefined;
+}
+export declare class PresenceManager implements CoordinatorPresence {
+    #private;
+    constructor(host: PresenceHost);
+    snapshot(): readonly PresenceEntry[];
+    subscribe(listener: (entries: readonly PresenceEntry[]) => void): Unsubscribe;
+    handleFrame(frame: Frame): boolean;
+    disconnected(): void;
+    stop(): void;
+}
+//# sourceMappingURL=presence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/internal/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAU,KAAK,KAAK,EAAsB,MAAM,sBAAsB,CAAC;AAI9E,MAAM,WAAW,YAAY;IAC3B,MAAM,IAAI,iBAAiB,GAAG,SAAS,CAAC;CACzC;AAYD,qBAAa,eAAgB,YAAW,mBAAmB;;IAKzD,YAAY,IAAI,EAAE,YAAY,EAE7B;IAED,QAAQ,IAAI,SAAS,aAAa,EAAE,CAMnC;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,KAAK,IAAI,GAAG,WAAW,CAS5E;IAED,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAyCjC;IAED,YAAY,IAAI,IAAI,CAInB;IAED,IAAI,IAAI,IAAI,CAGX;CAOF"}

package/dist/internal/presence.js

@@ -0,0 +1,99 @@
+import { Opcode } from '../protocol/codec.js';
+import { safeLog } from './errors.js';
+import { ListenerSet } from './resources.js';
+function entry(value, label) {
+    if (!Array.isArray(value)
+        || typeof value[0] !== 'number'
+        || !Number.isSafeInteger(value[0])
+        || typeof value[1] !== 'string') {
+        throw new TypeError(`${label} is invalid`);
+    }
+    return Object.freeze({ sessionId: value[0], userId: value[1] });
+}
+export class PresenceManager {
+    #host;
+    #listeners = new ListenerSet();
+    #entries = new Map();
+    constructor(host) {
+        this.#host = host;
+    }
+    snapshot() {
+        return Object.freeze([...this.#entries.values()]
+            .sort((left, right) => left.sessionId - right.sessionId)
+            .map((value) => Object.freeze({ ...value })));
+    }
+    subscribe(listener) {
+        if (typeof listener !== 'function')
+            throw new TypeError('presence listener must be a function');
+        const unsubscribe = this.#listeners.subscribe(listener);
+        try {
+            listener(this.snapshot());
+        }
+        catch {
+            safeLog(this.#host.logger(), { level: 'error', event: 'presence_listener_failed' });
+        }
+        return unsubscribe;
+    }
+    handleFrame(frame) {
+        if (frame.opcode === Opcode.PresenceSnapshot) {
+            const values = frame.payload[0];
+            if (!Array.isArray(values))
+                throw new TypeError('PRESENCE_SNAPSHOT entries are invalid');
+            const next = new Map();
+            values.forEach((value, index) => {
+                const presence = entry(value, `PRESENCE_SNAPSHOT[${index}]`);
+                if (next.has(presence.sessionId)) {
+                    throw new TypeError('PRESENCE_SNAPSHOT contains a duplicate session');
+                }
+                next.set(presence.sessionId, presence);
+            });
+            this.#entries.clear();
+            for (const [sessionId, presence] of next)
+                this.#entries.set(sessionId, presence);
+            this.#emit();
+            return true;
+        }
+        if (frame.opcode === Opcode.PresenceChange) {
+            const sessionId = frame.payload[0];
+            const userId = frame.payload[1];
+            const change = frame.payload[2];
+            if (typeof sessionId !== 'number'
+                || !Number.isSafeInteger(sessionId)
+                || typeof userId !== 'string'
+                || (change !== 1 && change !== 2)) {
+                throw new TypeError('PRESENCE_CHANGE is invalid');
+            }
+            const existing = this.#entries.get(sessionId);
+            if (change === 1) {
+                if (existing !== undefined)
+                    throw new TypeError('PRESENCE_CHANGE duplicates a session');
+                this.#entries.set(sessionId, Object.freeze({ sessionId, userId }));
+            }
+            else {
+                if (existing === undefined || existing.userId !== userId) {
+                    throw new TypeError('PRESENCE_CHANGE disconnects an unknown session');
+                }
+                this.#entries.delete(sessionId);
+            }
+            this.#emit();
+            return true;
+        }
+        return false;
+    }
+    disconnected() {
+        if (this.#entries.size === 0)
+            return;
+        this.#entries.clear();
+        this.#emit();
+    }
+    stop() {
+        this.disconnected();
+        this.#listeners.clear();
+    }
+    #emit() {
+        this.#listeners.emit(this.snapshot(), () => {
+            safeLog(this.#host.logger(), { level: 'error', event: 'presence_listener_failed' });
+        });
+    }
+}
+//# sourceMappingURL=presence.js.map

package/dist/internal/presence.js.map

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

package/dist/internal/resources.d.ts

@@ -0,0 +1,33 @@
+import type { Unsubscribe } from '../api.js';
+export interface Deferred<T> {
+    readonly promise: Promise<T>;
+    readonly settled: boolean;
+    resolve(value: T | PromiseLike<T>): void;
+    reject(reason: unknown): void;
+}
+export declare function createDeferred<T>(): Deferred<T>;
+export declare class ListenerSet<T> {
+    #private;
+    subscribe(listener: (value: T) => void): Unsubscribe;
+    emit(value: T, onError?: (error: unknown) => void): void;
+    clear(): void;
+    get size(): number;
+}
+export declare class IdSequence {
+    #private;
+    take(): number;
+}
+export declare class AsyncValueQueue<T> implements AsyncIterableIterator<T> {
+    #private;
+    constructor(onConsume?: () => void);
+    push(value: T): boolean;
+    close(): void;
+    fail(reason: unknown): void;
+    next(): Promise<IteratorResult<T>>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+export declare function childAbortController(parent?: AbortSignal): {
+    controller: AbortController;
+    dispose: Unsubscribe;
+};
+//# sourceMappingURL=resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/internal/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAsB/C;AAED,qBAAa,WAAW,CAAC,CAAC;;IAGxB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW,CAQnD;IAED,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAQvD;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,qBAAa,UAAU;;IAGrB,IAAI,IAAI,MAAM,CAOb;CACF;AAOD,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;;IAOjE,YAAY,SAAS,CAAC,EAAE,MAAM,IAAI,EAEjC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAUtB;IAED,KAAK,IAAI,IAAI,CAMZ;IAED,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAM1B;IAED,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAajC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAEjD;CACF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG;IAC1D,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC;CACtB,CASA"}

package/dist/internal/resources.js

@@ -0,0 +1,136 @@
+export function createDeferred() {
+    let resolvePromise;
+    let rejectPromise;
+    let settled = false;
+    const promise = new Promise((resolve, reject) => {
+        resolvePromise = resolve;
+        rejectPromise = reject;
+    });
+    return {
+        promise,
+        get settled() { return settled; },
+        resolve(value) {
+            if (settled)
+                return;
+            settled = true;
+            resolvePromise?.(value);
+        },
+        reject(reason) {
+            if (settled)
+                return;
+            settled = true;
+            rejectPromise?.(reason);
+        },
+    };
+}
+export class ListenerSet {
+    #listeners = new Set();
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            this.#listeners.delete(listener);
+        };
+    }
+    emit(value, onError) {
+        for (const listener of [...this.#listeners]) {
+            try {
+                listener(value);
+            }
+            catch (error) {
+                onError?.(error);
+            }
+        }
+    }
+    clear() {
+        this.#listeners.clear();
+    }
+    get size() {
+        return this.#listeners.size;
+    }
+}
+export class IdSequence {
+    #next = 1;
+    take() {
+        if (!Number.isSafeInteger(this.#next)) {
+            throw new RangeError('Identifier namespace is exhausted');
+        }
+        const value = this.#next;
+        this.#next += 1;
+        return value;
+    }
+}
+export class AsyncValueQueue {
+    #values = [];
+    #waiters = [];
+    #onConsume;
+    #terminal = 'open';
+    #failure;
+    constructor(onConsume) {
+        this.#onConsume = onConsume;
+    }
+    push(value) {
+        if (this.#terminal !== 'open')
+            return false;
+        const waiter = this.#waiters.shift();
+        if (waiter !== undefined) {
+            waiter.resolve({ done: false, value });
+            this.#onConsume?.();
+        }
+        else {
+            this.#values.push({ value });
+        }
+        return true;
+    }
+    close() {
+        if (this.#terminal !== 'open')
+            return;
+        this.#terminal = 'closed';
+        for (const waiter of this.#waiters.splice(0)) {
+            waiter.resolve({ done: true, value: undefined });
+        }
+    }
+    fail(reason) {
+        if (this.#terminal !== 'open')
+            return;
+        this.#terminal = 'failed';
+        this.#failure = reason;
+        this.#values.length = 0;
+        for (const waiter of this.#waiters.splice(0))
+            waiter.reject(reason);
+    }
+    next() {
+        const entry = this.#values.shift();
+        if (entry !== undefined) {
+            this.#onConsume?.();
+            return Promise.resolve({ done: false, value: entry.value });
+        }
+        if (this.#terminal === 'closed') {
+            return Promise.resolve({ done: true, value: undefined });
+        }
+        if (this.#terminal === 'failed')
+            return Promise.reject(this.#failure);
+        return new Promise((resolve, reject) => {
+            this.#waiters.push({ resolve, reject });
+        });
+    }
+    [Symbol.asyncIterator]() {
+        return this;
+    }
+}
+export function childAbortController(parent) {
+    const controller = new AbortController();
+    const abort = () => controller.abort(parent?.reason);
+    if (parent?.aborted === true)
+        abort();
+    else
+        parent?.addEventListener('abort', abort, { once: true });
+    return {
+        controller,
+        dispose() { parent?.removeEventListener('abort', abort); },
+    };
+}
+//# sourceMappingURL=resources.js.map

package/dist/internal/resources.js.map

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

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