@switchbot/openapi-cli 1.0.0

package/dist/utils/flags.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Read global flags directly from process.argv (same pattern as isJsonMode).
+ * Kept simple so subcommand actions don't need to thread program.opts() down.
+ */
+export declare function isVerbose(): boolean;
+export declare function isDryRun(): boolean;
+/** HTTP request timeout in milliseconds. Default 30s. */
+export declare function getTimeout(): number;
+/** Override for the credentials file path. */
+export declare function getConfigPath(): string | undefined;

package/dist/utils/flags.js

@@ -0,0 +1,34 @@
+/**
+ * Read global flags directly from process.argv (same pattern as isJsonMode).
+ * Kept simple so subcommand actions don't need to thread program.opts() down.
+ */
+function getFlagValue(...flagNames) {
+    for (const flag of flagNames) {
+        const idx = process.argv.indexOf(flag);
+        if (idx !== -1 && idx + 1 < process.argv.length) {
+            return process.argv[idx + 1];
+        }
+    }
+    return undefined;
+}
+export function isVerbose() {
+    return process.argv.includes('--verbose') || process.argv.includes('-v');
+}
+export function isDryRun() {
+    return process.argv.includes('--dry-run');
+}
+/** HTTP request timeout in milliseconds. Default 30s. */
+export function getTimeout() {
+    const v = getFlagValue('--timeout');
+    if (!v)
+        return 30_000;
+    const n = Number(v);
+    if (!Number.isFinite(n) || n <= 0)
+        return 30_000;
+    return n;
+}
+/** Override for the credentials file path. */
+export function getConfigPath() {
+    return getFlagValue('--config');
+}
+//# sourceMappingURL=flags.js.map

package/dist/utils/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/utils/flags.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,SAAS,YAAY,CAAC,GAAG,SAAmB;IAC1C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAChD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACtB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa;IAC3B,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,5 @@
+export declare function isJsonMode(): boolean;
+export declare function printJson(data: unknown): void;
+export declare function printTable(headers: string[], rows: (string | number | boolean | null | undefined)[][]): void;
+export declare function printKeyValue(data: Record<string, unknown>): void;
+export declare function handleError(error: unknown): never;

package/dist/utils/output.js

@@ -0,0 +1,78 @@
+import Table from 'cli-table3';
+import chalk from 'chalk';
+import { ApiError, DryRunSignal } from '../api/client.js';
+export function isJsonMode() {
+    return process.argv.includes('--json');
+}
+export function printJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+export function printTable(headers, rows) {
+    const table = new Table({
+        head: headers.map((h) => chalk.cyan(h)),
+        style: { border: ['grey'] },
+    });
+    for (const row of rows) {
+        table.push(row.map((cell) => {
+            if (cell === null || cell === undefined)
+                return chalk.grey('—');
+            if (typeof cell === 'boolean')
+                return cell ? chalk.green('✓') : chalk.red('✗');
+            return String(cell);
+        }));
+    }
+    console.log(table.toString());
+}
+export function printKeyValue(data) {
+    const table = new Table({
+        style: { border: ['grey'] },
+    });
+    for (const [key, value] of Object.entries(data)) {
+        if (value === null || value === undefined)
+            continue;
+        const displayValue = typeof value === 'object'
+            ? JSON.stringify(value)
+            : String(value);
+        table.push({ [chalk.cyan(key)]: displayValue });
+    }
+    console.log(table.toString());
+}
+export function handleError(error) {
+    if (error instanceof DryRunSignal) {
+        process.exit(0);
+    }
+    if (error instanceof ApiError) {
+        console.error(chalk.red(`Error (code ${error.code}): ${error.message}`));
+        const hint = errorHint(error.code);
+        if (hint)
+            console.error(chalk.grey(`Hint: ${hint}`));
+    }
+    else if (error instanceof Error) {
+        console.error(chalk.red(`Error: ${error.message}`));
+    }
+    else {
+        console.error(chalk.red('An unknown error occurred'));
+    }
+    process.exit(1);
+}
+function errorHint(code) {
+    switch (code) {
+        case 152:
+            return "Check the deviceId with 'switchbot devices list' (IDs are case-sensitive).";
+        case 160:
+            return "Run 'switchbot devices describe <deviceId>' to see which commands this device supports.";
+        case 161:
+            return 'BLE-only devices require a Hub. Check the hub connection and Wi-Fi.';
+        case 171:
+            return 'The Hub itself is offline — check its power and Wi-Fi.';
+        case 190:
+            return "Often means the deviceId is wrong or the command/parameter is invalid for this device. Double-check with 'switchbot devices list' and 'switchbot devices describe <deviceId>'. Use --verbose to see the raw API response.";
+        case 401:
+            return "Re-run 'switchbot config set-token <token> <secret>', or verify SWITCHBOT_TOKEN / SWITCHBOT_SECRET.";
+        case 429:
+            return 'Daily quota is 10,000 requests/account — retry after midnight UTC.';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAiB,EAAE,IAAwD;IACpG,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE;KAC5B,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,OAAO,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/E,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA6B;IACzD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE;KAC5B,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QACpD,MAAM,YAAY,GAAG,OAAO,KAAK,KAAK,QAAQ;YAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACvB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG;YACN,OAAO,4EAA4E,CAAC;QACtF,KAAK,GAAG;YACN,OAAO,yFAAyF,CAAC;QACnG,KAAK,GAAG;YACN,OAAO,qEAAqE,CAAC;QAC/E,KAAK,GAAG;YACN,OAAO,wDAAwD,CAAC;QAClE,KAAK,GAAG;YACN,OAAO,2NAA2N,CAAC;QACrO,KAAK,GAAG;YACN,OAAO,qGAAqG,CAAC;QAC/G,KAAK,GAAG;YACN,OAAO,oEAAoE,CAAC;QAC9E;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@switchbot/openapi-cli",
+  "version": "1.0.0",
+  "description": "Command-line interface for SwitchBot API v1.1",
+  "keywords": [
+    "switchbot",
+    "cli",
+    "iot",
+    "smart-home",
+    "home-automation",
+    "openapi"
+  ],
+  "license": "MIT",
+  "author": "chenliuyun <chenliuyun@onero.com>",
+  "homepage": "https://github.com/chenliuyun/switchbot-openapi-cli#readme",
+  "bugs": {
+    "url": "https://github.com/chenliuyun/switchbot-openapi-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chenliuyun/switchbot-openapi-cli.git"
+  },
+  "type": "module",
+  "bin": {
+    "switchbot": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "axios": "^1.7.9",
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "uuid": "^11.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "@types/uuid": "^10.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9"
+  }
+}