@switchbot/openapi-cli 3.2.1 → 3.3.0

package/dist/install/preflight.d.ts

@@ -1,60 +0,0 @@
-/**
- * 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

@@ -1,213 +0,0 @@
-/**
- * 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

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

package/dist/install/steps.d.ts

@@ -1,61 +0,0 @@
-/**
- * Install-orchestrator step runner (Phase 3A · F5).
- *
- * Each step has a deterministic `execute` and a matching `undo`. The
- * runner executes steps in order; on any failure it walks the
- * already-completed steps in reverse and invokes their `undo`. If an
- * `undo` itself fails, the error is captured and surfaced — the
- * runner does NOT abort the rollback. The caller gets a full report
- * and can decide how to surface partial cleanup failures.
- *
- * The module is intentionally agnostic of what steps do; consumers
- * (future `openclaw plugins install`) plug in concrete steps like
- * "npm i -g the CLI" or "write the credential to the keychain".
- */
-export interface InstallStep<Ctx = unknown> {
-    name: string;
-    description?: string;
-    execute: (ctx: Ctx) => Promise<void> | void;
-    undo: (ctx: Ctx) => Promise<void> | void;
-}
-export type StepOutcome = {
-    step: string;
-    status: 'succeeded';
-} | {
-    step: string;
-    status: 'failed';
-    error: string;
-} | {
-    step: string;
-    status: 'rolled-back';
-} | {
-    step: string;
-    status: 'rollback-failed';
-    error: string;
-} | {
-    step: string;
-    status: 'skipped';
-};
-export interface InstallReport {
-    ok: boolean;
-    /** Outcome entries in execution order (execution first, then rollback). */
-    outcomes: StepOutcome[];
-    /** Name of the step that caused the rollback, if any. */
-    failedAt?: string;
-}
-export interface RunInstallOptions<Ctx> {
-    /** Context object passed to every step. Defaults to `{}`. */
-    context?: Ctx;
-    /**
-     * When set, the runner stops immediately after executing this step
-     * (even on success). Useful for tests that want to exercise partial
-     * state without needing every step to succeed.
-     */
-    stopAfter?: string;
-}
-/**
- * Run the given steps in order. On the first failure, the runner
- * walks already-executed steps in reverse and invokes each step's
- * undo. Returns a report describing every step's fate.
- */
-export declare function runInstall<Ctx = Record<string, unknown>>(steps: InstallStep<Ctx>[], options?: RunInstallOptions<Ctx>): Promise<InstallReport>;

package/dist/install/steps.js

@@ -1,68 +0,0 @@
-/**
- * Install-orchestrator step runner (Phase 3A · F5).
- *
- * Each step has a deterministic `execute` and a matching `undo`. The
- * runner executes steps in order; on any failure it walks the
- * already-completed steps in reverse and invokes their `undo`. If an
- * `undo` itself fails, the error is captured and surfaced — the
- * runner does NOT abort the rollback. The caller gets a full report
- * and can decide how to surface partial cleanup failures.
- *
- * The module is intentionally agnostic of what steps do; consumers
- * (future `openclaw plugins install`) plug in concrete steps like
- * "npm i -g the CLI" or "write the credential to the keychain".
- */
-/**
- * Run the given steps in order. On the first failure, the runner
- * walks already-executed steps in reverse and invokes each step's
- * undo. Returns a report describing every step's fate.
- */
-export async function runInstall(steps, options = {}) {
-    const ctx = (options.context ?? {});
-    const outcomes = [];
-    const executed = [];
-    let failedAt;
-    for (const step of steps) {
-        try {
-            await step.execute(ctx);
-            outcomes.push({ step: step.name, status: 'succeeded' });
-            executed.push(step);
-        }
-        catch (err) {
-            outcomes.push({
-                step: step.name,
-                status: 'failed',
-                error: err instanceof Error ? err.message : String(err),
-            });
-            failedAt = step.name;
-            break;
-        }
-        if (options.stopAfter === step.name)
-            break;
-    }
-    if (failedAt !== undefined) {
-        // Roll back completed steps in reverse. Undo failures are captured
-        // but do not abort further rollback attempts — the goal is to
-        // leave as little residue as possible.
-        for (let i = executed.length - 1; i >= 0; i--) {
-            const step = executed[i];
-            try {
-                await step.undo(ctx);
-                outcomes.push({ step: step.name, status: 'rolled-back' });
-            }
-            catch (err) {
-                outcomes.push({
-                    step: step.name,
-                    status: 'rollback-failed',
-                    error: err instanceof Error ? err.message : String(err),
-                });
-            }
-        }
-    }
-    return {
-        ok: failedAt === undefined,
-        outcomes,
-        ...(failedAt !== undefined ? { failedAt } : {}),
-    };
-}
-//# sourceMappingURL=steps.js.map

package/dist/install/steps.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/install/steps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmCH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAyB,EACzB,UAAkC,EAAE;IAEpC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,IAAK,EAAU,CAAQ,CAAC;IACpD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,IAAI,QAA4B,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;YACrB,MAAM;QACR,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI;YAAE,MAAM;IAC7C,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,mEAAmE;QACnE,8DAA8D;QAC9D,uCAAuC;QACvC,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;YAC5D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,iBAAiB;oBACzB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,QAAQ,KAAK,SAAS;QAC1B,QAAQ;QACR,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC"}

package/dist/lib/command-keywords.d.ts

@@ -1,5 +0,0 @@
-export declare const COMMAND_KEYWORDS: Array<{
-    pattern: RegExp;
-    command: string;
-}>;
-export declare function inferCommandFromIntent(intent: string): string | undefined;

package/dist/lib/command-keywords.js

@@ -1,18 +0,0 @@
-export const COMMAND_KEYWORDS = [
-    { pattern: /\boff\b|\bturn.?off\b|\bstop\b/i, command: 'turnOff' },
-    { pattern: /\bon\b|\bturn.?on\b|\bstart\b/i, command: 'turnOn' },
-    { pattern: /\bpress\b|\bclick\b|\btap\b/i, command: 'press' },
-    { pattern: /\block\b/i, command: 'lock' },
-    { pattern: /\bunlock\b/i, command: 'unlock' },
-    { pattern: /\bopen\b|\braise\b|\bup\b/i, command: 'open' },
-    { pattern: /\bclose\b|\blower\b|\bdown\b/i, command: 'close' },
-    { pattern: /\bpause\b/i, command: 'pause' },
-];
-export function inferCommandFromIntent(intent) {
-    for (const k of COMMAND_KEYWORDS) {
-        if (k.pattern.test(intent))
-            return k.command;
-    }
-    return undefined;
-}
-//# sourceMappingURL=command-keywords.js.map

package/dist/lib/command-keywords.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-keywords.js","sourceRoot":"","sources":["../../src/lib/command-keywords.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,EAAE,OAAO,EAAE,iCAAiC,EAAE,OAAO,EAAE,SAAS,EAAE;IAClE,EAAE,OAAO,EAAE,gCAAgC,EAAE,OAAO,EAAE,QAAQ,EAAE;IAChE,EAAE,OAAO,EAAE,8BAA8B,EAAE,OAAO,EAAE,OAAO,EAAE;IAC7D,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE;IACzC,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE;IAC7C,EAAE,OAAO,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,EAAE;IAC1D,EAAE,OAAO,EAAE,+BAA+B,EAAE,OAAO,EAAE,OAAO,EAAE;IAC9D,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE;CAC5C,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/daemon-state.d.ts

@@ -1,24 +0,0 @@
-export declare const DAEMON_PID_FILE: string;
-export declare const DAEMON_LOG_FILE: string;
-export declare const DAEMON_STATE_FILE: string;
-export declare const HEALTHZ_PID_FILE: string;
-export interface DaemonState {
-    status: 'starting' | 'running' | 'stopped' | 'failed';
-    pid: number | null;
-    startedAt?: string;
-    stoppedAt?: string;
-    failedAt?: string;
-    failureReason?: string;
-    logFile: string;
-    pidFile: string;
-    stateFile: string;
-    healthzPid?: number | null;
-    healthzPort?: number | null;
-    healthzPidFile?: string;
-    lastReloadAt?: string;
-    lastReloadStatus?: 'ok' | 'failed';
-    lastReloadMessage?: string;
-}
-export declare function writeDaemonState(state: DaemonState): void;
-export declare function readDaemonState(): DaemonState | null;
-export declare function removeDaemonState(): void;

package/dist/lib/daemon-state.js

@@ -1,47 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-function getStateDir() {
-    return path.join(os.homedir(), '.switchbot');
-}
-function getDaemonPidFile() {
-    return path.join(getStateDir(), 'daemon.pid');
-}
-function getDaemonLogFile() {
-    return path.join(getStateDir(), 'daemon.log');
-}
-function getDaemonStateFile() {
-    return path.join(getStateDir(), 'daemon.state.json');
-}
-function getHealthzPidFile() {
-    return path.join(getStateDir(), 'healthz.pid');
-}
-export const DAEMON_PID_FILE = getDaemonPidFile();
-export const DAEMON_LOG_FILE = getDaemonLogFile();
-export const DAEMON_STATE_FILE = getDaemonStateFile();
-export const HEALTHZ_PID_FILE = getHealthzPidFile();
-function ensureStateDir() {
-    fs.mkdirSync(getStateDir(), { recursive: true, mode: 0o700 });
-}
-export function writeDaemonState(state) {
-    ensureStateDir();
-    fs.writeFileSync(getDaemonStateFile(), JSON.stringify(state, null, 2), { mode: 0o600 });
-}
-export function readDaemonState() {
-    try {
-        const raw = fs.readFileSync(getDaemonStateFile(), 'utf-8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-export function removeDaemonState() {
-    try {
-        fs.unlinkSync(getDaemonStateFile());
-    }
-    catch {
-        // best effort
-    }
-}
-//# sourceMappingURL=daemon-state.js.map

package/dist/lib/daemon-state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"daemon-state.js","sourceRoot":"","sources":["../../src/lib/daemon-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,WAAW;IAClB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,mBAAmB,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,EAAE,CAAC;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,EAAE,CAAC;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,EAAE,CAAC;AAoBpD,SAAS,cAAc;IACrB,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IACjD,cAAc,EAAE,CAAC;IACjB,EAAE,CAAC,aAAa,CAAC,kBAAkB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC"}

package/dist/lib/destructive-mode.d.ts

@@ -1,2 +0,0 @@
-export declare function allowsDirectDestructiveExecution(profile?: string | undefined): boolean;
-export declare function destructiveExecutionHint(): string;

package/dist/lib/destructive-mode.js

@@ -1,13 +0,0 @@
-import { getActiveProfile } from './request-context.js';
-const DIRECT_DESTRUCTIVE_PROFILES = new Set(['dev', 'development']);
-export function allowsDirectDestructiveExecution(profile = getActiveProfile()) {
-    if (process.env.SWITCHBOT_ALLOW_DIRECT_DESTRUCTIVE === '1')
-        return true;
-    if (!profile)
-        return false;
-    return DIRECT_DESTRUCTIVE_PROFILES.has(profile.toLowerCase());
-}
-export function destructiveExecutionHint() {
-    return "Use 'switchbot plan save <file>' -> 'switchbot plan review <planId>' -> 'switchbot plan approve <planId>' -> 'switchbot plan execute <planId>' instead.";
-}
-//# sourceMappingURL=destructive-mode.js.map

package/dist/lib/destructive-mode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"destructive-mode.js","sourceRoot":"","sources":["../../src/lib/destructive-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;AAEpE,MAAM,UAAU,gCAAgC,CAAC,OAAO,GAAG,gBAAgB,EAAE;IAC3E,IAAI,OAAO,CAAC,GAAG,CAAC,kCAAkC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,2BAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,yJAAyJ,CAAC;AACnK,CAAC"}