@agatx/serenada-core 0.6.10

package/dist/ConsoleLogger.d.ts

@@ -0,0 +1,6 @@
+import type { SerenadaLogLevel, SerenadaLogger } from './types.js';
+/** Default logger that writes to the browser console. Pass to {@link SerenadaConfig.logger} for debug output. */
+export declare class ConsoleSerenadaLogger implements SerenadaLogger {
+    log(level: SerenadaLogLevel, tag: string, message: string): void;
+}
+//# sourceMappingURL=ConsoleLogger.d.ts.map

package/dist/ConsoleLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.d.ts","sourceRoot":"","sources":["../src/ConsoleLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,iHAAiH;AACjH,qBAAa,qBAAsB,YAAW,cAAc;IACxD,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CASnE"}

package/dist/ConsoleLogger.js

@@ -0,0 +1,21 @@
+/** Default logger that writes to the browser console. Pass to {@link SerenadaConfig.logger} for debug output. */
+export class ConsoleSerenadaLogger {
+    log(level, tag, message) {
+        const formatted = `[${tag}] ${message}`;
+        switch (level) {
+            case 'debug':
+                console.debug(formatted);
+                break;
+            case 'info':
+                console.info(formatted);
+                break;
+            case 'warning':
+                console.warn(formatted);
+                break;
+            case 'error':
+                console.error(formatted);
+                break;
+        }
+    }
+}
+//# sourceMappingURL=ConsoleLogger.js.map

package/dist/ConsoleLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.js","sourceRoot":"","sources":["../src/ConsoleLogger.ts"],"names":[],"mappings":"AAEA,iHAAiH;AACjH,MAAM,OAAO,qBAAqB;IAC9B,GAAG,CAAC,KAAuB,EAAE,GAAW,EAAE,OAAe;QACrD,MAAM,SAAS,GAAG,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACxC,QAAQ,KAAK,EAAE,CAAC;YACZ,KAAK,OAAO;gBAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM;YAC9C,KAAK,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM;YAC5C,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM;YAC/C,KAAK,OAAO;gBAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM;QAClD,CAAC;IACL,CAAC;CACJ"}

package/dist/RoomWatcher.d.ts

@@ -0,0 +1,34 @@
+import type { RoomWatcherState, SerenadaConfig } from './types.js';
+import { SignalingEngine, type SignalingEngineConfig } from './signaling/SignalingEngine.js';
+import type { RoomStatuses } from './signaling/roomStatuses.js';
+type RoomWatcherListener = (state: RoomWatcherState) => void;
+interface RoomWatcherDependencies {
+    createSignalingEngine?: (config: SignalingEngineConfig) => SignalingEngine;
+}
+/**
+ * Monitors room occupancy via the signaling server.
+ * Use to show room status (e.g. "1 person waiting") before joining a call.
+ */
+export declare class RoomWatcher {
+    private readonly signaling;
+    private readonly unsubscribeStateChange;
+    private listeners;
+    private watchedRoomIds;
+    private hasConnected;
+    private stopped;
+    private wasConnected;
+    constructor(config: SerenadaConfig, dependencies?: RoomWatcherDependencies);
+    get isConnected(): boolean;
+    get activeTransport(): import("./index.js").TransportKind | null;
+    get currentStatuses(): RoomStatuses;
+    /** Subscribe to room status updates. Returns an unsubscribe function. */
+    subscribe(listener: RoomWatcherListener): () => void;
+    /** Start watching the given room IDs for occupancy changes. Replaces any previous watch list. */
+    watchRooms(roomIds: string[]): void;
+    /** Stop watching all rooms and release resources. */
+    stop(): void;
+    private notify;
+    private snapshot;
+}
+export {};
+//# sourceMappingURL=RoomWatcher.d.ts.map

package/dist/RoomWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoomWatcher.d.ts","sourceRoot":"","sources":["../src/RoomWatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE7D,UAAU,uBAAuB;IAC7B,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,eAAe,CAAC;CAC9E;AAED;;;GAGG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAa;IACpD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,cAAc,EAAE,YAAY,GAAE,uBAA4B;IAkB9E,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,eAAe,8CAElB;IAED,IAAI,eAAe,IAAI,YAAY,CAElC;IAED,yEAAyE;IACzE,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQpD,iGAAiG;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAwBnC,qDAAqD;IACrD,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,QAAQ;CAOnB"}

package/dist/RoomWatcher.js

@@ -0,0 +1,103 @@
+import { resolveServerUrls } from './serverUrls.js';
+import { SignalingEngine } from './signaling/SignalingEngine.js';
+import { requireServerHost } from './configValidation.js';
+/**
+ * Monitors room occupancy via the signaling server.
+ * Use to show room status (e.g. "1 person waiting") before joining a call.
+ */
+export class RoomWatcher {
+    signaling;
+    unsubscribeStateChange;
+    listeners = new Set();
+    watchedRoomIds = [];
+    hasConnected = false;
+    stopped = false;
+    wasConnected = false;
+    constructor(config, dependencies = {}) {
+        const serverHost = requireServerHost(config);
+        const urls = resolveServerUrls(serverHost);
+        this.signaling = (dependencies.createSignalingEngine ?? ((engineConfig) => new SignalingEngine(engineConfig)))({
+            wsUrl: urls.wsUrl,
+            httpBaseUrl: urls.httpBaseUrl,
+            transports: config.transports,
+        });
+        this.unsubscribeStateChange = this.signaling.onStateChange(() => {
+            const nowConnected = this.signaling.isConnected;
+            if (nowConnected && !this.wasConnected && this.watchedRoomIds.length > 0) {
+                this.signaling.watchRooms(this.watchedRoomIds);
+            }
+            this.wasConnected = nowConnected;
+            this.notify();
+        });
+    }
+    get isConnected() {
+        return !this.stopped && this.signaling.isConnected;
+    }
+    get activeTransport() {
+        return this.stopped ? null : this.signaling.activeTransport;
+    }
+    get currentStatuses() {
+        return filterRoomStatuses(this.signaling.roomStatuses, this.watchedRoomIds);
+    }
+    /** Subscribe to room status updates. Returns an unsubscribe function. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.snapshot());
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** Start watching the given room IDs for occupancy changes. Replaces any previous watch list. */
+    watchRooms(roomIds) {
+        if (this.stopped)
+            return;
+        this.watchedRoomIds = Array.from(new Set(roomIds.filter((roomId) => typeof roomId === 'string' && roomId.length > 0)));
+        this.notify();
+        if (this.watchedRoomIds.length === 0) {
+            if (this.hasConnected && this.signaling.isConnected) {
+                this.signaling.watchRooms([]);
+            }
+            return;
+        }
+        if (!this.hasConnected) {
+            this.hasConnected = true;
+            this.signaling.connect();
+            return;
+        }
+        if (this.signaling.isConnected) {
+            this.signaling.watchRooms(this.watchedRoomIds);
+        }
+    }
+    /** Stop watching all rooms and release resources. */
+    stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        this.watchedRoomIds = [];
+        this.unsubscribeStateChange();
+        this.signaling.destroy();
+        this.notify();
+        this.listeners.clear();
+    }
+    notify() {
+        const state = this.snapshot();
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+    snapshot() {
+        return {
+            isConnected: this.isConnected,
+            activeTransport: this.activeTransport,
+            roomStatuses: this.currentStatuses,
+        };
+    }
+}
+function filterRoomStatuses(roomStatuses, watchedRoomIds) {
+    if (watchedRoomIds.length === 0) {
+        return {};
+    }
+    const watched = new Set(watchedRoomIds);
+    return Object.fromEntries(Object.entries(roomStatuses).filter(([roomId]) => watched.has(roomId)));
+}
+//# sourceMappingURL=RoomWatcher.js.map

package/dist/RoomWatcher.js.map

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

package/dist/SerenadaCore.d.ts

@@ -0,0 +1,47 @@
+import type { SerenadaConfig, CreateRoomResult, SerenadaSessionHandle } from './types.js';
+import { type RecoveryRecord } from './recoveryStorage.js';
+/**
+ * Main entry point for the Serenada SDK.
+ * Create an instance with a {@link SerenadaConfig}, then use {@link join} or
+ * {@link createRoom} to start a call.
+ */
+export declare class SerenadaCore {
+    private readonly config;
+    private readonly resolvedConfig;
+    constructor(config: SerenadaConfig);
+    /** Check if the current browser supports WebRTC calling. */
+    static isSupported(): boolean;
+    /**
+     * Returns a recoverable session if the previous tab/page session ended
+     * abruptly (reload, OS-level crash) while a call was active and the
+     * persisted reconnect token is still within its TTL. Host apps should
+     * call this on launch and surface a "Rejoin call?" prompt — calling
+     * {@link join} with the returned `roomId` reattaches under the same CID.
+     *
+     * Returns `null` when there is nothing to recover.
+     */
+    static getRecoverableSession(): RecoveryRecord | null;
+    /**
+     * Drops any persisted recovery record. Host apps call this when the
+     * user explicitly declines to rejoin, so subsequent launches do not
+     * keep prompting for the same dead session.
+     */
+    static discardRecoverableSession(): void;
+    /** Join an existing call by URL. Returns a session handle. */
+    join(url: string, options?: {
+        displayName?: string;
+        peerId?: string;
+    }): SerenadaSessionHandle;
+    /** Join an existing call by room ID. Returns a session handle. */
+    join(options: {
+        roomId: string;
+        displayName?: string;
+        peerId?: string;
+    }): SerenadaSessionHandle;
+    /** Create a new room. Returns the room URL and ID. Call {@link join} to start the call. */
+    createRoom(): Promise<CreateRoomResult>;
+    private createUnsupportedSession;
+    private createSignalingProvider;
+    private parseRoomIdFromUrl;
+}
+//# sourceMappingURL=SerenadaCore.d.ts.map

package/dist/SerenadaCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerenadaCore.d.ts","sourceRoot":"","sources":["../src/SerenadaCore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAa,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQrG,OAAO,EAGH,KAAK,cAAc,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,MAAM,EAAE,cAAc;IAKlC,4DAA4D;IAC5D,MAAM,CAAC,WAAW,IAAI,OAAO;IAI7B;;;;;;;;OAQG;IACH,MAAM,CAAC,qBAAqB,IAAI,cAAc,GAAG,IAAI;IAIrD;;;;OAIG;IACH,MAAM,CAAC,yBAAyB,IAAI,IAAI;IAIxC,8DAA8D;IAC9D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,qBAAqB;IAC7F,kEAAkE;IAClE,IAAI,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,qBAAqB;IAyB/F,2FAA2F;IACrF,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAO7C,OAAO,CAAC,wBAAwB;IA8ChC,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,kBAAkB;CAc7B"}

package/dist/SerenadaCore.js

@@ -0,0 +1,141 @@
+import { SerenadaSession } from './SerenadaSession.js';
+import { createRoomId } from './api/roomApi.js';
+import { buildRoomUrl } from './serverUrls.js';
+import { requireServerHost, resolveSerenadaConfig } from './configValidation.js';
+import { SerenadaServerProvider } from './SerenadaServerProvider.js';
+import { clearRecoveryRecord, loadRecoveryRecord, } from './recoveryStorage.js';
+/**
+ * Main entry point for the Serenada SDK.
+ * Create an instance with a {@link SerenadaConfig}, then use {@link join} or
+ * {@link createRoom} to start a call.
+ */
+export class SerenadaCore {
+    config;
+    resolvedConfig;
+    constructor(config) {
+        this.config = config;
+        this.resolvedConfig = resolveSerenadaConfig(config);
+    }
+    /** Check if the current browser supports WebRTC calling. */
+    static isSupported() {
+        return typeof RTCPeerConnection !== 'undefined';
+    }
+    /**
+     * Returns a recoverable session if the previous tab/page session ended
+     * abruptly (reload, OS-level crash) while a call was active and the
+     * persisted reconnect token is still within its TTL. Host apps should
+     * call this on launch and surface a "Rejoin call?" prompt — calling
+     * {@link join} with the returned `roomId` reattaches under the same CID.
+     *
+     * Returns `null` when there is nothing to recover.
+     */
+    static getRecoverableSession() {
+        return loadRecoveryRecord();
+    }
+    /**
+     * Drops any persisted recovery record. Host apps call this when the
+     * user explicitly declines to rejoin, so subsequent launches do not
+     * keep prompting for the same dead session.
+     */
+    static discardRecoverableSession() {
+        clearRecoveryRecord();
+    }
+    join(urlOrOptions, extraOptions) {
+        if (!SerenadaCore.isSupported()) {
+            return this.createUnsupportedSession();
+        }
+        const signalingProvider = this.createSignalingProvider();
+        if (typeof urlOrOptions === 'string') {
+            const roomId = this.parseRoomIdFromUrl(urlOrOptions);
+            return new SerenadaSession(this.config, roomId, urlOrOptions, signalingProvider, {
+                displayName: extraOptions?.displayName,
+                peerId: extraOptions?.peerId,
+            });
+        }
+        const roomUrl = this.resolvedConfig.serverHost
+            ? buildRoomUrl(this.resolvedConfig.serverHost, urlOrOptions.roomId)
+            : null;
+        return new SerenadaSession(this.config, urlOrOptions.roomId, roomUrl, signalingProvider, {
+            displayName: urlOrOptions.displayName,
+            peerId: urlOrOptions.peerId,
+        });
+    }
+    /** Create a new room. Returns the room URL and ID. Call {@link join} to start the call. */
+    async createRoom() {
+        const serverHost = requireServerHost(this.config);
+        const roomId = await createRoomId(serverHost);
+        const url = buildRoomUrl(serverHost, roomId);
+        return { url, roomId };
+    }
+    createUnsupportedSession() {
+        const errorState = {
+            phase: 'error',
+            roomId: null,
+            roomUrl: null,
+            localParticipant: null,
+            remoteParticipants: [],
+            connectionStatus: 'connected',
+            signalingState: { kind: 'failed', reason: 'webrtcUnavailable' },
+            activeTransport: null,
+            requiredPermissions: null,
+            error: { code: 'webrtcUnavailable', message: 'WebRTC is not supported in this browser' },
+        };
+        const noop = () => { };
+        const noopAsync = async () => { };
+        const emptyMap = new Map();
+        return {
+            get state() { return errorState; },
+            subscribe(_cb) { return noop; },
+            onPeerMessage(_cb) { return noop; },
+            leave: noop,
+            end: noop,
+            toggleAudio: noop,
+            toggleVideo: noop,
+            flipCamera: noopAsync,
+            setAudioEnabled: noop,
+            setVideoEnabled: noop,
+            setCameraMode: noop,
+            startScreenShare: noopAsync,
+            stopScreenShare: noopAsync,
+            resumeJoin: noopAsync,
+            cancelJoin: noop,
+            destroy: noop,
+            get localStream() { return null; },
+            get remoteStreams() { return emptyMap; },
+            get callStats() { return null; },
+            get hasMultipleCameras() { return false; },
+            get canScreenShare() { return false; },
+            get isSignalingConnected() { return false; },
+            get iceConnectionState() { return 'closed'; },
+            get peerConnectionState() { return 'closed'; },
+            get rtcSignalingState() { return 'closed'; },
+            onPermissionsRequired: null,
+        };
+    }
+    createSignalingProvider() {
+        if (this.resolvedConfig.serverHost) {
+            return new SerenadaServerProvider({
+                serverHost: this.resolvedConfig.serverHost,
+                transports: this.config.transports,
+                logger: this.config.logger,
+            });
+        }
+        return this.resolvedConfig.signalingProvider;
+    }
+    parseRoomIdFromUrl(url) {
+        try {
+            const parsed = new URL(url);
+            const parts = parsed.pathname.split('/');
+            const callIndex = parts.indexOf('call');
+            if (callIndex !== -1 && parts[callIndex + 1]) {
+                return parts[callIndex + 1];
+            }
+            // Fallback: last path segment
+            return parts[parts.length - 1] || url;
+        }
+        catch {
+            return url;
+        }
+    }
+}
+//# sourceMappingURL=SerenadaCore.js.map

package/dist/SerenadaCore.js.map

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

package/dist/SerenadaDiagnostics.d.ts

@@ -0,0 +1,49 @@
+import type { SerenadaConfig, DiagnosticsReport, DiagnosticCheckResult, ConnectivityReport, IceProbeReport } from './types.js';
+/**
+ * Pre-flight diagnostics utility. Checks device capabilities (camera, mic, speaker)
+ * and server connectivity (signaling, TURN) before joining a call.
+ */
+export declare class SerenadaDiagnostics {
+    private readonly resolvedConfig;
+    constructor(config: SerenadaConfig);
+    /** Run all diagnostic checks and return a full report. */
+    runAll(): Promise<DiagnosticsReport>;
+    /** Test server connectivity: room API, WebSocket, SSE, and TURN credentials. */
+    runConnectivityChecks(): Promise<ConnectivityReport>;
+    /** Probe ICE connectivity using the active server or provider ICE source. */
+    runTurnProbe(turnsOnly: boolean, onCandidateLog?: (candidate: string) => void): Promise<IceProbeReport>;
+    /** Probe ICE connectivity (STUN/TURN) by gathering candidates with a real peer connection. */
+    runIceProbe(turnsOnly: boolean, onCandidateLog?: (candidate: string) => void): Promise<IceProbeReport>;
+    /** Validate that a server host is reachable by requesting a room ID. */
+    validateServerHost(host?: string): Promise<void>;
+    /** Check if a camera is available and authorized. */
+    checkCamera(): Promise<DiagnosticCheckResult>;
+    /** Check if a microphone is available and authorized. */
+    checkMicrophone(): Promise<DiagnosticCheckResult>;
+    /** Check if a speaker/audio output device is available. */
+    checkSpeaker(): Promise<DiagnosticCheckResult>;
+    /** Check if the browser reports network connectivity. */
+    checkNetwork(): Promise<DiagnosticCheckResult>;
+    /** Check if the signaling server is reachable. */
+    checkSignaling(): Promise<DiagnosticCheckResult & {
+        transport?: string;
+    }>;
+    /** Check if the TURN relay endpoint is reachable. */
+    checkTurn(): Promise<DiagnosticCheckResult & {
+        latencyMs?: number;
+    }>;
+    private checkMediaCapability;
+    private checkDeviceAvailability;
+    private enumerateDevices;
+    private runTimedCheck;
+    private createRoomId;
+    private fetchDiagnosticToken;
+    private fetchTurnCredentials;
+    private testWebSocket;
+    private testSse;
+    private gatherIceCandidates;
+    private resolveIceServers;
+    private fetchJson;
+    private fetchResponse;
+}
+//# sourceMappingURL=SerenadaDiagnostics.d.ts.map

package/dist/SerenadaDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerenadaDiagnostics.d.ts","sourceRoot":"","sources":["../src/SerenadaDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EAErB,kBAAkB,EAClB,cAAc,EACjB,MAAM,YAAY,CAAC;AAqBpB;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,MAAM,EAAE,cAAc;IAIlC,0DAA0D;IACpD,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAoB1C,gFAAgF;IAC1E,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA4B1D,6EAA6E;IACvE,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAS7G,8FAA8F;IACxF,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5G,wEAAwE;IAClE,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetD,qDAAqD;IAC/C,WAAW,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAKnD,yDAAyD;IACnD,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAKvD,2DAA2D;IACrD,YAAY,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAKpD,yDAAyD;IACnD,YAAY,IAAI,OAAO,CAAC,qBAAqB,CAAC;IASpD,kDAAkD;IAC5C,cAAc,IAAI,OAAO,CAAC,qBAAqB,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB/E,qDAAqD;IAC/C,SAAS,IAAI,OAAO,CAAC,qBAAqB,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA6B1E,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,uBAAuB;YAUjB,gBAAgB;YAShB,aAAa;YAUb,YAAY;YAaZ,oBAAoB;YAcpB,oBAAoB;YAsBpB,aAAa;YAgCb,OAAO;YA8CP,mBAAmB;YAgFnB,iBAAiB;YAajB,SAAS;YAQT,aAAa;CAY9B"}