@softomnitel/omnicall-kit 0.1.0-rc.0

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

@@ -0,0 +1,61 @@
+/**
+ * Internal connection session: transport lifecycle, state machine, correlation,
+ * heartbeat, and bounded reconnect. No product OmniCallClient methods.
+ */
+import type { CommandType } from '@softomnitel/omnicall-protocol';
+import { type ConnectionState } from './connection-state.js';
+import type { DiagnosticsSink } from './diagnostics.js';
+import { type HeartbeatPolicy } from './heartbeat-controller.js';
+import { type ReconnectPolicy } from './reconnect-policy.js';
+import { type PendingRequestResult } from './request-correlator.js';
+import type { JitterSource, Scheduler } from './scheduler.js';
+import type { OmniCallClientError } from './client-errors.js';
+import type { TransportFactory, TransportPort } from './transport-port.js';
+export type SessionWireIdentity = {
+    readonly serverInstanceId: string;
+    readonly sessionEpoch: string;
+};
+export type ConnectionSessionOptions = {
+    readonly url: string;
+    readonly transportFactory: TransportFactory;
+    readonly scheduler: Scheduler;
+    readonly jitter: JitterSource;
+    readonly diagnostics?: DiagnosticsSink;
+    readonly reconnect?: ReconnectPolicy;
+    readonly heartbeat?: HeartbeatPolicy;
+    readonly defaultRequestTimeoutMs?: number;
+    readonly onUnhandledMessage?: (data: string) => void;
+    readonly onHandshaking?: () => void;
+};
+export type OutboundCommandRequest = {
+    readonly requestId: string;
+    readonly commandType: CommandType;
+    readonly body: string;
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+};
+export type ConnectionSession = {
+    readonly getState: () => ConnectionState;
+    readonly connect: () => void;
+    readonly disconnect: () => void;
+    readonly requestReauth: () => void;
+    readonly setWireIdentity: (identity: SessionWireIdentity | undefined) => void;
+    readonly getWireIdentity: () => SessionWireIdentity | undefined;
+    readonly signalPairingRequired: () => void;
+    readonly signalAuthenticating: () => void;
+    readonly signalReady: (heartbeatSeconds?: number) => void;
+    readonly signalIncompatible: () => void;
+    readonly signalRevoked: () => void;
+    readonly signalFailed: () => void;
+    readonly signalOriginPolicyFailure: (error: OmniCallClientError) => void;
+    readonly getConnectError: () => OmniCallClientError | undefined;
+    readonly request: (command: OutboundCommandRequest) => Promise<PendingRequestResult>;
+    readonly sendRaw: (body: string) => boolean;
+    readonly onStateChange: (listener: (state: ConnectionState) => void) => () => void;
+    readonly pendingRequestCount: () => number;
+    readonly reconnectAttemptCount: () => number;
+    readonly mutationSendCount: () => number;
+    readonly activeTransport: () => TransportPort | undefined;
+};
+export declare function createConnectionSession(options: ConnectionSessionOptions): ConnectionSession;
+//# sourceMappingURL=connection-session.d.ts.map

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

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

package/dist/internal/connection-session.js

@@ -0,0 +1,333 @@
+/**
+ * Internal connection session: transport lifecycle, state machine, correlation,
+ * heartbeat, and bounded reconnect. No product OmniCallClient methods.
+ */
+import { isMutationCommand } from './command-classification.js';
+import { assertTransition, isReconnectEligible, isTerminalConnectionState } from './connection-state.js';
+import { createHeartbeatController, DEFAULT_HEARTBEAT_POLICY } from './heartbeat-controller.js';
+import { computeReconnectDelayMs, DEFAULT_RECONNECT_POLICY, hasReconnectAttemptsRemaining } from './reconnect-policy.js';
+import { createRequestCorrelator } from './request-correlator.js';
+import { mapTransportCloseToOriginPolicyError } from './origin-policy-errors.js';
+export function createConnectionSession(options) {
+    const reconnectPolicy = options.reconnect ?? DEFAULT_RECONNECT_POLICY;
+    const heartbeatPolicy = options.heartbeat ?? DEFAULT_HEARTBEAT_POLICY;
+    const defaultTimeoutMs = options.defaultRequestTimeoutMs ?? 5_000;
+    const diagnostics = options.diagnostics;
+    let state = 'idle';
+    let transport;
+    let unsubscribers = [];
+    let reconnectAttempts = 0;
+    let reconnectTimer;
+    let intentionalClose = false;
+    let wireIdentity;
+    let connectError;
+    const stateListeners = new Set();
+    const correlator = createRequestCorrelator({
+        scheduler: options.scheduler,
+        ...(diagnostics !== undefined ? { diagnostics } : {})
+    });
+    const setState = (next) => {
+        assertTransition(state, next);
+        state = next;
+        diagnostics?.emit({
+            level: 'info',
+            code: 'connection.state',
+            connectionState: next
+        });
+        for (const listener of stateListeners) {
+            listener(next);
+        }
+    };
+    const clearReconnectTimer = () => {
+        reconnectTimer?.clear();
+        reconnectTimer = undefined;
+    };
+    const detachTransport = () => {
+        for (const unsubscribe of unsubscribers) {
+            unsubscribe();
+        }
+        unsubscribers = [];
+        transport = undefined;
+    };
+    const rejectPending = (reason) => {
+        correlator.rejectAll(reason, state);
+    };
+    const heartbeat = createHeartbeatController({
+        scheduler: options.scheduler,
+        ...(diagnostics !== undefined ? { diagnostics } : {}),
+        timeoutMs: heartbeatPolicy.timeoutMs,
+        connectionState: () => state,
+        sendPing: async (timeoutMs) => sendHeartbeatPing(timeoutMs),
+        onMissed: () => {
+            if (state !== 'ready' || transport === undefined) {
+                return;
+            }
+            intentionalClose = false;
+            transport.close(4000, 'heartbeat_missed');
+        }
+    });
+    const sendHeartbeatPing = async (timeoutMs) => {
+        if (state !== 'ready' || transport === undefined) {
+            return false;
+        }
+        const requestId = `hb_${options.scheduler.now()}`;
+        const body = JSON.stringify({
+            protocolVersion: 1,
+            kind: 'command',
+            type: 'sdk:ping',
+            requestId,
+            serverInstanceId: wireIdentity?.serverInstanceId ?? 'pending',
+            sessionEpoch: wireIdentity?.sessionEpoch ?? 'pending',
+            occurredAt: new Date(options.scheduler.now()).toISOString(),
+            payload: {}
+        });
+        try {
+            transport.send(body);
+        }
+        catch {
+            return false;
+        }
+        const result = await correlator.track({
+            requestId,
+            commandType: 'sdk:ping',
+            mutation: false
+        }, { timeoutMs, connectionState: state });
+        return result.ok;
+    };
+    const openTransport = () => {
+        detachTransport();
+        intentionalClose = false;
+        const next = options.transportFactory();
+        transport = next;
+        unsubscribers = [
+            next.onOpen(() => {
+                if (state === 'connecting') {
+                    setState('handshaking');
+                    options.onHandshaking?.();
+                }
+            }),
+            next.onMessage((data) => {
+                const handled = correlator.handleInbound(data, state);
+                if (!handled) {
+                    options.onUnhandledMessage?.(data);
+                }
+            }),
+            next.onClose((closeInfo) => {
+                detachTransport();
+                if (intentionalClose || isTerminalConnectionState(state) || state === 'closed') {
+                    return;
+                }
+                const originPolicyError = mapTransportCloseToOriginPolicyError(closeInfo, state);
+                if (originPolicyError !== undefined) {
+                    signalOriginPolicyFailure(originPolicyError);
+                    return;
+                }
+                if (isReconnectEligible(state)) {
+                    beginReconnect('transport_closed');
+                }
+            }),
+            next.onError(() => {
+                diagnostics?.emit({
+                    level: 'warn',
+                    code: 'transport.error',
+                    connectionState: state
+                });
+            })
+        ];
+        next.connect(options.url);
+    };
+    const beginReconnect = (code) => {
+        heartbeat.stop();
+        rejectPending('disconnect');
+        clearReconnectTimer();
+        wireIdentity = undefined;
+        if (state !== 'reconnecting' && isReconnectEligible(state)) {
+            setState('reconnecting');
+        }
+        diagnostics?.emit({
+            level: 'warn',
+            code: `reconnect.${code}`,
+            connectionState: state,
+            attempt: reconnectAttempts
+        });
+        if (!hasReconnectAttemptsRemaining(reconnectPolicy, reconnectAttempts)) {
+            if (state === 'reconnecting') {
+                setState('failed');
+            }
+            return;
+        }
+        const delayMs = computeReconnectDelayMs(reconnectPolicy, reconnectAttempts, options.jitter);
+        reconnectAttempts += 1;
+        reconnectTimer = options.scheduler.setTimeout(() => {
+            reconnectTimer = undefined;
+            if (state !== 'reconnecting') {
+                return;
+            }
+            setState('connecting');
+            openTransport();
+        }, delayMs);
+    };
+    const enterTerminal = (next) => {
+        intentionalClose = true;
+        clearReconnectTimer();
+        heartbeat.stop();
+        rejectPending('aborted');
+        wireIdentity = undefined;
+        if (transport !== undefined) {
+            transport.close(1000, next);
+        }
+        detachTransport();
+        setState(next);
+    };
+    const signalOriginPolicyFailure = (error) => {
+        connectError = error;
+        intentionalClose = true;
+        clearReconnectTimer();
+        heartbeat.stop();
+        rejectPending('aborted');
+        wireIdentity = undefined;
+        if (transport !== undefined) {
+            transport.close(1000, 'origin_policy');
+        }
+        detachTransport();
+        if (state !== 'failed') {
+            setState('failed');
+        }
+    };
+    const canSendCommand = (commandType) => {
+        if (state === 'ready') {
+            return true;
+        }
+        return state === 'authenticating' && commandType === 'sdk:ping';
+    };
+    return {
+        getState: () => state,
+        connect: () => {
+            if (state !== 'idle') {
+                throw new Error(`connect() requires idle, got ${state}`);
+            }
+            reconnectAttempts = 0;
+            correlator.clearMutationLedger();
+            wireIdentity = undefined;
+            connectError = undefined;
+            setState('connecting');
+            openTransport();
+        },
+        disconnect: () => {
+            if (state === 'closed') {
+                return;
+            }
+            intentionalClose = true;
+            clearReconnectTimer();
+            heartbeat.stop();
+            rejectPending('aborted');
+            wireIdentity = undefined;
+            connectError = undefined;
+            if (transport !== undefined) {
+                transport.close(1000, 'client_disconnect');
+            }
+            detachTransport();
+            setState('closed');
+        },
+        requestReauth: () => {
+            if (transport === undefined || !isReconnectEligible(state)) {
+                return;
+            }
+            intentionalClose = false;
+            heartbeat.stop();
+            rejectPending('disconnect');
+            wireIdentity = undefined;
+            transport.close(4001, 'reauth_required');
+        },
+        setWireIdentity: (identity) => {
+            wireIdentity = identity;
+        },
+        getWireIdentity: () => wireIdentity,
+        signalPairingRequired: () => {
+            setState('pairing_required');
+        },
+        signalAuthenticating: () => {
+            setState('authenticating');
+        },
+        signalReady: (heartbeatSeconds) => {
+            setState('ready');
+            reconnectAttempts = 0;
+            if (!heartbeatPolicy.enabled) {
+                return;
+            }
+            const intervalMs = heartbeatSeconds !== undefined
+                ? heartbeatSeconds * 1000
+                : heartbeatPolicy.intervalMs;
+            heartbeat.start(intervalMs);
+        },
+        signalIncompatible: () => {
+            enterTerminal('incompatible');
+        },
+        signalRevoked: () => {
+            enterTerminal('revoked');
+        },
+        signalFailed: () => {
+            enterTerminal('failed');
+        },
+        signalOriginPolicyFailure,
+        getConnectError: () => connectError,
+        sendRaw: (body) => {
+            if (transport === undefined) {
+                return false;
+            }
+            const allowUnauth = state === 'handshaking' ||
+                state === 'pairing_required' ||
+                state === 'authenticating';
+            if (!allowUnauth && state !== 'ready') {
+                return false;
+            }
+            try {
+                transport.send(body);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        request: async (command) => {
+            if (!canSendCommand(command.commandType) || transport === undefined) {
+                return {
+                    ok: false,
+                    errorCode: 'not_ready',
+                    reason: 'invalid_reply'
+                };
+            }
+            const mutation = isMutationCommand(command.commandType);
+            try {
+                transport.send(command.body);
+            }
+            catch {
+                return {
+                    ok: false,
+                    errorCode: 'operation_failed',
+                    reason: 'disconnect'
+                };
+            }
+            return correlator.track({
+                requestId: command.requestId,
+                commandType: command.commandType,
+                mutation
+            }, {
+                timeoutMs: command.timeoutMs ?? defaultTimeoutMs,
+                connectionState: state,
+                ...(command.signal !== undefined ? { signal: command.signal } : {})
+            });
+        },
+        onStateChange: (listener) => {
+            stateListeners.add(listener);
+            return () => {
+                stateListeners.delete(listener);
+            };
+        },
+        pendingRequestCount: () => correlator.pendingCount(),
+        reconnectAttemptCount: () => reconnectAttempts,
+        mutationSendCount: () => correlator.mutationSendCount(),
+        activeTransport: () => transport
+    };
+}
+//# sourceMappingURL=connection-session.js.map

package/dist/internal/connection-session.js.map

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

package/dist/internal/connection-state.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Explicit SDK connection states (ARCHITECTURE.md).
+ * Account/SIP/OCP authorization are never implied by these states.
+ */
+/** Explicit SDK connection states (ARCHITECTURE.md). @public */
+export declare const CONNECTION_STATES: readonly ["idle", "connecting", "handshaking", "pairing_required", "authenticating", "ready", "reconnecting", "incompatible", "revoked", "failed", "closed"];
+/** @public */
+export type ConnectionState = (typeof CONNECTION_STATES)[number];
+export declare function canTransition(from: ConnectionState, to: ConnectionState): boolean;
+export declare function assertTransition(from: ConnectionState, to: ConnectionState): void;
+export declare function isTerminalConnectionState(state: ConnectionState): boolean;
+export declare function isReconnectEligible(state: ConnectionState): boolean;
+//# sourceMappingURL=connection-state.d.ts.map

package/dist/internal/connection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state.d.ts","sourceRoot":"","sources":["../../src/internal/connection-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,8JAYpB,CAAC;AAEX,cAAc;AACd,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAqCjE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,eAAe,GAClB,OAAO,CAET;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,eAAe,GAClB,IAAI,CAIN;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAOzE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CASnE"}

package/dist/internal/connection-state.js

@@ -0,0 +1,75 @@
+/**
+ * Explicit SDK connection states (ARCHITECTURE.md).
+ * Account/SIP/OCP authorization are never implied by these states.
+ */
+/** Explicit SDK connection states (ARCHITECTURE.md). @public */
+export const CONNECTION_STATES = [
+    'idle',
+    'connecting',
+    'handshaking',
+    'pairing_required',
+    'authenticating',
+    'ready',
+    'reconnecting',
+    'incompatible',
+    'revoked',
+    'failed',
+    'closed'
+];
+const LEGAL_TRANSITIONS = {
+    idle: ['connecting', 'closed'],
+    connecting: ['handshaking', 'reconnecting', 'failed', 'closed'],
+    handshaking: [
+        'pairing_required',
+        'authenticating',
+        'incompatible',
+        'reconnecting',
+        'failed',
+        'closed'
+    ],
+    pairing_required: ['authenticating', 'revoked', 'reconnecting', 'failed', 'closed'],
+    authenticating: [
+        'ready',
+        'revoked',
+        'incompatible',
+        'reconnecting',
+        'failed',
+        'closed'
+    ],
+    ready: ['reconnecting', 'incompatible', 'revoked', 'failed', 'closed'],
+    reconnecting: [
+        'connecting',
+        'ready',
+        'incompatible',
+        'revoked',
+        'failed',
+        'closed'
+    ],
+    incompatible: ['closed'],
+    revoked: ['closed'],
+    failed: ['closed'],
+    closed: []
+};
+export function canTransition(from, to) {
+    return LEGAL_TRANSITIONS[from].includes(to);
+}
+export function assertTransition(from, to) {
+    if (!canTransition(from, to)) {
+        throw new Error(`Illegal connection transition: ${from} -> ${to}`);
+    }
+}
+export function isTerminalConnectionState(state) {
+    return (state === 'incompatible' ||
+        state === 'revoked' ||
+        state === 'failed' ||
+        state === 'closed');
+}
+export function isReconnectEligible(state) {
+    return (state === 'connecting' ||
+        state === 'handshaking' ||
+        state === 'pairing_required' ||
+        state === 'authenticating' ||
+        state === 'ready' ||
+        state === 'reconnecting');
+}
+//# sourceMappingURL=connection-state.js.map

package/dist/internal/connection-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state.js","sourceRoot":"","sources":["../../src/internal/connection-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,YAAY;IACZ,aAAa;IACb,kBAAkB;IAClB,gBAAgB;IAChB,OAAO;IACP,cAAc;IACd,cAAc;IACd,SAAS;IACT,QAAQ;IACR,QAAQ;CACA,CAAC;AAKX,MAAM,iBAAiB,GAAkE;IACvF,IAAI,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC;IAC9B,UAAU,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC/D,WAAW,EAAE;QACX,kBAAkB;QAClB,gBAAgB;QAChB,cAAc;QACd,cAAc;QACd,QAAQ;QACR,QAAQ;KACT;IACD,gBAAgB,EAAE,CAAC,gBAAgB,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACnF,cAAc,EAAE;QACd,OAAO;QACP,SAAS;QACT,cAAc;QACd,cAAc;QACd,QAAQ;QACR,QAAQ;KACT;IACD,KAAK,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACtE,YAAY,EAAE;QACZ,YAAY;QACZ,OAAO;QACP,cAAc;QACd,SAAS;QACT,QAAQ;QACR,QAAQ;KACT;IACD,YAAY,EAAE,CAAC,QAAQ,CAAC;IACxB,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,MAAM,UAAU,aAAa,CAC3B,IAAqB,EACrB,EAAmB;IAEnB,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAqB,EACrB,EAAmB;IAEnB,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAsB;IAC9D,OAAO,CACL,KAAK,KAAK,cAAc;QACxB,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,QAAQ,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,OAAO,CACL,KAAK,KAAK,YAAY;QACtB,KAAK,KAAK,aAAa;QACvB,KAAK,KAAK,kBAAkB;QAC5B,KAAK,KAAK,gBAAgB;QAC1B,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,cAAc,CACzB,CAAC;AACJ,CAAC"}

package/dist/internal/diagnostics.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Redaction-safe diagnostics (SECURITY.md): allowlisted fields only.
+ * Never accepts payloads, tokens, phone numbers, or authorization material.
+ */
+import type { ConnectionState } from './connection-state.js';
+/** @public */
+export type DiagnosticLevel = 'debug' | 'info' | 'warn' | 'error';
+/** @public */
+export type DiagnosticResult = 'ok' | 'error' | 'timeout' | 'aborted' | 'rejected';
+/**
+ * Allowlisted diagnostic event. Extra keys must never be attached by producers.
+ * @public
+ */
+export type DiagnosticEvent = {
+    readonly level: DiagnosticLevel;
+    readonly code: string;
+    readonly connectionState: ConnectionState;
+    readonly requestId?: string;
+    readonly commandType?: string;
+    readonly durationMs?: number;
+    readonly result?: DiagnosticResult;
+    readonly errorCode?: string;
+    readonly attempt?: number;
+};
+/** @public */
+export type DiagnosticsSink = {
+    readonly emit: (event: DiagnosticEvent) => void;
+};
+/** Recording sink for tests; still enforces the allowlist. @public */
+export declare function createRecordingDiagnosticsSink(): DiagnosticsSink & {
+    readonly events: readonly DiagnosticEvent[];
+    readonly clear: () => void;
+};
+export declare function assertRedactionSafeDiagnostic(event: DiagnosticEvent): void;
+export declare function diagnosticContainsForbiddenText(event: DiagnosticEvent, needles: readonly string[]): boolean;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/internal/diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,cAAc;AACd,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElE,cAAc;AACd,MAAM,MAAM,gBAAgB,GACxB,IAAI,GACJ,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,cAAc;AACd,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CACjD,CAAC;AAuBF,sEAAsE;AACtE,wBAAgB,8BAA8B,IAAI,eAAe,GAAG;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B,CAYA;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAO1E;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAGT"}

package/dist/internal/diagnostics.js

@@ -0,0 +1,51 @@
+/**
+ * Redaction-safe diagnostics (SECURITY.md): allowlisted fields only.
+ * Never accepts payloads, tokens, phone numbers, or authorization material.
+ */
+const FORBIDDEN_DIAGNOSTIC_KEYS = [
+    'payload',
+    'body',
+    'authorization',
+    'token',
+    'password',
+    'secret',
+    'privateKey',
+    'publicKey',
+    'clientPublicKey',
+    'signature',
+    'nonce',
+    'apiKey',
+    'ocpAuthToken',
+    'sipPassword',
+    'phone',
+    'destination',
+    'displayName',
+    'message'
+];
+/** Recording sink for tests; still enforces the allowlist. @public */
+export function createRecordingDiagnosticsSink() {
+    const events = [];
+    return {
+        events,
+        clear: () => {
+            events.length = 0;
+        },
+        emit: (event) => {
+            assertRedactionSafeDiagnostic(event);
+            events.push(Object.freeze({ ...event }));
+        }
+    };
+}
+export function assertRedactionSafeDiagnostic(event) {
+    const keys = Object.keys(event);
+    for (const key of keys) {
+        if (FORBIDDEN_DIAGNOSTIC_KEYS.includes(key)) {
+            throw new Error(`Forbidden diagnostic key: ${key}`);
+        }
+    }
+}
+export function diagnosticContainsForbiddenText(event, needles) {
+    const serialized = JSON.stringify(event);
+    return needles.some((needle) => serialized.includes(needle));
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/internal/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/internal/diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,MAAM,yBAAyB,GAAG;IAChC,SAAS;IACT,MAAM;IACN,eAAe;IACf,OAAO;IACP,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,WAAW;IACX,iBAAiB;IACjB,WAAW;IACX,OAAO;IACP,QAAQ;IACR,cAAc;IACd,aAAa;IACb,OAAO;IACP,aAAa;IACb,aAAa;IACb,SAAS;CACD,CAAC;AAEX,sEAAsE;AACtE,MAAM,UAAU,8BAA8B;IAI5C,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,OAAO;QACL,MAAM;QACN,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACd,6BAA6B,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAsB;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAK,yBAA+C,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAsB,EACtB,OAA0B;IAE1B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/internal/event-subscription.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Typed public event subscriptions with sequence-gap detection.
+ */
+import type { DiagnosticsSink } from './diagnostics.js';
+import type { ConnectionState } from './connection-state.js';
+import { type OmniCallEvent, type PublicEventType } from './public-event-map.js';
+import type { EventMessage } from '@softomnitel/omnicall-protocol';
+export type EventSubscriptionHub = {
+    readonly subscribe: <T extends PublicEventType>(type: T, listener: (event: Extract<OmniCallEvent, {
+        type: T;
+    }>) => void) => () => void;
+    readonly handleEvent: (message: EventMessage, connectionState: ConnectionState) => {
+        readonly gap: boolean;
+    };
+    readonly clearSequence: () => void;
+    readonly lastSequence: () => number | undefined;
+    readonly clearListeners: () => void;
+};
+export declare function createEventSubscriptionHub(deps: {
+    readonly diagnostics?: DiagnosticsSink;
+    readonly onSequenceGap: () => void;
+}): EventSubscriptionHub;
+//# sourceMappingURL=event-subscription.d.ts.map

package/dist/internal/event-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-subscription.d.ts","sourceRoot":"","sources":["../../src/internal/event-subscription.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAInE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,eAAe,EAC5C,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,KAC3D,MAAM,IAAI,CAAC;IAChB,QAAQ,CAAC,WAAW,EAAE,CACpB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,eAAe,KAC7B;QAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACpC,GAAG,oBAAoB,CAiEvB"}