homebridge-smartthings-oauth 1.0.0

package/dist/auth/auth.js

@@ -0,0 +1,168 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartThingsAuth = void 0;
+const crypto = __importStar(require("crypto"));
+const axios_1 = __importDefault(require("axios"));
+const tokenManager_1 = require("./tokenManager");
+const SMARTTHINGS_AUTH_URL = 'https://api.smartthings.com/oauth/authorize';
+const SMARTTHINGS_TOKEN_URL = 'https://api.smartthings.com/oauth/token';
+class SmartThingsAuth {
+    constructor(clientId, clientSecret, log, platform, storagePath, webhookServer) {
+        this.clientId = clientId;
+        this.clientSecret = clientSecret;
+        this.log = log;
+        this.platform = platform;
+        this.webhookServer = webhookServer;
+        this.state = null;
+        this.tokenManager = new tokenManager_1.TokenManager(log, storagePath, this.startAuthFlow.bind(this), this.refreshTokens.bind(this));
+        this.webhookServer.setAuthHandler(this);
+    }
+    async handleOAuthCallback(query, res) {
+        try {
+            if (!query.code || !query.state) {
+                throw new Error('Missing code or state parameter');
+            }
+            if (query.state !== this.state) {
+                throw new Error('Invalid state parameter');
+            }
+            const tokens = await this.exchangeCodeForTokens(query.code);
+            await this.tokenManager.updateTokens(tokens);
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end('<h1>Authentication successful!</h1><p>You can close this window and restart Homebridge.</p>');
+            this.log.info('Successfully authenticated with SmartThings');
+        }
+        catch (error) {
+            this.log.error('OAuth callback error:', error);
+            res.writeHead(500, { 'Content-Type': 'text/html' });
+            res.end('<h1>Authentication failed</h1><p>Please try again.</p>');
+        }
+    }
+    async exchangeCodeForTokens(code) {
+        // Create Basic Auth header from client credentials
+        const basicAuth = Buffer.from(`${this.clientId}:${this.clientSecret}`).toString('base64');
+        // Build redirect URI with optional port
+        let redirectUri = this.platform.config.server_url;
+        if (!redirectUri.endsWith('/')) {
+            redirectUri += '/';
+        }
+        redirectUri += 'oauth/callback';
+        const params = new URLSearchParams();
+        params.append('grant_type', 'authorization_code');
+        params.append('code', code);
+        params.append('redirect_uri', redirectUri);
+        const response = await axios_1.default.post(SMARTTHINGS_TOKEN_URL, params, {
+            headers: {
+                'Authorization': `Basic ${basicAuth}`,
+                'Content-Type': 'application/x-www-form-urlencoded'
+            }
+        });
+        return response.data;
+    }
+    // Accepts refreshToken, performs API call, returns new token data
+    async refreshTokens(refreshToken) {
+        try {
+            if (!refreshToken) {
+                throw new Error('No refresh token provided to refreshTokens method');
+            }
+            this.log.debug('Attempting to refresh tokens via API call.');
+            // Create Basic Auth header from client credentials
+            const basicAuth = Buffer.from(`${this.clientId}:${this.clientSecret}`).toString('base64');
+            const params = new URLSearchParams();
+            params.append('grant_type', 'refresh_token');
+            params.append('refresh_token', refreshToken);
+            const response = await axios_1.default.post(SMARTTHINGS_TOKEN_URL, params, {
+                headers: {
+                    'Authorization': `Basic ${basicAuth}`,
+                    'Content-Type': 'application/x-www-form-urlencoded'
+                }
+            });
+            this.log.info('Successfully obtained new tokens from API.');
+            return response.data;
+        }
+        catch (error) {
+            this.log.error('Error during token refresh API call:', error);
+            throw error;
+        }
+    }
+    startAuthFlow() {
+        this.state = crypto.randomBytes(32).toString('hex');
+        const authUrl = new URL(SMARTTHINGS_AUTH_URL);
+        authUrl.searchParams.append('client_id', this.clientId);
+        authUrl.searchParams.append('response_type', 'code');
+        // Build redirect URI with optional port
+        let redirectUri = this.platform.config.server_url;
+        if (!redirectUri.endsWith('/')) {
+            redirectUri += '/';
+        }
+        redirectUri += 'oauth/callback';
+        authUrl.searchParams.append('redirect_uri', redirectUri);
+        authUrl.searchParams.append('scope', 'r:devices:* x:devices:* r:locations:*');
+        authUrl.searchParams.append('state', this.state);
+        this.log.warn('\n=================================================');
+        this.log.warn('SmartThings Authentication Required');
+        this.log.warn('Please visit this URL to authorize with SmartThings:');
+        this.log.warn(authUrl.toString());
+        this.log.warn('=================================================\n');
+        this.log.warn('Restart Homebridge after authentication');
+    }
+    async initialize() {
+        const accessToken = this.tokenManager.getAccessToken();
+        let authFlowStarted = false;
+        if (!accessToken || !this.tokenManager.isTokenValid()) {
+            if (this.tokenManager.isRefreshTokenValid()) {
+                try {
+                    const currentRefreshToken = this.tokenManager.getRefreshToken();
+                    if (currentRefreshToken) {
+                        await this.refreshTokens(currentRefreshToken);
+                    }
+                    else {
+                        this.log.warn('No refresh token found during initialization.');
+                        this.startAuthFlow();
+                        authFlowStarted = true;
+                    }
+                }
+                catch (error) {
+                    this.log.warn('Token refresh failed during initialization, starting auth flow.');
+                    this.startAuthFlow();
+                    authFlowStarted = true;
+                }
+            }
+            else {
+                this.startAuthFlow();
+                authFlowStarted = true;
+            }
+        }
+        return authFlowStarted; // Return true if auth flow was started
+    }
+    getAccessToken() {
+        return this.tokenManager.getAccessToken();
+    }
+}
+exports.SmartThingsAuth = SmartThingsAuth;
+//# sourceMappingURL=auth.js.map

package/dist/auth/auth.js.map

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

package/dist/auth/tokenManager.d.ts

@@ -0,0 +1,36 @@
+import { Logger } from 'homebridge';
+export interface TokenData {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+    expires_at: number;
+    refresh_token_expires_at: number;
+    installed_app_id?: string;
+    location_id?: string;
+}
+export declare class TokenManager {
+    private readonly log;
+    private tokenPath;
+    private tokenData;
+    private refreshTimer;
+    private readonly REFRESH_BEFORE_EXPIRY;
+    private readonly REFRESH_CHECK_INTERVAL;
+    private startAuthFlowCallback;
+    private refreshTokenApiCallback;
+    constructor(log: Logger, storagePath: string, startAuthFlowCallback: () => void, refreshTokenApiCallback: (refreshToken: string) => Promise<Partial<TokenData>>);
+    private startRefreshMonitor;
+    private checkAndRefreshTokens;
+    private loadTokens;
+    private saveTokens;
+    updateTokens(tokenData: Partial<TokenData>): Promise<void>;
+    getAccessToken(): string | null;
+    getRefreshToken(): string | null;
+    isTokenValid(): boolean;
+    isRefreshTokenValid(): boolean;
+    clearTokens(): void;
+    getTokenExpiryInfo(): {
+        accessTokenExpiresIn: number;
+        refreshTokenExpiresIn: number;
+    };
+}
+//# sourceMappingURL=tokenManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenManager.d.ts","sourceRoot":"","sources":["../../src/auth/tokenManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKpC,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IAUrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAiB;IACvD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAa;IACpD,OAAO,CAAC,qBAAqB,CAAa;IAC1C,OAAO,CAAC,uBAAuB,CAAwD;gBAGpE,GAAG,EAAE,MAAM,EAC5B,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,MAAM,IAAI,EACjC,uBAAuB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAShF,OAAO,CAAC,mBAAmB;YAYb,qBAAqB;IA6BnC,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,UAAU;IAWL,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyChE,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,YAAY,IAAI,OAAO;IAKvB,mBAAmB,IAAI,OAAO;IAK9B,WAAW,IAAI,IAAI;IAUnB,kBAAkB,IAAI;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAA;KAAE;CAW7F"}

package/dist/auth/tokenManager.js

@@ -0,0 +1,180 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class TokenManager {
+    constructor(log, storagePath, startAuthFlowCallback, refreshTokenApiCallback) {
+        this.log = log;
+        this.tokenData = null;
+        this.refreshTimer = null;
+        this.REFRESH_BEFORE_EXPIRY = 5 * 60 * 1000; // Refresh 5 minutes before expiry
+        this.REFRESH_CHECK_INTERVAL = 60 * 1000; // Check every minute
+        this.tokenPath = path.join(storagePath, 'smartthings_tokens.json');
+        this.startAuthFlowCallback = startAuthFlowCallback;
+        this.refreshTokenApiCallback = refreshTokenApiCallback;
+        this.loadTokens();
+        this.startRefreshMonitor();
+    }
+    startRefreshMonitor() {
+        // Clear any existing timer
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+        }
+        // Start a periodic check for token refresh
+        this.refreshTimer = setInterval(() => {
+            this.checkAndRefreshTokens();
+        }, this.REFRESH_CHECK_INTERVAL);
+    }
+    async checkAndRefreshTokens() {
+        // Only proceed if we actually have token data AND a refresh token
+        if (!this.tokenData || !this.tokenData.refresh_token) {
+            this.log.debug('checkAndRefreshTokens: Skipping refresh check as token data or refresh token is missing.');
+            return;
+        }
+        const now = Date.now();
+        const timeUntilExpiry = this.tokenData.expires_at - now;
+        // If access token is about to expire, refresh it
+        if (timeUntilExpiry <= this.REFRESH_BEFORE_EXPIRY) {
+            this.log.debug('Access token is about to expire, refreshing tokens');
+            try {
+                const currentRefreshToken = this.getRefreshToken();
+                // Call the API callback with the current refresh token
+                const newTokenData = await this.refreshTokenApiCallback(currentRefreshToken);
+                // Update internal tokens with the result from the API call
+                await this.updateTokens(newTokenData);
+                this.log.info('Successfully refreshed access token using API callback.');
+            }
+            catch (error) {
+                // If the API callback fails (e.g., invalid refresh token), trigger full auth flow
+                this.log.error('API token refresh failed:', error);
+                this.log.warn('Starting new auth flow due to refresh failure.');
+                this.startAuthFlowCallback();
+            }
+        }
+    }
+    loadTokens() {
+        try {
+            if (fs.existsSync(this.tokenPath)) {
+                const data = fs.readFileSync(this.tokenPath, 'utf8');
+                this.tokenData = JSON.parse(data);
+                this.log.debug('Loaded existing tokens from storage');
+            }
+        }
+        catch (error) {
+            this.log.error('Error loading tokens:', error);
+        }
+    }
+    saveTokens() {
+        try {
+            if (this.tokenData) {
+                fs.writeFileSync(this.tokenPath, JSON.stringify(this.tokenData, null, 2));
+                this.log.debug('Saved tokens to storage');
+            }
+        }
+        catch (error) {
+            this.log.error('Error saving tokens:', error);
+        }
+    }
+    async updateTokens(tokenData) {
+        var _a;
+        const oldAccessToken = (_a = this.tokenData) === null || _a === void 0 ? void 0 : _a.access_token;
+        this.tokenData = {
+            ...this.tokenData,
+            ...tokenData,
+            expires_at: Date.now() + (tokenData.expires_in || 0) * 1000,
+            refresh_token_expires_at: Date.now() + 30 * 24 * 60 * 60 * 1000, // 30 days
+        };
+        // Save tokens first
+        this.saveTokens();
+        // Update platform config only if access token actually changed
+        if (tokenData.access_token && tokenData.access_token !== oldAccessToken) {
+            // This part requires access to platform.config and platform.api, 
+            // which we no longer directly have. This needs rethinking.
+            // For now, commenting out the config update.
+            // TODO: Find a way to update platform config without circular dependency.
+            /*
+            try {
+              // Save the updated config to disk
+              const configPath = this.platform.api.user.configPath();
+              const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+              
+              // Find and update our platform's config
+              const platformConfig = config.platforms.find(p =>
+                p.platform === 'HomeBridgeSmartThings' && p.name === this.platform.config.name
+              );
+              
+              if (platformConfig) {
+                platformConfig.AccessToken = tokenData.access_token;
+                fs.writeFileSync(configPath, JSON.stringify(config, null, 4));
+                this.log.debug('Updated AccessToken in Homebridge config');
+              }
+            } catch (error) {
+              this.log.error('Error updating platform config:', error);
+            }
+            */
+        }
+    }
+    getAccessToken() {
+        var _a;
+        return ((_a = this.tokenData) === null || _a === void 0 ? void 0 : _a.access_token) || null;
+    }
+    getRefreshToken() {
+        var _a;
+        return ((_a = this.tokenData) === null || _a === void 0 ? void 0 : _a.refresh_token) || null;
+    }
+    isTokenValid() {
+        if (!this.tokenData)
+            return false;
+        return Date.now() < (this.tokenData.expires_at - this.REFRESH_BEFORE_EXPIRY);
+    }
+    isRefreshTokenValid() {
+        if (!this.tokenData)
+            return false;
+        return Date.now() < (this.tokenData.refresh_token_expires_at - this.REFRESH_BEFORE_EXPIRY);
+    }
+    clearTokens() {
+        this.tokenData = null;
+        if (fs.existsSync(this.tokenPath)) {
+            fs.unlinkSync(this.tokenPath);
+        }
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+        }
+    }
+    getTokenExpiryInfo() {
+        if (!this.tokenData) {
+            return { accessTokenExpiresIn: 0, refreshTokenExpiresIn: 0 };
+        }
+        const now = Date.now();
+        return {
+            accessTokenExpiresIn: Math.max(0, this.tokenData.expires_at - now),
+            refreshTokenExpiresIn: Math.max(0, this.tokenData.refresh_token_expires_at - now),
+        };
+    }
+}
+exports.TokenManager = TokenManager;
+//# sourceMappingURL=tokenManager.js.map

package/dist/auth/tokenManager.js.map

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

package/dist/basePlatformAccessory.d.ts

@@ -0,0 +1,49 @@
+/// <reference types="node" />
+import { PlatformAccessory, Logger, API, Characteristic, CharacteristicValue, Service, WithUUID } from 'homebridge';
+import axios = require('axios');
+import { IKHomeBridgeHomebridgePlatform } from './platform';
+import { ShortEvent } from './webhook/subscriptionHandler';
+type DeviceStatus = {
+    timestamp: number;
+    status: any;
+};
+/**
+ * Platform Accessory
+ * An instance of this class is created for each accessory your platform registers
+ * Each accessory may expose multiple services of different service types.
+ */
+export declare abstract class BasePlatformAccessory {
+    /**
+     * These are just used to create a working example
+     * You should implement your own code to track the state of your accessory
+     */
+    protected accessory: PlatformAccessory;
+    protected platform: IKHomeBridgeHomebridgePlatform;
+    readonly name: string;
+    protected characteristic: typeof Characteristic;
+    protected log: Logger;
+    protected baseURL: string;
+    protected key: string;
+    protected axInstance: axios.AxiosInstance;
+    protected commandURL: string;
+    protected statusURL: string;
+    protected healthURL: string;
+    protected api: API;
+    protected online: boolean;
+    protected deviceStatus: DeviceStatus;
+    protected failureCount: number;
+    protected giveUpTime: number;
+    protected commandInProgress: boolean;
+    protected lastCommandCompleted: number;
+    protected statusQueryInProgress: boolean;
+    protected lastStatusResult: boolean;
+    get id(): string;
+    constructor(platform: IKHomeBridgeHomebridgePlatform, accessory: PlatformAccessory);
+    abstract processEvent(event: ShortEvent): void;
+    protected refreshStatus(): Promise<boolean>;
+    protected startPollingState(pollSeconds: number, getValue: () => Promise<CharacteristicValue>, service: Service, chracteristic: WithUUID<new () => Characteristic>, targetStateCharacteristic?: WithUUID<new () => Characteristic>, getTargetState?: () => Promise<CharacteristicValue>): NodeJS.Timer | void;
+    sendCommand(capability: string, command: string, args?: unknown[]): Promise<boolean>;
+    private waitFor;
+}
+export {};
+//# sourceMappingURL=basePlatformAccessory.d.ts.map

package/dist/basePlatformAccessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basePlatformAccessory.d.ts","sourceRoot":"","sources":["../src/basePlatformAccessory.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,KAAK,GAAG,QAAQ,OAAO,CAAC,CAAC;AAChC,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AACF;;;;GAIG;AACH,8BAAsB,qBAAqB;IAGzC;;;OAGG;IAEH,SAAS,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACvC,SAAS,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IACnD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,cAAc,EAAE,OAAO,cAAc,CAAC;IAChD,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;IAC1C,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IACnB,SAAS,CAAC,MAAM,UAAQ;IACxB,SAAS,CAAC,YAAY,EAAE,YAAY,CAAuC;IAC3E,SAAS,CAAC,YAAY,SAAK;IAC3B,SAAS,CAAC,UAAU,SAAK;IACzB,SAAS,CAAC,iBAAiB,UAAS;IACpC,SAAS,CAAC,oBAAoB,SAAK;IAEnC,SAAS,CAAC,qBAAqB,UAAS;IACxC,SAAS,CAAC,gBAAgB,UAAQ;IAElC,IAAI,EAAE,WAEL;gBAGC,QAAQ,EAAE,8BAA8B,EACxC,SAAS,EAAE,iBAAiB;aAyCd,YAAY,CAAC,KAAK,EAAE,UAAU,GAAE,IAAI;cAMpC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IA8CjD,SAAS,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,OAAO,EAC7G,aAAa,EAAE,QAAQ,CAAC,UAAU,cAAc,CAAC,EAAE,yBAAyB,CAAC,EAAE,QAAQ,CAAC,UAAU,cAAc,CAAC,EACjH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAE,MAAM,CAAC,KAAK,GAAC,IAAI;IA6ClE,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;YA0C5E,OAAO;CAiBtB"}