@livepeer-frameworks/player-core 0.1.1 → 0.1.2

package/dist/esm/core/StreamStateClient.js

@@ -0,0 +1,379 @@
+import { TypedEventEmitter } from './EventEmitter.js';
+import { TimerManager } from './TimerManager.js';
+
+/**
+ * StreamStateClient.ts
+ *
+ * Framework-agnostic client for polling MistServer stream status via WebSocket or HTTP.
+ * Extracted from useStreamState.ts for use in headless core.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_POLL_INTERVAL = 3000;
+const initialState = {
+    status: "OFFLINE",
+    isOnline: false,
+    message: "Connecting...",
+    lastUpdate: 0,
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Parse MistServer error string into StreamStatus enum.
+ */
+function parseErrorToStatus(error) {
+    const lowerError = error.toLowerCase();
+    if (lowerError.includes("offline"))
+        return "OFFLINE";
+    if (lowerError.includes("initializing"))
+        return "INITIALIZING";
+    if (lowerError.includes("booting"))
+        return "BOOTING";
+    if (lowerError.includes("waiting for data"))
+        return "WAITING_FOR_DATA";
+    if (lowerError.includes("shutting down"))
+        return "SHUTTING_DOWN";
+    if (lowerError.includes("invalid"))
+        return "INVALID";
+    return "ERROR";
+}
+/**
+ * Get human-readable message for stream status.
+ */
+function getStatusMessage(status, percentage) {
+    switch (status) {
+        case "ONLINE":
+            return "Stream is online";
+        case "OFFLINE":
+            return "Stream is offline";
+        case "INITIALIZING":
+            return percentage !== undefined
+                ? `Initializing... ${Math.round(percentage * 10) / 10}%`
+                : "Stream is initializing";
+        case "BOOTING":
+            return "Stream is starting up";
+        case "WAITING_FOR_DATA":
+            return "Waiting for stream data";
+        case "SHUTTING_DOWN":
+            return "Stream is shutting down";
+        case "INVALID":
+            return "Stream status is invalid";
+        case "ERROR":
+        default:
+            return "Stream error";
+    }
+}
+// ============================================================================
+// StreamStateClient Class
+// ============================================================================
+/**
+ * Client for polling MistServer stream status via WebSocket or HTTP.
+ *
+ * @example
+ * ```typescript
+ * const client = new StreamStateClient({
+ *   mistBaseUrl: 'https://mist.example.com',
+ *   streamName: 'pk_...', // playbackId (view key)
+ * });
+ *
+ * client.on('stateChange', ({ state }) => console.log('State:', state));
+ * client.on('online', () => console.log('Stream is online!'));
+ * client.on('offline', () => console.log('Stream is offline'));
+ *
+ * client.start();
+ * // ...later
+ * client.stop();
+ * ```
+ */
+class StreamStateClient extends TypedEventEmitter {
+    constructor(config) {
+        super();
+        this.state = { ...initialState };
+        this.ws = null;
+        this.timers = new TimerManager();
+        this.isRunning = false;
+        this.wasOnline = false;
+        this.connectionId = 0; // Track connection attempts to prevent stale callbacks
+        this.config = {
+            pollInterval: DEFAULT_POLL_INTERVAL,
+            useWebSocket: true,
+            ...config,
+        };
+    }
+    /**
+     * Start polling/WebSocket connection.
+     * Always does initial HTTP poll to get full stream info (including sources),
+     * then connects WebSocket for real-time status updates.
+     *
+     * Debounced to prevent orphaned connections during rapid mount/unmount cycles.
+     */
+    start() {
+        if (this.isRunning)
+            return;
+        this.isRunning = true;
+        const { mistBaseUrl, streamName, useWebSocket } = this.config;
+        if (!mistBaseUrl || !streamName) {
+            console.warn("[StreamStateClient] Missing mistBaseUrl or streamName");
+            return;
+        }
+        // Reset state
+        this.setState({
+            ...initialState,
+            message: "Connecting...",
+            lastUpdate: Date.now(),
+        });
+        // Increment connection ID to invalidate any pending callbacks from previous attempts
+        const currentConnectionId = ++this.connectionId;
+        // Debounce connection to prevent rapid reconnects during mount/unmount cycles
+        this.timers.start(() => {
+            // Check if this connection attempt is still valid
+            if (!this.isRunning || this.connectionId !== currentConnectionId) {
+                return;
+            }
+            // Always do initial HTTP poll to get full data (including sources)
+            // Then connect WebSocket for real-time updates
+            this.pollHttp().then(() => {
+                // Verify still valid before WebSocket connection
+                if (useWebSocket && this.isRunning && this.connectionId === currentConnectionId) {
+                    this.connectWebSocket();
+                }
+            });
+        }, StreamStateClient.CONNECTION_DEBOUNCE_MS, "connect");
+    }
+    /**
+     * Stop polling and close connections.
+     */
+    stop() {
+        this.isRunning = false;
+        // Close WebSocket
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        // Clear all timers
+        this.timers.destroy();
+    }
+    /**
+     * Manual refresh - trigger an immediate poll.
+     */
+    refresh() {
+        if (this.config.useWebSocket && this.ws?.readyState === WebSocket.OPEN) {
+            // WebSocket will receive updates automatically
+            return;
+        }
+        this.pollHttp();
+    }
+    /**
+     * Get the underlying WebSocket connection (for MistReporter integration).
+     * Returns null if WebSocket is not connected.
+     */
+    getSocket() {
+        return this.ws;
+    }
+    /**
+     * Check if the WebSocket is connected and ready.
+     */
+    isSocketReady() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    /**
+     * Get current stream state.
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Check if stream is online.
+     */
+    isOnline() {
+        return this.state.isOnline;
+    }
+    /**
+     * Update configuration (stops and restarts if running).
+     */
+    updateConfig(config) {
+        const wasRunning = this.isRunning;
+        this.stop();
+        this.config = { ...this.config, ...config };
+        if (wasRunning) {
+            this.start();
+        }
+    }
+    /**
+     * Clean up resources.
+     */
+    destroy() {
+        this.stop();
+        this.removeAllListeners();
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    connectWebSocket() {
+        if (!this.isRunning)
+            return;
+        const { mistBaseUrl, streamName } = this.config;
+        // Clean up existing connection
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        try {
+            // Convert http(s) to ws(s)
+            const wsUrl = mistBaseUrl
+                .replace(/^http:/, "ws:")
+                .replace(/^https:/, "wss:")
+                .replace(/\/$/, "");
+            const ws = new WebSocket(`${wsUrl}/json_${encodeURIComponent(streamName)}.js?metaeverywhere=1&inclzero=1`);
+            this.ws = ws;
+            ws.onopen = () => {
+                console.debug("[StreamStateClient] WebSocket connected");
+            };
+            ws.onmessage = (event) => {
+                try {
+                    const data = JSON.parse(event.data);
+                    this.processStreamInfo(data);
+                }
+                catch (e) {
+                    console.warn("[StreamStateClient] Failed to parse WebSocket message:", e);
+                }
+            };
+            ws.onerror = () => {
+                console.warn("[StreamStateClient] WebSocket error, falling back to HTTP polling");
+                ws.close();
+            };
+            ws.onclose = () => {
+                this.ws = null;
+                if (!this.isRunning)
+                    return;
+                // Disable WebSocket and switch to HTTP polling
+                // This ensures pollHttp() schedules repeat polls (see line 365 condition)
+                this.config.useWebSocket = false;
+                console.debug("[StreamStateClient] WebSocket closed, switching to HTTP polling");
+                this.pollHttp();
+            };
+        }
+        catch (error) {
+            console.warn("[StreamStateClient] WebSocket connection failed:", error);
+            // Disable WebSocket and switch to HTTP polling
+            this.config.useWebSocket = false;
+            this.pollHttp();
+        }
+    }
+    async pollHttp() {
+        if (!this.isRunning)
+            return;
+        const { mistBaseUrl, streamName, pollInterval } = this.config;
+        try {
+            const url = `${mistBaseUrl.replace(/\/$/, "")}/json_${encodeURIComponent(streamName)}.js?metaeverywhere=1&inclzero=1`;
+            const response = await fetch(url, {
+                method: "GET",
+                headers: { Accept: "application/json" },
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            // MistServer returns JSON with potential JSONP wrapper
+            let text = await response.text();
+            // Strip JSONP callback if present
+            const jsonpMatch = text.match(/^[^(]+\(([\s\S]*)\);?$/);
+            if (jsonpMatch) {
+                text = jsonpMatch[1];
+            }
+            const data = JSON.parse(text);
+            this.processStreamInfo(data);
+        }
+        catch (error) {
+            if (!this.isRunning)
+                return;
+            const errorMessage = error instanceof Error ? error.message : "Connection failed";
+            this.setState({
+                ...this.state,
+                status: "ERROR",
+                isOnline: false,
+                message: errorMessage,
+                lastUpdate: Date.now(),
+                error: errorMessage,
+            });
+            this.emit("error", { error: errorMessage });
+        }
+        // Schedule next poll
+        if (this.isRunning && !this.config.useWebSocket) {
+            this.timers.start(() => this.pollHttp(), pollInterval, "poll");
+        }
+    }
+    processStreamInfo(data) {
+        if (!this.isRunning)
+            return;
+        let newState;
+        if (data.error) {
+            // Stream has an error state - preserve existing streamInfo
+            const status = parseErrorToStatus(data.error);
+            const message = data.on_error || getStatusMessage(status, data.perc);
+            newState = {
+                status,
+                isOnline: false,
+                message,
+                percentage: data.perc,
+                lastUpdate: Date.now(),
+                error: data.error,
+                streamInfo: this.state.streamInfo, // Preserve existing source/tracks
+            };
+        }
+        else {
+            // Stream is online with valid metadata
+            // Merge new data with existing streamInfo to preserve source/tracks from initial fetch
+            // WebSocket updates may not include source array
+            const mergedStreamInfo = {
+                ...this.state.streamInfo, // Keep existing source/meta if present
+                ...data, // Override with new data
+                // Explicitly preserve source if not in new data
+                source: data.source || this.state.streamInfo?.source,
+                // Merge meta to preserve tracks
+                meta: {
+                    ...this.state.streamInfo?.meta,
+                    ...data.meta,
+                    // Preserve tracks if not in new data
+                    tracks: data.meta?.tracks || this.state.streamInfo?.meta?.tracks,
+                },
+            };
+            newState = {
+                status: "ONLINE",
+                isOnline: true,
+                message: "Stream is online",
+                lastUpdate: Date.now(),
+                streamInfo: mergedStreamInfo,
+            };
+        }
+        this.setState(newState);
+        // Emit online/offline events on state transitions
+        if (newState.isOnline && !this.wasOnline) {
+            this.emit("online", undefined);
+        }
+        else if (!newState.isOnline && this.wasOnline) {
+            this.emit("offline", undefined);
+        }
+        this.wasOnline = newState.isOnline;
+    }
+    setState(state) {
+        const prevState = this.state;
+        this.state = state;
+        // Emit if ANY state field changed - including streamInfo (track data)
+        // Previously only checked status/isOnline/message, causing track updates to be lost
+        const hasChanged = prevState.status !== state.status ||
+            prevState.isOnline !== state.isOnline ||
+            prevState.message !== state.message ||
+            prevState.streamInfo !== state.streamInfo ||
+            prevState.lastUpdate !== state.lastUpdate;
+        if (hasChanged) {
+            this.emit("stateChange", { state });
+        }
+    }
+}
+// Debounce time for rapid mount/unmount cycles (ms)
+StreamStateClient.CONNECTION_DEBOUNCE_MS = 100;
+
+export { StreamStateClient };
+//# sourceMappingURL=StreamStateClient.js.map

package/dist/esm/core/StreamStateClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamStateClient.js","sources":["../../../../src/core/StreamStateClient.ts"],"sourcesContent":["/**\n * StreamStateClient.ts\n *\n * Framework-agnostic client for polling MistServer stream status via WebSocket or HTTP.\n * Extracted from useStreamState.ts for use in headless core.\n */\n\nimport { TypedEventEmitter } from \"./EventEmitter\";\nimport { TimerManager } from \"./TimerManager\";\nimport type { StreamState, StreamStatus, MistStreamInfo } from \"../types\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface StreamStateClientConfig {\n  /** MistServer base URL (e.g., https://mist.example.com) */\n  mistBaseUrl: string;\n  /** Stream name to poll */\n  streamName: string;\n  /** Poll interval in ms for HTTP fallback (default: 3000) */\n  pollInterval?: number;\n  /** Use WebSocket if available (default: true) */\n  useWebSocket?: boolean;\n}\n\ntype StreamStateClientResolvedConfig = Omit<\n  StreamStateClientConfig,\n  \"pollInterval\" | \"useWebSocket\"\n> & {\n  pollInterval: number;\n  useWebSocket: boolean;\n};\n\nexport interface StreamStateClientEvents {\n  /** Emitted when stream state changes */\n  stateChange: { state: StreamState };\n  /** Emitted when stream comes online */\n  online: void;\n  /** Emitted when stream goes offline */\n  offline: void;\n  /** Emitted on connection error */\n  error: { error: string };\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst DEFAULT_POLL_INTERVAL = 3000;\n\nconst initialState: StreamState = {\n  status: \"OFFLINE\",\n  isOnline: false,\n  message: \"Connecting...\",\n  lastUpdate: 0,\n};\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Parse MistServer error string into StreamStatus enum.\n */\nfunction parseErrorToStatus(error: string): StreamStatus {\n  const lowerError = error.toLowerCase();\n\n  if (lowerError.includes(\"offline\")) return \"OFFLINE\";\n  if (lowerError.includes(\"initializing\")) return \"INITIALIZING\";\n  if (lowerError.includes(\"booting\")) return \"BOOTING\";\n  if (lowerError.includes(\"waiting for data\")) return \"WAITING_FOR_DATA\";\n  if (lowerError.includes(\"shutting down\")) return \"SHUTTING_DOWN\";\n  if (lowerError.includes(\"invalid\")) return \"INVALID\";\n\n  return \"ERROR\";\n}\n\n/**\n * Get human-readable message for stream status.\n */\nfunction getStatusMessage(status: StreamStatus, percentage?: number): string {\n  switch (status) {\n    case \"ONLINE\":\n      return \"Stream is online\";\n    case \"OFFLINE\":\n      return \"Stream is offline\";\n    case \"INITIALIZING\":\n      return percentage !== undefined\n        ? `Initializing... ${Math.round(percentage * 10) / 10}%`\n        : \"Stream is initializing\";\n    case \"BOOTING\":\n      return \"Stream is starting up\";\n    case \"WAITING_FOR_DATA\":\n      return \"Waiting for stream data\";\n    case \"SHUTTING_DOWN\":\n      return \"Stream is shutting down\";\n    case \"INVALID\":\n      return \"Stream status is invalid\";\n    case \"ERROR\":\n    default:\n      return \"Stream error\";\n  }\n}\n\n// ============================================================================\n// StreamStateClient Class\n// ============================================================================\n\n/**\n * Client for polling MistServer stream status via WebSocket or HTTP.\n *\n * @example\n * ```typescript\n * const client = new StreamStateClient({\n *   mistBaseUrl: 'https://mist.example.com',\n *   streamName: 'pk_...', // playbackId (view key)\n * });\n *\n * client.on('stateChange', ({ state }) => console.log('State:', state));\n * client.on('online', () => console.log('Stream is online!'));\n * client.on('offline', () => console.log('Stream is offline'));\n *\n * client.start();\n * // ...later\n * client.stop();\n * ```\n */\nexport class StreamStateClient extends TypedEventEmitter<StreamStateClientEvents> {\n  private config: StreamStateClientResolvedConfig;\n  private state: StreamState = { ...initialState };\n  private ws: WebSocket | null = null;\n  private timers = new TimerManager();\n  private isRunning: boolean = false;\n  private wasOnline: boolean = false;\n  private connectionId: number = 0; // Track connection attempts to prevent stale callbacks\n\n  // Debounce time for rapid mount/unmount cycles (ms)\n  private static readonly CONNECTION_DEBOUNCE_MS = 100;\n\n  constructor(config: StreamStateClientConfig) {\n    super();\n    this.config = {\n      pollInterval: DEFAULT_POLL_INTERVAL,\n      useWebSocket: true,\n      ...config,\n    };\n  }\n\n  /**\n   * Start polling/WebSocket connection.\n   * Always does initial HTTP poll to get full stream info (including sources),\n   * then connects WebSocket for real-time status updates.\n   *\n   * Debounced to prevent orphaned connections during rapid mount/unmount cycles.\n   */\n  start(): void {\n    if (this.isRunning) return;\n    this.isRunning = true;\n\n    const { mistBaseUrl, streamName, useWebSocket } = this.config;\n\n    if (!mistBaseUrl || !streamName) {\n      console.warn(\"[StreamStateClient] Missing mistBaseUrl or streamName\");\n      return;\n    }\n\n    // Reset state\n    this.setState({\n      ...initialState,\n      message: \"Connecting...\",\n      lastUpdate: Date.now(),\n    });\n\n    // Increment connection ID to invalidate any pending callbacks from previous attempts\n    const currentConnectionId = ++this.connectionId;\n\n    // Debounce connection to prevent rapid reconnects during mount/unmount cycles\n    this.timers.start(\n      () => {\n        // Check if this connection attempt is still valid\n        if (!this.isRunning || this.connectionId !== currentConnectionId) {\n          return;\n        }\n\n        // Always do initial HTTP poll to get full data (including sources)\n        // Then connect WebSocket for real-time updates\n        this.pollHttp().then(() => {\n          // Verify still valid before WebSocket connection\n          if (useWebSocket && this.isRunning && this.connectionId === currentConnectionId) {\n            this.connectWebSocket();\n          }\n        });\n      },\n      StreamStateClient.CONNECTION_DEBOUNCE_MS,\n      \"connect\"\n    );\n  }\n\n  /**\n   * Stop polling and close connections.\n   */\n  stop(): void {\n    this.isRunning = false;\n\n    // Close WebSocket\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n\n    // Clear all timers\n    this.timers.destroy();\n  }\n\n  /**\n   * Manual refresh - trigger an immediate poll.\n   */\n  refresh(): void {\n    if (this.config.useWebSocket && this.ws?.readyState === WebSocket.OPEN) {\n      // WebSocket will receive updates automatically\n      return;\n    }\n    this.pollHttp();\n  }\n\n  /**\n   * Get the underlying WebSocket connection (for MistReporter integration).\n   * Returns null if WebSocket is not connected.\n   */\n  getSocket(): WebSocket | null {\n    return this.ws;\n  }\n\n  /**\n   * Check if the WebSocket is connected and ready.\n   */\n  isSocketReady(): boolean {\n    return this.ws?.readyState === WebSocket.OPEN;\n  }\n\n  /**\n   * Get current stream state.\n   */\n  getState(): StreamState {\n    return { ...this.state };\n  }\n\n  /**\n   * Check if stream is online.\n   */\n  isOnline(): boolean {\n    return this.state.isOnline;\n  }\n\n  /**\n   * Update configuration (stops and restarts if running).\n   */\n  updateConfig(config: Partial<StreamStateClientConfig>): void {\n    const wasRunning = this.isRunning;\n    this.stop();\n    this.config = { ...this.config, ...config };\n    if (wasRunning) {\n      this.start();\n    }\n  }\n\n  /**\n   * Clean up resources.\n   */\n  destroy(): void {\n    this.stop();\n    this.removeAllListeners();\n  }\n\n  // ============================================================================\n  // Private Methods\n  // ============================================================================\n\n  private connectWebSocket(): void {\n    if (!this.isRunning) return;\n\n    const { mistBaseUrl, streamName } = this.config;\n\n    // Clean up existing connection\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n\n    try {\n      // Convert http(s) to ws(s)\n      const wsUrl = mistBaseUrl\n        .replace(/^http:/, \"ws:\")\n        .replace(/^https:/, \"wss:\")\n        .replace(/\\/$/, \"\");\n\n      const ws = new WebSocket(\n        `${wsUrl}/json_${encodeURIComponent(streamName)}.js?metaeverywhere=1&inclzero=1`\n      );\n      this.ws = ws;\n\n      ws.onopen = () => {\n        console.debug(\"[StreamStateClient] WebSocket connected\");\n      };\n\n      ws.onmessage = (event) => {\n        try {\n          const data = JSON.parse(event.data) as MistStreamInfo;\n          this.processStreamInfo(data);\n        } catch (e) {\n          console.warn(\"[StreamStateClient] Failed to parse WebSocket message:\", e);\n        }\n      };\n\n      ws.onerror = () => {\n        console.warn(\"[StreamStateClient] WebSocket error, falling back to HTTP polling\");\n        ws.close();\n      };\n\n      ws.onclose = () => {\n        this.ws = null;\n\n        if (!this.isRunning) return;\n\n        // Disable WebSocket and switch to HTTP polling\n        // This ensures pollHttp() schedules repeat polls (see line 365 condition)\n        this.config.useWebSocket = false;\n        console.debug(\"[StreamStateClient] WebSocket closed, switching to HTTP polling\");\n        this.pollHttp();\n      };\n    } catch (error) {\n      console.warn(\"[StreamStateClient] WebSocket connection failed:\", error);\n      // Disable WebSocket and switch to HTTP polling\n      this.config.useWebSocket = false;\n      this.pollHttp();\n    }\n  }\n\n  private async pollHttp(): Promise<void> {\n    if (!this.isRunning) return;\n\n    const { mistBaseUrl, streamName, pollInterval } = this.config;\n\n    try {\n      const url = `${mistBaseUrl.replace(/\\/$/, \"\")}/json_${encodeURIComponent(streamName)}.js?metaeverywhere=1&inclzero=1`;\n      const response = await fetch(url, {\n        method: \"GET\",\n        headers: { Accept: \"application/json\" },\n      });\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}`);\n      }\n\n      // MistServer returns JSON with potential JSONP wrapper\n      let text = await response.text();\n      // Strip JSONP callback if present\n      const jsonpMatch = text.match(/^[^(]+\\(([\\s\\S]*)\\);?$/);\n      if (jsonpMatch) {\n        text = jsonpMatch[1];\n      }\n\n      const data = JSON.parse(text) as MistStreamInfo;\n      this.processStreamInfo(data);\n    } catch (error) {\n      if (!this.isRunning) return;\n\n      const errorMessage = error instanceof Error ? error.message : \"Connection failed\";\n      this.setState({\n        ...this.state,\n        status: \"ERROR\",\n        isOnline: false,\n        message: errorMessage,\n        lastUpdate: Date.now(),\n        error: errorMessage,\n      });\n      this.emit(\"error\", { error: errorMessage });\n    }\n\n    // Schedule next poll\n    if (this.isRunning && !this.config.useWebSocket) {\n      this.timers.start(() => this.pollHttp(), pollInterval, \"poll\");\n    }\n  }\n\n  private processStreamInfo(data: MistStreamInfo): void {\n    if (!this.isRunning) return;\n\n    let newState: StreamState;\n\n    if (data.error) {\n      // Stream has an error state - preserve existing streamInfo\n      const status = parseErrorToStatus(data.error);\n      const message = data.on_error || getStatusMessage(status, data.perc);\n\n      newState = {\n        status,\n        isOnline: false,\n        message,\n        percentage: data.perc,\n        lastUpdate: Date.now(),\n        error: data.error,\n        streamInfo: this.state.streamInfo, // Preserve existing source/tracks\n      };\n    } else {\n      // Stream is online with valid metadata\n      // Merge new data with existing streamInfo to preserve source/tracks from initial fetch\n      // WebSocket updates may not include source array\n      const mergedStreamInfo: MistStreamInfo = {\n        ...this.state.streamInfo, // Keep existing source/meta if present\n        ...data, // Override with new data\n        // Explicitly preserve source if not in new data\n        source: data.source || this.state.streamInfo?.source,\n        // Merge meta to preserve tracks\n        meta: {\n          ...this.state.streamInfo?.meta,\n          ...data.meta,\n          // Preserve tracks if not in new data\n          tracks: data.meta?.tracks || this.state.streamInfo?.meta?.tracks,\n        },\n      };\n\n      newState = {\n        status: \"ONLINE\",\n        isOnline: true,\n        message: \"Stream is online\",\n        lastUpdate: Date.now(),\n        streamInfo: mergedStreamInfo,\n      };\n    }\n\n    this.setState(newState);\n\n    // Emit online/offline events on state transitions\n    if (newState.isOnline && !this.wasOnline) {\n      this.emit(\"online\", undefined as never);\n    } else if (!newState.isOnline && this.wasOnline) {\n      this.emit(\"offline\", undefined as never);\n    }\n    this.wasOnline = newState.isOnline;\n  }\n\n  private setState(state: StreamState): void {\n    const prevState = this.state;\n    this.state = state;\n\n    // Emit if ANY state field changed - including streamInfo (track data)\n    // Previously only checked status/isOnline/message, causing track updates to be lost\n    const hasChanged =\n      prevState.status !== state.status ||\n      prevState.isOnline !== state.isOnline ||\n      prevState.message !== state.message ||\n      prevState.streamInfo !== state.streamInfo ||\n      prevState.lastUpdate !== state.lastUpdate;\n\n    if (hasChanged) {\n      this.emit(\"stateChange\", { state });\n    }\n  }\n}\n\nexport default StreamStateClient;\n"],"names":[],"mappings":"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"}

package/dist/esm/core/SubtitleManager.js

@@ -0,0 +1,225 @@
+/**
+ * SubtitleManager - WebVTT subtitle track management
+ *
+ * Based on MistMetaPlayer's subtitle handling (wrappers/html5.js, webrtc.js).
+ * Manages text tracks on video elements with support for:
+ * - Loading WebVTT from MistServer URLs
+ * - Multiple subtitle track selection
+ * - Sync correction for WebRTC seek offsets
+ */
+/**
+ * SubtitleManager handles text track lifecycle on a video element
+ */
+class SubtitleManager {
+    constructor(config = {}) {
+        this.video = null;
+        this.currentTrackId = null;
+        this.seekOffset = 0;
+        this.listeners = [];
+        this.config = config;
+        this.debug = config.debug ?? false;
+    }
+    /**
+     * Attach to a video element
+     */
+    attach(video) {
+        this.detach();
+        this.video = video;
+        // Listen for events that may require sync correction
+        const onLoadedData = () => this.correctSubtitleSync();
+        const onSeeked = () => this.correctSubtitleSync();
+        video.addEventListener("loadeddata", onLoadedData);
+        video.addEventListener("seeked", onSeeked);
+        this.listeners = [
+            () => video.removeEventListener("loadeddata", onLoadedData),
+            () => video.removeEventListener("seeked", onSeeked),
+        ];
+    }
+    /**
+     * Detach from video element
+     */
+    detach() {
+        this.listeners.forEach((fn) => fn());
+        this.listeners = [];
+        this.removeAllTracks();
+        this.video = null;
+        this.currentTrackId = null;
+    }
+    /**
+     * Get available text tracks from the video element
+     */
+    getTextTracks() {
+        if (!this.video)
+            return [];
+        return Array.from(this.video.textTracks);
+    }
+    /**
+     * Get all track elements from the video
+     */
+    getTrackElements() {
+        if (!this.video)
+            return [];
+        return Array.from(this.video.querySelectorAll("track"));
+    }
+    /**
+     * Set the active subtitle track
+     * Pass null to disable subtitles
+     */
+    setSubtitle(track) {
+        if (!this.video) {
+            this.log("Cannot set subtitle: no video element attached");
+            return;
+        }
+        // Remove existing subtitle tracks
+        this.removeAllTracks();
+        if (!track) {
+            this.currentTrackId = null;
+            this.log("Subtitles disabled");
+            return;
+        }
+        // Create new track element
+        const trackElement = document.createElement("track");
+        trackElement.kind = "subtitles";
+        trackElement.label = track.label;
+        trackElement.srclang = track.lang;
+        trackElement.src = this.buildTrackUrl(track.src);
+        trackElement.default = true;
+        // Set up load handler for sync correction
+        trackElement.addEventListener("load", () => {
+            this.correctSubtitleSync();
+        });
+        this.video.appendChild(trackElement);
+        this.currentTrackId = track.id;
+        // Enable the track
+        const textTrack = this.video.textTracks[this.video.textTracks.length - 1];
+        if (textTrack) {
+            textTrack.mode = "showing";
+        }
+        this.log(`Subtitle track set: ${track.label} (${track.lang})`);
+    }
+    /**
+     * Build track URL with base URL and append params
+     */
+    buildTrackUrl(src) {
+        let url = src;
+        // If relative URL and base URL provided, construct full URL
+        if (!url.startsWith("http") && this.config.mistBaseUrl) {
+            const base = this.config.mistBaseUrl.replace(/\/$/, "");
+            url = url.startsWith("/") ? `${base}${url}` : `${base}/${url}`;
+        }
+        // Append URL params if configured
+        if (this.config.urlAppend) {
+            const separator = url.includes("?") ? "&" : "?";
+            url = `${url}${separator}${this.config.urlAppend}`;
+        }
+        return url;
+    }
+    /**
+     * Create subtitle track info from MistServer track metadata
+     */
+    static createTrackInfo(trackId, label, lang, baseUrl, streamName) {
+        // MistServer WebVTT URL format
+        const src = `${baseUrl}/${streamName}.vtt?track=${trackId}`;
+        return { id: trackId, label, lang, src };
+    }
+    /**
+     * Remove all track elements from video
+     */
+    removeAllTracks() {
+        if (!this.video)
+            return;
+        const tracks = this.video.querySelectorAll("track");
+        tracks.forEach((track) => track.remove());
+    }
+    /**
+     * Get currently active track ID
+     */
+    getCurrentTrackId() {
+        return this.currentTrackId;
+    }
+    /**
+     * Set seek offset for WebRTC sync correction
+     * WebRTC playback has a seek offset that needs to be applied to subtitle timing
+     */
+    setSeekOffset(offset) {
+        const oldOffset = this.seekOffset;
+        this.seekOffset = offset;
+        // Re-sync if offset changed significantly
+        if (Math.abs(oldOffset - offset) > 1) {
+            this.correctSubtitleSync();
+        }
+    }
+    /**
+     * Correct subtitle timing based on seek offset
+     * This is needed for WebRTC where video.currentTime doesn't match actual playback position
+     */
+    correctSubtitleSync() {
+        if (!this.video || this.video.textTracks.length === 0)
+            return;
+        const textTrack = this.video.textTracks[0];
+        if (!textTrack || !textTrack.cues)
+            return;
+        const currentOffset = textTrack.currentOffset || 0;
+        // Don't bother if change is small
+        if (Math.abs(this.seekOffset - currentOffset) < 1)
+            return;
+        this.log(`Correcting subtitle sync: offset ${currentOffset} -> ${this.seekOffset}`);
+        // Collect and re-add cues with corrected timing
+        const newCues = [];
+        for (let i = textTrack.cues.length - 1; i >= 0; i--) {
+            const cue = textTrack.cues[i];
+            textTrack.removeCue(cue);
+            // Store original timing if not already stored
+            if (!cue.orig) {
+                cue.orig = { start: cue.startTime, end: cue.endTime };
+            }
+            // Apply offset correction
+            cue.startTime = cue.orig.start - this.seekOffset;
+            cue.endTime = cue.orig.end - this.seekOffset;
+            newCues.push(cue);
+        }
+        // Re-add cues
+        for (const cue of newCues) {
+            try {
+                textTrack.addCue(cue);
+            }
+            catch {
+                // Ignore errors from invalid cue timing
+            }
+        }
+        textTrack.currentOffset = this.seekOffset;
+    }
+    /**
+     * Parse subtitle tracks from MistServer stream info
+     */
+    static parseTracksFromStreamInfo(streamInfo, baseUrl, streamName) {
+        const tracks = [];
+        if (!streamInfo.meta?.tracks)
+            return tracks;
+        for (const [trackId, trackData] of Object.entries(streamInfo.meta.tracks)) {
+            if (trackData.type === "meta" && trackData.codec === "subtitle") {
+                const lang = trackData.lang || "und";
+                const label = lang === "und" ? `Subtitles ${trackId}` : lang.toUpperCase();
+                tracks.push(SubtitleManager.createTrackInfo(trackId, label, lang, baseUrl, streamName));
+            }
+        }
+        return tracks;
+    }
+    /**
+     * Debug logging
+     */
+    log(message) {
+        if (this.debug) {
+            console.debug(`[SubtitleManager] ${message}`);
+        }
+    }
+    /**
+     * Cleanup
+     */
+    destroy() {
+        this.detach();
+    }
+}
+
+export { SubtitleManager };
+//# sourceMappingURL=SubtitleManager.js.map