prismcast 1.10.2 → 1.11.0

package/dist/streaming/lifecycle.js

@@ -1,11 +1,12 @@
 import { LOG, formatDuration, formatError, getAbortController, unregisterAbortController } from "../utils/index.js";
+import { cancelPrerollTimer, getStream, unregisterStream } from "./registry.js";
 import { formatKeyframeStatsSummary, formatSessionStatsSummary } from "./fmp4Segmenter.js";
 import { formatRecoveryMetricsSummary, getTotalRecoveryAttempts } from "./recovery.js";
-import { getStream, unregisterStream } from "./registry.js";
+import { isGracefulShutdown, unregisterManagedPage } from "../browser/index.js";
 import { clearClients } from "./clients.js";
+import { clearPretuneSafetyTimer } from "./pretuneTimers.js";
 import { clearShowName } from "./showInfo.js";
 import { emitStreamRemoved } from "./statusEmitter.js";
-import { isGracefulShutdown } from "../browser/index.js";
 /* This module provides the authoritative stream termination logic. All code paths that need to terminate a stream should call terminateStream() from this module. This
  * ensures consistent cleanup behavior including:
  *
@@ -27,7 +28,8 @@ import { isGracefulShutdown } from "../browser/index.js";
  */
 const channelToStreamId = new Map();
 /**
- * Set of stream IDs for which termination has been initiated. Used to suppress warnings from segmenter callbacks during cleanup.
+ * Set of stream IDs whose termination is in flight. Serves as the idempotency guard that makes redundant terminateStream() calls a no-op (callers may issue them
+ * freely), and lets in-flight segmenter and monitor callbacks suppress spurious warnings during cleanup.
  */
 const terminationInitiated = new Set();
 // Channel Mapping Functions.
@@ -63,25 +65,53 @@ export function deleteChannelStreamId(channelName) {
 export function isTerminationInitiated(streamId) {
     return terminationInitiated.has(streamId);
 }
-// Capture Stream Cleanup.
+// Stream Termination.
 /**
- * Destroys the raw capture stream to ensure chrome.tabCapture releases the capture. This MUST be called before closing the page to prevent capture state corruption.
- * When the stream is destroyed, puppeteer-stream's close handler fires synchronously (while the browser is still connected), which calls STOP_RECORDING in the
- * extension. Without this, the extension may think a capture is still active, causing subsequent getStream() calls to hang with "Cannot capture a tab with an active
- * stream" errors.
- * @param rawCaptureStream - The raw capture stream from puppeteer-stream, or null if not available.
+ * Disposes a stream's owned resources in the correct teardown order. The stream is the root of an ownership tree whose leaves are self-disposing nodes - the health
+ * monitor, the native proxy, and the capture session - and this function composes them, inlining the simple owned operations (aborting the per-stream
+ * AbortController, cancelling the deferred preroll timer, closing the page).
+ *
+ * It lives here, in the lifecycle owner, rather than as a [Symbol.dispose] on the registry entry, because the stream's teardown is not self-contained: it reads the
+ * per-stream AbortController from a side registry and the graceful-shutdown flag from the browser module. (The entry's index/membership cleanup - registry, client
+ * tracking, show-name cache, SSE - stays in terminateStream for the same reason: those cross-module registries reference the stream, and the orchestrator removes
+ * them rather than the entry disposing itself from its own containers.) The genuinely self-contained resources are the nodes this composes; the stream composes them.
+ *
+ * The order matters: abort first so pending page.evaluate() calls reject immediately instead of hanging on Puppeteer's 180s protocolTimeout while teardown
+ * proceeds; stop the monitor so it no longer reacts to the stream; cancel the preroll timer; dispose the active pipeline (capture and native modes are mutually
+ * exclusive - the capture session kills FFmpeg first, then destroys its capture stream, firing STOP_RECORDING while the browser is still connected, then stops
+ * the segmenter); and close the page last, after that destroy.
+ * @param entry - The registry entry whose owned resources to dispose.
  */
-function destroyCaptureStream(rawCaptureStream) {
-    if (!rawCaptureStream) {
-        return;
-    }
-    if (!rawCaptureStream.destroyed) {
-        rawCaptureStream.destroy();
+function disposeStreamResources(entry) {
+    // Abort any pending page.evaluate() calls so they reject immediately rather than hanging on Puppeteer's protocolTimeout, then unregister the controller.
+    getAbortController(entry.streamIdStr)?.abort();
+    unregisterAbortController(entry.streamIdStr);
+    // Stop the health monitor; it no longer needs to react to the stream. Its metrics were already read in the termination prologue.
+    entry.monitor?.dispose();
+    // Cancel the deferred preroll timer so it cannot fire after teardown and write to the soon-to-be-unregistered HLS state.
+    cancelPrerollTimer(entry.hls);
+    // Dispose the active pipeline. The CaptureSession kills its FFmpeg child, then destroys its capture stream, then stops its segmenter; the native proxy stops
+    // its polling loop and token-refresh timer. Only one is present for a given stream.
+    entry.nativeProxy?.stop();
+    entry.captureSession?.dispose();
+    // Release the page from managed tracking ahead of the close, the unregister-then-close order every other teardown site follows. This is bookkeeping against an
+    // in-process set with no Puppeteer call behind it, so it runs whenever there is a page at all - including the cases below where the close itself is skipped,
+    // which would otherwise leave the id tracked for a page nobody owns.
+    if (entry.page) {
+        unregisterManagedPage(entry.page);
+    }
+    // Close the browser page last - after the capture stream's destroy fired STOP_RECORDING while the browser was still connected. Skip during graceful shutdown
+    // (closeBrowser() closes every page; double-closing yields "Target closed" errors). The page is null for a pending entry whose async setup never created one.
+    if (entry.page && !isGracefulShutdown() && !entry.page.isClosed()) {
+        entry.page.close().catch((error) => {
+            LOG.debug("streaming:hls", "Error closing page for stream %s: %s.", entry.id, formatError(error));
+        });
     }
 }
-// Stream Termination.
 /**
- * Terminates a stream, cleaning up all resources. This is the authoritative termination function that all code paths should use for consistent cleanup.
+ * Terminates a stream, cleaning up all resources. This is the authoritative termination function that all code paths should use for consistent cleanup. It collapses
+ * to three readable phases: a prologue that snapshots the summary statistics while the resources are still live, disposeStreamResources() to tear down the stream's
+ * owned resources, and the index/membership cleanup plus the termination log.
  *
  * Note: This function does NOT call emitCurrentSystemStatus() to avoid circular dependencies with the browser module. Callers should call emitCurrentSystemStatus()
  * after termination if they need to update the SSE system status.
@@ -90,95 +120,45 @@ function destroyCaptureStream(rawCaptureStream) {
  * @param reason - The reason for termination (e.g., "idle timeout", "circuit breaker").
  */
 export function terminateStream(streamId, channelName, reason) {
-    // Mark termination as initiated to suppress spurious warnings from segmenter callbacks.
+    // The guard makes redundant terminate calls a no-op (callers can issue them freely) and suppresses spurious warnings from in-flight segmenter/monitor callbacks.
     if (terminationInitiated.has(streamId)) {
-        // Termination already in progress.
         return;
     }
     terminationInitiated.add(streamId);
-    // Get stream info early to calculate duration and access resources.
     const streamInfo = getStream(streamId);
     const durationMs = streamInfo ? (Date.now() - streamInfo.startTime.getTime()) : 0;
-    // Abort pending evaluate calls for this stream. This immediately rejects any pending page.evaluate() calls, preventing them from hanging for up to 180 seconds
-    // (Puppeteer's protocolTimeout). We do this first so pending operations fail fast before we start cleaning up resources.
-    if (streamInfo?.streamIdStr) {
-        const controller = getAbortController(streamInfo.streamIdStr);
-        if (controller) {
-            controller.abort();
-        }
-        unregisterAbortController(streamInfo.streamIdStr);
-    }
-    // Cancel the deferred preroll timer if it hasn't fired yet. Without this, a pending stream terminated during setup (idle timeout, capacity reclaim, browser
-    // disconnect) would leave an orphaned timer that writes to the now-unregistered HLS state.
-    if (streamInfo?.hls.prerollTimer) {
-        clearTimeout(streamInfo.hls.prerollTimer);
-        streamInfo.hls.prerollTimer = null;
-    }
-    // Destroy the raw capture stream BEFORE killing FFmpeg or closing the page. This triggers puppeteer-stream's close handler while the browser is still connected,
-    // ensuring STOP_RECORDING is called and chrome.tabCapture releases the capture. Without this, subsequent getStream() calls may hang with "active stream" errors.
-    if (streamInfo) {
-        destroyCaptureStream(streamInfo.rawCaptureStream);
-    }
-    // Capture native proxy statistics before stopping. The stats are closure-scoped counters that remain valid after stop(), but reading them before stop() makes the
-    // data flow explicit and avoids relying on implementation details.
+    // Prologue: snapshot every statistic the termination summary needs while the resources are still live. Each capture-mode resource is a node exposing a read
+    // alongside its dispose - the segmenter (via the capture session), the native proxy, and the health monitor - read here, disposed below. The counters remain valid
+    // after disposal, but reading up front keeps the disposal purely side-effecting. Capture and native modes are mutually exclusive, so at most one set is present.
+    const segmenter = streamInfo?.captureSession?.segmenter;
+    const keyframeStats = segmenter?.getKeyframeStats() ?? null;
+    const segmentCount = segmenter?.getSegmentIndex() ?? 0;
+    const sessionStats = segmenter?.getSessionStats() ?? null;
     const nativeProxyStats = streamInfo?.nativeProxy?.getStats();
-    // Stop the native proxy if running. This stops the manifest polling loop and cleans up timers.
-    if (streamInfo?.nativeProxy) {
-        streamInfo.nativeProxy.stop();
-    }
-    // Kill the FFmpeg process if using FFmpeg mode. This sets FFmpeg's internal shuttingDown flag, so when the segmenter stops (which closes the capture stream and
-    // FFmpeg's stdin), FFmpeg won't report spurious errors about truncated input. The order matters: kill() must be called before segmenter.stop() to set the flag
-    // before stdin closes.
-    if (streamInfo?.ffmpegProcess) {
-        streamInfo.ffmpegProcess.kill();
-    }
-    // Capture keyframe and session statistics before stopping the segmenter. The stats are snapshots of the accumulated state, so they remain valid after stop().
-    let keyframeStats = null;
-    let segmentCount = 0;
-    let sessionStats = null;
-    if (streamInfo?.segmenter) {
-        keyframeStats = streamInfo.segmenter.getKeyframeStats();
-        segmentCount = streamInfo.segmenter.getSegmentIndex();
-        sessionStats = streamInfo.segmenter.getSessionStats();
-        streamInfo.segmenter.stop();
+    const recoveryMetrics = streamInfo?.monitor?.getMetrics() ?? null;
+    // Dispose the stream's owned resources (abort, monitor, preroll timer, pipeline, page) in teardown order.
+    if (streamInfo) {
+        disposeStreamResources(streamInfo);
     }
-    // Remove channel mapping.
+    // Index/membership cleanup. The channel mapping, registry entry, client tracking, show-name cache, and SSE consumers are owned by other modules and reference this
+    // stream; the orchestrator removes them here. The "terminated" event must fire before unregisterStream() destroys the HLS state, and removing all listeners
+    // prevents orphaned-handler leaks.
     if (channelToStreamId.get(channelName) === streamId) {
         channelToStreamId.delete(channelName);
     }
-    // Clean up stream resources and capture recovery metrics.
-    let recoveryMetrics = null;
-    if (streamInfo) {
-        // Stop the health monitor and get recovery metrics.
-        if (streamInfo.stopMonitor) {
-            recoveryMetrics = streamInfo.stopMonitor();
-        }
-        // Close the browser page. Skip during graceful shutdown since closeBrowser() will close all pages and we'd get spurious "Target closed" errors. The page may be
-        // null for pending stream entries that were registered but whose async setup has not yet completed (or failed before creating a page).
-        if (streamInfo.page && !isGracefulShutdown() && !streamInfo.page.isClosed()) {
-            streamInfo.page.close().catch((error) => {
-                LOG.debug("streaming:hls", "Error closing page for stream %s: %s.", streamId, formatError(error));
-            });
-        }
-    }
-    // Notify MPEG-TS clients that this stream is ending. This must happen before unregisterStream() which destroys the HLSState. Removing all listeners prevents
-    // memory leaks from orphaned event handlers.
     if (streamInfo) {
         streamInfo.hls.segmentEmitter.emit("terminated");
         streamInfo.hls.segmentEmitter.removeAllListeners();
     }
-    // Unregister from registry. This also clears the HLS segment storage.
     unregisterStream(streamId);
-    // Clear client tracking data for this stream.
     clearClients(streamId);
-    // Clear cached show name.
+    clearPretuneSafetyTimer(streamId);
     clearShowName(streamId);
-    // Emit stream removed event.
     emitStreamRemoved(streamId);
-    // Clean up termination tracking.
     terminationInitiated.delete(streamId);
-    // Log termination with stream ID prefix since we're outside the stream context. Include recovery summary if there were any recoveries.
+    // Epilogue: compose and emit the termination summary from the prologue snapshot. Logged with the stream-ID prefix since we are outside the stream context.
     const streamIdStr = streamInfo?.streamIdStr ?? ("s" + String(streamId).padStart(4, "0"));
+    // "No active clients" is the routine, expected way a stream ends and is omitted from the summary; every other reason is exceptional and worth calling out.
     const reasonSuffix = (reason === "no active clients") ? "" : " (" + reason + ")";
     const streamLog = LOG.withStreamId(streamIdStr);
     // Build termination log message from optional summary components. Each component is appended only when it has meaningful content, avoiding combinatorial branching.

package/dist/streaming/lifecycle.js.map

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

package/dist/streaming/monitor.d.ts

@@ -1,4 +1,4 @@
-import type { RecoveryMetrics, TabReplacementResult } from "./recovery.ts";
+import type { MonitorHandle, TabReplacementResult } from "./recovery.ts";
 import type { Frame, Page } from "puppeteer-core";
 import type { Nullable, ResolvedSiteProfile } from "../types/index.ts";
 /**
@@ -32,7 +32,9 @@ export interface MonitorStreamInfo {
  * @param streamInfo - Stream metadata for status updates.
  * @param onCircuitBreak - Callback function called when circuit breaker trips.
  * @param onTabReplacement - Optional callback for tab replacement recovery. When provided and 3+ consecutive timeouts occur, this is called to replace the hung tab.
- *                           If null/undefined, tab replacement is not available and timeouts will eventually trip the circuit breaker.
- * @returns A cleanup function to stop the monitor.
+ *                           If null/undefined, tab replacement is not available; sustained evaluate timeouts are only surfaced via status (lastIssueType) with no
+ *                           automatic recovery escalation.
+ * @returns A MonitorHandle exposing the live recovery metrics (getMetrics) and a self-contained dispose that stops the monitor's polling interval.
  */
-export declare function monitorPlaybackHealth(page: Page, context: Frame | Page, profile: ResolvedSiteProfile, url: string, streamId: string, streamInfo: MonitorStreamInfo, onCircuitBreak: () => void, onTabReplacement?: () => Promise<Nullable<TabReplacementResult>>): () => RecoveryMetrics;
+export declare function monitorPlaybackHealth(page: Page, context: Frame | Page, profile: ResolvedSiteProfile, url: string, streamId: string, streamInfo: MonitorStreamInfo, onCircuitBreak: () => void, onTabReplacement?: () => Promise<Nullable<TabReplacementResult>>): MonitorHandle;
+//# sourceMappingURL=monitor.d.ts.map

package/dist/streaming/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/streaming/monitor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAuB,aAAa,EAAmB,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG/G,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAc,MAAM,mBAAmB,CAAC;AA0EnF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAuDD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,KAAK,GAAG,IAAI,EACrB,OAAO,EAAE,mBAAmB,EAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,iBAAiB,EAC7B,cAAc,EAAE,MAAM,IAAI,EAC1B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,GAC/D,aAAa,CAgrEf"}