homebridge-myleviton 3.0.0

package/dist/api/client.js

@@ -0,0 +1,358 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Leviton API HTTP client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LevitonApiClient = exports.DEFAULT_API_CONFIG = void 0;
+exports.getApiClient = getApiClient;
+exports.resetGlobalClient = resetGlobalClient;
+const errors_1 = require("../errors");
+const rate_limiter_1 = require("./rate-limiter");
+const circuit_breaker_1 = require("./circuit-breaker");
+const cache_1 = require("./cache");
+const request_queue_1 = require("./request-queue");
+const validators_1 = require("../utils/validators");
+const sanitizers_1 = require("../utils/sanitizers");
+/**
+ * Default API configuration
+ */
+exports.DEFAULT_API_CONFIG = {
+    baseUrl: 'https://my.leviton.com/api',
+    timeout: 10000,
+    useCache: true,
+    cacheTtl: 2000,
+};
+/**
+ * Default headers for API requests
+ */
+const DEFAULT_HEADERS = {
+    'Content-Type': 'application/json; charset=utf-8',
+};
+/**
+ * Convert object to URL query string
+ */
+function toQueryString(params) {
+    return Object.entries(params)
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+        .join('&');
+}
+/**
+ * Leviton API client
+ */
+class LevitonApiClient {
+    config;
+    rateLimiter;
+    circuitBreaker;
+    cache;
+    deduplicator;
+    constructor(config = {}) {
+        this.config = { ...exports.DEFAULT_API_CONFIG, ...config };
+        this.rateLimiter = (0, rate_limiter_1.getRateLimiter)();
+        this.circuitBreaker = (0, circuit_breaker_1.getCircuitBreaker)();
+        this.cache = (0, cache_1.getResponseCache)({ ttlMs: this.config.cacheTtl });
+        this.deduplicator = new request_queue_1.RequestDeduplicator();
+    }
+    /**
+     * Make an API request with all protections
+     */
+    async request(url, options = {}, requestOptions = {}) {
+        const { useCache = false, cacheKey = url, bypassCircuitBreaker: _bypassCircuitBreaker = false, debugLog = () => { }, priority: _priority = 'normal', } = requestOptions;
+        const method = options.method || 'GET';
+        const dedupeKey = `${method}:${url}`;
+        debugLog(`[API] ${method} ${url}`);
+        // Check cache first
+        if (useCache && method === 'GET') {
+            const cached = this.cache.get(cacheKey);
+            if (cached !== null) {
+                debugLog(`[API] Cache hit: ${cacheKey}`);
+                return cached;
+            }
+        }
+        // Deduplicate concurrent requests for same resource
+        if (useCache && method === 'GET') {
+            return this.deduplicator.execute(dedupeKey, () => this.executeRequest(url, options, requestOptions));
+        }
+        return this.executeRequest(url, options, requestOptions);
+    }
+    /**
+     * Execute the actual request
+     */
+    async executeRequest(url, options, requestOptions) {
+        const { useCache = false, cacheKey = url, bypassCircuitBreaker = false, debugLog = () => { }, } = requestOptions;
+        const method = options.method || 'GET';
+        // Check circuit breaker
+        if (!bypassCircuitBreaker && !this.circuitBreaker.canRequest()) {
+            const status = this.circuitBreaker.getStatus();
+            throw new errors_1.ApiResponseError(503, `Service unavailable (circuit breaker open). Retry in ${Math.ceil((status.remainingResetTime || 30000) / 1000)}s`);
+        }
+        // Rate limit write operations
+        if (method !== 'GET') {
+            if (!this.rateLimiter.tryAcquire()) {
+                throw new errors_1.ApiResponseError(429, 'Rate limit exceeded');
+            }
+        }
+        // Track half-open request
+        if (!bypassCircuitBreaker && this.circuitBreaker.state === circuit_breaker_1.CircuitState.HALF_OPEN) {
+            this.circuitBreaker.trackHalfOpenRequest();
+        }
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+                headers: {
+                    ...DEFAULT_HEADERS,
+                    ...options.headers,
+                },
+            });
+            clearTimeout(timeoutId);
+            // Get response text
+            const responseText = await response.text();
+            debugLog(`[API] Response: ${response.status} ${(0, sanitizers_1.createResponsePreview)(responseText, 100)}`);
+            // Handle non-OK responses
+            if (!response.ok) {
+                if (!bypassCircuitBreaker && response.status >= 500) {
+                    this.circuitBreaker.recordFailure();
+                }
+                throw (0, errors_1.createApiError)(response.status, response.statusText, responseText);
+            }
+            // Check content type
+            const contentType = response.headers.get('content-type') || '';
+            if (!contentType.includes('application/json') && !contentType.includes('text/json')) {
+                if (!bypassCircuitBreaker) {
+                    this.circuitBreaker.recordFailure();
+                }
+                throw new errors_1.ApiParseError(`Expected JSON response, got ${contentType}`, responseText);
+            }
+            // Parse JSON
+            if (!responseText || responseText.trim().length === 0) {
+                throw new errors_1.ApiParseError('Empty response body');
+            }
+            let data;
+            try {
+                data = JSON.parse(responseText);
+            }
+            catch (e) {
+                if (!bypassCircuitBreaker) {
+                    this.circuitBreaker.recordFailure();
+                }
+                throw new errors_1.ApiParseError(`Failed to parse JSON: ${e.message}`, responseText);
+            }
+            // Record success
+            if (!bypassCircuitBreaker) {
+                this.circuitBreaker.recordSuccess();
+            }
+            // Cache response
+            if (useCache && method === 'GET') {
+                this.cache.set(cacheKey, data);
+            }
+            return data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Handle abort/timeout
+            if (error.name === 'AbortError') {
+                if (!bypassCircuitBreaker) {
+                    this.circuitBreaker.recordFailure();
+                }
+                throw new errors_1.TimeoutError(this.config.timeout);
+            }
+            // Network errors
+            if (error instanceof TypeError ||
+                error.message?.includes('fetch')) {
+                if (!bypassCircuitBreaker) {
+                    this.circuitBreaker.recordFailure();
+                }
+                throw new errors_1.NetworkError(error.message, { cause: error });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Login and get authentication token
+     */
+    async login(email, password, debugLog) {
+        const validEmail = (0, validators_1.validateEmail)(email);
+        const validPassword = (0, validators_1.validatePassword)(password);
+        const query = toQueryString({ include: 'user' });
+        const url = `${this.config.baseUrl}/Person/login?${query}`;
+        debugLog?.(`[login] Authenticating ${validEmail}`);
+        const response = await this.request(url, {
+            method: 'POST',
+            body: JSON.stringify({ email: validEmail, password: validPassword }),
+        }, {
+            bypassCircuitBreaker: true, // Login bypasses circuit breaker
+            debugLog,
+        });
+        if (!response.id || !response.userId) {
+            throw new errors_1.AuthenticationError('Invalid login response: missing token or userId');
+        }
+        debugLog?.(`[login] Success, token: ${(0, sanitizers_1.maskToken)(response.id)}`);
+        return response;
+    }
+    /**
+     * Get residential permissions for a person
+     */
+    async getResidentialPermissions(personId, token, debugLog) {
+        const validPersonId = (0, validators_1.validateDeviceId)(personId);
+        const validToken = (0, validators_1.validateToken)(token);
+        const url = `${this.config.baseUrl}/Person/${validPersonId}/residentialPermissions`;
+        return this.request(url, {
+            method: 'GET',
+            headers: { Authorization: validToken },
+        }, { debugLog });
+    }
+    /**
+     * Get residential account details
+     */
+    async getResidentialAccount(accountId, token, debugLog) {
+        const validAccountId = (0, validators_1.validateDeviceId)(accountId);
+        const validToken = (0, validators_1.validateToken)(token);
+        const url = `${this.config.baseUrl}/ResidentialAccounts/${validAccountId}`;
+        return this.request(url, {
+            method: 'GET',
+            headers: { Authorization: validToken },
+        }, { debugLog });
+    }
+    /**
+     * Get residences using v2 API
+     */
+    async getResidences(residenceObjectId, token, debugLog) {
+        const validId = (0, validators_1.validateDeviceId)(residenceObjectId);
+        const validToken = (0, validators_1.validateToken)(token);
+        const url = `${this.config.baseUrl}/ResidentialAccounts/${validId}/residences`;
+        return this.request(url, {
+            method: 'GET',
+            headers: { Authorization: validToken },
+        }, { debugLog });
+    }
+    /**
+     * Get IoT switches for a residence
+     */
+    async getDevices(residenceId, token, debugLog) {
+        const validResidenceId = (0, validators_1.validateDeviceId)(residenceId);
+        const validToken = (0, validators_1.validateToken)(token);
+        const url = `${this.config.baseUrl}/Residences/${validResidenceId}/iotSwitches`;
+        return this.request(url, {
+            method: 'GET',
+            headers: { Authorization: validToken },
+        }, { debugLog });
+    }
+    /**
+     * Get status of a specific device
+     */
+    async getDeviceStatus(deviceId, token, debugLog) {
+        const validDeviceId = (0, validators_1.validateDeviceId)(deviceId);
+        const validToken = (0, validators_1.validateToken)(token);
+        const url = `${this.config.baseUrl}/IotSwitches/${validDeviceId}`;
+        const cacheKey = `device:${validDeviceId}`;
+        return this.request(url, {
+            method: 'GET',
+            headers: { Authorization: validToken },
+        }, {
+            useCache: true,
+            cacheKey,
+            debugLog,
+        });
+    }
+    /**
+     * Update device state
+     */
+    async setDeviceState(deviceId, token, state, debugLog) {
+        const validDeviceId = (0, validators_1.validateDeviceId)(deviceId);
+        const validToken = (0, validators_1.validateToken)(token);
+        // Validate state
+        const body = {};
+        if (state.power !== undefined) {
+            body.power = (0, validators_1.validatePowerState)(state.power);
+        }
+        if (state.brightness !== undefined) {
+            body.brightness = (0, validators_1.validateBrightness)(state.brightness);
+        }
+        if (Object.keys(body).length === 0) {
+            throw new errors_1.ValidationError('state', 'At least one of power or brightness must be provided');
+        }
+        const url = `${this.config.baseUrl}/IotSwitches/${validDeviceId}`;
+        const cacheKey = `device:${validDeviceId}`;
+        const result = await this.request(url, {
+            method: 'PUT',
+            body: JSON.stringify(body),
+            headers: { Authorization: validToken },
+        }, { debugLog });
+        // Invalidate cache after successful update
+        this.cache.delete(cacheKey);
+        return result;
+    }
+    /**
+     * Set device power
+     */
+    async setPower(deviceId, token, power, debugLog) {
+        return this.setDeviceState(deviceId, token, { power: power ? 'ON' : 'OFF' }, debugLog);
+    }
+    /**
+     * Set device brightness
+     */
+    async setBrightness(deviceId, token, brightness, debugLog) {
+        return this.setDeviceState(deviceId, token, { brightness }, debugLog);
+    }
+    /**
+     * Clear response cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Invalidate cache for a specific device
+     */
+    invalidateDeviceCache(deviceId) {
+        this.cache.delete(`device:${deviceId}`);
+    }
+    /**
+     * Get client status
+     */
+    getStatus() {
+        return {
+            circuitBreaker: this.circuitBreaker.getStatus(),
+            rateLimiter: this.rateLimiter.getStatus(),
+            cache: this.cache.getStats(),
+        };
+    }
+    /**
+     * Reset all client state (for testing)
+     */
+    reset() {
+        this.cache.clear();
+        this.circuitBreaker.reset();
+        this.rateLimiter.reset();
+        this.deduplicator.clear();
+    }
+}
+exports.LevitonApiClient = LevitonApiClient;
+/**
+ * Global API client instance
+ */
+let globalClient = null;
+/**
+ * Get or create the global API client
+ */
+function getApiClient(config) {
+    if (!globalClient) {
+        globalClient = new LevitonApiClient(config);
+    }
+    return globalClient;
+}
+/**
+ * Reset the global client (for testing)
+ */
+function resetGlobalClient() {
+    globalClient?.reset();
+    globalClient = null;
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview API module exports
+ */
+export { LevitonApiClient, getApiClient, resetGlobalClient } from './client';
+export type { ApiClientConfig } from './client';
+export { RateLimiter, getRateLimiter, resetGlobalRateLimiter } from './rate-limiter';
+export type { RateLimiterConfig } from './rate-limiter';
+export { CircuitBreaker, getCircuitBreaker, resetGlobalCircuitBreaker, CircuitState } from './circuit-breaker';
+export type { CircuitBreakerConfig, CircuitBreakerStatus } from './circuit-breaker';
+export { ResponseCache, getResponseCache, resetGlobalCache } from './cache';
+export type { CacheConfig } from './cache';
+export { RequestQueue, RequestDeduplicator } from './request-queue';
+export type { RequestQueueConfig } from './request-queue';
+export { DevicePersistence, getDevicePersistence, resetGlobalPersistence, PERSISTENCE_FILE_NAME } from './persistence';
+export type { PersistenceConfig } from './persistence';
+export { LevitonWebSocket, createWebSocket } from './websocket';
+export type { WebSocketConfig } from './websocket';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG/C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACpF,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC9G,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAGnF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC3E,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGzD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACtH,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGtD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/api/index.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview API module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSocket = exports.LevitonWebSocket = exports.PERSISTENCE_FILE_NAME = exports.resetGlobalPersistence = exports.getDevicePersistence = exports.DevicePersistence = exports.RequestDeduplicator = exports.RequestQueue = exports.resetGlobalCache = exports.getResponseCache = exports.ResponseCache = exports.CircuitState = exports.resetGlobalCircuitBreaker = exports.getCircuitBreaker = exports.CircuitBreaker = exports.resetGlobalRateLimiter = exports.getRateLimiter = exports.RateLimiter = exports.resetGlobalClient = exports.getApiClient = exports.LevitonApiClient = void 0;
+// Client
+var client_1 = require("./client");
+Object.defineProperty(exports, "LevitonApiClient", { enumerable: true, get: function () { return client_1.LevitonApiClient; } });
+Object.defineProperty(exports, "getApiClient", { enumerable: true, get: function () { return client_1.getApiClient; } });
+Object.defineProperty(exports, "resetGlobalClient", { enumerable: true, get: function () { return client_1.resetGlobalClient; } });
+// Rate Limiter
+var rate_limiter_1 = require("./rate-limiter");
+Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return rate_limiter_1.RateLimiter; } });
+Object.defineProperty(exports, "getRateLimiter", { enumerable: true, get: function () { return rate_limiter_1.getRateLimiter; } });
+Object.defineProperty(exports, "resetGlobalRateLimiter", { enumerable: true, get: function () { return rate_limiter_1.resetGlobalRateLimiter; } });
+// Circuit Breaker
+var circuit_breaker_1 = require("./circuit-breaker");
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.CircuitBreaker; } });
+Object.defineProperty(exports, "getCircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.getCircuitBreaker; } });
+Object.defineProperty(exports, "resetGlobalCircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.resetGlobalCircuitBreaker; } });
+Object.defineProperty(exports, "CircuitState", { enumerable: true, get: function () { return circuit_breaker_1.CircuitState; } });
+// Cache
+var cache_1 = require("./cache");
+Object.defineProperty(exports, "ResponseCache", { enumerable: true, get: function () { return cache_1.ResponseCache; } });
+Object.defineProperty(exports, "getResponseCache", { enumerable: true, get: function () { return cache_1.getResponseCache; } });
+Object.defineProperty(exports, "resetGlobalCache", { enumerable: true, get: function () { return cache_1.resetGlobalCache; } });
+// Request Queue
+var request_queue_1 = require("./request-queue");
+Object.defineProperty(exports, "RequestQueue", { enumerable: true, get: function () { return request_queue_1.RequestQueue; } });
+Object.defineProperty(exports, "RequestDeduplicator", { enumerable: true, get: function () { return request_queue_1.RequestDeduplicator; } });
+// Persistence
+var persistence_1 = require("./persistence");
+Object.defineProperty(exports, "DevicePersistence", { enumerable: true, get: function () { return persistence_1.DevicePersistence; } });
+Object.defineProperty(exports, "getDevicePersistence", { enumerable: true, get: function () { return persistence_1.getDevicePersistence; } });
+Object.defineProperty(exports, "resetGlobalPersistence", { enumerable: true, get: function () { return persistence_1.resetGlobalPersistence; } });
+Object.defineProperty(exports, "PERSISTENCE_FILE_NAME", { enumerable: true, get: function () { return persistence_1.PERSISTENCE_FILE_NAME; } });
+// WebSocket
+var websocket_1 = require("./websocket");
+Object.defineProperty(exports, "LevitonWebSocket", { enumerable: true, get: function () { return websocket_1.LevitonWebSocket; } });
+Object.defineProperty(exports, "createWebSocket", { enumerable: true, get: function () { return websocket_1.createWebSocket; } });
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,SAAS;AACT,mCAA4E;AAAnE,0GAAA,gBAAgB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAG1D,eAAe;AACf,+CAAoF;AAA3E,2GAAA,WAAW,OAAA;AAAE,8GAAA,cAAc,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AAG5D,kBAAkB;AAClB,qDAA8G;AAArG,iHAAA,cAAc,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAAE,4HAAA,yBAAyB,OAAA;AAAE,+GAAA,YAAY,OAAA;AAGnF,QAAQ;AACR,iCAA2E;AAAlE,sGAAA,aAAa,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAG1D,gBAAgB;AAChB,iDAAmE;AAA1D,6GAAA,YAAY,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAG1C,cAAc;AACd,6CAAsH;AAA7G,gHAAA,iBAAiB,OAAA;AAAE,mHAAA,oBAAoB,OAAA;AAAE,qHAAA,sBAAsB,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AAG/F,YAAY;AACZ,yCAA+D;AAAtD,6GAAA,gBAAgB,OAAA;AAAE,4GAAA,eAAe,OAAA"}

package/dist/api/persistence.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Device state persistence for faster startup and offline resilience
+ */
+import type { PersistedDeviceState, DeviceStatus } from '../types';
+/**
+ * Persistence configuration
+ */
+export interface PersistenceConfig {
+    /** Storage file path */
+    storagePath: string;
+    /** Maximum age of cached data in ms */
+    maxAge: number;
+    /** Maximum number of devices to persist */
+    maxDevices: number;
+}
+/**
+ * Default persistence configuration
+ */
+export declare const DEFAULT_PERSISTENCE_CONFIG: Partial<PersistenceConfig>;
+/**
+ * Default persistence file name
+ */
+export declare const PERSISTENCE_FILE_NAME = ".homebridge-myleviton-state.json";
+/**
+ * Device state persistence manager
+ * Stores device states for faster startup and offline resilience
+ */
+export declare class DevicePersistence {
+    private readonly storagePath;
+    private readonly maxAge;
+    private readonly maxDevices;
+    private deviceStates;
+    private loaded;
+    private dirty;
+    constructor(storagePath?: string, config?: Partial<PersistenceConfig>);
+    /**
+     * Load persisted device states from disk
+     */
+    load(): Map<string, PersistedDeviceState>;
+    /**
+     * Save device states to disk
+     */
+    save(): boolean;
+    /**
+     * Update state for a device
+     */
+    updateDevice(deviceId: string, state: Partial<PersistedDeviceState>): void;
+    /**
+     * Update device from API status
+     */
+    updateFromStatus(deviceId: string, status: DeviceStatus): void;
+    /**
+     * Get cached state for a device
+     */
+    getDevice(deviceId: string): PersistedDeviceState | null;
+    /**
+     * Check if device has fresh cached data
+     */
+    hasFreshCache(deviceId: string, maxAge?: number): boolean;
+    /**
+     * Get device status from cache (for fallback)
+     */
+    getCachedStatus(deviceId: string): DeviceStatus | null;
+    /**
+     * Remove a device from persistence
+     */
+    removeDevice(deviceId: string): boolean;
+    /**
+     * Clear all persisted states
+     */
+    clear(): void;
+    /**
+     * Get all cached device states
+     */
+    getAllDevices(): Map<string, PersistedDeviceState>;
+    /**
+     * Get device count
+     */
+    get size(): number;
+    /**
+     * Check if persistence has been modified
+     */
+    get isDirty(): boolean;
+    /**
+     * Get persistence statistics
+     */
+    getStats(): {
+        deviceCount: number;
+        loaded: boolean;
+        dirty: boolean;
+        storagePath: string;
+    };
+}
+/**
+ * Get or create the global persistence instance
+ */
+export declare function getDevicePersistence(storagePath?: string): DevicePersistence;
+/**
+ * Reset the global persistence (for testing)
+ */
+export declare function resetGlobalPersistence(): void;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/api/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/api/persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,YAAY,EAAE,MAAM,UAAU,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAAC,iBAAiB,CAGjE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,qCAAqC,CAAA;AAEvE;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAEnC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAQ;gBAET,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAUzE;;OAEG;IACH,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAuCzC;;OAEG;IACH,IAAI,IAAI,OAAO;IAqCf;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAgB1E;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAO9D;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAKxD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,OAAO;IAQ9D;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAWtD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAab;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAKlD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,OAAO,CAAA;QACf,KAAK,EAAE,OAAO,CAAA;QACd,WAAW,EAAE,MAAM,CAAA;KACpB;CAQF;AAOD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAK5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}