@quiltdata/benchling-webhook 0.5.4 → 0.6.0

package/dist/lib/config-logger.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * Configuration Diagnostic Logging
+ *
+ * Provides comprehensive logging for configuration operations:
+ * - Configuration sources tracking
+ * - Operation audit trail
+ * - Troubleshooting insights
+ * - Performance metrics
+ *
+ * @module lib/config-logger
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLogger = exports.ConfigOperation = exports.LogLevel = void 0;
+exports.getConfigLogger = getConfigLogger;
+exports.setConfigLogger = setConfigLogger;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+/**
+ * Log level enumeration
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["WARN"] = "WARN";
+    LogLevel["ERROR"] = "ERROR";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Configuration operation types
+ */
+var ConfigOperation;
+(function (ConfigOperation) {
+    ConfigOperation["READ"] = "read";
+    ConfigOperation["WRITE"] = "write";
+    ConfigOperation["VALIDATE"] = "validate";
+    ConfigOperation["MERGE"] = "merge";
+    ConfigOperation["SYNC_SECRETS"] = "sync-secrets";
+    ConfigOperation["INFER_CONFIG"] = "infer-config";
+    ConfigOperation["CREATE_PROFILE"] = "create-profile";
+    ConfigOperation["DELETE_PROFILE"] = "delete-profile";
+})(ConfigOperation || (exports.ConfigOperation = ConfigOperation = {}));
+/**
+ * Configuration logger for diagnostic and audit purposes
+ */
+class ConfigLogger {
+    /**
+     * Creates a new configuration logger
+     *
+     * @param options - Logger configuration options
+     */
+    constructor(options) {
+        const { logFile, enableConsole = true, minLogLevel = LogLevel.INFO } = options || {};
+        // Default log file location
+        const logDir = (0, path_1.resolve)((0, os_1.homedir)(), ".config", "benchling-webhook", "logs");
+        if (!(0, fs_1.existsSync)(logDir)) {
+            (0, fs_1.mkdirSync)(logDir, { recursive: true });
+        }
+        this.logFile = logFile || (0, path_1.resolve)(logDir, "config.log");
+        this.enableConsole = enableConsole;
+        this.minLogLevel = minLogLevel;
+    }
+    /**
+     * Gets log level priority for comparison
+     *
+     * @param level - Log level
+     * @returns Priority number (higher = more severe)
+     */
+    getLogLevelPriority(level) {
+        switch (level) {
+            case LogLevel.DEBUG:
+                return 0;
+            case LogLevel.INFO:
+                return 1;
+            case LogLevel.WARN:
+                return 2;
+            case LogLevel.ERROR:
+                return 3;
+            default:
+                return 1;
+        }
+    }
+    /**
+     * Checks if log level should be output
+     *
+     * @param level - Log level to check
+     * @returns True if should log
+     */
+    shouldLog(level) {
+        return this.getLogLevelPriority(level) >= this.getLogLevelPriority(this.minLogLevel);
+    }
+    /**
+     * Formats log entry for output
+     *
+     * @param entry - Log entry
+     * @returns Formatted log string
+     */
+    formatLogEntry(entry) {
+        const parts = [
+            entry.timestamp,
+            `[${entry.level}]`,
+            `[${entry.operation}]`,
+            entry.message,
+        ];
+        if (entry.source) {
+            parts.push(`source=${entry.source}`);
+        }
+        if (entry.profileName) {
+            parts.push(`profile=${entry.profileName}`);
+        }
+        if (entry.duration !== undefined) {
+            parts.push(`duration=${entry.duration}ms`);
+        }
+        if (entry.data) {
+            parts.push(`data=${JSON.stringify(entry.data)}`);
+        }
+        return parts.join(" ");
+    }
+    /**
+     * Writes log entry to file and console
+     *
+     * @param entry - Log entry to write
+     */
+    writeLog(entry) {
+        if (!this.shouldLog(entry.level)) {
+            return;
+        }
+        const formattedLog = this.formatLogEntry(entry);
+        // Write to file
+        try {
+            (0, fs_1.appendFileSync)(this.logFile, formattedLog + "\n", "utf-8");
+        }
+        catch (error) {
+            console.error(`Failed to write log: ${error.message}`);
+        }
+        // Write to console
+        if (this.enableConsole) {
+            switch (entry.level) {
+                case LogLevel.DEBUG:
+                    console.debug(formattedLog);
+                    break;
+                case LogLevel.INFO:
+                    console.log(formattedLog);
+                    break;
+                case LogLevel.WARN:
+                    console.warn(formattedLog);
+                    break;
+                case LogLevel.ERROR:
+                    console.error(formattedLog);
+                    break;
+            }
+        }
+    }
+    /**
+     * Logs a debug message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    debug(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.DEBUG,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs an info message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    info(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs a warning message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    warn(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.WARN,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs an error message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    error(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.ERROR,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs configuration operation with timing
+     *
+     * @param operation - Configuration operation
+     * @param profileName - Profile name
+     * @param source - Configuration source
+     * @param fn - Function to execute and time
+     * @returns Result of the function
+     */
+    async logOperation(operation, profileName, source, fn) {
+        const startTime = Date.now();
+        this.info(operation, "Starting operation", {
+            profileName,
+            source,
+        });
+        try {
+            const result = await fn();
+            const duration = Date.now() - startTime;
+            this.info(operation, "Operation completed successfully", {
+                profileName,
+                source,
+                duration,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.error(operation, `Operation failed: ${error.message}`, {
+                profileName,
+                source,
+                duration,
+                error: error.stack,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Logs configuration read operation
+     *
+     * @param profileName - Profile name
+     * @param configType - Configuration type
+     * @param success - Whether read was successful
+     * @param source - Configuration source
+     */
+    logRead(profileName, configType, success, source) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: success ? LogLevel.INFO : LogLevel.ERROR,
+            operation: ConfigOperation.READ,
+            message: `Configuration read ${success ? "successful" : "failed"}`,
+            profileName,
+            source,
+            data: {
+                configType,
+            },
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Logs configuration write operation
+     *
+     * @param profileName - Profile name
+     * @param configType - Configuration type
+     * @param success - Whether write was successful
+     * @param source - Configuration source
+     */
+    logWrite(profileName, configType, success, source) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: success ? LogLevel.INFO : LogLevel.ERROR,
+            operation: ConfigOperation.WRITE,
+            message: `Configuration write ${success ? "successful" : "failed"}`,
+            profileName,
+            source,
+            data: {
+                configType,
+            },
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Logs configuration validation
+     *
+     * @param profileName - Profile name
+     * @param isValid - Whether configuration is valid
+     * @param errors - Validation errors
+     */
+    logValidation(profileName, isValid, errors) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: isValid ? LogLevel.INFO : LogLevel.WARN,
+            operation: ConfigOperation.VALIDATE,
+            message: `Configuration validation ${isValid ? "passed" : "failed"}`,
+            profileName,
+            data: errors ? { errors } : undefined,
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Logs secrets sync operation
+     *
+     * @param profileName - Profile name
+     * @param secretArn - Secret ARN
+     * @param action - Action performed (created/updated/skipped)
+     */
+    logSecretsSync(profileName, secretArn, action) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            operation: ConfigOperation.SYNC_SECRETS,
+            message: `Secrets ${action}`,
+            profileName,
+            data: {
+                secretArn,
+                action,
+            },
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Gets the log file path
+     *
+     * @returns Log file path
+     */
+    getLogFile() {
+        return this.logFile;
+    }
+}
+exports.ConfigLogger = ConfigLogger;
+/**
+ * Global configuration logger instance
+ */
+let globalLogger = null;
+/**
+ * Gets or creates the global configuration logger
+ *
+ * @param options - Logger options (only used on first call)
+ * @returns Configuration logger instance
+ */
+function getConfigLogger(options) {
+    if (!globalLogger) {
+        globalLogger = new ConfigLogger(options);
+    }
+    return globalLogger;
+}
+/**
+ * Sets the global configuration logger
+ *
+ * @param logger - Logger instance
+ */
+function setConfigLogger(logger) {
+    globalLogger = logger;
+}
+//# sourceMappingURL=config-logger.js.map

package/dist/lib/config-logger.js.map

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

package/dist/lib/configuration-saver.d.ts

@@ -0,0 +1,75 @@
+import { XDGConfig } from "./xdg-config";
+/**
+ * Configuration metadata
+ */
+export interface ConfigMetadata {
+    savedAt: string;
+    source: string;
+    version?: string;
+    inferredAt?: string;
+}
+/**
+ * Save options for configuration persistence
+ */
+export interface SaveOptions {
+    xdgConfig?: XDGConfig;
+    source?: string;
+    skipValidation?: boolean;
+    merge?: boolean;
+}
+/**
+ * Configuration saver for persisting configuration to XDG files
+ */
+export declare class ConfigurationSaver {
+    /**
+     * Default XDG config instance
+     */
+    private static defaultXDGConfig;
+    /**
+     * Get or create default XDG config instance
+     */
+    private static getDefaultXDGConfig;
+    /**
+     * Save configuration to user config file
+     *
+     * @param config - Configuration to save
+     * @param options - Save options
+     * @returns Saved configuration with metadata
+     */
+    static save(config: Record<string, string | number | boolean>, options?: SaveOptions): Promise<Record<string, string | number | boolean>>;
+    /**
+     * Save inferred configuration to derived config file
+     *
+     * @param config - Inferred configuration
+     * @param options - Save options
+     */
+    static saveToDerived(config: Record<string, string | number | boolean>, options?: SaveOptions): Promise<void>;
+    /**
+     * Save deployment outputs to deployment config file
+     *
+     * @param config - Deployment configuration
+     * @param options - Save options
+     */
+    static saveToDeployment(config: Record<string, string | number | boolean>, options?: SaveOptions): Promise<void>;
+    /**
+     * Create metadata for configuration
+     *
+     * @param options - Metadata options
+     * @returns Configuration metadata
+     */
+    static getMetadata(options?: Partial<ConfigMetadata>): ConfigMetadata;
+    /**
+     * Get the current version
+     *
+     * @returns Version string
+     */
+    private static getVersion;
+    /**
+     * Validate configuration before saving
+     *
+     * @param config - Configuration to validate
+     * @throws {Error} If configuration is invalid
+     */
+    private static validateConfig;
+}
+//# sourceMappingURL=configuration-saver.d.ts.map

package/dist/lib/configuration-saver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-saver.d.ts","sourceRoot":"","sources":["../../lib/configuration-saver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA0B;IAEzD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAQlC;;;;;;OAMG;WACiB,IAAI,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IA8CrD;;;;;OAKG;WACiB,aAAa,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;;;OAKG;WACiB,gBAAgB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;OAKG;WACW,WAAW,CAAC,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc;IAShF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAMzB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAQhC"}

package/dist/lib/configuration-saver.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationSaver = void 0;
+const xdg_config_1 = require("./xdg-config");
+const lodash_merge_1 = __importDefault(require("lodash.merge"));
+/**
+ * Configuration saver for persisting configuration to XDG files
+ */
+class ConfigurationSaver {
+    /**
+     * Get or create default XDG config instance
+     */
+    static getDefaultXDGConfig() {
+        if (!ConfigurationSaver.defaultXDGConfig) {
+            ConfigurationSaver.defaultXDGConfig = new xdg_config_1.XDGConfig();
+            ConfigurationSaver.defaultXDGConfig.ensureDirectories();
+        }
+        return ConfigurationSaver.defaultXDGConfig;
+    }
+    /**
+     * Save configuration to user config file
+     *
+     * @param config - Configuration to save
+     * @param options - Save options
+     * @returns Saved configuration with metadata
+     */
+    static async save(config, options = {}) {
+        const { xdgConfig = ConfigurationSaver.getDefaultXDGConfig(), source = "wizard", skipValidation = false, merge: shouldMerge = false, } = options;
+        // Validate configuration if not skipped
+        if (!skipValidation) {
+            ConfigurationSaver.validateConfig(config);
+        }
+        // Merge with existing config if requested
+        let finalConfig = { ...config };
+        if (shouldMerge) {
+            try {
+                const existingConfig = xdgConfig.readConfig("user");
+                finalConfig = (0, lodash_merge_1.default)({}, existingConfig, config);
+            }
+            catch {
+                // If no existing config, just use the new config
+                finalConfig = { ...config };
+            }
+        }
+        // Add metadata
+        const metadata = ConfigurationSaver.getMetadata({ source });
+        const configWithMetadata = {
+            ...finalConfig,
+            _metadata: metadata,
+        };
+        // Save to user config
+        xdgConfig.writeConfig("user", configWithMetadata);
+        // If source indicates inference, also save to derived config
+        if (source === "quilt-cli" || source === "inference") {
+            await ConfigurationSaver.saveToDerived(config, {
+                xdgConfig,
+                source,
+            });
+        }
+        return finalConfig;
+    }
+    /**
+     * Save inferred configuration to derived config file
+     *
+     * @param config - Inferred configuration
+     * @param options - Save options
+     */
+    static async saveToDerived(config, options = {}) {
+        const { xdgConfig = ConfigurationSaver.getDefaultXDGConfig(), source = "inferred", } = options;
+        // Add inference metadata
+        const metadata = ConfigurationSaver.getMetadata({
+            source,
+            inferredAt: new Date().toISOString(),
+        });
+        const configWithMetadata = {
+            ...config,
+            _metadata: metadata,
+        };
+        // Save to derived config
+        xdgConfig.writeConfig("derived", configWithMetadata);
+    }
+    /**
+     * Save deployment outputs to deployment config file
+     *
+     * @param config - Deployment configuration
+     * @param options - Save options
+     */
+    static async saveToDeployment(config, options = {}) {
+        const { xdgConfig = ConfigurationSaver.getDefaultXDGConfig(), source = "deployment", } = options;
+        // Add deployment metadata
+        const metadata = ConfigurationSaver.getMetadata({ source });
+        const configWithMetadata = {
+            ...config,
+            _metadata: metadata,
+        };
+        // Save to deployment config
+        xdgConfig.writeConfig("deploy", configWithMetadata);
+    }
+    /**
+     * Create metadata for configuration
+     *
+     * @param options - Metadata options
+     * @returns Configuration metadata
+     */
+    static getMetadata(options = {}) {
+        return {
+            savedAt: new Date().toISOString(),
+            source: options.source || "unknown",
+            version: ConfigurationSaver.getVersion(),
+            ...(options.inferredAt && { inferredAt: options.inferredAt }),
+        };
+    }
+    /**
+     * Get the current version
+     *
+     * @returns Version string
+     */
+    static getVersion() {
+        // For now, return a static version
+        // In production, this would read from package.json
+        return "0.6.0";
+    }
+    /**
+     * Validate configuration before saving
+     *
+     * @param config - Configuration to validate
+     * @throws {Error} If configuration is invalid
+     */
+    static validateConfig(config) {
+        // Check if config is empty
+        if (Object.keys(config).length === 0) {
+            throw new Error("Configuration validation failed: Configuration cannot be empty");
+        }
+        // Basic validation passed
+    }
+}
+exports.ConfigurationSaver = ConfigurationSaver;
+/**
+ * Default XDG config instance
+ */
+ConfigurationSaver.defaultXDGConfig = null;
+//# sourceMappingURL=configuration-saver.js.map

package/dist/lib/configuration-saver.js.map

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

package/dist/lib/configuration-validator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Configuration object for validation
+ */
+export interface Configuration {
+    catalogUrl?: string;
+    benchlingTenant?: string;
+    benchlingClientId?: string;
+    benchlingClientSecret?: string;
+    benchlingAppDefinitionId?: string;
+    quiltUserBucket?: string;
+    quiltRegion?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Validation options
+ */
+export interface ValidationOptions {
+    skipBenchlingValidation?: boolean;
+    skipS3Validation?: boolean;
+}
+/**
+ * Comprehensive validation result
+ */
+export interface ComprehensiveValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+/**
+ * Comprehensive configuration validator
+ *
+ * Combines all validation checks (Benchling + S3) and provides
+ * comprehensive validation results with aggregated errors.
+ */
+export declare class ConfigurationValidator {
+    /**
+     * Required configuration fields
+     */
+    private static readonly REQUIRED_FIELDS;
+    /**
+     * Validate entire configuration
+     *
+     * @param config - Configuration to validate
+     * @param options - Validation options
+     * @returns Comprehensive validation result
+     */
+    static validate(config: Configuration, options?: ValidationOptions): Promise<ComprehensiveValidationResult>;
+    /**
+     * Validate catalog URL format
+     *
+     * @param catalogUrl - Catalog URL to validate
+     * @returns True if URL format is valid
+     */
+    static validateCatalogUrl(catalogUrl: string): boolean;
+    /**
+     * Check for missing required fields
+     *
+     * @param config - Configuration to check
+     * @returns Array of missing field names
+     */
+    static checkRequiredFields(config: Configuration): string[];
+}
+//# sourceMappingURL=configuration-validator.d.ts.map

package/dist/lib/configuration-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-validator.d.ts","sourceRoot":"","sources":["../../lib/configuration-validator.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB;IAC/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAQrC;IAEF;;;;;;OAMG;WACiB,QAAQ,CACxB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,6BAA6B,CAAC;IA8EzC;;;;;OAKG;WACW,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAa7D;;;;;OAKG;WACW,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE;CAWrE"}