@livepeer-frameworks/player-react 0.1.0 → 0.1.2

package/dist/esm/hooks/usePlayerSelection.js

@@ -0,0 +1,88 @@
+import { slicedToArray as _slicedToArray } from '../_virtual/_rollupPluginBabelHelpers.js';
+import { useState, useEffect, useCallback } from 'react';
+
+/**
+ * Subscribe to player selection changes from a PlayerManager.
+ *
+ * This hook uses the event system in PlayerManager, which means:
+ * - Initial computation happens once when streamInfo is provided
+ * - Updates only fire when selection actually changes (different player+source)
+ * - No render spam from React strict mode or frequent re-renders
+ *
+ * @example
+ * ```tsx
+ * const { selection, combinations, ready } = usePlayerSelection(globalPlayerManager, {
+ *   streamInfo,
+ *   playbackMode: 'auto',
+ * });
+ *
+ * if (!ready) return <Loading />;
+ * if (!selection) return <NoPlayerAvailable />;
+ *
+ * return <div>Selected: {selection.player} + {selection.source.type}</div>;
+ * ```
+ */
+function usePlayerSelection(manager, options) {
+  var streamInfo = options.streamInfo,
+    playbackMode = options.playbackMode,
+    debug = options.debug;
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    selection = _useState2[0],
+    setSelection = _useState2[1];
+  var _useState3 = useState([]),
+    _useState4 = _slicedToArray(_useState3, 2),
+    combinations = _useState4[0],
+    setCombinations = _useState4[1];
+  var _useState5 = useState(false),
+    _useState6 = _slicedToArray(_useState5, 2),
+    ready = _useState6[0],
+    setReady = _useState6[1];
+  // Subscribe to events
+  useEffect(function () {
+    var unsubSelection = manager.on("selection-changed", function (sel) {
+      if (debug) {
+        var _sel$source;
+        console.log("[usePlayerSelection] Selection changed:", sel === null || sel === void 0 ? void 0 : sel.player, sel === null || sel === void 0 || (_sel$source = sel.source) === null || _sel$source === void 0 ? void 0 : _sel$source.type);
+      }
+      setSelection(sel);
+    });
+    var unsubCombos = manager.on("combinations-updated", function (combos) {
+      if (debug) {
+        console.log("[usePlayerSelection] Combinations updated:", combos.length);
+      }
+      setCombinations(combos);
+      setReady(true);
+    });
+    return function () {
+      unsubSelection();
+      unsubCombos();
+    };
+  }, [manager, debug]);
+  // Trigger initial computation when streamInfo changes
+  useEffect(function () {
+    if (!streamInfo) {
+      setSelection(null);
+      setCombinations([]);
+      setReady(false);
+      return;
+    }
+    // This will use cache if available, or compute + emit events if not
+    manager.getAllCombinations(streamInfo, playbackMode);
+  }, [manager, streamInfo, playbackMode]);
+  // Manual refresh function
+  var refresh = useCallback(function () {
+    if (!streamInfo) return;
+    manager.invalidateCache();
+    manager.getAllCombinations(streamInfo, playbackMode);
+  }, [manager, streamInfo, playbackMode]);
+  return {
+    selection: selection,
+    combinations: combinations,
+    ready: ready,
+    refresh: refresh
+  };
+}
+
+export { usePlayerSelection };
+//# sourceMappingURL=usePlayerSelection.js.map

package/dist/esm/hooks/usePlayerSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlayerSelection.js","sources":["../../../../src/hooks/usePlayerSelection.ts"],"sourcesContent":["/**\n * usePlayerSelection\n *\n * React hook for subscribing to PlayerManager selection events.\n * Uses event-driven updates instead of polling - no render spam.\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport type {\n  PlayerManager,\n  PlayerSelection,\n  PlayerCombination,\n  StreamInfo,\n  PlaybackMode,\n} from \"@livepeer-frameworks/player-core\";\n\nexport interface UsePlayerSelectionOptions {\n  /** Stream info to compute selections for */\n  streamInfo: StreamInfo | null;\n  /** Playback mode override */\n  playbackMode?: PlaybackMode;\n  /** Enable debug logging */\n  debug?: boolean;\n}\n\nexport interface UsePlayerSelectionReturn {\n  /** Current best selection (null if no compatible player) */\n  selection: PlayerSelection | null;\n  /** All player+source combinations with scores */\n  combinations: PlayerCombination[];\n  /** Whether initial computation has completed */\n  ready: boolean;\n  /** Force recomputation (invalidates cache) */\n  refresh: () => void;\n}\n\n/**\n * Subscribe to player selection changes from a PlayerManager.\n *\n * This hook uses the event system in PlayerManager, which means:\n * - Initial computation happens once when streamInfo is provided\n * - Updates only fire when selection actually changes (different player+source)\n * - No render spam from React strict mode or frequent re-renders\n *\n * @example\n * ```tsx\n * const { selection, combinations, ready } = usePlayerSelection(globalPlayerManager, {\n *   streamInfo,\n *   playbackMode: 'auto',\n * });\n *\n * if (!ready) return <Loading />;\n * if (!selection) return <NoPlayerAvailable />;\n *\n * return <div>Selected: {selection.player} + {selection.source.type}</div>;\n * ```\n */\nexport function usePlayerSelection(\n  manager: PlayerManager,\n  options: UsePlayerSelectionOptions\n): UsePlayerSelectionReturn {\n  const { streamInfo, playbackMode, debug } = options;\n\n  const [selection, setSelection] = useState<PlayerSelection | null>(null);\n  const [combinations, setCombinations] = useState<PlayerCombination[]>([]);\n  const [ready, setReady] = useState(false);\n\n  // Subscribe to events\n  useEffect(() => {\n    const unsubSelection = manager.on(\"selection-changed\", (sel) => {\n      if (debug) {\n        console.log(\"[usePlayerSelection] Selection changed:\", sel?.player, sel?.source?.type);\n      }\n      setSelection(sel);\n    });\n\n    const unsubCombos = manager.on(\"combinations-updated\", (combos) => {\n      if (debug) {\n        console.log(\"[usePlayerSelection] Combinations updated:\", combos.length);\n      }\n      setCombinations(combos);\n      setReady(true);\n    });\n\n    return () => {\n      unsubSelection();\n      unsubCombos();\n    };\n  }, [manager, debug]);\n\n  // Trigger initial computation when streamInfo changes\n  useEffect(() => {\n    if (!streamInfo) {\n      setSelection(null);\n      setCombinations([]);\n      setReady(false);\n      return;\n    }\n\n    // This will use cache if available, or compute + emit events if not\n    manager.getAllCombinations(streamInfo, playbackMode);\n  }, [manager, streamInfo, playbackMode]);\n\n  // Manual refresh function\n  const refresh = useCallback(() => {\n    if (!streamInfo) return;\n    manager.invalidateCache();\n    manager.getAllCombinations(streamInfo, playbackMode);\n  }, [manager, streamInfo, playbackMode]);\n\n  return {\n    selection,\n    combinations,\n    ready,\n    refresh,\n  };\n}\n"],"names":["usePlayerSelection","manager","options","streamInfo","playbackMode","debug","_useState","useState","_useState2","_slicedToArray","selection","setSelection","_useState3","_useState4","combinations","setCombinations","_useState5","_useState6","ready","setReady","useEffect","unsubSelection","on","sel","_sel$source","console","log","player","source","type","unsubCombos","combos","length","getAllCombinations","refresh","useCallback","invalidateCache"],"mappings":"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"}

package/dist/esm/hooks/useStreamState.js

@@ -0,0 +1,358 @@
+import { slicedToArray as _slicedToArray, objectSpread2 as _objectSpread2, asyncToGenerator as _asyncToGenerator, regenerator as _regenerator } from '../_virtual/_rollupPluginBabelHelpers.js';
+import { useState, useRef, useCallback, useEffect } from 'react';
+
+/**
+ * Parse MistServer error string into StreamStatus enum
+ */
+function parseErrorToStatus(error) {
+  var 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... ".concat(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";
+  }
+}
+/**
+ * Initial stream state
+ */
+var initialState = {
+  status: "OFFLINE",
+  isOnline: false,
+  message: "Connecting...",
+  lastUpdate: 0
+};
+function useStreamState(options) {
+  var mistBaseUrl = options.mistBaseUrl,
+    streamName = options.streamName,
+    _options$pollInterval = options.pollInterval,
+    pollInterval = _options$pollInterval === void 0 ? 3000 : _options$pollInterval,
+    _options$enabled = options.enabled,
+    enabled = _options$enabled === void 0 ? true : _options$enabled,
+    _options$useWebSocket = options.useWebSocket,
+    useWebSocket = _options$useWebSocket === void 0 ? true : _options$useWebSocket,
+    _options$debug = options.debug,
+    debug = _options$debug === void 0 ? false : _options$debug;
+  var _useState = useState(initialState),
+    _useState2 = _slicedToArray(_useState, 2),
+    state = _useState2[0],
+    setState = _useState2[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    socketReady = _useState4[0],
+    setSocketReady = _useState4[1];
+  var wsRef = useRef(null);
+  var pollTimeoutRef = useRef(null);
+  var wsTimeoutRef = useRef(null);
+  var mountedRef = useRef(true);
+  // MistPlayer-style WebSocket timeout (5 seconds)
+  var WS_TIMEOUT_MS = 5000;
+  /**
+   * Process MistServer response data
+   */
+  var processStreamInfo = useCallback(function (data) {
+    if (!mountedRef.current) return;
+    if (data.error) {
+      // Stream has an error state - preserve previous streamInfo (track data)
+      var status = parseErrorToStatus(data.error);
+      var message = data.on_error || getStatusMessage(status, data.perc);
+      setState(function (prev) {
+        return {
+          status: status,
+          isOnline: false,
+          message: message,
+          percentage: data.perc,
+          lastUpdate: Date.now(),
+          error: data.error,
+          streamInfo: prev.streamInfo // Preserve track data through error states
+        };
+      });
+    } 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 - only status updates
+      setState(function (prev) {
+        var _prev$streamInfo, _prev$streamInfo2, _data$meta, _prev$streamInfo3;
+        var mergedStreamInfo = _objectSpread2(_objectSpread2(_objectSpread2({}, prev.streamInfo), data), {}, {
+          // Override with new data
+          // Explicitly preserve source if not in new data
+          source: data.source || ((_prev$streamInfo = prev.streamInfo) === null || _prev$streamInfo === void 0 ? void 0 : _prev$streamInfo.source),
+          // Merge meta to preserve tracks
+          meta: _objectSpread2(_objectSpread2(_objectSpread2({}, (_prev$streamInfo2 = prev.streamInfo) === null || _prev$streamInfo2 === void 0 ? void 0 : _prev$streamInfo2.meta), data.meta), {}, {
+            // Preserve tracks if not in new data
+            tracks: ((_data$meta = data.meta) === null || _data$meta === void 0 ? void 0 : _data$meta.tracks) || ((_prev$streamInfo3 = prev.streamInfo) === null || _prev$streamInfo3 === void 0 || (_prev$streamInfo3 = _prev$streamInfo3.meta) === null || _prev$streamInfo3 === void 0 ? void 0 : _prev$streamInfo3.tracks)
+          })
+        });
+        return {
+          status: "ONLINE",
+          isOnline: true,
+          message: "Stream is online",
+          lastUpdate: Date.now(),
+          streamInfo: mergedStreamInfo
+        };
+      });
+    }
+  }, []);
+  /**
+   * HTTP polling fallback
+   * Adds metaeverywhere=1 and inclzero=1 like MistPlayer
+   */
+  var pollHttp = useCallback(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+    var baseUrl, url, response, text, jsonpMatch, data, _t;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.p = _context.n) {
+        case 0:
+          if (!(!mountedRef.current || !enabled)) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2);
+        case 1:
+          _context.p = 1;
+          // Build URL with MistPlayer-style params
+          baseUrl = "".concat(mistBaseUrl.replace(/\/$/, ""), "/json_").concat(encodeURIComponent(streamName), ".js");
+          url = "".concat(baseUrl, "?metaeverywhere=1&inclzero=1");
+          _context.n = 2;
+          return fetch(url, {
+            method: "GET",
+            headers: {
+              Accept: "application/json"
+            }
+          });
+        case 2:
+          response = _context.v;
+          if (response.ok) {
+            _context.n = 3;
+            break;
+          }
+          throw new Error("HTTP ".concat(response.status));
+        case 3:
+          _context.n = 4;
+          return response.text();
+        case 4:
+          text = _context.v;
+          // Strip JSONP callback if present (use [\s\S]* instead of /s flag for ES5 compat)
+          jsonpMatch = text.match(/^[^(]+\(([\s\S]*)\);?$/);
+          if (jsonpMatch) {
+            text = jsonpMatch[1];
+          }
+          data = JSON.parse(text);
+          processStreamInfo(data);
+          _context.n = 7;
+          break;
+        case 5:
+          _context.p = 5;
+          _t = _context.v;
+          if (mountedRef.current) {
+            _context.n = 6;
+            break;
+          }
+          return _context.a(2);
+        case 6:
+          setState(function (prev) {
+            return _objectSpread2(_objectSpread2({}, prev), {}, {
+              status: "ERROR",
+              isOnline: false,
+              message: _t instanceof Error ? _t.message : "Connection failed",
+              lastUpdate: Date.now(),
+              error: _t instanceof Error ? _t.message : "Unknown error"
+            });
+          });
+        case 7:
+          // Schedule next poll
+          if (mountedRef.current && enabled && !useWebSocket) {
+            pollTimeoutRef.current = setTimeout(pollHttp, pollInterval);
+          }
+        case 8:
+          return _context.a(2);
+      }
+    }, _callee, null, [[1, 5]]);
+  })), [mistBaseUrl, streamName, enabled, useWebSocket, pollInterval, processStreamInfo]);
+  /**
+   * WebSocket connection with MistPlayer-style 5-second timeout
+   */
+  var connectWebSocket = useCallback(function () {
+    if (!mountedRef.current || !enabled || !useWebSocket) return;
+    // Clean up existing connection and timeout
+    if (wsTimeoutRef.current) {
+      clearTimeout(wsTimeoutRef.current);
+      wsTimeoutRef.current = null;
+    }
+    if (wsRef.current) {
+      wsRef.current.close();
+      wsRef.current = null;
+    }
+    try {
+      // Convert http(s) to ws(s)
+      var wsUrl = mistBaseUrl.replace(/^http:/, "ws:").replace(/^https:/, "wss:").replace(/\/$/, "");
+      // Build URL with MistPlayer-style params
+      var url = "".concat(wsUrl, "/json_").concat(encodeURIComponent(streamName), ".js?metaeverywhere=1&inclzero=1");
+      var ws = new WebSocket(url);
+      wsRef.current = ws;
+      // MistPlayer-style timeout: if no message within 5 seconds, fall back to HTTP
+      wsTimeoutRef.current = setTimeout(function () {
+        if (ws.readyState <= WebSocket.OPEN) {
+          if (debug) {
+            console.debug("[useStreamState] WebSocket timeout (5s), falling back to HTTP polling");
+          }
+          ws.close();
+          pollHttp();
+        }
+      }, WS_TIMEOUT_MS);
+      ws.onopen = function () {
+        if (debug) {
+          console.debug("[useStreamState] WebSocket connected");
+        }
+        setSocketReady(true);
+      };
+      ws.onmessage = function (event) {
+        // Clear timeout on first message
+        if (wsTimeoutRef.current) {
+          clearTimeout(wsTimeoutRef.current);
+          wsTimeoutRef.current = null;
+        }
+        try {
+          var data = JSON.parse(event.data);
+          processStreamInfo(data);
+        } catch (e) {
+          console.warn("[useStreamState] Failed to parse WebSocket message:", e);
+        }
+      };
+      ws.onerror = function (_event) {
+        console.warn("[useStreamState] WebSocket error, falling back to HTTP polling");
+        if (wsTimeoutRef.current) {
+          clearTimeout(wsTimeoutRef.current);
+          wsTimeoutRef.current = null;
+        }
+        ws.close();
+      };
+      ws.onclose = function () {
+        wsRef.current = null;
+        setSocketReady(false);
+        if (!mountedRef.current || !enabled) return;
+        // Fallback to HTTP polling or reconnect
+        if (debug) {
+          console.debug("[useStreamState] WebSocket closed, starting HTTP polling");
+        }
+        pollHttp();
+      };
+    } catch (error) {
+      console.warn("[useStreamState] WebSocket connection failed:", error);
+      // Fallback to HTTP polling
+      pollHttp();
+    }
+  }, [mistBaseUrl, streamName, enabled, useWebSocket, debug, processStreamInfo, pollHttp]);
+  /**
+   * Manual refetch function
+   */
+  var refetch = useCallback(function () {
+    var _wsRef$current;
+    if (useWebSocket && ((_wsRef$current = wsRef.current) === null || _wsRef$current === void 0 ? void 0 : _wsRef$current.readyState) === WebSocket.OPEN) {
+      // WebSocket will receive updates automatically
+      return;
+    }
+    pollHttp();
+  }, [useWebSocket, pollHttp]);
+  /**
+   * Setup connection on mount and when options change
+   * Always do initial HTTP poll to get full stream info (including sources),
+   * then connect WebSocket for real-time status updates.
+   * MistServer WebSocket updates may not include source array.
+   */
+  useEffect(function () {
+    mountedRef.current = true;
+    if (!enabled || !mistBaseUrl || !streamName) {
+      setState(initialState);
+      return;
+    }
+    // Reset state when stream changes
+    setState(_objectSpread2(_objectSpread2({}, initialState), {}, {
+      message: "Connecting...",
+      lastUpdate: Date.now()
+    }));
+    // Always do initial HTTP poll to get full data (including sources)
+    // Then connect WebSocket for real-time updates
+    var initializeConnection = /*#__PURE__*/function () {
+      var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
+            case 0:
+              _context2.n = 1;
+              return pollHttp();
+            case 1:
+              // Then connect WebSocket for status updates (if enabled)
+              if (useWebSocket && mountedRef.current) {
+                connectWebSocket();
+              }
+            case 2:
+              return _context2.a(2);
+          }
+        }, _callee2);
+      }));
+      return function initializeConnection() {
+        return _ref2.apply(this, arguments);
+      };
+    }();
+    initializeConnection();
+    return function () {
+      // Set mounted=false FIRST before any other cleanup
+      mountedRef.current = false;
+      if (debug) {
+        console.debug("[useStreamState] cleanup starting, mountedRef set to false");
+      }
+      // Cleanup WebSocket timeout
+      if (wsTimeoutRef.current) {
+        clearTimeout(wsTimeoutRef.current);
+        wsTimeoutRef.current = null;
+      }
+      // Cleanup WebSocket - remove handlers BEFORE closing to prevent onclose callback
+      if (wsRef.current) {
+        // Detach handlers first to prevent onclose from triggering pollHttp
+        wsRef.current.onclose = null;
+        wsRef.current.onerror = null;
+        wsRef.current.onmessage = null;
+        wsRef.current.onopen = null;
+        wsRef.current.close();
+        wsRef.current = null;
+      }
+      // Cleanup polling timeout
+      if (pollTimeoutRef.current) {
+        clearTimeout(pollTimeoutRef.current);
+        pollTimeoutRef.current = null;
+      }
+    };
+  }, [enabled, mistBaseUrl, streamName, useWebSocket, debug, connectWebSocket, pollHttp]);
+  return _objectSpread2(_objectSpread2({}, state), {}, {
+    refetch: refetch,
+    socketRef: wsRef,
+    socketReady: socketReady
+  });
+}
+
+export { useStreamState };
+//# sourceMappingURL=useStreamState.js.map

package/dist/esm/hooks/useStreamState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamState.js","sources":["../../../../src/hooks/useStreamState.ts"],"sourcesContent":["import { useEffect, useState, useRef, useCallback } from \"react\";\nimport type { UseStreamStateOptions, StreamState, StreamStatus, MistStreamInfo } from \"../types\";\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 * Initial stream state\n */\nconst initialState: StreamState = {\n  status: \"OFFLINE\",\n  isOnline: false,\n  message: \"Connecting...\",\n  lastUpdate: 0,\n};\n\n/**\n * Hook to poll MistServer for stream status via WebSocket or HTTP\n *\n * Uses native MistServer protocol:\n * - WebSocket: ws://{baseUrl}/json_{streamName}.js\n * - HTTP fallback: GET {baseUrl}/json_{streamName}.js\n *\n * @example\n * ```tsx\n * const { status, isOnline, message } = useStreamState({\n *   mistBaseUrl: 'https://mist.example.com',\n *   streamName: 'pk_...', // playbackId (view key)\n *   pollInterval: 3000,\n * });\n * ```\n */\nexport interface UseStreamStateReturn extends StreamState {\n  /** Manual refetch function */\n  refetch: () => void;\n  /** WebSocket reference for sharing with MistReporter */\n  socketRef: React.RefObject<WebSocket | null>;\n  /** True when WebSocket is connected and ready (triggers re-render) */\n  socketReady: boolean;\n}\n\nexport function useStreamState(options: UseStreamStateOptions): UseStreamStateReturn {\n  const {\n    mistBaseUrl,\n    streamName,\n    pollInterval = 3000,\n    enabled = true,\n    useWebSocket = true,\n    debug = false,\n  } = options;\n\n  const [state, setState] = useState<StreamState>(initialState);\n  const [socketReady, setSocketReady] = useState(false);\n  const wsRef = useRef<WebSocket | null>(null);\n  const pollTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const wsTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const mountedRef = useRef(true);\n\n  // MistPlayer-style WebSocket timeout (5 seconds)\n  const WS_TIMEOUT_MS = 5000;\n\n  /**\n   * Process MistServer response data\n   */\n  const processStreamInfo = useCallback((data: MistStreamInfo) => {\n    if (!mountedRef.current) return;\n\n    if (data.error) {\n      // Stream has an error state - preserve previous streamInfo (track data)\n      const status = parseErrorToStatus(data.error);\n      const message = data.on_error || getStatusMessage(status, data.perc);\n\n      setState((prev) => ({\n        status,\n        isOnline: false,\n        message,\n        percentage: data.perc,\n        lastUpdate: Date.now(),\n        error: data.error,\n        streamInfo: prev.streamInfo, // Preserve track data through error states\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 - only status updates\n      setState((prev) => {\n        const mergedStreamInfo: MistStreamInfo = {\n          ...prev.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 || prev.streamInfo?.source,\n          // Merge meta to preserve tracks\n          meta: {\n            ...prev.streamInfo?.meta,\n            ...data.meta,\n            // Preserve tracks if not in new data\n            tracks: data.meta?.tracks || prev.streamInfo?.meta?.tracks,\n          },\n        };\n\n        return {\n          status: \"ONLINE\",\n          isOnline: true,\n          message: \"Stream is online\",\n          lastUpdate: Date.now(),\n          streamInfo: mergedStreamInfo,\n        };\n      });\n    }\n  }, []);\n\n  /**\n   * HTTP polling fallback\n   * Adds metaeverywhere=1 and inclzero=1 like MistPlayer\n   */\n  const pollHttp = useCallback(async () => {\n    if (!mountedRef.current || !enabled) return;\n\n    try {\n      // Build URL with MistPlayer-style params\n      const baseUrl = `${mistBaseUrl.replace(/\\/$/, \"\")}/json_${encodeURIComponent(streamName)}.js`;\n      const url = `${baseUrl}?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 (use [\\s\\S]* instead of /s flag for ES5 compat)\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      processStreamInfo(data);\n    } catch (error) {\n      if (!mountedRef.current) return;\n\n      setState((prev) => ({\n        ...prev,\n        status: \"ERROR\",\n        isOnline: false,\n        message: error instanceof Error ? error.message : \"Connection failed\",\n        lastUpdate: Date.now(),\n        error: error instanceof Error ? error.message : \"Unknown error\",\n      }));\n    }\n\n    // Schedule next poll\n    if (mountedRef.current && enabled && !useWebSocket) {\n      pollTimeoutRef.current = setTimeout(pollHttp, pollInterval);\n    }\n  }, [mistBaseUrl, streamName, enabled, useWebSocket, pollInterval, processStreamInfo]);\n\n  /**\n   * WebSocket connection with MistPlayer-style 5-second timeout\n   */\n  const connectWebSocket = useCallback(() => {\n    if (!mountedRef.current || !enabled || !useWebSocket) return;\n\n    // Clean up existing connection and timeout\n    if (wsTimeoutRef.current) {\n      clearTimeout(wsTimeoutRef.current);\n      wsTimeoutRef.current = null;\n    }\n    if (wsRef.current) {\n      wsRef.current.close();\n      wsRef.current = 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      // Build URL with MistPlayer-style params\n      const url = `${wsUrl}/json_${encodeURIComponent(streamName)}.js?metaeverywhere=1&inclzero=1`;\n      const ws = new WebSocket(url);\n      wsRef.current = ws;\n\n      // MistPlayer-style timeout: if no message within 5 seconds, fall back to HTTP\n      wsTimeoutRef.current = setTimeout(() => {\n        if (ws.readyState <= WebSocket.OPEN) {\n          if (debug) {\n            console.debug(\"[useStreamState] WebSocket timeout (5s), falling back to HTTP polling\");\n          }\n          ws.close();\n          pollHttp();\n        }\n      }, WS_TIMEOUT_MS);\n\n      ws.onopen = () => {\n        if (debug) {\n          console.debug(\"[useStreamState] WebSocket connected\");\n        }\n        setSocketReady(true);\n      };\n\n      ws.onmessage = (event) => {\n        // Clear timeout on first message\n        if (wsTimeoutRef.current) {\n          clearTimeout(wsTimeoutRef.current);\n          wsTimeoutRef.current = null;\n        }\n\n        try {\n          const data = JSON.parse(event.data) as MistStreamInfo;\n          processStreamInfo(data);\n        } catch (e) {\n          console.warn(\"[useStreamState] Failed to parse WebSocket message:\", e);\n        }\n      };\n\n      ws.onerror = (_event) => {\n        console.warn(\"[useStreamState] WebSocket error, falling back to HTTP polling\");\n        if (wsTimeoutRef.current) {\n          clearTimeout(wsTimeoutRef.current);\n          wsTimeoutRef.current = null;\n        }\n        ws.close();\n      };\n\n      ws.onclose = () => {\n        wsRef.current = null;\n        setSocketReady(false);\n\n        if (!mountedRef.current || !enabled) return;\n\n        // Fallback to HTTP polling or reconnect\n        if (debug) {\n          console.debug(\"[useStreamState] WebSocket closed, starting HTTP polling\");\n        }\n        pollHttp();\n      };\n    } catch (error) {\n      console.warn(\"[useStreamState] WebSocket connection failed:\", error);\n      // Fallback to HTTP polling\n      pollHttp();\n    }\n  }, [mistBaseUrl, streamName, enabled, useWebSocket, debug, processStreamInfo, pollHttp]);\n\n  /**\n   * Manual refetch function\n   */\n  const refetch = useCallback(() => {\n    if (useWebSocket && wsRef.current?.readyState === WebSocket.OPEN) {\n      // WebSocket will receive updates automatically\n      return;\n    }\n    pollHttp();\n  }, [useWebSocket, pollHttp]);\n\n  /**\n   * Setup connection on mount and when options change\n   * Always do initial HTTP poll to get full stream info (including sources),\n   * then connect WebSocket for real-time status updates.\n   * MistServer WebSocket updates may not include source array.\n   */\n  useEffect(() => {\n    mountedRef.current = true;\n\n    if (!enabled || !mistBaseUrl || !streamName) {\n      setState(initialState);\n      return;\n    }\n\n    // Reset state when stream changes\n    setState({\n      ...initialState,\n      message: \"Connecting...\",\n      lastUpdate: Date.now(),\n    });\n\n    // Always do initial HTTP poll to get full data (including sources)\n    // Then connect WebSocket for real-time updates\n    const initializeConnection = async () => {\n      // First HTTP poll to get complete stream info\n      await pollHttp();\n\n      // Then connect WebSocket for status updates (if enabled)\n      if (useWebSocket && mountedRef.current) {\n        connectWebSocket();\n      }\n    };\n\n    initializeConnection();\n\n    return () => {\n      // Set mounted=false FIRST before any other cleanup\n      mountedRef.current = false;\n      if (debug) {\n        console.debug(\"[useStreamState] cleanup starting, mountedRef set to false\");\n      }\n\n      // Cleanup WebSocket timeout\n      if (wsTimeoutRef.current) {\n        clearTimeout(wsTimeoutRef.current);\n        wsTimeoutRef.current = null;\n      }\n\n      // Cleanup WebSocket - remove handlers BEFORE closing to prevent onclose callback\n      if (wsRef.current) {\n        // Detach handlers first to prevent onclose from triggering pollHttp\n        wsRef.current.onclose = null;\n        wsRef.current.onerror = null;\n        wsRef.current.onmessage = null;\n        wsRef.current.onopen = null;\n        wsRef.current.close();\n        wsRef.current = null;\n      }\n\n      // Cleanup polling timeout\n      if (pollTimeoutRef.current) {\n        clearTimeout(pollTimeoutRef.current);\n        pollTimeoutRef.current = null;\n      }\n    };\n  }, [enabled, mistBaseUrl, streamName, useWebSocket, debug, connectWebSocket, pollHttp]);\n\n  return {\n    ...state,\n    refetch,\n    socketRef: wsRef,\n    socketReady,\n  };\n}\n\nexport default useStreamState;\n"],"names":["parseErrorToStatus","error","lowerError","toLowerCase","includes","getStatusMessage","status","percentage","undefined","concat","Math","round","initialState","isOnline","message","lastUpdate","useStreamState","options","mistBaseUrl","streamName","_options$pollInterval","pollInterval","_options$enabled","enabled","_options$useWebSocket","useWebSocket","_options$debug","debug","_useState","useState","_useState2","_slicedToArray","state","setState","_useState3","_useState4","socketReady","setSocketReady","wsRef","useRef","pollTimeoutRef","wsTimeoutRef","mountedRef","WS_TIMEOUT_MS","processStreamInfo","useCallback","data","current","on_error","perc","prev","Date","now","streamInfo","_prev$streamInfo","_prev$streamInfo2","_data$meta","_prev$streamInfo3","mergedStreamInfo","_objectSpread","source","meta","tracks","pollHttp","_asyncToGenerator","_regenerator","m","_callee","baseUrl","url","response","text","jsonpMatch","_t","w","_context","p","n","a","replace","encodeURIComponent","fetch","method","headers","Accept","v","ok","Error","match","JSON","parse","setTimeout","connectWebSocket","clearTimeout","close","wsUrl","ws","WebSocket","readyState","OPEN","console","onopen","onmessage","event","e","warn","onerror","_event","onclose","refetch","_wsRef$current","useEffect","initializeConnection","_ref2","_callee2","_context2","apply","arguments","socketRef"],"mappings":"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"}

package/dist/esm/hooks/useTelemetry.js

@@ -0,0 +1,118 @@
+import { useRef, useEffect, useCallback } from 'react';
+import { TelemetryReporter } from '@livepeer-frameworks/player-core';
+
+/**
+ * Hook to send telemetry data to a server
+ *
+ * Reports playback metrics at configurable intervals:
+ * - Current time and duration
+ * - Buffer health
+ * - Stall count and duration
+ * - Quality score and bitrate
+ * - Frame decode/drop stats
+ * - Errors encountered
+ *
+ * Uses navigator.sendBeacon() for reliable reporting on page unload.
+ *
+ * @example
+ * ```tsx
+ * const { sessionId, recordError } = useTelemetry({
+ *   enabled: true,
+ *   endpoint: '/api/telemetry',
+ *   interval: 5000,
+ *   videoElement,
+ *   contentId: 'pk_...', // playbackId (view key)
+ *   contentType: 'live',
+ *   playerType: 'hlsjs',
+ *   protocol: 'HLS',
+ *   getQuality: () => qualityMonitor.getCurrentQuality(),
+ * });
+ *
+ * // Record custom error
+ * recordError('NETWORK_ERROR', 'Connection lost');
+ * ```
+ */
+function useTelemetry(options) {
+  var _reporterRef$current$3, _reporterRef$current7;
+  var enabled = options.enabled,
+    endpoint = options.endpoint,
+    interval = options.interval,
+    authToken = options.authToken,
+    batchSize = options.batchSize,
+    videoElement = options.videoElement,
+    contentId = options.contentId,
+    contentType = options.contentType,
+    playerType = options.playerType,
+    protocol = options.protocol,
+    getQuality = options.getQuality;
+  var reporterRef = useRef(null);
+  // Create reporter instance
+  useEffect(function () {
+    if (!enabled || !endpoint || !contentId) {
+      var _reporterRef$current;
+      (_reporterRef$current = reporterRef.current) === null || _reporterRef$current === void 0 || _reporterRef$current.stop();
+      reporterRef.current = null;
+      return;
+    }
+    reporterRef.current = new TelemetryReporter({
+      endpoint: endpoint,
+      authToken: authToken,
+      interval: interval,
+      batchSize: batchSize,
+      contentId: contentId,
+      contentType: contentType,
+      playerType: playerType,
+      protocol: protocol
+    });
+    return function () {
+      var _reporterRef$current2;
+      (_reporterRef$current2 = reporterRef.current) === null || _reporterRef$current2 === void 0 || _reporterRef$current2.stop();
+      reporterRef.current = null;
+    };
+  }, [enabled, endpoint, authToken, interval, batchSize, contentId, contentType, playerType, protocol]);
+  // Start/stop reporting when video element changes
+  useEffect(function () {
+    if (!enabled || !videoElement || !reporterRef.current) {
+      return;
+    }
+    reporterRef.current.start(videoElement, getQuality);
+    return function () {
+      var _reporterRef$current3;
+      (_reporterRef$current3 = reporterRef.current) === null || _reporterRef$current3 === void 0 || _reporterRef$current3.stop();
+    };
+  }, [enabled, videoElement, getQuality]);
+  /**
+   * Record a custom error
+   */
+  var recordError = useCallback(function (code, message) {
+    var _reporterRef$current4;
+    (_reporterRef$current4 = reporterRef.current) === null || _reporterRef$current4 === void 0 || _reporterRef$current4.recordError(code, message);
+  }, []);
+  /**
+   * Get current session ID
+   */
+  var getSessionId = useCallback(function () {
+    var _reporterRef$current$, _reporterRef$current5;
+    return (_reporterRef$current$ = (_reporterRef$current5 = reporterRef.current) === null || _reporterRef$current5 === void 0 ? void 0 : _reporterRef$current5.getSessionId()) !== null && _reporterRef$current$ !== void 0 ? _reporterRef$current$ : null;
+  }, []);
+  /**
+   * Check if telemetry is active
+   */
+  var isActive = useCallback(function () {
+    var _reporterRef$current$2, _reporterRef$current6;
+    return (_reporterRef$current$2 = (_reporterRef$current6 = reporterRef.current) === null || _reporterRef$current6 === void 0 ? void 0 : _reporterRef$current6.isActive()) !== null && _reporterRef$current$2 !== void 0 ? _reporterRef$current$2 : false;
+  }, []);
+  return {
+    /** Session ID for this playback session */
+    sessionId: (_reporterRef$current$3 = (_reporterRef$current7 = reporterRef.current) === null || _reporterRef$current7 === void 0 ? void 0 : _reporterRef$current7.getSessionId()) !== null && _reporterRef$current$3 !== void 0 ? _reporterRef$current$3 : null,
+    /** Record a custom error */
+    recordError: recordError,
+    /** Get current session ID */
+    getSessionId: getSessionId,
+    /** Check if telemetry is active */
+    isActive: isActive
+  };
+}
+
+export { useTelemetry };
+//# sourceMappingURL=useTelemetry.js.map

package/dist/esm/hooks/useTelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTelemetry.js","sources":["../../../../src/hooks/useTelemetry.ts"],"sourcesContent":["import { useEffect, useRef, useCallback } from \"react\";\nimport {\n  TelemetryReporter,\n  type TelemetryOptions,\n  type PlaybackQuality,\n  type ContentType,\n} from \"@livepeer-frameworks/player-core\";\n\nexport interface UseTelemetryOptions extends TelemetryOptions {\n  /** Video element to monitor */\n  videoElement: HTMLVideoElement | null;\n  /** Content ID being played */\n  contentId: string;\n  /** Content type */\n  contentType: ContentType;\n  /** Player type name */\n  playerType: string;\n  /** Protocol being used */\n  protocol: string;\n  /** Optional quality getter function */\n  getQuality?: () => PlaybackQuality | null;\n}\n\n/**\n * Hook to send telemetry data to a server\n *\n * Reports playback metrics at configurable intervals:\n * - Current time and duration\n * - Buffer health\n * - Stall count and duration\n * - Quality score and bitrate\n * - Frame decode/drop stats\n * - Errors encountered\n *\n * Uses navigator.sendBeacon() for reliable reporting on page unload.\n *\n * @example\n * ```tsx\n * const { sessionId, recordError } = useTelemetry({\n *   enabled: true,\n *   endpoint: '/api/telemetry',\n *   interval: 5000,\n *   videoElement,\n *   contentId: 'pk_...', // playbackId (view key)\n *   contentType: 'live',\n *   playerType: 'hlsjs',\n *   protocol: 'HLS',\n *   getQuality: () => qualityMonitor.getCurrentQuality(),\n * });\n *\n * // Record custom error\n * recordError('NETWORK_ERROR', 'Connection lost');\n * ```\n */\nexport function useTelemetry(options: UseTelemetryOptions) {\n  const {\n    enabled,\n    endpoint,\n    interval,\n    authToken,\n    batchSize,\n    videoElement,\n    contentId,\n    contentType,\n    playerType,\n    protocol,\n    getQuality,\n  } = options;\n\n  const reporterRef = useRef<TelemetryReporter | null>(null);\n\n  // Create reporter instance\n  useEffect(() => {\n    if (!enabled || !endpoint || !contentId) {\n      reporterRef.current?.stop();\n      reporterRef.current = null;\n      return;\n    }\n\n    reporterRef.current = new TelemetryReporter({\n      endpoint,\n      authToken,\n      interval,\n      batchSize,\n      contentId,\n      contentType,\n      playerType,\n      protocol,\n    });\n\n    return () => {\n      reporterRef.current?.stop();\n      reporterRef.current = null;\n    };\n  }, [\n    enabled,\n    endpoint,\n    authToken,\n    interval,\n    batchSize,\n    contentId,\n    contentType,\n    playerType,\n    protocol,\n  ]);\n\n  // Start/stop reporting when video element changes\n  useEffect(() => {\n    if (!enabled || !videoElement || !reporterRef.current) {\n      return;\n    }\n\n    reporterRef.current.start(videoElement, getQuality);\n\n    return () => {\n      reporterRef.current?.stop();\n    };\n  }, [enabled, videoElement, getQuality]);\n\n  /**\n   * Record a custom error\n   */\n  const recordError = useCallback((code: string, message: string) => {\n    reporterRef.current?.recordError(code, message);\n  }, []);\n\n  /**\n   * Get current session ID\n   */\n  const getSessionId = useCallback((): string | null => {\n    return reporterRef.current?.getSessionId() ?? null;\n  }, []);\n\n  /**\n   * Check if telemetry is active\n   */\n  const isActive = useCallback((): boolean => {\n    return reporterRef.current?.isActive() ?? false;\n  }, []);\n\n  return {\n    /** Session ID for this playback session */\n    sessionId: reporterRef.current?.getSessionId() ?? null,\n    /** Record a custom error */\n    recordError,\n    /** Get current session ID */\n    getSessionId,\n    /** Check if telemetry is active */\n    isActive,\n  };\n}\n\nexport default useTelemetry;\n"],"names":["useTelemetry","options","_reporterRef$current$3","_reporterRef$current7","enabled","endpoint","interval","authToken","batchSize","videoElement","contentId","contentType","playerType","protocol","getQuality","reporterRef","useRef","useEffect","_reporterRef$current","current","stop","TelemetryReporter","_reporterRef$current2","start","_reporterRef$current3","recordError","useCallback","code","message","_reporterRef$current4","getSessionId","_reporterRef$current$","_reporterRef$current5","isActive","_reporterRef$current$2","_reporterRef$current6","sessionId"],"mappings":"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"}