@bnhf/prismcast 1.3.4-2026.2.19

package/dist/index.js

@@ -0,0 +1,144 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * index.ts: Entry point for PrismCast.
+ */
+import { LOG, formatError, getPackageVersion, initDebugFilter, setDebugLogging } from "./utils/index.js";
+import { CONFIG } from "./config/index.js";
+import { flushLogBufferSync } from "./utils/fileLogger.js";
+import { handleServiceCommand } from "./service/index.js";
+import { killStaleChrome } from "./browser/index.js";
+import { startServer } from "./app.js";
+/* These handlers catch unhandled promise rejections and uncaught exceptions to prevent the process from crashing. For a livestreaming server, process stability is
+ * critical - a single unhandled error should not terminate all active streams. The handlers log the error and allow the process to continue. Individual stream
+ * failures are handled by circuit breakers, and actual browser crashes are handled by the browser's disconnected event.
+ */
+process.on("unhandledRejection", (reason) => {
+    LOG.error("Unhandled promise rejection: %s.", formatError(reason));
+});
+process.on("uncaughtException", (error) => {
+    LOG.error("Uncaught exception: %s.", formatError(error));
+});
+/* The entry point supports basic command-line arguments for common operations like changing the port, showing help, and displaying the version.
+ */
+/**
+ * Prints usage information to the console.
+ */
+function printUsage() {
+    /* eslint-disable no-console */
+    console.log("Usage: prismcast [command] [options]");
+    console.log("");
+    console.log("Commands:");
+    console.log("  service             Manage PrismCast as a system service");
+    console.log("                      Run 'prismcast service --help' for details");
+    console.log("");
+    console.log("Options:");
+    console.log("  -c, --console       Log to console instead of file (for Docker or debugging)");
+    console.log("  -d, --debug         Enable debug logging (verbose output for troubleshooting)");
+    console.log("  -h, --help          Show this help message");
+    console.log("  -p, --port <port>   Set server port (default: 5589)");
+    console.log("  -v, --version       Show version number");
+    console.log("");
+    console.log("If no command is specified, starts the PrismCast server.");
+    console.log("");
+    console.log("Environment Variables:");
+    console.log("  PORT                HTTP server port");
+    console.log("  HOST                HTTP server bind address");
+    console.log("  QUALITY_PRESET      Video quality preset (480p, 720p, 1080p, 1080p-high, 4k)");
+    console.log("  VIDEO_BITRATE       Video bitrate (bps)");
+    console.log("  AUDIO_BITRATE       Audio bitrate (bps)");
+    console.log("  FRAME_RATE          Target frame rate");
+    console.log("  CHROME_BIN          Path to Chrome executable");
+    console.log("  LOG_MAX_SIZE        Maximum log file size in bytes (default: 1048576)");
+    console.log("  PRISMCAST_DEBUG     Debug category filter (e.g., 'tuning:hulu', 'recovery', '*,-streaming:segmenter')");
+    /* eslint-enable no-console */
+}
+/**
+ * Parses command-line arguments and applies overrides to the configuration.
+ * @returns Parsed argument flags.
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let consoleLogging = false;
+    let debugLogging = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === "-c") || (arg === "--console")) {
+            consoleLogging = true;
+        }
+        if ((arg === "-d") || (arg === "--debug")) {
+            debugLogging = true;
+        }
+        if ((arg === "-h") || (arg === "--help")) {
+            printUsage();
+            process.exit(0);
+        }
+        if ((arg === "-p") || (arg === "--port")) {
+            const port = parseInt(args[++i]);
+            if (!isNaN(port)) {
+                CONFIG.server.port = port;
+            }
+        }
+        if ((arg === "-v") || (arg === "--version")) {
+            // eslint-disable-next-line no-console
+            console.log("PrismCast v" + getPackageVersion());
+            process.exit(0);
+        }
+    }
+    return { consoleLogging, debugLogging };
+}
+/* Check for subcommands before parsing flags. Subcommands are handled separately and exit after completion.
+ */
+const rawArgs = process.argv.slice(2);
+const subcommand = rawArgs[0];
+// Handle the 'service' subcommand for managing PrismCast as a system service.
+if (subcommand === "service") {
+    handleServiceCommand(rawArgs.slice(1)).then((exitCode) => {
+        process.exit(exitCode);
+    }).catch((error) => {
+        // eslint-disable-next-line no-console
+        console.error("Service command failed: " + formatError(error));
+        process.exit(1);
+    });
+}
+else {
+    /* The main entry point parses command-line arguments, starts the server, and handles any fatal errors that occur during initialization. If startup fails, we exit
+     * with a non-zero code to signal the failure to process managers.
+     */
+    const parsedArgs = parseArgs();
+    // Enable debug logging before starting the server so debug messages during startup are captured. The PRISMCAST_DEBUG environment variable takes precedence over
+    // the --debug CLI flag, allowing fine-grained category selection.
+    const debugEnv = process.env.PRISMCAST_DEBUG;
+    if (debugEnv) {
+        initDebugFilter(debugEnv);
+    }
+    else if (parsedArgs.debugLogging) {
+        setDebugLogging(true);
+    }
+    /* Safety net for server exit paths. When the process exits — whether via process.exit(1) from a fatal startup error, an unrecoverable exception, or any other
+     * termination — we ensure Chrome processes are cleaned up and buffered log entries are flushed to disk. Without this, fatal exits during startup (e.g., capture
+     * probe timeout) silently orphan Chrome processes and lose diagnostic messages that are still in the file logger's write buffer.
+     *
+     * The 'exit' event runs synchronously, so only synchronous operations are safe here. killStaleChrome() uses execSync internally, and flushLogBufferSync() writes
+     * directly to the filesystem. The graceful shutdown path (SIGTERM/SIGINT) handles cleanup via async closeBrowser() and shutdownFileLogger() — this handler is a
+     * fallback for paths that bypass graceful shutdown.
+     *
+     * This is registered only in the server branch — not for service subcommands like `prismcast service status`. Running killStaleChrome() from a service
+     * subcommand would kill Chrome belonging to the running PrismCast server instance.
+     */
+    process.on("exit", () => {
+        // Flush logs first — this is the critical operation. The error messages from a failed startup are sitting in the write buffer and must reach disk before the
+        // process terminates. Chrome will die when its pipes break since the parent is exiting; killing it explicitly is belt-and-suspenders.
+        flushLogBufferSync();
+        try {
+            killStaleChrome();
+        }
+        catch {
+            // Best-effort cleanup. If pkill fails for any reason, the process is exiting anyway.
+        }
+    });
+    startServer(parsedArgs.consoleLogging).catch((error) => {
+        LOG.error("Fatal startup error occurred: %s.", formatError(error));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/routes/assets.d.ts

@@ -0,0 +1,6 @@
+import type { Express } from "express";
+/**
+ * Configures routes for serving static assets (logo and favicon).
+ * @param app - The Express application.
+ */
+export declare function setupAssetEndpoints(app: Express): void;

package/dist/routes/assets.js

@@ -0,0 +1,79 @@
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { readFile } from "fs/promises";
+/* This module serves static assets like the logo and favicon. The assets are read from the project root directory at startup and cached in memory for efficient
+ * serving.
+ */
+// Cached asset data. Populated on first request and reused for subsequent requests.
+let svgData = null;
+let pngData = null;
+// Resolve the project root directory (two levels up from src/routes/).
+const projectRoot = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
+/**
+ * Loads an asset file from the project root, caching it for subsequent requests.
+ * @param filename - The filename to load from the project root.
+ * @returns The file contents as a Buffer, or null if the file could not be read.
+ */
+async function loadAsset(filename) {
+    try {
+        return await readFile(join(projectRoot, filename));
+    }
+    catch (_error) {
+        return null;
+    }
+}
+/**
+ * Configures routes for serving static assets (logo and favicon).
+ * @param app - The Express application.
+ */
+export function setupAssetEndpoints(app) {
+    // Serve the SVG favicon.
+    app.get("/favicon.svg", async (_req, res) => {
+        svgData ??= await loadAsset("prismcast.svg");
+        if (svgData) {
+            res.setHeader("Content-Type", "image/svg+xml");
+            res.setHeader("Cache-Control", "public, max-age=86400");
+            res.send(svgData);
+        }
+        else {
+            res.status(404).send("Not found");
+        }
+    });
+    // Serve the PNG favicon (alternative for browsers that prefer PNG).
+    app.get("/favicon.png", async (_req, res) => {
+        pngData ??= await loadAsset("prismcast.png");
+        if (pngData) {
+            res.setHeader("Content-Type", "image/png");
+            res.setHeader("Cache-Control", "public, max-age=86400");
+            res.send(pngData);
+        }
+        else {
+            res.status(404).send("Not found");
+        }
+    });
+    // Serve the PNG logo (used for apple-touch-icon which requires PNG format).
+    app.get("/logo.png", async (_req, res) => {
+        pngData ??= await loadAsset("prismcast.png");
+        if (pngData) {
+            res.setHeader("Content-Type", "image/png");
+            res.setHeader("Cache-Control", "public, max-age=86400");
+            res.send(pngData);
+        }
+        else {
+            res.status(404).send("Not found");
+        }
+    });
+    // Serve the SVG logo (used for the homepage header).
+    app.get("/logo.svg", async (_req, res) => {
+        svgData ??= await loadAsset("prismcast.svg");
+        if (svgData) {
+            res.setHeader("Content-Type", "image/svg+xml");
+            res.setHeader("Cache-Control", "public, max-age=86400");
+            res.send(svgData);
+        }
+        else {
+            res.status(404).send("Not found");
+        }
+    });
+}
+//# sourceMappingURL=assets.js.map

package/dist/routes/assets.js.map

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

package/dist/routes/auth.d.ts

@@ -0,0 +1,6 @@
+import type { Express } from "express";
+/**
+ * Sets up authentication routes for channel login.
+ * @param app - The Express application.
+ */
+export declare function setupAuthEndpoint(app: Express): void;

package/dist/routes/auth.js

@@ -0,0 +1,77 @@
+import { endLoginMode, getLoginStatus, startLoginMode } from "../browser/index.js";
+import { getResolvedChannel, resolveProviderKey } from "../config/providers.js";
+import { getDomainConfig } from "../config/sites.js";
+/**
+ * Sets up authentication routes for channel login.
+ * @param app - The Express application.
+ */
+export function setupAuthEndpoint(app) {
+    /**
+     * POST /auth/login - Start login mode for a channel or URL.
+     *
+     * Request body:
+     * - channel: The channel key (e.g., "nbc") - will be resolved to URL
+     * - url: Direct URL to navigate to
+     *
+     * One of channel or url must be provided.
+     */
+    app.post("/auth/login", async (req, res) => {
+        const body = req.body;
+        // Resolve URL from channel or use provided URL.
+        let url;
+        if (body.channel) {
+            // Resolve provider selection and get the channel. This respects both user-defined channel overrides and provider selections (e.g., Disney+ vs ESPN.com).
+            const resolvedKey = resolveProviderKey(body.channel);
+            const channel = getResolvedChannel(resolvedKey);
+            if (!channel) {
+                const response = { error: "Channel not found.", success: false };
+                res.status(404).json(response);
+                return;
+            }
+            url = channel.url;
+        }
+        else if (body.url) {
+            url = body.url;
+        }
+        if (!url) {
+            const response = { error: "Either channel or url must be provided.", success: false };
+            res.status(400).json(response);
+            return;
+        }
+        // Check if the domain has a login URL override. Some sites (e.g., Fox.com) show different authentication options on their homepage vs their player page.
+        const domainConfig = getDomainConfig(url);
+        if (domainConfig?.loginUrl) {
+            url = domainConfig.loginUrl;
+        }
+        // Start login mode.
+        const result = await startLoginMode(url);
+        if (result.success) {
+            const response = { message: "Login mode started. Complete authentication in the browser window.", success: true };
+            res.json(response);
+        }
+        else {
+            const response = { error: result.error, success: false };
+            res.status(409).json(response);
+        }
+    });
+    /**
+     * POST /auth/done - End login mode.
+     *
+     * Called when the user clicks "Done" in the web UI to indicate authentication is complete.
+     */
+    app.post("/auth/done", async (_req, res) => {
+        await endLoginMode();
+        const response = { message: "Login mode ended.", success: true };
+        res.json(response);
+    });
+    /**
+     * GET /auth/status - Get current login status.
+     *
+     * Returns whether login mode is active and details about the current login session.
+     */
+    app.get("/auth/status", (_req, res) => {
+        const status = getLoginStatus();
+        res.json(status);
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/routes/auth.js.map

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

package/dist/routes/channels.d.ts

@@ -0,0 +1,6 @@
+import type { Express } from "express";
+/**
+ * Creates an endpoint to list all channels with their source and enabled status.
+ * @param app - The Express application.
+ */
+export declare function setupChannelsEndpoint(app: Express): void;

package/dist/routes/channels.js

@@ -0,0 +1,40 @@
+import { getChannelListing } from "../config/userChannels.js";
+/**
+ * Creates an endpoint to list all channels with their source and enabled status.
+ * @param app - The Express application.
+ */
+export function setupChannelsEndpoint(app) {
+    app.get("/channels", (_req, res) => {
+        const listing = getChannelListing();
+        const channels = [];
+        for (const entry of listing) {
+            // Build the response entry with required fields. Canonical channels always have name; fallback to key is defensive.
+            const channelEntry = {
+                enabled: entry.enabled,
+                key: entry.key,
+                name: entry.channel.name ?? entry.key,
+                source: entry.source,
+                url: entry.channel.url
+            };
+            // Add optional fields only when present.
+            if (entry.channel.channelNumber !== undefined) {
+                channelEntry.channelNumber = entry.channel.channelNumber;
+            }
+            if (entry.channel.channelSelector) {
+                channelEntry.channelSelector = entry.channel.channelSelector;
+            }
+            if (entry.channel.profile) {
+                channelEntry.profile = entry.channel.profile;
+            }
+            if (entry.channel.stationId) {
+                channelEntry.stationId = entry.channel.stationId;
+            }
+            channels.push(channelEntry);
+        }
+        res.json({
+            channels,
+            count: channels.length
+        });
+    });
+}
+//# sourceMappingURL=channels.js.map

package/dist/routes/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/routes/channels.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAuC9D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAEhD,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAa,EAAE,GAAa,EAAQ,EAAE;QAE1D,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAmB,EAAE,CAAC;QAEpC,KAAI,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAE3B,oHAAoH;YACpH,MAAM,YAAY,GAAiB;gBAEjC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG;gBACrC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG;aACvB,CAAC;YAEF,yCAAyC;YACzC,IAAG,KAAK,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBAE7C,YAAY,CAAC,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;YAC3D,CAAC;YAED,IAAG,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;gBAEjC,YAAY,CAAC,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;YAC/D,CAAC;YAED,IAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAEzB,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAC/C,CAAC;YAED,IAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAE3B,YAAY,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACnD,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9B,CAAC;QAED,GAAG,CAAC,IAAI,CAAC;YAEP,QAAQ;YACR,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/routes/components.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Alert type for styling.
+ */
+export type AlertType = "error" | "success" | "warning";
+/**
+ * Generates an alert box HTML with title and message.
+ * @param type - The alert type (success, error, warning).
+ * @param title - The alert title.
+ * @param message - The alert message (can include HTML).
+ * @param escapeMessage - Whether to escape the message HTML (default true).
+ * @returns HTML string for the alert box.
+ */
+export declare function generateAlert(type: AlertType, title: string, message: string, escapeMessage?: boolean): string;
+/**
+ * Generates a simple alert box without a title.
+ * @param type - The alert type (success, error, warning).
+ * @param message - The alert message.
+ * @returns HTML string for the alert box.
+ */
+export declare function generateSimpleAlert(type: AlertType, message: string): string;
+/**
+ * Button variant for styling.
+ */
+export type ButtonVariant = "danger" | "delete" | "edit" | "primary" | "secondary";
+/**
+ * Button size for styling.
+ */
+export type ButtonSize = "md" | "sm";
+/**
+ * Options for button generation.
+ */
+export interface ButtonOptions {
+    className?: string;
+    disabled?: boolean;
+    id?: string;
+    onclick?: string;
+    size?: ButtonSize;
+    type?: "button" | "reset" | "submit";
+    variant: ButtonVariant;
+}
+/**
+ * Generates a button HTML element.
+ * @param label - The button label text.
+ * @param options - Button configuration options.
+ * @returns HTML string for the button.
+ */
+export declare function generateButton(label: string, options: ButtonOptions): string;
+/**
+ * Badge variant for styling.
+ */
+export type BadgeVariant = "builtin" | "custom" | "env" | "flag" | "override";
+/**
+ * Generates a badge HTML element.
+ * @param label - The badge label text.
+ * @param variant - The badge style variant.
+ * @returns HTML string for the badge.
+ */
+export declare function generateBadge(label: string, variant: BadgeVariant): string;
+/**
+ * Generates a status indicator (colored dot with label).
+ * @param status - The status type (healthy, error, etc.).
+ * @param label - The label text.
+ * @returns HTML string for the status indicator.
+ */
+export declare function generateStatusIndicator(status: string, label: string): string;
+/**
+ * Options for text input generation.
+ */
+export interface TextInputOptions {
+    disabled?: boolean;
+    hint?: string;
+    id: string;
+    max?: number;
+    min?: number;
+    name: string;
+    pattern?: string;
+    placeholder?: string;
+    required?: boolean;
+    step?: string;
+    type?: string;
+    value?: string;
+}
+/**
+ * Generates a form row with label and text input.
+ * @param label - The input label.
+ * @param options - Input configuration options.
+ * @returns HTML string for the form row.
+ */
+export declare function generateTextInput(label: string, options: TextInputOptions): string;
+/**
+ * Option item for select dropdown.
+ */
+export interface SelectOption {
+    label: string;
+    selected?: boolean;
+    value: string;
+}
+/**
+ * Options for select dropdown generation.
+ */
+export interface SelectOptions {
+    disabled?: boolean;
+    hint?: string;
+    id: string;
+    name: string;
+    options: SelectOption[];
+    required?: boolean;
+}
+/**
+ * Generates a form row with label and select dropdown.
+ * @param label - The select label.
+ * @param config - Select configuration options.
+ * @returns HTML string for the form row.
+ */
+export declare function generateSelect(label: string, config: SelectOptions): string;
+/**
+ * Generates a code block with optional copy button.
+ * @param content - The code content.
+ * @param showCopyButton - Whether to show a copy button.
+ * @param copyButtonId - ID for the copy button (required if showCopyButton is true).
+ * @returns HTML string for the code block.
+ */
+export declare function generateCodeBlock(content: string, showCopyButton?: boolean, copyButtonId?: string): string;
+/**
+ * Generates a section container with optional heading.
+ * @param content - The section content (HTML).
+ * @param heading - Optional section heading.
+ * @param headingLevel - Heading level (2 or 3, default 3).
+ * @returns HTML string for the section.
+ */
+export declare function generateSection(content: string, heading?: string, headingLevel?: 2 | 3): string;
+/**
+ * Generates a panel header with title and optional action button.
+ * @param title - The panel title.
+ * @param actionHtml - Optional action button HTML (not escaped).
+ * @returns HTML string for the panel header.
+ */
+export declare function generatePanelHeader(title: string, actionHtml?: string): string;