@agatx/serenada-core 0.6.10

package/dist/signaling/SignalingEngine.d.ts

@@ -0,0 +1,126 @@
+import type { ReconnectOutcome, RoomState, SignalingMessage } from './types.js';
+import type { RoomStatuses } from './roomStatuses.js';
+import type { TransportKind } from './transports/types.js';
+import type { SerenadaLogger } from '../types.js';
+export interface SignalingEngineConfig {
+    wsUrl: string;
+    httpBaseUrl: string;
+    transports?: TransportKind[];
+    logger?: SerenadaLogger;
+}
+export type SignalingStateListener = () => void;
+export type SignalingMessageListener = (msg: SignalingMessage) => void;
+export declare class SignalingEngine {
+    isConnected: boolean;
+    activeTransport: TransportKind | null;
+    clientId: string | null;
+    roomState: RoomState | null;
+    turnToken: string | null;
+    turnTokenTTLMs: number | null;
+    error: {
+        code: string;
+        message: string;
+        reason?: string;
+    } | null;
+    roomStatuses: RoomStatuses;
+    /** Most-recent reconnect outcome reported by the server in `joined`. */
+    lastReconnectOutcome: ReconnectOutcome | null;
+    /**
+     * Highest room-state epoch observed so far. Advances monotonically (per
+     * room) on every membership change. Used by MediaEngine to gate ICE
+     * restart on an authoritative post-reconnect snapshot.
+     */
+    lastEpoch: number | null;
+    /** Epoch at the moment the transport was last observed disconnected. */
+    epochAtDisconnect: number | null;
+    /**
+     * Unix-ms timestamp of the first successful `joined` for the current
+     * session. Stable across reconnects so the persisted recovery record
+     * carries the original join time, not the latest reattach time.
+     */
+    private sessionStartTs;
+    /**
+     * True from disconnect until we've seen a fresh authoritative snapshot
+     * for the current room on the new transport. Consumers should suppress
+     * ICE restart while this flag is set.
+     */
+    awaitingPostReconnectSnapshot: boolean;
+    private wsUrl;
+    private httpBaseUrl;
+    private transportOrder;
+    private transport;
+    private transportIndex;
+    private transportConnectedOnce;
+    private transportId;
+    private currentRoomId;
+    private pendingJoin;
+    private lastClientId;
+    private needsRejoin;
+    private reconnectToken;
+    private reconnectTokenRoomId;
+    private lastPongAt;
+    private missedPongs;
+    private wsConsecutiveFailures;
+    private sseSid;
+    private joinAttemptId;
+    private joinAcked;
+    private joinKickstartTimer;
+    private joinRecoveryTimer;
+    private joinHardTimeout;
+    private turnRefreshTimer;
+    private pingInterval;
+    private reconnectTimeout;
+    private reconnectAttempts;
+    private closedByDestroy;
+    private connecting;
+    private lastCreateMaxParticipants;
+    private lastDisplayName;
+    private lastPeerId;
+    private logger?;
+    private messageListeners;
+    private stateListeners;
+    constructor(config: SignalingEngineConfig);
+    connect(): void;
+    destroy(): void;
+    sendMessage(type: string, payload?: Record<string, unknown>, to?: string): void;
+    joinRoom(roomId: string, options?: {
+        createMaxParticipants?: number;
+        displayName?: string;
+        peerId?: string;
+    }): void;
+    leaveRoom(options?: {
+        preserveReconnectState?: boolean;
+    }): void;
+    endRoom(): void;
+    watchRooms(rids: string[]): void;
+    clearError(): void;
+    subscribeToMessages(cb: SignalingMessageListener): () => void;
+    onStateChange(cb: SignalingStateListener): () => void;
+    get currentRoom(): string | null;
+    private handleIncomingMessage;
+    private doConnect;
+    private shouldFallback;
+    private tryNextTransport;
+    private scheduleReconnect;
+    private startPingInterval;
+    private turnRefreshGate;
+    private turnTokenExpiresAtMs;
+    setTurnRefreshGate(gate: (() => Promise<boolean>) | null): void;
+    private scheduleTurnRefresh;
+    private maybeSendTurnRefresh;
+    private clearJoinTimers;
+    private clearPingInterval;
+    private clearTurnRefreshTimer;
+    private clearReconnectTimeout;
+    private notifyStateChange;
+    private resetForTerminal;
+    private readonly storageKeyClientId;
+    private readonly storageKeyReconnectToken;
+    private readonly storageKeyReconnectTokenRoom;
+    private loadReconnectStorage;
+    private persistClientId;
+    private persistReconnectStorage;
+    private clearReconnectStorage;
+    private persistRecoveryRecord;
+}
+//# sourceMappingURL=SignalingEngine.d.ts.map

package/dist/signaling/SignalingEngine.d.ts.map

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