node-switchbot 4.0.0-beta.1 → 4.0.0-beta.11

package/dist/utils/circuit-breaker.js

@@ -0,0 +1,187 @@
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * utils/circuit-breaker.ts: SwitchBot v4.0.0 - Circuit Breaker Pattern
+ */
+import { Logger } from './index.js';
+/**
+ * Circuit breaker states
+ */
+export var CircuitBreakerState;
+(function (CircuitBreakerState) {
+    CircuitBreakerState["CLOSED"] = "CLOSED";
+    CircuitBreakerState["OPEN"] = "OPEN";
+    CircuitBreakerState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitBreakerState || (CircuitBreakerState = {}));
+/**
+ * Circuit breaker for managing connection reliability
+ */
+export class CircuitBreaker {
+    name;
+    state = CircuitBreakerState.CLOSED;
+    successCount = 0;
+    failureCount = 0;
+    halfOpenAttempts = 0;
+    lastFailureTime;
+    lastRecoveryTime;
+    resetTimer;
+    logger;
+    config;
+    constructor(name, config = {}, logLevel) {
+        this.name = name;
+        this.config = {
+            failureThreshold: config.failureThreshold ?? 0.5,
+            minRequests: config.minRequests ?? 5,
+            resetTimeoutMs: config.resetTimeoutMs ?? 30000,
+            maxHalfOpenRequests: config.maxHalfOpenRequests ?? 1,
+        };
+        this.logger = new Logger(`CircuitBreaker:${name}`, logLevel);
+    }
+    /**
+     * Record a successful operation
+     */
+    recordSuccess() {
+        this.successCount++;
+        if (this.state === CircuitBreakerState.HALF_OPEN) {
+            // Successful in Half-Open -> recover
+            this.logger.info(`${this.name}: circuit recovered (HALF_OPEN -> CLOSED)`);
+            this.transitionToClosed();
+        }
+    }
+    /**
+     * Record a failed operation
+     */
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureTime = new Date();
+        if (this.state === CircuitBreakerState.CLOSED) {
+            // Check if we should open the circuit
+            if (this.shouldOpen()) {
+                this.logger.warn(`${this.name}: circuit opened - failure rate ${this.getFailureRate().toFixed(2)}`);
+                this.transitionToOpen();
+            }
+        }
+        else if (this.state === CircuitBreakerState.HALF_OPEN) {
+            // Failed during recovery -> reopen
+            this.logger.warn(`${this.name}: circuit reopened (HALF_OPEN -> OPEN)`);
+            this.transitionToOpen();
+        }
+    }
+    /**
+     * Check if circuit should open based on failure rate
+     */
+    shouldOpen() {
+        const totalRequests = this.successCount + this.failureCount;
+        if (totalRequests < this.config.minRequests) {
+            return false;
+        }
+        const failureRate = this.failureCount / totalRequests;
+        return failureRate >= this.config.failureThreshold;
+    }
+    /**
+     * Transition to CLOSED state (recovered)
+     */
+    transitionToClosed() {
+        this.state = CircuitBreakerState.CLOSED;
+        this.successCount = 0;
+        this.failureCount = 0;
+        this.halfOpenAttempts = 0;
+        this.lastRecoveryTime = new Date();
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = undefined;
+        }
+    }
+    /**
+     * Transition to OPEN state (failing)
+     */
+    transitionToOpen() {
+        this.state = CircuitBreakerState.OPEN;
+        this.successCount = 0;
+        this.failureCount = 0;
+        this.halfOpenAttempts = 0;
+        // Schedule recovery attempt
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+        }
+        this.resetTimer = setTimeout(() => {
+            this.logger.info(`${this.name}: attempting recovery (OPEN -> HALF_OPEN)`);
+            this.state = CircuitBreakerState.HALF_OPEN;
+            this.halfOpenAttempts = 0;
+        }, this.config.resetTimeoutMs);
+    }
+    /**
+     * Check if the circuit allows operations
+     */
+    canExecute() {
+        if (this.state === CircuitBreakerState.CLOSED) {
+            return true;
+        }
+        if (this.state === CircuitBreakerState.HALF_OPEN) {
+            return this.halfOpenAttempts < this.config.maxHalfOpenRequests;
+        }
+        // OPEN state
+        return false;
+    }
+    /**
+     * Mark that we tried to execute in half-open state
+     */
+    markHalfOpenAttempt() {
+        if (this.state === CircuitBreakerState.HALF_OPEN) {
+            this.halfOpenAttempts++;
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get current failure rate (0-1)
+     */
+    getFailureRate() {
+        const total = this.successCount + this.failureCount;
+        return total === 0 ? 0 : this.failureCount / total;
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        const totalRequests = this.successCount + this.failureCount;
+        return {
+            state: this.state,
+            successCount: this.successCount,
+            failureCount: this.failureCount,
+            successRate: totalRequests === 0 ? 1 : this.successCount / totalRequests,
+            totalRequests,
+            lastFailureTime: this.lastFailureTime,
+            lastRecoveryTime: this.lastRecoveryTime,
+        };
+    }
+    /**
+     * Reset circuit breaker (for testing)
+     */
+    reset() {
+        this.logger.debug(`${this.name}: reset`);
+        this.state = CircuitBreakerState.CLOSED;
+        this.successCount = 0;
+        this.failureCount = 0;
+        this.halfOpenAttempts = 0;
+        this.lastFailureTime = undefined;
+        this.lastRecoveryTime = undefined;
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = undefined;
+        }
+    }
+    /**
+     * Cleanup
+     */
+    cleanup() {
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/utils/circuit-breaker.js.map

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

package/dist/utils/connection-tracker.d.ts

@@ -0,0 +1,66 @@
+import type { ConnectionType } from '../types/index.js';
+/**
+ * Statistics for a single connection type
+ */
+export interface ConnectionStats {
+    connectionType: ConnectionType;
+    successCount: number;
+    failureCount: number;
+    totalAttempts: number;
+    successRate: number;
+    averageLatencyMs: number;
+    lastAttemptTime?: Date;
+    lastSuccessTime?: Date;
+    lastFailureTime?: Date;
+}
+/**
+ * Tracks connection success/failure statistics per device per connection type
+ */
+export declare class ConnectionTracker {
+    private deviceId;
+    private stats;
+    private logger;
+    constructor(deviceId: string, logLevel?: number);
+    /**
+     * Record a successful attempt
+     */
+    recordSuccess(connectionType: ConnectionType, latencyMs?: number): void;
+    /**
+     * Record a failed attempt
+     */
+    recordFailure(connectionType: ConnectionType): void;
+    /**
+     * Get statistics for a connection type
+     */
+    getStats(connectionType: ConnectionType): ConnectionStats | undefined;
+    /**
+     * Get all statistics
+     */
+    getAllStats(): ConnectionStats[];
+    /**
+     * Get the best connection type (highest success rate)
+     */
+    getBestConnection(availableTypes?: ConnectionType[]): ConnectionType | undefined;
+    /**
+     * Get the most recent successful connection type
+     */
+    getMostRecentSuccessful(availableTypes?: ConnectionType[]): ConnectionType | undefined;
+    /**
+     * Check if a connection type is considered reliable
+     * (e.g., success rate > 75% with at least 5 attempts)
+     */
+    isReliable(connectionType: ConnectionType, minAttempts?: number, minRate?: number): boolean;
+    /**
+     * Get connection recommendation with reasoning
+     */
+    getRecommendation(availableTypes?: ConnectionType[]): {
+        recommended: ConnectionType | undefined;
+        reason: string;
+        stats: ConnectionStats[];
+    };
+    /**
+     * Reset all statistics
+     */
+    reset(): void;
+}
+//# sourceMappingURL=connection-tracker.d.ts.map

package/dist/utils/connection-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/connection-tracker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,cAAc,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,IAAI,CAAA;IACtB,eAAe,CAAC,EAAE,IAAI,CAAA;IACtB,eAAe,CAAC,EAAE,IAAI,CAAA;CACvB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,KAAK,CAAkD;IAC/D,OAAO,CAAC,MAAM,CAAQ;gBAGZ,QAAQ,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,MAAM;IAqBnB;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,cAAc,EAAE,SAAS,GAAE,MAAU,GAAG,IAAI;IAwB1E;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAmBnD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,eAAe,GAAG,SAAS;IAIrE;;OAEG;IACH,WAAW,IAAI,eAAe,EAAE;IAIhC;;OAEG;IACH,iBAAiB,CAAC,cAAc,GAAE,cAAc,EAAmB,GAAG,cAAc,GAAG,SAAS;IAsBhG;;OAEG;IACH,uBAAuB,CAAC,cAAc,GAAE,cAAc,EAAmB,GAAG,cAAc,GAAG,SAAS;IAiBtG;;;OAGG;IACH,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,WAAW,GAAE,MAAU,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO;IASpG;;OAEG;IACH,iBAAiB,CAAC,cAAc,GAAE,cAAc,EAAmB,GAAG;QACpE,WAAW,EAAE,cAAc,GAAG,SAAS,CAAA;QACvC,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,eAAe,EAAE,CAAA;KACzB;IAsCD;;OAEG;IACH,KAAK,IAAI,IAAI;CAad"}

package/dist/utils/connection-tracker.js

@@ -0,0 +1,184 @@
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * utils/connection-tracker.ts: SwitchBot v4.0.0 - Connection Success Tracking
+ */
+import { Logger } from './index.js';
+/**
+ * Tracks connection success/failure statistics per device per connection type
+ */
+export class ConnectionTracker {
+    deviceId;
+    stats = new Map();
+    logger;
+    constructor(deviceId, logLevel) {
+        this.deviceId = deviceId;
+        this.logger = new Logger(`ConnectionTracker:${deviceId}`, logLevel);
+        // Initialize stats for all connection types
+        const connectionTypes = ['ble', 'api'];
+        for (const type of connectionTypes) {
+            this.stats.set(type, {
+                connectionType: type,
+                successCount: 0,
+                failureCount: 0,
+                totalAttempts: 0,
+                successRate: 1, // Start optimistic
+                averageLatencyMs: 0,
+                lastAttemptTime: undefined,
+                lastSuccessTime: undefined,
+                lastFailureTime: undefined,
+            });
+        }
+    }
+    /**
+     * Record a successful attempt
+     */
+    recordSuccess(connectionType, latencyMs = 0) {
+        const stat = this.stats.get(connectionType);
+        if (!stat) {
+            return;
+        }
+        stat.successCount++;
+        stat.totalAttempts++;
+        stat.lastAttemptTime = new Date();
+        stat.lastSuccessTime = new Date();
+        // Update average latency (exponential moving average)
+        const alpha = 0.3;
+        stat.averageLatencyMs = stat.averageLatencyMs * (1 - alpha) + latencyMs * alpha;
+        // Update success rate
+        stat.successRate = stat.totalAttempts === 0 ? 1 : stat.successCount / stat.totalAttempts;
+        this.logger.debug(`${connectionType}: success recorded`, {
+            successRate: stat.successRate.toFixed(2),
+            latency: latencyMs,
+        });
+    }
+    /**
+     * Record a failed attempt
+     */
+    recordFailure(connectionType) {
+        const stat = this.stats.get(connectionType);
+        if (!stat) {
+            return;
+        }
+        stat.failureCount++;
+        stat.totalAttempts++;
+        stat.lastAttemptTime = new Date();
+        stat.lastFailureTime = new Date();
+        // Update success rate
+        stat.successRate = stat.totalAttempts === 0 ? 1 : stat.successCount / stat.totalAttempts;
+        this.logger.debug(`${connectionType}: failure recorded`, {
+            successRate: stat.successRate.toFixed(2),
+        });
+    }
+    /**
+     * Get statistics for a connection type
+     */
+    getStats(connectionType) {
+        return this.stats.get(connectionType);
+    }
+    /**
+     * Get all statistics
+     */
+    getAllStats() {
+        return [...this.stats.values()];
+    }
+    /**
+     * Get the best connection type (highest success rate)
+     */
+    getBestConnection(availableTypes = ['ble', 'api']) {
+        let bestType;
+        let bestRate = -1;
+        for (const type of availableTypes) {
+            const stat = this.stats.get(type);
+            if (stat && stat.successRate > bestRate) {
+                bestRate = stat.successRate;
+                bestType = type;
+            }
+        }
+        if (bestType) {
+            const stat = this.stats.get(bestType);
+            if (stat.totalAttempts > 0) {
+                this.logger.debug(`Best connection: ${bestType} (success rate: ${stat.successRate.toFixed(2)})`);
+            }
+        }
+        return bestType;
+    }
+    /**
+     * Get the most recent successful connection type
+     */
+    getMostRecentSuccessful(availableTypes = ['ble', 'api']) {
+        let mostRecentType;
+        let mostRecentTime;
+        for (const type of availableTypes) {
+            const stat = this.stats.get(type);
+            if (stat?.lastSuccessTime) {
+                if (!mostRecentTime || stat.lastSuccessTime > mostRecentTime) {
+                    mostRecentTime = stat.lastSuccessTime;
+                    mostRecentType = type;
+                }
+            }
+        }
+        return mostRecentType;
+    }
+    /**
+     * Check if a connection type is considered reliable
+     * (e.g., success rate > 75% with at least 5 attempts)
+     */
+    isReliable(connectionType, minAttempts = 5, minRate = 0.75) {
+        const stat = this.stats.get(connectionType);
+        if (!stat) {
+            return false;
+        }
+        return stat.totalAttempts >= minAttempts && stat.successRate >= minRate;
+    }
+    /**
+     * Get connection recommendation with reasoning
+     */
+    getRecommendation(availableTypes = ['ble', 'api']) {
+        const stats = availableTypes.map(type => this.stats.get(type)).filter(Boolean);
+        // If no attempt history, recommend first available
+        if (stats.every(s => s.totalAttempts === 0)) {
+            return {
+                recommended: availableTypes[0],
+                reason: 'No history, using first available connection',
+                stats,
+            };
+        }
+        // Find most reliable based on success rate
+        const bestType = this.getBestConnection(availableTypes);
+        if (!bestType) {
+            return {
+                recommended: undefined,
+                reason: 'No available connections',
+                stats,
+            };
+        }
+        const bestStat = this.stats.get(bestType);
+        let reason = `${bestType} has best success rate (${bestStat.successRate.toFixed(2)})`;
+        // Add context about latency if applicable
+        if (bestStat.averageLatencyMs > 0) {
+            reason += ` with avg latency ${bestStat.averageLatencyMs.toFixed(0)}ms`;
+        }
+        return {
+            recommended: bestType,
+            reason,
+            stats,
+        };
+    }
+    /**
+     * Reset all statistics
+     */
+    reset() {
+        this.logger.debug('Resetting all statistics');
+        for (const stat of this.stats.values()) {
+            stat.successCount = 0;
+            stat.failureCount = 0;
+            stat.totalAttempts = 0;
+            stat.successRate = 1;
+            stat.averageLatencyMs = 0;
+            stat.lastAttemptTime = undefined;
+            stat.lastSuccessTime = undefined;
+            stat.lastFailureTime = undefined;
+        }
+    }
+}
+//# sourceMappingURL=connection-tracker.js.map

package/dist/utils/connection-tracker.js.map

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

package/dist/utils/fallback-handler.d.ts

@@ -0,0 +1,68 @@
+import type { ConnectionType } from '../types/index.js';
+/**
+ * Information about a fallback event
+ */
+export interface FallbackEvent {
+    deviceId: string;
+    primaryConnection: ConnectionType;
+    fallbackConnection: ConnectionType | undefined;
+    reason: string;
+    timestamp: Date;
+    attemptsCount?: number;
+    totalTimeMs?: number;
+}
+/**
+ * Type for custom fallback handler callbacks
+ */
+export type FallbackHandler = (event: FallbackEvent) => void | Promise<void>;
+/**
+ * Options for registering a fallback handler
+ */
+export interface FallbackHandlerOptions {
+    /** Handler identifier for later removal */
+    id?: string;
+    /** Handler priority (higher = executes first) */
+    priority?: number;
+}
+/**
+ * Manages custom fallback handlers and events
+ */
+export declare class FallbackHandlerManager {
+    private handlers;
+    private logger;
+    private handlerCounter;
+    constructor(logLevel?: number);
+    /**
+     * Register a custom fallback handler
+     */
+    register(handler: FallbackHandler, options?: FallbackHandlerOptions): string;
+    /**
+     * Unregister a fallback handler
+     */
+    unregister(id: string): boolean;
+    /**
+     * Emit a fallback event to all registered handlers
+     */
+    emit(event: FallbackEvent): Promise<void>;
+    /**
+     * Clear all handlers
+     */
+    clear(): void;
+    /**
+     * Get handler count
+     */
+    getHandlerCount(): number;
+}
+/**
+ * Built-in fallback handler: Log fallback events
+ */
+export declare function createLoggingFallbackHandler(logLevel?: number): FallbackHandler;
+/**
+ * Built-in fallback handler: Metrics/statistics collection
+ */
+export declare function createMetricsCollectionHandler(): FallbackHandler;
+/**
+ * Built-in fallback handler: Alert on repeated fallbacks
+ */
+export declare function createAlertHandler(alertThreshold?: number): FallbackHandler;
+//# sourceMappingURL=fallback-handler.d.ts.map

package/dist/utils/fallback-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-handler.d.ts","sourceRoot":"","sources":["../../src/utils/fallback-handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIvD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,cAAc,CAAA;IACjC,kBAAkB,EAAE,cAAc,GAAG,SAAS,CAAA;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,IAAI,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAGH;IAEb,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,cAAc,CAAI;gBAEd,QAAQ,CAAC,EAAE,MAAM;IAI7B;;OAEG;IACH,QAAQ,CACN,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,sBAA2B,GACnC,MAAM;IAUT;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ/B;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB/C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,GAAE,MAAU,GAAG,eAAe,CAmBlF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,eAAe,CA+BhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,GAAE,MAAU,GAAG,eAAe,CAkB9E"}

package/dist/utils/fallback-handler.js

@@ -0,0 +1,131 @@
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * utils/fallback-handler.ts: SwitchBot v4.0.0 - Custom Fallback Handlers
+ */
+import { Logger } from './index.js';
+/**
+ * Manages custom fallback handlers and events
+ */
+export class FallbackHandlerManager {
+    handlers = new Map();
+    logger;
+    handlerCounter = 0;
+    constructor(logLevel) {
+        this.logger = new Logger('FallbackHandlerManager', logLevel);
+    }
+    /**
+     * Register a custom fallback handler
+     */
+    register(handler, options = {}) {
+        const id = options.id || `handler_${++this.handlerCounter}`;
+        const priority = options.priority ?? 0;
+        this.handlers.set(id, { handler, priority });
+        this.logger.debug(`Registered fallback handler: ${id} (priority: ${priority})`);
+        return id;
+    }
+    /**
+     * Unregister a fallback handler
+     */
+    unregister(id) {
+        const removed = this.handlers.delete(id);
+        if (removed) {
+            this.logger.debug(`Unregistered fallback handler: ${id}`);
+        }
+        return removed;
+    }
+    /**
+     * Emit a fallback event to all registered handlers
+     */
+    async emit(event) {
+        // Sort handlers by priority (descending)
+        // eslint-disable-next-line e18e/prefer-array-to-sorted
+        const sortedHandlers = [...this.handlers.entries()].sort((a, b) => b[1].priority - a[1].priority);
+        this.logger.debug(`Emitting fallback event to ${sortedHandlers.length} handlers`, {
+            device: event.deviceId,
+            primary: event.primaryConnection,
+            fallback: event.fallbackConnection,
+        });
+        for (const [id, { handler }] of sortedHandlers) {
+            try {
+                await Promise.resolve(handler(event));
+            }
+            catch (error) {
+                this.logger.error(`Fallback handler ${id} threw error`, error);
+                // Continue with other handlers even if one fails
+            }
+        }
+    }
+    /**
+     * Clear all handlers
+     */
+    clear() {
+        this.logger.debug(`Clearing ${this.handlers.size} fallback handlers`);
+        this.handlers.clear();
+    }
+    /**
+     * Get handler count
+     */
+    getHandlerCount() {
+        return this.handlers.size;
+    }
+}
+/**
+ * Built-in fallback handler: Log fallback events
+ */
+export function createLoggingFallbackHandler(logLevel = 3) {
+    const logger = new Logger('FallbackLogger', logLevel);
+    return (event) => {
+        if (!event.fallbackConnection) {
+            logger.error(`Device ${event.deviceId}: ${event.primaryConnection} failed and no fallback available`);
+        }
+        else {
+            logger.warn(`Device ${event.deviceId}: ${event.primaryConnection} failed, falling back to ${event.fallbackConnection}`, {
+                reason: event.reason,
+                attempts: event.attemptsCount,
+                timeMs: event.totalTimeMs,
+            });
+        }
+    };
+}
+/**
+ * Built-in fallback handler: Metrics/statistics collection
+ */
+export function createMetricsCollectionHandler() {
+    const metrics = {
+        totalFallbacks: 0,
+        fallbacksByDevice: new Map(),
+        fallbacksByConnection: new Map(),
+        lastFallbackTime: undefined,
+    };
+    const handler = (event) => {
+        metrics.totalFallbacks++;
+        metrics.lastFallbackTime = event.timestamp;
+        const deviceCount = metrics.fallbacksByDevice.get(event.deviceId) || 0;
+        metrics.fallbacksByDevice.set(event.deviceId, deviceCount + 1);
+        if (event.fallbackConnection) {
+            const connectionKey = `${event.primaryConnection}->${event.fallbackConnection}`;
+            const count = metrics.fallbacksByConnection.get(connectionKey) || 0;
+            metrics.fallbacksByConnection.set(connectionKey, count + 1);
+        }
+    };
+    handler.getMetrics = () => ({ ...metrics });
+    return handler;
+}
+/**
+ * Built-in fallback handler: Alert on repeated fallbacks
+ */
+export function createAlertHandler(alertThreshold = 3) {
+    const fallbackCounts = new Map();
+    const logger = new Logger('FallbackAlertHandler');
+    return (event) => {
+        const count = (fallbackCounts.get(event.deviceId) || 0) + 1;
+        fallbackCounts.set(event.deviceId, count);
+        if (count === alertThreshold) {
+            logger.error(`ALERT: Device ${event.deviceId} has fallen back ${count} times - check connection`);
+        }
+        if (count > alertThreshold && count % alertThreshold === 0) {
+            logger.error(`ALERT: Device ${event.deviceId} has fallen back ${count} times`);
+        }
+    };
+}
+//# sourceMappingURL=fallback-handler.js.map

package/dist/utils/fallback-handler.js.map

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