node-red-contrib-senec-cloud-v2 0.2.0

package/dist/lib/auth-manager.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * Authentication Manager
+ *
+ * Handles SENEC Cloud authentication, token management, and refresh logic.
+ *
+ * Since the SENEC API change (August 2025), authentication uses the
+ * SENEC Keycloak SSO with the OAuth2 Authorization Code + PKCE flow,
+ * emulating the official SENEC app:
+ *
+ *   1. GET  /auth  (login page, collects session cookies)
+ *   2. POST username to the login form
+ *   3. POST password to the second-step form
+ *   4. Receive redirect to senec-app-auth://keycloak.prod?code=...
+ *   5. Exchange authorization code for access + refresh tokens
+ *
+ * Access tokens are short-lived (~5 minutes); refresh tokens last ~30 days.
+ * Token refresh uses the standard OAuth2 refresh_token grant.
+ */
+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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __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.AuthenticationManager = void 0;
+const axios_1 = __importDefault(require("axios"));
+const crypto = __importStar(require("crypto"));
+const querystring = __importStar(require("querystring"));
+const SSO_BASE = 'https://sso.senec.com/realms/senec/protocol/openid-connect';
+const CLIENT_ID = 'endcustomer-app-frontend';
+const REDIRECT_URI = 'senec-app-auth://keycloak.prod';
+const OAUTH_SCOPE = 'roles meinsenec';
+function base64url(buffer) {
+    return buffer
+        .toString('base64')
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=+$/, '');
+}
+class AuthenticationManager {
+    constructor(credentials) {
+        this.token = null;
+        this.tokenExpiry = null;
+        this.refreshTokenValue = null;
+        this.refreshTokenExpiry = null;
+        this.credentials = credentials;
+        this.httpClient = axios_1.default.create({
+            timeout: 30000,
+        });
+    }
+    /**
+     * Authenticate with SENEC Cloud (OAuth2 Authorization Code + PKCE)
+     */
+    async authenticate() {
+        try {
+            const codeVerifier = base64url(crypto.randomBytes(64));
+            const codeChallenge = base64url(crypto.createHash('sha256').update(codeVerifier).digest());
+            // Cookie jar for the Keycloak login session
+            const cookies = {};
+            const storeCookies = (headers) => {
+                const setCookie = headers['set-cookie'] || [];
+                for (const c of setCookie) {
+                    const [pair] = c.split(';');
+                    const eq = pair.indexOf('=');
+                    if (eq > 0) {
+                        cookies[pair.substring(0, eq).trim()] = pair.substring(eq + 1);
+                    }
+                }
+            };
+            const cookieHeader = () => Object.entries(cookies)
+                .map(([k, v]) => `${k}=${v}`)
+                .join('; ');
+            // Step 1: GET login page
+            const authUrl = `${SSO_BASE}/auth?` +
+                querystring.stringify({
+                    client_id: CLIENT_ID,
+                    redirect_uri: REDIRECT_URI,
+                    response_type: 'code',
+                    scope: OAUTH_SCOPE,
+                    code_challenge: codeChallenge,
+                    code_challenge_method: 'S256',
+                });
+            const loginPage = await this.httpClient.get(authUrl);
+            storeCookies(loginPage.headers);
+            const extractFormAction = (html) => {
+                const match = html.match(/action="([^"]+)"/);
+                return match ? match[1].replace(/&amp;/g, '&') : null;
+            };
+            const usernameFormAction = extractFormAction(loginPage.data);
+            if (!usernameFormAction) {
+                throw new Error('SENEC login page did not contain a login form');
+            }
+            const postForm = async (action, fields) => this.httpClient.post(action, querystring.stringify(fields), {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    Cookie: cookieHeader(),
+                },
+                maxRedirects: 0,
+                validateStatus: (s) => s === 200 || s === 302,
+            });
+            // Step 2: submit username
+            let response = await postForm(usernameFormAction, {
+                username: this.credentials.username,
+                credentialId: '',
+            });
+            storeCookies(response.headers);
+            // Step 3: submit password (second form step)
+            if (response.status === 200) {
+                const passwordFormAction = extractFormAction(response.data);
+                if (!passwordFormAction) {
+                    throw new Error('Invalid username (SENEC login rejected the account name)');
+                }
+                response = await postForm(passwordFormAction, {
+                    password: this.credentials.password,
+                    credentialId: '',
+                });
+                storeCookies(response.headers);
+            }
+            if (response.status !== 302) {
+                // Form re-rendered => wrong credentials
+                throw new Error('Invalid username or password (check your SENEC app credentials)');
+            }
+            // Step 4: extract authorization code from redirect
+            const location = response.headers.location || '';
+            const codeMatch = location.match(/[?&#]code=([^&]+)/);
+            if (!codeMatch) {
+                throw new Error('SENEC login did not return an authorization code');
+            }
+            // Step 5: exchange code for tokens
+            const tokenResponse = await this.httpClient.post(`${SSO_BASE}/token`, querystring.stringify({
+                grant_type: 'authorization_code',
+                client_id: CLIENT_ID,
+                redirect_uri: REDIRECT_URI,
+                code: codeMatch[1],
+                code_verifier: codeVerifier,
+            }), { headers: { 'Content-Type': 'application/x-www-form-urlencoded' } });
+            this.storeTokens(tokenResponse.data);
+            if (!this.token || !this.tokenExpiry) {
+                throw new Error('Failed to obtain valid token from authentication response');
+            }
+            return {
+                token: this.token,
+                expiry: this.tokenExpiry,
+            };
+        }
+        catch (error) {
+            this.clearToken();
+            throw new Error(`Authentication failed: ${this.describeError(error)}`);
+        }
+    }
+    /**
+     * Refresh the authentication token using the OAuth2 refresh_token grant.
+     * Falls back to a full re-authentication if no valid refresh token exists
+     * or the refresh fails.
+     */
+    async refreshToken() {
+        const refreshUsable = this.refreshTokenValue &&
+            (!this.refreshTokenExpiry || Date.now() < this.refreshTokenExpiry.getTime() - 60000);
+        if (!refreshUsable) {
+            return this.authenticate();
+        }
+        try {
+            const response = await this.httpClient.post(`${SSO_BASE}/token`, querystring.stringify({
+                grant_type: 'refresh_token',
+                client_id: CLIENT_ID,
+                refresh_token: this.refreshTokenValue,
+            }), { headers: { 'Content-Type': 'application/x-www-form-urlencoded' } });
+            this.storeTokens(response.data);
+            if (!this.token || !this.tokenExpiry) {
+                throw new Error('Failed to obtain valid token from refresh response');
+            }
+            return {
+                token: this.token,
+                expiry: this.tokenExpiry,
+            };
+        }
+        catch (error) {
+            // If refresh fails, try full re-authentication
+            return this.authenticate();
+        }
+    }
+    /**
+     * Check if the current token is valid
+     */
+    isTokenValid() {
+        if (!this.token || !this.tokenExpiry) {
+            return false;
+        }
+        // Consider token invalid if it expires in less than 30 seconds
+        // (SENEC access tokens are only valid for ~5 minutes)
+        const bufferTime = 30 * 1000;
+        return Date.now() < this.tokenExpiry.getTime() - bufferTime;
+    }
+    /**
+     * Whether a (probably valid) refresh token is available
+     */
+    canRefresh() {
+        return (!!this.refreshTokenValue &&
+            (!this.refreshTokenExpiry || Date.now() < this.refreshTokenExpiry.getTime() - 60000));
+    }
+    /**
+     * Get the current token
+     */
+    getToken() {
+        return this.token;
+    }
+    /**
+     * Clear the stored tokens
+     */
+    clearToken() {
+        this.token = null;
+        this.tokenExpiry = null;
+        this.refreshTokenValue = null;
+        this.refreshTokenExpiry = null;
+    }
+    /**
+     * Store tokens from a Keycloak token endpoint response
+     */
+    storeTokens(data) {
+        this.token = data.access_token || null;
+        const expiresIn = data.expires_in || 300;
+        this.tokenExpiry = new Date(Date.now() + expiresIn * 1000);
+        if (data.refresh_token) {
+            this.refreshTokenValue = data.refresh_token;
+            const refreshExpiresIn = data.refresh_expires_in || 2592000;
+            this.refreshTokenExpiry = new Date(Date.now() + refreshExpiresIn * 1000);
+        }
+    }
+    /**
+     * Build a user-friendly error description without leaking credentials
+     */
+    describeError(error) {
+        const axiosError = error;
+        if (axiosError && axiosError.isAxiosError) {
+            const status = axiosError.response?.status;
+            if (status === 401 || status === 403) {
+                return 'Invalid username or password (check your SENEC app credentials)';
+            }
+            if (status === 429) {
+                return 'Too many login attempts - rate limited by SENEC Cloud, please wait';
+            }
+            if (status) {
+                return `SENEC Cloud returned HTTP ${status}`;
+            }
+            if (axiosError.code === 'ECONNABORTED' || axiosError.code === 'ETIMEDOUT') {
+                return 'Connection timeout while contacting SENEC Cloud';
+            }
+            if (axiosError.code === 'ENOTFOUND' || axiosError.code === 'ECONNREFUSED') {
+                return 'Cannot reach SENEC Cloud - check your internet connection';
+            }
+        }
+        return error instanceof Error ? error.message : 'Unknown error';
+    }
+}
+exports.AuthenticationManager = AuthenticationManager;
+//# sourceMappingURL=auth-manager.js.map

package/dist/lib/auth-manager.js.map

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

package/dist/lib/data-parser.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Data Parser
+ *
+ * Parses SENEC Cloud App API dashboard responses (v2 format from
+ * app-gateway.prod.senec.dev) and transforms them into the expected
+ * payload structure for backward compatibility.
+ */
+import { SenecData, ValidationResult } from '../types/senec';
+export declare class DataParser {
+    private debugMode;
+    constructor(debugMode?: boolean);
+    /**
+     * Parse SENEC Cloud App API v2 dashboard response into structured data.
+     *
+     * Expected input structure (v2/senec/systems/{id}/dashboard):
+     * {
+     *   currently: {
+     *     powerGenerationInW, powerConsumptionInW,
+     *     gridFeedInInW, gridDrawInW,
+     *     batteryChargeInW, batteryDischargeInW,
+     *     batteryLevelInPercent, selfSufficiencyInPercent, wallboxInW
+     *   },
+     *   today: {
+     *     powerGenerationInWh, powerConsumptionInWh,
+     *     gridFeedInInWh, gridDrawInWh, ...
+     *   },
+     *   timestamp: ISO string
+     * }
+     *
+     * @param apiResponse - Raw dashboard API response from SENEC Cloud
+     * @param systemInfo - Optional system master data (from /v1/senec/anlagen)
+     * @throws {Error} If apiResponse is null, undefined, or invalid
+     */
+    parseEnergyData(apiResponse: any, systemInfo?: any): SenecData;
+    /**
+     * Validate parsed data
+     * @param data - Parsed SENEC data to validate
+     * @returns Validation result with errors and warnings
+     */
+    validateData(data: SenecData): ValidationResult;
+    /**
+     * Extract value from nested object using dot notation path
+     * @param obj - Source object
+     * @param path - Dot notation path (e.g., 'grid.import.today')
+     * @param defaultValue - Default value if path not found
+     * @returns Extracted value or default value
+     */
+    private extractValue;
+    /**
+     * Log debug message
+     * @param method - Method name where log originated
+     * @param message - Debug message
+     */
+    private logDebug;
+    /**
+     * Log warning message
+     * @param method - Method name where warning originated
+     * @param message - Warning message
+     */
+    private logWarning;
+    /**
+     * Log error message
+     * @param method - Method name where error originated
+     * @param error - Error object
+     */
+    private logError;
+}
+//# sourceMappingURL=data-parser.d.ts.map

package/dist/lib/data-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-parser.d.ts","sourceRoot":"","sources":["../../src/lib/data-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAU;gBAEf,SAAS,GAAE,OAAe;IAItC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,GAAG,GAAG,SAAS;IAkD9D;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB;IA2D/C;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IA2BpB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAMhB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/lib/data-parser.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Data Parser
+ *
+ * Parses SENEC Cloud App API dashboard responses (v2 format from
+ * app-gateway.prod.senec.dev) and transforms them into the expected
+ * payload structure for backward compatibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataParser = void 0;
+class DataParser {
+    constructor(debugMode = false) {
+        this.debugMode = debugMode;
+    }
+    /**
+     * Parse SENEC Cloud App API v2 dashboard response into structured data.
+     *
+     * Expected input structure (v2/senec/systems/{id}/dashboard):
+     * {
+     *   currently: {
+     *     powerGenerationInW, powerConsumptionInW,
+     *     gridFeedInInW, gridDrawInW,
+     *     batteryChargeInW, batteryDischargeInW,
+     *     batteryLevelInPercent, selfSufficiencyInPercent, wallboxInW
+     *   },
+     *   today: {
+     *     powerGenerationInWh, powerConsumptionInWh,
+     *     gridFeedInInWh, gridDrawInWh, ...
+     *   },
+     *   timestamp: ISO string
+     * }
+     *
+     * @param apiResponse - Raw dashboard API response from SENEC Cloud
+     * @param systemInfo - Optional system master data (from /v1/senec/anlagen)
+     * @throws {Error} If apiResponse is null, undefined, or invalid
+     */
+    parseEnergyData(apiResponse, systemInfo) {
+        try {
+            // Validate input
+            if (!apiResponse || typeof apiResponse !== 'object') {
+                const error = new Error('Invalid API response: response must be a non-null object');
+                this.logError('parseEnergyData', error);
+                throw error;
+            }
+            // Today values come in Wh from the API; old payload used kWh
+            const whToKwh = (value) => Math.round((value / 1000) * 1000) / 1000;
+            const parsedData = {
+                steuereinheitState: this.extractValue(systemInfo, 'systemType', 'OK'),
+                gridimport: {
+                    today: whToKwh(this.extractValue(apiResponse, 'today.gridDrawInWh', 0)),
+                    now: this.extractValue(apiResponse, 'currently.gridDrawInW', 0),
+                },
+                powergenerated: {
+                    today: whToKwh(this.extractValue(apiResponse, 'today.powerGenerationInWh', 0)),
+                    now: this.extractValue(apiResponse, 'currently.powerGenerationInW', 0),
+                },
+                consumption: {
+                    today: whToKwh(this.extractValue(apiResponse, 'today.powerConsumptionInWh', 0)),
+                    now: this.extractValue(apiResponse, 'currently.powerConsumptionInW', 0),
+                },
+                gridexport: {
+                    today: whToKwh(this.extractValue(apiResponse, 'today.gridFeedInInWh', 0)),
+                    now: this.extractValue(apiResponse, 'currently.gridFeedInInW', 0),
+                },
+                acculevel: {
+                    now: this.extractValue(apiResponse, 'currently.batteryLevelInPercent', 0),
+                },
+            };
+            this.logDebug('parseEnergyData', 'Successfully parsed SENEC energy data');
+            return parsedData;
+        }
+        catch (error) {
+            const errorMessage = `Failed to parse energy data: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            this.logError('parseEnergyData', new Error(errorMessage));
+            throw new Error(errorMessage);
+        }
+    }
+    /**
+     * Validate parsed data
+     * @param data - Parsed SENEC data to validate
+     * @returns Validation result with errors and warnings
+     */
+    validateData(data) {
+        try {
+            const errors = [];
+            const warnings = [];
+            // Validate battery level
+            if (data.acculevel.now < 0 || data.acculevel.now > 100) {
+                const error = `Invalid battery level: ${data.acculevel.now}% (must be 0-100)`;
+                errors.push(error);
+                this.logError('validateData', new Error(error));
+            }
+            // Validate power values (should be non-negative)
+            if (data.powergenerated.now < 0) {
+                const warning = `Negative solar production: ${data.powergenerated.now}W`;
+                warnings.push(warning);
+                this.logWarning('validateData', warning);
+            }
+            if (data.consumption.now < 0) {
+                const warning = `Negative consumption: ${data.consumption.now}W`;
+                warnings.push(warning);
+                this.logWarning('validateData', warning);
+            }
+            // Check for suspiciously high values (>100kW for home system)
+            const maxPower = 100000; // 100kW
+            if (data.powergenerated.now > maxPower) {
+                const warning = `Unusually high solar production: ${data.powergenerated.now}W`;
+                warnings.push(warning);
+                this.logWarning('validateData', warning);
+            }
+            if (data.consumption.now > maxPower) {
+                const warning = `Unusually high consumption: ${data.consumption.now}W`;
+                warnings.push(warning);
+                this.logWarning('validateData', warning);
+            }
+            const result = {
+                valid: errors.length === 0,
+                errors,
+                warnings,
+            };
+            if (result.valid) {
+                this.logDebug('validateData', 'Data validation passed');
+            }
+            else {
+                this.logError('validateData', new Error(`Data validation failed with ${errors.length} error(s)`));
+            }
+            return result;
+        }
+        catch (error) {
+            const errorMessage = `Validation process failed: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            this.logError('validateData', new Error(errorMessage));
+            throw new Error(errorMessage);
+        }
+    }
+    /**
+     * Extract value from nested object using dot notation path
+     * @param obj - Source object
+     * @param path - Dot notation path (e.g., 'grid.import.today')
+     * @param defaultValue - Default value if path not found
+     * @returns Extracted value or default value
+     */
+    extractValue(obj, path, defaultValue) {
+        try {
+            const keys = path.split('.');
+            let current = obj;
+            for (const key of keys) {
+                if (current && typeof current === 'object' && key in current) {
+                    current = current[key];
+                }
+                else {
+                    this.logDebug('extractValue', `Path '${path}' not found, using default value`);
+                    return defaultValue;
+                }
+            }
+            const result = current !== undefined && current !== null ? current : defaultValue;
+            if (result === defaultValue) {
+                this.logDebug('extractValue', `Path '${path}' returned null/undefined, using default value`);
+            }
+            return result;
+        }
+        catch (error) {
+            this.logError('extractValue', new Error(`Failed to extract value from path '${path}': ${error instanceof Error ? error.message : 'Unknown error'}`));
+            return defaultValue;
+        }
+    }
+    /**
+     * Log debug message
+     * @param method - Method name where log originated
+     * @param message - Debug message
+     */
+    logDebug(method, message) {
+        if (this.debugMode) {
+            process.stderr.write(`[DataParser.${method}] DEBUG: ${message}\n`);
+        }
+    }
+    /**
+     * Log warning message
+     * @param method - Method name where warning originated
+     * @param message - Warning message
+     */
+    logWarning(method, message) {
+        process.stderr.write(`[DataParser.${method}] WARNING: ${message}\n`);
+    }
+    /**
+     * Log error message
+     * @param method - Method name where error originated
+     * @param error - Error object
+     */
+    logError(method, error) {
+        process.stderr.write(`[DataParser.${method}] ERROR: ${error.message}\n`);
+        if (this.debugMode && error.stack) {
+            process.stderr.write(`${error.stack}\n`);
+        }
+    }
+}
+exports.DataParser = DataParser;
+//# sourceMappingURL=data-parser.js.map

package/dist/lib/data-parser.js.map

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

package/dist/lib/error-handler.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Error Handler
+ *
+ * Centralized error handling with classification and retry logic.
+ */
+import { AxiosError } from 'axios';
+import { ErrorType, HandledError } from '../types/senec';
+export declare class ErrorHandler {
+    /**
+     * Handle and classify an error
+     */
+    handleError(error: Error | AxiosError): HandledError;
+    /**
+     * Classify error by type
+     */
+    classifyError(error: Error | AxiosError): ErrorType;
+    /**
+     * Determine if error should be retried
+     */
+    shouldRetry(error: Error | AxiosError): boolean;
+    /**
+     * Calculate retry delay with exponential backoff
+     * @param attempt - Retry attempt number (1-based)
+     */
+    getRetryDelay(attempt: number): number;
+    /**
+     * Get Retry-After header value if present (for rate limiting)
+     */
+    getRetryAfter(error: AxiosError): number | null;
+    /**
+     * Get user-friendly error message
+     */
+    private getErrorMessage;
+    /**
+     * Type guard for AxiosError
+     */
+    private isAxiosError;
+}
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/lib/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzD,qBAAa,YAAY;IACvB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,YAAY;IAcpD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS;IA8BnD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO;IAsB/C;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAgBtC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAsB/C;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB"}