@bnhf/prismcast 1.3.4-2026.2.19

package/dist/service/generators.js

@@ -0,0 +1,432 @@
+import { SERVICE_ID, SERVICE_NAME, getLogsDirectory, getNodeExecutablePath, getPlatform, getPrismCastEntryPoint, getPrismCastWorkingDirectory, getServiceFileDirectory, getServiceFilePath } from "../utils/platform.js";
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+const { promises: fsPromises } = fs;
+/* Generates a launchd property list (plist) file for macOS. The plist is installed to ~/Library/LaunchAgents/ and configured with:
+ * - RunAtLoad: Start when user logs in
+ * - KeepAlive: Restart automatically if the process exits
+ * - StandardOutPath/StandardErrorPath: Capture stdout/stderr to ~/.prismcast/logs/
+ */
+/**
+ * Escapes a string for use in XML by replacing special characters with entities.
+ * @param str - The string to escape.
+ * @returns The escaped string safe for XML.
+ */
+function escapeXml(str) {
+    return str
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/**
+ * Creates a launchd service generator for macOS.
+ * @returns A ServiceGenerator for launchd.
+ */
+function createLaunchdGenerator() {
+    return {
+        generate(options) {
+            const nodePath = getNodeExecutablePath();
+            const entryPoint = getPrismCastEntryPoint();
+            const workingDir = getPrismCastWorkingDirectory();
+            const logsDir = getLogsDirectory();
+            // Build environment variables section. Always include PRISMCAST_SERVICE=1 for service detection.
+            const envVars = { PRISMCAST_SERVICE: "1", ...options.envVars };
+            // Generate the environment dictionary entries.
+            const envEntries = Object.entries(envVars)
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([key, value]) => [
+                "      <key>" + escapeXml(key) + "</key>",
+                "      <string>" + escapeXml(value) + "</string>"
+            ].join("\n"))
+                .join("\n");
+            // Generate the plist content.
+            return [
+                "<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
+                "<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">",
+                "<plist version=\"1.0\">",
+                "<dict>",
+                "  <key>Label</key>",
+                "  <string>" + escapeXml(SERVICE_ID) + "</string>",
+                "",
+                "  <key>ProgramArguments</key>",
+                "  <array>",
+                "    <string>" + escapeXml(nodePath) + "</string>",
+                "    <string>" + escapeXml(entryPoint) + "</string>",
+                "  </array>",
+                "",
+                "  <key>WorkingDirectory</key>",
+                "  <string>" + escapeXml(workingDir) + "</string>",
+                "",
+                "  <key>EnvironmentVariables</key>",
+                "  <dict>",
+                envEntries,
+                "  </dict>",
+                "",
+                "  <key>RunAtLoad</key>",
+                "  <true/>",
+                "",
+                "  <key>KeepAlive</key>",
+                "  <true/>",
+                "",
+                "  <key>StandardOutPath</key>",
+                "  <string>" + escapeXml(logsDir + "/service-stdout.log") + "</string>",
+                "",
+                "  <key>StandardErrorPath</key>",
+                "  <string>" + escapeXml(logsDir + "/service-stderr.log") + "</string>",
+                "</dict>",
+                "</plist>",
+                ""
+            ].join("\n");
+        },
+        getInstallPath() {
+            return getServiceFilePath();
+        },
+        async install(content) {
+            const installPath = this.getInstallPath();
+            const installDir = getServiceFileDirectory();
+            const logsDir = getLogsDirectory();
+            // Ensure directories exist.
+            await fsPromises.mkdir(installDir, { recursive: true });
+            await fsPromises.mkdir(logsDir, { recursive: true });
+            // Write the plist file.
+            await fsPromises.writeFile(installPath, content, "utf8");
+            // Load the service with launchctl.
+            try {
+                execSync("launchctl load -w \"" + installPath + "\"", { stdio: "pipe" });
+            }
+            catch {
+                // If load fails, try to unload first then reload (handles reinstall case).
+                try {
+                    execSync("launchctl unload \"" + installPath + "\"", { stdio: "pipe" });
+                }
+                catch {
+                    // Ignore unload errors.
+                }
+                execSync("launchctl load -w \"" + installPath + "\"", { stdio: "pipe" });
+            }
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async isInstalled() {
+            return fs.existsSync(this.getInstallPath());
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async isRunning() {
+            try {
+                // Use launchctl list | grep to get tab-separated output: "PID\tStatus\tLabel". The grep exits non-zero if not found.
+                const result = execSync("launchctl list | grep " + SERVICE_ID, { encoding: "utf8", stdio: "pipe" });
+                // Parse the PID from the first column. Format: "12345\t0\tcom.github.hjdhjd.prismcast" or "-\t0\t..." if loaded but not running.
+                const pid = result.trim().split("\t")[0];
+                // PID is "-" when loaded but process not running, or a number when actually running.
+                return (pid !== "-") && !isNaN(Number(pid));
+            }
+            catch {
+                return false;
+            }
+        },
+        platform: "darwin",
+        serviceManager: "launchd",
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async start() {
+            const installPath = this.getInstallPath();
+            // Load the plist if not already loaded. This is idempotent — if already loaded, launchd logs a warning but doesn't fail.
+            try {
+                execSync("launchctl load -w \"" + installPath + "\"", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore — may already be loaded.
+            }
+            // Explicitly start the service. This handles the case where the plist is loaded but the process isn't running (e.g., after a crash).
+            execSync("launchctl start " + SERVICE_ID, { stdio: "pipe" });
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async stop() {
+            const installPath = this.getInstallPath();
+            execSync("launchctl unload \"" + installPath + "\"", { stdio: "pipe" });
+        },
+        async uninstall() {
+            const installPath = this.getInstallPath();
+            // Unload the service first.
+            try {
+                execSync("launchctl unload \"" + installPath + "\"", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore errors if service wasn't loaded.
+            }
+            // Remove the plist file.
+            if (fs.existsSync(installPath)) {
+                await fsPromises.unlink(installPath);
+            }
+        }
+    };
+}
+/* Generates a systemd user service unit file for Linux. The unit is installed to ~/.config/systemd/user/ and configured with:
+ * - Restart=always: Restart automatically if the process exits
+ * - RestartSec=5: Wait 5 seconds before restarting
+ * - WantedBy=default.target: Start when user session begins
+ */
+/**
+ * Creates a systemd service generator for Linux.
+ * @returns A ServiceGenerator for systemd.
+ */
+function createSystemdGenerator() {
+    return {
+        generate(options) {
+            const nodePath = getNodeExecutablePath();
+            const entryPoint = getPrismCastEntryPoint();
+            const workingDir = getPrismCastWorkingDirectory();
+            // Build environment variables. Always include PRISMCAST_SERVICE=1 for service detection.
+            const envVars = { PRISMCAST_SERVICE: "1", ...options.envVars };
+            // Generate Environment= lines, sorted alphabetically.
+            const envLines = Object.entries(envVars)
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([key, value]) => "Environment=\"" + key + "=" + value + "\"")
+                .join("\n");
+            // Generate the unit file content.
+            return [
+                "[Unit]",
+                "Description=" + SERVICE_NAME + " Streaming Server",
+                "After=network.target",
+                "",
+                "[Service]",
+                "Type=simple",
+                "ExecStart=" + nodePath + " " + entryPoint,
+                "WorkingDirectory=" + workingDir,
+                "Restart=always",
+                "RestartSec=5",
+                envLines,
+                "",
+                "[Install]",
+                "WantedBy=default.target",
+                ""
+            ].join("\n");
+        },
+        getInstallPath() {
+            return getServiceFilePath();
+        },
+        async install(content) {
+            const installPath = this.getInstallPath();
+            const installDir = getServiceFileDirectory();
+            const logsDir = getLogsDirectory();
+            // Ensure directories exist.
+            await fsPromises.mkdir(installDir, { recursive: true });
+            await fsPromises.mkdir(logsDir, { recursive: true });
+            // Write the unit file.
+            await fsPromises.writeFile(installPath, content, "utf8");
+            // Reload systemd to pick up the new unit file.
+            try {
+                execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore if systemctl isn't available (shouldn't happen on systemd systems).
+            }
+            // Enable and start the service.
+            execSync("systemctl --user enable prismcast.service", { stdio: "pipe" });
+            execSync("systemctl --user start prismcast.service", { stdio: "pipe" });
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async isInstalled() {
+            return fs.existsSync(this.getInstallPath());
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async isRunning() {
+            try {
+                const result = execSync("systemctl --user is-active prismcast.service", { encoding: "utf8", stdio: "pipe" });
+                return result.trim() === "active";
+            }
+            catch {
+                return false;
+            }
+        },
+        platform: "linux",
+        serviceManager: "systemd",
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async start() {
+            execSync("systemctl --user start prismcast.service", { stdio: "pipe" });
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async stop() {
+            execSync("systemctl --user stop prismcast.service", { stdio: "pipe" });
+        },
+        async uninstall() {
+            const installPath = this.getInstallPath();
+            // Stop and disable the service.
+            try {
+                execSync("systemctl --user stop prismcast.service", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore if not running.
+            }
+            try {
+                execSync("systemctl --user disable prismcast.service", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore if not enabled.
+            }
+            // Remove the unit file.
+            if (fs.existsSync(installPath)) {
+                await fsPromises.unlink(installPath);
+            }
+            // Reload systemd.
+            try {
+                execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore.
+            }
+        }
+    };
+}
+/* Uses Windows Task Scheduler via schtasks.exe to create a task that runs at user logon. Unlike launchd and systemd, Task Scheduler doesn't have built-in process
+ * supervision, so we configure the task to restart on failure. A marker file is used to track installation state.
+ */
+/**
+ * Creates a Windows Task Scheduler generator.
+ * @returns A ServiceGenerator for Windows Task Scheduler.
+ */
+function createWindowsSchedulerGenerator() {
+    const taskName = SERVICE_NAME;
+    return {
+        generate(options) {
+            const nodePath = getNodeExecutablePath();
+            const entryPoint = getPrismCastEntryPoint();
+            const workingDir = getPrismCastWorkingDirectory();
+            // Build environment variables for the command. We'll set them in the task action using cmd /c set.
+            const envVars = { PRISMCAST_SERVICE: "1", ...options.envVars };
+            // Generate environment variable SET commands.
+            const envSets = Object.entries(envVars)
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([key, value]) => "set \"" + key + "=" + value + "\"")
+                .join(" && ");
+            // Return the command to run (used by install).
+            return "cmd /c \"cd /d \"" + workingDir + "\" && " + envSets + " && \"" + nodePath + "\" \"" + entryPoint + "\"\"";
+        },
+        getInstallPath() {
+            return getServiceFilePath();
+        },
+        async install(content) {
+            const installPath = this.getInstallPath();
+            const installDir = getServiceFileDirectory();
+            const logsDir = getLogsDirectory();
+            // Ensure directories exist.
+            await fsPromises.mkdir(installDir, { recursive: true });
+            await fsPromises.mkdir(logsDir, { recursive: true });
+            // Delete existing task if it exists.
+            try {
+                execSync("schtasks /Delete /TN \"" + taskName + "\" /F", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore if task doesn't exist.
+            }
+            // Create the scheduled task. The /SC ONLOGON runs at user logon. /RL HIGHEST gives elevated privileges if needed.
+            const createCmd = "schtasks /Create /TN \"" + taskName + "\" /TR \"" + content + "\" /SC ONLOGON /RL HIGHEST /F";
+            execSync(createCmd, { stdio: "pipe" });
+            // Write marker file to indicate installation.
+            await fsPromises.writeFile(installPath, "Installed at " + new Date().toISOString() + "\n", "utf8");
+            // Start the task immediately.
+            try {
+                execSync("schtasks /Run /TN \"" + taskName + "\"", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore if start fails.
+            }
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async isInstalled() {
+            try {
+                execSync("schtasks /Query /TN \"" + taskName + "\"", { stdio: "pipe" });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async isRunning() {
+            try {
+                const result = execSync("schtasks /Query /TN \"" + taskName + "\" /FO CSV /NH", { encoding: "utf8", stdio: "pipe" });
+                return result.includes("Running");
+            }
+            catch {
+                return false;
+            }
+        },
+        platform: "windows",
+        serviceManager: "windows-scheduler",
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async start() {
+            execSync("schtasks /Run /TN \"" + taskName + "\"", { stdio: "pipe" });
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async stop() {
+            execSync("schtasks /End /TN \"" + taskName + "\"", { stdio: "pipe" });
+        },
+        async uninstall() {
+            const installPath = this.getInstallPath();
+            // Delete the scheduled task.
+            try {
+                execSync("schtasks /Delete /TN \"" + taskName + "\" /F", { stdio: "pipe" });
+            }
+            catch {
+                // Ignore if task doesn't exist.
+            }
+            // Remove marker file.
+            if (fs.existsSync(installPath)) {
+                await fsPromises.unlink(installPath);
+            }
+        }
+    };
+}
+/* Returns the appropriate service generator for the current platform.
+ */
+/**
+ * Returns the service generator for the current platform.
+ * @returns The appropriate ServiceGenerator, or null if the platform is not supported.
+ */
+export function getServiceGenerator() {
+    switch (getPlatform()) {
+        case "darwin": {
+            return createLaunchdGenerator();
+        }
+        case "linux": {
+            return createSystemdGenerator();
+        }
+        case "windows": {
+            return createWindowsSchedulerGenerator();
+        }
+        default: {
+            return null;
+        }
+    }
+}
+/**
+ * Collects environment variables that should be persisted in the service file. This includes settings that differ from defaults or have been explicitly configured.
+ * @returns A record of environment variable names to values.
+ */
+export function collectServiceEnvironment() {
+    const envVars = {};
+    // Always capture PATH so that FFmpeg and other tools can be found. Service managers like launchd use a minimal PATH by default (/usr/bin:/bin:/usr/sbin:/sbin)
+    // which doesn't include Homebrew or other common tool locations.
+    if (process.env.PATH) {
+        envVars.PATH = process.env.PATH;
+    }
+    // Include key settings if they're set via environment. These are the settings most likely to be intentionally configured.
+    const keysToCapture = [
+        "AUDIO_BITRATE",
+        "CAPTURE_MODE",
+        "CHROME_BIN",
+        "FRAME_RATE",
+        "HOST",
+        "QUALITY_PRESET",
+        "VIDEO_BITRATE"
+    ];
+    for (const key of keysToCapture) {
+        const value = process.env[key];
+        if (value !== undefined) {
+            envVars[key] = value;
+        }
+    }
+    return envVars;
+}
+//# sourceMappingURL=generators.js.map

package/dist/service/generators.js.map

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

package/dist/service/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./commands.js";
+export * from "./generators.js";

package/dist/service/index.js

@@ -0,0 +1,7 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * index.ts: Service module exports for PrismCast.
+ */
+export * from "./commands.js";
+export * from "./generators.js";
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/streaming/clients.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Client type classification by protocol.
+ */
+export type ClientType = "hls" | "mpegts";
+/**
+ * Count of clients for a specific client type.
+ */
+export interface ClientTypeCount {
+    count: number;
+    type: ClientType;
+}
+/**
+ * Aggregated client summary for a stream.
+ */
+export interface ClientSummary {
+    clients: ClientTypeCount[];
+    total: number;
+}
+/**
+ * Registers or refreshes a client for a stream. For HLS clients, this updates the lastSeen timestamp to prevent TTL expiration. For MPEG-TS clients, this creates
+ * the client entry on connect. Guards against registration after stream termination by verifying the stream still exists in the registry.
+ * @param streamId - The numeric stream ID.
+ * @param clientAddress - The raw client IP address.
+ * @param protocol - The protocol ("hls" or "mpegts").
+ */
+export declare function registerClient(streamId: number, clientAddress: string, protocol: ClientType): void;
+/**
+ * Unregisters a client from a stream. Used for MPEG-TS clients on disconnect. HLS clients are not explicitly unregistered — they expire via TTL cleanup in
+ * getClientSummary(). If the client map has already been cleared (e.g., during stream termination), this is a no-op.
+ * @param streamId - The numeric stream ID.
+ * @param clientAddress - The raw client IP address.
+ * @param protocol - The protocol ("hls" or "mpegts").
+ */
+export declare function unregisterClient(streamId: number, clientAddress: string, protocol: ClientType): void;
+/**
+ * Returns an aggregated client summary for a stream. Performs lazy TTL cleanup of stale HLS clients as a side effect — entries that have not been refreshed within
+ * HLS_CLIENT_TTL are removed. MPEG-TS clients are managed explicitly via register/unregister and are never expired by TTL.
+ *
+ * Called by the monitor every ~2 seconds during status emission.
+ * @param streamId - The numeric stream ID.
+ * @returns The client summary with total count and per-type breakdown.
+ */
+export declare function getClientSummary(streamId: number): ClientSummary;
+/**
+ * Removes all client tracking data for a stream. Called during stream termination to prevent memory leaks.
+ * @param streamId - The numeric stream ID.
+ */
+export declare function clearClients(streamId: number): void;

package/dist/streaming/clients.js

@@ -0,0 +1,114 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * clients.ts: Client tracking for PrismCast streams.
+ */
+import { getStream } from "./registry.js";
+// Constants.
+// HLS clients that have not sent a playlist request within this window are considered disconnected and removed during the next summary query.
+const HLS_CLIENT_TTL = 30000;
+// State.
+// Per-stream client maps. Outer key is numeric stream ID, inner key is a composite string "protocol:address".
+const clientMaps = new Map();
+// Registration.
+/**
+ * Normalizes an IP address by stripping the IPv6-mapped IPv4 prefix. This prevents the same client from appearing twice when Express reports the address as
+ * "::ffff:192.168.1.50" on some requests and "192.168.1.50" on others.
+ * @param address - The raw IP address string.
+ * @returns The normalized address.
+ */
+function normalizeAddress(address) {
+    return address.startsWith("::ffff:") ? address.slice(7) : address;
+}
+/**
+ * Registers or refreshes a client for a stream. For HLS clients, this updates the lastSeen timestamp to prevent TTL expiration. For MPEG-TS clients, this creates
+ * the client entry on connect. Guards against registration after stream termination by verifying the stream still exists in the registry.
+ * @param streamId - The numeric stream ID.
+ * @param clientAddress - The raw client IP address.
+ * @param protocol - The protocol ("hls" or "mpegts").
+ */
+export function registerClient(streamId, clientAddress, protocol) {
+    // Guard against registration after stream termination. If the stream no longer exists in the registry, skip silently to prevent orphaned client entries.
+    if (!getStream(streamId)) {
+        return;
+    }
+    const address = normalizeAddress(clientAddress);
+    const key = protocol + ":" + address;
+    let clients = clientMaps.get(streamId);
+    if (!clients) {
+        clients = new Map();
+        clientMaps.set(streamId, clients);
+    }
+    clients.set(key, {
+        clientAddress: address,
+        lastSeen: Date.now(),
+        protocol
+    });
+}
+/**
+ * Unregisters a client from a stream. Used for MPEG-TS clients on disconnect. HLS clients are not explicitly unregistered — they expire via TTL cleanup in
+ * getClientSummary(). If the client map has already been cleared (e.g., during stream termination), this is a no-op.
+ * @param streamId - The numeric stream ID.
+ * @param clientAddress - The raw client IP address.
+ * @param protocol - The protocol ("hls" or "mpegts").
+ */
+export function unregisterClient(streamId, clientAddress, protocol) {
+    const clients = clientMaps.get(streamId);
+    if (!clients) {
+        return;
+    }
+    const address = normalizeAddress(clientAddress);
+    const key = protocol + ":" + address;
+    clients.delete(key);
+    // Clean up empty maps to prevent memory accumulation from streams with no remaining clients.
+    if (clients.size === 0) {
+        clientMaps.delete(streamId);
+    }
+}
+// Summary.
+/**
+ * Returns an aggregated client summary for a stream. Performs lazy TTL cleanup of stale HLS clients as a side effect — entries that have not been refreshed within
+ * HLS_CLIENT_TTL are removed. MPEG-TS clients are managed explicitly via register/unregister and are never expired by TTL.
+ *
+ * Called by the monitor every ~2 seconds during status emission.
+ * @param streamId - The numeric stream ID.
+ * @returns The client summary with total count and per-type breakdown.
+ */
+export function getClientSummary(streamId) {
+    const clients = clientMaps.get(streamId);
+    if (!clients) {
+        return { clients: [], total: 0 };
+    }
+    // Expire stale HLS clients.
+    const now = Date.now();
+    for (const [key, client] of clients) {
+        if ((client.protocol === "hls") && ((now - client.lastSeen) > HLS_CLIENT_TTL)) {
+            clients.delete(key);
+        }
+    }
+    // Clean up empty maps.
+    if (clients.size === 0) {
+        clientMaps.delete(streamId);
+        return { clients: [], total: 0 };
+    }
+    // Aggregate by protocol.
+    const typeCounts = new Map();
+    for (const client of clients.values()) {
+        typeCounts.set(client.protocol, (typeCounts.get(client.protocol) ?? 0) + 1);
+    }
+    // Build sorted result.
+    const result = [];
+    for (const [type, count] of typeCounts) {
+        result.push({ count, type });
+    }
+    result.sort((a, b) => a.type.localeCompare(b.type));
+    return { clients: result, total: clients.size };
+}
+// Cleanup.
+/**
+ * Removes all client tracking data for a stream. Called during stream termination to prevent memory leaks.
+ * @param streamId - The numeric stream ID.
+ */
+export function clearClients(streamId) {
+    clientMaps.delete(streamId);
+}
+//# sourceMappingURL=clients.js.map

package/dist/streaming/clients.js.map

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