crewly 1.1.2 → 1.2.0

package/dist/backend/backend/src/services/whatsapp/whatsapp-initializer.js

@@ -0,0 +1,96 @@
+/**
+ * WhatsApp Initializer
+ *
+ * Handles automatic WhatsApp connection on application startup.
+ * Checks for environment variables and initializes if configured.
+ *
+ * @module services/whatsapp/initializer
+ */
+import { getWhatsAppService } from './whatsapp.service.js';
+import { getWhatsAppOrchestratorBridge } from './whatsapp-orchestrator-bridge.js';
+import { LoggerService } from '../core/logger.service.js';
+const logger = LoggerService.getInstance().createComponentLogger('WhatsAppInitializer');
+/**
+ * Check if WhatsApp is configured via environment variables.
+ *
+ * @returns True if WHATSAPP_ENABLED is set to 'true'
+ */
+export function isWhatsAppConfigured() {
+    return process.env.WHATSAPP_ENABLED === 'true';
+}
+/**
+ * Get WhatsApp configuration from environment variables.
+ *
+ * @returns WhatsAppConfig object or null if not configured
+ */
+export function getWhatsAppConfigFromEnv() {
+    if (!isWhatsAppConfigured()) {
+        return null;
+    }
+    return {
+        phoneNumber: process.env.WHATSAPP_PHONE_NUMBER,
+        authStatePath: process.env.WHATSAPP_AUTH_PATH,
+        allowedContacts: process.env.WHATSAPP_ALLOWED_CONTACTS?.split(',').filter(Boolean),
+    };
+}
+/**
+ * Initialize WhatsApp integration if configured via environment variables.
+ *
+ * This function is designed to be called during application startup.
+ * It safely handles cases where WhatsApp is not configured.
+ *
+ * @param options - Optional initialization options
+ * @returns Result object indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = await initializeWhatsAppIfConfigured({
+ *   messageQueueService: myService,
+ * });
+ * if (result.success) {
+ *   console.log('WhatsApp connected!');
+ * }
+ * ```
+ */
+export async function initializeWhatsAppIfConfigured(options) {
+    const config = getWhatsAppConfigFromEnv();
+    if (!config) {
+        logger.info('Not configured — skipping initialization');
+        return { attempted: false, success: false };
+    }
+    try {
+        const whatsappService = getWhatsAppService();
+        await whatsappService.initialize(config);
+        const bridge = getWhatsAppOrchestratorBridge();
+        if (options?.messageQueueService) {
+            bridge.setMessageQueueService(options.messageQueueService);
+        }
+        await bridge.initialize();
+        logger.info('Successfully initialized');
+        return { attempted: true, success: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Failed to initialize', { error: errorMessage });
+        return { attempted: true, success: false, error: errorMessage };
+    }
+}
+/**
+ * Gracefully shutdown WhatsApp integration.
+ * Call this during application shutdown to disconnect cleanly.
+ */
+export async function shutdownWhatsApp() {
+    try {
+        const whatsappService = getWhatsAppService();
+        if (whatsappService.isConnected()) {
+            await whatsappService.disconnect();
+            logger.info('Disconnected');
+        }
+    }
+    catch (error) {
+        logger.error('Error during shutdown', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=whatsapp-initializer.js.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-initializer.js.map

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

package/dist/backend/backend/src/services/whatsapp/whatsapp-orchestrator-bridge.d.ts

@@ -0,0 +1,109 @@
+/**
+ * WhatsApp-Orchestrator Bridge
+ *
+ * Routes messages between WhatsApp and the Crewly orchestrator,
+ * enabling mobile control of AI teams via WhatsApp.
+ *
+ * @module services/whatsapp/bridge
+ */
+import { EventEmitter } from 'events';
+import type { MessageQueueService } from '../messaging/message-queue.service.js';
+/**
+ * Bridge configuration
+ */
+export interface WhatsAppBridgeConfig {
+    /** Orchestrator session name */
+    orchestratorSession: string;
+    /** Maximum response length before truncation */
+    maxResponseLength: number;
+    /** Response timeout in ms */
+    responseTimeoutMs: number;
+}
+/**
+ * WhatsAppOrchestratorBridge class
+ *
+ * Routes messages between WhatsApp and the Crewly orchestrator.
+ * Mirrors the SlackOrchestratorBridge pattern with WhatsApp-specific handling.
+ *
+ * @example
+ * ```typescript
+ * const bridge = getWhatsAppOrchestratorBridge();
+ * await bridge.initialize();
+ * ```
+ */
+export declare class WhatsAppOrchestratorBridge extends EventEmitter {
+    private logger;
+    private whatsappService;
+    private chatService;
+    private messageQueueService;
+    private config;
+    private initialized;
+    private boundMessageHandler;
+    /**
+     * Create a new WhatsAppOrchestratorBridge
+     *
+     * @param config - Partial configuration to override defaults
+     */
+    constructor(config?: Partial<WhatsAppBridgeConfig>);
+    /**
+     * Initialize the bridge.
+     * Sets up message listeners for WhatsApp incoming messages.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if bridge is initialized
+     *
+     * @returns True if initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Set the message queue service for enqueuing messages to the orchestrator.
+     *
+     * @param service - The MessageQueueService instance
+     */
+    setMessageQueueService(service: MessageQueueService): void;
+    /**
+     * Get current configuration
+     *
+     * @returns A copy of the current configuration
+     */
+    getConfig(): WhatsAppBridgeConfig;
+    /**
+     * Handle incoming WhatsApp message.
+     * Routes the message to the orchestrator and sends the response back.
+     *
+     * @param message - Incoming WhatsApp message
+     */
+    private handleWhatsAppMessage;
+    /**
+     * Send message to orchestrator via the message queue and wait for response.
+     *
+     * @param message - Message text to send
+     * @param context - Conversation context
+     * @returns Orchestrator response or offline/error message
+     */
+    private sendToOrchestrator;
+    /**
+     * Cleanup bridge resources.
+     * Removes only this bridge's event listener and resets initialization state.
+     */
+    cleanup(): void;
+    /**
+     * Send a text response back to a WhatsApp chat.
+     *
+     * @param chatId - Destination chat JID
+     * @param text - Response text
+     */
+    sendWhatsAppResponse(chatId: string, text: string): Promise<void>;
+}
+/**
+ * Get WhatsApp bridge singleton
+ *
+ * @returns WhatsAppOrchestratorBridge instance
+ */
+export declare function getWhatsAppOrchestratorBridge(): WhatsAppOrchestratorBridge;
+/**
+ * Reset WhatsApp bridge singleton (for testing)
+ */
+export declare function resetWhatsAppOrchestratorBridge(): void;
+//# sourceMappingURL=whatsapp-orchestrator-bridge.d.ts.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-orchestrator-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-orchestrator-bridge.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/whatsapp/whatsapp-orchestrator-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAIjF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAcD;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;IAC1D,OAAO,CAAC,MAAM,CAAuE;IACrF,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,mBAAmB,CAAsE;IAEjG;;;;OAIG;gBACS,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAOtD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;IACH,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1D;;;;OAIG;IACH,SAAS,IAAI,oBAAoB;IAIjC;;;;;OAKG;YACW,qBAAqB;IAiCnC;;;;;;OAMG;YACW,kBAAkB;IAgEhC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAQf;;;;;OAKG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYxE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,0BAA0B,CAK1E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}

package/dist/backend/backend/src/services/whatsapp/whatsapp-orchestrator-bridge.js

@@ -0,0 +1,234 @@
+/**
+ * WhatsApp-Orchestrator Bridge
+ *
+ * Routes messages between WhatsApp and the Crewly orchestrator,
+ * enabling mobile control of AI teams via WhatsApp.
+ *
+ * @module services/whatsapp/bridge
+ */
+import { EventEmitter } from 'events';
+import { getWhatsAppService } from './whatsapp.service.js';
+import { getChatService } from '../chat/chat.service.js';
+import { isOrchestratorActive, getOrchestratorOfflineMessage, } from '../orchestrator/index.js';
+import { ORCHESTRATOR_SESSION_NAME, MESSAGE_QUEUE_CONSTANTS, WHATSAPP_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+/**
+ * Default bridge configuration
+ */
+const DEFAULT_CONFIG = {
+    orchestratorSession: ORCHESTRATOR_SESSION_NAME,
+    maxResponseLength: WHATSAPP_CONSTANTS.MAX_RESPONSE_LENGTH,
+    responseTimeoutMs: (MESSAGE_QUEUE_CONSTANTS?.DEFAULT_MESSAGE_TIMEOUT ?? WHATSAPP_CONSTANTS.DEFAULT_FALLBACK_TIMEOUT_MS) + WHATSAPP_CONSTANTS.RESPONSE_TIMEOUT_BUFFER_MS,
+};
+/** WhatsApp bridge singleton */
+let bridgeInstance = null;
+/**
+ * WhatsAppOrchestratorBridge class
+ *
+ * Routes messages between WhatsApp and the Crewly orchestrator.
+ * Mirrors the SlackOrchestratorBridge pattern with WhatsApp-specific handling.
+ *
+ * @example
+ * ```typescript
+ * const bridge = getWhatsAppOrchestratorBridge();
+ * await bridge.initialize();
+ * ```
+ */
+export class WhatsAppOrchestratorBridge extends EventEmitter {
+    logger = LoggerService.getInstance().createComponentLogger('WhatsAppBridge');
+    whatsappService;
+    chatService;
+    messageQueueService = null;
+    config;
+    initialized = false;
+    boundMessageHandler = null;
+    /**
+     * Create a new WhatsAppOrchestratorBridge
+     *
+     * @param config - Partial configuration to override defaults
+     */
+    constructor(config = {}) {
+        super();
+        this.whatsappService = getWhatsAppService();
+        this.chatService = getChatService();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize the bridge.
+     * Sets up message listeners for WhatsApp incoming messages.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        this.boundMessageHandler = this.handleWhatsAppMessage.bind(this);
+        this.whatsappService.on('message', this.boundMessageHandler);
+        this.initialized = true;
+        this.logger.info('Initialized');
+    }
+    /**
+     * Check if bridge is initialized
+     *
+     * @returns True if initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Set the message queue service for enqueuing messages to the orchestrator.
+     *
+     * @param service - The MessageQueueService instance
+     */
+    setMessageQueueService(service) {
+        this.messageQueueService = service;
+    }
+    /**
+     * Get current configuration
+     *
+     * @returns A copy of the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Handle incoming WhatsApp message.
+     * Routes the message to the orchestrator and sends the response back.
+     *
+     * @param message - Incoming WhatsApp message
+     */
+    async handleWhatsAppMessage(message) {
+        this.logger.info('Received message', {
+            from: message.contactName || message.from,
+            preview: message.text.substring(0, 50),
+        });
+        try {
+            const context = this.whatsappService.getConversationContext(message.chatId, message.contactName || message.from);
+            const response = await this.sendToOrchestrator(message.text, context);
+            await this.sendWhatsAppResponse(message.chatId, response);
+            this.emit('message_handled', { message, response });
+        }
+        catch (error) {
+            this.logger.error('Error handling message', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            try {
+                await this.sendWhatsAppResponse(message.chatId, `Sorry, I encountered an error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            catch {
+                // Silent fail on error response
+            }
+            this.emit('error', error);
+        }
+    }
+    /**
+     * Send message to orchestrator via the message queue and wait for response.
+     *
+     * @param message - Message text to send
+     * @param context - Conversation context
+     * @returns Orchestrator response or offline/error message
+     */
+    async sendToOrchestrator(message, context) {
+        try {
+            const isActive = await isOrchestratorActive();
+            if (!isActive) {
+                this.logger.info('Orchestrator is not active, returning offline message');
+                return getOrchestratorOfflineMessage(true);
+            }
+            // Capture reference to avoid race condition with non-null assertion
+            const mqService = this.messageQueueService;
+            if (!mqService) {
+                this.logger.error('Message queue service not configured');
+                return 'The WhatsApp bridge is not properly configured. Please restart the server.';
+            }
+            // Store message in chat service
+            const result = await this.chatService.sendMessage({
+                content: message,
+                conversationId: context?.conversationId,
+                metadata: {
+                    source: 'whatsapp',
+                    chatId: context?.chatId,
+                    contactName: context?.contactName,
+                },
+            });
+            // Enqueue with a resolve callback for response routing
+            const response = await new Promise((resolve) => {
+                const timeoutId = setTimeout(() => {
+                    resolve('The orchestrator is taking longer than expected. Please try again.');
+                }, this.config.responseTimeoutMs);
+                try {
+                    mqService.enqueue({
+                        content: message,
+                        conversationId: result.conversation.id,
+                        source: 'whatsapp',
+                        sourceMetadata: {
+                            whatsappResolve: (resp) => {
+                                clearTimeout(timeoutId);
+                                resolve(resp);
+                            },
+                            chatId: context?.chatId,
+                            contactName: context?.contactName,
+                        },
+                    });
+                }
+                catch (enqueueErr) {
+                    clearTimeout(timeoutId);
+                    resolve(`Failed to enqueue message: ${enqueueErr instanceof Error ? enqueueErr.message : String(enqueueErr)}`);
+                }
+            });
+            return response;
+        }
+        catch (error) {
+            this.logger.error('Error sending to orchestrator', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Cleanup bridge resources.
+     * Removes only this bridge's event listener and resets initialization state.
+     */
+    cleanup() {
+        if (this.boundMessageHandler) {
+            this.whatsappService.removeListener('message', this.boundMessageHandler);
+            this.boundMessageHandler = null;
+        }
+        this.initialized = false;
+    }
+    /**
+     * Send a text response back to a WhatsApp chat.
+     *
+     * @param chatId - Destination chat JID
+     * @param text - Response text
+     */
+    async sendWhatsAppResponse(chatId, text) {
+        const trimmed = text?.trim();
+        if (!trimmed)
+            return;
+        try {
+            await this.whatsappService.sendMessage({ to: chatId, text: trimmed });
+        }
+        catch (err) {
+            this.logger.error('Failed to send WhatsApp response', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+/**
+ * Get WhatsApp bridge singleton
+ *
+ * @returns WhatsAppOrchestratorBridge instance
+ */
+export function getWhatsAppOrchestratorBridge() {
+    if (!bridgeInstance) {
+        bridgeInstance = new WhatsAppOrchestratorBridge();
+    }
+    return bridgeInstance;
+}
+/**
+ * Reset WhatsApp bridge singleton (for testing)
+ */
+export function resetWhatsAppOrchestratorBridge() {
+    bridgeInstance = null;
+}
+//# sourceMappingURL=whatsapp-orchestrator-bridge.js.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-orchestrator-bridge.js.map

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

package/dist/backend/backend/src/services/whatsapp/whatsapp.service.d.ts

@@ -0,0 +1,127 @@
+/**
+ * WhatsApp Service
+ *
+ * Manages WhatsApp connection via Baileys (WhatsApp Web multi-device protocol).
+ * Handles QR code pairing, auth state persistence, and bidirectional messaging.
+ *
+ * @module services/whatsapp
+ */
+import { EventEmitter } from 'events';
+import type { WhatsAppConfig, WhatsAppIncomingMessage, WhatsAppOutgoingMessage, WhatsAppServiceStatus, WhatsAppConversationContext } from '../../types/whatsapp.types.js';
+/**
+ * Events emitted by WhatsAppService
+ */
+export interface WhatsAppServiceEvents {
+    message: (message: WhatsAppIncomingMessage) => void;
+    qr: (qrCode: string) => void;
+    connected: () => void;
+    disconnected: (reason?: string) => void;
+    error: (error: Error) => void;
+}
+/**
+ * WhatsApp Service singleton
+ *
+ * Manages the Baileys WebSocket connection, QR pairing flow,
+ * and message send/receive lifecycle.
+ *
+ * @example
+ * ```typescript
+ * const service = getWhatsAppService();
+ * await service.initialize({ allowedContacts: ['+1234567890'] });
+ * service.on('message', (msg) => console.log(msg.text));
+ * ```
+ */
+export declare class WhatsAppService extends EventEmitter {
+    private logger;
+    private sock;
+    private config;
+    private connected;
+    private currentQrCode;
+    private messagesSent;
+    private messagesReceived;
+    private phoneNumber;
+    private conversationContexts;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private static readonly MAX_RECONNECT_DELAY_MS;
+    private static readonly MAX_RECONNECT_ATTEMPTS;
+    /**
+     * Initialize the WhatsApp connection.
+     * Sets up Baileys socket, auth state persistence, and event handlers.
+     *
+     * @param config - WhatsApp configuration
+     */
+    initialize(config: WhatsAppConfig): Promise<void>;
+    /**
+     * Process an incoming Baileys message and emit as WhatsAppIncomingMessage.
+     *
+     * Extracts text from various WhatsApp message types (conversation, extendedTextMessage),
+     * validates the sender against the allowed contacts list, and emits a normalized
+     * message event for the bridge to handle.
+     *
+     * Messages are silently ignored if:
+     * - Sent by this account (fromMe = true)
+     * - No text content present (images, stickers, etc.)
+     * - Sender not in allowedContacts list (when configured)
+     *
+     * @param rawMsg - Raw Baileys message object containing key, message content, and metadata
+     */
+    private handleIncomingMessage;
+    /**
+     * Send a text message via WhatsApp.
+     *
+     * @param msg - Outgoing message with destination and text
+     * @throws Error if not connected or message too long
+     */
+    sendMessage(msg: WhatsAppOutgoingMessage): Promise<void>;
+    /**
+     * Send a file (document) via WhatsApp.
+     *
+     * @param chatId - Destination chat JID
+     * @param filePath - Absolute path to the file on disk
+     * @param caption - Optional caption for the file
+     * @throws Error if not connected or file too large
+     */
+    sendFile(chatId: string, filePath: string, caption?: string): Promise<void>;
+    /**
+     * Disconnect from WhatsApp gracefully.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current connection status.
+     *
+     * @returns WhatsApp service status object
+     */
+    getStatus(): WhatsAppServiceStatus;
+    /**
+     * Check if WhatsApp is currently connected.
+     *
+     * @returns True if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the current QR code for pairing.
+     *
+     * @returns QR code string or null if not pending
+     */
+    getQRCode(): string | null;
+    /**
+     * Get or create a conversation context for a chat.
+     *
+     * @param chatId - Chat JID
+     * @param contactName - Contact display name
+     * @returns Conversation context for message routing
+     */
+    getConversationContext(chatId: string, contactName: string): WhatsAppConversationContext;
+}
+/**
+ * Get WhatsApp service singleton
+ *
+ * @returns WhatsAppService instance
+ */
+export declare function getWhatsAppService(): WhatsAppService;
+/**
+ * Reset WhatsApp service singleton (for testing)
+ */
+export declare function resetWhatsAppService(): void;
+//# sourceMappingURL=whatsapp.service.d.ts.map

package/dist/backend/backend/src/services/whatsapp/whatsapp.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/whatsapp/whatsapp.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,+BAA+B,CAAC;AAKvC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACpD,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAaD;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAwE;IACtF,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,oBAAoB,CAAuD;IACnF,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAM;IAEpD;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA4HvD;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,qBAAqB;IAkD7B;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;;;;;OAOG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC;;;;OAIG;IACH,SAAS,IAAI,qBAAqB;IAUlC;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B;;;;;;OAMG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,2BAA2B;CAczF;AAKD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}