homebridge-myleviton 3.0.0

package/dist/utils/logger.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Structured logging utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StructuredLogger = exports.LeveledLogger = exports.DEFAULT_STRUCTURED_LOGGER_CONFIG = exports.DEFAULT_LOG_LEVEL = exports.LOG_LEVELS = void 0;
+exports.createLogger = createLogger;
+exports.createStructuredLogger = createStructuredLogger;
+const sanitizers_1 = require("./sanitizers");
+/**
+ * Log levels in order of severity
+ */
+exports.LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+/**
+ * Default log level
+ */
+exports.DEFAULT_LOG_LEVEL = 'info';
+/**
+ * Default structured logger configuration
+ */
+exports.DEFAULT_STRUCTURED_LOGGER_CONFIG = {
+    structured: false,
+    includeCorrelationId: true,
+    includeTimestamp: true,
+};
+/**
+ * Logger wrapper that supports level filtering and structured output
+ */
+class LeveledLogger {
+    baseLog;
+    minLevel;
+    debug;
+    info;
+    warn;
+    error;
+    constructor(log, level = exports.DEFAULT_LOG_LEVEL) {
+        this.baseLog = typeof log === 'function' ? log : (msg) => log.info(msg);
+        this.minLevel = exports.LOG_LEVELS.indexOf(level);
+        // Create level methods
+        this.debug = this.createLevelMethod('debug');
+        this.info = this.createLevelMethod('info');
+        this.warn = this.createLevelMethod('warn');
+        this.error = this.createLevelMethod('error');
+    }
+    createLevelMethod(level) {
+        const levelIndex = exports.LOG_LEVELS.indexOf(level);
+        return (message) => {
+            if (levelIndex >= this.minLevel) {
+                this.baseLog(message);
+            }
+        };
+    }
+}
+exports.LeveledLogger = LeveledLogger;
+/**
+ * Structured logger with correlation ID support
+ */
+class StructuredLogger {
+    log;
+    config;
+    correlationId = null;
+    constructor(log, config = {}) {
+        this.log = log instanceof LeveledLogger ? log : new LeveledLogger(log);
+        this.config = { ...exports.DEFAULT_STRUCTURED_LOGGER_CONFIG, ...config };
+    }
+    /**
+     * Set correlation ID for request tracing
+     */
+    setCorrelationId(id) {
+        this.correlationId = id;
+    }
+    /**
+     * Generate a new correlation ID
+     */
+    generateCorrelationId() {
+        this.correlationId = `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        return this.correlationId;
+    }
+    /**
+     * Clear correlation ID
+     */
+    clearCorrelationId() {
+        this.correlationId = null;
+    }
+    /**
+     * Format a log entry
+     */
+    format(level, message, context) {
+        if (this.config.structured) {
+            const entry = {
+                timestamp: new Date().toISOString(),
+                level,
+                message: typeof message === 'string' ? message : '',
+                ...(typeof message === 'object' ? (0, sanitizers_1.sanitizeObject)(message) : {}),
+                ...(context ? (0, sanitizers_1.sanitizeObject)(context) : {}),
+            };
+            if (this.config.includeCorrelationId && this.correlationId) {
+                entry.correlationId = this.correlationId;
+            }
+            return JSON.stringify(entry);
+        }
+        // Traditional string format
+        let result = '';
+        if (typeof message === 'object') {
+            const { event, ...rest } = message;
+            const contextStr = Object.keys(rest).length > 0
+                ? ` ${JSON.stringify((0, sanitizers_1.sanitizeObject)(rest))}`
+                : '';
+            result = `[${event || 'log'}]${contextStr}`;
+        }
+        else {
+            result = message;
+        }
+        if (context) {
+            result += ` ${JSON.stringify((0, sanitizers_1.sanitizeObject)(context))}`;
+        }
+        return result;
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        this.log.debug(this.format('debug', message, context));
+    }
+    /**
+     * Log info message
+     */
+    info(message, context) {
+        this.log.info(this.format('info', message, context));
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        this.log.warn(this.format('warn', message, context));
+    }
+    /**
+     * Log error message
+     */
+    error(message, context) {
+        this.log.error(this.format('error', message, context));
+    }
+    /**
+     * Log an error with stack trace
+     */
+    logError(message, error, context) {
+        const errorInfo = {
+            code: error instanceof Error ? error.name : 'UNKNOWN',
+            message: (0, sanitizers_1.sanitizeError)(error),
+        };
+        this.error(message, { ...context, error: errorInfo });
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(context) {
+        // Create a new logger that includes the context in every message
+        const childLogger = new StructuredLogger(this.log, this.config);
+        const originalFormat = childLogger.format.bind(childLogger);
+        childLogger['format'] = (level, message, ctx) => {
+            return originalFormat(level, message, { ...context, ...ctx });
+        };
+        return childLogger;
+    }
+}
+exports.StructuredLogger = StructuredLogger;
+/**
+ * Create a leveled logger from Homebridge logger
+ */
+function createLogger(log, level = exports.DEFAULT_LOG_LEVEL) {
+    return new LeveledLogger(log, level);
+}
+/**
+ * Create a structured logger
+ */
+function createStructuredLogger(log, config) {
+    return new StructuredLogger(log, config);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/retry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Centralized retry logic with configurable policies
+ */
+import type { RetryPolicy } from '../types';
+/**
+ * Default retry policy
+ */
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+/**
+ * Aggressive retry policy for critical operations
+ */
+export declare const AGGRESSIVE_RETRY_POLICY: RetryPolicy;
+/**
+ * Conservative retry policy for non-critical operations
+ */
+export declare const CONSERVATIVE_RETRY_POLICY: RetryPolicy;
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Calculate delay with exponential backoff and jitter
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelay: number, maxDelay: number, multiplier: number): number;
+/**
+ * Execute a function with retry logic
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, policy?: Partial<RetryPolicy>): Promise<T>;
+/**
+ * Create a retryable version of a function
+ */
+export declare function makeRetryable<T extends unknown[], R>(fn: (...args: T) => Promise<R>, policy?: Partial<RetryPolicy>): (...args: T) => Promise<R>;
+/**
+ * Retry with timeout
+ */
+export declare function withRetryAndTimeout<T>(fn: () => Promise<T>, timeoutMs: number, policy?: Partial<RetryPolicy>): Promise<T>;
+/**
+ * Context for retry operations (for logging)
+ */
+export interface RetryContext {
+    operation: string;
+    attempt: number;
+    maxAttempts: number;
+    error?: Error;
+    delay?: number;
+}
+/**
+ * Execute with retry and context logging
+ */
+export declare function withRetryContext<T>(operation: string, fn: () => Promise<T>, policy?: Partial<RetryPolicy>, logger?: (context: RetryContext) => void): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAMlC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAMrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAMvC,CAAA;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CASR;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CA4CZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAClD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GACvC,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/dist/utils/retry.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Centralized retry logic with configurable policies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONSERVATIVE_RETRY_POLICY = exports.AGGRESSIVE_RETRY_POLICY = exports.DEFAULT_RETRY_POLICY = void 0;
+exports.sleep = sleep;
+exports.calculateBackoffDelay = calculateBackoffDelay;
+exports.withRetry = withRetry;
+exports.makeRetryable = makeRetryable;
+exports.withRetryAndTimeout = withRetryAndTimeout;
+exports.withRetryContext = withRetryContext;
+const errors_1 = require("../errors");
+/**
+ * Default retry policy
+ */
+exports.DEFAULT_RETRY_POLICY = {
+    maxAttempts: 3,
+    baseDelay: 1000,
+    maxDelay: 30000,
+    backoffMultiplier: 2,
+    retryableErrors: ['AUTH_ERROR', 'TOKEN_EXPIRED', 'NETWORK_ERROR', 'TIMEOUT', 'RATE_LIMITED'],
+};
+/**
+ * Aggressive retry policy for critical operations
+ */
+exports.AGGRESSIVE_RETRY_POLICY = {
+    maxAttempts: 5,
+    baseDelay: 500,
+    maxDelay: 60000,
+    backoffMultiplier: 2,
+    retryableErrors: ['AUTH_ERROR', 'TOKEN_EXPIRED', 'NETWORK_ERROR', 'TIMEOUT', 'RATE_LIMITED', 'API_ERROR'],
+};
+/**
+ * Conservative retry policy for non-critical operations
+ */
+exports.CONSERVATIVE_RETRY_POLICY = {
+    maxAttempts: 2,
+    baseDelay: 2000,
+    maxDelay: 10000,
+    backoffMultiplier: 1.5,
+    retryableErrors: ['NETWORK_ERROR', 'TIMEOUT'],
+};
+/**
+ * Sleep for a specified duration
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Calculate delay with exponential backoff and jitter
+ */
+function calculateBackoffDelay(attempt, baseDelay, maxDelay, multiplier) {
+    // Exponential backoff
+    const exponentialDelay = baseDelay * Math.pow(multiplier, attempt - 1);
+    // Add jitter (±25%)
+    const jitter = exponentialDelay * 0.25 * (Math.random() * 2 - 1);
+    // Cap at max delay
+    return Math.min(exponentialDelay + jitter, maxDelay);
+}
+/**
+ * Execute a function with retry logic
+ */
+async function withRetry(fn, policy = {}) {
+    const { maxAttempts, baseDelay, maxDelay, backoffMultiplier, retryableErrors, onRetry, } = { ...exports.DEFAULT_RETRY_POLICY, ...policy };
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            const errorCode = (0, errors_1.getErrorCode)(error);
+            // Check if error is retryable
+            const isRetryable = (0, errors_1.isRetryableError)(error) || retryableErrors.includes(errorCode);
+            if (!isRetryable || attempt === maxAttempts) {
+                throw error;
+            }
+            // Calculate delay
+            let delay;
+            if (error instanceof errors_1.RateLimitError) {
+                // Use retry-after from rate limit error if available
+                delay = error.retryAfter * 1000;
+            }
+            else {
+                delay = calculateBackoffDelay(attempt, baseDelay, maxDelay, backoffMultiplier);
+            }
+            // Call retry callback if provided
+            onRetry?.(attempt, error);
+            // Wait before retrying
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Create a retryable version of a function
+ */
+function makeRetryable(fn, policy = {}) {
+    return (...args) => withRetry(() => fn(...args), policy);
+}
+/**
+ * Retry with timeout
+ */
+async function withRetryAndTimeout(fn, timeoutMs, policy = {}) {
+    return withRetry(async () => {
+        return Promise.race([
+            fn(),
+            new Promise((_, reject) => {
+                setTimeout(() => reject(new Error(`Operation timed out after ${timeoutMs}ms`)), timeoutMs);
+            }),
+        ]);
+    }, policy);
+}
+/**
+ * Execute with retry and context logging
+ */
+async function withRetryContext(operation, fn, policy = {}, logger) {
+    const mergedPolicy = { ...exports.DEFAULT_RETRY_POLICY, ...policy };
+    const policyWithLogging = {
+        ...mergedPolicy,
+        onRetry: (attempt, error) => {
+            const delay = calculateBackoffDelay(attempt, mergedPolicy.baseDelay, mergedPolicy.maxDelay, mergedPolicy.backoffMultiplier);
+            logger?.({
+                operation,
+                attempt,
+                maxAttempts: mergedPolicy.maxAttempts,
+                error,
+                delay,
+            });
+            mergedPolicy.onRetry?.(attempt, error);
+        },
+    };
+    return withRetry(fn, policyWithLogging);
+}
+//# 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/sanitizers.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Data sanitization utilities for security
+ */
+/**
+ * Sanitize error messages to prevent exposing sensitive data
+ */
+export declare function sanitizeError(err: unknown): string;
+/**
+ * Sanitize a string by removing sensitive data
+ */
+export declare function sanitizeString(str: string): string;
+/**
+ * Sanitize an object by redacting sensitive fields
+ */
+export declare function sanitizeObject<T extends Record<string, unknown>>(obj: T): T;
+/**
+ * Truncate a string to a maximum length
+ */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * Mask a token for logging (show first and last few characters)
+ */
+export declare function maskToken(token: string, visibleChars?: number): string;
+/**
+ * Create a safe preview of a response body for logging
+ */
+export declare function createResponsePreview(body: string, maxLength?: number): string;
+/**
+ * Sanitize stack trace by removing file paths that might expose system info
+ */
+export declare function sanitizeStackTrace(stack: string | undefined): string | undefined;
+//# sourceMappingURL=sanitizers.d.ts.map

package/dist/utils/sanitizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizers.d.ts","sourceRoot":"","sources":["../../src/utils/sanitizers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAYlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CA6B3E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAK/E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,MAAM,CAKjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQhF"}

package/dist/utils/sanitizers.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Data sanitization utilities for security
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeError = sanitizeError;
+exports.sanitizeString = sanitizeString;
+exports.sanitizeObject = sanitizeObject;
+exports.truncate = truncate;
+exports.maskToken = maskToken;
+exports.createResponsePreview = createResponsePreview;
+exports.sanitizeStackTrace = sanitizeStackTrace;
+/**
+ * Patterns for sensitive data that should be redacted
+ */
+const SENSITIVE_PATTERNS = [
+    { pattern: /password[=:]\s*\S+/gi, replacement: 'password=***' },
+    { pattern: /token[=:]\s*\S+/gi, replacement: 'token=***' },
+    { pattern: /email[=:]\s*\S+/gi, replacement: 'email=***' },
+    { pattern: /authorization[=:]\s*\S+/gi, replacement: 'Authorization=***' },
+    { pattern: /bearer\s+\S+/gi, replacement: 'Bearer ***' },
+    { pattern: /"password"\s*:\s*"[^"]+"/gi, replacement: '"password":"***"' },
+    { pattern: /"token"\s*:\s*"[^"]+"/gi, replacement: '"token":"***"' },
+    { pattern: /"id"\s*:\s*"[a-zA-Z0-9]{20,}"/gi, replacement: '"id":"***"' },
+];
+/**
+ * Sanitize error messages to prevent exposing sensitive data
+ */
+function sanitizeError(err) {
+    let message;
+    if (err instanceof Error) {
+        message = err.message;
+    }
+    else if (typeof err === 'string') {
+        message = err;
+    }
+    else {
+        message = String(err);
+    }
+    return sanitizeString(message);
+}
+/**
+ * Sanitize a string by removing sensitive data
+ */
+function sanitizeString(str) {
+    let result = str;
+    for (const { pattern, replacement } of SENSITIVE_PATTERNS) {
+        result = result.replace(pattern, replacement);
+    }
+    return result;
+}
+/**
+ * Sanitize an object by redacting sensitive fields
+ */
+function sanitizeObject(obj) {
+    const sensitiveKeys = new Set([
+        'password',
+        'token',
+        'authorization',
+        'secret',
+        'apiKey',
+        'api_key',
+        'accessToken',
+        'access_token',
+        'refreshToken',
+        'refresh_token',
+    ]);
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (sensitiveKeys.has(key.toLowerCase())) {
+            result[key] = '***';
+        }
+        else if (typeof value === 'object' && value !== null) {
+            result[key] = sanitizeObject(value);
+        }
+        else if (typeof value === 'string') {
+            result[key] = sanitizeString(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Truncate a string to a maximum length
+ */
+function truncate(str, maxLength, suffix = '...') {
+    if (str.length <= maxLength) {
+        return str;
+    }
+    return str.substring(0, maxLength - suffix.length) + suffix;
+}
+/**
+ * Mask a token for logging (show first and last few characters)
+ */
+function maskToken(token, visibleChars = 4) {
+    if (token.length <= visibleChars * 2) {
+        return '***';
+    }
+    return `${token.substring(0, visibleChars)}...${token.substring(token.length - visibleChars)}`;
+}
+/**
+ * Create a safe preview of a response body for logging
+ */
+function createResponsePreview(body, maxLength = 200) {
+    const sanitized = sanitizeString(body);
+    return truncate(sanitized, maxLength);
+}
+/**
+ * Sanitize stack trace by removing file paths that might expose system info
+ */
+function sanitizeStackTrace(stack) {
+    if (!stack) {
+        return undefined;
+    }
+    // Remove absolute paths, keep relative
+    return stack.replace(/\s+at\s+.*\((\/[^)]+)\)/g, (match, path) => {
+        const filename = path.split('/').pop() || path;
+        return match.replace(path, filename);
+    });
+}
+//# sourceMappingURL=sanitizers.js.map

package/dist/utils/sanitizers.js.map

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

package/dist/utils/validators.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Input validation utilities
+ */
+import type { LevitonConfig, PowerState } from '../types';
+/**
+ * Validate email format
+ */
+export declare function validateEmail(email: unknown): string;
+/**
+ * Validate password
+ */
+export declare function validatePassword(password: unknown): string;
+/**
+ * Validate device ID
+ * Accepts strings or numbers (Leviton API returns numeric IDs)
+ */
+export declare function validateDeviceId(id: unknown): string;
+/**
+ * Validate device serial
+ */
+export declare function validateSerial(serial: unknown): string;
+/**
+ * Validate authentication token
+ */
+export declare function validateToken(token: unknown): string;
+/**
+ * Validate power state
+ */
+export declare function validatePowerState(power: unknown): PowerState;
+/**
+ * Validate brightness value (0-100)
+ */
+export declare function validateBrightness(brightness: unknown): number;
+/**
+ * Validate plugin configuration
+ */
+export declare function validateConfig(config: unknown): LevitonConfig;
+/**
+ * Validate that a value is defined (not null or undefined)
+ */
+export declare function assertDefined<T>(value: T | null | undefined, name: string): T;
+/**
+ * Validate that a value is a non-empty array
+ */
+export declare function validateNonEmptyArray<T>(arr: unknown, name: string): T[];
+//# sourceMappingURL=validators.d.ts.map

package/dist/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAiBzD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmBpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAc1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAoBpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAetD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAK7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAc9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAqF7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAK7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAQxE"}