@switchbot/openapi-cli 3.2.0 → 3.2.1

package/dist/commands/watch.js

@@ -0,0 +1,195 @@
+import { printJson, isJsonMode, handleError, UsageError, emitStreamHeader } from '../utils/output.js';
+import { fetchDeviceStatus } from '../lib/devices.js';
+import { getCachedDevice } from '../devices/cache.js';
+import { parseDurationToMs, getFields } from '../utils/flags.js';
+import { intArg, durationArg, stringArg } from '../utils/arg-parsers.js';
+import { createClient } from '../api/client.js';
+import { resolveDeviceId } from '../utils/name-resolver.js';
+import { resolveFieldList, listAllCanonical } from '../schema/field-aliases.js';
+const DEFAULT_INTERVAL_MS = 30_000;
+const MIN_INTERVAL_MS = 1_000;
+function diff(prev, next, fields) {
+    const out = {};
+    const keys = fields ?? Object.keys(next);
+    for (const k of keys) {
+        const a = prev ? prev[k] : undefined;
+        const b = next[k];
+        if (JSON.stringify(a) !== JSON.stringify(b)) {
+            out[k] = { from: prev ? a : null, to: b };
+        }
+    }
+    return out;
+}
+function formatHumanLine(ev) {
+    const when = new Date(ev.t).toLocaleTimeString();
+    const head = `[${when}] ${ev.deviceId}${ev.type ? ` (${ev.type})` : ''}`;
+    if (ev.error)
+        return `${head}: error — ${ev.error}`;
+    const keys = Object.keys(ev.changed);
+    if (keys.length === 0)
+        return `${head}: no changes`;
+    const pairs = keys
+        .map((k) => {
+        const { from, to } = ev.changed[k];
+        if (from === null || from === undefined)
+            return `${k}=${JSON.stringify(to)}`;
+        return `${k}: ${JSON.stringify(from)} → ${JSON.stringify(to)}`;
+    })
+        .join(', ');
+    return `${head} ${pairs}`;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        const t = setTimeout(() => resolve(), ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            resolve();
+        };
+        if (signal.aborted) {
+            clearTimeout(t);
+            resolve();
+        }
+        else {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+    });
+}
+export function registerWatchCommand(devices) {
+    devices
+        .command('watch')
+        .description('Poll device status on an interval and emit field-level changes (JSONL)')
+        .argument('[deviceId...]', 'One or more deviceIds to watch (or use --name for one device)')
+        .option('--name <query>', 'Resolve one device by fuzzy name (combined with any positional IDs)', stringArg('--name'))
+        .option('--interval <dur>', `Polling interval: "30s", "1m", "500ms", ... (default 30s, min ${MIN_INTERVAL_MS / 1000}s)`, durationArg('--interval'), '30s')
+        .option('--max <n>', 'Stop after N ticks (default: run until Ctrl-C)', intArg('--max', { min: 1 }))
+        .option('--for <dur>', 'Stop after elapsed time (e.g. "5m", "30s"). Combines with --max: first limit wins.', durationArg('--for'))
+        .option('--include-unchanged', 'Emit a tick even when no field changed')
+        .addHelpText('after', `
+Each poll emits one JSON line per deviceId with the shape:
+  { "t": "<ISO>", "tick": <n>, "deviceId": "ID", "type": "Bot",
+    "changed": { "power": { "from": "off", "to": "on" } } }
+
+The very first poll has "from": null for every field (seed).
+
+Examples:
+  $ switchbot devices watch ABC123 --interval 10s
+  $ switchbot devices watch ABC123 --fields battery,power --interval 1m
+  $ switchbot devices watch ABC123 DEF456 --interval 30s --max 10
+  $ switchbot devices watch ABC123 --json | jq 'select(.changed.power)'
+  $ switchbot devices watch --name "Living Room AC" --interval 10s
+`)
+        .action(async (deviceIds, options) => {
+        try {
+            const allIds = [...deviceIds];
+            if (options.name) {
+                const resolved = resolveDeviceId(undefined, options.name);
+                if (!allIds.includes(resolved))
+                    allIds.push(resolved);
+            }
+            if (allIds.length === 0)
+                throw new UsageError('Provide at least one deviceId argument or --name.');
+            const parsed = parseDurationToMs(options.interval);
+            if (parsed === null || parsed < MIN_INTERVAL_MS) {
+                throw new UsageError(`Invalid --interval "${options.interval}". Minimum is ${MIN_INTERVAL_MS / 1000}s.`);
+            }
+            const intervalMs = parsed;
+            let maxTicks = null;
+            if (options.max !== undefined) {
+                const n = Number(options.max);
+                if (!Number.isFinite(n) || n < 1) {
+                    throw new UsageError(`Invalid --max "${options.max}". Must be a positive integer.`);
+                }
+                maxTicks = Math.floor(n);
+            }
+            const forMs = options.for ? parseDurationToMs(options.for) : null;
+            const rawFields = getFields() ?? null;
+            // Resolve aliases upfront against the static canonical registry.
+            // Validating here lets UsageError exit the command before any
+            // polling starts, and keeps mid-loop error handling free of
+            // "misuse" concerns. Unknown fields that are not registered as
+            // aliases but happen to match an API key pass through unchanged.
+            const fields = rawFields
+                ? resolveFieldList(rawFields, listAllCanonical())
+                : null;
+            const ac = new AbortController();
+            const onSig = () => ac.abort();
+            process.on('SIGINT', onSig);
+            process.on('SIGTERM', onSig);
+            const forTimer = forMs !== null && forMs > 0
+                ? setTimeout(() => ac.abort(), forMs)
+                : null;
+            // P7: streaming JSON contract — first line under --json is the
+            // stream header so consumers can route by eventKind/cadence.
+            if (isJsonMode())
+                emitStreamHeader({ eventKind: 'tick', cadence: 'poll' });
+            try {
+                const prev = new Map();
+                const client = createClient();
+                let tick = 0;
+                while (!ac.signal.aborted) {
+                    tick++;
+                    const t = new Date().toISOString();
+                    // Poll all devices in parallel; one failure per device doesn't stop
+                    // the others.
+                    await Promise.all(allIds.map(async (id) => {
+                        const cached = getCachedDevice(id);
+                        try {
+                            const body = await fetchDeviceStatus(id, client);
+                            const changed = diff(prev.get(id), body, fields);
+                            prev.set(id, body);
+                            if (Object.keys(changed).length === 0 && !options.includeUnchanged) {
+                                return;
+                            }
+                            const ev = {
+                                t,
+                                tick,
+                                deviceId: id,
+                                type: cached?.type,
+                                changed,
+                            };
+                            if (isJsonMode()) {
+                                // JSONL: one event per line (printJson with newline).
+                                printJson(ev);
+                            }
+                            else {
+                                console.log(formatHumanLine(ev));
+                            }
+                        }
+                        catch (err) {
+                            const ev = {
+                                t,
+                                tick,
+                                deviceId: id,
+                                type: cached?.type,
+                                changed: {},
+                                error: err instanceof Error ? err.message : String(err),
+                            };
+                            if (isJsonMode()) {
+                                printJson(ev);
+                            }
+                            else {
+                                console.error(formatHumanLine(ev));
+                            }
+                        }
+                    }));
+                    if (maxTicks !== null && tick >= maxTicks)
+                        break;
+                    await sleep(intervalMs, ac.signal);
+                }
+            }
+            catch (err) {
+                handleError(err);
+            }
+            finally {
+                if (forTimer)
+                    clearTimeout(forTimer);
+                process.off('SIGINT', onSig);
+                process.off('SIGTERM', onSig);
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/commands/webhook.d.ts

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

package/dist/commands/webhook.js

@@ -0,0 +1,183 @@
+import { stringArg } from '../utils/arg-parsers.js';
+import { createClient } from '../api/client.js';
+import { printKeyValue, printJson, isJsonMode, handleError, UsageError } from '../utils/output.js';
+import chalk from 'chalk';
+function assertValidUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new UsageError(`Invalid URL "${url}" (expected absolute URL, e.g. https://example.com/hook)`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new UsageError(`URL must use http:// or https:// (got "${parsed.protocol}")`);
+    }
+}
+export function registerWebhookCommand(program) {
+    const webhook = program
+        .command('webhook')
+        .description('Manage SwitchBot Webhook configuration')
+        .addHelpText('after', `
+A webhook lets SwitchBot POST device state-change events to a URL you host.
+Only one webhook URL can be active per account; "setup" registers it for ALL devices.
+`);
+    // switchbot webhook setup <url>
+    webhook
+        .command('setup')
+        .description('Configure the webhook receiver URL (receives events from all devices)')
+        .argument('<url>', 'Absolute http(s):// URL where SwitchBot will POST events')
+        .addHelpText('after', `
+Example:
+  $ switchbot webhook setup https://example.com/switchbot/events
+`)
+        .action(async (url) => {
+        try {
+            assertValidUrl(url);
+            const client = createClient();
+            await client.post('/v1.1/webhook/setupWebhook', {
+                action: 'setupWebhook',
+                url,
+                deviceList: 'ALL',
+            });
+            if (isJsonMode()) {
+                printJson({ ok: true, url });
+            }
+            else {
+                console.log(chalk.green(`✓ Webhook configured: ${url}`));
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // switchbot webhook query [--details <url>]
+    webhook
+        .command('query')
+        .description('Query webhook configuration')
+        .option('--details <url>', 'Query detailed configuration (enable/deviceList/timestamps) for a specific URL', stringArg('--details'))
+        .addHelpText('after', `
+Without --details, lists all configured webhook URLs.
+With --details, prints enable/deviceList/createTime/lastUpdateTime for the given URL.
+
+Examples:
+  $ switchbot webhook query
+  $ switchbot webhook query --details https://example.com/hook
+  $ switchbot webhook query --json
+`)
+        .action(async (options) => {
+        try {
+            const client = createClient();
+            if (options.details) {
+                const res = await client.post('/v1.1/webhook/queryWebhook', { action: 'queryDetails', urls: [options.details] });
+                if (isJsonMode()) {
+                    printJson(res.data.body);
+                    return;
+                }
+                const details = res.data.body;
+                if (!details || details.length === 0) {
+                    console.log('No webhook configuration found for this URL');
+                    return;
+                }
+                for (const d of details) {
+                    printKeyValue({
+                        url: d.url,
+                        enable: d.enable,
+                        deviceList: d.deviceList,
+                        createTime: new Date(d.createTime).toLocaleString(),
+                        lastUpdateTime: new Date(d.lastUpdateTime).toLocaleString(),
+                    });
+                }
+            }
+            else {
+                const res = await client.post('/v1.1/webhook/queryWebhook', { action: 'queryUrl' });
+                if (isJsonMode()) {
+                    printJson(res.data.body);
+                    return;
+                }
+                const urls = res.data.body.urls ?? [];
+                if (urls.length === 0) {
+                    console.log('No webhooks configured');
+                    return;
+                }
+                console.log('Configured Webhook URLs:');
+                urls.forEach((u) => console.log(`  ${chalk.cyan(u)}`));
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // switchbot webhook update <url> [--enable | --disable]
+    webhook
+        .command('update')
+        .description('Update webhook configuration (enable / disable a registered URL)')
+        .argument('<url>', 'URL of the webhook to update (must already be configured)')
+        .option('--enable', 'Enable the webhook')
+        .option('--disable', 'Disable the webhook')
+        .addHelpText('after', `
+--enable and --disable are mutually exclusive. If neither is provided, the
+webhook is re-submitted with no change to its enabled state.
+
+Examples:
+  $ switchbot webhook update https://example.com/hook --enable
+  $ switchbot webhook update https://example.com/hook --disable
+`)
+        .action(async (url, options) => {
+        try {
+            if (options.enable && options.disable) {
+                throw new UsageError('--enable and --disable are mutually exclusive');
+            }
+            assertValidUrl(url);
+            const client = createClient();
+            const config = { url };
+            if (options.enable)
+                config.enable = true;
+            if (options.disable)
+                config.enable = false;
+            await client.post('/v1.1/webhook/updateWebhook', {
+                action: 'updateWebhook',
+                config,
+            });
+            const statusText = options.enable ? 'enabled' : options.disable ? 'disabled' : 'updated';
+            if (isJsonMode()) {
+                printJson({ ok: true, url, status: statusText });
+            }
+            else {
+                console.log(chalk.green(`✓ Webhook ${statusText}: ${url}`));
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // switchbot webhook delete <url>
+    webhook
+        .command('delete')
+        .description('Delete webhook configuration')
+        .argument('<url>', 'URL of the webhook to remove')
+        .addHelpText('after', `
+Example:
+  $ switchbot webhook delete https://example.com/hook
+`)
+        .action(async (url) => {
+        try {
+            assertValidUrl(url);
+            const client = createClient();
+            await client.post('/v1.1/webhook/deleteWebhook', {
+                action: 'deleteWebhook',
+                url,
+            });
+            if (isJsonMode()) {
+                printJson({ ok: true, url });
+            }
+            else {
+                console.log(chalk.green(`✓ Webhook deleted: ${url}`));
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=webhook.js.map

package/dist/commands/webhook.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,57 @@
+export interface SwitchBotConfig {
+    token: string;
+    secret: string;
+    label?: string;
+    description?: string;
+    limits?: {
+        dailyCap?: number;
+    };
+    defaults?: {
+        flags?: string[];
+    };
+}
+export interface ConfigSummary {
+    source: 'env' | 'file' | 'none' | 'invalid';
+    path?: string;
+    token?: string;
+    secret?: string;
+    label?: string;
+    description?: string;
+    dailyCap?: number;
+    defaultFlags?: string[];
+}
+/**
+ * Credential file resolution priority:
+ *   1. --config <path> (absolute override — wins over everything)
+ *   2. active profile (ALS request context, else --profile flag) → ~/.switchbot/profiles/<name>.json
+ *   3. default        → ~/.switchbot/config.json
+ *
+ * Env SWITCHBOT_TOKEN+SWITCHBOT_SECRET still take priority inside loadConfig.
+ */
+export declare function configFilePath(): string;
+export declare function profileFilePath(profile: string): string;
+export declare function listProfiles(): string[];
+export declare function loadConfig(): SwitchBotConfig;
+/**
+ * Like loadConfig but returns null instead of exiting. Use this in code paths
+ * that want graceful degradation (e.g. optional MQTT init in `mcp serve`).
+ */
+export declare function tryLoadConfig(): SwitchBotConfig | null;
+export declare function saveConfig(token: string, secret: string, extras?: Partial<SwitchBotConfig>): void;
+/**
+ * Read a profile's metadata (label / description / limits / defaults) without
+ * exposing the token/secret. Returns null when the file is missing or invalid.
+ */
+export declare function readProfileMeta(profile?: string): {
+    label?: string;
+    description?: string;
+    limits?: {
+        dailyCap?: number;
+    };
+    defaults?: {
+        flags?: string[];
+    };
+    path: string;
+} | null;
+export declare function showConfig(): void;
+export declare function getConfigSummary(): ConfigSummary;