@switchbot/openapi-cli 3.1.1 → 3.2.1

package/dist/rules/pid-file.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Cross-platform supervisor glue for `switchbot rules run`.
+ *
+ * The running engine registers a pid file and a reload sentinel under
+ * `~/.switchbot/`; the `switchbot rules reload` subcommand reads them
+ * to signal the live process:
+ *
+ *   - Unix (SIGHUP supported): `process.kill(pid, 'SIGHUP')`.
+ *   - Windows (no SIGHUP): write `~/.switchbot/rules.reload`. The engine
+ *     polls this path and consumes it, so the same `rules reload`
+ *     command works on every platform.
+ *
+ * The files are tiny (<100 bytes) and created with 0o600; cleanup is
+ * best-effort on exit so a crash leaves at most a stale pid the user
+ * can overwrite with a fresh `rules run`.
+ */
+export interface PidFilePaths {
+    dir: string;
+    pidFile: string;
+    reloadFile: string;
+}
+export declare function getDefaultPidFilePaths(): PidFilePaths;
+/** Write the current process pid. Creates parent dir with 0700 if needed. */
+export declare function writePidFile(pidFile: string, pid?: number): void;
+/** Return the pid persisted in the file, or null if absent / unparseable. */
+export declare function readPidFile(pidFile: string): number | null;
+/**
+ * Remove the pid file only when it still refers to the current process.
+ * A stale file from an earlier run is left alone so we don't accidentally
+ * clobber a new supervisor that already won the race.
+ */
+export declare function clearPidFile(pidFile: string, pid?: number): void;
+export declare function writeReloadSentinel(reloadFile: string): void;
+export declare function consumeReloadSentinel(reloadFile: string): boolean;
+/** Detect whether SIGHUP is usable on the current platform. */
+export declare function sighupSupported(): boolean;
+/**
+ * Check whether a pid is alive — used by `rules reload` to avoid
+ * signalling dead pids, which would otherwise leave the user wondering
+ * why nothing happened. Node's `process.kill(pid, 0)` throws `ESRCH`
+ * for dead pids and `EPERM` for pids we cannot signal (still alive).
+ */
+export declare function isPidAlive(pid: number): boolean;

package/dist/rules/pid-file.js

@@ -93,3 +93,4 @@ export function isPidAlive(pid) {
         return code === 'EPERM';
     }
 }
+//# sourceMappingURL=pid-file.js.map

package/dist/rules/pid-file.js.map

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

package/dist/rules/quiet-hours.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Time-window helpers shared by `time_between` conditions and (later)
+ * the top-level `quiet_hours` block. Both evaluate a local-clock HH:MM
+ * range that may cross midnight.
+ */
+export interface TimeWindow {
+    start: string;
+    end: string;
+}
+/**
+ * `true` when `now` falls inside the window. If `start > end` the window
+ * is interpreted as overnight (e.g. 22:00 → 07:00 crosses midnight).
+ *
+ * Boundary semantics: start is inclusive, end is exclusive. A window of
+ * 09:00 → 09:00 therefore matches nothing — callers who want "always"
+ * should omit the condition entirely rather than fake it with equal
+ * times.
+ */
+export declare function isWithin(window: TimeWindow, now: Date): boolean;
+/** Convenience wrapper that accepts the schema's tuple shape. */
+export declare function isWithinTuple(range: [string, string], now: Date): boolean;
+/** Top-level quiet_hours block helper — same math, schema shape differs. */
+export declare function isInQuietHours(qh: {
+    start?: string;
+    end?: string;
+} | null | undefined, now: Date): boolean;

package/dist/rules/quiet-hours.js

@@ -43,3 +43,4 @@ export function isInQuietHours(qh, now) {
         return false;
     return isWithin({ start: qh.start, end: qh.end }, now);
 }
+//# sourceMappingURL=quiet-hours.js.map

package/dist/rules/quiet-hours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiet-hours.js","sourceRoot":"","sources":["../../src/rules/quiet-hours.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,IAAI,GAAG,2BAA2B,CAAC;AAOzC,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,SAAS,CAAC,CAAO;IACxB,OAAO,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAkB,EAAE,GAAS;IACpD,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,KAAuB,EAAE,GAAS;IAC9D,OAAO,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAC5B,EAAuD,EACvD,GAAS;IAET,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/dist/rules/suggest.d.ts

@@ -0,0 +1,20 @@
+import type { Rule } from './types.js';
+export interface SuggestRuleOptions {
+    intent: string;
+    trigger?: 'mqtt' | 'cron' | 'webhook';
+    devices?: Array<{
+        id: string;
+        name?: string;
+        type?: string;
+    }>;
+    event?: string;
+    schedule?: string;
+    days?: string[];
+    webhookPath?: string;
+}
+export interface SuggestRuleResult {
+    rule: Rule;
+    ruleYaml: string;
+    warnings: string[];
+}
+export declare function suggestRule(opts: SuggestRuleOptions): SuggestRuleResult;

package/dist/rules/suggest.js

@@ -93,3 +93,4 @@ export function suggestRule(opts) {
     const ruleYaml = yamlStringify(rule, { lineWidth: 0 });
     return { rule, ruleYaml, warnings };
 }
+//# sourceMappingURL=suggest.js.map

package/dist/rules/suggest.js.map

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

package/dist/rules/throttle.d.ts

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

@@ -114,3 +114,4 @@ export class ThrottleGate {
         return this.lastFireAt.size;
     }
 }
+//# sourceMappingURL=throttle.js.map

package/dist/rules/throttle.js.map

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

package/dist/rules/types.d.ts

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

@@ -32,3 +32,4 @@ export function isAnyCondition(c) {
 export function isNotCondition(c) {
     return c.not !== undefined && !Array.isArray(c.not);
 }
+//# sourceMappingURL=types.js.map

package/dist/rules/types.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,63 @@
+/**
+ * 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;
+}

package/dist/rules/webhook-listener.js

@@ -221,3 +221,4 @@ function readLimitedBody(req, max) {
         req.on('error', reject);
     });
 }
+//# sourceMappingURL=webhook-listener.js.map

package/dist/rules/webhook-listener.js.map

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

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

@@ -0,0 +1,50 @@
+/**
+ * Webhook bearer-token management for the rules engine.
+ *
+ * Responsibilities:
+ *   - Resolve the bearer token the listener will accept. The order is
+ *     env var (SWITCHBOT_WEBHOOK_TOKEN) → on-disk cache
+ *     (~/.switchbot/webhook-token, chmod 0600) → generate a fresh
+ *     32-byte hex token and persist it.
+ *   - Rotate the token on demand (`rules webhook-rotate-token` cli).
+ *
+ * Why not the OS keychain (F1 abstraction)? The webhook bearer is a
+ * single opaque string, whereas `CredentialStore` is shaped around the
+ * SwitchBot {token,secret} bundle. Fitting a one-field artifact into
+ * that contract bloats every profile; keeping it in a 0600 file gives
+ * the same protection the CLI has used for `~/.switchbot/config.json`.
+ * Promotion into the keychain is a future follow-up once the
+ * abstraction grows a generic single-value slot.
+ */
+export interface WebhookTokenStoreOptions {
+    /** Override the resolved token path — tests use a tmpdir. */
+    filePath?: string;
+    /**
+     * Override the environment lookup. When set to `false` the env var is
+     * not consulted; useful for tests that want the file path exercised
+     * even though a token is set in the shell.
+     */
+    envLookup?: () => string | undefined;
+}
+export declare class WebhookTokenStore {
+    private readonly filePath;
+    private readonly envLookup;
+    constructor(opts?: WebhookTokenStoreOptions);
+    /**
+     * Return a bearer token, creating + persisting one if none exists yet.
+     * Env var wins when set; otherwise the on-disk token is read (and
+     * generated on first call).
+     */
+    getOrCreate(): string;
+    /**
+     * Read the persisted token, returning null when the file is absent
+     * or empty. Does NOT consult the env var — callers that want the
+     * env-aware path should use `getOrCreate()`.
+     */
+    readFromDisk(): string | null;
+    /** Write a new token, persisting with 0600 perms. */
+    rotate(): string;
+    getFilePath(): string;
+    private writeToDisk;
+}
+export declare function generateToken(): string;

package/dist/rules/webhook-token.js

@@ -88,3 +88,4 @@ export class WebhookTokenStore {
 export function generateToken() {
     return randomBytes(32).toString('hex');
 }
+//# sourceMappingURL=webhook-token.js.map

package/dist/rules/webhook-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-token.js","sourceRoot":"","sources":["../../src/rules/webhook-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAC5C,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAahD,MAAM,OAAO,iBAAiB;IACX,QAAQ,CAAS;IACjB,SAAS,CAA2B;IAErD,YAAY,OAAiC,EAAE;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;QACvE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;QAEhE,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAClE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,MAAM;QACJ,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,oEAAoE;QACpE,gEAAgE;QAChE,wCAAwC;QACxC,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/schema/field-aliases.d.ts

@@ -0,0 +1,34 @@
+/**
+ * User-facing aliases for canonical field names.
+ *
+ * Keys are canonical names (matching API response keys and CLI/schema output);
+ * values are lowercase alternatives a user may type for `--fields` or `--filter`.
+ *
+ * Conflict rules (do not add an alias that violates these — tests will fail):
+ * - `temp` is exclusive to `temperature` (NOT `colorTemperature`, `targetTemperature`).
+ * - `motion` is exclusive to `moveDetected`; `moving` uses `active` instead.
+ * - `mode` is exclusive to top-level `mode` (preset); device-specific modes go through `deviceMode`.
+ * - Reserved / too-generic words never appear as aliases: `auto`, `status`, `state`,
+ *   `switch`, `type`, `on`, `off`.
+ * - Device-type words are never aliases: `lock`, `fan`.
+ */
+export declare const FIELD_ALIASES: Record<string, readonly string[]>;
+/**
+ * Resolve a user-typed field name to its canonical form against an allowed list.
+ *
+ * Matching is case-insensitive and trims surrounding whitespace. Direct matches
+ * win over alias matches. Throws UsageError if the input is empty or does not
+ * match any canonical / alias in the allowed list.
+ */
+export declare function resolveField(input: string, allowedCanonical: readonly string[]): string;
+/**
+ * Resolve every field in a list. Preserves order and the original UsageError
+ * from resolveField() on the first unknown input.
+ */
+export declare function resolveFieldList(inputs: readonly string[], allowedCanonical: readonly string[]): string[];
+export declare function listSupportedFieldInputs(allowedCanonical: readonly string[]): string[];
+/**
+ * All canonical keys known to the alias registry. Use when no dynamic
+ * canonical list is available (e.g. `watch` before the first poll response).
+ */
+export declare function listAllCanonical(): string[];

package/dist/schema/field-aliases.js

@@ -129,3 +129,4 @@ export function listSupportedFieldInputs(allowedCanonical) {
 export function listAllCanonical() {
     return Object.keys(FIELD_ALIASES);
 }
+//# sourceMappingURL=field-aliases.js.map

package/dist/schema/field-aliases.js.map

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

package/dist/sinks/dispatcher.d.ts

@@ -0,0 +1,7 @@
+import type { Sink, MqttSinkEvent } from './types.js';
+export declare class SinkDispatcher {
+    private sinks;
+    constructor(sinks: Sink[]);
+    dispatch(event: MqttSinkEvent): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/sinks/dispatcher.js

@@ -10,3 +10,4 @@ export class SinkDispatcher {
         await Promise.allSettled(this.sinks.map((s) => s.close?.()));
     }
 }
+//# sourceMappingURL=dispatcher.js.map

package/dist/sinks/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/sinks/dispatcher.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACjB,KAAK,CAAS;IAEtB,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAoB;QACjC,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/sinks/file.d.ts

@@ -0,0 +1,6 @@
+import type { Sink, MqttSinkEvent } from './types.js';
+export declare class FileSink implements Sink {
+    private filePath;
+    constructor(filePath: string);
+    write(event: MqttSinkEvent): Promise<void>;
+}

package/dist/sinks/file.js

@@ -17,3 +17,4 @@ export class FileSink {
         }
     }
 }
+//# sourceMappingURL=file.js.map

package/dist/sinks/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/sinks/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,OAAO,QAAQ;IACX,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAoB;QAC9B,IAAI,CAAC;YACH,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACxF,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;CACF"}

package/dist/sinks/format.d.ts

@@ -0,0 +1,20 @@
+export interface DeviceContext {
+    deviceMac?: string;
+    deviceType?: string;
+    temperature?: number;
+    humidity?: number;
+    power?: string;
+    battery?: number;
+    brightness?: string;
+    detectionState?: string;
+    openState?: string;
+    lockState?: string;
+    lightLevel?: number;
+    [key: string]: unknown;
+}
+export declare function formatEventText(context: DeviceContext): string;
+export declare function parseSinkEvent(payload: unknown): {
+    deviceId: string;
+    deviceType: string;
+    text: string;
+};

package/dist/sinks/format.js

@@ -54,3 +54,4 @@ export function parseSinkEvent(payload) {
         text: formatEventText(context),
     };
 }
+//# sourceMappingURL=format.js.map

package/dist/sinks/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/sinks/format.ts"],"names":[],"mappings":"AAeA,MAAM,KAAK,GAA2B;IACpC,KAAK,EAAE,IAAI;IACX,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,gBAAgB,EAAE,IAAI;IACtB,MAAM,EAAE,IAAI;IACZ,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,IAAI;IACrB,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF,SAAS,IAAI,CAAC,UAAkB;IAC9B,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC;IAC7C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IACpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,GAAG,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAExD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,GAAG,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;IACnE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,GAAG,GAAG,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;IAC3E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,GAAG,GAAG,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;IAC3E,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,GAAG,GAAG,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC;IACrF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,GAAG,GAAG,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;IAE7E,OAAO,GAAG,GAAG,gBAAgB,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAK7C,MAAM,CAAC,GAAG,OAAqD,CAAC;IAChE,MAAM,OAAO,GAAI,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAmB,CAAC;IACtD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC;QAChD,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC;QACnD,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/sinks/homeassistant.d.ts

@@ -0,0 +1,18 @@
+import type { Sink, MqttSinkEvent } from './types.js';
+export interface HomeAssistantSinkOptions {
+    url: string;
+    /** Long-lived access token — used when webhookId is not set */
+    token?: string;
+    /** Webhook ID — no auth required, takes priority over token */
+    webhookId?: string;
+    /** Event type for REST event API (default: switchbot_event) */
+    eventType?: string;
+}
+export declare class HomeAssistantSink implements Sink {
+    private url;
+    private token?;
+    private webhookId?;
+    private eventType;
+    constructor(opts: HomeAssistantSinkOptions);
+    write(event: MqttSinkEvent): Promise<void>;
+}