@switchbot/openapi-cli 1.1.0 → 1.3.0

package/dist/lib/devices.js

@@ -0,0 +1,329 @@
+import { createClient } from '../api/client.js';
+import { findCatalogEntry, suggestedActions, getEffectiveCatalog, } from '../devices/catalog.js';
+import { getCachedDevice, updateCacheFromDeviceList, loadCache, isListCacheFresh, getCachedStatus, setCachedStatus, } from '../devices/cache.js';
+import { getCacheMode } from '../utils/flags.js';
+import { writeAudit } from '../utils/audit.js';
+import { isDryRun } from '../utils/flags.js';
+export class DeviceNotFoundError extends Error {
+    deviceId;
+    constructor(deviceId) {
+        super(`No device with id "${deviceId}" found on this account.`);
+        this.deviceId = deviceId;
+        this.name = 'DeviceNotFoundError';
+    }
+}
+export class CommandValidationError extends Error {
+    kind;
+    hint;
+    constructor(message, kind, hint) {
+        super(message);
+        this.kind = kind;
+        this.hint = hint;
+        this.name = 'CommandValidationError';
+    }
+}
+/** Fetch the full device + IR remote inventory and refresh the local cache. */
+export async function fetchDeviceList(client) {
+    // TTL-gated read: when the on-disk cache is younger than the configured
+    // list TTL, skip the API call and synthesize a DeviceListBody from the
+    // metadata cache.
+    const mode = getCacheMode();
+    if (mode.listTtlMs > 0 && isListCacheFresh(mode.listTtlMs)) {
+        const cached = loadCache();
+        if (cached) {
+            const deviceList = [];
+            const infraredRemoteList = [];
+            for (const [deviceId, entry] of Object.entries(cached.devices)) {
+                if (entry.category === 'physical') {
+                    deviceList.push({
+                        deviceId,
+                        deviceName: entry.name,
+                        deviceType: entry.type,
+                        enableCloudService: entry.enableCloudService ?? true,
+                        hubDeviceId: entry.hubDeviceId ?? '',
+                        roomID: entry.roomID,
+                        roomName: entry.roomName,
+                        familyName: entry.familyName,
+                        controlType: entry.controlType,
+                    });
+                }
+                else {
+                    infraredRemoteList.push({
+                        deviceId,
+                        deviceName: entry.name,
+                        remoteType: entry.type,
+                        hubDeviceId: entry.hubDeviceId ?? '',
+                        controlType: entry.controlType,
+                    });
+                }
+            }
+            return { deviceList, infraredRemoteList };
+        }
+    }
+    const c = client ?? createClient();
+    const res = await c.get('/v1.1/devices');
+    updateCacheFromDeviceList(res.data.body);
+    return res.data.body;
+}
+/** Fetch live status for a single physical device. IR remotes have no status channel. */
+export async function fetchDeviceStatus(deviceId, client) {
+    const mode = getCacheMode();
+    if (mode.statusTtlMs > 0) {
+        const cached = getCachedStatus(deviceId, mode.statusTtlMs);
+        if (cached)
+            return cached;
+    }
+    const c = client ?? createClient();
+    const res = await c.get(`/v1.1/devices/${deviceId}/status`);
+    if (mode.statusTtlMs > 0) {
+        setCachedStatus(deviceId, res.data.body);
+    }
+    return res.data.body;
+}
+/**
+ * Execute a command on a device. `parameter` is the fully-parsed value already
+ * (JSON-object when applicable), not a raw CLI string — callers should parse
+ * upstream if needed.
+ */
+export async function executeCommand(deviceId, cmd, parameter, commandType, client) {
+    const c = client ?? createClient();
+    const body = {
+        command: cmd,
+        parameter: parameter ?? 'default',
+        commandType,
+    };
+    const baseAudit = {
+        t: new Date().toISOString(),
+        kind: 'command',
+        deviceId,
+        command: cmd,
+        parameter,
+        commandType,
+        dryRun: isDryRun(),
+    };
+    try {
+        const res = await c.post(`/v1.1/devices/${deviceId}/commands`, body);
+        writeAudit({ ...baseAudit, result: 'ok' });
+        return res.data.body;
+    }
+    catch (err) {
+        // Dry-run intercepts throw DryRunSignal — still log the intent.
+        if (err instanceof Error && err.name === 'DryRunSignal') {
+            writeAudit({ ...baseAudit, result: 'ok' });
+        }
+        else {
+            writeAudit({
+                ...baseAudit,
+                result: 'error',
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        throw err;
+    }
+}
+/**
+ * Validate a command against the locally-cached device → catalog mapping.
+ * Returns `{ ok: true }` when validation passes or is skipped (unknown device,
+ * custom IR button, etc.); returns `{ ok: false, error }` when the caller
+ * should refuse the call.
+ */
+export function validateCommand(deviceId, cmd, parameter, commandType) {
+    if (commandType === 'customize')
+        return { ok: true };
+    const cached = getCachedDevice(deviceId);
+    if (!cached)
+        return { ok: true };
+    const match = findCatalogEntry(cached.type);
+    if (!match || Array.isArray(match))
+        return { ok: true };
+    const builtinCommands = match.commands.filter((c) => c.commandType !== 'customize');
+    if (builtinCommands.length === 0)
+        return { ok: true };
+    const spec = builtinCommands.find((c) => c.command === cmd);
+    if (!spec) {
+        const unique = [...new Set(builtinCommands.map((c) => c.command))];
+        return {
+            ok: false,
+            error: new CommandValidationError(`"${cmd}" is not a supported command for ${cached.name} (${cached.type}).`, 'unknown-command', `Supported commands: ${unique.join(', ')}`),
+        };
+    }
+    const noParamExpected = spec.parameter === '—';
+    const userProvidedParam = parameter !== undefined && parameter !== 'default';
+    if (noParamExpected && userProvidedParam) {
+        return {
+            ok: false,
+            error: new CommandValidationError(`"${cmd}" takes no parameter, but one was provided: "${parameter}".`, 'unexpected-parameter', `Try: switchbot devices command ${deviceId} ${cmd}`),
+        };
+    }
+    return { ok: true };
+}
+/**
+ * Inspect catalog annotations to decide whether a command is destructive,
+ * i.e. has hard-to-reverse real-world effects and should require an explicit
+ * confirmation from an agent / operator before execution. Customize commands
+ * are considered non-destructive here — they're user-defined IR buttons
+ * whose behavior the catalog can't know about.
+ */
+export function isDestructiveCommand(deviceType, cmd, commandType) {
+    if (commandType === 'customize')
+        return false;
+    if (!deviceType)
+        return false;
+    const match = findCatalogEntry(deviceType);
+    if (!match || Array.isArray(match))
+        return false;
+    const spec = match.commands.find((c) => c.command === cmd);
+    return Boolean(spec?.destructive);
+}
+/** Return the destructiveReason for a command, or null if not destructive / not found. */
+export function getDestructiveReason(deviceType, cmd, commandType) {
+    if (commandType === 'customize')
+        return null;
+    if (!deviceType)
+        return null;
+    const match = findCatalogEntry(deviceType);
+    if (!match || Array.isArray(match))
+        return null;
+    const spec = match.commands.find((c) => c.command === cmd);
+    return spec?.destructiveReason ?? null;
+}
+/**
+ * Describe a device by id: metadata + catalog entry (if known) +
+ * optional live status. Throws `DeviceNotFoundError` when the id is unknown.
+ */
+export async function describeDevice(deviceId, options = {}, client) {
+    const body = await fetchDeviceList(client);
+    const { deviceList, infraredRemoteList } = body;
+    const physical = deviceList.find((d) => d.deviceId === deviceId);
+    const ir = infraredRemoteList.find((d) => d.deviceId === deviceId);
+    if (!physical && !ir)
+        throw new DeviceNotFoundError(deviceId);
+    const typeName = physical ? (physical.deviceType ?? '') : ir.remoteType;
+    const match = typeName ? findCatalogEntry(typeName) : null;
+    const catalogEntry = !match || Array.isArray(match) ? null : match;
+    let liveStatus;
+    if (options.live && physical) {
+        try {
+            liveStatus = await fetchDeviceStatus(deviceId, client);
+        }
+        catch (err) {
+            liveStatus = { error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    const source = catalogEntry
+        ? liveStatus
+            ? 'catalog+live'
+            : 'catalog'
+        : liveStatus
+            ? 'live'
+            : 'none';
+    const capabilities = catalogEntry
+        ? {
+            role: catalogEntry.role ?? null,
+            readOnly: catalogEntry.readOnly ?? false,
+            commands: catalogEntry.commands,
+            statusFields: catalogEntry.statusFields ?? [],
+            ...(liveStatus !== undefined ? { liveStatus } : {}),
+        }
+        : liveStatus !== undefined
+            ? { liveStatus }
+            : null;
+    return {
+        device: (physical ?? ir),
+        isPhysical: Boolean(physical),
+        typeName,
+        controlType: physical?.controlType ?? ir?.controlType ?? null,
+        catalog: catalogEntry,
+        capabilities,
+        source,
+        suggestedActions: catalogEntry ? suggestedActions(catalogEntry) : [],
+        inheritedLocation: ir ? buildHubLocationMap(deviceList).get(ir.hubDeviceId) : undefined,
+    };
+}
+/** Build a map from hubDeviceId → room/family/roomID for IR-remote inheritance. */
+export function buildHubLocationMap(deviceList) {
+    const map = new Map();
+    for (const d of deviceList) {
+        if (!d.deviceId)
+            continue;
+        map.set(d.deviceId, {
+            family: d.familyName ?? undefined,
+            room: d.roomName ?? undefined,
+            roomID: d.roomID ?? undefined,
+        });
+    }
+    return map;
+}
+/**
+ * Search the local catalog by type name / alias. Returns up to `limit`
+ * entries whose type or alias contains the query (case-insensitive).
+ * Intended for MCP's `search_catalog` tool — not for dispatching commands.
+ */
+export function searchCatalog(query, limit = 20) {
+    const catalog = getEffectiveCatalog();
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return catalog.slice(0, limit);
+    const hits = [];
+    for (const entry of catalog) {
+        const haystack = [entry.type, ...(entry.aliases ?? [])].map((s) => s.toLowerCase());
+        if (haystack.some((h) => h.includes(q))) {
+            hits.push(entry);
+            if (hits.length >= limit)
+                break;
+        }
+    }
+    return hits;
+}
+/** Convert a DescribeResult to the shape validated by the MCP outputSchema. */
+export function toMcpDescribeShape(r) {
+    const d = r.device;
+    return {
+        device: {
+            deviceId: d.deviceId,
+            deviceName: d.deviceName,
+            ...(d.deviceType !== undefined ? { deviceType: d.deviceType } : {}),
+            ...('enableCloudService' in d ? { enableCloudService: d.enableCloudService } : {}),
+            ...(d.hubDeviceId !== undefined ? { hubDeviceId: d.hubDeviceId } : {}),
+            ...(d.roomID !== undefined ? { roomID: d.roomID } : {}),
+            ...(d.roomName !== undefined ? { roomName: d.roomName } : {}),
+            ...(d.familyName !== undefined ? { familyName: d.familyName } : {}),
+            ...(d.controlType !== undefined ? { controlType: d.controlType } : {}),
+            ...('remoteType' in d && d.remoteType !== undefined ? { remoteType: d.remoteType } : {}),
+        },
+        isPhysical: r.isPhysical,
+        typeName: r.typeName,
+        controlType: r.controlType,
+        source: r.source,
+        capabilities: r.capabilities,
+        suggestedActions: r.suggestedActions,
+        ...(r.inheritedLocation !== undefined
+            ? { inheritedLocation: { family: r.inheritedLocation.family, room: r.inheritedLocation.room } }
+            : {}),
+    };
+}
+/** Shapes the device list body for the MCP list_devices outputSchema. */
+export function toMcpDeviceListShape(d) {
+    return {
+        deviceId: d.deviceId,
+        deviceName: d.deviceName,
+        deviceType: d.deviceType,
+        enableCloudService: d.enableCloudService,
+        hubDeviceId: d.hubDeviceId,
+        roomID: d.roomID,
+        roomName: d.roomName,
+        familyName: d.familyName,
+        controlType: d.controlType,
+    };
+}
+/** Shapes an infrared remote for the MCP list_devices outputSchema. */
+export function toMcpIrDeviceShape(d) {
+    return {
+        deviceId: d.deviceId,
+        deviceName: d.deviceName,
+        remoteType: d.remoteType,
+        hubDeviceId: d.hubDeviceId,
+        controlType: d.controlType,
+    };
+}
+//# sourceMappingURL=devices.js.map

package/dist/lib/devices.js.map

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

package/dist/lib/scenes.d.ts

@@ -0,0 +1,7 @@
+import type { AxiosInstance } from 'axios';
+export interface Scene {
+    sceneId: string;
+    sceneName: string;
+}
+export declare function fetchScenes(client?: AxiosInstance): Promise<Scene[]>;
+export declare function executeScene(sceneId: string, client?: AxiosInstance): Promise<void>;

package/dist/lib/scenes.js

@@ -0,0 +1,11 @@
+import { createClient } from '../api/client.js';
+export async function fetchScenes(client) {
+    const c = client ?? createClient();
+    const res = await c.get('/v1.1/scenes');
+    return res.data.body;
+}
+export async function executeScene(sceneId, client) {
+    const c = client ?? createClient();
+    await c.post(`/v1.1/scenes/${sceneId}/execute`);
+}
+//# sourceMappingURL=scenes.js.map

package/dist/lib/scenes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenes.js","sourceRoot":"","sources":["../../src/lib/scenes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOhD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAsB;IACtD,MAAM,CAAC,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAoB,cAAc,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,MAAsB;IACxE,MAAM,CAAC,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC;IACnC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,OAAO,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/audit.d.ts

@@ -0,0 +1,13 @@
+export interface AuditEntry {
+    t: string;
+    kind: 'command';
+    deviceId: string;
+    command: string;
+    parameter: unknown;
+    commandType: 'command' | 'customize';
+    dryRun: boolean;
+    result?: 'ok' | 'error';
+    error?: string;
+}
+export declare function writeAudit(entry: AuditEntry): void;
+export declare function readAudit(file: string): AuditEntry[];

package/dist/utils/audit.js

@@ -0,0 +1,43 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getAuditLog } from './flags.js';
+function resolveAuditPath() {
+    const flag = getAuditLog();
+    if (flag === null)
+        return null;
+    return path.resolve(flag);
+}
+export function writeAudit(entry) {
+    const file = resolveAuditPath();
+    if (!file)
+        return;
+    const dir = path.dirname(file);
+    try {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.appendFileSync(file, JSON.stringify(entry) + '\n');
+    }
+    catch {
+        // Best-effort — never let audit failures break the actual command.
+    }
+}
+export function readAudit(file) {
+    if (!fs.existsSync(file))
+        return [];
+    const raw = fs.readFileSync(file, 'utf-8');
+    const out = [];
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            out.push(JSON.parse(trimmed));
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=audit.js.map

package/dist/utils/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/utils/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAczC,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/filter.d.ts

@@ -0,0 +1,45 @@
+import type { Device, InfraredDevice } from '../lib/devices.js';
+/**
+ * A parsed filter clause. Each clause is an (op, key, value) triple that runs
+ * against a candidate device. All clauses from a single expression are AND-ed.
+ */
+export interface FilterClause {
+    key: 'type' | 'family' | 'room' | 'category';
+    op: '=' | '~=';
+    value: string;
+}
+export declare class FilterSyntaxError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a filter expression like "type=Bot,family=Home" into discrete clauses.
+ *
+ * Grammar:
+ *   expr    := clause ("," clause)*
+ *   clause  := KEY OP VALUE
+ *   KEY     := type | family | room | category
+ *   OP      := "=" | "~="
+ *   VALUE   := any non-empty string (no comma — split at the clause boundary)
+ *
+ * Whitespace around keys / values is trimmed. Empty expressions return [].
+ */
+export declare function parseFilter(expr: string | undefined): FilterClause[];
+interface FilterableDevice {
+    deviceId: string;
+    type: string;
+    family?: string;
+    room?: string;
+    category: 'physical' | 'ir';
+}
+/**
+ * Apply the parsed clauses to a mixed list of physical devices + IR remotes.
+ * Returns the deviceIds of the entries that satisfy every clause.
+ *
+ * `hubLocation` (optional) allows family/room filters to match IR remotes by
+ * the Hub-inherited location.
+ */
+export declare function applyFilter(clauses: FilterClause[], deviceList: Device[], infraredRemoteList: InfraredDevice[], hubLocation?: Map<string, {
+    family?: string;
+    room?: string;
+}>): FilterableDevice[];
+export {};

package/dist/utils/filter.js

@@ -0,0 +1,96 @@
+export class FilterSyntaxError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FilterSyntaxError';
+    }
+}
+const VALID_KEYS = ['type', 'family', 'room', 'category'];
+/**
+ * Parse a filter expression like "type=Bot,family=Home" into discrete clauses.
+ *
+ * Grammar:
+ *   expr    := clause ("," clause)*
+ *   clause  := KEY OP VALUE
+ *   KEY     := type | family | room | category
+ *   OP      := "=" | "~="
+ *   VALUE   := any non-empty string (no comma — split at the clause boundary)
+ *
+ * Whitespace around keys / values is trimmed. Empty expressions return [].
+ */
+export function parseFilter(expr) {
+    if (!expr)
+        return [];
+    const parts = expr.split(',').map((p) => p.trim()).filter((p) => p.length > 0);
+    const clauses = [];
+    for (const part of parts) {
+        const m = /^([a-zA-Z_]+)\s*(~=|=)\s*(.+)$/.exec(part);
+        if (!m) {
+            throw new FilterSyntaxError(`Invalid filter clause "${part}" — expected "<key>=<value>" or "<key>~=<pattern>"`);
+        }
+        const key = m[1];
+        const op = m[2];
+        const value = m[3].trim();
+        if (!VALID_KEYS.includes(key)) {
+            throw new FilterSyntaxError(`Unknown filter key "${key}" — supported: ${VALID_KEYS.join(', ')}`);
+        }
+        if (!value) {
+            throw new FilterSyntaxError(`Empty value for filter clause "${part}"`);
+        }
+        clauses.push({ key, op, value });
+    }
+    return clauses;
+}
+/** Normalize a physical / IR device entry to the shape the filter matcher expects. */
+function toFilterable(d, isPhysical, hubLocation) {
+    if (isPhysical) {
+        const p = d;
+        return {
+            deviceId: p.deviceId,
+            type: p.deviceType ?? '',
+            family: p.familyName ?? undefined,
+            room: p.roomName ?? undefined,
+            category: 'physical',
+        };
+    }
+    const ir = d;
+    const inherited = hubLocation?.get(ir.hubDeviceId);
+    return {
+        deviceId: ir.deviceId,
+        type: ir.remoteType ?? '',
+        family: inherited?.family,
+        room: inherited?.room,
+        category: 'ir',
+    };
+}
+function matches(d, clause) {
+    const candidate = clause.key === 'type'
+        ? d.type
+        : clause.key === 'family'
+            ? d.family
+            : clause.key === 'room'
+                ? d.room
+                : d.category;
+    if (candidate === undefined)
+        return false;
+    if (clause.op === '=')
+        return candidate.toLowerCase() === clause.value.toLowerCase();
+    // '~=' — case-insensitive substring match on the candidate.
+    return candidate.toLowerCase().includes(clause.value.toLowerCase());
+}
+/**
+ * Apply the parsed clauses to a mixed list of physical devices + IR remotes.
+ * Returns the deviceIds of the entries that satisfy every clause.
+ *
+ * `hubLocation` (optional) allows family/room filters to match IR remotes by
+ * the Hub-inherited location.
+ */
+export function applyFilter(clauses, deviceList, infraredRemoteList, hubLocation) {
+    const candidates = [
+        ...deviceList.map((d) => toFilterable(d, true)),
+        ...infraredRemoteList.map((d) => toFilterable(d, false, hubLocation)),
+    ];
+    if (clauses.length === 0)
+        return candidates;
+    return candidates.filter((c) => clauses.every((clause) => matches(c, clause)));
+}
+//# sourceMappingURL=filter.js.map

package/dist/utils/filter.js.map

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

package/dist/utils/flags.d.ts

@@ -8,3 +8,45 @@ export declare function isDryRun(): boolean;
 export declare function getTimeout(): number;
 /** Override for the credentials file path. */
 export declare function getConfigPath(): string | undefined;
+/** Named profile → ~/.switchbot/profiles/<name>.json. */
+export declare function getProfile(): string | undefined;
+/**
+ * Audit log path. `--audit-log <path>` enables JSONL append on every mutating
+ * command; default path is ~/.switchbot/audit.log when `--audit-log` is given
+ * without a value. Returns null when the flag is absent.
+ */
+export declare function getAuditLog(): string | null;
+/**
+ * Max 429 retries before surfacing the error. Default 3. `--no-retry`
+ * disables retries entirely; `--retry-on-429 <n>` overrides the count.
+ */
+export declare function getRetryOn429(): number;
+/** Backoff strategy for 429 retries. Default 'exponential'. */
+export declare function getBackoffStrategy(): 'linear' | 'exponential';
+/**
+ * Whether local quota counting is disabled. Quota counting is best-effort
+ * (see src/utils/quota.ts) — this lets scripts opt out entirely when even
+ * best-effort file I/O is unwelcome.
+ */
+export declare function isQuotaDisabled(): boolean;
+/**
+ * Cache TTL controls. Values:
+ *   - `--no-cache`                 → disable cache for all reads
+ *   - `--cache off`                → same as `--no-cache`
+ *   - `--cache auto` (default)     → list cache on (1h), status cache off
+ *   - `--cache 5m` | `--cache 1h`  → enable both stores with the given TTL
+ *   - numeric millisecond values are also accepted
+ */
+export interface CacheMode {
+    /** TTL for the device-list cache, in ms. 0/undefined = off. */
+    listTtlMs: number;
+    /** TTL for the device-status cache, in ms. 0/undefined = off. */
+    statusTtlMs: number;
+}
+declare function parseDurationToMs(v: string): number | null;
+export { parseDurationToMs };
+/** The --format flag value, or undefined when absent. */
+export declare function getFormat(): string | undefined;
+/** Comma-separated --fields value, split into an array. */
+export declare function getFields(): string[] | undefined;
+export declare function getCacheMode(): CacheMode;