@easyling/sanity-connector 0.0.1

package/dist/utils/logger.js

@@ -0,0 +1,229 @@
+/**
+ * Logging utilities with structured output
+ * Requirements: 4.3 - Clear error messages and structured logging
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    constructor(config = {}) {
+        this.config = {
+            level: LogLevel.INFO,
+            enableConsole: true,
+            enableStructuredOutput: true,
+            ...config
+        };
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        this.log(LogLevel.DEBUG, message, context);
+    }
+    /**
+     * Log info message
+     */
+    info(message, context) {
+        this.log(LogLevel.INFO, message, context);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        this.log(LogLevel.WARN, message, context);
+    }
+    /**
+     * Log error message
+     * Requirement 4.3: Display clear error messages
+     */
+    error(message, error, context) {
+        this.log(LogLevel.ERROR, message, context, error);
+    }
+    /**
+     * Log translation request with structured format
+     * Requirements: 1.3, 2.4 - Log request body to console for verification
+     */
+    logTranslationRequest(documentId, endpoint, payload) {
+        this.info('Translation request prepared', {
+            documentId,
+            endpoint,
+            payloadSize: JSON.stringify(payload).length,
+            contentLength: payload.content?.body?.length || 0,
+            title: payload.metadata?.title || 'Unknown',
+            documentType: payload.metadata?.documentType || 'Unknown'
+        });
+        if (this.config.enableStructuredOutput) {
+            console.log('Translation Request Payload:', {
+                timestamp: new Date().toISOString(),
+                documentId,
+                endpoint,
+                payload
+            });
+        }
+    }
+    /**
+     * Log bulk translation summary
+     * Requirement 2.5: Display summary of processed documents
+     */
+    logBulkTranslationSummary(summary) {
+        const successRate = summary.totalDocuments > 0
+            ? ((summary.processedDocuments / summary.totalDocuments) * 100).toFixed(2)
+            : '0';
+        this.info('Bulk translation completed', {
+            totalDocuments: summary.totalDocuments,
+            processedDocuments: summary.processedDocuments,
+            failedDocuments: summary.failedDocuments,
+            successRate: `${successRate}%`,
+            duration: summary.duration ? `${summary.duration}ms` : undefined
+        });
+    }
+    /**
+     * Log document processing progress
+     */
+    logProgress(current, total, documentId) {
+        const percentage = total > 0 ? ((current / total) * 100).toFixed(1) : '0';
+        this.debug(`Processing progress: ${current}/${total} (${percentage}%)`, {
+            current,
+            total,
+            percentage: `${percentage}%`,
+            documentId
+        });
+    }
+    /**
+     * Log validation errors
+     * Requirement 4.3: Clear error messages for validation failures
+     */
+    logValidationError(type, errors, context) {
+        this.error(`Validation failed for ${type}`, undefined, {
+            validationType: type,
+            errors,
+            errorCount: errors.length,
+            ...context
+        });
+    }
+    /**
+     * Log performance metrics
+     */
+    logPerformance(operation, duration, context) {
+        this.info(`Performance: ${operation}`, {
+            operation,
+            duration: `${duration}ms`,
+            ...context
+        });
+    }
+    /**
+     * Core logging method
+     */
+    log(level, message, context, error) {
+        if (level < this.config.level) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message: this.config.prefix ? `[${this.config.prefix}] ${message}` : message,
+            context,
+            error
+        };
+        if (this.config.enableConsole) {
+            this.outputToConsole(entry);
+        }
+    }
+    /**
+     * Output log entry to console with appropriate formatting
+     */
+    outputToConsole(entry) {
+        const levelName = LogLevel[entry.level];
+        const timestamp = entry.timestamp;
+        if (this.config.enableStructuredOutput) {
+            // Structured output for debugging
+            const logData = {
+                timestamp,
+                level: levelName,
+                message: entry.message,
+                ...(entry.context && { context: entry.context }),
+                ...(entry.error && { error: this.serializeError(entry.error) })
+            };
+            switch (entry.level) {
+                case LogLevel.DEBUG:
+                    console.debug('🔍', logData);
+                    break;
+                case LogLevel.INFO:
+                    console.info('ℹ️', logData);
+                    break;
+                case LogLevel.WARN:
+                    console.warn('⚠️', logData);
+                    break;
+                case LogLevel.ERROR:
+                    console.error('❌', logData);
+                    break;
+            }
+        }
+        else {
+            // Simple console output
+            const contextStr = entry.context ? ` ${JSON.stringify(entry.context)}` : '';
+            const errorStr = entry.error ? ` Error: ${entry.error.message}` : '';
+            switch (entry.level) {
+                case LogLevel.DEBUG:
+                    console.debug(`[${timestamp}] DEBUG: ${entry.message}${contextStr}${errorStr}`);
+                    break;
+                case LogLevel.INFO:
+                    console.info(`[${timestamp}] INFO: ${entry.message}${contextStr}${errorStr}`);
+                    break;
+                case LogLevel.WARN:
+                    console.warn(`[${timestamp}] WARN: ${entry.message}${contextStr}${errorStr}`);
+                    break;
+                case LogLevel.ERROR:
+                    console.error(`[${timestamp}] ERROR: ${entry.message}${contextStr}${errorStr}`);
+                    if (entry.error && entry.error.stack) {
+                        console.error(entry.error.stack);
+                    }
+                    break;
+            }
+        }
+    }
+    /**
+     * Serialize error object for logging
+     */
+    serializeError(error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+            ...(error.cause ? { cause: error.cause } : {})
+        };
+    }
+    /**
+     * Update logger configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+// Create default logger instance
+export const defaultLogger = new Logger({
+    prefix: 'SanityTranslation'
+});
+// Export convenience functions for backward compatibility
+export const logger = {
+    debug: (message, context) => defaultLogger.debug(message, context),
+    info: (message, context) => defaultLogger.info(message, context),
+    warn: (message, context) => defaultLogger.warn(message, context),
+    error: (message, error, context) => defaultLogger.error(message, error, context),
+    logTranslationRequest: (documentId, endpoint, payload) => defaultLogger.logTranslationRequest(documentId, endpoint, payload),
+    logBulkTranslationSummary: (summary) => defaultLogger.logBulkTranslationSummary(summary),
+    logProgress: (current, total, documentId) => defaultLogger.logProgress(current, total, documentId),
+    logValidationError: (type, errors, context) => defaultLogger.logValidationError(type, errors, context),
+    logPerformance: (operation, duration, context) => defaultLogger.logPerformance(operation, duration, context)
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/oauthErrorFeedback.d.ts

@@ -0,0 +1,76 @@
+/**
+ * OAuth Error Feedback Utility
+ *
+ * Provides user-friendly error feedback for OAuth authentication errors
+ * using Sanity UI toast notifications and dialogs.
+ *
+ * Requirements: 7.2, 7.3, 7.4
+ */
+import { OAuthError, OAuthErrorType } from '../types/oauth';
+import { DialogService } from '../services/dialogService';
+/**
+ * OAuth Error Feedback Handler
+ *
+ * Provides methods for displaying user-friendly error messages
+ * with appropriate help text and retry options.
+ */
+export declare class OAuthErrorFeedback {
+    private dialogService;
+    /**
+     * Create a new OAuth error feedback handler
+     *
+     * @param dialogService - Dialog service instance
+     */
+    constructor(dialogService: DialogService);
+    /**
+     * Show an error dialog for an OAuth error
+     *
+     * Requirements: 7.2, 7.3, 7.4
+     *
+     * @param error - OAuth error to display
+     * @param onRetry - Optional callback for retry action
+     * @returns Promise that resolves to true if user clicked retry, false otherwise
+     */
+    showError(error: OAuthError, onRetry?: () => void): Promise<boolean>;
+    /**
+     * Show an error dialog for a generic error
+     *
+     * Requirements: 7.2, 7.3
+     *
+     * @param message - Error message to display
+     * @param details - Optional additional details
+     * @param showRetry - Whether to show retry button
+     * @param onRetry - Optional callback for retry action
+     * @returns Promise that resolves to true if user clicked retry, false otherwise
+     */
+    showGenericError(message: string, details?: string, showRetry?: boolean, onRetry?: () => void): Promise<boolean>;
+    /**
+     * Show a success message
+     *
+     * @param message - Success message to display
+     * @param details - Optional additional details
+     */
+    showSuccess(message: string, details?: string): void;
+    /**
+     * Get help text for a specific error type
+     *
+     * @param errorType - OAuth error type
+     * @returns Help text for the error type
+     */
+    getHelpText(errorType: OAuthErrorType): string;
+    /**
+     * Format an error for logging (sanitizes sensitive data)
+     *
+     * @param error - Error to format
+     * @returns Formatted error object safe for logging
+     */
+    formatErrorForLogging(error: OAuthError): Record<string, unknown>;
+}
+/**
+ * Create an OAuth error feedback handler
+ *
+ * @param dialogService - Dialog service instance
+ * @returns OAuth error feedback handler
+ */
+export declare function createOAuthErrorFeedback(dialogService: DialogService): OAuthErrorFeedback;
+//# sourceMappingURL=oauthErrorFeedback.d.ts.map

package/dist/utils/oauthErrorFeedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthErrorFeedback.d.ts","sourceRoot":"","sources":["../../src/utils/oauthErrorFeedback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAmB1D;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAgB;IAErC;;;;OAIG;gBACS,aAAa,EAAE,aAAa;IAIxC;;;;;;;;OAQG;IACG,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB1E;;;;;;;;;;OAUG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,GAAE,OAAc,EACzB,OAAO,CAAC,EAAE,MAAM,IAAI,GACnB,OAAO,CAAC,OAAO,CAAC;IAkBnB;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAUpD;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM;IAI9C;;;;;OAKG;IACH,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,aAAa,GAAG,kBAAkB,CAEzF"}

package/dist/utils/oauthErrorFeedback.js

@@ -0,0 +1,134 @@
+/**
+ * OAuth Error Feedback Utility
+ *
+ * Provides user-friendly error feedback for OAuth authentication errors
+ * using Sanity UI toast notifications and dialogs.
+ *
+ * Requirements: 7.2, 7.3, 7.4
+ */
+import { OAuthErrorType } from '../types/oauth';
+/**
+ * Error help text for common authentication error scenarios
+ */
+const ERROR_HELP_TEXT = {
+    [OAuthErrorType.INVALID_CONFIG]: 'Please check your Easyling configuration. Make sure your access token and project ID are correct.',
+    [OAuthErrorType.NETWORK_ERROR]: 'Please check your internet connection and try again. If the problem persists, the service may be temporarily unavailable.',
+    [OAuthErrorType.AUTH_FAILED]: 'Authentication failed. Please check your access token in the Easyling Configuration.',
+    [OAuthErrorType.STORAGE_ERROR]: 'There was a problem saving your authentication data. Please check your browser settings and try again.'
+};
+/**
+ * OAuth Error Feedback Handler
+ *
+ * Provides methods for displaying user-friendly error messages
+ * with appropriate help text and retry options.
+ */
+export class OAuthErrorFeedback {
+    /**
+     * Create a new OAuth error feedback handler
+     *
+     * @param dialogService - Dialog service instance
+     */
+    constructor(dialogService) {
+        this.dialogService = dialogService;
+    }
+    /**
+     * Show an error dialog for an OAuth error
+     *
+     * Requirements: 7.2, 7.3, 7.4
+     *
+     * @param error - OAuth error to display
+     * @param onRetry - Optional callback for retry action
+     * @returns Promise that resolves to true if user clicked retry, false otherwise
+     */
+    async showError(error, onRetry) {
+        const userMessage = error.getUserMessage();
+        const helpText = ERROR_HELP_TEXT[error.type] || 'Please try again.';
+        const isRecoverable = error.isRecoverable();
+        // Combine user message and help text
+        const fullMessage = `${userMessage}\n\n${helpText}`;
+        const result = await this.dialogService.showError({
+            title: 'Authentication Error',
+            message: fullMessage,
+            showRetry: isRecoverable
+        });
+        // If user clicked retry and callback provided, call it
+        if (result && onRetry) {
+            onRetry();
+        }
+        return result;
+    }
+    /**
+     * Show an error dialog for a generic error
+     *
+     * Requirements: 7.2, 7.3
+     *
+     * @param message - Error message to display
+     * @param details - Optional additional details
+     * @param showRetry - Whether to show retry button
+     * @param onRetry - Optional callback for retry action
+     * @returns Promise that resolves to true if user clicked retry, false otherwise
+     */
+    async showGenericError(message, details, showRetry = true, onRetry) {
+        // Combine message and details if provided
+        const fullMessage = details ? `${message}\n\n${details}` : message;
+        const result = await this.dialogService.showError({
+            title: 'Error',
+            message: fullMessage,
+            showRetry
+        });
+        // If user clicked retry and callback provided, call it
+        if (result && onRetry) {
+            onRetry();
+        }
+        return result;
+    }
+    /**
+     * Show a success message
+     *
+     * @param message - Success message to display
+     * @param details - Optional additional details
+     */
+    showSuccess(message, details) {
+        // Combine message and details if provided
+        const fullMessage = details ? `${message}\n\n${details}` : message;
+        this.dialogService.showSuccess({
+            title: 'Success',
+            message: fullMessage
+        });
+    }
+    /**
+     * Get help text for a specific error type
+     *
+     * @param errorType - OAuth error type
+     * @returns Help text for the error type
+     */
+    getHelpText(errorType) {
+        return ERROR_HELP_TEXT[errorType] || 'Please try again.';
+    }
+    /**
+     * Format an error for logging (sanitizes sensitive data)
+     *
+     * @param error - Error to format
+     * @returns Formatted error object safe for logging
+     */
+    formatErrorForLogging(error) {
+        return {
+            type: error.type,
+            message: error.message,
+            name: error.name,
+            isRecoverable: error.isRecoverable(),
+            // Don't include details as they might contain sensitive data
+            hasDetails: !!error.details
+        };
+    }
+}
+/**
+ * Create an OAuth error feedback handler
+ *
+ * @param dialogService - Dialog service instance
+ * @returns OAuth error feedback handler
+ */
+export function createOAuthErrorFeedback(dialogService) {
+    return new OAuthErrorFeedback(dialogService);
+}
+//# sourceMappingURL=oauthErrorFeedback.js.map

package/dist/utils/oauthErrorFeedback.js.map

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

package/dist/utils/oauthLogger.d.ts

@@ -0,0 +1,176 @@
+/**
+ * OAuth Logger Utility
+ *
+ * Provides structured logging for OAuth authentication events with timestamps
+ * and component identification. Never logs sensitive data like tokens or secrets.
+ *
+ * Requirements: 7.1, 8.5
+ */
+/**
+ * Log level enumeration
+ */
+export declare enum LogLevel {
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * OAuth component identifier
+ */
+export type OAuthComponent = 'OAuthService' | 'TokenStorage' | 'AuthStateManager' | 'OAuthCallback' | 'AuthStatus' | 'TranslationService';
+/**
+ * OAuth log entry structure
+ */
+export interface OAuthLogEntry {
+    /** ISO timestamp of the log entry */
+    timestamp: string;
+    /** Log level */
+    level: LogLevel;
+    /** Component that generated the log */
+    component: OAuthComponent;
+    /** Event name or description */
+    event: string;
+    /** Optional additional details (never contains sensitive data) */
+    details?: Record<string, unknown>;
+}
+/**
+ * OAuth Logger
+ *
+ * Provides structured logging methods for OAuth-related events.
+ * Automatically sanitizes sensitive data from log output.
+ */
+export declare class OAuthLogger {
+    private component;
+    /**
+     * Create a new OAuth logger for a specific component
+     *
+     * @param component - Component identifier
+     */
+    constructor(component: OAuthComponent);
+    /**
+     * Sanitize details object to remove sensitive data
+     *
+     * @param details - Details object to sanitize
+     * @returns Sanitized details object
+     */
+    private sanitizeDetails;
+    /**
+     * Create a log entry
+     *
+     * @param level - Log level
+     * @param event - Event name
+     * @param details - Optional details
+     * @returns OAuth log entry
+     */
+    private createLogEntry;
+    /**
+     * Format log entry for console output
+     *
+     * @param entry - OAuth log entry to format
+     * @returns Formatted log message
+     */
+    private formatLogEntry;
+    /**
+     * Log an info-level event
+     *
+     * @param event - Event name
+     * @param details - Optional details
+     */
+    info(event: string, details?: Record<string, unknown>): void;
+    /**
+     * Log a warning-level event
+     *
+     * @param event - Event name
+     * @param details - Optional details
+     */
+    warn(event: string, details?: Record<string, unknown>): void;
+    /**
+     * Log an error-level event
+     *
+     * @param event - Event name
+     * @param details - Optional details
+     */
+    error(event: string, details?: Record<string, unknown>): void;
+    /**
+     * Log OAuth flow initiation
+     *
+     * @param authUrl - Authorization URL (without sensitive params)
+     */
+    logFlowInitiation(authUrl: string): void;
+    /**
+     * Log OAuth callback received
+     *
+     * @param hasCode - Whether authorization code was received
+     * @param hasError - Whether error was received
+     * @param projectId - Project ID if available
+     */
+    logCallbackReceived(hasCode: boolean, hasError: boolean, projectId?: string): void;
+    /**
+     * Log token exchange attempt
+     */
+    logTokenExchange(): void;
+    /**
+     * Log token exchange success
+     *
+     * @param expiresIn - Token expiration time in seconds
+     * @param hasRefreshToken - Whether refresh token was received
+     */
+    logTokenExchangeSuccess(expiresIn: number, hasRefreshToken: boolean): void;
+    /**
+     * Log token exchange failure
+     *
+     * @param error - Error message
+     * @param statusCode - HTTP status code if available
+     */
+    logTokenExchangeFailure(error: string, statusCode?: number): void;
+    /**
+     * Log token refresh attempt
+     */
+    logTokenRefresh(): void;
+    /**
+     * Log token refresh success
+     *
+     * @param expiresIn - New token expiration time in seconds
+     */
+    logTokenRefreshSuccess(expiresIn: number): void;
+    /**
+     * Log token refresh failure
+     *
+     * @param error - Error message
+     */
+    logTokenRefreshFailure(error: string): void;
+    /**
+     * Log authentication state change
+     *
+     * @param fromState - Previous state
+     * @param toState - New state
+     * @param projectId - Project ID if available
+     */
+    logStateChange(fromState: string, toState: string, projectId?: string): void;
+    /**
+     * Log logout event
+     */
+    logLogout(): void;
+    /**
+     * Log storage operation
+     *
+     * @param operation - Operation type (store, retrieve, clear)
+     * @param success - Whether operation succeeded
+     */
+    logStorageOperation(operation: 'store' | 'retrieve' | 'clear', success: boolean): void;
+    /**
+     * Sanitize URL to remove sensitive query parameters
+     *
+     * @param url - URL to sanitize
+     * @returns Sanitized URL string
+     */
+    private sanitizeUrl;
+}
+/**
+ * Create a logger instance for a specific component
+ *
+ * @param component - Component identifier
+ * @returns Logger instance
+ */
+export declare function createOAuthLogger(component: OAuthComponent): OAuthLogger;
+//# sourceMappingURL=oauthLogger.d.ts.map

package/dist/utils/oauthLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthLogger.d.ts","sourceRoot":"","sources":["../../src/utils/oauthLogger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,oBAAoB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,gBAAgB;IAChB,KAAK,EAAE,QAAQ,CAAC;IAEhB,uCAAuC;IACvC,SAAS,EAAE,cAAc,CAAC;IAE1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAqBD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAiB;IAElC;;;;OAIG;gBACS,SAAS,EAAE,cAAc;IAIrC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IActB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK5D;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK5D;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK7D;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMxC;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQlF;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;;;;OAKG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAG,IAAI;IAO1E;;;;;OAKG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAOjE;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM/C;;;;OAIG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3C;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ5E;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQtF;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAiBpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,WAAW,CAExE"}