@brightchain/brightchain-lib 0.8.1 → 0.10.0

package/src/lib/logging/blockLogger.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Block Logger Module
+ *
+ * Provides structured logging for block operations in BrightChain.
+ * Supports configurable log levels and JSON-formatted output.
+ *
+ * @module logging/blockLogger
+ *
+ * @example
+ * ```typescript
+ * import { BlockLogger, LogLevel } from 'brightchain-lib';
+ *
+ * const logger = new BlockLogger();
+ * logger.setLevel(LogLevel.DEBUG);
+ *
+ * logger.info('encrypt', { blockId: '0x123...', blockType: 'EncryptedBlock' });
+ * logger.error('decrypt', new Error('Decryption failed'), { blockId: '0x456...' });
+ * ```
+ *
+ * @see Requirements 8.1, 8.2, 8.3, 8.4, 8.5, 8.6
+ */
+/**
+ * Log levels for block operations.
+ * Ordered from most verbose (DEBUG) to least verbose (ERROR).
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * Structured log entry for block operations.
+ * All entries are JSON-serializable for machine parsing.
+ *
+ * @see Requirement 8.4 - Structured JSON format
+ */
+export interface BlockLogEntry {
+    /** ISO 8601 timestamp of the log entry */
+    timestamp: string;
+    /** Log level (debug, info, warn, error) */
+    level: LogLevel;
+    /** Operation being performed (e.g., 'encrypt', 'decrypt', 'validate') */
+    operation: string;
+    /** Block ID (hex-encoded checksum) - not sensitive */
+    blockId?: string;
+    /** Block type name */
+    blockType?: string;
+    /** Additional metadata (never contains sensitive data) */
+    metadata?: Record<string, unknown>;
+    /** Error information if applicable */
+    error?: {
+        /** Error class name */
+        type: string;
+        /** Error message (sanitized) */
+        message: string;
+    };
+}
+/**
+ * Interface for block logging operations.
+ * Implementations must ensure sensitive data is never logged.
+ *
+ * @see Requirement 8.6 - No sensitive data in logs
+ */
+export interface IBlockLogger {
+    /**
+     * Log a debug-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    debug(operation: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log an info-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    info(operation: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log a warning-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    warn(operation: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log an error-level message.
+     * @param operation - The operation being performed
+     * @param error - The error that occurred
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    error(operation: string, error: Error, metadata?: Record<string, unknown>): void;
+    /**
+     * Set the minimum log level.
+     * Messages below this level will be suppressed.
+     * @param level - The minimum log level to emit
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current log level.
+     * @returns The current minimum log level
+     */
+    getLevel(): LogLevel;
+}
+/**
+ * BlockLogger implementation with configurable output and log levels.
+ *
+ * Features:
+ * - Structured JSON log entries
+ * - Configurable log levels with filtering
+ * - Automatic sensitive data sanitization
+ * - Configurable output destination
+ *
+ * @see Requirements 8.4, 8.5, 8.6
+ *
+ * @example
+ * ```typescript
+ * // Create logger with custom output
+ * const entries: BlockLogEntry[] = [];
+ * const logger = new BlockLogger((entry) => entries.push(entry));
+ *
+ * // Set log level
+ * logger.setLevel(LogLevel.WARN);
+ *
+ * // These will be suppressed
+ * logger.debug('operation', { detail: 'value' });
+ * logger.info('operation', { detail: 'value' });
+ *
+ * // These will be logged
+ * logger.warn('operation', { detail: 'value' });
+ * logger.error('operation', new Error('Failed'), { detail: 'value' });
+ * ```
+ */
+export declare class BlockLogger implements IBlockLogger {
+    private level;
+    private output;
+    private _silent;
+    /**
+     * Create a new BlockLogger.
+     * @param output - Optional custom output function. Defaults to console output.
+     */
+    constructor(output?: (entry: BlockLogEntry) => void);
+    /**
+     * Enable or disable all output (useful for tests)
+     */
+    set silent(value: boolean);
+    get silent(): boolean;
+    /**
+     * Set the minimum log level.
+     * @param level - The minimum log level to emit
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current log level.
+     * @returns The current minimum log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Check if a log level should be emitted based on current level setting.
+     * @param level - The level to check
+     * @returns true if the level should be emitted
+     */
+    private shouldLog;
+    /**
+     * Create a log entry with common fields.
+     * @param level - The log level
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata
+     * @returns The log entry
+     */
+    private createEntry;
+    /**
+     * Emit a log entry if the level is enabled.
+     * @param entry - The log entry to emit
+     */
+    private emit;
+    /**
+     * Log a debug-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    debug(operation: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log an info-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    info(operation: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log a warning-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    warn(operation: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log an error-level message.
+     * @param operation - The operation being performed
+     * @param error - The error that occurred
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    error(operation: string, error: Error, metadata?: Record<string, unknown>): void;
+}
+/**
+ * Global block logger instance.
+ * Can be used directly or replaced with a custom logger.
+ */
+export declare const blockLogger: BlockLogger;
+/**
+ * Log a validation failure with error type and metadata.
+ * This is a convenience function for block validation operations.
+ *
+ * @param blockId - The block ID (hex-encoded checksum)
+ * @param blockType - The block type name
+ * @param error - The validation error
+ * @param metadata - Optional additional metadata
+ *
+ * @see Requirement 8.3 - Validation failure logging
+ */
+export declare function logValidationFailure(blockId: string | undefined, blockType: string | undefined, error: Error, metadata?: Record<string, unknown>): void;
+//# sourceMappingURL=blockLogger.d.ts.map

package/src/lib/logging/blockLogger.d.ts.map

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

package/src/lib/logging/blockLogger.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * Block Logger Module
+ *
+ * Provides structured logging for block operations in BrightChain.
+ * Supports configurable log levels and JSON-formatted output.
+ *
+ * @module logging/blockLogger
+ *
+ * @example
+ * ```typescript
+ * import { BlockLogger, LogLevel } from 'brightchain-lib';
+ *
+ * const logger = new BlockLogger();
+ * logger.setLevel(LogLevel.DEBUG);
+ *
+ * logger.info('encrypt', { blockId: '0x123...', blockType: 'EncryptedBlock' });
+ * logger.error('decrypt', new Error('Decryption failed'), { blockId: '0x456...' });
+ * ```
+ *
+ * @see Requirements 8.1, 8.2, 8.3, 8.4, 8.5, 8.6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockLogger = exports.BlockLogger = exports.LogLevel = void 0;
+exports.logValidationFailure = logValidationFailure;
+/**
+ * Log levels for block operations.
+ * Ordered from most verbose (DEBUG) to least verbose (ERROR).
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Numeric priority for log levels (higher = more severe).
+ * Used for log level filtering.
+ */
+const LOG_LEVEL_PRIORITY = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.WARN]: 2,
+    [LogLevel.ERROR]: 3,
+};
+/**
+ * Default output function that writes to console.
+ * @param entry - The log entry to output
+ */
+function defaultOutput(entry) {
+    const json = JSON.stringify(entry);
+    switch (entry.level) {
+        case LogLevel.DEBUG:
+            console.debug(json);
+            break;
+        case LogLevel.INFO:
+            console.info(json);
+            break;
+        case LogLevel.WARN:
+            console.warn(json);
+            break;
+        case LogLevel.ERROR:
+            console.error(json);
+            break;
+    }
+}
+/**
+ * Patterns that indicate sensitive data that should never be logged.
+ * Used to sanitize metadata before logging.
+ */
+const SENSITIVE_PATTERNS = [
+    /privateKey/i,
+    /secretKey/i,
+    /password/i,
+    /secret/i,
+    /credential/i,
+    /token/i,
+    /apiKey/i,
+    /encryptionKey/i,
+    /decryptionKey/i,
+    /plaintext/i,
+    /cleartext/i,
+];
+/**
+ * Check if a key name indicates sensitive data.
+ * @param key - The key name to check
+ * @returns true if the key indicates sensitive data
+ */
+function isSensitiveKey(key) {
+    return SENSITIVE_PATTERNS.some((pattern) => pattern.test(key));
+}
+/**
+ * Check if a value looks like a private key (long hex string in key-related context).
+ * @param value - The value to check
+ * @param key - Optional key name to check for safe fields
+ * @returns true if the value looks like a private key
+ */
+function looksLikePrivateKey(value, key) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    // Known safe fields that may contain long hex strings (like checksums/block IDs)
+    const safeHexFields = ['blockId', 'checksum', 'id', 'hash', 'signature'];
+    if (key &&
+        safeHexFields.some((safe) => key.toLowerCase().includes(safe.toLowerCase()))) {
+        return false;
+    }
+    // Private keys are typically 64+ hex characters
+    return /^(0x)?[0-9a-fA-F]{64,}$/.test(value);
+}
+/**
+ * Sanitize metadata to remove any sensitive data.
+ * @param metadata - The metadata to sanitize
+ * @returns Sanitized metadata safe for logging
+ */
+function sanitizeMetadata(metadata) {
+    if (!metadata) {
+        return undefined;
+    }
+    const sanitized = {};
+    for (const [key, value] of Object.entries(metadata)) {
+        // Skip sensitive keys entirely
+        if (isSensitiveKey(key)) {
+            sanitized[key] = '[REDACTED]';
+            continue;
+        }
+        // Check for values that look like private keys (pass key for context)
+        if (looksLikePrivateKey(value, key)) {
+            sanitized[key] = '[REDACTED]';
+            continue;
+        }
+        // Recursively sanitize nested objects
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            sanitized[key] = sanitizeMetadata(value);
+        }
+        else if (Array.isArray(value)) {
+            // Sanitize array elements
+            sanitized[key] = value.map((item) => {
+                if (looksLikePrivateKey(item)) {
+                    return '[REDACTED]';
+                }
+                if (item !== null && typeof item === 'object') {
+                    return sanitizeMetadata(item);
+                }
+                return item;
+            });
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * BlockLogger implementation with configurable output and log levels.
+ *
+ * Features:
+ * - Structured JSON log entries
+ * - Configurable log levels with filtering
+ * - Automatic sensitive data sanitization
+ * - Configurable output destination
+ *
+ * @see Requirements 8.4, 8.5, 8.6
+ *
+ * @example
+ * ```typescript
+ * // Create logger with custom output
+ * const entries: BlockLogEntry[] = [];
+ * const logger = new BlockLogger((entry) => entries.push(entry));
+ *
+ * // Set log level
+ * logger.setLevel(LogLevel.WARN);
+ *
+ * // These will be suppressed
+ * logger.debug('operation', { detail: 'value' });
+ * logger.info('operation', { detail: 'value' });
+ *
+ * // These will be logged
+ * logger.warn('operation', { detail: 'value' });
+ * logger.error('operation', new Error('Failed'), { detail: 'value' });
+ * ```
+ */
+class BlockLogger {
+    /**
+     * Create a new BlockLogger.
+     * @param output - Optional custom output function. Defaults to console output.
+     */
+    constructor(output) {
+        this.level = LogLevel.INFO;
+        this._silent = false;
+        this.output = output ?? defaultOutput;
+    }
+    /**
+     * Enable or disable all output (useful for tests)
+     */
+    set silent(value) {
+        this._silent = value;
+    }
+    get silent() {
+        return this._silent;
+    }
+    /**
+     * Set the minimum log level.
+     * @param level - The minimum log level to emit
+     */
+    setLevel(level) {
+        this.level = level;
+    }
+    /**
+     * Get the current log level.
+     * @returns The current minimum log level
+     */
+    getLevel() {
+        return this.level;
+    }
+    /**
+     * Check if a log level should be emitted based on current level setting.
+     * @param level - The level to check
+     * @returns true if the level should be emitted
+     */
+    shouldLog(level) {
+        return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.level];
+    }
+    /**
+     * Create a log entry with common fields.
+     * @param level - The log level
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata
+     * @returns The log entry
+     */
+    createEntry(level, operation, metadata) {
+        const sanitizedMetadata = sanitizeMetadata(metadata);
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            operation,
+        };
+        // Extract blockId and blockType from metadata if present
+        if (sanitizedMetadata) {
+            if (typeof sanitizedMetadata['blockId'] === 'string') {
+                entry.blockId = sanitizedMetadata['blockId'];
+                delete sanitizedMetadata['blockId'];
+            }
+            if (typeof sanitizedMetadata['blockType'] === 'string') {
+                entry.blockType = sanitizedMetadata['blockType'];
+                delete sanitizedMetadata['blockType'];
+            }
+            // Only include metadata if there are remaining fields
+            if (Object.keys(sanitizedMetadata).length > 0) {
+                entry.metadata = sanitizedMetadata;
+            }
+        }
+        return entry;
+    }
+    /**
+     * Emit a log entry if the level is enabled.
+     * @param entry - The log entry to emit
+     */
+    emit(entry) {
+        // Skip output in silent mode (useful for tests)
+        if (this._silent)
+            return;
+        if (this.shouldLog(entry.level)) {
+            try {
+                this.output(entry);
+            }
+            catch {
+                // Never let logging failures affect block operations
+                // Silently ignore logging errors
+            }
+        }
+    }
+    /**
+     * Log a debug-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    debug(operation, metadata) {
+        const entry = this.createEntry(LogLevel.DEBUG, operation, metadata);
+        this.emit(entry);
+    }
+    /**
+     * Log an info-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    info(operation, metadata) {
+        const entry = this.createEntry(LogLevel.INFO, operation, metadata);
+        this.emit(entry);
+    }
+    /**
+     * Log a warning-level message.
+     * @param operation - The operation being performed
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    warn(operation, metadata) {
+        const entry = this.createEntry(LogLevel.WARN, operation, metadata);
+        this.emit(entry);
+    }
+    /**
+     * Log an error-level message.
+     * @param operation - The operation being performed
+     * @param error - The error that occurred
+     * @param metadata - Optional metadata (must not contain sensitive data)
+     */
+    error(operation, error, metadata) {
+        const entry = this.createEntry(LogLevel.ERROR, operation, metadata);
+        entry.error = {
+            type: error.constructor.name,
+            message: error.message,
+        };
+        this.emit(entry);
+    }
+}
+exports.BlockLogger = BlockLogger;
+/**
+ * Global block logger instance.
+ * Can be used directly or replaced with a custom logger.
+ */
+exports.blockLogger = new BlockLogger();
+/**
+ * Log a validation failure with error type and metadata.
+ * This is a convenience function for block validation operations.
+ *
+ * @param blockId - The block ID (hex-encoded checksum)
+ * @param blockType - The block type name
+ * @param error - The validation error
+ * @param metadata - Optional additional metadata
+ *
+ * @see Requirement 8.3 - Validation failure logging
+ */
+function logValidationFailure(blockId, blockType, error, metadata) {
+    exports.blockLogger.error('validate', error, {
+        blockId,
+        blockType,
+        errorType: error.constructor.name,
+        ...metadata,
+    });
+}
+//# sourceMappingURL=blockLogger.js.map

package/src/lib/logging/blockLogger.js.map

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

package/src/lib/logging/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Logging Module for BrightChain
+ *
+ * This module exports logging utilities for block operations.
+ *
+ * @module logging
+ *
+ * @example
+ * ```typescript
+ * import { BlockLogger, LogLevel, blockLogger } from 'brightchain-lib';
+ *
+ * // Use the global logger
+ * blockLogger.setLevel(LogLevel.DEBUG);
+ * blockLogger.info('encrypt', { blockId: '0x123...', recipientCount: 1 });
+ *
+ * // Or create a custom logger
+ * const customLogger = new BlockLogger((entry) => {
+ *   // Custom output handling
+ *   myLoggingService.log(entry);
+ * });
+ * ```
+ */
+export * from './blockLogger';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,cAAc,eAAe,CAAC"}

package/src/lib/logging/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Logging Module for BrightChain
+ *
+ * This module exports logging utilities for block operations.
+ *
+ * @module logging
+ *
+ * @example
+ * ```typescript
+ * import { BlockLogger, LogLevel, blockLogger } from 'brightchain-lib';
+ *
+ * // Use the global logger
+ * blockLogger.setLevel(LogLevel.DEBUG);
+ * blockLogger.info('encrypt', { blockId: '0x123...', recipientCount: 1 });
+ *
+ * // Or create a custom logger
+ * const customLogger = new BlockLogger((entry) => {
+ *   // Custom output handling
+ *   myLoggingService.log(entry);
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./blockLogger"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/logging/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,wDAA8B"}

package/src/lib/logging/structuredLogger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Log levels for structured logging
+ */
+export declare enum LogLevel {
+    Debug = "DEBUG",
+    Info = "INFO",
+    Warning = "WARNING",
+    Error = "ERROR"
+}
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    timestamp: Date;
+    level: LogLevel;
+    operation: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+    error?: Error;
+}
+/**
+ * Structured logger for BrightChain operations
+ */
+export declare class StructuredLogger {
+    private static instance;
+    private logs;
+    private maxLogs;
+    private minLevel;
+    private constructor();
+    static getInstance(): StructuredLogger;
+    setLevel(level: LogLevel): void;
+    debug(operation: string, message: string, metadata?: Record<string, unknown>): void;
+    info(operation: string, message: string, metadata?: Record<string, unknown>): void;
+    warn(operation: string, message: string, metadata?: Record<string, unknown>): void;
+    error(operation: string, message: string, error?: Error, metadata?: Record<string, unknown>): void;
+    private log;
+    private shouldLog;
+    private output;
+    getLogs(limit?: number): LogEntry[];
+    clear(): void;
+}
+//# sourceMappingURL=structuredLogger.d.ts.map

package/src/lib/logging/structuredLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredLogger.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/logging/structuredLogger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAA2B;IAE3C,OAAO;WAEO,WAAW,IAAI,gBAAgB;IAOtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,KAAK,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAIA,IAAI,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAIA,IAAI,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAIA,KAAK,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAOP,OAAO,CAAC,GAAG;IAyBX,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,MAAM;IAeP,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;IAInC,KAAK,IAAI,IAAI;CAGrB"}