@switchbot/openapi-cli 3.2.0 → 3.2.1

package/dist/commands/daemon.js

@@ -0,0 +1,411 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isJsonMode, printJson, exitWithError } from '../utils/output.js';
+import { readPidFile, writePidFile, clearPidFile, isPidAlive, getDefaultPidFilePaths, writeReloadSentinel, sighupSupported } from '../rules/pid-file.js';
+import { stringArg } from '../utils/arg-parsers.js';
+import chalk from 'chalk';
+import { DAEMON_LOG_FILE, DAEMON_PID_FILE, DAEMON_STATE_FILE, HEALTHZ_PID_FILE, readDaemonState, writeDaemonState, } from '../lib/daemon-state.js';
+function readDaemonPid() {
+    return readPidFile(DAEMON_PID_FILE);
+}
+function readHealthPid() {
+    return readPidFile(HEALTHZ_PID_FILE);
+}
+function killIfAlive(pid, signal = 'SIGTERM') {
+    if (!pid)
+        return;
+    if (!isPidAlive(pid))
+        return;
+    process.kill(pid, signal);
+}
+function buildHealthSummary(state) {
+    const healthPid = readHealthPid();
+    const healthRunning = healthPid !== null && isPidAlive(healthPid);
+    const port = state?.healthzPort ?? null;
+    return {
+        configured: port !== null,
+        pid: healthRunning ? healthPid : null,
+        pidFile: HEALTHZ_PID_FILE,
+        port,
+        running: healthRunning,
+        url: port !== null ? `http://127.0.0.1:${port}/healthz` : null,
+    };
+}
+function getDaemonStatus() {
+    const state = readDaemonState();
+    const pid = readDaemonPid();
+    const running = pid !== null && isPidAlive(pid);
+    return {
+        status: running ? 'running' : 'stopped',
+        pid: running ? pid : null,
+        pidFile: DAEMON_PID_FILE,
+        logFile: DAEMON_LOG_FILE,
+        stateFile: DAEMON_STATE_FILE,
+        health: buildHealthSummary(state),
+        lastReloadAt: state?.lastReloadAt ?? null,
+        lastReloadStatus: state?.lastReloadStatus ?? null,
+        lastReloadMessage: state?.lastReloadMessage ?? null,
+        startedAt: state?.startedAt ?? null,
+        stoppedAt: state?.stoppedAt ?? null,
+    };
+}
+function persistState(partial) {
+    const previous = readDaemonState();
+    const next = {
+        ...(previous ?? {}),
+        status: partial.status ?? previous?.status ?? 'stopped',
+        pid: partial.pid ?? previous?.pid ?? null,
+        ...partial,
+        logFile: DAEMON_LOG_FILE,
+        pidFile: DAEMON_PID_FILE,
+        stateFile: DAEMON_STATE_FILE,
+    };
+    writeDaemonState(next);
+    return next;
+}
+function readLastLines(filePath, n = 20) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        return lines.slice(Math.max(0, lines.length - n)).join('\n').trim();
+    }
+    catch {
+        return '';
+    }
+}
+async function probeLiveness(opts) {
+    await new Promise((resolve) => setTimeout(resolve, opts.delayMs));
+    const dead = opts.child.exitCode !== null || opts.child.killed;
+    if (!dead)
+        return true;
+    if (opts.fatal) {
+        if (opts.pidFile)
+            clearPidFile(opts.pidFile);
+        const exitCode = opts.child.exitCode ?? 'unknown';
+        const logSnippet = opts.logFile ? readLastLines(opts.logFile) : '';
+        const trailingLog = logSnippet ? `\n\nLast log lines:\n${logSnippet}` : '';
+        const logRef = opts.logFile ?? 'daemon log';
+        persistState({
+            status: 'failed', pid: null, failedAt: new Date().toISOString(),
+            failureReason: `Daemon exited immediately (code ${exitCode}). Check ${logRef}.`,
+        });
+        exitWithError({
+            code: 1, kind: 'runtime',
+            message: `Daemon process exited immediately (code ${exitCode}). Check ${logRef} for details.${trailingLog}`,
+        });
+    }
+    return false;
+}
+function renderHumanStatus(status) {
+    if (status.status === 'running' && status.pid !== null) {
+        console.log(`${chalk.green('●')} Daemon is running (pid ${status.pid}).`);
+    }
+    else {
+        console.log(`${chalk.grey('○')} Daemon is not running.`);
+    }
+    if (status.startedAt)
+        console.log(`  Started: ${status.startedAt}`);
+    if (status.stoppedAt)
+        console.log(`  Stopped: ${status.stoppedAt}`);
+    console.log(`  Log:     ${status.logFile}`);
+    console.log(`  PID:     ${status.pidFile}`);
+    console.log(`  State:   ${status.stateFile}`);
+    if (status.lastReloadAt) {
+        console.log(`  Reload:  ${status.lastReloadAt} (${status.lastReloadStatus ?? 'unknown'})`);
+        if (status.lastReloadMessage)
+            console.log(`           ${status.lastReloadMessage}`);
+    }
+    if (status.health.configured) {
+        if (status.health.running) {
+            console.log(`${chalk.green('✓')} Health server running (pid ${status.health.pid})`);
+        }
+        else {
+            console.log(`${chalk.yellow('!')} Health server configured but not running`);
+        }
+        if (status.health.url)
+            console.log(`  Health:  ${status.health.url}`);
+    }
+}
+export function registerDaemonCommand(program) {
+    const daemon = program
+        .command('daemon')
+        .description('Manage the background SwitchBot rules daemon and its health endpoint.')
+        .addHelpText('after', `
+The daemon runs \`switchbot rules run\` as a detached background process,
+tracks runtime metadata in ~/.switchbot/daemon.state.json, and can optionally
+co-launch a health endpoint via \`switchbot health serve\`.
+
+Subcommands:
+  start [--policy <path>]   Start the daemon (no-op if already running).
+  stop                      Stop the daemon and any co-launched health server.
+  status                    Report the daemon state, log path, and health summary.
+  reload                    Trigger a hot reload for the running rules engine.
+
+The daemon reads the same policy file as \`switchbot rules run\`.
+`);
+    daemon
+        .command('start')
+        .description('Start the rules-engine daemon in the background.')
+        .option('--policy <path>', 'Policy file path (default: auto-detected)', stringArg('--policy'))
+        .option('--force', 'Restart even if the daemon appears to be running.')
+        .option('--healthz-port <n>', 'Also start a health HTTP server on this port (default: disabled).')
+        .action(async (opts) => {
+        const current = getDaemonStatus();
+        if (current.status === 'running' && !opts.force) {
+            if (isJsonMode()) {
+                printJson({ result: 'already-running', ...current });
+            }
+            else {
+                console.log(`Daemon is already running (pid ${current.pid}). Use --force to restart.`);
+            }
+            return;
+        }
+        if (opts.force) {
+            try {
+                killIfAlive(current.pid);
+                killIfAlive(current.health.pid);
+            }
+            catch {
+                // best effort
+            }
+        }
+        const thisFile = fileURLToPath(import.meta.url);
+        const cliEntry = path.resolve(path.dirname(thisFile), '..', 'index.js');
+        const args = ['rules', 'run'];
+        if (opts.policy)
+            args.push(opts.policy);
+        fs.mkdirSync(path.dirname(DAEMON_PID_FILE), { recursive: true, mode: 0o700 });
+        persistState({
+            status: 'starting',
+            pid: null,
+            startedAt: new Date().toISOString(),
+            stoppedAt: undefined,
+            failedAt: undefined,
+            failureReason: undefined,
+            healthzPort: opts.healthzPort ? Number.parseInt(opts.healthzPort, 10) : null,
+            healthzPid: null,
+            healthzPidFile: HEALTHZ_PID_FILE,
+        });
+        const logFd = fs.openSync(DAEMON_LOG_FILE, 'a');
+        const child = spawn(process.execPath, [cliEntry, ...args], {
+            detached: true,
+            stdio: ['ignore', logFd, logFd],
+            env: { ...process.env },
+        });
+        child.unref();
+        fs.closeSync(logFd);
+        // Liveness probe: wait 300 ms then verify the child is still alive.
+        await probeLiveness({
+            child, delayMs: 300, fatal: true,
+            pidFile: DAEMON_PID_FILE, logFile: DAEMON_LOG_FILE,
+        });
+        const newPid = child.pid;
+        if (!newPid) {
+            persistState({
+                status: 'failed',
+                pid: null,
+                failedAt: new Date().toISOString(),
+                failureReason: 'Failed to spawn daemon process.',
+            });
+            exitWithError({ code: 1, kind: 'runtime', message: 'Failed to spawn daemon process.' });
+        }
+        writePidFile(DAEMON_PID_FILE, newPid);
+        let healthzPid = null;
+        let healthzPort = opts.healthzPort ? Number.parseInt(opts.healthzPort, 10) : null;
+        if (healthzPort !== null) {
+            const healthArgs = ['health', 'serve', '--port', String(healthzPort)];
+            const healthLogFd = fs.openSync(DAEMON_LOG_FILE, 'a');
+            const healthChild = spawn(process.execPath, [cliEntry, ...healthArgs], {
+                detached: true,
+                stdio: ['ignore', healthLogFd, healthLogFd],
+                env: { ...process.env },
+            });
+            healthChild.unref();
+            fs.closeSync(healthLogFd);
+            if (healthChild.pid) {
+                // Brief liveness probe for the health server process.
+                const healthAlive = await probeLiveness({ child: healthChild, delayMs: 200, fatal: false });
+                if (healthAlive) {
+                    healthzPid = healthChild.pid;
+                    writePidFile(HEALTHZ_PID_FILE, healthzPid);
+                }
+                // Non-fatal if health server dies — daemon itself is still running.
+            }
+        }
+        persistState({
+            status: 'running',
+            pid: newPid,
+            startedAt: new Date().toISOString(),
+            stoppedAt: undefined,
+            failedAt: undefined,
+            failureReason: undefined,
+            healthzPort,
+            healthzPid,
+            healthzPidFile: HEALTHZ_PID_FILE,
+        });
+        const status = getDaemonStatus();
+        if (isJsonMode()) {
+            printJson({ result: 'started', ...status });
+        }
+        else {
+            console.log(`${chalk.green('✓')} Daemon started (pid ${newPid})`);
+            console.log(`  Log:     ${DAEMON_LOG_FILE}`);
+            console.log(`  PID:     ${DAEMON_PID_FILE}`);
+            console.log(`  State:   ${DAEMON_STATE_FILE}`);
+            console.log(`  Reload:  switchbot daemon reload`);
+            if (status.health.running && status.health.url) {
+                console.log(`${chalk.green('✓')} Health server started (pid ${status.health.pid})`);
+                console.log(`  Health:  ${status.health.url}`);
+            }
+        }
+    });
+    daemon
+        .command('stop')
+        .description('Stop the background daemon by sending SIGTERM.')
+        .action(() => {
+        const status = getDaemonStatus();
+        if (status.status !== 'running' || status.pid === null) {
+            persistState({ status: 'stopped', pid: null, stoppedAt: new Date().toISOString() });
+            if (isJsonMode()) {
+                printJson({ result: 'not-running', ...getDaemonStatus() });
+            }
+            else {
+                console.log(`No running daemon found (pid file: ${DAEMON_PID_FILE}).`);
+            }
+            return;
+        }
+        try {
+            killIfAlive(status.pid);
+            killIfAlive(status.health.pid);
+        }
+        catch (err) {
+            persistState({
+                status: 'failed',
+                pid: status.pid,
+                failedAt: new Date().toISOString(),
+                failureReason: err instanceof Error ? err.message : String(err),
+            });
+            exitWithError({
+                code: 1,
+                kind: 'runtime',
+                message: `Failed to stop daemon (pid ${status.pid}): ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        try {
+            fs.unlinkSync(DAEMON_PID_FILE);
+        }
+        catch { /* best effort */ }
+        try {
+            fs.unlinkSync(HEALTHZ_PID_FILE);
+        }
+        catch { /* best effort */ }
+        persistState({
+            status: 'stopped',
+            pid: null,
+            healthzPid: null,
+            stoppedAt: new Date().toISOString(),
+        });
+        if (isJsonMode()) {
+            printJson({ result: 'stopped', ...getDaemonStatus() });
+        }
+        else {
+            console.log(`${chalk.green('✓')} Daemon stopped (pid ${status.pid}).`);
+        }
+    });
+    daemon
+        .command('status')
+        .description('Report whether the daemon is currently running.')
+        .action(() => {
+        const status = getDaemonStatus();
+        if (isJsonMode()) {
+            printJson(status);
+            return;
+        }
+        renderHumanStatus(status);
+    });
+    daemon
+        .command('reload')
+        .description('Trigger a hot reload on the running rules-engine daemon.')
+        .action(() => {
+        const daemonStatus = getDaemonStatus();
+        if (daemonStatus.status !== 'running' || daemonStatus.pid === null) {
+            persistState({
+                status: 'failed',
+                failedAt: new Date().toISOString(),
+                failureReason: 'No running daemon to reload.',
+                lastReloadAt: new Date().toISOString(),
+                lastReloadStatus: 'failed',
+                lastReloadMessage: 'No running daemon to reload.',
+            });
+            exitWithError({
+                code: 2,
+                kind: 'usage',
+                message: `No running daemon found (pid file: ${DAEMON_PID_FILE}).`,
+            });
+        }
+        const pidPaths = getDefaultPidFilePaths();
+        const rulesPid = readPidFile(pidPaths.pidFile);
+        if (rulesPid === null || !isPidAlive(rulesPid)) {
+            persistState({
+                status: 'failed',
+                failedAt: new Date().toISOString(),
+                failureReason: 'Rules engine PID is missing or stale.',
+                lastReloadAt: new Date().toISOString(),
+                lastReloadStatus: 'failed',
+                lastReloadMessage: 'Rules engine PID is missing or stale.',
+            });
+            exitWithError({
+                code: 2,
+                kind: 'usage',
+                message: `No running rules engine found for daemon reload (pid file: ${pidPaths.pidFile}).`,
+            });
+        }
+        let method;
+        try {
+            if (sighupSupported()) {
+                process.kill(rulesPid, 'SIGHUP');
+                method = 'SIGHUP';
+            }
+            else {
+                writeReloadSentinel(pidPaths.reloadFile);
+                method = 'sentinel';
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            persistState({
+                status: 'failed',
+                failedAt: new Date().toISOString(),
+                failureReason: message,
+                lastReloadAt: new Date().toISOString(),
+                lastReloadStatus: 'failed',
+                lastReloadMessage: message,
+            });
+            exitWithError({
+                code: 1,
+                kind: 'runtime',
+                message: `Failed to reload daemon: ${message}`,
+            });
+        }
+        persistState({
+            status: 'running',
+            lastReloadAt: new Date().toISOString(),
+            lastReloadStatus: 'ok',
+            lastReloadMessage: method === 'SIGHUP'
+                ? `Sent SIGHUP to rules engine pid ${rulesPid}.`
+                : `Wrote reload sentinel ${pidPaths.reloadFile}.`,
+        });
+        const status = getDaemonStatus();
+        if (isJsonMode()) {
+            printJson({ result: 'reloaded', method, ...status });
+        }
+        else {
+            console.log(`${chalk.green('✓')} Reload requested via ${method}.`);
+            if (status.lastReloadMessage)
+                console.log(`  ${status.lastReloadMessage}`);
+        }
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/commands/daemon.js.map

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

package/dist/commands/device-meta.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerDevicesMetaCommand(devices: Command): void;

package/dist/commands/device-meta.js

@@ -0,0 +1,160 @@
+import { stringArg } from '../utils/arg-parsers.js';
+import { handleError, isJsonMode, printJson, printTable, UsageError } from '../utils/output.js';
+import { loadDeviceMeta, saveDeviceMeta, setDeviceMeta, clearDeviceMeta, getDeviceMeta, getMetaFilePath, } from '../devices/device-meta.js';
+export function registerDevicesMetaCommand(devices) {
+    const meta = devices
+        .command('meta')
+        .description('Manage local device metadata (alias, hide, notes) stored in ~/.switchbot/device-meta.json');
+    // switchbot devices meta set <deviceId>
+    meta
+        .command('set')
+        .description('Set local metadata for a device (alias, hide/show, notes)')
+        .argument('<deviceId>', 'Target device ID')
+        .option('--alias <name>', 'Local alias for the device (used with --name flag)', stringArg('--alias'))
+        .option('--hide', 'Hide this device from "devices list"')
+        .option('--show', 'Un-hide this device')
+        .option('--notes <text>', 'Freeform notes shown in "devices describe"', stringArg('--notes'))
+        .option('--force', 'Reassign alias even if it already belongs to another device')
+        .action((deviceId, options) => {
+        try {
+            if (options.hide && options.show) {
+                throw new UsageError('--hide and --show cannot be used together.');
+            }
+            if (!options.alias && !options.hide && !options.show && !options.notes) {
+                throw new UsageError('Specify at least one of: --alias, --hide, --show, --notes');
+            }
+            // Enforce alias uniqueness across devices
+            if (options.alias !== undefined) {
+                const meta = loadDeviceMeta();
+                const holder = Object.entries(meta.devices).find(([id, m]) => m.alias === options.alias && id !== deviceId);
+                if (holder) {
+                    if (!options.force) {
+                        throw new UsageError(`Alias "${options.alias}" is already assigned to device ${holder[0]}. Use --force to reassign.`);
+                    }
+                    // --force: clear the alias from the previous holder
+                    meta.devices[holder[0]] = { ...meta.devices[holder[0]], alias: undefined };
+                    saveDeviceMeta(meta);
+                    if (!isJsonMode()) {
+                        console.log(`(reassigned alias from ${holder[0]})`);
+                    }
+                }
+            }
+            const patch = {};
+            if (options.alias !== undefined)
+                patch.alias = options.alias;
+            if (options.notes !== undefined)
+                patch.notes = options.notes;
+            if (options.hide)
+                patch.hidden = true;
+            if (options.show)
+                patch.hidden = false;
+            setDeviceMeta(deviceId, patch);
+            const updated = getDeviceMeta(deviceId);
+            if (isJsonMode()) {
+                printJson({ ok: true, deviceId, meta: updated });
+            }
+            else {
+                console.log(`✓ Metadata updated for ${deviceId}`);
+                if (updated?.alias)
+                    console.log(`  alias:  ${updated.alias}`);
+                if (updated?.hidden)
+                    console.log(`  hidden: true`);
+                if (updated?.notes)
+                    console.log(`  notes:  ${updated.notes}`);
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // switchbot devices meta get <deviceId>
+    meta
+        .command('get')
+        .description('Show local metadata for a device')
+        .argument('<deviceId>', 'Target device ID')
+        .action((deviceId) => {
+        try {
+            const entry = getDeviceMeta(deviceId);
+            if (!entry) {
+                if (isJsonMode()) {
+                    printJson({ deviceId, meta: null });
+                }
+                else {
+                    console.log(`No local metadata for ${deviceId}`);
+                }
+                return;
+            }
+            if (isJsonMode()) {
+                printJson({ deviceId, meta: entry });
+            }
+            else {
+                if (entry.alias)
+                    console.log(`alias:  ${entry.alias}`);
+                if (entry.hidden !== undefined)
+                    console.log(`hidden: ${entry.hidden}`);
+                if (entry.notes)
+                    console.log(`notes:  ${entry.notes}`);
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // switchbot devices meta list
+    meta
+        .command('list')
+        .description('List all devices with local metadata')
+        .option('--hidden-only', 'Show only hidden devices')
+        .action((options) => {
+        try {
+            const file = loadDeviceMeta();
+            let entries = Object.entries(file.devices);
+            if (options.hiddenOnly)
+                entries = entries.filter(([, m]) => m.hidden);
+            if (entries.length === 0) {
+                if (isJsonMode()) {
+                    printJson([]);
+                }
+                else {
+                    console.log('No local metadata entries.');
+                    console.log(`File: ${getMetaFilePath()}`);
+                }
+                return;
+            }
+            if (isJsonMode()) {
+                printJson(entries.map(([id, m]) => ({ deviceId: id, ...m })));
+                return;
+            }
+            const rows = entries.map(([id, m]) => [
+                id,
+                m.alias ?? '—',
+                m.hidden ? 'yes' : '—',
+                m.notes ?? '—',
+            ]);
+            printTable(['deviceId', 'alias', 'hidden', 'notes'], rows);
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // switchbot devices meta clear <deviceId>
+    meta
+        .command('clear')
+        .description('Remove all local metadata for a device')
+        .argument('<deviceId>', 'Target device ID')
+        .action((deviceId) => {
+        try {
+            clearDeviceMeta(deviceId);
+            if (isJsonMode()) {
+                printJson({ ok: true, deviceId });
+            }
+            else {
+                console.log(`✓ Metadata cleared for ${deviceId}`);
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=device-meta.js.map

package/dist/commands/device-meta.js.map

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

package/dist/commands/devices.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerDevicesCommand(program: Command): void;