@switchbot/openapi-cli 3.2.1 → 3.3.0

package/dist/devices/cache.d.ts

@@ -1,79 +0,0 @@
-export interface CachedDevice {
-    type: string;
-    name: string;
-    category: 'physical' | 'ir';
-    hubDeviceId?: string;
-    enableCloudService?: boolean;
-    roomID?: string;
-    roomName?: string | null;
-    familyName?: string;
-    controlType?: string;
-}
-export interface DeviceCache {
-    lastUpdated: string;
-    devices: Record<string, CachedDevice>;
-}
-export interface DeviceListBodyShape {
-    deviceList: Array<{
-        deviceId: string;
-        deviceName: string;
-        deviceType?: string;
-        hubDeviceId?: string;
-        enableCloudService?: boolean;
-        roomID?: string;
-        roomName?: string | null;
-        familyName?: string;
-        controlType?: string;
-    }>;
-    infraredRemoteList: Array<{
-        deviceId: string;
-        deviceName: string;
-        remoteType: string;
-        hubDeviceId?: string;
-        controlType?: string;
-    }>;
-}
-/** Force the next loadCache() call to re-read from disk. Used in tests. */
-export declare function resetListCache(): void;
-/** Force the next loadStatusCache() call to re-read from disk. Used in tests. */
-export declare function resetStatusCache(): void;
-export declare function loadCache(): DeviceCache | null;
-export declare function getCachedDevice(deviceId: string): CachedDevice | null;
-/** Build a deviceId -> type map from the metadata cache. */
-export declare function getCachedTypeMap(deviceIds?: Iterable<string>): Map<string, string>;
-export declare function updateCacheFromDeviceList(body: DeviceListBodyShape): void;
-export declare function clearCache(): void;
-/** Age of the on-disk list cache in ms, or null if there is no cache. */
-export declare function listCacheAgeMs(now?: number): number | null;
-/** True when the on-disk list cache is present and younger than `ttlMs`. */
-export declare function isListCacheFresh(ttlMs: number, now?: number): boolean;
-export interface CachedStatus {
-    fetchedAt: string;
-    body: Record<string, unknown>;
-}
-export interface StatusCache {
-    entries: Record<string, CachedStatus>;
-}
-export declare function loadStatusCache(): StatusCache;
-/** Read a status entry; returns null when missing or older than `ttlMs`. */
-export declare function getCachedStatus(deviceId: string, ttlMs: number, now?: number): Record<string, unknown> | null;
-export declare function setCachedStatus(deviceId: string, body: Record<string, unknown>, now?: Date, ttlMsForGc?: number): void;
-export declare function clearStatusCache(): void;
-/** Summary for `switchbot cache show`. */
-export interface CacheSummary {
-    list: {
-        path: string;
-        exists: boolean;
-        lastUpdated?: string;
-        ageMs?: number;
-        deviceCount?: number;
-    };
-    status: {
-        path: string;
-        exists: boolean;
-        entryCount: number;
-        oldestFetchedAt?: string;
-        newestFetchedAt?: string;
-    };
-}
-export declare function describeCache(now?: number): CacheSummary;

package/dist/devices/cache.js

@@ -1,294 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { createHash } from 'node:crypto';
-import { getConfigPath } from '../utils/flags.js';
-import { getActiveProfile } from '../lib/request-context.js';
-/**
- * Returns the directory where cache files should be stored.
- *
- * - If a profile is active, scopes into a per-profile sub-directory so that
- *   rotating credentials or switching profiles never serves stale inventory
- *   from a prior session (Bug #37).
- * - If no profile is active (unnamed / default), returns `baseDir` unchanged
- *   so the existing legacy path (~/.switchbot/devices.json) is preserved.
- *
- * Only called when `getConfigPath()` returns undefined — the --config-path
- * override takes full precedence and bypasses this helper entirely.
- */
-function scopedCacheDir(baseDir) {
-    const profile = getActiveProfile();
-    if (profile === undefined)
-        return baseDir;
-    const hash = createHash('sha256').update(profile).digest('hex').slice(0, 8);
-    const dir = path.join(baseDir, 'cache', hash);
-    if (!fs.existsSync(dir))
-        fs.mkdirSync(dir, { recursive: true });
-    return dir;
-}
-/** GC cutoff for status entries: evict anything older than this. */
-const DEFAULT_STATUS_GC_TTL_MS = 24 * 60 * 60 * 1000; // 24 h
-function cacheFilePath() {
-    const override = getConfigPath();
-    const dir = override
-        ? path.dirname(path.resolve(override))
-        : scopedCacheDir(path.join(os.homedir(), '.switchbot'));
-    return path.join(dir, 'devices.json');
-}
-// In-memory hot-cache keyed by active profile (or '__default__' for no profile).
-// Using Maps instead of module-level singletons ensures that mcp serve, which
-// rotates profiles per request via withRequestContext, never leaks inventory
-// across profiles within the same process (Bug #37).
-const _listCacheByProfile = new Map();
-const _statusCacheByProfile = new Map();
-function cacheKey() {
-    return getActiveProfile() ?? '__default__';
-}
-/** Force the next loadCache() call to re-read from disk. Used in tests. */
-export function resetListCache() {
-    _listCacheByProfile.clear();
-}
-/** Force the next loadStatusCache() call to re-read from disk. Used in tests. */
-export function resetStatusCache() {
-    _statusCacheByProfile.clear();
-}
-export function loadCache() {
-    const key = cacheKey();
-    if (_listCacheByProfile.has(key))
-        return _listCacheByProfile.get(key);
-    const file = cacheFilePath();
-    if (!fs.existsSync(file)) {
-        _listCacheByProfile.set(key, null);
-        return null;
-    }
-    try {
-        const raw = fs.readFileSync(file, 'utf-8');
-        const cache = JSON.parse(raw);
-        if (!cache || typeof cache.devices !== 'object' || cache.devices === null) {
-            _listCacheByProfile.set(key, null);
-            return null;
-        }
-        _listCacheByProfile.set(key, cache);
-        return cache;
-    }
-    catch {
-        _listCacheByProfile.set(key, null);
-        return null;
-    }
-}
-export function getCachedDevice(deviceId) {
-    const cache = loadCache();
-    if (!cache)
-        return null;
-    return cache.devices[deviceId] ?? null;
-}
-/** Build a deviceId -> type map from the metadata cache. */
-export function getCachedTypeMap(deviceIds) {
-    const cache = loadCache();
-    const out = new Map();
-    if (!cache)
-        return out;
-    if (deviceIds) {
-        for (const id of deviceIds) {
-            const entry = cache.devices[id];
-            if (entry?.type)
-                out.set(id, entry.type);
-        }
-        return out;
-    }
-    for (const [deviceId, entry] of Object.entries(cache.devices)) {
-        if (entry.type)
-            out.set(deviceId, entry.type);
-    }
-    return out;
-}
-export function updateCacheFromDeviceList(body) {
-    const devices = {};
-    for (const d of body.deviceList) {
-        if (!d.deviceId || !d.deviceType)
-            continue;
-        devices[d.deviceId] = {
-            type: d.deviceType,
-            name: d.deviceName,
-            category: 'physical',
-            hubDeviceId: d.hubDeviceId,
-            enableCloudService: d.enableCloudService,
-            roomID: d.roomID,
-            roomName: d.roomName,
-            familyName: d.familyName,
-            controlType: d.controlType,
-        };
-    }
-    for (const d of body.infraredRemoteList) {
-        if (!d.deviceId)
-            continue;
-        devices[d.deviceId] = {
-            type: d.remoteType,
-            name: d.deviceName,
-            category: 'ir',
-            hubDeviceId: d.hubDeviceId,
-            controlType: d.controlType,
-        };
-    }
-    const cache = {
-        lastUpdated: new Date().toISOString(),
-        devices,
-    };
-    try {
-        const file = cacheFilePath();
-        const dir = path.dirname(file);
-        if (!fs.existsSync(dir))
-            fs.mkdirSync(dir, { recursive: true });
-        fs.writeFileSync(file, JSON.stringify(cache, null, 2), { mode: 0o600 });
-        _listCacheByProfile.set(cacheKey(), cache);
-    }
-    catch {
-        // Cache write failures must not break the command that triggered them.
-    }
-}
-export function clearCache() {
-    const file = cacheFilePath();
-    if (fs.existsSync(file))
-        fs.unlinkSync(file);
-    _listCacheByProfile.set(cacheKey(), null);
-}
-// ---- Device list freshness -------------------------------------------------
-/** Age of the on-disk list cache in ms, or null if there is no cache. */
-export function listCacheAgeMs(now = Date.now()) {
-    const cache = loadCache();
-    if (!cache)
-        return null;
-    const ts = Date.parse(cache.lastUpdated);
-    if (!Number.isFinite(ts))
-        return null;
-    return Math.max(0, now - ts);
-}
-/** True when the on-disk list cache is present and younger than `ttlMs`. */
-export function isListCacheFresh(ttlMs, now = Date.now()) {
-    if (!ttlMs || ttlMs <= 0)
-        return false;
-    const age = listCacheAgeMs(now);
-    return age !== null && age < ttlMs;
-}
-function statusCacheFilePath() {
-    const override = getConfigPath();
-    const dir = override
-        ? path.dirname(path.resolve(override))
-        : scopedCacheDir(path.join(os.homedir(), '.switchbot'));
-    return path.join(dir, 'status.json');
-}
-export function loadStatusCache() {
-    const key = cacheKey();
-    if (_statusCacheByProfile.has(key))
-        return _statusCacheByProfile.get(key);
-    const file = statusCacheFilePath();
-    if (!fs.existsSync(file)) {
-        const empty = { entries: {} };
-        _statusCacheByProfile.set(key, empty);
-        return empty;
-    }
-    try {
-        const raw = fs.readFileSync(file, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (!parsed || typeof parsed.entries !== 'object' || parsed.entries === null) {
-            const empty = { entries: {} };
-            _statusCacheByProfile.set(key, empty);
-            return empty;
-        }
-        _statusCacheByProfile.set(key, parsed);
-        return parsed;
-    }
-    catch {
-        const empty = { entries: {} };
-        _statusCacheByProfile.set(key, empty);
-        return empty;
-    }
-}
-function saveStatusCache(cache) {
-    _statusCacheByProfile.set(cacheKey(), cache);
-    try {
-        const file = statusCacheFilePath();
-        const dir = path.dirname(file);
-        if (!fs.existsSync(dir))
-            fs.mkdirSync(dir, { recursive: true });
-        fs.writeFileSync(file, JSON.stringify(cache, null, 2), { mode: 0o600 });
-    }
-    catch {
-        /* best-effort */
-    }
-}
-/** Read a status entry; returns null when missing or older than `ttlMs`. */
-export function getCachedStatus(deviceId, ttlMs, now = Date.now()) {
-    if (!ttlMs || ttlMs <= 0)
-        return null;
-    const cache = loadStatusCache();
-    const entry = cache.entries[deviceId];
-    if (!entry)
-        return null;
-    const ts = Date.parse(entry.fetchedAt);
-    if (!Number.isFinite(ts))
-        return null;
-    if (now - ts >= ttlMs)
-        return null;
-    return entry.body;
-}
-/** Evict status entries older than max(ttlMs × 10, 24 h) to bound file growth. */
-function evictExpiredStatusEntries(cache, ttlMs, now = Date.now()) {
-    const cutoff = now - Math.max(ttlMs * 10, 24 * 60 * 60 * 1000);
-    for (const id of Object.keys(cache.entries)) {
-        const entry = cache.entries[id];
-        const ts = Date.parse(entry.fetchedAt);
-        if (!Number.isFinite(ts) || ts < cutoff)
-            delete cache.entries[id];
-    }
-}
-export function setCachedStatus(deviceId, body, now = new Date(), ttlMsForGc = DEFAULT_STATUS_GC_TTL_MS) {
-    const cache = loadStatusCache();
-    cache.entries[deviceId] = {
-        fetchedAt: now.toISOString(),
-        body,
-    };
-    evictExpiredStatusEntries(cache, ttlMsForGc, now.getTime());
-    saveStatusCache(cache);
-}
-export function clearStatusCache() {
-    const file = statusCacheFilePath();
-    if (fs.existsSync(file))
-        fs.unlinkSync(file);
-    _statusCacheByProfile.set(cacheKey(), { entries: {} });
-}
-export function describeCache(now = Date.now()) {
-    const listFile = cacheFilePath();
-    const listCache = loadCache();
-    const listExists = fs.existsSync(listFile);
-    const list = {
-        path: listFile,
-        exists: listExists,
-    };
-    if (listCache) {
-        list.lastUpdated = listCache.lastUpdated;
-        const ts = Date.parse(listCache.lastUpdated);
-        if (Number.isFinite(ts))
-            list.ageMs = Math.max(0, now - ts);
-        list.deviceCount = Object.keys(listCache.devices).length;
-    }
-    const statusFile = statusCacheFilePath();
-    const statusExists = fs.existsSync(statusFile);
-    const statusCache = loadStatusCache();
-    const entries = Object.values(statusCache.entries);
-    const status = {
-        path: statusFile,
-        exists: statusExists,
-        entryCount: entries.length,
-    };
-    if (entries.length > 0) {
-        const sorted = entries
-            .map((e) => e.fetchedAt)
-            .filter((s) => typeof s === 'string')
-            .sort();
-        status.oldestFetchedAt = sorted[0];
-        status.newestFetchedAt = sorted[sorted.length - 1];
-    }
-    return { list, status };
-}
-//# sourceMappingURL=cache.js.map

package/dist/devices/cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/devices/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oEAAoE;AACpE,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO;AAwC7D,SAAS,aAAa;IACpB,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ;QAClB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACxC,CAAC;AAED,iFAAiF;AACjF,8EAA8E;AAC9E,6EAA6E;AAC7E,qDAAqD;AACrD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA8B,CAAC;AAClE,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE7D,SAAS,QAAQ;IACf,OAAO,gBAAgB,EAAE,IAAI,aAAa,CAAC;AAC7C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc;IAC5B,mBAAmB,CAAC,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB;IAC9B,qBAAqB,CAAC,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IACvB,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACvE,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1E,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,SAA4B;IAC3D,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IAEvB,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,KAAK,EAAE,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAyB;IACjE,MAAM,OAAO,GAAiC,EAAE,CAAC;IAEjD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,UAAU;YAAE,SAAS;QAC3C,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG;YACpB,IAAI,EAAE,CAAC,CAAC,UAAU;YAClB,IAAI,EAAE,CAAC,CAAC,UAAU;YAClB,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;YACxC,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC,CAAC,QAAQ;YAAE,SAAS;QAC1B,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG;YACpB,IAAI,EAAE,CAAC,CAAC,UAAU;YAClB,IAAI,EAAE,CAAC,CAAC,UAAU;YAClB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAgB;QACzB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,OAAO;KACR,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACxE,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7C,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,+EAA+E;AAE/E,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC7C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC9D,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC;AACrC,CAAC;AAqBD,SAAS,mBAAmB;IAC1B,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ;QAClB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IACvB,IAAI,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC9B,qBAAqB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;QAC9C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC7E,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC9B,qBAAqB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,qBAAqB,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC9B,qBAAqB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAkB;IACzC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,KAAa,EACb,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAEhB,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,GAAG,GAAG,EAAE,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,kFAAkF;AAClF,SAAS,yBAAyB,CAAC,KAAkB,EAAE,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACpF,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,IAA6B,EAC7B,GAAG,GAAG,IAAI,IAAI,EAAE,EAChB,UAAU,GAAG,wBAAwB;IAErC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG;QACxB,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;QAC5B,IAAI;KACL,CAAC;IACF,yBAAyB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,eAAe,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7C,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAoBD,MAAM,UAAU,aAAa,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC5C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAyB;QACjC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,UAAU;KACnB,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC3D,CAAC;IAED,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,MAAM,GAA2B;QACrC,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE,OAAO,CAAC,MAAM;KAC3B,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,OAAO;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;aACvB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;aACjD,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC"}

package/dist/devices/catalog.d.ts

@@ -1,138 +0,0 @@
-/**
- * Static catalog of SwitchBot device types, control commands and status fields.
- * Sourced from https://github.com/OpenWonderLabs/SwitchBotAPI — keep in sync
- * when the upstream API adds new device types.
- *
- * Field conventions:
- *   - CommandSpec.idempotent: repeat-safe — calling it N times ends in the
- *     same state as calling it once (turnOn, setBrightness 50). Agents can
- *     retry these freely. Counter-examples: toggle, press, volumeAdd.
- *   - CommandSpec.safetyTier: explicit action safety classification. See
- *     SafetyTier for the 5-tier enum. Built-in entries set this on the
- *     destructive tier; other tiers are derived (see deriveSafetyTier).
- *   - DeviceCatalogEntry.role: functional grouping for filter/search
- *     ("all lighting", "all security"). Does not affect API behavior.
- *   - DeviceCatalogEntry.readOnly: the device has no control commands; it
- *     can only be queried via 'devices status'.
- */
-/**
- * Catalog shape version. Bump when any of the exported interfaces
- * (CommandSpec / DeviceCatalogEntry / SafetyTier) gain/lose/rename a
- * load-bearing field. The agent-bootstrap payload's schemaVersion must
- * stay pinned to this value; `doctor` fails the `catalog-schema` check
- * when they drift.
- */
-export declare const CATALOG_SCHEMA_VERSION = "1.0";
-/**
- * Safety classification for catalog commands.
- *
- *  - 'read'           —— Read-only query (status fetch). Reserved for v2.8+
- *                        `statusQueries` expansion; no command uses it today.
- *  - 'mutation'       —— Causes a state change but is reversible/idempotent
- *                        (turnOn/Off, setBrightness, setPosition).
- *  - 'ir-fire-forget' —— IR command (no reply/ack) or customize IR button.
- *                        Fire-and-forget; reversibility depends on device.
- *  - 'destructive'    —— Hard or unsafe to reverse; physical-world side effects
- *                        (unlock, garage open, deleteKey). Needs confirmation.
- *  - 'maintenance'    —— Factory reset / firmware update / deep calibrate.
- *                        Reserved; the SwitchBot API exposes no such endpoint
- *                        today, so no command uses it.
- */
-export type SafetyTier = 'read' | 'mutation' | 'ir-fire-forget' | 'destructive' | 'maintenance';
-export interface CommandSpec {
-    command: string;
-    parameter: string;
-    description: string;
-    commandType?: 'command' | 'customize';
-    idempotent?: boolean;
-    /**
-     * Explicit safety tier. When omitted, deriveSafetyTier() infers:
-     *   commandType: 'customize' or entry.category === 'ir'  → 'ir-fire-forget'
-     *   otherwise              → 'mutation'
-     */
-    safetyTier?: SafetyTier;
-    /** One sentence explaining *why* this command needs caution — used in guard errors. */
-    safetyReason?: string;
-    exampleParams?: string[];
-}
-/** Coarse functional role — helpful for cross-type selection in agents. */
-export type DeviceRole = 'lighting' | 'climate' | 'security' | 'media' | 'sensor' | 'cleaning' | 'curtain' | 'fan' | 'power' | 'hub' | 'other';
-export interface DeviceCatalogEntry {
-    type: string;
-    category: 'physical' | 'ir';
-    description?: string;
-    aliases?: string[];
-    commands: CommandSpec[];
-    statusFields?: string[];
-    /**
-     * P11: strongly-typed read-only queries powering the 'read' safety tier.
-     * When omitted, deriveStatusQueries() produces equivalent entries from
-     * `statusFields`. Use this to override descriptions or attach examples.
-     */
-    statusQueries?: ReadOnlyQuerySpec[];
-    role?: DeviceRole;
-    readOnly?: boolean;
-}
-/**
- * P11: a single read-only query against a device. `endpoint: 'status'` is
- * the normal /devices/{id}/status call; 'keys' reads lock keypad entries;
- * 'webhook' reads the server-side webhook event subscription. All three
- * are safe to call at any time — they never mutate state.
- */
-export interface ReadOnlyQuerySpec {
-    field: string;
-    description: string;
-    endpoint: 'status' | 'keys' | 'webhook';
-    safetyTier: 'read';
-    example?: unknown;
-}
-/**
- * P11: derive the read-only query list for an entry. If the entry has
- * explicit `statusQueries`, return them as-is; otherwise synthesize one
- * ReadOnlyQuerySpec per `statusFields` entry, all keyed to the `status`
- * endpoint. IR-category entries have no status channel so return [].
- */
-export declare function deriveStatusQueries(entry: DeviceCatalogEntry): ReadOnlyQuerySpec[];
-export declare const DEVICE_CATALOG: DeviceCatalogEntry[];
-/** Find a catalog entry by exact name, alias, or case-insensitive substring. */
-export declare function findCatalogEntry(query: string): DeviceCatalogEntry | DeviceCatalogEntry[] | null;
-/**
- * Derive the safety tier for a catalog command, honouring an explicit
- * `safetyTier` when present and falling back to heuristic inference.
- *
- * The inference order is:
- *   1. Explicit `spec.safetyTier`.
- *   2. IR context (customize command OR entry.category === 'ir')
- *      → `'ir-fire-forget'`.
- *   3. Default → `'mutation'`.
- */
-export declare function deriveSafetyTier(spec: CommandSpec, entry?: Pick<DeviceCatalogEntry, 'category'>): SafetyTier;
-/** Read the safety reason for a command. */
-export declare function getCommandSafetyReason(spec: CommandSpec): string | null;
-/**
- * Pick up to 3 non-destructive, idempotent commands an agent can safely invoke
- * to explore or exercise a device. Used by `devices describe --json` to hint
- * at concrete next steps.
- */
-export declare function suggestedActions(entry: DeviceCatalogEntry): Array<{
-    command: string;
-    parameter?: string;
-    description: string;
-}>;
-export interface CatalogOverlayEntry extends Partial<DeviceCatalogEntry> {
-    type: string;
-    remove?: boolean;
-}
-export interface OverlayLoadResult {
-    path: string;
-    exists: boolean;
-    entries: CatalogOverlayEntry[];
-    error?: string;
-}
-export declare function getCatalogOverlayPath(): string;
-/** Read the overlay file. Never throws — returns `error` on bad files. */
-export declare function loadCatalogOverlay(): OverlayLoadResult;
-/** Clear the overlay cache (test helper; also useful for `catalog refresh`). */
-export declare function resetCatalogOverlayCache(): void;
-/** Merge built-in catalog with the on-disk overlay. */
-export declare function getEffectiveCatalog(): DeviceCatalogEntry[];