@switchbot/openapi-cli 1.0.1 → 1.2.0

package/dist/commands/doctor.js

@@ -0,0 +1,147 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { printJson, isJsonMode } from '../utils/output.js';
+import { getEffectiveCatalog } from '../devices/catalog.js';
+import { configFilePath, listProfiles } from '../config.js';
+import { describeCache } from '../devices/cache.js';
+async function checkCredentials() {
+    const envOk = Boolean(process.env.SWITCHBOT_TOKEN && process.env.SWITCHBOT_SECRET);
+    if (envOk)
+        return { name: 'credentials', status: 'ok', detail: 'env: SWITCHBOT_TOKEN + SWITCHBOT_SECRET' };
+    const file = configFilePath();
+    if (!fs.existsSync(file)) {
+        return {
+            name: 'credentials',
+            status: 'fail',
+            detail: `No env vars and no config at ${file}. Run 'switchbot config set-token'.`,
+        };
+    }
+    try {
+        const raw = fs.readFileSync(file, 'utf-8');
+        const cfg = JSON.parse(raw);
+        if (!cfg.token || !cfg.secret) {
+            return { name: 'credentials', status: 'fail', detail: `Config ${file} missing token/secret.` };
+        }
+        return { name: 'credentials', status: 'ok', detail: `file: ${file}` };
+    }
+    catch (err) {
+        return {
+            name: 'credentials',
+            status: 'fail',
+            detail: `Unreadable config ${file}: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+function checkProfiles() {
+    const dir = path.join(os.homedir(), '.switchbot', 'profiles');
+    if (!fs.existsSync(dir)) {
+        return { name: 'profiles', status: 'ok', detail: 'no profile dir (default profile only)' };
+    }
+    const profiles = listProfiles();
+    return {
+        name: 'profiles',
+        status: 'ok',
+        detail: profiles.length ? `found ${profiles.length}: ${profiles.join(', ')}` : 'profile dir empty',
+    };
+}
+function checkClockSkew() {
+    const now = Date.now();
+    const drift = now - Math.floor(now / 1000) * 1000;
+    // HMAC signing uses ms timestamps — we can't detect remote skew without a
+    // round-trip, but we can flag if the local clock has NTP issues via the
+    // classic "jumps back" pattern. Best-effort: just report local time.
+    const iso = new Date().toISOString();
+    return { name: 'clock', status: 'ok', detail: `local time ${iso} (drift check needs API round-trip)` };
+    void drift;
+}
+function checkCatalog() {
+    const catalog = getEffectiveCatalog();
+    const missingRole = catalog.filter((e) => !e.role).length;
+    if (catalog.length === 0) {
+        return { name: 'catalog', status: 'fail', detail: 'catalog empty — package corrupt?' };
+    }
+    const status = missingRole > 0 ? 'warn' : 'ok';
+    return {
+        name: 'catalog',
+        status,
+        detail: `${catalog.length} types loaded${missingRole > 0 ? `, ${missingRole} missing role` : ''}`,
+    };
+}
+function checkCache() {
+    try {
+        const info = describeCache();
+        const parts = [];
+        parts.push(info.list.exists ? `list: ${info.list.path}` : 'list: (none)');
+        parts.push(info.status.exists ? `status: ${info.status.entryCount} entries` : 'status: (none)');
+        return { name: 'cache', status: 'ok', detail: parts.join(' | ') };
+    }
+    catch (err) {
+        return { name: 'cache', status: 'warn', detail: `cache inspect failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+function checkQuotaFile() {
+    const p = path.join(os.homedir(), '.switchbot', 'quota.json');
+    if (!fs.existsSync(p)) {
+        return { name: 'quota', status: 'ok', detail: 'no quota file yet (will be created on first call)' };
+    }
+    try {
+        const raw = fs.readFileSync(p, 'utf-8');
+        JSON.parse(raw);
+        return { name: 'quota', status: 'ok', detail: p };
+    }
+    catch {
+        return { name: 'quota', status: 'warn', detail: `${p} unreadable/malformed — run 'switchbot quota reset'` };
+    }
+}
+function checkNodeVersion() {
+    const major = Number(process.versions.node.split('.')[0]);
+    if (Number.isFinite(major) && major < 18) {
+        return { name: 'node', status: 'fail', detail: `Node ${process.versions.node} — minimum is 18` };
+    }
+    return { name: 'node', status: 'ok', detail: `Node ${process.versions.node}` };
+}
+export function registerDoctorCommand(program) {
+    program
+        .command('doctor')
+        .description('Self-check: credentials, catalog, cache, quota, profiles, Node version')
+        .addHelpText('after', `
+Runs a battery of local sanity checks and exits with code 0 only when every
+check is 'ok'. 'warn' → exit 0 (informational); 'fail' → exit 1.
+
+Examples:
+  $ switchbot doctor
+  $ switchbot --json doctor | jq '.checks[] | select(.status != "ok")'
+`)
+        .action(async () => {
+        const checks = [
+            checkNodeVersion(),
+            await checkCredentials(),
+            checkProfiles(),
+            checkCatalog(),
+            checkCache(),
+            checkQuotaFile(),
+            checkClockSkew(),
+        ];
+        const summary = {
+            ok: checks.filter((c) => c.status === 'ok').length,
+            warn: checks.filter((c) => c.status === 'warn').length,
+            fail: checks.filter((c) => c.status === 'fail').length,
+        };
+        const overallFail = summary.fail > 0;
+        if (isJsonMode()) {
+            printJson({ overall: overallFail ? 'fail' : summary.warn > 0 ? 'warn' : 'ok', summary, checks });
+        }
+        else {
+            for (const c of checks) {
+                const icon = c.status === 'ok' ? '✓' : c.status === 'warn' ? '!' : '✗';
+                console.log(`${icon} ${c.name.padEnd(12)} ${c.detail}`);
+            }
+            console.log('');
+            console.log(`${summary.ok} ok, ${summary.warn} warn, ${summary.fail} fail`);
+        }
+        if (overallFail)
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/events.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import http from 'node:http';
+interface EventRecord {
+    t: string;
+    remote: string;
+    path: string;
+    body: unknown;
+    matched: boolean;
+}
+export declare function startReceiver(port: number, pathMatch: string, filter: {
+    deviceId?: string;
+    type?: string;
+} | null, onEvent: (ev: EventRecord) => void): http.Server;
+export declare function registerEventsCommand(program: Command): void;
+export {};

package/dist/commands/events.js

@@ -0,0 +1,188 @@
+import http from 'node:http';
+import { printJson, isJsonMode, handleError, UsageError } from '../utils/output.js';
+const DEFAULT_PORT = 3000;
+const DEFAULT_PATH = '/';
+const MAX_BODY_BYTES = 1_000_000;
+function matchFilter(body, filter) {
+    if (!filter)
+        return true;
+    if (!body || typeof body !== 'object')
+        return false;
+    const b = body;
+    const ctx = (b.context ?? b);
+    if (filter.deviceId && ctx.deviceMac !== filter.deviceId && ctx.deviceId !== filter.deviceId) {
+        return false;
+    }
+    if (filter.type && ctx.deviceType !== filter.type) {
+        return false;
+    }
+    return true;
+}
+function parseFilter(flag) {
+    if (!flag)
+        return null;
+    const allowed = new Set(['deviceId', 'type']);
+    const out = {};
+    for (const pair of flag.split(',')) {
+        const eq = pair.indexOf('=');
+        if (eq === -1 || eq === 0) {
+            throw new UsageError(`Invalid --filter pair "${pair.trim()}". Expected "key=value". Supported keys: deviceId, type.`);
+        }
+        const k = pair.slice(0, eq).trim();
+        const v = pair.slice(eq + 1).trim();
+        if (!v) {
+            throw new UsageError(`Empty value for --filter key "${k}". Expected "key=value". Supported keys: deviceId, type.`);
+        }
+        if (!allowed.has(k)) {
+            throw new UsageError(`Unknown --filter key "${k}". Supported keys: deviceId, type.`);
+        }
+        if (k === 'deviceId')
+            out.deviceId = v;
+        else if (k === 'type')
+            out.type = v;
+    }
+    return out;
+}
+export function startReceiver(port, pathMatch, filter, onEvent) {
+    const server = http.createServer((req, res) => {
+        if (req.method !== 'POST') {
+            res.statusCode = 405;
+            res.end('method not allowed');
+            return;
+        }
+        if (req.url !== pathMatch && pathMatch !== '*') {
+            res.statusCode = 404;
+            res.end('not found');
+            return;
+        }
+        const chunks = [];
+        let size = 0;
+        let bailed = false;
+        req.on('data', (c) => {
+            if (bailed)
+                return;
+            size += c.length;
+            if (size > MAX_BODY_BYTES) {
+                bailed = true;
+                res.statusCode = 413;
+                res.setHeader('connection', 'close');
+                res.end('payload too large');
+                // Drop remaining upload without destroying the socket mid-flush.
+                req.on('data', () => { });
+                return;
+            }
+            chunks.push(c);
+        });
+        req.on('end', () => {
+            if (bailed)
+                return;
+            const raw = Buffer.concat(chunks).toString('utf-8');
+            let body = raw;
+            try {
+                body = JSON.parse(raw);
+            }
+            catch {
+                // keep raw
+            }
+            const matched = matchFilter(body, filter);
+            onEvent({
+                t: new Date().toISOString(),
+                remote: `${req.socket.remoteAddress ?? ''}:${req.socket.remotePort ?? ''}`,
+                path: req.url ?? '/',
+                body,
+                matched,
+            });
+            res.statusCode = 204;
+            res.end();
+        });
+    });
+    server.listen(port);
+    return server;
+}
+export function registerEventsCommand(program) {
+    const events = program
+        .command('events')
+        .description('Subscribe to local webhook events forwarded by SwitchBot');
+    events
+        .command('tail')
+        .description('Run a local HTTP receiver and print incoming webhook events as JSONL')
+        .option('--port <n>', `Local port to listen on (default ${DEFAULT_PORT})`, String(DEFAULT_PORT))
+        .option('--path <p>', `HTTP path to match (default "${DEFAULT_PATH}"; use "*" for all paths)`, DEFAULT_PATH)
+        .option('--filter <expr>', 'Filter events, e.g. "deviceId=ABC123" or "type=Bot" (comma-separated)')
+        .option('--max <n>', 'Stop after N matching events (default: run until Ctrl-C)')
+        .addHelpText('after', `
+SwitchBot posts events to a single webhook URL configured via:
+  $ switchbot webhook setup https://<your-public-host>/<path>
+
+'events tail' only runs the LOCAL receiver — it does not tunnel. Expose
+the port to the internet yourself (ngrok/cloudflared/reverse proxy) and
+point the SwitchBot webhook at that public URL.
+
+Output (JSONL, one event per line):
+  { "t": "<ISO>", "remote": "<ip:port>", "path": "/",
+    "body": <parsed JSON or raw string>, "matched": true }
+
+Filter grammar: comma-separated "key=value" pairs. Supported keys:
+  deviceId=<id>    match by context.deviceMac / context.deviceId
+  type=<type>      match by context.deviceType (e.g. "Bot", "WoMeter")
+
+Examples:
+  $ switchbot events tail --port 3000
+  $ switchbot events tail --port 3000 --filter deviceId=ABC123
+  $ switchbot events tail --filter 'type=WoMeter' --max 5 --json
+`)
+        .action(async (options) => {
+        try {
+            const port = Number(options.port);
+            if (!Number.isInteger(port) || port <= 0 || port > 65535) {
+                throw new UsageError(`Invalid --port "${options.port}". Must be 1..65535.`);
+            }
+            const maxMatched = options.max !== undefined ? Number(options.max) : null;
+            if (maxMatched !== null && (!Number.isFinite(maxMatched) || maxMatched < 1)) {
+                throw new UsageError(`Invalid --max "${options.max}". Must be a positive integer.`);
+            }
+            const filter = parseFilter(options.filter);
+            let matchedCount = 0;
+            const ac = new AbortController();
+            await new Promise((resolve, reject) => {
+                let server = null;
+                try {
+                    server = startReceiver(port, options.path, filter, (ev) => {
+                        if (!ev.matched)
+                            return;
+                        matchedCount++;
+                        if (isJsonMode()) {
+                            printJson(ev);
+                        }
+                        else {
+                            const when = new Date(ev.t).toLocaleTimeString();
+                            console.log(`[${when}] ${ev.remote} ${ev.path} ${JSON.stringify(ev.body)}`);
+                        }
+                        if (maxMatched !== null && matchedCount >= maxMatched) {
+                            ac.abort();
+                        }
+                    });
+                    server.on('error', (err) => reject(err));
+                }
+                catch (err) {
+                    reject(err);
+                    return;
+                }
+                const startMsg = `Listening on http://127.0.0.1:${port}${options.path} (Ctrl-C to stop)`;
+                if (!isJsonMode())
+                    console.error(startMsg);
+                const cleanup = () => {
+                    server?.close();
+                    resolve();
+                };
+                process.once('SIGINT', cleanup);
+                process.once('SIGTERM', cleanup);
+                ac.signal.addEventListener('abort', cleanup, { once: true });
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/commands/events.js.map

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

package/dist/commands/explain.d.ts

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

package/dist/commands/explain.js

@@ -0,0 +1,137 @@
+import { printJson, isJsonMode, handleError } from '../utils/output.js';
+import { describeDevice, fetchDeviceList, } from '../lib/devices.js';
+function deviceName(d) {
+    return d.deviceName;
+}
+export function registerExplainCommand(devices) {
+    devices
+        .command('explain')
+        .description('One-shot device summary: metadata + capabilities + live status + children (for Hubs)')
+        .argument('<deviceId>', 'Device ID to explain')
+        .option('--no-live', 'Skip the live status API call (catalog-only output)')
+        .addHelpText('after', `
+'explain' is the agent-friendly sibling of 'describe'. It combines:
+  - metadata (id, name, type, category, role)
+  - live status (unless --no-live)
+  - commands with idempotent/destructive flags
+  - children (for Hub devices: IR remotes bound to this hub)
+  - suggested actions (pre-baked common usages)
+  - warnings (deprecated types, missing cloud service, etc.)
+
+Examples:
+  $ switchbot devices explain <id>
+  $ switchbot --json devices explain <id> | jq '.commands[] | select(.destructive)'
+  $ switchbot devices explain <id> --no-live
+`)
+        .action(async (deviceId, options) => {
+        try {
+            const wantLive = options.live !== false;
+            const desc = await describeDevice(deviceId, { live: wantLive });
+            const warnings = [];
+            if (desc.isPhysical && !desc.device.enableCloudService) {
+                warnings.push('Cloud service disabled on this device — commands will fail.');
+            }
+            if (!desc.catalog) {
+                warnings.push(`No catalog entry for type "${desc.typeName}". Commands cannot be validated offline.`);
+            }
+            let children = [];
+            if (desc.catalog?.role === 'hub') {
+                const body = await fetchDeviceList();
+                children = body.infraredRemoteList
+                    .filter((ir) => ir.hubDeviceId === deviceId)
+                    .map((ir) => ({ deviceId: ir.deviceId, name: ir.deviceName, type: ir.remoteType }));
+            }
+            const caps = desc.capabilities;
+            const commands = caps && 'commands' in caps
+                ? caps.commands.map((c) => ({
+                    command: c.command,
+                    parameter: c.parameter,
+                    idempotent: c.idempotent,
+                    destructive: c.destructive,
+                }))
+                : [];
+            const statusFields = caps && 'statusFields' in caps ? caps.statusFields : [];
+            const liveStatus = caps && 'liveStatus' in caps ? caps.liveStatus : undefined;
+            const location = desc.isPhysical
+                ? {
+                    family: desc.device.familyName,
+                    room: desc.device.roomName ?? undefined,
+                }
+                : desc.inheritedLocation
+                    ? { family: desc.inheritedLocation.family, room: desc.inheritedLocation.room }
+                    : undefined;
+            const result = {
+                deviceId,
+                type: desc.typeName,
+                category: desc.isPhysical ? 'physical' : 'ir',
+                name: deviceName(desc.device),
+                role: desc.catalog?.role ?? null,
+                readOnly: desc.catalog?.readOnly ?? false,
+                location,
+                liveStatus,
+                commands,
+                statusFields,
+                children,
+                suggestedActions: desc.suggestedActions,
+                warnings,
+            };
+            if (isJsonMode()) {
+                printJson(result);
+                return;
+            }
+            printHuman(result);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+function printHuman(r) {
+    console.log(`# ${r.name} (${r.deviceId})`);
+    console.log(`type:     ${r.type} [${r.category}${r.role ? ', ' + r.role : ''}${r.readOnly ? ', read-only' : ''}]`);
+    if (r.location?.family || r.location?.room) {
+        const loc = [r.location?.family, r.location?.room].filter(Boolean).join(' / ');
+        console.log(`location: ${loc}`);
+    }
+    if (r.warnings.length) {
+        console.log('warnings:');
+        for (const w of r.warnings)
+            console.log(`  ! ${w}`);
+    }
+    if (r.liveStatus && !('error' in r.liveStatus)) {
+        console.log('live status:');
+        for (const [k, v] of Object.entries(r.liveStatus)) {
+            console.log(`  ${k}: ${JSON.stringify(v)}`);
+        }
+    }
+    else if (r.liveStatus && 'error' in r.liveStatus) {
+        console.log(`live status: error — ${r.liveStatus.error}`);
+    }
+    if (r.commands.length) {
+        console.log('commands:');
+        for (const c of r.commands) {
+            const flags = [c.idempotent && 'idempotent', c.destructive && 'destructive']
+                .filter(Boolean)
+                .join(', ');
+            const suffix = flags ? `  [${flags}]` : '';
+            console.log(`  ${c.command}${c.parameter !== '—' ? ` <${c.parameter}>` : ''}${suffix}`);
+        }
+    }
+    if (r.statusFields.length) {
+        console.log(`status fields: ${r.statusFields.join(', ')}`);
+    }
+    if (r.children.length) {
+        console.log(`children (${r.children.length}):`);
+        for (const c of r.children) {
+            console.log(`  ${c.deviceId}  ${c.name}  [${c.type}]`);
+        }
+    }
+    if (r.suggestedActions.length) {
+        console.log('suggested:');
+        for (const s of r.suggestedActions) {
+            const param = s.parameter ? ` ${s.parameter}` : '';
+            console.log(`  ${s.description}: ${s.command}${param}`);
+        }
+    }
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

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

package/dist/commands/history.d.ts

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

package/dist/commands/history.js

@@ -0,0 +1,104 @@
+import path from 'node:path';
+import os from 'node:os';
+import { printJson, isJsonMode, handleError } from '../utils/output.js';
+import { readAudit } from '../utils/audit.js';
+import { executeCommand } from '../lib/devices.js';
+const DEFAULT_AUDIT = path.join(os.homedir(), '.switchbot', 'audit.log');
+export function registerHistoryCommand(program) {
+    const history = program
+        .command('history')
+        .description('View and replay commands recorded via --audit-log')
+        .addHelpText('after', `
+Every 'devices command' run with --audit-log is appended as JSONL to the
+audit file (default ~/.switchbot/audit.log). 'history show' prints the file,
+'history replay <n>' re-runs the Nth entry (1-indexed, most-recent last).
+
+Examples:
+  $ switchbot --audit-log devices command <id> turnOff
+  $ switchbot history show --limit 10
+  $ switchbot history replay 3
+`);
+    history
+        .command('show')
+        .description('Print recent audit entries')
+        .option('--file <path>', `Path to the audit log (default ${DEFAULT_AUDIT})`)
+        .option('--limit <n>', 'Show only the last N entries')
+        .action((options) => {
+        const file = options.file ?? DEFAULT_AUDIT;
+        const entries = readAudit(file);
+        const limited = options.limit !== undefined
+            ? entries.slice(-Math.max(1, Number(options.limit) || 1))
+            : entries;
+        if (isJsonMode()) {
+            printJson({ file, total: entries.length, entries: limited });
+            return;
+        }
+        if (entries.length === 0) {
+            console.log(`(no entries in ${file})`);
+            return;
+        }
+        const startIdx = entries.length - limited.length;
+        limited.forEach((e, i) => {
+            const idx = startIdx + i + 1;
+            const mark = e.result === 'error' ? '✗' : e.dryRun ? '◦' : '✓';
+            const param = e.parameter !== undefined && e.parameter !== 'default'
+                ? ` ${JSON.stringify(e.parameter)}`
+                : '';
+            const err = e.error ? `  [err: ${e.error}]` : '';
+            console.log(`${String(idx).padStart(4)}  ${mark}  ${e.t}  ${e.deviceId}  ${e.command}${param}${err}`);
+        });
+    });
+    history
+        .command('replay')
+        .description('Re-run a recorded command by its 1-indexed position')
+        .argument('<index>', 'Entry index (1 = oldest; as shown by "history show")')
+        .option('--file <path>', `Path to the audit log (default ${DEFAULT_AUDIT})`)
+        .addHelpText('after', `
+Dry-run-honouring: pass --dry-run on the parent command to preview without
+sending the actual call. Errors from the recorded entry are NOT replayed —
+replay always attempts the command fresh.
+
+Examples:
+  $ switchbot history replay 3
+  $ switchbot --dry-run history replay 3
+`)
+        .action(async (indexArg, options) => {
+        const file = options.file ?? DEFAULT_AUDIT;
+        const entries = readAudit(file);
+        const idx = Number(indexArg);
+        if (!Number.isInteger(idx) || idx < 1 || idx > entries.length) {
+            const msg = `Invalid index ${indexArg}. Log has ${entries.length} entries.`;
+            if (isJsonMode()) {
+                console.error(JSON.stringify({ error: { code: 2, kind: 'usage', message: msg } }));
+            }
+            else {
+                console.error(msg);
+            }
+            process.exit(2);
+        }
+        const entry = entries[idx - 1];
+        if (entry.kind !== 'command') {
+            const msg = `Entry ${idx} is not a command (kind=${entry.kind}).`;
+            if (isJsonMode()) {
+                console.error(JSON.stringify({ error: { code: 2, kind: 'usage', message: msg } }));
+            }
+            else {
+                console.error(msg);
+            }
+            process.exit(2);
+        }
+        try {
+            const result = await executeCommand(entry.deviceId, entry.command, entry.parameter, entry.commandType);
+            if (isJsonMode()) {
+                printJson({ replayed: entry, result });
+            }
+            else {
+                console.log(`✓ replayed ${entry.command} on ${entry.deviceId}`);
+            }
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=history.js.map

package/dist/commands/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,mDAAmD,CAAC;SAChE,WAAW,CAAC,OAAO,EAAE;;;;;;;;;CASzB,CAAC,CAAC;IAED,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,eAAe,EAAE,kCAAkC,aAAa,GAAG,CAAC;SAC3E,MAAM,CAAC,aAAa,EAAE,8BAA8B,CAAC;SACrD,MAAM,CAAC,CAAC,OAA0C,EAAE,EAAE;QACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC;QAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,OAAO,GACX,OAAO,CAAC,KAAK,KAAK,SAAS;YACzB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACzD,CAAC,CAAC,OAAO,CAAC;QAEd,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,GAAG,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,GAAG,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC/D,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;gBAClE,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnC,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qDAAqD,CAAC;SAClE,QAAQ,CAAC,SAAS,EAAE,sDAAsD,CAAC;SAC3E,MAAM,CAAC,eAAe,EAAE,kCAAkC,aAAa,GAAG,CAAC;SAC3E,WAAW,CAAC,OAAO,EAAE;;;;;;;;CAQzB,CAAC;SACG,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAA0B,EAAE,EAAE;QAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC;QAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAC9D,MAAM,GAAG,GAAG,iBAAiB,QAAQ,aAAa,OAAO,CAAC,MAAM,WAAW,CAAC;YAC5E,IAAI,UAAU,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,GAAe,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,SAAS,GAAG,2BAA2B,KAAK,CAAC,IAAI,IAAI,CAAC;YAClE,IAAI,UAAU,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,WAAW,CAClB,CAAC;YACF,IAAI,UAAU,EAAE,EAAE,CAAC;gBACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createSwitchBotMcpServer(): McpServer;
+export declare function registerMcpCommand(program: Command): void;