@switchbot/openapi-cli 3.2.0 → 3.2.1

package/dist/index.js.map

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

package/dist/install/default-steps.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Default install steps used by `switchbot install` (Phase 3B in-repo).
+ *
+ * Each factory returns an `InstallStep<InstallContext>` whose `execute`
+ * and `undo` both operate on the shared context. Steps are intentionally
+ * small — each one either mutates one system (keychain / filesystem /
+ * symlink) or captures input, never a mix. The orchestrator composes
+ * them in `src/commands/install.ts`.
+ *
+ * The step runner (`src/install/steps.ts`) handles rollback on failure;
+ * these factories just make sure every `execute` records what it needs
+ * into the context so the matching `undo` can unwind it.
+ */
+import type { InstallStep } from './steps.js';
+import { type ScaffoldPolicyResult } from '../commands/policy.js';
+import { type CredentialStore, type CredentialBundle } from '../credentials/keychain.js';
+export type AgentName = 'claude-code' | 'cursor' | 'copilot' | 'none';
+export interface InstallContext {
+    /** Profile to write credentials under (default `default`). */
+    profile: string;
+    /** Which agent to link the skill for. `none` → skip skill step. */
+    agent: AgentName;
+    /** Absolute path to a local clone of openclaw-switchbot-skill, or undefined. */
+    skillPath?: string;
+    /** Policy file path (default: from resolvePolicyPath()). */
+    policyPath: string;
+    /** Non-interactive credential file, read once and unlinked on success. */
+    tokenFile?: string;
+    /** True if stdout is not a TTY; forbids interactive prompting. */
+    nonInteractive?: boolean;
+    credentials?: CredentialBundle;
+    credentialStore?: CredentialStore;
+    credentialsWereStored?: boolean;
+    previousCredentials?: CredentialBundle | null;
+    policyScaffoldResult?: ScaffoldPolicyResult;
+    skillLinkPath?: string;
+    skillLinkCreated?: boolean;
+    skillRecipePrinted?: boolean;
+    doctorOk?: boolean;
+    doctorReport?: unknown;
+}
+export declare function stepPromptCredentials(): InstallStep<InstallContext>;
+export declare function stepWriteKeychain(): InstallStep<InstallContext>;
+export declare function stepScaffoldPolicy(): InstallStep<InstallContext>;
+/**
+ * Compute the on-disk location where an agent expects to find this skill.
+ * Only `claude-code` has an automation path today; others are informational
+ * (the installer will print a recipe instead of creating anything).
+ */
+export declare function skillLinkPathFor(agent: AgentName, home?: string): string | null;
+export interface SymlinkSkillOptions {
+    /** When true, replace an existing symlink even if it points elsewhere. */
+    force?: boolean;
+}
+export declare function stepSymlinkSkill(opts?: SymlinkSkillOptions): InstallStep<InstallContext>;
+export interface DoctorSpawnResult {
+    ok: boolean;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+}
+export type DoctorSpawner = (cliPath: string, profile: string) => DoctorSpawnResult;
+export declare function stepDoctorVerify(opts?: {
+    cliPath: string;
+    spawner?: DoctorSpawner;
+}): InstallStep<InstallContext>;

package/dist/install/default-steps.js

@@ -0,0 +1,258 @@
+/**
+ * Default install steps used by `switchbot install` (Phase 3B in-repo).
+ *
+ * Each factory returns an `InstallStep<InstallContext>` whose `execute`
+ * and `undo` both operate on the shared context. Steps are intentionally
+ * small — each one either mutates one system (keychain / filesystem /
+ * symlink) or captures input, never a mix. The orchestrator composes
+ * them in `src/commands/install.ts`.
+ *
+ * The step runner (`src/install/steps.ts`) handles rollback on failure;
+ * these factories just make sure every `execute` records what it needs
+ * into the context so the matching `undo` can unwind it.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { scaffoldPolicyFile, PolicyFileExistsError, } from '../commands/policy.js';
+import { promptTokenAndSecret, readCredentialsFile } from '../commands/config.js';
+import { selectCredentialStore } from '../credentials/keychain.js';
+// ---------------------------------------------------------------------------
+// Step 1: capture credentials (memory only — no side effects until step 2)
+// ---------------------------------------------------------------------------
+export function stepPromptCredentials() {
+    return {
+        name: 'prompt-credentials',
+        description: 'Collect SwitchBot token + secret (interactive unless --token-file)',
+        async execute(ctx) {
+            if (ctx.credentials)
+                return; // already provided via API consumer
+            if (ctx.tokenFile) {
+                const creds = readCredentialsFile(ctx.tokenFile);
+                ctx.credentials = creds;
+                return;
+            }
+            if (ctx.nonInteractive) {
+                throw new Error('no --token-file and stdin is not a TTY; pass --token-file <path> to install non-interactively');
+            }
+            ctx.credentials = await promptTokenAndSecret();
+        },
+        undo() {
+            // No disk state created; clearing memory is enough.
+            // The calling process will exit shortly after rollback, but null
+            // the field for defence-in-depth.
+            return;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Step 2: write credentials to keychain (or file fallback)
+// ---------------------------------------------------------------------------
+export function stepWriteKeychain() {
+    return {
+        name: 'write-keychain',
+        description: 'Store credentials in the OS keychain (falls back to ~/.switchbot/config.json)',
+        async execute(ctx) {
+            if (!ctx.credentials) {
+                throw new Error('internal: credentials missing at write-keychain; prompt step must run first');
+            }
+            const store = await selectCredentialStore();
+            const previous = await store.get(ctx.profile);
+            ctx.previousCredentials = previous;
+            await store.set(ctx.profile, ctx.credentials);
+            ctx.credentialStore = store;
+            ctx.credentialsWereStored = true;
+        },
+        async undo(ctx) {
+            if (!ctx.credentialsWereStored || !ctx.credentialStore)
+                return;
+            try {
+                if (ctx.previousCredentials) {
+                    await ctx.credentialStore.set(ctx.profile, ctx.previousCredentials);
+                }
+                else {
+                    await ctx.credentialStore.delete(ctx.profile);
+                }
+            }
+            finally {
+                ctx.credentialsWereStored = false;
+                ctx.previousCredentials = undefined;
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Step 3: scaffold policy.yaml if missing (skip if present, don't clobber)
+// ---------------------------------------------------------------------------
+export function stepScaffoldPolicy() {
+    return {
+        name: 'scaffold-policy',
+        description: 'Create a starter policy.yaml (only if none exists)',
+        execute(ctx) {
+            try {
+                const result = scaffoldPolicyFile(ctx.policyPath, { skipExisting: true });
+                ctx.policyScaffoldResult = result;
+            }
+            catch (err) {
+                if (err instanceof PolicyFileExistsError) {
+                    // skipExisting is true → this branch is unreachable, but be
+                    // defensive against future changes.
+                    return;
+                }
+                throw err;
+            }
+        },
+        undo(ctx) {
+            const r = ctx.policyScaffoldResult;
+            if (!r || r.skipped)
+                return;
+            // Only remove the file if WE created it (skipped === false means
+            // we wrote fresh content to a path that did not exist before).
+            try {
+                fs.unlinkSync(r.policyPath);
+            }
+            catch {
+                // best-effort; do not fail rollback on cleanup
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Step 4: install skill into the agent's skills directory
+// ---------------------------------------------------------------------------
+/**
+ * Compute the on-disk location where an agent expects to find this skill.
+ * Only `claude-code` has an automation path today; others are informational
+ * (the installer will print a recipe instead of creating anything).
+ */
+export function skillLinkPathFor(agent, home = os.homedir()) {
+    if (agent === 'claude-code') {
+        return path.join(home, '.claude', 'skills', 'switchbot');
+    }
+    return null;
+}
+export function stepSymlinkSkill(opts = {}) {
+    return {
+        name: 'symlink-skill',
+        description: 'Link the skill into ~/.claude/skills/switchbot (Claude Code)',
+        execute(ctx) {
+            if (ctx.agent === 'none')
+                return;
+            if (!ctx.skillPath) {
+                // Informational path: print the recipe, do not fail. Undo can
+                // safely no-op in this branch.
+                ctx.skillRecipePrinted = true;
+                return;
+            }
+            const target = path.resolve(ctx.skillPath);
+            if (!fs.existsSync(target)) {
+                throw new Error(`--skill-path does not exist: ${target}`);
+            }
+            const stat = fs.statSync(target);
+            if (!stat.isDirectory()) {
+                throw new Error(`--skill-path is not a directory: ${target}`);
+            }
+            const linkPath = skillLinkPathFor(ctx.agent);
+            if (!linkPath) {
+                // Non-automating agent: print a recipe instead of creating state.
+                ctx.skillRecipePrinted = true;
+                return;
+            }
+            // A2: require a SKILL.md only when we are about to create a link.
+            // Non-automating agents (cursor/copilot) print a recipe and return
+            // above, so they are never blocked by this check.
+            if (!opts.force && !fs.existsSync(path.join(target, 'SKILL.md'))) {
+                throw new Error(`${target} does not look like a skill (no SKILL.md at the root). ` +
+                    'Pass --force if you really mean to link this directory.');
+            }
+            if (fs.existsSync(linkPath)) {
+                const st = fs.lstatSync(linkPath);
+                if (st.isSymbolicLink()) {
+                    // A3: tolerate an existing link only when it points at the same
+                    // target; otherwise the user is likely trying to repoint and we
+                    // should not silently pretend success. --force replaces it.
+                    let existingTarget = null;
+                    try {
+                        existingTarget = path.resolve(path.dirname(linkPath), fs.readlinkSync(linkPath));
+                    }
+                    catch {
+                        existingTarget = null;
+                    }
+                    if (existingTarget === target) {
+                        ctx.skillLinkPath = linkPath;
+                        ctx.skillLinkCreated = false;
+                        return;
+                    }
+                    if (!opts.force) {
+                        throw new Error(`${linkPath} already links to ${existingTarget ?? '(unreadable)'}; ` +
+                            'pass --force to replace it, or run `switchbot uninstall` first.');
+                    }
+                    fs.unlinkSync(linkPath);
+                }
+                else {
+                    throw new Error(`${linkPath} exists and is not a symlink; refusing to clobber (move it aside and re-run)`);
+                }
+            }
+            fs.mkdirSync(path.dirname(linkPath), { recursive: true });
+            // Windows: regular symlinks require admin or Developer Mode. A
+            // directory junction works for any user and is transparent to
+            // most tools. Unix: plain symlink.
+            const linkType = process.platform === 'win32' ? 'junction' : 'dir';
+            fs.symlinkSync(target, linkPath, linkType);
+            ctx.skillLinkPath = linkPath;
+            ctx.skillLinkCreated = true;
+        },
+        undo(ctx) {
+            if (!ctx.skillLinkCreated || !ctx.skillLinkPath)
+                return;
+            try {
+                fs.unlinkSync(ctx.skillLinkPath);
+            }
+            catch {
+                // best-effort
+            }
+        },
+    };
+}
+function defaultDoctorSpawner(cliPath, profile) {
+    const args = profile === 'default' ? [cliPath, 'doctor', '--json'] : [cliPath, '--profile', profile, 'doctor', '--json'];
+    const r = spawnSync(process.execPath, args, { encoding: 'utf-8' });
+    return {
+        ok: r.status === 0,
+        exitCode: r.status,
+        stdout: r.stdout ?? '',
+        stderr: r.stderr ?? '',
+    };
+}
+export function stepDoctorVerify(opts = { cliPath: '' }) {
+    const spawner = opts.spawner ?? defaultDoctorSpawner;
+    const cliPath = opts.cliPath;
+    return {
+        name: 'doctor-verify',
+        description: 'Verify the install with switchbot doctor --json',
+        execute(ctx) {
+            if (!cliPath) {
+                // Fail closed: without a known CLI path we cannot spawn doctor.
+                // Mark not-ok but still succeed (no rollback).
+                ctx.doctorOk = false;
+                ctx.doctorReport = { skipped: true, reason: 'no cliPath provided' };
+                return;
+            }
+            const r = spawner(cliPath, ctx.profile);
+            ctx.doctorOk = r.ok;
+            try {
+                ctx.doctorReport = r.stdout ? JSON.parse(r.stdout) : { exitCode: r.exitCode, stderr: r.stderr };
+            }
+            catch {
+                ctx.doctorReport = { exitCode: r.exitCode, stdout: r.stdout, stderr: r.stderr };
+            }
+            // NOTE: never throw here. Doctor failure is reported; rollback is
+            // opt-in by the user via `switchbot uninstall`.
+        },
+        undo() {
+            return;
+        },
+    };
+}
+//# sourceMappingURL=default-steps.js.map

package/dist/install/default-steps.js.map

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

package/dist/install/preflight.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Install-orchestrator pre-flight (Phase 3A · F5).
+ *
+ * Pure library — no CLI entry. Consumers (e.g. a future
+ * `openclaw plugins install` command) call `runPreflight()` and decide
+ * whether to proceed based on the returned result. Nothing here mutates
+ * user state: every check is read-only.
+ *
+ * The check list mirrors `docs/design/phase3-install.md` step 1 minus
+ * the bits that require external services (npm registry / SwitchBot API
+ * reachability are left for the installer itself to probe when it has
+ * a plan to retry, since they are the flakiest of the lot).
+ */
+export type PreflightStatus = 'ok' | 'warn' | 'fail';
+export interface PreflightCheck {
+    name: string;
+    status: PreflightStatus;
+    message: string;
+    hint?: string;
+}
+export interface PreflightResult {
+    checks: PreflightCheck[];
+    /** True when no check is at 'fail'. Warnings are informational. */
+    ok: boolean;
+}
+export interface PreflightOptions {
+    /**
+     * Minimum required major version of Node.js. Defaults to 18 (current
+     * package.json "engines.node" floor).
+     */
+    minNodeMajor?: number;
+    /**
+     * Override process.version for deterministic tests.
+     */
+    nodeVersion?: string;
+    /**
+     * Override process.platform for tests.
+     */
+    platform?: NodeJS.Platform;
+    /**
+     * Target agent. When set to `claude-code` the preflight probes that
+     * `~/.claude/` (or the skills directory underneath it) is writable, so
+     * the later symlink-skill step fails fast with a clear message.
+     * Unset (or `none`/`cursor`/`copilot`) skips the check.
+     */
+    agent?: 'claude-code' | 'cursor' | 'copilot' | 'none';
+    /**
+     * Whether this install run will actually attempt to create the Claude
+     * skill link. When false, the agent-skills-dir check is skipped even if
+     * agent is `claude-code` (e.g. recipe-only installs without --skill-path).
+     *
+     * Defaults to true for backward compatibility when `agent=claude-code`.
+     */
+    expectSkillLink?: boolean;
+}
+/**
+ * Run every pre-flight check and return a combined result. Safe to
+ * call multiple times; no state is cached.
+ */
+export declare function runPreflight(options?: PreflightOptions): Promise<PreflightResult>;

package/dist/install/preflight.js

@@ -0,0 +1,213 @@
+/**
+ * Install-orchestrator pre-flight (Phase 3A · F5).
+ *
+ * Pure library — no CLI entry. Consumers (e.g. a future
+ * `openclaw plugins install` command) call `runPreflight()` and decide
+ * whether to proceed based on the returned result. Nothing here mutates
+ * user state: every check is read-only.
+ *
+ * The check list mirrors `docs/design/phase3-install.md` step 1 minus
+ * the bits that require external services (npm registry / SwitchBot API
+ * reachability are left for the installer itself to probe when it has
+ * a plan to retry, since they are the flakiest of the lot).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { resolvePolicyPath, loadPolicyFile, PolicyFileNotFoundError } from '../policy/load.js';
+import { validateLoadedPolicy } from '../policy/validate.js';
+import { selectCredentialStore } from '../credentials/keychain.js';
+function parseMajor(version) {
+    const m = /^v?(\d+)\./.exec(version);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    return Number.isFinite(n) ? n : null;
+}
+function checkNodeVersion(opts) {
+    const required = opts.minNodeMajor ?? 18;
+    const version = opts.nodeVersion ?? process.version;
+    const major = parseMajor(version);
+    if (major === null) {
+        return {
+            name: 'node',
+            status: 'fail',
+            message: `unrecognised Node.js version string: ${version}`,
+            hint: 'reinstall Node.js from https://nodejs.org',
+        };
+    }
+    if (major < required) {
+        return {
+            name: 'node',
+            status: 'fail',
+            message: `Node.js ${version} < required v${required}`,
+            hint: `upgrade Node.js to v${required} or later`,
+        };
+    }
+    return { name: 'node', status: 'ok', message: `Node.js ${version}` };
+}
+function checkPolicy() {
+    const policyPath = resolvePolicyPath();
+    try {
+        const loaded = loadPolicyFile(policyPath);
+        const result = validateLoadedPolicy(loaded);
+        if (result.valid) {
+            return {
+                name: 'policy',
+                status: 'ok',
+                message: `policy at ${policyPath} validates (v${result.schemaVersion ?? '?'})`,
+            };
+        }
+        return {
+            name: 'policy',
+            status: 'warn',
+            message: `policy at ${policyPath} has ${result.errors.length} validation error(s)`,
+            hint: 'run "switchbot policy validate" to see details before installing',
+        };
+    }
+    catch (err) {
+        if (err instanceof PolicyFileNotFoundError) {
+            return {
+                name: 'policy',
+                status: 'ok',
+                message: `no policy at ${policyPath} (installer will scaffold one)`,
+            };
+        }
+        return {
+            name: 'policy',
+            status: 'warn',
+            message: `policy at ${policyPath} is unreadable: ${err instanceof Error ? err.message : String(err)}`,
+            hint: 'move the file aside, then re-run — the installer will scaffold a fresh copy',
+        };
+    }
+}
+async function checkKeychain() {
+    try {
+        const store = await selectCredentialStore();
+        const desc = store.describe();
+        if (desc.writable) {
+            return {
+                name: 'keychain',
+                status: 'ok',
+                message: `credential backend: ${desc.backend}`,
+            };
+        }
+        return {
+            name: 'keychain',
+            status: 'warn',
+            message: `credential backend ${desc.backend} is not writable — will fall back to file`,
+            hint: desc.notes ?? 'install the OS keychain helper to get native credential storage',
+        };
+    }
+    catch (err) {
+        return {
+            name: 'keychain',
+            status: 'warn',
+            message: `keychain probe failed: ${err instanceof Error ? err.message : String(err)}`,
+            hint: 'the installer will fall back to the file backend',
+        };
+    }
+}
+function checkHomeDirWritable() {
+    const home = os.homedir();
+    const switchbotDir = path.join(home, '.switchbot');
+    try {
+        const homeStat = fs.statSync(home);
+        if (!homeStat.isDirectory()) {
+            return {
+                name: 'home',
+                status: 'fail',
+                message: `home path is not a directory: ${home}`,
+                hint: 'check your HOME/USERPROFILE environment configuration',
+            };
+        }
+        if (fs.existsSync(switchbotDir)) {
+            const sbStat = fs.statSync(switchbotDir);
+            if (!sbStat.isDirectory()) {
+                return {
+                    name: 'home',
+                    status: 'fail',
+                    message: `${switchbotDir} exists but is not a directory`,
+                    hint: 'move the file aside and re-run install',
+                };
+            }
+            fs.accessSync(switchbotDir, fs.constants.W_OK);
+            return { name: 'home', status: 'ok', message: `writable: ${switchbotDir}` };
+        }
+        fs.accessSync(home, fs.constants.W_OK);
+        return { name: 'home', status: 'ok', message: `writable: ${home}` };
+    }
+    catch (err) {
+        return {
+            name: 'home',
+            status: 'fail',
+            message: `cannot write under ${home}: ${err instanceof Error ? err.message : String(err)}`,
+            hint: 'check ownership and permissions on your home directory',
+        };
+    }
+}
+function nearestExistingPath(target) {
+    let cur = target;
+    while (true) {
+        if (fs.existsSync(cur))
+            return cur;
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            return null;
+        cur = parent;
+    }
+}
+function checkAgentSkillDirWritable(opts) {
+    const shouldCheck = opts.agent === 'claude-code' && (opts.expectSkillLink ?? true);
+    if (!shouldCheck)
+        return null;
+    const home = os.homedir();
+    const target = path.join(home, '.claude', 'skills');
+    try {
+        const existing = nearestExistingPath(target);
+        if (!existing) {
+            return {
+                name: 'agent-skills-dir',
+                status: 'fail',
+                message: `cannot resolve an existing parent for ${target}`,
+                hint: 'check your home directory path and permissions',
+            };
+        }
+        const stat = fs.statSync(existing);
+        if (!stat.isDirectory()) {
+            return {
+                name: 'agent-skills-dir',
+                status: 'fail',
+                message: `path component is not a directory: ${existing}`,
+                hint: 'move the blocking file aside and re-run install',
+            };
+        }
+        fs.accessSync(existing, fs.constants.W_OK);
+        return { name: 'agent-skills-dir', status: 'ok', message: `writable: ${target}` };
+    }
+    catch (err) {
+        return {
+            name: 'agent-skills-dir',
+            status: 'fail',
+            message: `cannot write to ${target}: ${err instanceof Error ? err.message : String(err)}`,
+            hint: 'open Claude Code once (it will create ~/.claude) or create the directory manually',
+        };
+    }
+}
+/**
+ * Run every pre-flight check and return a combined result. Safe to
+ * call multiple times; no state is cached.
+ */
+export async function runPreflight(options = {}) {
+    const checks = [];
+    checks.push(checkNodeVersion(options));
+    checks.push(checkPolicy());
+    checks.push(await checkKeychain());
+    checks.push(checkHomeDirWritable());
+    const agentCheck = checkAgentSkillDirWritable(options);
+    if (agentCheck)
+        checks.push(agentCheck);
+    const ok = checks.every((c) => c.status !== 'fail');
+    return { checks, ok };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/install/preflight.js.map

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