@switchbot/openapi-cli 3.2.1 → 3.3.0

package/dist/rules/suggest.js

@@ -1,96 +0,0 @@
-import { stringify as yamlStringify } from 'yaml';
-import { COMMAND_KEYWORDS } from '../lib/command-keywords.js';
-const TRIGGER_KEYWORDS = [
-    { pattern: /\bmotion\b|\bdetect/i, trigger: 'mqtt', event: 'motion.detected' },
-    { pattern: /\bdoor\b|\bcontact\b|\bopen.*sensor/i, trigger: 'mqtt', event: 'contact.opened' },
-    { pattern: /\bbutton\b|\bpress/i, trigger: 'mqtt', event: 'button.pressed' },
-    { pattern: /\bwebhook\b|\bhttp\b|\bifttt\b/i, trigger: 'webhook' },
-    { pattern: /\bevery\b|\bdaily\b|\bmorning\b|\bnight\b|\bevening\b|\b\d{1,2}\s*[ap]m\b/i, trigger: 'cron' },
-];
-function inferTrigger(intent) {
-    for (const t of TRIGGER_KEYWORDS) {
-        if (t.pattern.test(intent))
-            return { trigger: t.trigger, event: t.event };
-    }
-    return { trigger: 'mqtt', event: 'device.shadow' };
-}
-function inferSchedule(intent, warnings) {
-    const amMatch = /\b(\d{1,2})\s*am\b/i.exec(intent);
-    if (amMatch)
-        return `0 ${parseInt(amMatch[1], 10)} * * *`;
-    const pmMatch = /\b(\d{1,2})\s*pm\b/i.exec(intent);
-    if (pmMatch)
-        return `0 ${parseInt(pmMatch[1], 10) + 12} * * *`;
-    if (/\bevery\s*hour/i.test(intent))
-        return '0 * * * *';
-    if (/\bnight\b|\bevening\b/i.test(intent))
-        return '0 22 * * *';
-    if (/\bmorning\b/i.test(intent))
-        return '0 8 * * *';
-    warnings.push(`Could not infer cron schedule from intent "${intent}" — defaulted to "0 8 * * *". Edit the generated rule to set the correct schedule.`);
-    return '0 8 * * *';
-}
-function inferCommand(intent, warnings) {
-    for (const k of COMMAND_KEYWORDS) {
-        if (k.pattern.test(intent))
-            return k.command;
-    }
-    warnings.push(`Could not infer command from intent "${intent}" — defaulted to "turnOn". Edit the generated rule to set the correct command.`);
-    return 'turnOn';
-}
-export function suggestRule(opts) {
-    const warnings = [];
-    // Resolve trigger
-    let triggerSource = opts.trigger;
-    let inferredEvent;
-    if (!triggerSource) {
-        const inferred = inferTrigger(opts.intent);
-        triggerSource = inferred.trigger;
-        inferredEvent = inferred.event;
-        if (inferredEvent === 'device.shadow') {
-            warnings.push(`Could not infer trigger type from intent "${opts.intent}" — defaulted to mqtt/device.shadow. Set --trigger and --event explicitly.`);
-        }
-    }
-    // Build the when block
-    let when;
-    if (triggerSource === 'mqtt') {
-        const event = opts.event ?? inferredEvent ?? 'device.shadow';
-        const mqttTrigger = { source: 'mqtt', event };
-        if (opts.devices && opts.devices.length > 0) {
-            const sensorDevice = opts.devices[0];
-            mqttTrigger.device = sensorDevice.name ?? sensorDevice.id;
-        }
-        when = mqttTrigger;
-    }
-    else if (triggerSource === 'cron') {
-        const schedule = opts.schedule ?? inferSchedule(opts.intent, warnings);
-        const cronTrigger = { source: 'cron', schedule };
-        if (opts.days && opts.days.length > 0)
-            cronTrigger.days = opts.days;
-        when = cronTrigger;
-    }
-    else {
-        when = { source: 'webhook', path: opts.webhookPath ?? '/action' };
-    }
-    // Build then[] — one action per device (skip the sensor device for mqtt)
-    const command = inferCommand(opts.intent, warnings);
-    const actionDevices = triggerSource === 'mqtt' && opts.devices && opts.devices.length > 1
-        ? opts.devices.slice(1)
-        : (opts.devices ?? []);
-    const then = actionDevices.length > 0
-        ? actionDevices.map((d) => ({
-            command: `devices command <id> ${command}`,
-            device: d.id,
-        }))
-        : [{ command: `devices command <id> ${command}` }];
-    const rule = {
-        name: opts.intent,
-        when,
-        then,
-        dry_run: true,
-        ...(triggerSource === 'mqtt' ? { throttle: { max_per: '10m' } } : {}),
-    };
-    const ruleYaml = yamlStringify(rule, { lineWidth: 0 });
-    return { rule, ruleYaml, warnings };
-}
-//# sourceMappingURL=suggest.js.map

package/dist/rules/suggest.js.map

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

package/dist/rules/throttle.d.ts

@@ -1,61 +0,0 @@
-/**
- * Throttle gate — per-rule, optionally keyed by deviceId.
- *
- * Semantics:
- *   - `max_per: "10m"` → a rule may fire at most once every 10 minutes
- *     per (rule, deviceId) pair.
- *   - `dedupe_window: "5s"` → suppress fires whose key already fired
- *     within the window (collapses rapid sensor bursts into one action).
- *   - Fires that would violate the window are **suppressed** (not
- *     queued) and surface as `{ allowed: false, reason: 'throttled' }`.
- *   - When a rule has no `throttle` block, `ThrottleGate.check` returns
- *     `{ allowed: true }` immediately.
- *
- * The gate is in-memory only. Re-reads between processes (or after
- * SIGHUP reload) start with a clean slate — a deliberate choice,
- * because persisting throttle state would lock the engine into a
- * schema that changes every time we add a trigger type.
- */
-export declare function parseMaxPerMs(expr: string): number;
-export interface ThrottleCheckResult {
-    allowed: boolean;
-    /** Timestamp of the last fire that occupies the window, if any. */
-    lastFiredAt?: number;
-    /** When the window will reopen. */
-    nextAllowedAt?: number;
-    /** Whether this was blocked by the dedupe_window (vs max_per). */
-    dedupedBy?: 'dedupe_window' | 'max_per' | 'cooldown' | 'maxFiringsPerHour';
-}
-export interface MaxFiringsCheckResult {
-    allowed: boolean;
-    count: number;
-    max: number;
-}
-export declare class ThrottleGate {
-    private lastFireAt;
-    /** Sliding-window fire-time log for count-based maxFiringsPerHour. */
-    private fireTimes;
-    private keyOf;
-    /**
-     * Does **not** record the fire. Call `record()` after the action
-     * actually runs so that dry-run / throttled paths don't bump the
-     * window.
-     */
-    check(ruleName: string, windowMs: number | null, now: number, deviceId?: string, dedupeWindowMs?: number | null): ThrottleCheckResult;
-    record(ruleName: string, now: number, deviceId?: string): void;
-    /** Count-based check: has the rule fired >= maxCount times in the last windowMs? */
-    checkMaxFirings(ruleName: string, maxCount: number, windowMs: number, now: number, deviceId?: string): MaxFiringsCheckResult;
-    /** Record a count-based fire (call alongside record()). */
-    recordFire(ruleName: string, now: number, deviceId?: string): void;
-    /** Drop everything — used by engine.reload when a rule is removed. */
-    forget(ruleName: string): void;
-    /**
-     * Drop every window whose rule name isn't in the given set — used by
-     * `engine.reload` after a policy swap. Entries for names that survive
-     * the reload are preserved so unchanged rules don't get a free
-     * one-fire amnesty.
-     */
-    retainOnly(ruleNames: Set<string>): void;
-    /** Test helper — exposes the underlying size. */
-    size(): number;
-}

package/dist/rules/throttle.js

@@ -1,117 +0,0 @@
-/**
- * Throttle gate — per-rule, optionally keyed by deviceId.
- *
- * Semantics:
- *   - `max_per: "10m"` → a rule may fire at most once every 10 minutes
- *     per (rule, deviceId) pair.
- *   - `dedupe_window: "5s"` → suppress fires whose key already fired
- *     within the window (collapses rapid sensor bursts into one action).
- *   - Fires that would violate the window are **suppressed** (not
- *     queued) and surface as `{ allowed: false, reason: 'throttled' }`.
- *   - When a rule has no `throttle` block, `ThrottleGate.check` returns
- *     `{ allowed: true }` immediately.
- *
- * The gate is in-memory only. Re-reads between processes (or after
- * SIGHUP reload) start with a clean slate — a deliberate choice,
- * because persisting throttle state would lock the engine into a
- * schema that changes every time we add a trigger type.
- */
-const DURATION_RE = /^(\d+)([smh])$/;
-export function parseMaxPerMs(expr) {
-    const m = DURATION_RE.exec(expr.trim());
-    if (!m)
-        throw new Error(`Invalid throttle.max_per: "${expr}"`);
-    const n = Number(m[1]);
-    const unit = m[2];
-    const unitMs = unit === 's' ? 1_000 : unit === 'm' ? 60_000 : 3_600_000;
-    return n * unitMs;
-}
-export class ThrottleGate {
-    lastFireAt = new Map();
-    /** Sliding-window fire-time log for count-based maxFiringsPerHour. */
-    fireTimes = new Map();
-    keyOf(ruleName, deviceId) {
-        return deviceId ? `${ruleName}::${deviceId}` : ruleName;
-    }
-    /**
-     * Does **not** record the fire. Call `record()` after the action
-     * actually runs so that dry-run / throttled paths don't bump the
-     * window.
-     */
-    check(ruleName, windowMs, now, deviceId, dedupeWindowMs) {
-        const key = this.keyOf(ruleName, deviceId);
-        const last = this.lastFireAt.get(key);
-        // dedupe_window check: suppress if last fire was within this (typically smaller) window
-        if (dedupeWindowMs !== null && dedupeWindowMs !== undefined && dedupeWindowMs > 0) {
-            if (last !== undefined) {
-                const dedupeEnd = last + dedupeWindowMs;
-                if (now < dedupeEnd) {
-                    return { allowed: false, lastFiredAt: last, nextAllowedAt: dedupeEnd, dedupedBy: 'dedupe_window' };
-                }
-            }
-        }
-        // max_per / cooldown check
-        if (windowMs === null || windowMs <= 0)
-            return { allowed: true, lastFiredAt: last };
-        if (last === undefined)
-            return { allowed: true };
-        const earliest = last + windowMs;
-        if (now >= earliest)
-            return { allowed: true, lastFiredAt: last };
-        return { allowed: false, lastFiredAt: last, nextAllowedAt: earliest, dedupedBy: windowMs > 0 ? 'max_per' : undefined };
-    }
-    record(ruleName, now, deviceId) {
-        this.lastFireAt.set(this.keyOf(ruleName, deviceId), now);
-    }
-    /** Count-based check: has the rule fired >= maxCount times in the last windowMs? */
-    checkMaxFirings(ruleName, maxCount, windowMs, now, deviceId) {
-        const key = this.keyOf(ruleName, deviceId);
-        const times = (this.fireTimes.get(key) ?? []).filter((t) => now - t < windowMs);
-        this.fireTimes.set(key, times);
-        return { allowed: times.length < maxCount, count: times.length, max: maxCount };
-    }
-    /** Record a count-based fire (call alongside record()). */
-    recordFire(ruleName, now, deviceId) {
-        const key = this.keyOf(ruleName, deviceId);
-        const times = this.fireTimes.get(key) ?? [];
-        times.push(now);
-        this.fireTimes.set(key, times);
-    }
-    /** Drop everything — used by engine.reload when a rule is removed. */
-    forget(ruleName) {
-        const prefix = `${ruleName}::`;
-        for (const k of this.lastFireAt.keys()) {
-            if (k === ruleName || k.startsWith(prefix))
-                this.lastFireAt.delete(k);
-        }
-        for (const k of this.fireTimes.keys()) {
-            if (k === ruleName || k.startsWith(prefix))
-                this.fireTimes.delete(k);
-        }
-    }
-    /**
-     * Drop every window whose rule name isn't in the given set — used by
-     * `engine.reload` after a policy swap. Entries for names that survive
-     * the reload are preserved so unchanged rules don't get a free
-     * one-fire amnesty.
-     */
-    retainOnly(ruleNames) {
-        for (const k of this.lastFireAt.keys()) {
-            const sep = k.indexOf('::');
-            const ruleName = sep === -1 ? k : k.slice(0, sep);
-            if (!ruleNames.has(ruleName))
-                this.lastFireAt.delete(k);
-        }
-        for (const k of this.fireTimes.keys()) {
-            const sep = k.indexOf('::');
-            const ruleName = sep === -1 ? k : k.slice(0, sep);
-            if (!ruleNames.has(ruleName))
-                this.fireTimes.delete(k);
-        }
-    }
-    /** Test helper — exposes the underlying size. */
-    size() {
-        return this.lastFireAt.size;
-    }
-}
-//# sourceMappingURL=throttle.js.map

package/dist/rules/throttle.js.map

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

package/dist/rules/types.d.ts

@@ -1,117 +0,0 @@
-/**
- * Runtime TypeScript shapes for policy v0.2 rule objects.
- *
- * These are hand-mirrored from `src/policy/schema/v0.2.json` — the ajv
- * validator is the source of truth for what a file may contain, this
- * file is the source of truth for what the engine expects after load.
- * When you edit one, edit the other in the same commit.
- */
-import type { DestructiveCommand } from './destructive.js';
-export type TriggerSource = 'mqtt' | 'cron' | 'webhook';
-export interface MqttTrigger {
-    source: 'mqtt';
-    /**
-     * Event name matched against the engine's event classifier. Known
-     * values today: `device.shadow` (catch-all), `motion.detected`,
-     * `motion.cleared`, `contact.opened`, `contact.closed`.
-     */
-    event: string;
-    /** Optional filter by deviceId or alias. */
-    device?: string;
-}
-export type DayOfWeek = 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
-export interface CronTrigger {
-    source: 'cron';
-    /** Standard 5-field cron (minute hour dom month dow), local tz. */
-    schedule: string;
-    /**
-     * Optional weekday filter applied AFTER the cron expression fires.
-     * When omitted, every firing passes. Values are matched
-     * case-insensitively against the local weekday name.
-     */
-    days?: DayOfWeek[];
-}
-export interface WebhookTrigger {
-    source: 'webhook';
-    /** Local HTTP path the rule engine listens on, e.g. `/kitchen/motion`. */
-    path: string;
-}
-export type Trigger = MqttTrigger | CronTrigger | WebhookTrigger;
-export interface TimeBetweenCondition {
-    time_between: [string, string];
-}
-export interface DeviceStateCondition {
-    device: string;
-    field: string;
-    op: '==' | '!=' | '<' | '>' | '<=' | '>=';
-    value: unknown;
-}
-export interface AllCondition {
-    all: Condition[];
-}
-export interface AnyCondition {
-    any: Condition[];
-}
-export interface NotCondition {
-    not: Condition;
-}
-export type Condition = TimeBetweenCondition | DeviceStateCondition | AllCondition | AnyCondition | NotCondition;
-export interface Action {
-    command: string;
-    device?: string;
-    args?: Record<string, unknown> | null;
-    on_error?: 'continue' | 'stop';
-}
-export interface Throttle {
-    max_per: string;
-    /** Deduplicate identical events arriving within this window after the last fire. */
-    dedupe_window?: string;
-}
-export interface Rule {
-    name: string;
-    enabled?: boolean;
-    when: Trigger;
-    conditions?: Condition[] | null;
-    then: Action[];
-    throttle?: Throttle | null;
-    dry_run?: boolean;
-    /** Shorthand cooldown — equivalent to throttle.max_per. Takes precedence when both are set. */
-    cooldown?: string;
-    /** Hysteresis guard — device state must remain stable for this duration before the rule fires. */
-    requires_stable_for?: string;
-    /** Alias for requires_stable_for with clearer semantics (takes precedence when both are set). */
-    hysteresis?: string;
-    /** Maximum times this rule may fire per rolling hour (count-based rate limit). */
-    maxFiringsPerHour?: number;
-    /** Skip the action if the device's last-known cached state already matches the desired command outcome. */
-    suppressIfAlreadyDesired?: boolean;
-}
-export interface AutomationBlock {
-    enabled?: boolean;
-    rules?: Rule[] | null;
-}
-/**
- * Engine event — unified shape the matcher consumes regardless of
- * trigger source.
- */
-export interface EngineEvent {
-    source: TriggerSource;
-    /** Classifier output for MQTT; schedule string for cron; path for webhook. */
-    event: string;
-    t: Date;
-    /** Resolved deviceId if the trigger carried one (MQTT). */
-    deviceId?: string;
-    /** Raw trigger payload for inspection / audit. */
-    payload?: unknown;
-}
-/** Guards used outside this file. */
-export declare function isMqttTrigger(t: Trigger): t is MqttTrigger;
-export declare function isCronTrigger(t: Trigger): t is CronTrigger;
-export declare function isWebhookTrigger(t: Trigger): t is WebhookTrigger;
-export declare function isTimeBetween(c: Condition): c is TimeBetweenCondition;
-export declare function isDeviceState(c: Condition): c is DeviceStateCondition;
-export declare function isAllCondition(c: Condition): c is AllCondition;
-export declare function isAnyCondition(c: Condition): c is AnyCondition;
-export declare function isNotCondition(c: Condition): c is NotCondition;
-/** Re-export for consumers that want the single list without a second import. */
-export type { DestructiveCommand };

package/dist/rules/types.js

@@ -1,35 +0,0 @@
-/**
- * Runtime TypeScript shapes for policy v0.2 rule objects.
- *
- * These are hand-mirrored from `src/policy/schema/v0.2.json` — the ajv
- * validator is the source of truth for what a file may contain, this
- * file is the source of truth for what the engine expects after load.
- * When you edit one, edit the other in the same commit.
- */
-/** Guards used outside this file. */
-export function isMqttTrigger(t) {
-    return t.source === 'mqtt';
-}
-export function isCronTrigger(t) {
-    return t.source === 'cron';
-}
-export function isWebhookTrigger(t) {
-    return t.source === 'webhook';
-}
-export function isTimeBetween(c) {
-    return Array.isArray(c.time_between);
-}
-export function isDeviceState(c) {
-    const d = c;
-    return typeof d.device === 'string' && typeof d.field === 'string' && typeof d.op === 'string';
-}
-export function isAllCondition(c) {
-    return Array.isArray(c.all);
-}
-export function isAnyCondition(c) {
-    return Array.isArray(c.any);
-}
-export function isNotCondition(c) {
-    return c.not !== undefined && !Array.isArray(c.not);
-}
-//# sourceMappingURL=types.js.map

package/dist/rules/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rules/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuHH,qCAAqC;AACrC,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;AAC7B,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;AAC7B,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,OAAO,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;AAChC,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,CAAY;IACxC,OAAO,KAAK,CAAC,OAAO,CAAE,CAA0B,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,CAAY;IACxC,MAAM,CAAC,GAAG,CAAyB,CAAC;IACpC,OAAO,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC;AACjG,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,CAAY;IACzC,OAAO,KAAK,CAAC,OAAO,CAAE,CAAkB,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,CAAY;IACzC,OAAO,KAAK,CAAC,OAAO,CAAE,CAAkB,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,CAAY;IACzC,OAAQ,CAAkB,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,CAAkB,CAAC,GAAG,CAAC,CAAC;AAC1F,CAAC"}

package/dist/rules/webhook-listener.d.ts

@@ -1,63 +0,0 @@
-/**
- * Local HTTP listener that delivers webhook events to the rules engine.
- *
- * Scope (E2):
- *   - Binds to `127.0.0.1` only — the loopback interface keeps the
- *     listener off the network by default. The plan's integration story
- *     is that an agent or local script POSTs to this endpoint.
- *   - Default port is 18790 (phase-3 design doc choice); override with
- *     `--webhook-port <n>` in `switchbot rules run`. `--webhook-port 0`
- *     asks the OS for an ephemeral port — useful in tests.
- *   - Bearer-token auth on every request: `Authorization: Bearer <t>`.
- *     The expected token comes from `WebhookTokenStore`; unauthorized
- *     requests get a 401 with no body, no hint about which header
- *     failed, and an audit entry (`rule-webhook-rejected`).
- *   - Matches request path against registered webhook rules: only
- *     `POST /path/exactly/as/declared`. Unknown paths return 404.
- *
- * Non-goals:
- *   - No TLS; operators who expose this outside loopback are expected
- *     to sit behind a reverse proxy that terminates TLS.
- *   - No payload parsing beyond reading the body as a string — the
- *     engine passes the raw body through in the event payload.
- */
-import type { EngineEvent, Rule } from './types.js';
-export declare const DEFAULT_WEBHOOK_PORT = 18790;
-export interface WebhookDispatch {
-    (rule: Rule, event: EngineEvent): Promise<void>;
-}
-export interface WebhookListenerOptions {
-    rules: Rule[];
-    /** Bearer token used to authorize incoming requests. */
-    bearerToken: string;
-    /**
-     * Host interface to bind. Defaults to 127.0.0.1; tests can set this
-     * to '127.0.0.1' + port 0 for ephemeral allocation.
-     */
-    host?: string;
-    port?: number;
-    dispatch: WebhookDispatch;
-    /** Optional clock — tests inject a deterministic value. */
-    now?: () => Date;
-}
-export declare class WebhookListener {
-    private readonly opts;
-    private server;
-    private readonly pathIndex;
-    private actualPort;
-    constructor(opts: WebhookListenerOptions);
-    /** Start listening. Resolves once the server has bound a port. */
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getPort(): number | null;
-    listPaths(): string[];
-    /**
-     * Replace the current rule → path index. Used by `engine.reload`: the
-     * listener keeps its open port and accepted connections, but routes
-     * subsequent requests against the fresh policy.
-     */
-    updateRules(rules: Rule[]): void;
-    private handle;
-    private isAuthorized;
-    private now;
-}