@switchbot/openapi-cli 3.2.0 → 3.2.1

package/dist/utils/quota.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Local quota counter. Tracks the SwitchBot 10k/day request budget so the
+ * CLI (and any AI agent) can check "how many calls have I already burned?"
+ * without pinging the API.
+ *
+ * Shape (`~/.switchbot/quota.json`):
+ *   {
+ *     "days": {
+ *       "2026-04-18": {
+ *         "total": 42,
+ *         "endpoints": {
+ *           "GET /v1.1/devices": 3,
+ *           "GET /v1.1/devices/:id/status": 27,
+ *           "POST /v1.1/devices/:id/commands": 12
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * We keep the last 7 days to bound the file size and give a short-term
+ * trend. Writes are fire-and-forget — a failed write never breaks the
+ * actual API call.
+ */
+export declare const DAILY_QUOTA = 10000;
+export interface DayBucket {
+    total: number;
+    endpoints: Record<string, number>;
+}
+export interface QuotaFile {
+    days: Record<string, DayBucket>;
+}
+export declare function loadQuota(): QuotaFile;
+/**
+ * Normalise a full URL into a SwitchBot-style endpoint pattern. The segment
+ * immediately after `devices` or `scenes` is collapsed to `:id` so we can
+ * bucket by endpoint shape rather than by specific deviceId/sceneId.
+ */
+export declare function normaliseEndpoint(method: string, url: string): string;
+/** Record a single request. Bucketed by local-date + endpoint pattern. */
+export declare function recordRequest(method: string, url: string, now?: Date): void;
+export declare function flushQuota(): void;
+export declare function resetQuotaState(): void;
+export declare function resetQuota(): void;
+/** Return today's usage (convenience for `quota status`). */
+export declare function todayUsage(now?: Date): {
+    date: string;
+    total: number;
+    remaining: number;
+    endpoints: Record<string, number>;
+};
+/**
+ * Check whether today's call count is at or over the given cap. Returns the
+ * current counter either way so callers can render a helpful refusal message.
+ * Undefined cap → returns { over: false } without loading anything.
+ */
+export declare function checkDailyCap(dailyCap: number | undefined, now?: Date): {
+    over: boolean;
+    total: number;
+    cap?: number;
+    date: string;
+};

package/dist/utils/quota.js

@@ -0,0 +1,228 @@
+/**
+ * Local quota counter. Tracks the SwitchBot 10k/day request budget so the
+ * CLI (and any AI agent) can check "how many calls have I already burned?"
+ * without pinging the API.
+ *
+ * Shape (`~/.switchbot/quota.json`):
+ *   {
+ *     "days": {
+ *       "2026-04-18": {
+ *         "total": 42,
+ *         "endpoints": {
+ *           "GET /v1.1/devices": 3,
+ *           "GET /v1.1/devices/:id/status": 27,
+ *           "POST /v1.1/devices/:id/commands": 12
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * We keep the last 7 days to bound the file size and give a short-term
+ * trend. Writes are fire-and-forget — a failed write never breaks the
+ * actual API call.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+export const DAILY_QUOTA = 10_000;
+const MAX_RETAINED_DAYS = 7;
+const FLUSH_DELAY_MS = 250;
+let quotaCache = null;
+let loadedPath = null;
+let dirty = false;
+let flushTimer = null;
+let flushHooksRegistered = false;
+function quotaFilePath() {
+    return path.join(os.homedir(), '.switchbot', 'quota.json');
+}
+function today(now = new Date()) {
+    // Local date, not UTC — SwitchBot's quota window is loose but users
+    // reason about "today" in their own timezone.
+    const y = now.getFullYear();
+    const m = String(now.getMonth() + 1).padStart(2, '0');
+    const d = String(now.getDate()).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
+function emptyFile() {
+    return { days: {} };
+}
+function loadQuotaFromDisk(file) {
+    if (!fs.existsSync(file))
+        return emptyFile();
+    try {
+        const raw = fs.readFileSync(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || !parsed.days)
+            return emptyFile();
+        return parsed;
+    }
+    catch {
+        return emptyFile();
+    }
+}
+function saveQuota(data, file = quotaFilePath()) {
+    const dir = path.dirname(file);
+    try {
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(file, JSON.stringify(data, null, 2));
+    }
+    catch {
+        // swallow: counting is best-effort, must not break a real API call
+    }
+}
+function clearScheduledFlush() {
+    if (flushTimer) {
+        clearTimeout(flushTimer);
+        flushTimer = null;
+    }
+}
+function syncLoadedQuota() {
+    const file = quotaFilePath();
+    if (loadedPath !== file) {
+        clearScheduledFlush();
+        quotaCache = loadQuotaFromDisk(file);
+        loadedPath = file;
+        dirty = false;
+    }
+    if (!quotaCache) {
+        quotaCache = loadQuotaFromDisk(file);
+        loadedPath = file;
+    }
+    return quotaCache;
+}
+function ensureFlushHooks() {
+    if (flushHooksRegistered)
+        return;
+    flushHooksRegistered = true;
+    process.on('beforeExit', () => flushQuota());
+    process.on('exit', () => flushQuota());
+    // SIGINT/SIGTERM: attaching a listener suppresses Node's default terminate.
+    // Flush the counter, then re-raise the conventional exit code (128 + signo).
+    process.on('SIGINT', () => {
+        flushQuota();
+        process.exit(130);
+    });
+    process.on('SIGTERM', () => {
+        flushQuota();
+        process.exit(143);
+    });
+}
+function scheduleFlush() {
+    dirty = true;
+    ensureFlushHooks();
+    if (flushTimer)
+        return;
+    flushTimer = setTimeout(() => {
+        flushTimer = null;
+        flushQuota();
+    }, FLUSH_DELAY_MS);
+    flushTimer.unref?.();
+}
+export function loadQuota() {
+    return syncLoadedQuota();
+}
+function prune(data) {
+    const keys = Object.keys(data.days).sort();
+    if (keys.length <= MAX_RETAINED_DAYS)
+        return data;
+    const keep = keys.slice(keys.length - MAX_RETAINED_DAYS);
+    const next = { days: {} };
+    for (const k of keep)
+        next.days[k] = data.days[k];
+    return next;
+}
+/**
+ * Normalise a full URL into a SwitchBot-style endpoint pattern. The segment
+ * immediately after `devices` or `scenes` is collapsed to `:id` so we can
+ * bucket by endpoint shape rather than by specific deviceId/sceneId.
+ */
+export function normaliseEndpoint(method, url) {
+    const m = (method || 'GET').toUpperCase();
+    let pathOnly = url;
+    try {
+        const parsed = new URL(url);
+        pathOnly = parsed.pathname;
+    }
+    catch {
+        const q = url.indexOf('?');
+        if (q !== -1)
+            pathOnly = url.slice(0, q);
+    }
+    const segments = pathOnly.split('/');
+    for (let i = 0; i < segments.length - 1; i++) {
+        if (segments[i] === 'devices' || segments[i] === 'scenes') {
+            // Only collapse when the next segment looks like an id (not another
+            // API verb); the SwitchBot API uses lower-case keywords elsewhere,
+            // but guard against future collisions.
+            const next = segments[i + 1];
+            if (next && next.length > 0) {
+                segments[i + 1] = ':id';
+            }
+        }
+    }
+    return `${m} ${segments.join('/')}`;
+}
+/** Record a single request. Bucketed by local-date + endpoint pattern. */
+export function recordRequest(method, url, now = new Date()) {
+    const key = today(now);
+    const endpoint = normaliseEndpoint(method, url);
+    const data = syncLoadedQuota();
+    const bucket = data.days[key] ?? { total: 0, endpoints: {} };
+    bucket.total += 1;
+    bucket.endpoints[endpoint] = (bucket.endpoints[endpoint] ?? 0) + 1;
+    data.days[key] = bucket;
+    quotaCache = prune(data);
+    scheduleFlush();
+}
+export function flushQuota() {
+    if (!dirty)
+        return;
+    const data = syncLoadedQuota();
+    saveQuota(prune(data));
+    dirty = false;
+}
+export function resetQuotaState() {
+    clearScheduledFlush();
+    quotaCache = null;
+    loadedPath = null;
+    dirty = false;
+}
+export function resetQuota() {
+    resetQuotaState();
+    const file = quotaFilePath();
+    try {
+        if (fs.existsSync(file))
+            fs.unlinkSync(file);
+    }
+    catch {
+        // ignore
+    }
+}
+/** Return today's usage (convenience for `quota status`). */
+export function todayUsage(now = new Date()) {
+    const key = today(now);
+    const data = loadQuota();
+    const bucket = data.days[key] ?? { total: 0, endpoints: {} };
+    return {
+        date: key,
+        total: bucket.total,
+        remaining: Math.max(0, DAILY_QUOTA - bucket.total),
+        endpoints: { ...bucket.endpoints },
+    };
+}
+/**
+ * Check whether today's call count is at or over the given cap. Returns the
+ * current counter either way so callers can render a helpful refusal message.
+ * Undefined cap → returns { over: false } without loading anything.
+ */
+export function checkDailyCap(dailyCap, now = new Date()) {
+    const date = today(now);
+    if (!dailyCap || dailyCap <= 0) {
+        return { over: false, total: 0, date };
+    }
+    const data = loadQuota();
+    const total = data.days[date]?.total ?? 0;
+    return { over: total >= dailyCap, total, cap: dailyCap, date };
+}
+//# sourceMappingURL=quota.js.map

package/dist/utils/quota.js.map

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

package/dist/utils/redact.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Header/value redaction utilities for verbose traces.
+ *
+ * C6 contract: any header whose name matches a sensitive pattern is mid-masked
+ * (first 2 chars + `*` run + last 2 chars) before it is written to stderr. The
+ * `--trace-unsafe` flag turns masking off — with a prominent one-time warning.
+ */
+export declare function isSensitiveHeader(name: string): boolean;
+export declare function maskValue(value: string): string;
+/**
+ * Redact the sensitive entries of a headers object. Returns a new object
+ * alongside the count of entries that were masked.
+ */
+export declare function redactHeaders(headers: Record<string, unknown> | undefined): {
+    safe: Record<string, string>;
+    redactedCount: number;
+};
+/**
+ * Print the big "REDACTION DISABLED" banner once per process when
+ * --trace-unsafe is on. Callers should invoke this once before any
+ * header-spilling output.
+ */
+export declare function warnOnceIfUnsafe(): void;

package/dist/utils/redact.js

@@ -0,0 +1,69 @@
+/**
+ * Header/value redaction utilities for verbose traces.
+ *
+ * C6 contract: any header whose name matches a sensitive pattern is mid-masked
+ * (first 2 chars + `*` run + last 2 chars) before it is written to stderr. The
+ * `--trace-unsafe` flag turns masking off — with a prominent one-time warning.
+ */
+import { isTraceUnsafe } from './flags.js';
+const SENSITIVE_HEADER_PATTERNS = [
+    /^authorization$/i,
+    /^token$/i,
+    /^sign$/i,
+    /^nonce$/i,
+    /^x-api-key$/i,
+    /^cookie$/i,
+    /^set-cookie$/i,
+    /^x-auth-token$/i,
+];
+// The `t` header (timestamp) is treated as sensitive alongside sign because
+// together they reconstruct the HMAC signature — anyone watching the logs
+// shouldn't be able to replay the exact timestamp that was used.
+const SENSITIVE_EXACT_KEYS = new Set(['t']);
+export function isSensitiveHeader(name) {
+    if (SENSITIVE_EXACT_KEYS.has(name))
+        return true;
+    return SENSITIVE_HEADER_PATTERNS.some((re) => re.test(name));
+}
+export function maskValue(value) {
+    if (value.length <= 4)
+        return '****';
+    return `${value.slice(0, 2)}${'*'.repeat(Math.max(4, value.length - 4))}${value.slice(-2)}`;
+}
+/**
+ * Redact the sensitive entries of a headers object. Returns a new object
+ * alongside the count of entries that were masked.
+ */
+export function redactHeaders(headers) {
+    const safe = {};
+    let redactedCount = 0;
+    if (!headers)
+        return { safe, redactedCount };
+    const unsafe = isTraceUnsafe();
+    for (const [k, v] of Object.entries(headers)) {
+        const strVal = typeof v === 'string' ? v : v == null ? '' : String(v);
+        if (!unsafe && isSensitiveHeader(k)) {
+            safe[k] = maskValue(strVal);
+            redactedCount++;
+        }
+        else {
+            safe[k] = strVal;
+        }
+    }
+    return { safe, redactedCount };
+}
+let unsafeBannerShown = false;
+/**
+ * Print the big "REDACTION DISABLED" banner once per process when
+ * --trace-unsafe is on. Callers should invoke this once before any
+ * header-spilling output.
+ */
+export function warnOnceIfUnsafe() {
+    if (unsafeBannerShown)
+        return;
+    if (!isTraceUnsafe())
+        return;
+    unsafeBannerShown = true;
+    process.stderr.write('⚠️  --trace-unsafe: sensitive headers will be printed UNMASKED. Do not share this output.\n');
+}
+//# sourceMappingURL=redact.js.map

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,yBAAyB,GAAG;IAChC,kBAAkB;IAClB,UAAU;IACV,SAAS;IACT,UAAU;IACV,cAAc;IACd,WAAW;IACX,eAAe;IACf,iBAAiB;CAClB,CAAC;AAEF,4EAA4E;AAC5E,0EAA0E;AAC1E,iEAAiE;AACjE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACrC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA4C;IAE5C,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAC5B,aAAa,EAAE,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACjC,CAAC;AAED,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAC9B;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,iBAAiB;QAAE,OAAO;IAC9B,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IAC7B,iBAAiB,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6FAA6F,CAC9F,CAAC;AACJ,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Retry/backoff helpers for the axios client. Kept as pure functions so
+ * tests can pin attempt → delay without wall-clock sleeping.
+ *
+ * Backoff strategies:
+ *   linear       → 1s, 2s, 3s, ... (cap 30s)
+ *   exponential  → 1s, 2s, 4s, 8s, 16s (cap 30s)  [default]
+ *
+ * If the server returns a `Retry-After` header we always prefer it over our
+ * own backoff — the API explicitly told us when to come back.
+ *
+ * Circuit breaker:
+ *   Prevents hammering a consistently-failing endpoint. Tracks consecutive
+ *   failures; when `failureThreshold` is exceeded the circuit opens and
+ *   subsequent calls fail immediately (with CircuitOpenError). After
+ *   `resetTimeoutMs` the circuit enters half-open state: the next call is
+ *   allowed as a probe — success closes it, failure re-opens it.
+ */
+export type BackoffStrategy = 'linear' | 'exponential';
+/**
+ * Parse an HTTP `Retry-After` header. Supports both the seconds form
+ * ("Retry-After: 42") and the HTTP-date form ("Retry-After: Wed, 21 Oct
+ * 2015 07:28:00 GMT"). Returns the delay in ms, or undefined on garbage.
+ */
+export declare function parseRetryAfter(header: unknown, now?: number): number | undefined;
+/** Compute the next backoff delay (ms) for a given attempt index (0-based). */
+export declare function computeBackoff(attempt: number, strategy: BackoffStrategy): number;
+/** Resolve the delay to use before the next retry, preferring Retry-After. */
+export declare function nextRetryDelayMs(attempt: number, strategy: BackoffStrategy, retryAfterHeader: unknown, now?: number): number;
+export declare function sleep(ms: number): Promise<void>;
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerOptions {
+    /** Number of consecutive failures before the circuit opens. Default: 5. */
+    failureThreshold?: number;
+    /** Milliseconds to keep the circuit open before entering half-open. Default: 60_000. */
+    resetTimeoutMs?: number;
+}
+/**
+ * Thrown when a call is blocked because the circuit is open.
+ */
+export declare class CircuitOpenError extends Error {
+    readonly circuitName: string;
+    readonly nextAttemptMs: number;
+    constructor(circuitName: string, nextAttemptMs: number);
+}
+export declare class CircuitBreaker {
+    readonly name: string;
+    private state;
+    private failures;
+    private lastOpenedAt;
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    constructor(name: string, opts?: CircuitBreakerOptions);
+    getState(): CircuitState;
+    getStats(): {
+        state: CircuitState;
+        failures: number;
+        lastOpenedAt: number;
+        nextProbeMs: number;
+    };
+    /**
+     * Check if a call is allowed. Throws `CircuitOpenError` when the circuit
+     * is open and the reset timeout hasn't elapsed. Call `recordSuccess()` or
+     * `recordFailure()` after the operation completes.
+     */
+    checkAndAllow(): void;
+    recordSuccess(): void;
+    recordFailure(): void;
+    /** Reset to closed — useful for testing or manual recovery. */
+    reset(): void;
+    private _maybeHalfOpen;
+}

package/dist/utils/retry.js

@@ -0,0 +1,141 @@
+/**
+ * Retry/backoff helpers for the axios client. Kept as pure functions so
+ * tests can pin attempt → delay without wall-clock sleeping.
+ *
+ * Backoff strategies:
+ *   linear       → 1s, 2s, 3s, ... (cap 30s)
+ *   exponential  → 1s, 2s, 4s, 8s, 16s (cap 30s)  [default]
+ *
+ * If the server returns a `Retry-After` header we always prefer it over our
+ * own backoff — the API explicitly told us when to come back.
+ *
+ * Circuit breaker:
+ *   Prevents hammering a consistently-failing endpoint. Tracks consecutive
+ *   failures; when `failureThreshold` is exceeded the circuit opens and
+ *   subsequent calls fail immediately (with CircuitOpenError). After
+ *   `resetTimeoutMs` the circuit enters half-open state: the next call is
+ *   allowed as a probe — success closes it, failure re-opens it.
+ */
+const BASE_MS = 1_000;
+const MAX_MS = 30_000;
+/**
+ * Parse an HTTP `Retry-After` header. Supports both the seconds form
+ * ("Retry-After: 42") and the HTTP-date form ("Retry-After: Wed, 21 Oct
+ * 2015 07:28:00 GMT"). Returns the delay in ms, or undefined on garbage.
+ */
+export function parseRetryAfter(header, now = Date.now()) {
+    if (typeof header !== 'string')
+        return undefined;
+    const trimmed = header.trim();
+    if (!trimmed)
+        return undefined;
+    // All-digits → seconds.
+    if (/^\d+$/.test(trimmed)) {
+        const seconds = Number(trimmed);
+        if (!Number.isFinite(seconds) || seconds < 0)
+            return undefined;
+        return Math.min(seconds * 1000, MAX_MS);
+    }
+    // HTTP-date.
+    const ts = Date.parse(trimmed);
+    if (!Number.isFinite(ts))
+        return undefined;
+    const delta = ts - now;
+    if (delta <= 0)
+        return 0;
+    return Math.min(delta, MAX_MS);
+}
+/** Compute the next backoff delay (ms) for a given attempt index (0-based). */
+export function computeBackoff(attempt, strategy) {
+    const safe = Math.max(0, attempt);
+    if (strategy === 'linear') {
+        return Math.min((safe + 1) * BASE_MS, MAX_MS);
+    }
+    // exponential
+    return Math.min(BASE_MS * Math.pow(2, safe), MAX_MS);
+}
+/** Resolve the delay to use before the next retry, preferring Retry-After. */
+export function nextRetryDelayMs(attempt, strategy, retryAfterHeader, now = Date.now()) {
+    const fromHeader = parseRetryAfter(retryAfterHeader, now);
+    if (fromHeader !== undefined)
+        return fromHeader;
+    return computeBackoff(attempt, strategy);
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Thrown when a call is blocked because the circuit is open.
+ */
+export class CircuitOpenError extends Error {
+    circuitName;
+    nextAttemptMs;
+    constructor(circuitName, nextAttemptMs) {
+        super(`Circuit "${circuitName}" is open — too many recent failures. Next probe allowed in ${Math.ceil((nextAttemptMs - Date.now()) / 1000)}s.`);
+        this.circuitName = circuitName;
+        this.nextAttemptMs = nextAttemptMs;
+        this.name = 'CircuitOpenError';
+    }
+}
+export class CircuitBreaker {
+    name;
+    state = 'closed';
+    failures = 0;
+    lastOpenedAt = 0;
+    failureThreshold;
+    resetTimeoutMs;
+    constructor(name, opts = {}) {
+        this.name = name;
+        this.failureThreshold = opts.failureThreshold ?? 5;
+        this.resetTimeoutMs = opts.resetTimeoutMs ?? 60_000;
+    }
+    getState() {
+        this._maybeHalfOpen();
+        return this.state;
+    }
+    getStats() {
+        this._maybeHalfOpen();
+        return {
+            state: this.state,
+            failures: this.failures,
+            lastOpenedAt: this.lastOpenedAt,
+            nextProbeMs: this.state === 'open' ? this.lastOpenedAt + this.resetTimeoutMs : 0,
+        };
+    }
+    /**
+     * Check if a call is allowed. Throws `CircuitOpenError` when the circuit
+     * is open and the reset timeout hasn't elapsed. Call `recordSuccess()` or
+     * `recordFailure()` after the operation completes.
+     */
+    checkAndAllow() {
+        this._maybeHalfOpen();
+        if (this.state === 'open') {
+            throw new CircuitOpenError(this.name, this.lastOpenedAt + this.resetTimeoutMs);
+        }
+        // closed or half-open: allow the call
+    }
+    recordSuccess() {
+        this.failures = 0;
+        this.state = 'closed';
+    }
+    recordFailure() {
+        this.failures++;
+        if (this.state === 'half-open' || this.failures >= this.failureThreshold) {
+            this.state = 'open';
+            this.lastOpenedAt = Date.now();
+        }
+    }
+    /** Reset to closed — useful for testing or manual recovery. */
+    reset() {
+        this.state = 'closed';
+        this.failures = 0;
+        this.lastOpenedAt = 0;
+    }
+    _maybeHalfOpen() {
+        if (this.state === 'open' &&
+            Date.now() >= this.lastOpenedAt + this.resetTimeoutMs) {
+            this.state = 'half-open';
+        }
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/string.d.ts

@@ -0,0 +1,2 @@
+export declare function levenshtein(a: string, b: string): number;
+export declare function normalizeDeviceName(s: string): string;

package/dist/utils/string.js

@@ -0,0 +1,23 @@
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const row = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        let prev = i;
+        for (let j = 1; j <= b.length; j++) {
+            const val = a[i - 1] === b[j - 1] ? row[j - 1] : Math.min(row[j - 1], row[j], prev) + 1;
+            row[j - 1] = prev;
+            prev = val;
+        }
+        row[b.length] = prev;
+    }
+    return row[b.length];
+}
+export function normalizeDeviceName(s) {
+    return s.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff ]/g, ' ').replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=string.js.map

package/dist/utils/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/utils/string.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IAEpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACxF,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;YAClB,IAAI,GAAG,GAAG,CAAC;QACb,CAAC;QACD,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,CAAS;IAC3C,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9F,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+declare const VERSION: string;
+export { VERSION };

package/dist/version.js

@@ -0,0 +1,5 @@
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const { version: VERSION } = require('../package.json');
+export { VERSION };
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE/E,OAAO,EAAE,OAAO,EAAE,CAAC"}