@bnhf/prismcast 1.3.4-2026.2.19

package/dist/service/commands.js

@@ -0,0 +1,391 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * commands.ts: Service command handlers for PrismCast CLI.
+ */
+import { DEFAULTS, loadUserConfig } from "../config/userConfig.js";
+import { SERVICE_NAME, getPlatform, getServiceFilePath } from "../utils/platform.js";
+import { collectServiceEnvironment, getServiceGenerator } from "./generators.js";
+/* These handlers implement the `prismcast service` subcommands for installing, uninstalling, and checking the status of PrismCast as a system service. Each handler
+ * prints its output directly to the console and exits with an appropriate status code.
+ */
+/**
+ * Prints a message to stdout.
+ * @param message - The message to print.
+ */
+function print(message) {
+    // eslint-disable-next-line no-console
+    console.log(message);
+}
+/**
+ * Prints an error message to stderr.
+ * @param message - The error message to print.
+ */
+function printError(message) {
+    // eslint-disable-next-line no-console
+    console.error(message);
+}
+/**
+ * Formats a duration in seconds to a human-readable string.
+ * @param seconds - The duration in seconds.
+ * @returns Formatted duration (e.g., "45s", "2m 15s", "1h 23m").
+ */
+function formatDuration(seconds) {
+    if (seconds < 60) {
+        return String(seconds) + "s";
+    }
+    if (seconds < 3600) {
+        const minutes = Math.floor(seconds / 60);
+        const secs = seconds % 60;
+        return secs > 0 ? String(minutes) + "m " + String(secs) + "s" : String(minutes) + "m";
+    }
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    return minutes > 0 ? String(hours) + "h " + String(minutes) + "m" : String(hours) + "h";
+}
+/**
+ * Fetches active stream information from the running server.
+ * @param port - The server port to connect to.
+ * @returns Stream data on success, null if the server is unreachable.
+ */
+async function fetchActiveStreams(port) {
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => { controller.abort(); }, 3000);
+        const response = await fetch("http://127.0.0.1:" + String(port) + "/streams", { signal: controller.signal });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            return null;
+        }
+        return await response.json();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Gets the configured server port from user config or defaults.
+ * @returns The server port.
+ */
+async function getServerPort() {
+    const result = await loadUserConfig();
+    return result.config.server?.port ?? DEFAULTS.server.port;
+}
+/**
+ * Prints usage information for the service subcommand.
+ */
+export function printServiceUsage() {
+    print("Usage: prismcast service <command> [options]");
+    print("");
+    print("Commands:");
+    print("  install [--force]   Install " + SERVICE_NAME + " as a user service");
+    print("  uninstall           Remove " + SERVICE_NAME + " service");
+    print("  start               Start the " + SERVICE_NAME + " service");
+    print("  stop                Stop the " + SERVICE_NAME + " service");
+    print("  restart             Restart the " + SERVICE_NAME + " service");
+    print("  status              Show service installation and running status");
+    print("");
+    print("Options:");
+    print("  --force             Force reinstall even if already installed");
+    print("");
+    print("The service runs as the current user and starts automatically at login.");
+    print("Configuration is read from ~/.prismcast/config.json.");
+}
+/**
+ * Handles the `service install` command. Generates and installs a service file for the current platform, then starts the service.
+ * @param force - If true, reinstall even if already installed.
+ * @returns Exit code (0 for success, 1 for error).
+ */
+export async function handleInstall(force) {
+    const generator = getServiceGenerator();
+    if (!generator) {
+        printError("Error: Service installation is not supported on this platform (" + getPlatform() + ").");
+        return 1;
+    }
+    // Check if already installed.
+    const isInstalled = await generator.isInstalled();
+    if (isInstalled && !force) {
+        printError("Error: " + SERVICE_NAME + " service is already installed.");
+        printError("Use --force to reinstall, or run 'prismcast service uninstall' first.");
+        return 1;
+    }
+    print("Installing " + SERVICE_NAME + " service...");
+    print("");
+    // Collect environment variables to persist in the service file.
+    const envVars = collectServiceEnvironment();
+    // Generate and install the service.
+    try {
+        const content = generator.generate({ envVars });
+        await generator.install(content);
+    }
+    catch (error) {
+        printError("Error: Failed to install service.");
+        if (error instanceof Error) {
+            printError(error.message);
+        }
+        return 1;
+    }
+    print("Service installed successfully.");
+    print("");
+    print("Service file: " + getServiceFilePath());
+    print("Service manager: " + generator.serviceManager);
+    print("");
+    // Print platform-specific instructions.
+    switch (generator.serviceManager) {
+        case "launchd": {
+            print("The service is now running and will start automatically at login.");
+            print("");
+            print("Useful commands:");
+            print("  View logs:        tail -f ~/.prismcast/prismcast.log");
+            print("  View service log: tail -f ~/.prismcast/service-stdout.log");
+            print("  Stop service:     prismcast service stop");
+            print("  Start service:    prismcast service start");
+            print("  Status:           prismcast service status");
+            break;
+        }
+        case "systemd": {
+            print("The service is now running and will start automatically at login.");
+            print("");
+            print("Useful commands:");
+            print("  View logs:     tail -f ~/.prismcast/prismcast.log");
+            print("  View journal:  journalctl --user -u prismcast -f");
+            print("  Stop service:  prismcast service stop");
+            print("  Start service: prismcast service start");
+            print("  Status:        prismcast service status");
+            break;
+        }
+        case "windows-scheduler": {
+            print("The service is now running and will start automatically at login.");
+            print("");
+            print("Useful commands:");
+            print("  View logs:     type %USERPROFILE%\\.prismcast\\prismcast.log");
+            print("  Stop service:  prismcast service stop");
+            print("  Start service: prismcast service start");
+            print("  Status:        prismcast service status");
+            break;
+        }
+    }
+    return 0;
+}
+/**
+ * Handles the `service uninstall` command. Stops and removes the service.
+ * @returns Exit code (0 for success, 1 for error).
+ */
+export async function handleUninstall() {
+    const generator = getServiceGenerator();
+    if (!generator) {
+        printError("Error: Service management is not supported on this platform (" + getPlatform() + ").");
+        return 1;
+    }
+    // Check if installed.
+    const isInstalled = await generator.isInstalled();
+    if (!isInstalled) {
+        printError("Error: " + SERVICE_NAME + " service is not installed.");
+        return 1;
+    }
+    print("Uninstalling " + SERVICE_NAME + " service...");
+    try {
+        await generator.uninstall();
+    }
+    catch (error) {
+        printError("Error: Failed to uninstall service.");
+        if (error instanceof Error) {
+            printError(error.message);
+        }
+        return 1;
+    }
+    print("Service uninstalled successfully.");
+    print("");
+    print("Note: Configuration and data files in ~/.prismcast/ have been preserved.");
+    print("To remove all data, delete the ~/.prismcast directory manually.");
+    return 0;
+}
+/**
+ * Handles the `service start` command. Starts the service if it is installed but not running.
+ * @returns Exit code (0 for success, 1 for error).
+ */
+export async function handleStart() {
+    const generator = getServiceGenerator();
+    if (!generator) {
+        printError("Error: Service management is not supported on this platform (" + getPlatform() + ").");
+        return 1;
+    }
+    // Check if installed.
+    const isInstalled = await generator.isInstalled();
+    if (!isInstalled) {
+        printError("Error: " + SERVICE_NAME + " service is not installed.");
+        printError("Run 'prismcast service install' first.");
+        return 1;
+    }
+    // Check if already running.
+    const isRunning = await generator.isRunning();
+    if (isRunning) {
+        print(SERVICE_NAME + " service is already running.");
+        return 0;
+    }
+    print("Starting " + SERVICE_NAME + " service...");
+    try {
+        await generator.start();
+    }
+    catch (error) {
+        printError("Error: Failed to start service.");
+        if (error instanceof Error) {
+            printError(error.message);
+        }
+        return 1;
+    }
+    print("Service started successfully.");
+    return 0;
+}
+/**
+ * Handles the `service stop` command. Stops the service if it is running.
+ * @returns Exit code (0 for success, 1 for error).
+ */
+export async function handleStop() {
+    const generator = getServiceGenerator();
+    if (!generator) {
+        printError("Error: Service management is not supported on this platform (" + getPlatform() + ").");
+        return 1;
+    }
+    // Check if installed.
+    const isInstalled = await generator.isInstalled();
+    if (!isInstalled) {
+        printError("Error: " + SERVICE_NAME + " service is not installed.");
+        return 1;
+    }
+    // Check if running.
+    const isRunning = await generator.isRunning();
+    if (!isRunning) {
+        print(SERVICE_NAME + " service is not running.");
+        return 0;
+    }
+    print("Stopping " + SERVICE_NAME + " service...");
+    try {
+        await generator.stop();
+    }
+    catch (error) {
+        printError("Error: Failed to stop service.");
+        if (error instanceof Error) {
+            printError(error.message);
+        }
+        return 1;
+    }
+    print("Service stopped successfully.");
+    return 0;
+}
+/**
+ * Handles the `service restart` command. Stops the service if running, then starts it.
+ * @returns Exit code (0 for success, 1 for error).
+ */
+export async function handleRestart() {
+    // Stop the service (ignores "not running" state).
+    const stopResult = await handleStop();
+    if (stopResult !== 0) {
+        return stopResult;
+    }
+    // Start the service.
+    return handleStart();
+}
+/**
+ * Handles the `service status` command. Shows the current service installation and running status.
+ * @returns Exit code (0 for success).
+ */
+export async function handleStatus() {
+    const generator = getServiceGenerator();
+    if (!generator) {
+        print(SERVICE_NAME + " Service Status");
+        print("─".repeat(40));
+        print("Platform:        " + getPlatform());
+        print("Service support: Not available");
+        print("");
+        print("Service installation is not supported on this platform.");
+        return 0;
+    }
+    const isInstalled = await generator.isInstalled();
+    const isRunning = isInstalled ? await generator.isRunning() : false;
+    print(SERVICE_NAME + " Service Status");
+    print("─".repeat(40));
+    print("Platform:        " + getPlatform());
+    print("Service manager: " + generator.serviceManager);
+    print("Service file:    " + getServiceFilePath());
+    print("Installed:       " + (isInstalled ? "Yes" : "No"));
+    print("Running:         " + (isRunning ? "Yes" : "No"));
+    // If the service is running, fetch and display active streams.
+    if (isRunning) {
+        const port = await getServerPort();
+        const streamsData = await fetchActiveStreams(port);
+        if (streamsData === null) {
+            print("Active streams:  (server not responding)");
+        }
+        else if (streamsData.count === 0) {
+            print("Active streams:  0/" + String(streamsData.limit));
+        }
+        else {
+            print("Active streams:  " + String(streamsData.count) + "/" + String(streamsData.limit));
+            for (const stream of streamsData.streams) {
+                // Use channel name if available, otherwise extract hostname from URL.
+                let name = stream.channel;
+                if (!name) {
+                    try {
+                        name = new URL(stream.url).hostname.replace(/^www\./, "");
+                    }
+                    catch {
+                        name = "Stream " + String(stream.id);
+                    }
+                }
+                print("  • " + name + " (" + formatDuration(stream.duration) + ")");
+            }
+        }
+    }
+    if (!isInstalled) {
+        print("");
+        print("Run 'prismcast service install' to install the service.");
+    }
+    return 0;
+}
+/**
+ * Main handler for the `service` subcommand. Parses arguments and delegates to the appropriate handler.
+ * @param args - Arguments after 'service' (e.g., ['install', '--force']).
+ * @returns Exit code (0 for success, 1 for error).
+ */
+export async function handleServiceCommand(args) {
+    const command = args[0];
+    // Handle empty args (show help).
+    if (command === undefined) {
+        printServiceUsage();
+        return 0;
+    }
+    switch (command) {
+        case "install": {
+            const force = args.includes("--force") || args.includes("-f");
+            return handleInstall(force);
+        }
+        case "uninstall": {
+            return handleUninstall();
+        }
+        case "start": {
+            return handleStart();
+        }
+        case "stop": {
+            return handleStop();
+        }
+        case "restart": {
+            return handleRestart();
+        }
+        case "status": {
+            return handleStatus();
+        }
+        case "help":
+        case "--help":
+        case "-h": {
+            printServiceUsage();
+            return 0;
+        }
+        default: {
+            printError("Error: Unknown service command '" + command + "'.");
+            printError("");
+            printServiceUsage();
+            return 1;
+        }
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/service/commands.js.map

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

package/dist/service/generators.d.ts

@@ -0,0 +1,33 @@
+import type { Platform, ServiceManager } from "../utils/platform.js";
+import type { Nullable } from "../types/index.js";
+/**
+ * Options for generating a service file.
+ */
+export interface ServiceOptions {
+    envVars?: Record<string, string>;
+}
+/**
+ * Interface for platform-specific service generators.
+ */
+export interface ServiceGenerator {
+    generate(options: ServiceOptions): string;
+    getInstallPath(): string;
+    install(content: string): Promise<void>;
+    isInstalled(): Promise<boolean>;
+    isRunning(): Promise<boolean>;
+    platform: Platform;
+    serviceManager: ServiceManager;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    uninstall(): Promise<void>;
+}
+/**
+ * Returns the service generator for the current platform.
+ * @returns The appropriate ServiceGenerator, or null if the platform is not supported.
+ */
+export declare function getServiceGenerator(): Nullable<ServiceGenerator>;
+/**
+ * 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 declare function collectServiceEnvironment(): Record<string, string>;