homebridge-myleviton 3.0.0

package/dist/errors/index.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Structured error hierarchy for better error handling
+ */
+/**
+ * Base error class for all Leviton plugin errors
+ */
+export declare abstract class LevitonError extends Error {
+    abstract code: string;
+    abstract readonly isRetryable: boolean;
+    readonly httpStatus?: number;
+    readonly timestamp: Date;
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+    /**
+     * Convert to JSON for logging
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Authentication/authorization errors (401, 403)
+ */
+export declare class AuthenticationError extends LevitonError {
+    code: string;
+    readonly isRetryable = true;
+    readonly httpStatus = 401;
+    constructor(message?: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Token expired error - specific case of auth error
+ */
+export declare class TokenExpiredError extends AuthenticationError {
+    constructor(message?: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Rate limiting errors (429)
+ */
+export declare class RateLimitError extends LevitonError {
+    readonly code = "RATE_LIMITED";
+    readonly isRetryable = true;
+    readonly httpStatus = 429;
+    readonly retryAfter: number;
+    constructor(message?: string, retryAfter?: number, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Device offline/unreachable errors
+ */
+export declare class DeviceOfflineError extends LevitonError {
+    readonly code = "DEVICE_OFFLINE";
+    readonly isRetryable = false;
+    readonly deviceId: string;
+    readonly deviceName?: string;
+    constructor(deviceId: string, deviceName?: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Device not found errors
+ */
+export declare class DeviceNotFoundError extends LevitonError {
+    readonly code = "DEVICE_NOT_FOUND";
+    readonly isRetryable = false;
+    readonly httpStatus = 404;
+    readonly deviceId: string;
+    constructor(deviceId: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Circuit breaker open errors
+ */
+export declare class CircuitBreakerError extends LevitonError {
+    readonly code = "CIRCUIT_OPEN";
+    readonly isRetryable = true;
+    readonly resetTime: Date;
+    constructor(resetTimeMs: number, options?: {
+        cause?: Error;
+    });
+    get retryAfterMs(): number;
+}
+/**
+ * Network/connectivity errors
+ */
+export declare class NetworkError extends LevitonError {
+    code: string;
+    readonly isRetryable = true;
+    readonly originalError?: Error;
+    constructor(message?: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Request timeout errors
+ */
+export declare class TimeoutError extends NetworkError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * API response parsing errors
+ */
+export declare class ApiParseError extends LevitonError {
+    readonly code = "PARSE_ERROR";
+    readonly isRetryable = false;
+    readonly responsePreview?: string;
+    constructor(message: string, responsePreview?: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Invalid API response errors
+ */
+export declare class ApiResponseError extends LevitonError {
+    readonly code = "API_ERROR";
+    readonly isRetryable: boolean;
+    readonly httpStatus: number;
+    readonly responseBody?: string;
+    constructor(httpStatus: number, statusText: string, responseBody?: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Configuration validation errors
+ */
+export declare class ConfigurationError extends LevitonError {
+    readonly code = "CONFIG_ERROR";
+    readonly isRetryable = false;
+    readonly field?: string;
+    readonly details?: string[];
+    constructor(message: string, field?: string, details?: string[], options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Validation errors for input data
+ */
+export declare class ValidationError extends LevitonError {
+    readonly code = "VALIDATION_ERROR";
+    readonly isRetryable = false;
+    readonly field: string;
+    readonly value?: unknown;
+    constructor(field: string, message: string, value?: unknown, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * WebSocket connection errors
+ */
+export declare class WebSocketError extends LevitonError {
+    readonly code = "WEBSOCKET_ERROR";
+    readonly isRetryable = true;
+    readonly closeCode?: number;
+    constructor(message: string, closeCode?: number, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error factory for creating appropriate error types from API responses
+ */
+export declare function createApiError(httpStatus: number, statusText: string, responseBody?: string): LevitonError;
+/**
+ * Check if an error is retryable
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * Get error code from any error
+ */
+export declare function getErrorCode(error: unknown): string;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/errors/index.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Structured error hierarchy for better error handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketError = exports.ValidationError = exports.ConfigurationError = exports.ApiResponseError = exports.ApiParseError = exports.TimeoutError = exports.NetworkError = exports.CircuitBreakerError = exports.DeviceNotFoundError = exports.DeviceOfflineError = exports.RateLimitError = exports.TokenExpiredError = exports.AuthenticationError = exports.LevitonError = void 0;
+exports.createApiError = createApiError;
+exports.isRetryableError = isRetryableError;
+exports.getErrorCode = getErrorCode;
+/**
+ * Base error class for all Leviton plugin errors
+ */
+class LevitonError extends Error {
+    httpStatus;
+    timestamp;
+    constructor(message, options) {
+        super(message, options);
+        this.name = this.constructor.name;
+        this.timestamp = new Date();
+        // Capture stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert to JSON for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            isRetryable: this.isRetryable,
+            httpStatus: this.httpStatus,
+            timestamp: this.timestamp.toISOString(),
+            stack: this.stack,
+        };
+    }
+}
+exports.LevitonError = LevitonError;
+/**
+ * Authentication/authorization errors (401, 403)
+ */
+class AuthenticationError extends LevitonError {
+    code = 'AUTH_ERROR';
+    isRetryable = true;
+    httpStatus = 401;
+    constructor(message = 'Authentication failed', options) {
+        super(message, options);
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Token expired error - specific case of auth error
+ */
+class TokenExpiredError extends AuthenticationError {
+    constructor(message = 'Authentication token has expired', options) {
+        super(message, options);
+        this.code = 'TOKEN_EXPIRED';
+    }
+}
+exports.TokenExpiredError = TokenExpiredError;
+/**
+ * Rate limiting errors (429)
+ */
+class RateLimitError extends LevitonError {
+    code = 'RATE_LIMITED';
+    isRetryable = true;
+    httpStatus = 429;
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', retryAfter = 60, options) {
+        super(message, options);
+        this.retryAfter = retryAfter;
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Device offline/unreachable errors
+ */
+class DeviceOfflineError extends LevitonError {
+    code = 'DEVICE_OFFLINE';
+    isRetryable = false;
+    deviceId;
+    deviceName;
+    constructor(deviceId, deviceName, options) {
+        super(`Device ${deviceName || deviceId} is offline or unreachable`, options);
+        this.deviceId = deviceId;
+        this.deviceName = deviceName;
+    }
+}
+exports.DeviceOfflineError = DeviceOfflineError;
+/**
+ * Device not found errors
+ */
+class DeviceNotFoundError extends LevitonError {
+    code = 'DEVICE_NOT_FOUND';
+    isRetryable = false;
+    httpStatus = 404;
+    deviceId;
+    constructor(deviceId, options) {
+        super(`Device ${deviceId} not found`, options);
+        this.deviceId = deviceId;
+    }
+}
+exports.DeviceNotFoundError = DeviceNotFoundError;
+/**
+ * Circuit breaker open errors
+ */
+class CircuitBreakerError extends LevitonError {
+    code = 'CIRCUIT_OPEN';
+    isRetryable = true;
+    resetTime;
+    constructor(resetTimeMs, options) {
+        const resetTime = new Date(Date.now() + resetTimeMs);
+        super(`Circuit breaker is open. Service unavailable until ${resetTime.toISOString()}`, options);
+        this.resetTime = resetTime;
+    }
+    get retryAfterMs() {
+        return Math.max(0, this.resetTime.getTime() - Date.now());
+    }
+}
+exports.CircuitBreakerError = CircuitBreakerError;
+/**
+ * Network/connectivity errors
+ */
+class NetworkError extends LevitonError {
+    code = 'NETWORK_ERROR';
+    isRetryable = true;
+    originalError;
+    constructor(message = 'Network request failed', options) {
+        super(message, options);
+        this.originalError = options?.cause;
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Request timeout errors
+ */
+class TimeoutError extends NetworkError {
+    timeoutMs;
+    constructor(timeoutMs, options) {
+        super(`Request timed out after ${timeoutMs}ms`, options);
+        this.code = 'TIMEOUT';
+        this.timeoutMs = timeoutMs;
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * API response parsing errors
+ */
+class ApiParseError extends LevitonError {
+    code = 'PARSE_ERROR';
+    isRetryable = false;
+    responsePreview;
+    constructor(message, responsePreview, options) {
+        super(message, options);
+        this.responsePreview = responsePreview?.substring(0, 200);
+    }
+}
+exports.ApiParseError = ApiParseError;
+/**
+ * Invalid API response errors
+ */
+class ApiResponseError extends LevitonError {
+    code = 'API_ERROR';
+    isRetryable;
+    httpStatus;
+    responseBody;
+    constructor(httpStatus, statusText, responseBody, options) {
+        super(`API request failed: ${httpStatus} ${statusText}`, options);
+        this.httpStatus = httpStatus;
+        this.responseBody = responseBody?.substring(0, 500);
+        // Server errors (5xx) are retryable, client errors (4xx) are not
+        this.isRetryable = httpStatus >= 500 && httpStatus < 600;
+    }
+}
+exports.ApiResponseError = ApiResponseError;
+/**
+ * Configuration validation errors
+ */
+class ConfigurationError extends LevitonError {
+    code = 'CONFIG_ERROR';
+    isRetryable = false;
+    field;
+    details;
+    constructor(message, field, details, options) {
+        super(message, options);
+        this.field = field;
+        this.details = details;
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+/**
+ * Validation errors for input data
+ */
+class ValidationError extends LevitonError {
+    code = 'VALIDATION_ERROR';
+    isRetryable = false;
+    field;
+    value;
+    constructor(field, message, value, options) {
+        super(`Invalid ${field}: ${message}`, options);
+        this.field = field;
+        this.value = value;
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * WebSocket connection errors
+ */
+class WebSocketError extends LevitonError {
+    code = 'WEBSOCKET_ERROR';
+    isRetryable = true;
+    closeCode;
+    constructor(message, closeCode, options) {
+        super(message, options);
+        this.closeCode = closeCode;
+    }
+}
+exports.WebSocketError = WebSocketError;
+/**
+ * Error factory for creating appropriate error types from API responses
+ */
+function createApiError(httpStatus, statusText, responseBody) {
+    switch (httpStatus) {
+        case 401:
+            return new AuthenticationError(`Unauthorized: ${statusText}`);
+        case 403:
+            return new AuthenticationError(`Forbidden: ${statusText}`);
+        case 404:
+            return new ApiResponseError(httpStatus, statusText, responseBody);
+        case 429:
+            return new RateLimitError(`Rate limited: ${statusText}`);
+        default:
+            return new ApiResponseError(httpStatus, statusText, responseBody);
+    }
+}
+/**
+ * Check if an error is retryable
+ */
+function isRetryableError(error) {
+    if (error instanceof LevitonError) {
+        return error.isRetryable;
+    }
+    // Network errors from fetch are generally retryable
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('network') ||
+            message.includes('timeout') ||
+            message.includes('econnreset') ||
+            message.includes('enotfound') ||
+            message.includes('socket hang up'));
+    }
+    return false;
+}
+/**
+ * Get error code from any error
+ */
+function getErrorCode(error) {
+    if (error instanceof LevitonError) {
+        return error.code;
+    }
+    if (error instanceof Error) {
+        return error.name || 'UNKNOWN_ERROR';
+    }
+    return 'UNKNOWN_ERROR';
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Main entry point for homebridge-myleviton
+ */
+export * from './types';
+export * from './errors';
+export * from './api';
+export * from './utils';
+export { LevitonDecoraSmartPlatform } from './platform';
+export { default } from './platform';
+export declare const VERSION = "3.0.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAGvD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGpC,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Main entry point for homebridge-myleviton
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.default = exports.LevitonDecoraSmartPlatform = void 0;
+// Re-export everything
+__exportStar(require("./types"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./api"), exports);
+__exportStar(require("./utils"), exports);
+// Export platform
+var platform_1 = require("./platform");
+Object.defineProperty(exports, "LevitonDecoraSmartPlatform", { enumerable: true, get: function () { return platform_1.LevitonDecoraSmartPlatform; } });
+// Default export for Homebridge plugin registration
+var platform_2 = require("./platform");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(platform_2).default; } });
+// Export version
+exports.VERSION = '3.0.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;AAEH,uBAAuB;AACvB,0CAAuB;AACvB,2CAAwB;AACxB,wCAAqB;AACrB,0CAAuB;AAEvB,kBAAkB;AAClB,uCAAuD;AAA9C,sHAAA,0BAA0B,OAAA;AAEnC,oDAAoD;AACpD,uCAAoC;AAA3B,oHAAA,OAAO,OAAA;AAEhB,iBAAiB;AACJ,QAAA,OAAO,GAAG,OAAO,CAAA"}

package/dist/platform.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Copyright (c) 2026 tbaur
+ *
+ * Licensed under the Apache License, Version 2.0
+ * See LICENSE file for full license text
+ *
+ * @fileoverview Homebridge platform plugin for My Leviton Decora Smart devices
+ */
+import type { LevitonConfig, DeviceInfo } from './types';
+type HomebridgeAPI = any;
+type PlatformAccessory = any;
+/**
+ * Leviton Decora Smart Platform for Homebridge
+ */
+export declare class LevitonDecoraSmartPlatform {
+    private readonly config;
+    private readonly api;
+    private readonly accessories;
+    private readonly log;
+    private client;
+    private currentToken;
+    private tokenRefreshInProgress;
+    private webSocket;
+    private pollingInterval;
+    private residenceId;
+    private devicePersistence;
+    private cleanupInterval;
+    constructor(homebridgeLog: (msg: string) => void, config: LevitonConfig, api: HomebridgeAPI);
+    /**
+     * Validates plugin configuration
+     */
+    private validateConfig;
+    /**
+     * Initializes the platform
+     */
+    private initialize;
+    /**
+     * Discovers devices from Leviton API
+     */
+    private discoverDevices;
+    /**
+     * Handles WebSocket update messages
+     */
+    private handleWebSocketUpdate;
+    /**
+     * Checks if device should be excluded
+     */
+    private isDeviceExcluded;
+    /**
+     * Checks if accessory already exists
+     */
+    private accessoryExists;
+    /**
+     * Adds a new accessory
+     */
+    addAccessory(device: DeviceInfo, token: string): Promise<void>;
+    /**
+     * Configures a cached accessory
+     */
+    configureAccessory(accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Sets up the appropriate service for a device
+     */
+    private setupService;
+    /**
+     * Gets device status with error handling
+     */
+    private getStatus;
+    /**
+     * Sets up a lightbulb service
+     */
+    private setupLightbulbService;
+    /**
+     * Sets up a motion dimmer service
+     */
+    private setupMotionDimmerService;
+    /**
+     * Sets up a fan service
+     */
+    private setupFanService;
+    /**
+     * Sets up a basic switch/outlet service
+     */
+    private setupBasicService;
+    /**
+     * Creates a power getter handler
+     */
+    private createPowerGetter;
+    /**
+     * Creates a power setter handler
+     */
+    private createPowerSetter;
+    /**
+     * Creates a brightness getter handler
+     */
+    private createBrightnessGetter;
+    /**
+     * Creates a brightness setter handler
+     */
+    private createBrightnessSetter;
+    /**
+     * Ensures a valid token is available
+     */
+    private ensureValidToken;
+    /**
+     * Refreshes the authentication token
+     */
+    private refreshToken;
+    /**
+     * Starts polling for device updates
+     */
+    private startPolling;
+    /**
+     * Polls all devices for updates
+     */
+    private pollDevices;
+    /**
+     * Saves device states to persistence
+     */
+    private saveDeviceStates;
+    /**
+     * Starts periodic cleanup
+     */
+    private startPeriodicCleanup;
+    /**
+     * Cleans up resources
+     */
+    private cleanup;
+    /**
+     * Removes all accessories
+     */
+    removeAccessories(): void;
+}
+/**
+ * Homebridge plugin registration
+ */
+export declare function registerPlatform(homebridge: HomebridgeAPI): void;
+export default registerPlatform;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EAIX,MAAM,SAAS,CAAA;AAsBhB,KAAK,aAAa,GAAG,GAAG,CAAA;AAExB,KAAK,iBAAiB,GAAG,GAAG,CAAA;AAM5B;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAGnC,OAAO,CAAC,MAAM,CAAkB;IAGhC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,sBAAsB,CAAQ;IAGtC,OAAO,CAAC,SAAS,CAAgC;IAGjD,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,WAAW,CAAsB;IAGzC,OAAO,CAAC,iBAAiB,CAAmB;IAG5C,OAAO,CAAC,eAAe,CAA8C;gBAGnE,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EACpC,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,aAAa;IAuCpB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;OAEG;YACW,UAAU;IA4CxB;;OAEG;YACW,eAAe;IAmE7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuD7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCpE;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,SAAS;IASvB;;OAEG;YACW,qBAAqB;IAgCnC;;OAEG;YACW,wBAAwB;IAYtC;;OAEG;YACW,eAAe;IAuB7B;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;IAEH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IAEH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IAEH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IAEH,OAAO,CAAC,sBAAsB;IAa9B;;OAEG;YACW,gBAAgB;IAO9B;;OAEG;YACW,YAAY;IA0B1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;YACW,WAAW;IAsBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,OAAO;IAiBf;;OAEG;IACH,iBAAiB,IAAI,IAAI;CAK1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAGhE;AAED,eAAe,gBAAgB,CAAA"}