prismcast 1.13.0 → 1.14.0

package/dist/utils/errors.js

@@ -2,9 +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, 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.
+/* These helpers group the error-handling primitives shared across the application: normalizers that turn an arbitrary thrown value into log-ready text or into
+ * an Error, and classifiers of browser-state failures, so a retry loop aborts as soon as the session it was retrying against is gone and 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
@@ -26,6 +26,15 @@ export function formatError(error) {
     // Strip trailing punctuation to prevent double punctuation when callers add their own.
     return message.replace(/[.!?]+$/, "");
 }
+/**
+ * Normalizes an unknown rejection value into an Error. An Error passes through unchanged; any other value becomes an Error whose message is the value's
+ * formatted text, with the original value kept as its cause so nothing is lost.
+ * @param error - The value a promise rejected with or a catch received.
+ * @returns The value itself when it is an Error, otherwise a new Error carrying it as the cause.
+ */
+export function toError(error) {
+    return (error instanceof Error) ? error : new Error(formatError(error), { cause: error });
+}
 /**
  * Checks whether an error indicates that the browser page or session has been closed or is otherwise unrecoverable. These errors should cause immediate abort of
  * any retry loops rather than continuing to retry an operation that will never succeed. Common unrecoverable errors include closed targets, closed sessions, and

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"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"}
+{"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;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IAEpC,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5F,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/fileLogger.d.ts

@@ -2,16 +2,16 @@ 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. 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.
+ * Initializes the file logger. Creates the log file and its parent directory when either is missing. 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, clock?: Clock): Promise<void>;
 /**
- * Writes a log entry to the buffer. Entries are flushed to disk periodically.
+ * Writes a log entry where the lifecycle state sends it. The window holds it for the first flush, dropping the oldest held entry past STARTUP_BUFFER_LIMIT; open
+ * and closing buffer it for the periodic or final flush, and a paused file drops it until the retry delay passes; closed appends it synchronously; off discards it.
  * @param level - Log level ("info", "warn", "error", "debug").
  * @param message - The formatted log message.
  * @param color - Color name accepted by node:util.styleText, or null for the default terminal color.
@@ -31,19 +31,30 @@ export declare function flushLogBuffer(): Promise<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
- * without orchestrating real filesystem I/O - the surrounding read/write/rename chain is small enough to be exercised at the integration level.
+ * Sets the maximum log file size and checks the open file against it at once, so a saved smaller limit trims an oversized file without waiting for the next
+ * periodic check. The limit is assigned before the check starts, so every check and trim from here on reads it whether or not the caller awaits the setter.
+ * The check returns when no file is open or the open file is paused, and skips the trim while debug logging is active, as the periodic check does.
+ * @param maxSize - The maximum log file size in bytes.
+ * @returns A promise that resolves once the size check, and any trim it started, completes.
+ */
+export declare function setMaxLogSize(maxSize: number): Promise<void>;
+/**
+ * Pure trim logic: given the log file's bytes and the configured maximum size, returns the trimmed bytes (keeping complete lines from the file's tail) or null
+ * when no trim is needed (the file is already at or below half maxSize). Extracted from trimLogFile so the cut is testable in isolation without orchestrating
+ * real filesystem I/O - the surrounding read/write/rename chain is small enough to be exercised at the integration level.
+ *
+ * Algorithm: the target is half of maxSize, rounded down, and the cut sits at the buffer's length minus the target, so the kept tail is at most half the limit.
+ * The kept tail starts after the first newline byte at or past the cut, so the trimmed file begins on a complete line, and that start is a whole character
+ * because a newline byte never lies inside a multi-byte sequence. With no newline past the cut, the kept tail is the end of one line, and a cut inside a
+ * multi-byte sequence advances past its continuation bytes to the next lead byte, so the kept tail never opens mid-character.
  *
- * Algorithm: target half of maxSize as the post-trim file size, cut from (content.length - targetSize), then advance to the next newline so the trimmed file
- * begins on a complete line. If no newline exists past the cut, the cut position is taken as-is (the trim still drops earlier content even if the kept tail is
- * a single fragment line).
+ * The result is a subarray of the input, so the trim writes back the bytes it read rather than decoding the file and encoding it again.
  *
- * @param content - The current log file content as a UTF-8 string.
+ * @param content - The log file's content, as read from disk.
  * @param maxSize - The configured maximum log file size in bytes.
  * @returns The trimmed content, or null when no trim is needed.
  */
-export declare function computeTrimmedLogContent(content: string, maxSize: number): Nullable<string>;
+export declare function computeTrimmedLogContent(content: Buffer, maxSize: number): Nullable<Buffer>;
 /**
  * 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.
  *

package/dist/utils/fileLogger.js

@@ -7,14 +7,16 @@ import path from "node:path";
 import { styleText } from "node:util";
 import { systemClock } from "homebridge-plugin-utils";
 const { promises: fsPromises } = fs;
-/* The file logger provides persistent logging to a configurable log file with automatic size-based trimming. When the log file exceeds the configured maximum
- * size, it is trimmed to half the maximum size, keeping only complete lines (the most recent logs are preserved). This approach prevents unbounded log growth while
- * maintaining recent history for troubleshooting.
+/* The file logger provides persistent logging to a configurable log file with automatic size-based trimming. When the log file's size in bytes exceeds the
+ * configured maximum, it is trimmed to at most half the maximum, keeping the most recent complete lines. The trim measures and cuts in bytes, the unit of the limit
+ * and of the size check, so a log of multi-byte text is held to the same bound an ASCII log is. This approach prevents unbounded log growth while maintaining
+ * recent history for troubleshooting.
  *
  * Design decisions:
  *
  * 1. Asynchronous buffered writes - Logs are collected in a buffer and flushed periodically to avoid blocking the event loop during high-frequency logging.
- * 2. Periodic size checking - File size is checked every N writes rather than on each write to minimize syscall overhead.
+ * 2. Size checking - File size is checked every N writes rather than on each write to minimize syscall overhead, and once more when setMaxLogSize() receives a
+ *    saved limit, so a smaller limit trims an oversized file at once. Each check starts only while the logger is open on a file that is accepting writes.
  * 3. Atomic trim operations - Trimming writes to a temp file then renames, preventing data loss if the process crashes during trim.
  * 4. Timestamps - Delegates to formatTimestamp() in utils/format.ts, which emits yyyy/mm/dd hh:mm:ss.mmm AM/PM. The same helper feeds the console method
  *    wrappers in app.ts and the Morgan HTTP request logger, so file, console, and request logs share identical timestamps.
@@ -25,8 +27,10 @@ const { promises: fsPromises } = fs;
  *    worth logging. Entries emitted in the window state, before the one initialization, are held in the write buffer and appended by the first flush after it,
  *    so the log file opens with the boot messages that preceded it. The window is bounded, and the initialization leaves it whether it succeeds or fails.
  */
-/* The file logger's module state: the lifecycle state that says where a line goes, plus the bookkeeping of the file it is open on. Every one of them is set up
- * by the initializeFileLogger() call during server startup.
+/* The file logger's module state: the lifecycle state that says where a line goes, plus the bookkeeping of the file it is open on. The initializeFileLogger()
+ * call during server startup sets the lifecycle state, the clock and the size cap, and setMaxLogSize() replaces the size cap when a saved limit changes it. The
+ * buffer, the write counter and the write chain start from their module initializers and shutdownFileLogger() resets them; a failed initialization also empties
+ * the buffer.
  */
 // Where the logger is in its lifecycle. Only transition() assigns it, which is what gives the flush timer a single owner.
 let state = { kind: "window" };
@@ -34,7 +38,8 @@ let state = { kind: "window" };
  * line, and rebuilding a state object per line would allocate on every log call.
  */
 let writeBuffer = [];
-// Writes since the last file size check, beside the state for the same reason the buffer is - the write path bumps it once per line.
+// The running count of lines the open and closing states buffer, whose multiples of SIZE_CHECK_FREQUENCY trigger the periodic size check, reset at shutdown. It
+// sits beside the state for the same reason the buffer does - that write path bumps it once per buffered line.
 let writeCount = 0;
 /* Tail of the write-ordering chain, the open file's bookkeeping rather than a member of its state. Every asynchronous mutation of the log file (buffer flushes
  * and trims) is appended to this promise so that the operations run strictly one after another. Without this serialization a flush's appendFile could land
@@ -47,8 +52,10 @@ let writeChain = Promise.resolve();
 // How long shutdown waits for the outstanding write chain to drain. Generous enough for a trim's read, write, and rename on a busy disk, and short enough that a
 // wedged filesystem operation cannot hold the process open through its own shutdown.
 const SHUTDOWN_DRAIN_BOUND_MS = 5000;
-// Maximum log file size, set during initialization. It is configuration the trim reads rather than lifecycle, so it stays beside the state.
-let maxLogSize = 1048576;
+// Maximum log file size in bytes, set by initialization and by setMaxLogSize(). It is configuration the size check and the trim read rather than lifecycle, so
+// it stays beside the state. It has no initial value because nothing reads it before initialization assigns the configured cap: the size check and the trim run
+// only in the open state, which initialization enters after that assignment.
+let maxLogSize;
 /* The clock the flush interval arms on and the pause stamps read, set during initialization. It is per-run configuration the way the size cap is, so it stays
  * beside the state rather than inside it: a member of the open variant would put the clock's lifetime where the file keeps lifecycle, and the closing and closed
  * states read it too.
@@ -98,9 +105,8 @@ function openFilePath() {
 }
 // Initialization.
 /**
- * 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.
+ * Initializes the file logger. Creates the log file and its parent directory when either is missing. 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.
@@ -169,7 +175,8 @@ function formatLogEntry(level, message, color, categoryTag) {
     return "[" + timestamp + "] " + coloredBody + "\n";
 }
 /**
- * Writes a log entry to the buffer. Entries are flushed to disk periodically.
+ * Writes a log entry where the lifecycle state sends it. The window holds it for the first flush, dropping the oldest held entry past STARTUP_BUFFER_LIMIT; open
+ * and closing buffer it for the periodic or final flush, and a paused file drops it until the retry delay passes; closed appends it synchronously; off discards it.
  * @param level - Log level ("info", "warn", "error", "debug").
  * @param message - The formatted log message.
  * @param color - Color name accepted by node:util.styleText, or null for the default terminal color.
@@ -209,7 +216,8 @@ export function writeLogEntry(level, message, color, categoryTag) {
         }
         case "closed": {
             /* The logger has shut down and this line still belongs to the run that just ended, so it goes to that run's file. The append is synchronous because
-             * nothing asynchronous is left to carry it: the flush timer is stopped, the write chain has drained, and the process may exit on the next tick.
+             * nothing asynchronous is left to carry it: the flush timer is stopped, the write chain has drained or its bounded wait has lapsed, and the process may exit
+             * on the next tick. A lapsed drain can leave a trim's rename pending, which would replace the file under this append.
              */
             try {
                 fs.appendFileSync(state.path, formatLogEntry(level, message, color, categoryTag), "utf-8");
@@ -320,13 +328,29 @@ export function flushLogBufferSync(fallbackPath) {
 }
 // Size Management.
 /**
- * Checks the actual file size and trims if it exceeds the maximum.
+ * Sets the maximum log file size and checks the open file against it at once, so a saved smaller limit trims an oversized file without waiting for the next
+ * periodic check. The limit is assigned before the check starts, so every check and trim from here on reads it whether or not the caller awaits the setter.
+ * The check returns when no file is open or the open file is paused, and skips the trim while debug logging is active, as the periodic check does.
+ * @param maxSize - The maximum log file size in bytes.
+ * @returns A promise that resolves once the size check, and any trim it started, completes.
+ */
+export async function setMaxLogSize(maxSize) {
+    maxLogSize = maxSize;
+    await checkAndTrimFile();
+}
+/**
+ * Checks the open file's size in bytes and trims it when it exceeds the maximum. The write path runs the check every SIZE_CHECK_FREQUENCY writes, and
+ * setMaxLogSize() runs it once for a saved limit.
  */
 async function checkAndTrimFile() {
-    const targetPath = openFilePath();
-    if (targetPath === null) {
+    /* A check starts only while the logger is open and its file is accepting writes. A trim started while the logger is closing would land on the write chain
+     * outside the drain shutdown awaits, where its rename could replace the file under the final flush, so no check starts once shutdown has begun, from the
+     * write path or from a save. A paused file takes no size check, as the write path takes none while it drops entries.
+     */
+    if ((state.kind !== "open") || (state.pausedSince !== null)) {
         return;
     }
+    const targetPath = state.path;
     try {
         const stats = await fsPromises.stat(targetPath);
         // Skip trimming when debug logging is active. Debug sessions generate high-volume output that is valuable for diagnosis - trimming mid-session would discard
@@ -343,15 +367,18 @@ async function checkAndTrimFile() {
     }
 }
 /**
- * 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
- * without orchestrating real filesystem I/O - the surrounding read/write/rename chain is small enough to be exercised at the integration level.
+ * Pure trim logic: given the log file's bytes and the configured maximum size, returns the trimmed bytes (keeping complete lines from the file's tail) or null
+ * when no trim is needed (the file is already at or below half maxSize). Extracted from trimLogFile so the cut is testable in isolation without orchestrating
+ * real filesystem I/O - the surrounding read/write/rename chain is small enough to be exercised at the integration level.
  *
- * Algorithm: target half of maxSize as the post-trim file size, cut from (content.length - targetSize), then advance to the next newline so the trimmed file
- * begins on a complete line. If no newline exists past the cut, the cut position is taken as-is (the trim still drops earlier content even if the kept tail is
- * a single fragment line).
+ * Algorithm: the target is half of maxSize, rounded down, and the cut sits at the buffer's length minus the target, so the kept tail is at most half the limit.
+ * The kept tail starts after the first newline byte at or past the cut, so the trimmed file begins on a complete line, and that start is a whole character
+ * because a newline byte never lies inside a multi-byte sequence. With no newline past the cut, the kept tail is the end of one line, and a cut inside a
+ * multi-byte sequence advances past its continuation bytes to the next lead byte, so the kept tail never opens mid-character.
  *
- * @param content - The current log file content as a UTF-8 string.
+ * The result is a subarray of the input, so the trim writes back the bytes it read rather than decoding the file and encoding it again.
+ *
+ * @param content - The log file's content, as read from disk.
  * @param maxSize - The configured maximum log file size in bytes.
  * @returns The trimmed content, or null when no trim is needed.
  */
@@ -364,42 +391,47 @@ export function computeTrimmedLogContent(content, maxSize) {
         // File is smaller than target, no trimming needed.
         return null;
     }
-    // Find the next newline after the cut position to keep complete lines.
-    let lineStart = content.indexOf("\n", cutPosition);
-    if (lineStart === -1) {
-        // No newline found after cut position, keep from cut position.
-        lineStart = cutPosition;
-    }
-    else {
+    // Find the next newline at or after the cut position to keep complete lines.
+    const newlinePosition = content.indexOf("\n", cutPosition);
+    if (newlinePosition !== -1) {
         // Start after the newline.
-        lineStart += 1;
+        return content.subarray(newlinePosition + 1);
+    }
+    // No newline past the cut. A continuation byte, one whose top two bits read 10, is never the first byte of a character, so the cut advances past any it lands
+    // on to the next lead byte; an advance that reaches the end keeps nothing.
+    let lineStart = cutPosition;
+    while ((lineStart < content.length) && ((content.readUInt8(lineStart) & 0xC0) === 0x80)) {
+        lineStart++;
     }
-    return content.substring(lineStart);
+    return content.subarray(lineStart);
 }
 /**
- * Trims the log file to half the maximum size, keeping only complete lines. The most recent logs are preserved. Pure cut logic lives in
- * computeTrimmedLogContent; this function is the I/O orchestration shell around it.
+ * Trims the log file to at most half the maximum size, keeping the most recent complete lines. Pure cut logic lives in computeTrimmedLogContent; this function
+ * is the I/O orchestration shell around it, reading the file as bytes and writing back the subarray the cut returns.
  *
  * The entire read/write/rename critical section runs inside the write-ordering chain so it is serialized against buffer flushes. This closes the trim/flush race:
  * an appendFile cannot land between this function's readFile and its rename, so the rename never overwrites freshly appended lines with a stale snapshot.
  */
 async function trimLogFile() {
-    // The path is read once here because a shutdown can move the state under the serialized operation below, and the rename has to land on the file the read
-    // came from rather than on wherever the logger has since gone.
-    const targetPath = openFilePath();
-    if (targetPath === null) {
+    /* The size check made this test before its stat, and it is made again here because a shutdown or a failed flush can move the state while that stat is awaited.
+     * The test and the enqueue below run in one synchronous step, so a trim either joins the write chain a shutdown's drain awaits or never starts. The path comes
+     * from the state the test read, because a shutdown can move the state under the serialized operation, and the rename has to land on the file the read came
+     * from rather than on wherever the logger has since gone.
+     */
+    if ((state.kind !== "open") || (state.pausedSince !== null)) {
         return;
     }
+    const targetPath = state.path;
     return serializeWrite(async () => {
         try {
-            const content = await fsPromises.readFile(targetPath, "utf-8");
+            const content = await fsPromises.readFile(targetPath);
             const trimmedContent = computeTrimmedLogContent(content, maxLogSize);
             if (trimmedContent === null) {
                 return;
             }
             // Write to temp file, then rename (atomic replace).
             const tempPath = targetPath + ".tmp";
-            await fsPromises.writeFile(tempPath, trimmedContent, "utf-8");
+            await fsPromises.writeFile(tempPath, trimmedContent);
             await fsPromises.rename(tempPath, targetPath);
         }
         catch (error) {

package/dist/utils/fileLogger.js.map

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

package/dist/utils/httpErrors.d.ts

@@ -0,0 +1,13 @@
+import type { NextFunction, Request, Response } from "express";
+/**
+ * Handles an error a route threw or passed on, installed as the last middleware of the main application and of the HDHomeRun server, so a request failure in
+ * any PrismCast application reaches the project logger rather than Express's console fallback, and a client never receives a stack trace. While the response has
+ * not started, it answers 500 with a sentence. Once headers are sent the status line is already on the wire and no answer can replace it, so the error goes on
+ * to Express's default handler, which closes the connection rather than leaving a half-written response open. Express recognizes an error handler by its four
+ * parameters, which is why next stays in the signature on the path that does not call it.
+ * @param error - The error the route raised.
+ * @param req - The request that failed.
+ * @param res - The response to answer on.
+ * @param next - Express's next function, handed the error once headers are sent.
+ */
+export declare function handleRequestError(error: unknown, req: Request, res: Response, next: NextFunction): void;

package/dist/utils/httpErrors.js

@@ -0,0 +1,22 @@
+import { LOG } from "./logger.js";
+import { formatError } from "./errors.js";
+/**
+ * Handles an error a route threw or passed on, installed as the last middleware of the main application and of the HDHomeRun server, so a request failure in
+ * any PrismCast application reaches the project logger rather than Express's console fallback, and a client never receives a stack trace. While the response has
+ * not started, it answers 500 with a sentence. Once headers are sent the status line is already on the wire and no answer can replace it, so the error goes on
+ * to Express's default handler, which closes the connection rather than leaving a half-written response open. Express recognizes an error handler by its four
+ * parameters, which is why next stays in the signature on the path that does not call it.
+ * @param error - The error the route raised.
+ * @param req - The request that failed.
+ * @param res - The response to answer on.
+ * @param next - Express's next function, handed the error once headers are sent.
+ */
+export function handleRequestError(error, req, res, next) {
+    LOG.error("A request failed with an unhandled error.", { error: formatError(error), method: req.method, url: req.originalUrl });
+    if (res.headersSent) {
+        next(error);
+        return;
+    }
+    res.status(500).send("Internal server error.");
+}
+//# sourceMappingURL=httpErrors.js.map

package/dist/utils/httpErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpErrors.js","sourceRoot":"","sources":["../../src/utils/httpErrors.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB;IAEhG,GAAG,CAAC,KAAK,CAAC,2CAA2C,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAEhI,IAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAEnB,IAAI,CAAC,KAAK,CAAC,CAAC;QAEZ,OAAO;IACT,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AACjD,CAAC"}

package/dist/utils/index.d.ts

@@ -3,10 +3,12 @@ export * from "./chromeFetch.ts";
 export * from "./cliOutput.ts";
 export * from "./debugFilter.ts";
 export * from "./delay.ts";
+export * from "./deviceId.ts";
 export * from "./errors.ts";
 export * from "./evaluate.ts";
 export * from "./ffmpeg.ts";
 export * from "./format.ts";
+export * from "./httpErrors.ts";
 export * from "./logEmitter.ts";
 export * from "./logger.ts";
 export * from "./m3u.ts";
@@ -15,6 +17,7 @@ export * from "./morganStream.ts";
 export * from "./network.ts";
 export * from "./never.ts";
 export * from "./pid.ts";
+export * from "./plainObject.ts";
 export * from "./platform.ts";
 export * from "./processInspector.ts";
 export * from "./retry.ts";

package/dist/utils/index.js

@@ -7,10 +7,12 @@ export * from "./chromeFetch.js";
 export * from "./cliOutput.js";
 export * from "./debugFilter.js";
 export * from "./delay.js";
+export * from "./deviceId.js";
 export * from "./errors.js";
 export * from "./evaluate.js";
 export * from "./ffmpeg.js";
 export * from "./format.js";
+export * from "./httpErrors.js";
 export * from "./logEmitter.js";
 export * from "./logger.js";
 export * from "./m3u.js";
@@ -19,6 +21,7 @@ export * from "./morganStream.js";
 export * from "./network.js";
 export * from "./never.js";
 export * from "./pid.js";
+export * from "./plainObject.js";
 export * from "./platform.js";
 export * from "./processInspector.js";
 export * from "./retry.js";

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/utils/logger.d.ts

@@ -14,8 +14,8 @@ export declare function isConsoleLogging(): boolean;
  */
 export declare function setDebugLogging(enabled: boolean): void;
 /**
- * Returns whether any debug logging is currently enabled.
- * @returns True if any debug categories are enabled, false otherwise.
+ * Returns whether any debug filter pattern is configured. An exclude-only pattern counts, so a true answer does not mean a category is enabled.
+ * @returns True if any debug filter pattern is configured, including an exclude-only pattern, false otherwise.
  */
 export declare function isDebugLogging(): boolean;
 /**
@@ -38,12 +38,13 @@ interface BoundLogger {
 }
 export declare const LOG: {
     /**
-     * Logs a debug message in cyan, filtered by category. Debug messages are only output when the specified category is enabled via the PRISMCAST_DEBUG environment
-     * variable or the --debug CLI flag (which enables all categories). Use this for verbose diagnostic information that would clutter normal logs.
+     * Logs a debug message in cyan, filtered by category. Debug messages are output only when the debug filter in debugFilter.ts enables the specified category.
+     * The filter is set by the PRISMCAST_DEBUG environment variable, by the --debug CLI flag (which enables all categories), or from the /debug page, whose filter
+     * is persisted in the configuration and applied at startup. Use this for verbose diagnostic information that would clutter normal logs.
      *
      * Stream ID is automatically included if running within a stream context (established by runWithStreamContext()).
      * @param category - The debug category (e.g., "tuning:hulu", "recovery:tab", "streaming:segmenter").
-     * @param message - The format string (supports %s, %d, %j, %o).
+     * @param message - The format string (supports %s, %d, %i, %f, %j, %o, %O, %c).
      * @param args - Values to interpolate into the format string.
      */
     debug: (category: string, message: string, ...args: unknown[]) => void;
@@ -52,7 +53,7 @@ export declare const LOG: {
      * stream initialization errors. The red color provides immediate visual indication of serious problems requiring attention.
      *
      * Stream ID is automatically included if running within a stream context (established by runWithStreamContext()).
-     * @param message - The format string (supports %s, %d, %j, %o).
+     * @param message - The format string (supports %s, %d, %i, %f, %j, %o, %O, %c).
      * @param args - Values to interpolate into the format string.
      */
     error: (message: string, ...args: unknown[]) => void;
@@ -61,7 +62,7 @@ export declare const LOG: {
      * status updates.
      *
      * Stream ID is automatically included if running within a stream context (established by runWithStreamContext()).
-     * @param message - The format string (supports %s, %d, %j, %o).
+     * @param message - The format string (supports %s, %d, %i, %f, %j, %o, %O, %c).
      * @param args - Values to interpolate into the format string.
      */
     info: (message: string, ...args: unknown[]) => void;
@@ -70,7 +71,7 @@ export declare const LOG: {
      * recovered from, missing optional features, or degraded functionality.
      *
      * Stream ID is automatically included if running within a stream context (established by runWithStreamContext()).
-     * @param message - The format string (supports %s, %d, %j, %o).
+     * @param message - The format string (supports %s, %d, %i, %f, %j, %o, %O, %c).
      * @param args - Values to interpolate into the format string.
      */
     warn: (message: string, ...args: unknown[]) => void;