prismcast 1.12.0 → 1.13.0

package/dist/utils/delay.d.ts

@@ -1,3 +1,4 @@
+import type { Clock } from "homebridge-plugin-utils";
 import type { Nullable } from "../types/index.ts";
 /**
  * A timeout expressed as an abort signal, paired with the disposal its consumer owes. The signal aborts with the caller's own error object as its reason, which
@@ -10,20 +11,32 @@ export interface TimeoutSignal {
     signal: AbortSignal;
 }
 /**
- * Creates a timeout signal that aborts after the given duration, carrying the supplied error as its abort reason.
+ * What a bound needs beyond its duration: where its time comes from, and what its lapse says. Every policy in this file accepts this shape, so one clock
+ * injected at a call site drives whichever bound that call site builds.
+ */
+export interface BoundOptions {
+    readonly clock?: Clock;
+    readonly reason?: Error;
+}
+/**
+ * Creates a timeout signal that aborts after the given duration, carrying the supplied error as its abort reason. The bound is a one-shot armed on the clock,
+ * so it comes due wherever that clock's time comes from - a platform timer under the system clock, an advance under a virtual one.
  *
  * The consumer owns the returned handle and must cancel() it once its wait settles. That discipline is what keeps a timer from being disposed at process exit
  * instead of at settlement: on Windows, libuv disposing a still-pending timeout handle during natural exit can race pending socket cleanup and trip the
  * UV_HANDLE_CLOSING assertion in libuv's async.c. Cancelling at settlement disposes the handle while the event loop is still healthy, which sidesteps the race
- * regardless of how soon afterwards the process exits. The timer is also unref'd, so during its bounded pre-settlement window it never by itself holds open an
- * otherwise-empty loop.
+ * regardless of how soon afterwards the process exits. A bound left pending holds the loop open for at most its own duration, and that never delays exit,
+ * because shutdown ends the process explicitly (see app.ts) rather than waiting for the loop to empty.
+ *
+ * The system clock reads the host's wall clock, so a step in that clock while a bound is pending shifts the bound by the size of the step, once; the next
+ * reading corrects it.
  *
  * The default error is built inside the timer callback so a wait that finishes in time allocates nothing.
  * @param ms - The timeout duration in milliseconds.
- * @param reason - Optional error to abort with. Defaults to a generic Error naming the duration.
+ * @param options - The clock the bound runs on and the reason it aborts with when it lapses.
  * @returns A handle exposing the timeout's signal and the cancel function that disposes its timer.
  */
-export declare function timeoutSignal(ms: number, reason?: Error): TimeoutSignal;
+export declare function timeoutSignal(ms: number, options?: BoundOptions): TimeoutSignal;
 /**
  * Waits for a promise, bounded by a timeout that throws. If the promise settles first its outcome passes through unchanged; if the bound lapses first, the
  * caller's exact error object is thrown, so a call site can identify its own lapse by reference or by instanceof rather than by parsing a message.
@@ -32,11 +45,11 @@ export declare function timeoutSignal(ms: number, reason?: Error): TimeoutSignal
  * and cancelled in the finally on every exit path - so no call site can forget the cleanup.
  * @param promise - The promise to wait on.
  * @param timeoutMs - The timeout duration in milliseconds.
- * @param timeoutError - Optional error to throw on timeout. Defaults to a generic Error naming the duration.
+ * @param options - The clock the bound runs on and the reason thrown when it lapses.
  * @returns The resolved value of the promise.
  * @throws The supplied error (or the default) when the bound lapses first, or the promise's own rejection when it settles first.
  */
-export declare function waitWithTimeout<T>(promise: Promise<T>, timeoutMs: number, timeoutError?: Error): Promise<T>;
+export declare function waitWithTimeout<T>(promise: Promise<T>, timeoutMs: number, options?: BoundOptions): Promise<T>;
 /**
  * Waits for a promise, bounded by a timeout that yields null. If the promise settles first its value is returned; if the bound lapses first the result is null,
  * so the caller branches on a value rather than unwinding through a catch.
@@ -47,20 +60,59 @@ export declare function waitWithTimeout<T>(promise: Promise<T>, timeoutMs: numbe
  *
  * The composition is deliberate. runWithAbort performs no race of its own; it composes the bounds into one signal, hands that signal to the factory, and maps
  * an abort-time rejection to null. So the factory forwards the signal into waitWithSignal, and that forwarding is what makes the bound genuinely bind on a
- * promise this code does not own - a factory that ignored its signal would leave a held promise waiting forever. The bound rides timeoutSignal rather than
- * runWithAbort's own timeout option so every bound in the project flows through the one source that can carry a reason, owns its timer, and is controllable
- * from a fake clock.
+ * promise this code does not own - a factory that ignored its signal would leave a held promise waiting forever. The bound uses timeoutSignal rather than
+ * runWithAbort's own timeout option so every bound in the project flows through the one source that can carry a reason, owns its timer, and runs on an
+ * injected clock.
+ *
+ * The lapse carries no reason, because there is no rejection to carry it on: a caller that needs to tell its own lapse apart reaches for waitWithTimeout.
  *
  * One constraint belongs to the caller: a promise that can itself resolve null cannot be told apart from a lapse. Callers own that fit.
  * @param promise - The promise to wait on.
  * @param timeoutMs - The timeout duration in milliseconds.
+ * @param options - The clock the bound runs on.
  * @returns The resolved value of the promise, or null if the bound lapsed first.
  */
-export declare function boundedWait<T>(promise: Promise<T>, timeoutMs: number): Promise<Nullable<T>>;
+export declare function boundedWait<T>(promise: Promise<T>, timeoutMs: number, options?: Pick<BoundOptions, "clock">): Promise<Nullable<T>>;
 /**
- * Creates a promise that resolves after the specified delay. Wraps node:timers/promises.setTimeout so the codebase has a single canonical "sleep" name.
+ * Creates a promise that resolves after the specified delay. This is the project's one canonical "sleep" name, over the system clock's delay, for the call
+ * sites that hold no clock of their own; a consumer that does hold one calls clock.delay instead, so its sleep runs on the same time source as its bounds.
  * @param ms - The delay duration in milliseconds.
  * @returns A promise that resolves after the specified delay.
  */
 export declare function delay(ms: number): Promise<void>;
-//# sourceMappingURL=delay.d.ts.map
+/**
+ * The inputs to one poll: what to read, when to stop reading, how often to ask, how long to keep asking, and what ends the asking early.
+ */
+export interface PollUntilOptions<T> {
+    readonly cadenceMs: number;
+    readonly ceilingMs: number;
+    readonly clock?: Clock;
+    readonly read: () => Promise<T>;
+    readonly signal?: AbortSignal;
+    readonly until: (value: T) => boolean;
+}
+/**
+ * A poll that ended on its own terms: satisfied by a read, or lapsed at its ceiling. The value is the satisfying read in the first case and the last read in the
+ * second, and the read count says how many it took - a satisfied-on-arrival signal reads once.
+ */
+export interface PollSettled<T> {
+    readonly reads: number;
+    readonly status: "lapsed" | "satisfied";
+    readonly value: T;
+}
+/**
+ * A poll its signal ended: before its first read, or between a read and the sleep that would have followed, or inside a cadence sleep. There is no value to
+ * report, because the state the caller was asking for was never confirmed and the caller has stopped caring; the read count says how far the poll got.
+ */
+export interface PollAborted {
+    readonly reads: number;
+    readonly status: "aborted";
+}
+/**
+ * The result of one poll.
+ */
+export type PollOutcome<T> = PollAborted | PollSettled<T>;
+export declare function pollUntil<T>(options: PollUntilOptions<T> & {
+    readonly signal?: undefined;
+}): Promise<PollSettled<T>>;
+export declare function pollUntil<T>(options: PollUntilOptions<T>): Promise<PollOutcome<T>>;

package/dist/utils/delay.js

@@ -1,9 +1,21 @@
 /* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
  *
  * delay.ts: The project's wait policies. homebridge-plugin-utils owns the wait mechanisms - waitWithSignal races a held promise against an interrupt signal,
- * and runWithAbort carries the return-null-on-abort policy - and this file names the policies built over them exactly once: timeoutSignal is the
- * reason-carrying interrupt source, waitWithTimeout is the throw-shaped bounded wait, boundedWait is the value-shaped one, and delay is the named sleep. Any
- * code path that needs "promise with a bound" consumes a policy here rather than re-rolling the timer, race, and cleanup sequence.
+ * runWithAbort carries the return-null-on-abort policy, and Clock is the time source the waits run on - and this file names the policies built over them
+ * exactly once: timeoutSignal is the reason-carrying interrupt source, waitWithTimeout is the throw-shaped bounded wait, boundedWait is the value-shaped one,
+ * delay is the named sleep, and pollUntil is the read-a-reported-state shape. Any code path that needs "promise with a bound" consumes a policy here rather
+ * than re-rolling the timer, race, and cleanup sequence.
+ *
+ * Every policy takes its clock through its options and defaults to systemClock, so a test drives the whole policy set from one TestClock: the bound, the
+ * cadence, and the sleep settle on a single virtual timeline, and a wait binds on a deadline the test crosses rather than resolving whenever a double decides
+ * it should. The system clock reads the host's wall clock, so a step in that clock while a bound or a poll is pending shifts that wait by the size of the
+ * step, once; the next reading corrects it.
+ *
+ * pollUntil sits beside the two bounded waits rather than among them because it binds a different thing. The bounded waits hold a promise somebody else
+ * produced and decide what a lapse means; pollUntil has no promise to hold - the state it is waiting on is one the caller can only ask for - so it asks on a
+ * cadence and reports what it last saw. That is why its ceiling is a bound to log rather than a delay the healthy path pays: a signal that is already true
+ * costs exactly one read. It is also the one policy here that takes an abort signal, because the state it asks for is one its caller may stop caring about
+ * before the ceiling, and an abort is a third outcome beside satisfied and lapsed rather than a lapse in disguise.
  *
  * Choosing between the two bounded waits is a question about semantics, not mechanism. A wait whose interruption is exceptional - the operation was supposed
  * to finish and did not - throws through waitWithTimeout, so the failure travels as an error the caller can distinguish by identity or type. A wait whose
@@ -14,27 +26,34 @@
  * what keeps a forgotten cleanup from leaking a timer at any call site, and it is what guarantees the handle is disposed at settlement while the event loop is
  * still healthy (see the rationale on timeoutSignal).
  */
-import { runWithAbort, waitWithSignal } from "homebridge-plugin-utils";
-import { setTimeout as nodeSleep } from "node:timers/promises";
+import { runWithAbort, systemClock, waitWithSignal } from "homebridge-plugin-utils";
 /**
- * Creates a timeout signal that aborts after the given duration, carrying the supplied error as its abort reason.
+ * Creates a timeout signal that aborts after the given duration, carrying the supplied error as its abort reason. The bound is a one-shot armed on the clock,
+ * so it comes due wherever that clock's time comes from - a platform timer under the system clock, an advance under a virtual one.
  *
  * The consumer owns the returned handle and must cancel() it once its wait settles. That discipline is what keeps a timer from being disposed at process exit
  * instead of at settlement: on Windows, libuv disposing a still-pending timeout handle during natural exit can race pending socket cleanup and trip the
  * UV_HANDLE_CLOSING assertion in libuv's async.c. Cancelling at settlement disposes the handle while the event loop is still healthy, which sidesteps the race
- * regardless of how soon afterwards the process exits. The timer is also unref'd, so during its bounded pre-settlement window it never by itself holds open an
- * otherwise-empty loop.
+ * regardless of how soon afterwards the process exits. A bound left pending holds the loop open for at most its own duration, and that never delays exit,
+ * because shutdown ends the process explicitly (see app.ts) rather than waiting for the loop to empty.
+ *
+ * The system clock reads the host's wall clock, so a step in that clock while a bound is pending shifts the bound by the size of the step, once; the next
+ * reading corrects it.
  *
  * The default error is built inside the timer callback so a wait that finishes in time allocates nothing.
  * @param ms - The timeout duration in milliseconds.
- * @param reason - Optional error to abort with. Defaults to a generic Error naming the duration.
+ * @param options - The clock the bound runs on and the reason it aborts with when it lapses.
  * @returns A handle exposing the timeout's signal and the cancel function that disposes its timer.
  */
-export function timeoutSignal(ms, reason) {
+export function timeoutSignal(ms, options = {}) {
+    const { clock = systemClock, reason } = options;
     const controller = new AbortController();
-    const timer = setTimeout(() => { controller.abort(reason ?? new Error("Operation timed out after " + String(ms) + "ms.")); }, ms);
-    timer.unref();
-    return { cancel: () => { clearTimeout(timer); }, signal: controller.signal };
+    // The bound is a one-shot on the clock, so a virtual clock fires it inside advance and disposing the handle cancels it before it fires. The default reason is
+    // built when the bound fires, so a wait that finishes in time allocates nothing.
+    const timer = clock.schedule(() => {
+        controller.abort(reason ?? new Error("Operation timed out after " + String(ms) + "ms."));
+    }, ms);
+    return { cancel: () => { timer[Symbol.dispose](); }, signal: controller.signal };
 }
 /**
  * Waits for a promise, bounded by a timeout that throws. If the promise settles first its outcome passes through unchanged; if the bound lapses first, the
@@ -44,12 +63,12 @@ export function timeoutSignal(ms, reason) {
  * and cancelled in the finally on every exit path - so no call site can forget the cleanup.
  * @param promise - The promise to wait on.
  * @param timeoutMs - The timeout duration in milliseconds.
- * @param timeoutError - Optional error to throw on timeout. Defaults to a generic Error naming the duration.
+ * @param options - The clock the bound runs on and the reason thrown when it lapses.
  * @returns The resolved value of the promise.
  * @throws The supplied error (or the default) when the bound lapses first, or the promise's own rejection when it settles first.
  */
-export async function waitWithTimeout(promise, timeoutMs, timeoutError) {
-    const timeout = timeoutSignal(timeoutMs, timeoutError);
+export async function waitWithTimeout(promise, timeoutMs, options = {}) {
+    const timeout = timeoutSignal(timeoutMs, options);
     try {
         return await waitWithSignal(promise, timeout.signal);
     }
@@ -67,17 +86,20 @@ export async function waitWithTimeout(promise, timeoutMs, timeoutError) {
  *
  * The composition is deliberate. runWithAbort performs no race of its own; it composes the bounds into one signal, hands that signal to the factory, and maps
  * an abort-time rejection to null. So the factory forwards the signal into waitWithSignal, and that forwarding is what makes the bound genuinely bind on a
- * promise this code does not own - a factory that ignored its signal would leave a held promise waiting forever. The bound rides timeoutSignal rather than
- * runWithAbort's own timeout option so every bound in the project flows through the one source that can carry a reason, owns its timer, and is controllable
- * from a fake clock.
+ * promise this code does not own - a factory that ignored its signal would leave a held promise waiting forever. The bound uses timeoutSignal rather than
+ * runWithAbort's own timeout option so every bound in the project flows through the one source that can carry a reason, owns its timer, and runs on an
+ * injected clock.
+ *
+ * The lapse carries no reason, because there is no rejection to carry it on: a caller that needs to tell its own lapse apart reaches for waitWithTimeout.
  *
  * One constraint belongs to the caller: a promise that can itself resolve null cannot be told apart from a lapse. Callers own that fit.
  * @param promise - The promise to wait on.
  * @param timeoutMs - The timeout duration in milliseconds.
+ * @param options - The clock the bound runs on.
  * @returns The resolved value of the promise, or null if the bound lapsed first.
  */
-export async function boundedWait(promise, timeoutMs) {
-    const timeout = timeoutSignal(timeoutMs);
+export async function boundedWait(promise, timeoutMs, options = {}) {
+    const timeout = timeoutSignal(timeoutMs, { clock: options.clock });
     try {
         return await runWithAbort((signal) => waitWithSignal(promise, signal), { signal: timeout.signal });
     }
@@ -86,11 +108,62 @@ export async function boundedWait(promise, timeoutMs) {
     }
 }
 /**
- * Creates a promise that resolves after the specified delay. Wraps node:timers/promises.setTimeout so the codebase has a single canonical "sleep" name.
+ * Creates a promise that resolves after the specified delay. This is the project's one canonical "sleep" name, over the system clock's delay, for the call
+ * sites that hold no clock of their own; a consumer that does hold one calls clock.delay instead, so its sleep runs on the same time source as its bounds.
  * @param ms - The delay duration in milliseconds.
  * @returns A promise that resolves after the specified delay.
  */
 export async function delay(ms) {
-    await nodeSleep(ms);
+    await systemClock.delay(ms);
+}
+/**
+ * Reads a signal on a cadence until it satisfies a predicate, a ceiling lapses, or an abort signal ends the asking. This is the shape every "wait for a reported
+ * state" call in the project shares: a state that only its owner can report, asked for on a cadence, under a ceiling that exists to be logged rather than to be
+ * waited out, and stoppable by the caller that no longer needs the answer.
+ *
+ * The first read runs immediately, with no sleep ahead of it, so a signal that is already true costs one round trip and nothing else. A read that rejects
+ * propagates unchanged: the poll has no opinion on what a failed read means, and swallowing it would hide a fault behind a lapse. A supplied signal ends the poll
+ * at the next checkpoint - before a read, before a sleep, or inside a sleep - and the outcome says so.
+ * @param options - The poll's read, predicate, cadence, ceiling, clock, and signal.
+ * @returns The outcome: satisfied or lapsed with the last value read, or aborted with the reads that ran.
+ */
+export async function pollUntil(options) {
+    const { cadenceMs, ceilingMs, clock = systemClock, read, signal, until } = options;
+    const startedAt = clock.now();
+    // The sleep's init is built once: a signal is forwarded so the clock ends the sleep when it aborts, and an absent signal forwards nothing at all.
+    const init = signal ? { signal } : undefined;
+    let reads = 0;
+    for (;;) {
+        if (signal?.aborted) {
+            return { reads, status: "aborted" };
+        }
+        // eslint-disable-next-line no-await-in-loop -- A poll is sequential by definition: each read has to settle before the cadence sleep and the next read.
+        const value = await read();
+        reads++;
+        if (until(value)) {
+            return { reads, status: "satisfied", value };
+        }
+        // An abort that landed during the read wins over a lapse at the ceiling and registers no sleep: the caller's own stop is checked before the ceiling and
+        // before the cadence, because a lapse would hand back a value the caller has already stopped caring about.
+        if (signal?.aborted) {
+            return { reads, status: "aborted" };
+        }
+        // The ceiling is checked only after a read has already happened, so the poll always reports a value and a zero ceiling still asks once.
+        if ((clock.now() - startedAt) >= ceilingMs) {
+            return { reads, status: "lapsed", value };
+        }
+        try {
+            // eslint-disable-next-line no-await-in-loop -- The cadence is the point: the next read must not start until this wait completes.
+            await clock.delay(cadenceMs, init);
+        }
+        catch (error) {
+            // The clock rejects an aborted sleep with its own AbortError rather than the signal's reason, so the poll identifies its abort by the signal it holds and
+            // lets any other rejection propagate unchanged.
+            if (signal?.aborted) {
+                return { reads, status: "aborted" };
+            }
+            throw error;
+        }
+    }
 }
 //# sourceMappingURL=delay.js.map

package/dist/utils/delay.js.map

@@ -1 +1 @@
-{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/utils/delay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAc/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,MAAc;IAEtD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,4BAA4B,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAElI,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,OAAO,EAAE,MAAM,EAAE,GAAS,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AACrF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAI,OAAmB,EAAE,SAAiB,EAAE,YAAoB;IAEnG,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEvD,IAAI,CAAC;QAEH,OAAO,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;YAAS,CAAC;QAET,OAAO,CAAC,MAAM,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAAmB,EAAE,SAAiB;IAEzE,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAEzC,IAAI,CAAC;QAEH,OAAO,MAAM,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrG,CAAC;YAAS,CAAC;QAET,OAAO,CAAC,MAAM,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IAEpC,MAAM,SAAS,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC"}
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/utils/delay.ts"],"names":[],"mappings":"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"}

package/dist/utils/errors.d.ts

@@ -34,14 +34,3 @@ export declare function isSessionClosedError(error: unknown): boolean;
  * @returns True if the error indicates the page, execution context, or frame the operation ran in is gone.
  */
 export declare function isPageDeathError(error: unknown): boolean;
-/**
- * Checks whether an error is the stale-capture-mutex signal: Chrome's tabCapture extension rejects a second concurrent getStream() with "Cannot capture a tab with
- * an active stream", and that rejection leaks puppeteer-stream's module-level mutex permanently, so the only recovery is a full process restart. This is the single
- * home for that one literal - every site that must decide the process-exit escalation reads it from here. The predicate is deliberately narrow: session-closed-shaped
- * rejections are common and benign, so widening it would exit the process on ordinary browser crashes. The related, broader capture-infrastructure classifier
- * (isCaptureInfrastructureError in recovery.ts) matches this message too, but the process-exit decision this predicate gates stays its own distinct check.
- * @param error - The error or message to check.
- * @returns True if the error carries the stale-capture-mutex signature.
- */
-export declare function isStaleCaptureMutexError(error: unknown): boolean;
-//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.js

@@ -2,8 +2,9 @@
  *
  * errors.ts: Error formatting and handling utilities for PrismCast.
  */
-/* These helpers group the error-handling primitives shared across the application: one normalizes arbitrary errors into log-ready text, the others classify
- * browser-state failures so callers can abort a retry loop early, tell a dead page apart from a bad subject, or escalate an unrecoverable capture.
+/* These helpers group the error-handling primitives shared across the application: one normalizes arbitrary errors into log-ready text, and two classify
+ * browser-state failures - one so a retry loop aborts as soon as the session it was retrying against is gone, the other so a caller can tell a page that
+ * died apart from a subject that was never there.
  */
 /**
  * Formats an error for logging by extracting the message if available, falling back to string conversion for non-Error objects. Trailing punctuation is stripped
@@ -66,16 +67,4 @@ export function isPageDeathError(error) {
         "frame got detached", "frame was detached"];
     return contextDeathPatterns.some((pattern) => message.includes(pattern));
 }
-/**
- * Checks whether an error is the stale-capture-mutex signal: Chrome's tabCapture extension rejects a second concurrent getStream() with "Cannot capture a tab with
- * an active stream", and that rejection leaks puppeteer-stream's module-level mutex permanently, so the only recovery is a full process restart. This is the single
- * home for that one literal - every site that must decide the process-exit escalation reads it from here. The predicate is deliberately narrow: session-closed-shaped
- * rejections are common and benign, so widening it would exit the process on ordinary browser crashes. The related, broader capture-infrastructure classifier
- * (isCaptureInfrastructureError in recovery.ts) matches this message too, but the process-exit decision this predicate gates stays its own distinct check.
- * @param error - The error or message to check.
- * @returns True if the error carries the stale-capture-mutex signature.
- */
-export function isStaleCaptureMutexError(error) {
-    return formatError(error).includes("Cannot capture a tab with an active stream");
-}
 //# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IAExC,IAAI,OAAe,CAAC;IAEpB,IAAG,KAAK,YAAY,KAAK,EAAE,CAAC;QAE1B,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC1B,CAAC;SAAM,IAAG,KAAK,IAAI,CAAC,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAElF,OAAO,GAAI,KAA6B,CAAC,OAAO,CAAC;IACnD,CAAC;SAAM,CAAC;QAEN,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,uFAAuF;IACvF,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAEjD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAEjD,MAAM,qBAAqB,GAAG,CAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,CAAE,CAAC;IAEtF,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAE7C,IAAG,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAE/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAEjD,MAAM,oBAAoB,GAAG,CAAE,uCAAuC,EAAE,oCAAoC,EAAE,iCAAiC;QAC7I,oBAAoB,EAAE,oBAAoB,CAAE,CAAC;IAE/C,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IAErD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC,CAAC;AACnF,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IAExC,IAAI,OAAe,CAAC;IAEpB,IAAG,KAAK,YAAY,KAAK,EAAE,CAAC;QAE1B,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC1B,CAAC;SAAM,IAAG,KAAK,IAAI,CAAC,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAElF,OAAO,GAAI,KAA6B,CAAC,OAAO,CAAC;IACnD,CAAC;SAAM,CAAC;QAEN,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,uFAAuF;IACvF,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAEjD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAEjD,MAAM,qBAAqB,GAAG,CAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,CAAE,CAAC;IAEtF,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAE7C,IAAG,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAE/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAEjD,MAAM,oBAAoB,GAAG,CAAE,uCAAuC,EAAE,oCAAoC,EAAE,iCAAiC;QAC7I,oBAAoB,EAAE,oBAAoB,CAAE,CAAC;IAE/C,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/utils/evaluate.d.ts

@@ -1,4 +1,5 @@
 import type { Frame, Page } from "puppeteer-core";
+import type { Clock } from "homebridge-plugin-utils";
 /**
  * Registers an AbortController for a stream. Called when a stream is created.
  * @param streamIdStr - The stream ID string (e.g., "cnn-5jecl6").
@@ -34,6 +35,14 @@ export declare class EvaluateTimeoutError extends Error {
 export declare class EvaluateAbortError extends Error {
     constructor();
 }
+/**
+ * What a call can say about its own bound: where the bound's time comes from, and how long it is. One options object rather than a second positional parameter,
+ * because only a few call sites name a timeout at all and none of them should have to write an undefined placeholder to reach past it.
+ */
+export interface EvaluateOptions {
+    readonly clock?: Clock;
+    readonly timeoutMs?: number;
+}
 /**
  * Executes a Puppeteer evaluate call with abort and timeout support. This wrapper provides immediate cancellation when a stream is terminated and a safety timeout to
  * prevent hanging on unresponsive browsers.
@@ -42,11 +51,10 @@ export declare class EvaluateAbortError extends Error {
  * @param context - The Page or Frame to evaluate in.
  * @param pageFunction - The function to evaluate in the browser context.
  * @param args - Arguments to pass to the function (optional).
- * @param timeoutMs - Timeout in milliseconds (default: 15000).
+ * @param options - The clock the bound arms on and how long the bound is.
  * @returns The result of the evaluate call.
  * @throws EvaluateAbortError if the stream was terminated.
  * @throws EvaluateTimeoutError if the timeout was reached.
  * @throws Any error from the underlying evaluate call.
  */
-export declare function evaluateWithAbort<T, Args extends unknown[]>(context: Frame | Page, pageFunction: (...args: Args) => T, args?: Args, timeoutMs?: number): Promise<T>;
-//# sourceMappingURL=evaluate.d.ts.map
+export declare function evaluateWithAbort<T, Args extends unknown[]>(context: Frame | Page, pageFunction: (...args: Args) => T, args?: Args, options?: EvaluateOptions): Promise<T>;

package/dist/utils/evaluate.js

@@ -80,13 +80,14 @@ export class EvaluateAbortError extends Error {
  * @param context - The Page or Frame to evaluate in.
  * @param pageFunction - The function to evaluate in the browser context.
  * @param args - Arguments to pass to the function (optional).
- * @param timeoutMs - Timeout in milliseconds (default: 15000).
+ * @param options - The clock the bound arms on and how long the bound is.
  * @returns The result of the evaluate call.
  * @throws EvaluateAbortError if the stream was terminated.
  * @throws EvaluateTimeoutError if the timeout was reached.
  * @throws Any error from the underlying evaluate call.
  */
-export async function evaluateWithAbort(context, pageFunction, args, timeoutMs) {
+export async function evaluateWithAbort(context, pageFunction, args, options = {}) {
+    const { clock, timeoutMs } = options;
     const timeout = timeoutMs ?? DEFAULT_EVALUATE_TIMEOUT;
     // Get stream context to find the abort signal.
     const streamIdStr = getStreamId();
@@ -105,7 +106,7 @@ export async function evaluateWithAbort(context, pageFunction, args, timeoutMs)
     // platform's AbortError for a stream termination. Those two can never be confused, and an evaluate rejection is never the signal's reason at all, so it falls
     // through verbatim. When there is no stream signal, composeSignals hands back the timeout signal unwrapped and the bound is the whole story.
     const timeoutReason = new EvaluateTimeoutError(timeout);
-    const timeoutHandle = timeoutSignal(timeout, timeoutReason);
+    const timeoutHandle = timeoutSignal(timeout, { clock, reason: timeoutReason });
     const signal = composeSignals(streamSignal, timeoutHandle.signal);
     try {
         return await waitWithSignal(evaluatePromise, signal);

package/dist/utils/evaluate.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/utils/evaluate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AAEH,sDAAsD;AACtD,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAEvC,gKAAgK;AAChK,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA2B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,UAA2B;IAEtF,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAE3D,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAEhD,OAAO,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IAEpD,OAAO,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE7C,YAAY,SAAiB;QAE3B,KAAK,CAAC,2BAA2B,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC;QAE/D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAE3C;QAEE,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAErD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAqB,EACrB,YAAkC,EAClC,IAAW,EACX,SAAkB;IAGlB,MAAM,OAAO,GAAG,SAAS,IAAI,wBAAwB,CAAC;IAEtD,+CAA+C;IAC/C,MAAM,WAAW,GAAG,WAAW,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzF,6GAA6G;IAC7G,IAAG,YAAY,EAAE,OAAO,EAAE,CAAC;QAEzB,MAAM,IAAI,kBAAkB,EAAE,CAAC;IACjC,CAAC;IAED,gKAAgK;IAChK,mDAAmD;IACnD,MAAM,eAAe,GAAG,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,QAAQ,CAAC,YAAoD,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEjC,yJAAyJ;IACzJ,yJAAyJ;IACzJ,8JAA8J;IAC9J,6IAA6I;IAC7I,MAAM,aAAa,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAElE,IAAI,CAAC;QAEH,OAAO,MAAM,cAAc,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAAC,OAAM,KAAK,EAAE,CAAC;QAEd,IAAG,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,aAAa,CAAC,EAAE,CAAC;YAE1D,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QAET,aAAa,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/utils/evaluate.ts"],"names":[],"mappings":"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"}

package/dist/utils/ffmpeg.context.d.ts

@@ -4,4 +4,3 @@ import type { FFmpegContext } from "./ffmpeg.ts";
  * @returns An FFmpegContext populated from the live process.
  */
 export declare function createDefaultFFmpegContext(): FFmpegContext;
-//# sourceMappingURL=ffmpeg.context.d.ts.map

package/dist/utils/ffmpeg.d.ts

@@ -71,6 +71,7 @@ export declare const resolvePrerollFFmpegPath: () => Promise<string | undefined>
  * Result from spawning an FFmpeg process.
  */
 export interface FFmpegProcess {
+    isShuttingDown: () => boolean;
     kill: () => void;
     process: ChildProcess;
     stdin: Writable;
@@ -157,4 +158,3 @@ export declare function spawnMpegTsRemuxer(ffmpegBin: string, onError: (error: E
  * @returns Promise resolving to true if FFmpeg is available, false otherwise.
  */
 export declare function isFFmpegAvailable(): Promise<boolean>;
-//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/utils/ffmpeg.js

@@ -181,7 +181,7 @@ export function classifyFfmpegExit(code, signal, label) {
  * @param options.label - Descriptive label for log messages and error strings (e.g., "FFmpeg", "MPEG-TS remuxer").
  * @param options.onError - Callback invoked when FFmpeg exits unexpectedly or encounters an error.
  * @param options.streamId - Optional stream identifier for log prefixing.
- * @returns FFmpeg process wrapper with stdin, stdout, and kill function.
+ * @returns FFmpeg process wrapper with stdin, stdout, a kill function, and the teardown-requested read its stream listeners gate on.
  */
 function spawnFFmpegProcess({ args, ffmpegBin, label, onError, streamId }) {
     const ffmpeg = spawn(ffmpegBin, args, { stdio: ["pipe", "pipe", "pipe"] });
@@ -226,6 +226,7 @@ function spawnFFmpegProcess({ args, ffmpegBin, label, onError, streamId }) {
         }
     };
     return {
+        isShuttingDown: () => shuttingDown,
         kill,
         process: ffmpeg,
         stdin: ffmpeg.stdin,

package/dist/utils/ffmpeg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/utils/ffmpeg.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,iKAAiK;AACjK,2EAA2E;AAC3E,MAAM,qBAAqB,GAAG,CAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAE,CAAC;AAyBxG;;;;;;;GAOG;AACH,KAAK,UAAU,kBAAkB,CAAC,GAAkB;IAElD,IAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAExF,OAAO,GAAG,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAAC,GAAkB;IAEjD,IAAG,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAE7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,iKAAiK;AACjK,4JAA4J;AAC5J,MAAM,kBAAkB,GAAsB;IAC5C,cAAc;IACd,UAAU;IACV,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,iBAAiB;IAC5B,aAAa,EAAE,YAAY;IAC3B,YAAY,EAAE,OAAO;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAqB,0BAA0B,EAAE;IAErF,sHAAsH;IACtH,IAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAE7B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEjH,IAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;YAErE,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,kHAAkH;IAClH,IAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAE5B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEzF,IAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;YAErE,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,+JAA+J;IAC/J,+HAA+H;IAC/H,IAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAE5B,MAAM,qBAAqB,GAAG;YAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACvD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACzD,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;SACjD,CAAC;QAEF,KAAI,MAAM,eAAe,IAAI,qBAAqB,EAAE,CAAC;YAEnD,4CAA4C;YAC5C,IAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;gBAErE,OAAO,eAAe,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,4JAA4J;IAC5J,0FAA0F;IAC1F,OAAO,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAqB,0BAA0B,EAAE;IAE5F,OAAO,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAqB,KAAK,IAAI,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;AAEjG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAqB,KAAK,IAAI,EAAE,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAsB/G,wBAAwB;AAExB;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,uBAAuB,EAAE,QAAQ;IACjC,mBAAmB,EAAE,QAAQ;IAC7B,sBAAsB,EAAE,YAAY;IACpC,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,GAAG;CACtB,CAAC;AASF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmB,EAAE,MAA6B,EAAE,KAAa;IAElG,IAAG,MAAM,KAAK,SAAS,EAAE,CAAC;QAExB,yDAAyD;QACzD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,IAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QAEnC,OAAO,EAAE,OAAO,EAAE,KAAK,GAAG,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC1F,CAAC;IAED,IAAG,MAAM,EAAE,CAAC;QAEV,OAAO,EAAE,OAAO,EAAE,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACpF,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,mBAAmB;AAEnB;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAMtE;IAEC,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAE,EAAE,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAExD,iKAAiK;IACjK,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,mGAAmG;IACnG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QAExC,IAAG,YAAY,EAAE,CAAC;YAEhB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAEvC,IAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAEtE,OAAO;QACT,CAAC;QAED,IAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAEtB,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAEjC,IAAG,YAAY,EAAE,CAAC;YAEhB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAEvD,IAAG,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAE9B,OAAO,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAE3B,IAAG,YAAY,EAAE,CAAC;YAEhB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,4IAA4I;IAC5I,MAAM,IAAI,GAAG,GAAS,EAAE;QAEtB,YAAY,GAAG,IAAI,CAAC;QAEpB,IAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAElB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QAEL,IAAI;QACJ,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAmBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB,EAAE,UAA8B,EAAE;IAEzF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,kJAAkJ;IAClJ,MAAM,UAAU,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IAE5D,MAAM,UAAU,GAAG;QACjB,GAAG,kBAAkB;QACrB,4BAA4B;QAC5B,IAAI,EAAE,QAAQ;QACd,+JAA+J;QAC/J,qCAAqC;QACrC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC;QAC5B,iKAAiK;QACjK,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,mEAAmE;QAChF,kHAAkH;QAClH,gBAAgB,EAAE,GAAG;KACtB,CAAC;IAEF,0GAA0G;IAC1G,IAAG,OAAO,EAAE,CAAC;QAEX,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,qIAAqI;IACrI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB;IAEpC,OAAO;QACL,GAAG,kBAAkB;QACrB,oFAAoF;QACpF,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,GAAG,mBAAmB;QACtB,2BAA2B;QAC3B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,0BAA0B;AAE1B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,YAAoB,EAAE,OAA+B,EAAE,QAAiB,EAAE,OAAgB;IAEvI,OAAO,kBAAkB,CAAC;QAExB,IAAI,EAAE,oBAAoB,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC;QACrD,SAAS;QACT,KAAK,EAAE,QAAQ;QACf,OAAO;QACP,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,OAA+B,EAAE,QAAiB;IAEtG,OAAO,kBAAkB,CAAC;QAExB,IAAI,EAAE,sBAAsB,EAAE;QAC9B,SAAS;QACT,KAAK,EAAE,iBAAiB;QACxB,OAAO;QACP,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IAErC,OAAO,CAAC,MAAM,iBAAiB,EAAE,CAAC,KAAK,SAAS,CAAC;AACnD,CAAC"}
+{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/utils/ffmpeg.ts"],"names":[],"mappings":"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"}

package/dist/utils/fileLogger.d.ts

@@ -1,11 +1,15 @@
+import type { Clock } from "homebridge-plugin-utils";
 import type { Nullable } from "../types/index.ts";
 export type LogColor = "cyan" | "red" | "yellow" | null;
 /**
- * Initializes the file logger. Creates the log file if it does not exist. Must be called after the data directory is ensured to exist.
+ * Initializes the file logger. Creates the log file if it does not exist. Must be called after the data directory is ensured to exist. A call is the one
+ * initialization of the process: it enters open, leaving the window's entries in the buffer for the first flush to append, or off, discarding them. Either
+ * outcome leaves the startup window behind.
  * @param logPath - Absolute path to the log file, resolved by the caller via getLogFilePath().
  * @param maxSize - Maximum log file size in bytes from CONFIG.logging.maxSize.
+ * @param clock - The clock the flush interval arms on and the pause stamps read; defaults to the system clock.
  */
-export declare function initializeFileLogger(logPath: string, maxSize: number): Promise<void>;
+export declare function initializeFileLogger(logPath: string, maxSize: number, clock?: Clock): Promise<void>;
 /**
  * Writes a log entry to the buffer. Entries are flushed to disk periodically.
  * @param level - Log level ("info", "warn", "error", "debug").
@@ -20,9 +24,12 @@ export declare function writeLogEntry(level: string, message: string, color: Log
  */
 export declare function flushLogBuffer(): Promise<void>;
 /**
- * Flushes the write buffer to disk synchronously. Used during shutdown to ensure final logs are written.
+ * Flushes the write buffer to disk synchronously. Shutdown reaches it while the logger is closing and writes to the configured log file, and the process exit
+ * handler reaches it on either side of initialization. The fallback path serves that second position - an exit in the startup window, where the buffer holds
+ * the window's entries and no log file was ever opened - and a logger holding a file of its own ignores it in favor of that file.
+ * @param fallbackPath - Absolute path to write to when the logger never initialized. Shutdown omits it, and so does console mode, whose lines never enter the buffer.
  */
-export declare function flushLogBufferSync(): void;
+export declare function flushLogBufferSync(fallbackPath?: string): void;
 /**
  * Pure trim logic: given the current log file content and the configured maximum size, returns the trimmed content (keeping complete lines from the file's tail)
  * or null when no trim is needed (file is already at or below half maxSize). Extracted from trimLogFile so the cut-at-newline algorithm is testable in isolation
@@ -38,7 +45,19 @@ export declare function flushLogBufferSync(): void;
  */
 export declare function computeTrimmedLogContent(content: string, maxSize: number): Nullable<string>;
 /**
- * Shuts down the file logger, flushing any remaining buffer synchronously.
+ * Shuts down the file logger: enters the closing state, waits for the write chain to drain, then flushes any remaining buffer synchronously and enters closed.
+ *
+ * The flush timer stops the moment the logger enters closing, because the chokepoint disposes a timer the next state does not carry, so no periodic flush can
+ * fire into the drain.
+ *
+ * The drain is what keeps shutdown from racing the writes it is meant to finish. A trim holds the log file across a read, a temp write, and a rename; a synchronous
+ * final flush issued while that rename is still pending appends to the file the rename is about to replace, so the last entries of the run are discarded along with
+ * the stale snapshot. Awaiting the chain first puts the final flush strictly after every mutation already in flight.
+ *
+ * The wait is bounded because a wedged filesystem operation must not hold the process open through its own shutdown. When the bound lapses the flush and the move
+ * to closed proceed anyway, which is the same outcome an unbounded wait would eventually reach minus the hang.
+ *
+ * The closed state keeps the path of the file it closed, so a line logged after this point - the exit handler's Chrome cleanup, a late process-level handler - is
+ * appended to that file synchronously instead of falling into the gap between the shutdown and the process exit.
  */
-export declare function shutdownFileLogger(): void;
-//# sourceMappingURL=fileLogger.d.ts.map
+export declare function shutdownFileLogger(): Promise<void>;