@bernierllc/email-sender-manager 1.0.1

package/dist/manager.js

@@ -0,0 +1,469 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+import { SenderBootstrap } from './database/bootstrap.js';
+import { SenderSelector } from './selection/selector.js';
+import { extractDomain } from './utils/domain-utils.js';
+import { validateCreateSenderRequest, validateSenderConfiguration, } from './utils/validation-utils.js';
+export class EmailSenderManager {
+    database;
+    providers = new Map();
+    bootstrap;
+    selector;
+    bootstrapConfig;
+    // @ts-expect-error - Reserved for future validation features
+    validationConfig;
+    selectionConfig;
+    systemUser;
+    constructor(config) {
+        this.database = config.database;
+        this.systemUser = config.systemUser ?? 'system';
+        // Initialize configurations with defaults
+        this.bootstrapConfig = {
+            enabled: false,
+            createTables: false,
+            seedDefaultSenders: false,
+            defaultSenders: [],
+            environment: 'production',
+            ...config.bootstrap,
+        };
+        this.validationConfig = {
+            requireVerification: false,
+            allowUnverifiedSenders: true,
+            validateDomainOwnership: false,
+            ...config.validation,
+        };
+        this.selectionConfig = {
+            strategy: 'priority',
+            fallbackToDefault: true,
+            domainMatchingRules: [],
+            ...config.selection,
+        };
+        // Initialize bootstrap system
+        this.bootstrap = new SenderBootstrap(this.database, this.bootstrapConfig);
+        // Initialize selector
+        this.selector = new SenderSelector(this.selectionConfig);
+        // Register providers
+        if (config.providers) {
+            for (const provider of config.providers) {
+                this.providers.set(provider.providerId, provider);
+            }
+        }
+    }
+    /**
+     * Bootstrap database and seed default senders
+     */
+    async bootstrapDatabase() {
+        if (!this.bootstrapConfig.enabled) {
+            return {
+                success: false,
+                tablesCreated: false,
+                seedersRun: 0,
+                message: 'Bootstrap is not enabled in configuration',
+            };
+        }
+        return await this.bootstrap.bootstrap();
+    }
+    /**
+     * Create a new sender configuration
+     */
+    async createSender(request) {
+        // Validate request
+        const validation = validateCreateSenderRequest(request);
+        if (validation.errors.length > 0) {
+            throw new Error(`Validation failed: ${validation.errors.map((e) => e.message).join(', ')}`);
+        }
+        // Validate domain configuration
+        const domainValidation = validateSenderConfiguration(request.fromEmail, request.allowedDomains);
+        if (!domainValidation.valid) {
+            throw new Error(`Domain validation failed: ${domainValidation.errors.map((e) => e.message).join(', ')}`);
+        }
+        const id = this.generateId();
+        const domain = extractDomain(request.fromEmail);
+        const now = new Date();
+        const sender = {
+            id,
+            name: request.name,
+            ...(request.description !== undefined && { description: request.description }),
+            fromEmail: request.fromEmail,
+            fromName: request.fromName,
+            ...(request.replyToEmail !== undefined && { replyToEmail: request.replyToEmail }),
+            ...(request.replyToName !== undefined && { replyToName: request.replyToName }),
+            provider: request.provider,
+            ...(request.providerSenderId !== undefined && { providerSenderId: request.providerSenderId }),
+            ...(request.providerMetadata !== undefined && { providerMetadata: request.providerMetadata }),
+            isVerified: false,
+            verificationStatus: 'pending',
+            isDefault: false,
+            isActive: true,
+            priority: request.priority ?? 100,
+            ...(request.allowedDomains !== undefined && { allowedDomains: request.allowedDomains }),
+            domain,
+            createdAt: now,
+            updatedAt: now,
+            createdBy: request.createdBy,
+            lastModifiedBy: request.createdBy,
+        };
+        await this.database.execute(`INSERT INTO email_senders (
+        id, name, description, from_email, from_name, reply_to_email, reply_to_name,
+        provider, provider_sender_id, provider_metadata,
+        is_verified, verification_status, is_default, is_active, priority,
+        allowed_domains, domain, created_at, updated_at, created_by, last_modified_by
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            sender.id,
+            sender.name,
+            sender.description ?? null,
+            sender.fromEmail,
+            sender.fromName,
+            sender.replyToEmail ?? null,
+            sender.replyToName ?? null,
+            sender.provider,
+            sender.providerSenderId ?? null,
+            sender.providerMetadata ? JSON.stringify(sender.providerMetadata) : null,
+            sender.isVerified,
+            sender.verificationStatus,
+            sender.isDefault,
+            sender.isActive,
+            sender.priority,
+            sender.allowedDomains ? JSON.stringify(sender.allowedDomains) : null,
+            sender.domain,
+            sender.createdAt,
+            sender.updatedAt,
+            sender.createdBy,
+            sender.lastModifiedBy,
+        ]);
+        return sender;
+    }
+    /**
+     * Update an existing sender
+     */
+    async updateSender(id, updates) {
+        const existing = await this.getSender(id);
+        if (!existing) {
+            throw new Error(`Sender not found: ${id}`);
+        }
+        const now = new Date();
+        const updatedSender = {
+            ...existing,
+            ...updates,
+            updatedAt: now,
+        };
+        await this.database.execute(`UPDATE email_senders SET
+        name = ?, description = ?, from_name = ?, reply_to_email = ?, reply_to_name = ?,
+        provider_sender_id = ?, provider_metadata = ?,
+        is_verified = ?, verification_status = ?, last_verified_at = ?, verification_error = ?,
+        is_default = ?, is_active = ?, priority = ?, allowed_domains = ?,
+        updated_at = ?, last_modified_by = ?
+      WHERE id = ?`, [
+            updatedSender.name,
+            updatedSender.description ?? null,
+            updatedSender.fromName,
+            updatedSender.replyToEmail ?? null,
+            updatedSender.replyToName ?? null,
+            updatedSender.providerSenderId ?? null,
+            updatedSender.providerMetadata ? JSON.stringify(updatedSender.providerMetadata) : null,
+            updatedSender.isVerified,
+            updatedSender.verificationStatus,
+            updatedSender.lastVerifiedAt ?? null,
+            updatedSender.verificationError ?? null,
+            updatedSender.isDefault,
+            updatedSender.isActive,
+            updatedSender.priority,
+            updatedSender.allowedDomains ? JSON.stringify(updatedSender.allowedDomains) : null,
+            updatedSender.updatedAt,
+            updates.lastModifiedBy,
+            id,
+        ]);
+        return updatedSender;
+    }
+    /**
+     * Delete a sender
+     */
+    async deleteSender(id) {
+        await this.database.execute('DELETE FROM email_senders WHERE id = ?', [id]);
+    }
+    /**
+     * Get a single sender by ID
+     */
+    async getSender(id) {
+        const row = await this.database.queryOne('SELECT * FROM email_senders WHERE id = ?', [id]);
+        return row ? this.mapRowToSender(row) : null;
+    }
+    /**
+     * List senders with pagination and filtering
+     */
+    async listSenders(options = {}) {
+        const { provider, isActive, isVerified, domain, offset = 0, limit = 50, orderBy = 'priority', orderDirection = 'asc', } = options;
+        const conditions = [];
+        const params = [];
+        if (provider) {
+            conditions.push('provider = ?');
+            params.push(provider);
+        }
+        if (isActive !== undefined) {
+            conditions.push('is_active = ?');
+            params.push(isActive);
+        }
+        if (isVerified !== undefined) {
+            conditions.push('is_verified = ?');
+            params.push(isVerified);
+        }
+        if (domain) {
+            conditions.push('domain = ?');
+            params.push(domain);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const orderClause = `ORDER BY ${orderBy} ${orderDirection.toUpperCase()}`;
+        // Get total count
+        const countResult = await this.database.queryOne(`SELECT COUNT(*) as count FROM email_senders ${whereClause}`, params);
+        const total = countResult?.count ?? 0;
+        // Get paginated results
+        const rows = await this.database.query(`SELECT * FROM email_senders ${whereClause} ${orderClause} LIMIT ? OFFSET ?`, [...params, limit, offset]);
+        const items = rows.map((row) => this.mapRowToSender(row));
+        return {
+            items,
+            total,
+            offset,
+            limit,
+            hasMore: offset + items.length < total,
+        };
+    }
+    /**
+     * Validate a sender configuration
+     */
+    async validateSender(id) {
+        const sender = await this.getSender(id);
+        if (!sender) {
+            return {
+                isValid: false,
+                errors: [{ field: 'id', message: 'Sender not found', code: 'NOT_FOUND' }],
+                warnings: [],
+            };
+        }
+        const validation = validateSenderConfiguration(sender.fromEmail, sender.allowedDomains);
+        return {
+            isValid: validation.valid,
+            errors: validation.errors,
+            warnings: [],
+        };
+    }
+    /**
+     * Verify sender with provider
+     */
+    async verifySender(id, providerId) {
+        const sender = await this.getSender(id);
+        if (!sender) {
+            return {
+                success: false,
+                isVerified: false,
+                verificationStatus: 'not_found',
+                error: 'Sender not found',
+            };
+        }
+        const provId = providerId ?? sender.provider;
+        const provider = this.providers.get(provId);
+        if (!provider) {
+            return {
+                success: false,
+                isVerified: false,
+                verificationStatus: 'provider_not_found',
+                error: `Provider not found: ${provId}`,
+            };
+        }
+        try {
+            const validation = await provider.validateSender(sender.fromEmail);
+            await this.updateSender(id, {
+                isVerified: validation.isVerified,
+                verificationStatus: validation.verificationStatus,
+                lastVerifiedAt: validation.lastChecked,
+                lastModifiedBy: this.systemUser,
+            });
+            return {
+                success: true,
+                isVerified: validation.isVerified,
+                verificationStatus: validation.verificationStatus,
+                message: validation.isVerified ? 'Sender verified successfully' : 'Sender verification failed',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                isVerified: false,
+                verificationStatus: 'error',
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Refresh verification status from provider
+     */
+    async refreshVerificationStatus(id) {
+        const verification = await this.verifySender(id);
+        if (!verification.success) {
+            throw new Error(`Failed to refresh verification: ${verification.error}`);
+        }
+        const sender = await this.getSender(id);
+        if (!sender) {
+            throw new Error(`Sender not found: ${id}`);
+        }
+        return sender;
+    }
+    /**
+     * Select best sender for an email address
+     */
+    async selectBestSender(fromEmail, options = {}) {
+        const domain = extractDomain(fromEmail);
+        // Get all active senders
+        const result = await this.listSenders({
+            isActive: true,
+            limit: 1000,
+        });
+        let candidates = result.items;
+        // Apply filters
+        candidates = this.selector.filterCandidates(candidates, options);
+        if (candidates.length === 0) {
+            return this.selectionConfig.fallbackToDefault ? await this.getDefaultSender() : null;
+        }
+        return this.selector.selectBestSender(candidates, domain, options);
+    }
+    /**
+     * Get the default sender
+     */
+    async getDefaultSender(provider) {
+        const conditions = ['is_default = TRUE', 'is_active = TRUE'];
+        const params = [];
+        if (provider) {
+            conditions.push('provider = ?');
+            params.push(provider);
+        }
+        const row = await this.database.queryOne(`SELECT * FROM email_senders WHERE ${conditions.join(' AND ')} LIMIT 1`, params);
+        return row ? this.mapRowToSender(row) : null;
+    }
+    /**
+     * Get senders by domain
+     */
+    async getSendersByDomain(domain) {
+        const result = await this.listSenders({ domain, limit: 1000 });
+        return result.items;
+    }
+    /**
+     * Register a provider plugin
+     */
+    async registerProvider(provider) {
+        this.providers.set(provider.providerId, provider);
+        // Sync existing senders with this provider
+        const result = await this.listSenders({ provider: provider.providerId, limit: 1000 });
+        for (const sender of result.items) {
+            await this.refreshVerificationStatus(sender.id);
+        }
+    }
+    /**
+     * Get provider senders
+     */
+    async getProviderSenders(providerId) {
+        const provider = this.providers.get(providerId);
+        if (!provider) {
+            throw new Error(`Provider not found: ${providerId}`);
+        }
+        return await provider.getVerifiedSenders();
+    }
+    /**
+     * Sync with all providers
+     */
+    async syncWithProviders() {
+        const results = [];
+        for (const [providerId, provider] of this.providers) {
+            const senders = await this.listSenders({ provider: providerId, limit: 1000 });
+            for (const sender of senders.items) {
+                try {
+                    const syncResult = await provider.syncSender(sender);
+                    results.push(syncResult);
+                }
+                catch (error) {
+                    results.push({
+                        success: false,
+                        senderId: sender.id,
+                        synced: false,
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Clean up inactive senders
+     */
+    async cleanupInactiveSenders() {
+        const result = await this.database.query('SELECT id FROM email_senders WHERE is_active = FALSE');
+        let deletedCount = 0;
+        for (const row of result) {
+            await this.deleteSender(row.id);
+            deletedCount++;
+        }
+        return {
+            success: true,
+            deletedCount,
+            message: `Cleaned up ${deletedCount} inactive sender(s)`,
+        };
+    }
+    /**
+     * Map database row to SenderConfiguration
+     */
+    mapRowToSender(row) {
+        const sender = {
+            id: row.id,
+            name: row.name,
+            fromEmail: row.from_email,
+            fromName: row.from_name,
+            provider: row.provider,
+            isVerified: Boolean(row.is_verified),
+            verificationStatus: row.verification_status,
+            isDefault: Boolean(row.is_default),
+            isActive: Boolean(row.is_active),
+            priority: row.priority,
+            domain: row.domain,
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+            createdBy: row.created_by,
+            lastModifiedBy: row.last_modified_by,
+        };
+        // Add optional properties only if they exist
+        if (row.description !== null && row.description !== undefined) {
+            sender.description = row.description;
+        }
+        if (row.reply_to_email !== null && row.reply_to_email !== undefined) {
+            sender.replyToEmail = row.reply_to_email;
+        }
+        if (row.reply_to_name !== null && row.reply_to_name !== undefined) {
+            sender.replyToName = row.reply_to_name;
+        }
+        if (row.provider_sender_id !== null && row.provider_sender_id !== undefined) {
+            sender.providerSenderId = row.provider_sender_id;
+        }
+        if (row.provider_metadata !== null && row.provider_metadata !== undefined) {
+            sender.providerMetadata = JSON.parse(row.provider_metadata);
+        }
+        if (row.last_verified_at !== null && row.last_verified_at !== undefined) {
+            sender.lastVerifiedAt = new Date(row.last_verified_at);
+        }
+        if (row.verification_error !== null && row.verification_error !== undefined) {
+            sender.verificationError = row.verification_error;
+        }
+        if (row.allowed_domains !== null && row.allowed_domains !== undefined) {
+            sender.allowedDomains = JSON.parse(row.allowed_domains);
+        }
+        return sender;
+    }
+    /**
+     * Generate unique sender ID
+     */
+    generateId() {
+        return `sender_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/manager.js.map

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

package/dist/selection/selector.d.ts

@@ -0,0 +1,27 @@
+import type { SenderConfiguration, SelectionOptions, SelectionConfig } from '../types.js';
+export declare class SenderSelector {
+    private config;
+    private roundRobinCounters;
+    constructor(config: SelectionConfig);
+    /**
+     * Select best sender from candidates
+     */
+    selectBestSender(candidates: SenderConfiguration[], domain: string, options?: SelectionOptions): SenderConfiguration | null;
+    /**
+     * Select sender by domain matching
+     */
+    private selectByDomainMatch;
+    /**
+     * Select sender by priority
+     */
+    private selectByPriority;
+    /**
+     * Select sender using round-robin
+     */
+    private selectRoundRobin;
+    /**
+     * Filter candidates by selection options
+     */
+    filterCandidates(candidates: SenderConfiguration[], options: SelectionOptions): SenderConfiguration[];
+}
+//# sourceMappingURL=selector.d.ts.map

package/dist/selection/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/selection/selector.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1F,qBAAa,cAAc;IAGb,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,kBAAkB,CAAkC;gBAExC,MAAM,EAAE,eAAe;IAE3C;;OAEG;IACH,gBAAgB,CACd,UAAU,EAAE,mBAAmB,EAAE,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,mBAAmB,GAAG,IAAI;IAmB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,gBAAgB,CACd,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,gBAAgB,GACxB,mBAAmB,EAAE;CAoBzB"}

package/dist/selection/selector.js

@@ -0,0 +1,107 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+import { isDomainMatch } from '../utils/domain-utils.js';
+export class SenderSelector {
+    config;
+    roundRobinCounters = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Select best sender from candidates
+     */
+    selectBestSender(candidates, domain, options = {}) {
+        if (candidates.length === 0) {
+            return null;
+        }
+        const strategy = options.strategy || this.config.strategy;
+        switch (strategy) {
+            case 'domain_match':
+                return this.selectByDomainMatch(candidates, domain);
+            case 'priority':
+                return this.selectByPriority(candidates);
+            case 'round_robin':
+                return this.selectRoundRobin(candidates, domain);
+            default:
+                return candidates[0];
+        }
+    }
+    /**
+     * Select sender by domain matching
+     */
+    selectByDomainMatch(candidates, domain) {
+        // 1. Exact domain match
+        const exactMatches = candidates.filter((sender) => sender.domain === domain);
+        if (exactMatches.length > 0) {
+            return this.selectByPriority(exactMatches);
+        }
+        // 2. Parent/subdomain match
+        const relatedMatches = candidates.filter((sender) => domain.endsWith(`.${sender.domain}`) || sender.domain.endsWith(`.${domain}`));
+        if (relatedMatches.length > 0) {
+            return this.selectByPriority(relatedMatches);
+        }
+        // 3. Allowed domains match
+        const allowedMatches = candidates.filter((sender) => sender.allowedDomains?.some((allowed) => isDomainMatch(domain, allowed)));
+        if (allowedMatches.length > 0) {
+            return this.selectByPriority(allowedMatches);
+        }
+        // 4. Fallback to priority
+        return this.selectByPriority(candidates);
+    }
+    /**
+     * Select sender by priority
+     */
+    selectByPriority(candidates) {
+        return candidates.sort((a, b) => {
+            // Lower priority number = higher priority
+            if (a.priority !== b.priority) {
+                return a.priority - b.priority;
+            }
+            // Verified senders preferred
+            if (a.isVerified !== b.isVerified) {
+                return b.isVerified ? 1 : -1;
+            }
+            // More recently verified preferred
+            if (a.lastVerifiedAt && b.lastVerifiedAt) {
+                return b.lastVerifiedAt.getTime() - a.lastVerifiedAt.getTime();
+            }
+            // Fallback to creation order
+            return a.createdAt.getTime() - b.createdAt.getTime();
+        })[0];
+    }
+    /**
+     * Select sender using round-robin
+     */
+    selectRoundRobin(candidates, domain) {
+        const key = `rr_${domain}`;
+        const currentIndex = this.roundRobinCounters.get(key) ?? 0;
+        const nextIndex = (currentIndex + 1) % candidates.length;
+        this.roundRobinCounters.set(key, nextIndex);
+        return candidates[currentIndex];
+    }
+    /**
+     * Filter candidates by selection options
+     */
+    filterCandidates(candidates, options) {
+        let filtered = [...candidates];
+        // Filter by verification status
+        if (!options.allowUnverified) {
+            filtered = filtered.filter((sender) => sender.isVerified);
+        }
+        // Filter by provider
+        if (options.provider) {
+            filtered = filtered.filter((sender) => sender.provider === options.provider);
+        }
+        // Exclude specific senders
+        if (options.excludeIds && options.excludeIds.length > 0) {
+            filtered = filtered.filter((sender) => !options.excludeIds.includes(sender.id));
+        }
+        return filtered;
+    }
+}
+//# sourceMappingURL=selector.js.map

package/dist/selection/selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.js","sourceRoot":"","sources":["../../src/selection/selector.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAGF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,OAAO,cAAc;IAGL;IAFZ,kBAAkB,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE5D,YAAoB,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAE/C;;OAEG;IACH,gBAAgB,CACd,UAAiC,EACjC,MAAc,EACd,UAA4B,EAAE;QAE9B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAE1D,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACtD,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC3C,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACnD;gBACE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,UAAiC,EACjC,MAAc;QAEd,wBAAwB;QACxB,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC7E,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;QAED,4BAA4B;QAC5B,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CACtC,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,CAC/E,CAAC;QACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAC/C,CAAC;QAED,2BAA2B;QAC3B,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAClD,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CACzE,CAAC;QACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAC/C,CAAC;QAED,0BAA0B;QAC1B,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,UAAiC;QACxD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC9B,0CAA0C;YAC1C,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;YACjC,CAAC;YAED,6BAA6B;YAC7B,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;gBAClC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;YAED,mCAAmC;YACnC,IAAI,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;gBACzC,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YACjE,CAAC;YAED,6BAA6B;YAC7B,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACR,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,UAAiC,EAAE,MAAc;QACxE,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;QAEzD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAE5C,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,UAAiC,EACjC,OAAyB;QAEzB,IAAI,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;QAE/B,gCAAgC;QAChC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5D,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/E,CAAC;QAED,2BAA2B;QAC3B,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnF,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}