miakapi 3.0.31 → 4.0.0-alpha.1

package/dist/internal/errors.js

@@ -0,0 +1,72 @@
+export class CoordinatorError extends Error {
+    kind;
+    retryable;
+    outcome;
+    code;
+    correlation;
+    constructor(kind, outcome, message, options = {}) {
+        super(message);
+        this.name = 'CoordinatorFailure';
+        this.kind = kind;
+        this.outcome = outcome;
+        this.retryable = options.retryable ?? false;
+        if (options.code !== undefined)
+            this.code = options.code;
+        if (options.correlation !== undefined) {
+            this.correlation = Object.freeze({ ...options.correlation });
+        }
+    }
+}
+export function invalidLifecycle(message) {
+    return new CoordinatorError('invalid_lifecycle', 'not_dispatched', message);
+}
+export function unavailable(message = 'Coordinator is not ready') {
+    return new CoordinatorError('unavailable', 'not_dispatched', message, { retryable: true });
+}
+export function cancelled(outcome, message = 'Operation was cancelled') {
+    return new CoordinatorError('cancelled', outcome, message);
+}
+export function superseded() {
+    return new CoordinatorError('superseded', 'not_dispatched', 'Declaration was superseded by a newer desired snapshot');
+}
+export function outcomeUnknown(message = 'Transport closed after operation handoff') {
+    return new CoordinatorError('unavailable', 'outcome_unknown', message, { retryable: false });
+}
+export function internalFailure(message = 'Coordinator internal failure') {
+    return new CoordinatorError('internal', 'not_dispatched', message);
+}
+export function protocolFailure(message = 'Relay protocol violation') {
+    return new CoordinatorError('protocol', 'not_dispatched', message);
+}
+function kindFromCode(code) {
+    if (code >= 1100 && code <= 1102)
+        return 'authentication';
+    if (code >= 1200 && code <= 1203)
+        return 'authorization';
+    if (code >= 1300 && code <= 1305)
+        return 'conflict';
+    if (code === 1405)
+        return 'cancelled';
+    if (code >= 1000 && code <= 1005)
+        return 'protocol';
+    if (code === 1500)
+        return 'internal';
+    return 'unavailable';
+}
+export function relayFailure(code, retryable, outcome, correlation) {
+    const options = correlation === undefined
+        ? { code, retryable }
+        : { code, retryable, correlation };
+    return new CoordinatorError(kindFromCode(code), outcome, 'Relay rejected the operation', options);
+}
+export function safeLog(logger, record) {
+    if (logger === undefined)
+        return;
+    try {
+        logger.write(Object.freeze({ ...record }));
+    }
+    catch {
+        // A diagnostic sink must never control coordinator execution.
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/internal/errors.js.map

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

package/dist/internal/events.d.ts

@@ -0,0 +1,27 @@
+import type { CoordinatorEvents, CoordinatorLogger, DeclarationOptions, EventDeclaration, EventHandle, EventTarget, IncomingEvent, OperationOptions, ProtocolValue, Unsubscribe } from '../api.js';
+import { type Frame } from '../protocol/codec.js';
+import type { ActiveDeclarations, DeclarationManager } from './declarations.js';
+import { relayFailure } from './errors.js';
+import type { RelaySession } from './session.js';
+export interface EventHost {
+    readySession(): RelaySession | undefined;
+    activeDeclarations(): ActiveDeclarations | undefined;
+    nextEventId(): number;
+    nextLocalEventId(): number;
+    emitFailure(failure: ReturnType<typeof relayFailure>): void;
+    logger(): CoordinatorLogger | undefined;
+}
+export declare class EventManager implements CoordinatorEvents {
+    #private;
+    constructor(host: EventHost, declarations: DeclarationManager);
+    declare(entries: readonly EventDeclaration[], options?: DeclarationOptions): Promise<import('../api.js').DeclarationReceipt>;
+    publish(topic: string, value: ProtocolValue, options?: OperationOptions & {
+        target?: EventTarget;
+    }): EventHandle;
+    subscribe(topic: string, listener: (event: IncomingEvent) => void): Unsubscribe;
+    handleFrame(frame: Frame): boolean;
+    handleError(eventId: number, code: number, retryable: boolean): boolean;
+    disconnected(): void;
+    stop(): void;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/internal/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAEhB,aAAa,EAEb,WAAW,EACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAU,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAA6B,YAAY,EAAwB,MAAM,aAAa,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAUjD,MAAM,WAAW,SAAS;IACxB,YAAY,IAAI,YAAY,GAAG,SAAS,CAAC;IACzC,kBAAkB,IAAI,kBAAkB,GAAG,SAAS,CAAC;IACrD,WAAW,IAAI,MAAM,CAAC;IACtB,gBAAgB,IAAI,MAAM,CAAC;IAC3B,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC;IAC5D,MAAM,IAAI,iBAAiB,GAAG,SAAS,CAAC;CACzC;AAoCD,qBAAa,YAAa,YAAW,iBAAiB;;IAQpD,YAAY,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAG5D;IAED,OAAO,CACL,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,WAAW,EAAE,kBAAkB,CAAC,CAGjD;IAED,OAAO,CACL,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,gBAAgB,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxD,WAAW,CAoEb;IAED,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW,CAgB9E;IAED,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAiBjC;IAED,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAsBtE;IAED,YAAY,IAAI,IAAI,CAUnB;IAED,IAAI,IAAI,IAAI,CAGX;CAOF"}

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