miakapi 3.0.3-DEV → 4.0.0-alpha.0

package/dist/internal/declarations.js

@@ -0,0 +1,427 @@
+import { LIMITS, Opcode } from '../protocol/codec.js';
+import { cancelled, invalidLifecycle, relayFailure, superseded, } from './errors.js';
+import { createDeferred } from './resources.js';
+import { validateDeclarationOptions, validateEventAccess, validateStateAccess, } from './validation.js';
+export const DECLARATION_DOMAINS = Object.freeze([
+    'state',
+    'state_access',
+    'events',
+    'event_access',
+    'functions',
+]);
+const EMPTY_REVISIONS = Object.freeze({
+    state: 0,
+    state_access: 0,
+    events: 0,
+    event_access: 0,
+    functions: 0,
+});
+function emptySnapshot() {
+    return Object.freeze({
+        state: Object.freeze({}),
+        stateAccess: Object.freeze([]),
+        events: Object.freeze([]),
+        eventAccess: Object.freeze([]),
+        functions: Object.freeze({}),
+        revisions: EMPTY_REVISIONS,
+    });
+}
+function copyRevisions(value) {
+    return Object.freeze({ ...value });
+}
+function copySnapshot(value) {
+    return Object.freeze({
+        state: value.state,
+        stateAccess: value.stateAccess,
+        events: value.events,
+        eventAccess: value.eventAccess,
+        functions: value.functions,
+        revisions: copyRevisions(value.revisions),
+    });
+}
+function revisionsEqual(left, right) {
+    return DECLARATION_DOMAINS.every((domain) => left[domain] === right[domain]);
+}
+function frameRequestId(frame) {
+    const value = frame.payload[0];
+    return typeof value === 'number' && Number.isSafeInteger(value) ? value : undefined;
+}
+function dictionary(value, expectedNames) {
+    if (!Array.isArray(value))
+        throw new TypeError('Relay dictionary is not an array');
+    const result = new Map();
+    const ids = new Set();
+    for (const raw of value) {
+        if (!Array.isArray(raw))
+            throw new TypeError('Relay dictionary entry is not an array');
+        const id = raw[0];
+        const name = raw[1];
+        if (typeof id !== 'number' || !Number.isSafeInteger(id) || typeof name !== 'string') {
+            throw new TypeError('Relay dictionary entry is invalid');
+        }
+        if (ids.has(id) || result.has(name))
+            throw new TypeError('Relay dictionary contains a duplicate');
+        ids.add(id);
+        result.set(name, id);
+    }
+    if (result.size !== expectedNames.length
+        || expectedNames.some((name) => !result.has(name))) {
+        throw new TypeError('Relay dictionary does not match the declared snapshot');
+    }
+    return result;
+}
+function ackDomain(opcode) {
+    if (opcode === Opcode.StateSyncOk)
+        return 'state';
+    if (opcode === Opcode.StateAclOk)
+        return 'state_access';
+    if (opcode === Opcode.EventSyncOk)
+        return 'events';
+    if (opcode === Opcode.EventAclOk)
+        return 'event_access';
+    if (opcode === Opcode.FunctionSyncOk)
+        return 'functions';
+    return undefined;
+}
+export class DeclarationManager {
+    #host;
+    #pending = [];
+    #requests = new Map();
+    #desired = emptySnapshot();
+    #active;
+    #current;
+    #transactionToken = 0;
+    #stopped = false;
+    constructor(host) {
+        this.#host = host;
+    }
+    get desired() {
+        return this.#desired;
+    }
+    get active() {
+        return this.#active;
+    }
+    configure(configuration) {
+        for (const domain of DECLARATION_DOMAINS)
+            this.#supersedeUnprotected(domain);
+        const revisions = {
+            state: this.#desired.revisions.state + 1,
+            state_access: this.#desired.revisions.state_access + 1,
+            events: this.#desired.revisions.events + 1,
+            event_access: this.#desired.revisions.event_access + 1,
+            functions: this.#desired.revisions.functions + 1,
+        };
+        this.#desired = Object.freeze({
+            ...configuration,
+            revisions: Object.freeze(revisions),
+        });
+    }
+    declareState(state, signal) {
+        return this.#replace('state', (snapshot, revisions) => copySnapshot({ ...snapshot, state, revisions }), signal);
+    }
+    declareStateAccess(stateAccess, signal) {
+        return this.#replace('state_access', (snapshot, revisions) => copySnapshot({ ...snapshot, stateAccess, revisions }), signal);
+    }
+    declareEvents(events, signal) {
+        return this.#replace('events', (snapshot, revisions) => copySnapshot({ ...snapshot, events, revisions }), signal);
+    }
+    declareEventAccess(eventAccess, signal) {
+        return this.#replace('event_access', (snapshot, revisions) => copySnapshot({ ...snapshot, eventAccess, revisions }), signal);
+    }
+    declareFunctions(functions, signal) {
+        return this.#replace('functions', (snapshot, revisions) => copySnapshot({ ...snapshot, functions, revisions }), signal);
+    }
+    synchronize(session) {
+        this.#requests.clear();
+        this.#current = undefined;
+        this.#begin(session);
+    }
+    handleFrame(frame) {
+        const domain = ackDomain(frame.opcode);
+        if (domain === undefined)
+            return false;
+        const requestId = frameRequestId(frame);
+        if (requestId === undefined)
+            throw new TypeError('Declaration acknowledgement has no request ID');
+        const request = this.#requests.get(requestId);
+        if (request === undefined)
+            throw new TypeError('Declaration acknowledgement is not correlated');
+        this.#requests.delete(requestId);
+        const current = this.#current;
+        if (current === undefined || request.token !== current.token)
+            return true;
+        const expectedDomain = DECLARATION_DOMAINS[current.index];
+        if (request.domain !== domain || expectedDomain !== domain) {
+            throw new TypeError('Declaration acknowledgement is out of order');
+        }
+        if (domain === 'state') {
+            const epoch = frame.payload[1];
+            const expectedEpoch = current.session.welcome.epoch;
+            if (!(epoch instanceof Uint8Array)
+                || epoch.length !== expectedEpoch.length
+                || epoch.some((value, index) => value !== expectedEpoch[index])) {
+                throw new TypeError('STATE_SYNC_OK uses a stale epoch');
+            }
+            current.stateIds = dictionary(frame.payload[3], Object.keys(current.snapshot.state));
+        }
+        if (domain === 'events') {
+            current.topicIds = dictionary(frame.payload[1], current.snapshot.events.map(({ topic }) => topic));
+        }
+        if (domain === 'functions') {
+            current.functionIds = dictionary(frame.payload[1], Object.keys(current.snapshot.functions));
+        }
+        current.index += 1;
+        if (current.index === DECLARATION_DOMAINS.length)
+            this.#activate(current);
+        else
+            void this.#sendCurrentDomain(current);
+        return true;
+    }
+    handleError(requestId, code, retryable) {
+        const request = this.#requests.get(requestId);
+        if (request === undefined)
+            return false;
+        this.#requests.delete(requestId);
+        const current = this.#current;
+        if (current === undefined || request.token !== current.token)
+            return true;
+        if (retryable) {
+            this.#host.transportFailure(relayFailure(code, true, 'not_dispatched'));
+            return true;
+        }
+        this.#rejectTransaction(current, relayFailure(code, false, 'not_dispatched'));
+        return true;
+    }
+    disconnected() {
+        this.#requests.clear();
+        this.#current = undefined;
+    }
+    stop() {
+        this.#stopped = true;
+        this.#requests.clear();
+        this.#current = undefined;
+        for (const pending of this.#pending.splice(0)) {
+            this.#removePendingAbort(pending);
+            pending.deferred.reject(cancelled('not_dispatched', 'Coordinator stopped before declaration activation'));
+        }
+    }
+    #replace(domain, update, signal) {
+        if (this.#stopped)
+            return Promise.reject(invalidLifecycle('Coordinator is stopped'));
+        if (signal?.aborted === true)
+            return Promise.reject(cancelled('not_dispatched'));
+        if (this.#pending.length >= LIMITS.declarationsPerCoordinator
+            || this.#requests.size >= LIMITS.declarationsPerCoordinator) {
+            return Promise.reject(new RangeError('Too many pending declarations'));
+        }
+        this.#supersedeUnprotected(domain);
+        const revision = this.#desired.revisions[domain] + 1;
+        const revisions = copyRevisions({ ...this.#desired.revisions, [domain]: revision });
+        this.#desired = update(this.#desired, revisions);
+        const deferred = createDeferred();
+        const pending = { domain, revision, deferred };
+        if (signal !== undefined) {
+            const abort = () => {
+                const index = this.#pending.indexOf(pending);
+                if (index !== -1)
+                    this.#pending.splice(index, 1);
+                deferred.reject(cancelled('not_dispatched'));
+            };
+            pending.signal = signal;
+            pending.abort = abort;
+            signal.addEventListener('abort', abort, { once: true });
+        }
+        this.#pending.push(pending);
+        const session = this.#host.currentSession();
+        if (session !== undefined) {
+            if (this.#current === undefined)
+                this.#begin(session);
+            else if (!this.#current.handedOff) {
+                this.#current = undefined;
+                this.#begin(session);
+            }
+        }
+        return deferred.promise;
+    }
+    #supersedeUnprotected(domain) {
+        const protectedRevision = this.#current?.handedOff === true
+            ? this.#current.snapshot.revisions[domain]
+            : 0;
+        for (let index = this.#pending.length - 1; index >= 0; index -= 1) {
+            const pending = this.#pending[index];
+            if (pending?.domain !== domain || pending.revision <= protectedRevision)
+                continue;
+            this.#pending.splice(index, 1);
+            this.#removePendingAbort(pending);
+            pending.deferred.reject(superseded());
+        }
+    }
+    #begin(session) {
+        this.#transactionToken += 1;
+        const welcome = session.welcome;
+        this.#current = {
+            token: this.#transactionToken,
+            snapshot: copySnapshot(this.#desired),
+            session,
+            receipt: Object.freeze({
+                sessionId: welcome.readySession.sessionId,
+                generation: welcome.readySession.generation,
+            }),
+            index: 0,
+            handedOff: false,
+            stateIds: new Map(),
+            topicIds: new Map(),
+            functionIds: new Map(),
+        };
+        this.#host.synchronizing();
+        if (this.#stopped) {
+            this.#current = undefined;
+            return;
+        }
+        void this.#sendCurrentDomain(this.#current);
+    }
+    async #sendCurrentDomain(transaction) {
+        const domain = DECLARATION_DOMAINS[transaction.index];
+        if (domain === undefined || this.#current?.token !== transaction.token)
+            return;
+        const requestId = this.#host.nextRequestId();
+        this.#requests.set(requestId, { token: transaction.token, domain });
+        const frame = this.#frameFor(transaction.snapshot, domain, requestId);
+        if (domain === 'functions')
+            transaction.handedOff = true;
+        try {
+            await transaction.session.send(frame);
+        }
+        catch (error) {
+            if (this.#current?.token === transaction.token)
+                this.#host.transportFailure(error);
+        }
+    }
+    #frameFor(snapshot, domain, requestId) {
+        if (domain === 'state') {
+            return {
+                opcode: Opcode.StateSync,
+                payload: [requestId, Object.entries(snapshot.state).map(([path, value]) => [path, value])],
+            };
+        }
+        if (domain === 'state_access') {
+            return {
+                opcode: Opcode.StateAclSync,
+                payload: [requestId, snapshot.stateAccess.map(({ userId, patterns }) => [
+                        userId,
+                        [...patterns],
+                    ])],
+            };
+        }
+        if (domain === 'events') {
+            return {
+                opcode: Opcode.EventSync,
+                payload: [requestId, snapshot.events.map(({ topic, directions }) => [topic, directions])],
+            };
+        }
+        if (domain === 'event_access') {
+            return {
+                opcode: Opcode.EventAclSync,
+                payload: [requestId, snapshot.eventAccess.map(({ userId, publish, subscribe }) => [
+                        userId,
+                        [...publish],
+                        [...subscribe],
+                    ])],
+            };
+        }
+        return {
+            opcode: Opcode.FunctionSync,
+            payload: [requestId, Object.keys(snapshot.functions)],
+        };
+    }
+    #activate(transaction) {
+        if (this.#current?.token !== transaction.token)
+            return;
+        this.#active = Object.freeze({
+            snapshot: transaction.snapshot,
+            receipt: transaction.receipt,
+            stateIds: transaction.stateIds,
+            topicIds: transaction.topicIds,
+            functionIds: transaction.functionIds,
+        });
+        this.#current = undefined;
+        this.#host.activeDeclarationsChanged(this.#active);
+        this.#settleThrough(transaction.snapshot.revisions, transaction.receipt, undefined);
+        if (!revisionsEqual(this.#desired.revisions, transaction.snapshot.revisions)) {
+            this.#begin(transaction.session);
+        }
+        else {
+            this.#host.declarationsReady(transaction.receipt);
+        }
+    }
+    #rejectTransaction(transaction, failure) {
+        if (this.#current?.token !== transaction.token)
+            return;
+        this.#current = undefined;
+        this.#settleThrough(transaction.snapshot.revisions, transaction.receipt, failure);
+        const activeSnapshot = this.#active?.snapshot ?? emptySnapshot();
+        const desired = this.#desired;
+        const revisions = { ...desired.revisions };
+        const next = {
+            state: desired.state,
+            stateAccess: desired.stateAccess,
+            events: desired.events,
+            eventAccess: desired.eventAccess,
+            functions: desired.functions,
+        };
+        for (const domain of DECLARATION_DOMAINS) {
+            if (desired.revisions[domain] > transaction.snapshot.revisions[domain])
+                continue;
+            revisions[domain] = activeSnapshot.revisions[domain];
+            if (domain === 'state')
+                next.state = activeSnapshot.state;
+            if (domain === 'state_access')
+                next.stateAccess = activeSnapshot.stateAccess;
+            if (domain === 'events')
+                next.events = activeSnapshot.events;
+            if (domain === 'event_access')
+                next.eventAccess = activeSnapshot.eventAccess;
+            if (domain === 'functions')
+                next.functions = activeSnapshot.functions;
+        }
+        this.#desired = copySnapshot({ ...next, revisions: copyRevisions(revisions) });
+        const hasQueuedSnapshot = !revisionsEqual(this.#desired.revisions, activeSnapshot.revisions);
+        const hasActiveConfiguration = this.#active?.receipt.sessionId === transaction.receipt.sessionId
+            && this.#active.receipt.generation === transaction.receipt.generation;
+        this.#host.declarationFailure(failure, hasActiveConfiguration, hasQueuedSnapshot);
+        if (hasQueuedSnapshot) {
+            this.#begin(transaction.session);
+        }
+    }
+    #settleThrough(revisions, receipt, failure) {
+        for (let index = this.#pending.length - 1; index >= 0; index -= 1) {
+            const pending = this.#pending[index];
+            if (pending === undefined || pending.revision > revisions[pending.domain])
+                continue;
+            this.#pending.splice(index, 1);
+            this.#removePendingAbort(pending);
+            if (failure === undefined)
+                pending.deferred.resolve(receipt);
+            else
+                pending.deferred.reject(failure);
+        }
+    }
+    #removePendingAbort(pending) {
+        if (pending.signal !== undefined && pending.abort !== undefined) {
+            pending.signal.removeEventListener('abort', pending.abort);
+        }
+    }
+}
+export class AccessManager {
+    #declarations;
+    constructor(declarations) {
+        this.#declarations = declarations;
+    }
+    declareState(entries, options = {}) {
+        return this.#declarations.declareStateAccess(validateStateAccess(entries), validateDeclarationOptions(options, 'state access declaration'));
+    }
+    declareEvents(entries, options = {}) {
+        return this.#declarations.declareEventAccess(validateEventAccess(entries), validateDeclarationOptions(options, 'event access declaration'));
+    }
+}
+//# sourceMappingURL=declarations.js.map

package/dist/internal/declarations.js.map

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

package/dist/internal/errors.d.ts

@@ -0,0 +1,31 @@
+import type { CoordinatorFailure, CoordinatorLogRecord, CoordinatorLogger, DispatchOutcome } from '../api.js';
+interface FailureOptions {
+    code?: number;
+    correlation?: {
+        kind: 'event' | 'call';
+        localId: string;
+    };
+    retryable?: boolean;
+}
+export declare class CoordinatorError extends Error implements CoordinatorFailure {
+    readonly kind: CoordinatorFailure['kind'];
+    readonly retryable: boolean;
+    readonly outcome: DispatchOutcome;
+    readonly code?: number;
+    readonly correlation?: {
+        kind: 'event' | 'call';
+        localId: string;
+    };
+    constructor(kind: CoordinatorFailure['kind'], outcome: DispatchOutcome, message: string, options?: FailureOptions);
+}
+export declare function invalidLifecycle(message: string): CoordinatorError;
+export declare function unavailable(message?: string): CoordinatorError;
+export declare function cancelled(outcome: 'not_dispatched' | 'outcome_unknown', message?: string): CoordinatorError;
+export declare function superseded(): CoordinatorError;
+export declare function outcomeUnknown(message?: string): CoordinatorError;
+export declare function internalFailure(message?: string): CoordinatorError;
+export declare function protocolFailure(message?: string): CoordinatorError;
+export declare function relayFailure(code: number, retryable: boolean, outcome: DispatchOutcome, correlation?: FailureOptions['correlation']): CoordinatorError;
+export declare function safeLog(logger: CoordinatorLogger | undefined, record: CoordinatorLogRecord): void;
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EAChB,MAAM,WAAW,CAAC;AAEnB,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,gBAAiB,SAAQ,KAAM,YAAW,kBAAkB;IACvE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,YACE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,EAW7B;CACF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAElE;AAED,wBAAgB,WAAW,CAAC,OAAO,SAA6B,GAAG,gBAAgB,CAElF;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,EAC7C,OAAO,SAA4B,GAClC,gBAAgB,CAElB;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAM7C;AAED,wBAAgB,cAAc,CAAC,OAAO,SAA6C,GAAG,gBAAgB,CAErG;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAiC,GAAG,gBAAgB,CAE1F;AAED,wBAAgB,eAAe,CAAC,OAAO,SAA6B,GAAG,gBAAgB,CAEtF;AAYD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,eAAe,EACxB,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,GAC1C,gBAAgB,CAKlB;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAOjG"}

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