trane-thermostat-api 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spencer S
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# Nexia Homebridge Library
+
+A TypeScript/Node.js library for controlling Nexia/Trane/American Standard thermostats, specifically designed for Homebridge integration.
+
+## Overview
+
+This library provides a complete rewrite of the Python Nexia library in TypeScript, offering:
+
+- **Full TypeScript support** with comprehensive type definitions
+- **Homebridge-optimized** architecture for seamless HomeKit integration
+- **Modern async/await** patterns for all API interactions
+- **Multi-zone support** with individual thermostat zone control
+- **RoomIQ sensor integration** for enhanced temperature monitoring
+- **Comprehensive error handling** with structured error hierarchy
+
+## Supported Devices
+
+- **Nexia Thermostats**: XL950, XL1050, XL824, UX360
+- **Trane Thermostats**: Compatible with Nexia API
+- **American Standard**: Compatible with Nexia API
+
+## Features
+
+### Thermostat Control
+- System mode control (Auto, Heat, Cool, Off)
+- Temperature setpoint management with deadband validation
+- Fan speed and mode control
+- Emergency heat support
+- Outdoor temperature monitoring
+- Variable speed compressor monitoring
+
+### Zone Management
+- Individual zone temperature control
+- Zone-specific mode settings
+- Hold/schedule management
+- Preset mode support (Home, Away, Sleep)
+- RoomIQ sensor selection and monitoring
+
+### Humidity & Air Quality
+- Humidity monitoring and control
+- Dehumidify/humidify setpoint management
+- Air cleaner mode control (Auto, Quick, Allergy)
+
+### Advanced Features
+- ETag-based caching for efficient API usage
+- Automatic session management and re-authentication
+- Rate-limited login attempts to prevent account lockout
+- Brand-specific URL handling (Nexia, Trane, American Standard)
+- Comprehensive device capability detection
+
+## Installation
+
+```bash
+npm install trane-thermostat-api
+```
+
+## Quick Start
+
+```typescript
+import { NexiaClient, BrandType } from 'trane-thermostat-api';
+
+const client = new NexiaClient({
+  username: 'your-email@example.com',
+  password: 'your-password',
+  brand: BrandType.NEXIA
+});
+
+// Authenticate and discover devices
+await client.login();
+const thermostats = await client.getThermostats();
+
+// Control thermostat
+const thermostat = thermostats[0];
+await thermostat.setFanMode('auto');
+
+// Control zones
+const zone = thermostat.zones[0];
+await zone.setTemperatures({
+  heatingSetpoint: 70,
+  coolingSetpoint: 75
+});
+```
+
+## API Documentation
+
+### Core Classes
+
+#### NexiaClient
+Main HTTP client for API communication and device discovery.
+
+#### NexiaThermostat
+Represents a physical thermostat with full feature detection and control.
+
+#### NexiaZone
+Represents a zone/room within a thermostat with independent temperature control.
+
+#### NexiaSensor
+RoomIQ temperature and humidity sensor with battery monitoring.
+
+## Homebridge Integration
+
+This library is designed specifically for Homebridge plugins. See the included platform implementation for complete HomeKit integration examples.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Run linting
+npm run lint
+
+# Watch mode for development
+npm run dev
+```
+
+## Testing
+
+The test suite includes:
+- Unit tests for all core classes
+- Mock HTTP responses for API testing
+- Validation logic testing
+- Error handling scenarios
+- Integration tests with real API endpoints
+
+```bash
+npm run test:coverage
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes with tests
+4. Run the test suite
+5. Submit a pull request
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Acknowledgments
+
+Based on the original Python Nexia library architecture, rewritten for modern TypeScript/Node.js environments with Homebridge-specific optimizations.

package/dist/client/auth.d.ts

@@ -0,0 +1,50 @@
+import { BrandType } from '../types/constants';
+import { AuthTokens } from '../types/api';
+import { HttpClient } from '../utils/http-utils';
+export interface AuthConfig {
+    username: string;
+    password: string;
+    deviceName?: string;
+    brand: BrandType;
+    stateFile?: string;
+    houseId?: number;
+}
+export interface AuthState {
+    deviceUuid: string;
+    apiKey?: string;
+    mobileId?: string;
+    loginAttempts: number;
+    lastLoginAttempt?: number;
+    sessionExpiry?: number;
+}
+export declare class AuthManager {
+    private readonly config;
+    private readonly httpClient;
+    private readonly stateFilePath;
+    private authState;
+    constructor(httpClient: HttpClient, config: AuthConfig);
+    initialize(): Promise<void>;
+    authenticate(): Promise<AuthTokens>;
+    isSessionValid(): boolean;
+    refreshSession(): Promise<void>;
+    getApiKey(): string | null;
+    getMobileId(): string | null;
+    getDeviceUuid(): string;
+    needsAuthentication(): boolean;
+    logout(): Promise<void>;
+    reset(): Promise<void>;
+    getSessionInfo(): Promise<{
+        houseId: number;
+        houseName: string;
+    }>;
+    private validateConfig;
+    private getStateFilePath;
+    private loadState;
+    private saveState;
+    private generateNewDeviceUuid;
+    private checkRateLimit;
+    private performLogin;
+    private handleLoginFailure;
+    handleSessionExpired(): void;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/client/auth.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAgC,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAgD,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAUjD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,SAAS,CAAY;gBAEjB,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IAazC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IA6CzC,cAAc,IAAI,OAAO;IAYnB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrC,SAAS,IAAI,MAAM,GAAG,IAAI;IAO1B,WAAW,IAAI,MAAM,GAAG,IAAI;IAO5B,aAAa,IAAI,MAAM;IAOvB,mBAAmB,IAAI,OAAO;IAOxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA8C9E,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,gBAAgB;YAaV,SAAS;YA4BT,SAAS;YAiBT,qBAAqB;IAQnC,OAAO,CAAC,cAAc;YA8BR,YAAY;IAuB1B,OAAO,CAAC,kBAAkB;IAQnB,oBAAoB,IAAI,IAAI;CAMpC"}

package/dist/client/auth.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthManager = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const uuid_1 = require("uuid");
+const constants_1 = require("../types/constants");
+const errors_1 = require("../utils/errors");
+class AuthManager {
+    constructor(httpClient, config) {
+        this.httpClient = httpClient;
+        this.config = this.validateConfig(config);
+        this.stateFilePath = this.getStateFilePath();
+        this.authState = {
+            deviceUuid: (0, uuid_1.v4)(),
+            loginAttempts: 0
+        };
+    }
+    async initialize() {
+        try {
+            await this.loadState();
+        }
+        catch (error) {
+            console.warn('Failed to load auth state, starting fresh:', error);
+            await this.generateNewDeviceUuid();
+        }
+    }
+    async authenticate() {
+        this.checkRateLimit();
+        try {
+            const response = await this.performLogin();
+            if (response.success && response.api_key && response.mobile_id) {
+                this.authState.apiKey = response.api_key;
+                this.authState.mobileId = response.mobile_id;
+                this.authState.loginAttempts = 0;
+                this.authState.lastLoginAttempt = Date.now();
+                this.authState.sessionExpiry = Date.now() + (24 * 60 * 60 * 1000);
+                this.httpClient.setAuthHeaders(response.api_key, response.mobile_id, this.config.brand);
+                await this.saveState();
+                return {
+                    apiKey: response.api_key,
+                    mobileId: response.mobile_id,
+                    success: true
+                };
+            }
+            else {
+                this.handleLoginFailure();
+                throw new errors_1.AuthenticationError('Login failed: Invalid credentials');
+            }
+        }
+        catch (error) {
+            this.handleLoginFailure();
+            if (error instanceof errors_1.AuthenticationError) {
+                throw error;
+            }
+            const nexiaError = errors_1.ErrorHandler.handle(error);
+            throw new errors_1.AuthenticationError(`Login failed: ${nexiaError.message}`);
+        }
+    }
+    isSessionValid() {
+        return !!(this.authState.apiKey &&
+            this.authState.mobileId &&
+            this.authState.sessionExpiry &&
+            this.authState.sessionExpiry > Date.now());
+    }
+    async refreshSession() {
+        this.authState.apiKey = undefined;
+        this.authState.mobileId = undefined;
+        this.authState.sessionExpiry = undefined;
+        this.httpClient.clearAuthHeaders();
+        await this.authenticate();
+    }
+    getApiKey() {
+        return this.authState.apiKey || null;
+    }
+    getMobileId() {
+        return this.authState.mobileId || null;
+    }
+    getDeviceUuid() {
+        return this.authState.deviceUuid;
+    }
+    needsAuthentication() {
+        return !this.isSessionValid();
+    }
+    async logout() {
+        this.authState.apiKey = undefined;
+        this.authState.mobileId = undefined;
+        this.authState.sessionExpiry = undefined;
+        this.httpClient.clearAuthHeaders();
+        await this.saveState();
+    }
+    async reset() {
+        this.authState = {
+            deviceUuid: (0, uuid_1.v4)(),
+            loginAttempts: 0
+        };
+        this.httpClient.clearAuthHeaders();
+        await this.saveState();
+    }
+    async getSessionInfo() {
+        if (!this.isSessionValid()) {
+            await this.authenticate();
+        }
+        try {
+            const response = await this.httpClient.post(constants_1.API_ENDPOINTS.SESSION, {});
+            if (response.data.success && response.data.result?.homes) {
+                const homes = response.data.result.homes;
+                if (homes.length === 0) {
+                    throw new errors_1.AuthenticationError('No homes found in account');
+                }
+                const targetHouse = this.config.houseId
+                    ? homes.find(h => h.house_id === this.config.houseId)
+                    : homes[0];
+                if (!targetHouse) {
+                    throw new errors_1.AuthenticationError(`House ID ${this.config.houseId} not found. Available houses: ${homes.map(h => h.house_id).join(', ')}`);
+                }
+                return {
+                    houseId: targetHouse.house_id,
+                    houseName: targetHouse.name
+                };
+            }
+            else {
+                throw new errors_1.AuthenticationError('Failed to retrieve session information');
+            }
+        }
+        catch (error) {
+            if (error instanceof errors_1.AuthenticationError) {
+                throw error;
+            }
+            const nexiaError = errors_1.ErrorHandler.handle(error);
+            throw new errors_1.AuthenticationError(`Session discovery failed: ${nexiaError.message}`);
+        }
+    }
+    validateConfig(config) {
+        if (!config.username || typeof config.username !== 'string') {
+            throw new errors_1.ConfigurationError('Username is required');
+        }
+        if (!config.password || typeof config.password !== 'string') {
+            throw new errors_1.ConfigurationError('Password is required');
+        }
+        if (!Object.values(constants_1.BrandType).includes(config.brand)) {
+            throw new errors_1.ConfigurationError(`Invalid brand: ${config.brand}. Must be one of: ${Object.values(constants_1.BrandType).join(', ')}`);
+        }
+        return {
+            ...config,
+            deviceName: config.deviceName || constants_1.API_CONSTANTS.DEFAULT_DEVICE_NAME
+        };
+    }
+    getStateFilePath() {
+        if (this.config.stateFile) {
+            return this.config.stateFile;
+        }
+        const homeDir = process.env['HOME'] || process.env['USERPROFILE'] || process.cwd();
+        return (0, path_1.join)(homeDir, '.nexia', 'auth-state.json');
+    }
+    async loadState() {
+        try {
+            const stateData = await fs_1.promises.readFile(this.stateFilePath, 'utf8');
+            const state = JSON.parse(stateData);
+            if (state.deviceUuid && typeof state.deviceUuid === 'string') {
+                this.authState = {
+                    ...this.authState,
+                    ...state
+                };
+                if (this.isSessionValid() && state.apiKey && state.mobileId) {
+                    this.httpClient.setAuthHeaders(state.apiKey, state.mobileId, this.config.brand);
+                }
+            }
+            else {
+                throw new Error('Invalid state file format');
+            }
+        }
+        catch {
+            await this.generateNewDeviceUuid();
+        }
+    }
+    async saveState() {
+        try {
+            await fs_1.promises.mkdir((0, path_1.dirname)(this.stateFilePath), { recursive: true });
+            const stateData = JSON.stringify(this.authState, null, 2);
+            await fs_1.promises.writeFile(this.stateFilePath, stateData, 'utf8');
+        }
+        catch (error) {
+            console.warn('Failed to save auth state:', error);
+        }
+    }
+    async generateNewDeviceUuid() {
+        this.authState.deviceUuid = (0, uuid_1.v4)();
+        await this.saveState();
+    }
+    checkRateLimit() {
+        const now = Date.now();
+        const lastAttempt = this.authState.lastLoginAttempt || 0;
+        const timeSinceLastAttempt = now - lastAttempt;
+        if (timeSinceLastAttempt > 60 * 60 * 1000) {
+            this.authState.loginAttempts = 0;
+        }
+        if (this.authState.loginAttempts >= constants_1.API_CONSTANTS.MAX_LOGIN_ATTEMPTS) {
+            const waitTime = 60 * 60 * 1000;
+            const remainingWait = waitTime - timeSinceLastAttempt;
+            if (remainingWait > 0) {
+                throw new errors_1.RateLimitError(`Too many login attempts. Try again in ${Math.ceil(remainingWait / 60000)} minutes.`, Math.ceil(remainingWait / 1000));
+            }
+            else {
+                this.authState.loginAttempts = 0;
+            }
+        }
+    }
+    async performLogin() {
+        const loginData = {
+            login: this.config.username,
+            password: this.config.password,
+            device_uuid: this.authState.deviceUuid,
+            device_name: this.config.deviceName,
+            app_version: constants_1.API_CONSTANTS.APP_VERSION,
+            is_commercial: false
+        };
+        const response = await this.httpClient.post(constants_1.API_ENDPOINTS.SIGN_IN, loginData);
+        if (response.status === 302) {
+            throw new errors_1.AuthenticationError('Invalid credentials');
+        }
+        return response.data;
+    }
+    handleLoginFailure() {
+        this.authState.loginAttempts = (this.authState.loginAttempts || 0) + 1;
+        this.authState.lastLoginAttempt = Date.now();
+    }
+    handleSessionExpired() {
+        this.authState.apiKey = undefined;
+        this.authState.mobileId = undefined;
+        this.authState.sessionExpiry = undefined;
+        this.httpClient.clearAuthHeaders();
+    }
+}
+exports.AuthManager = AuthManager;
+//# sourceMappingURL=auth.js.map

package/dist/client/auth.js.map

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

package/dist/client/nexia-client.d.ts

@@ -0,0 +1,48 @@
+import { BrandType } from '../types/constants';
+import { NexiaClientConfig, UpdateOptions } from '../types/api';
+import { INexiaClient, INexiaThermostat, INexiaAutomation } from '../types/interfaces';
+export declare class NexiaClient implements INexiaClient {
+    private readonly httpClient;
+    private readonly authManager;
+    private readonly config;
+    private _houseId?;
+    private _houseName?;
+    private thermostats;
+    private automations;
+    private _lastUpdate;
+    private isInitialized;
+    constructor(config: NexiaClientConfig);
+    initialize(): Promise<void>;
+    login(): Promise<void>;
+    logout(): Promise<void>;
+    isAuthenticated(): boolean;
+    getThermostats(): Promise<INexiaThermostat[]>;
+    getAutomations(): Promise<INexiaAutomation[]>;
+    getThermostatById(id: string): INexiaThermostat | undefined;
+    getAutomationById(id: string): INexiaAutomation | undefined;
+    update(options?: UpdateOptions): Promise<void>;
+    get<T>(url: string, headers?: Record<string, string>): Promise<T>;
+    post<T>(url: string, data: unknown, headers?: Record<string, string>): Promise<T>;
+    put<T>(url: string, data: unknown, headers?: Record<string, string>): Promise<T>;
+    get brand(): BrandType;
+    get username(): string;
+    getHouseId(): number | undefined;
+    get lastUpdate(): Date | null;
+    getThermostatIds(): string[];
+    getAutomationIds(): string[];
+    clearCache(): void;
+    private validateConfig;
+    private ensureAuthenticated;
+    private processHouseData;
+    private processThermostat;
+    private processAutomation;
+    private clearDeviceCache;
+    private isSessionExpiredError;
+    private handleSessionExpiry;
+    delayedUpdate(delayMs?: number): Promise<void>;
+    getBaseUrl(): string;
+    getMobileUrl(): string;
+    getUpdateUrl(): string | null;
+    getHouseName(): string | undefined;
+}
+//# sourceMappingURL=nexia-client.d.ts.map

package/dist/client/nexia-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexia-client.d.ts","sourceRoot":"","sources":["../../src/client/nexia-client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAA0C,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAIL,iBAAiB,EACjB,aAAa,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAavF,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,OAAO,CAAC,QAAQ,CAAC,CAAS;IAE1B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,aAAa,CAAkB;gBAE3B,MAAM,EAAE,iBAAiB;IA8BxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B,eAAe,IAAI,OAAO;IAOpB,cAAc,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAQ7C,cAAc,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAQnD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAO3D,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAOrD,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmClD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoBjE,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoBjF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAkB7F,IAAW,KAAK,IAAI,SAAS,CAE5B;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAEM,UAAU,IAAI,MAAM,GAAG,SAAS;IAIvC,IAAW,UAAU,IAAI,IAAI,GAAG,IAAI,CAEnC;IAKM,gBAAgB,IAAI,MAAM,EAAE;IAO5B,gBAAgB,IAAI,MAAM,EAAE;IAO5B,UAAU,IAAI,IAAI;IAOzB,OAAO,CAAC,cAAc;YAwBR,mBAAmB;YAanB,gBAAgB;YAqDhB,iBAAiB;YAiBjB,iBAAiB;IAiB/B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,qBAAqB;YAWf,mBAAmB;IAqBpB,aAAa,CAAC,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1D,UAAU,IAAI,MAAM;IAOpB,YAAY,IAAI,MAAM;IAOtB,YAAY,IAAI,MAAM,GAAG,IAAI;IAO7B,YAAY,IAAI,MAAM,GAAG,SAAS;CAG1C"}