@bernierllc/email-sender-manager 1.0.1

package/dist/database/bootstrap.d.ts

@@ -0,0 +1,35 @@
+import type { DatabaseAdapter, BootstrapConfig, BootstrapResult } from '../types.js';
+export declare class SenderBootstrap {
+    private database;
+    private config;
+    constructor(database: DatabaseAdapter, config: BootstrapConfig);
+    /**
+     * Run bootstrap process
+     */
+    bootstrap(): Promise<BootstrapResult>;
+    /**
+     * Ensure database schema exists
+     */
+    private ensureSchema;
+    /**
+     * Seed default senders
+     */
+    private seedDefaultSenders;
+    /**
+     * Check if sender exists by email
+     */
+    private senderExists;
+    /**
+     * Create a sender during bootstrap
+     */
+    private createSender;
+    /**
+     * Ensure exactly one default sender exists
+     */
+    private ensureDefaultSender;
+    /**
+     * Generate unique sender ID
+     */
+    private generateId;
+}
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/database/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/database/bootstrap.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EAGhB,MAAM,aAAa,CAAC;AAIrB,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;gBADN,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,eAAe;IAGjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAwC3C;;OAEG;YACW,YAAY;IAQ1B;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;YACW,YAAY;IAQ1B;;OAEG;YACW,YAAY;IAgE1B;;OAEG;YACW,mBAAmB;IAiCjC;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}

package/dist/database/bootstrap.js

@@ -0,0 +1,183 @@
+/*
+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 { getAllSchemas } from './schema.js';
+import { extractDomain } from '../utils/domain-utils.js';
+export class SenderBootstrap {
+    database;
+    config;
+    constructor(database, config) {
+        this.database = database;
+        this.config = config;
+    }
+    /**
+     * Run bootstrap process
+     */
+    async bootstrap() {
+        const errors = [];
+        let tablesCreated = false;
+        let seedersRun = 0;
+        try {
+            // Create tables if enabled
+            if (this.config.createTables) {
+                await this.ensureSchema();
+                tablesCreated = true;
+            }
+            // Seed default senders if enabled
+            if (this.config.seedDefaultSenders && this.config.defaultSenders.length > 0) {
+                seedersRun = await this.seedDefaultSenders(this.config.defaultSenders);
+            }
+            // Ensure exactly one default sender
+            await this.ensureDefaultSender();
+            return {
+                success: true,
+                tablesCreated,
+                seedersRun,
+                message: `Bootstrap completed successfully. Tables created: ${tablesCreated}, Senders seeded: ${seedersRun}`,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            errors.push(errorMessage);
+            return {
+                success: false,
+                tablesCreated,
+                seedersRun,
+                message: 'Bootstrap failed',
+                errors,
+            };
+        }
+    }
+    /**
+     * Ensure database schema exists
+     */
+    async ensureSchema() {
+        const schemas = getAllSchemas();
+        for (const schema of schemas) {
+            await this.database.execute(schema);
+        }
+    }
+    /**
+     * Seed default senders
+     */
+    async seedDefaultSenders(senders) {
+        let count = 0;
+        for (const sender of senders) {
+            const exists = await this.senderExists(sender.fromEmail);
+            if (!exists) {
+                await this.createSender({
+                    ...sender,
+                    createdBy: 'system-bootstrap',
+                });
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Check if sender exists by email
+     */
+    async senderExists(email) {
+        const result = await this.database.queryOne('SELECT COUNT(*) as count FROM email_senders WHERE from_email = ?', [email]);
+        return (result?.count ?? 0) > 0;
+    }
+    /**
+     * Create a sender during bootstrap
+     */
+    async createSender(request) {
+        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;
+    }
+    /**
+     * Ensure exactly one default sender exists
+     */
+    async ensureDefaultSender() {
+        const defaultSenders = await this.database.query('SELECT id, last_verified_at, created_at FROM email_senders WHERE is_default = TRUE AND is_active = TRUE');
+        if (defaultSenders.length === 0) {
+            // Set the first active sender as default
+            const firstActive = await this.database.queryOne('SELECT id FROM email_senders WHERE is_active = TRUE ORDER BY created_at ASC LIMIT 1');
+            if (firstActive) {
+                await this.database.execute('UPDATE email_senders SET is_default = TRUE WHERE id = ?', [
+                    firstActive.id,
+                ]);
+            }
+        }
+        else if (defaultSenders.length > 1) {
+            // Keep only one default (most recently verified, or oldest)
+            const sorted = defaultSenders.sort((a, b) => {
+                if (a.last_verified_at && b.last_verified_at) {
+                    return new Date(b.last_verified_at).getTime() - new Date(a.last_verified_at).getTime();
+                }
+                return new Date(a.created_at).getTime() - new Date(b.created_at).getTime();
+            });
+            const keepId = sorted[0].id;
+            await this.database.execute('UPDATE email_senders SET is_default = FALSE WHERE id != ?', [
+                keepId,
+            ]);
+        }
+    }
+    /**
+     * Generate unique sender ID
+     */
+    generateId() {
+        return `sender_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/database/bootstrap.js.map

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

package/dist/database/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Database schema for email senders table
+ */
+export declare const EMAIL_SENDERS_SCHEMA = "\nCREATE TABLE IF NOT EXISTS email_senders (\n  id VARCHAR(255) PRIMARY KEY,\n  name VARCHAR(255) NOT NULL,\n  description TEXT,\n\n  -- Email configuration\n  from_email VARCHAR(255) NOT NULL UNIQUE,\n  from_name VARCHAR(255) NOT NULL,\n  reply_to_email VARCHAR(255),\n  reply_to_name VARCHAR(255),\n\n  -- Provider integration\n  provider VARCHAR(100) NOT NULL,\n  provider_sender_id VARCHAR(255),\n  provider_metadata JSON,\n\n  -- Validation and status\n  is_verified BOOLEAN DEFAULT FALSE,\n  verification_status VARCHAR(50) DEFAULT 'pending',\n  last_verified_at TIMESTAMP NULL,\n  verification_error TEXT,\n\n  -- Configuration\n  is_default BOOLEAN DEFAULT FALSE,\n  is_active BOOLEAN DEFAULT TRUE,\n  priority INTEGER DEFAULT 100,\n\n  -- Domain information\n  allowed_domains JSON,\n  domain VARCHAR(255) NOT NULL,\n\n  -- Metadata\n  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,\n  created_by VARCHAR(255),\n  last_modified_by VARCHAR(255),\n\n  -- Indexes\n  INDEX idx_email_senders_from_email (from_email),\n  INDEX idx_email_senders_domain (domain),\n  INDEX idx_email_senders_provider (provider),\n  INDEX idx_email_senders_active (is_active),\n  INDEX idx_email_senders_default (is_default),\n  INDEX idx_email_senders_priority (priority)\n);\n";
+/**
+ * Migration to add name column if missing
+ */
+export declare const ADD_NAME_COLUMN_MIGRATION = "\nALTER TABLE email_senders\nADD COLUMN IF NOT EXISTS name VARCHAR(255)\nDEFAULT 'Unnamed Sender'\n";
+/**
+ * Get all schema creation statements
+ */
+export declare function getAllSchemas(): string[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/database/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,oBAAoB,m0CA8ChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,wGAIrC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/database/schema.js

@@ -0,0 +1,72 @@
+/*
+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.
+*/
+/**
+ * Database schema for email senders table
+ */
+export const EMAIL_SENDERS_SCHEMA = `
+CREATE TABLE IF NOT EXISTS email_senders (
+  id VARCHAR(255) PRIMARY KEY,
+  name VARCHAR(255) NOT NULL,
+  description TEXT,
+
+  -- Email configuration
+  from_email VARCHAR(255) NOT NULL UNIQUE,
+  from_name VARCHAR(255) NOT NULL,
+  reply_to_email VARCHAR(255),
+  reply_to_name VARCHAR(255),
+
+  -- Provider integration
+  provider VARCHAR(100) NOT NULL,
+  provider_sender_id VARCHAR(255),
+  provider_metadata JSON,
+
+  -- Validation and status
+  is_verified BOOLEAN DEFAULT FALSE,
+  verification_status VARCHAR(50) DEFAULT 'pending',
+  last_verified_at TIMESTAMP NULL,
+  verification_error TEXT,
+
+  -- Configuration
+  is_default BOOLEAN DEFAULT FALSE,
+  is_active BOOLEAN DEFAULT TRUE,
+  priority INTEGER DEFAULT 100,
+
+  -- Domain information
+  allowed_domains JSON,
+  domain VARCHAR(255) NOT NULL,
+
+  -- Metadata
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  created_by VARCHAR(255),
+  last_modified_by VARCHAR(255),
+
+  -- Indexes
+  INDEX idx_email_senders_from_email (from_email),
+  INDEX idx_email_senders_domain (domain),
+  INDEX idx_email_senders_provider (provider),
+  INDEX idx_email_senders_active (is_active),
+  INDEX idx_email_senders_default (is_default),
+  INDEX idx_email_senders_priority (priority)
+);
+`;
+/**
+ * Migration to add name column if missing
+ */
+export const ADD_NAME_COLUMN_MIGRATION = `
+ALTER TABLE email_senders
+ADD COLUMN IF NOT EXISTS name VARCHAR(255)
+DEFAULT 'Unnamed Sender'
+`;
+/**
+ * Get all schema creation statements
+ */
+export function getAllSchemas() {
+    return [EMAIL_SENDERS_SCHEMA, ADD_NAME_COLUMN_MIGRATION];
+}
+//# sourceMappingURL=schema.js.map

package/dist/database/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CnC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;CAIxC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;AAC3D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { EmailSenderManager } from './manager.js';
+export type { SenderConfiguration, CreateSenderRequest, UpdateSenderRequest, ListSendersOptions, PaginatedResult, ValidationError, ValidationWarning, ProviderValidationResult, SenderValidationResult, VerificationResult, SelectionOptions, DomainMatchingRule, BootstrapConfig, SelectionConfig, ValidationConfig, DatabaseAdapter, ProviderSender, SenderProviderPlugin, SyncResult, BootstrapResult, CleanupResult, SenderManagerConfig, } from './types.js';
+export { extractDomain, isDomainMatch, isValidEmail, getParentDomain, isSubdomainOf } from './utils/domain-utils.js';
+export { validateCreateSenderRequest, validateDomainAllowed, validateSenderConfiguration } from './utils/validation-utils.js';
+export { SenderBootstrap } from './database/bootstrap.js';
+export { EMAIL_SENDERS_SCHEMA, getAllSchemas } from './database/schema.js';
+export { SenderSelector } from './selection/selector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrH,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAG9H,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG3E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/*
+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.
+*/
+// Main exports
+export { EmailSenderManager } from './manager.js';
+// Utility exports
+export { extractDomain, isDomainMatch, isValidEmail, getParentDomain, isSubdomainOf } from './utils/domain-utils.js';
+export { validateCreateSenderRequest, validateDomainAllowed, validateSenderConfiguration } from './utils/validation-utils.js';
+// Database exports
+export { SenderBootstrap } from './database/bootstrap.js';
+export { EMAIL_SENDERS_SCHEMA, getAllSchemas } from './database/schema.js';
+// Selection exports
+export { SenderSelector } from './selection/selector.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AA4BlD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrH,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE9H,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE3E,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/manager.d.ts

@@ -0,0 +1,85 @@
+import type { SenderManagerConfig, SenderConfiguration, CreateSenderRequest, UpdateSenderRequest, ListSendersOptions, PaginatedResult, SenderValidationResult, VerificationResult, SelectionOptions, BootstrapResult, SyncResult, CleanupResult, SenderProviderPlugin, ProviderSender } from './types.js';
+export declare class EmailSenderManager {
+    private database;
+    private providers;
+    private bootstrap;
+    private selector;
+    private bootstrapConfig;
+    private validationConfig;
+    private selectionConfig;
+    private systemUser;
+    constructor(config: SenderManagerConfig);
+    /**
+     * Bootstrap database and seed default senders
+     */
+    bootstrapDatabase(): Promise<BootstrapResult>;
+    /**
+     * Create a new sender configuration
+     */
+    createSender(request: CreateSenderRequest): Promise<SenderConfiguration>;
+    /**
+     * Update an existing sender
+     */
+    updateSender(id: string, updates: UpdateSenderRequest): Promise<SenderConfiguration>;
+    /**
+     * Delete a sender
+     */
+    deleteSender(id: string): Promise<void>;
+    /**
+     * Get a single sender by ID
+     */
+    getSender(id: string): Promise<SenderConfiguration | null>;
+    /**
+     * List senders with pagination and filtering
+     */
+    listSenders(options?: ListSendersOptions): Promise<PaginatedResult<SenderConfiguration>>;
+    /**
+     * Validate a sender configuration
+     */
+    validateSender(id: string): Promise<SenderValidationResult>;
+    /**
+     * Verify sender with provider
+     */
+    verifySender(id: string, providerId?: string): Promise<VerificationResult>;
+    /**
+     * Refresh verification status from provider
+     */
+    refreshVerificationStatus(id: string): Promise<SenderConfiguration>;
+    /**
+     * Select best sender for an email address
+     */
+    selectBestSender(fromEmail: string, options?: SelectionOptions): Promise<SenderConfiguration | null>;
+    /**
+     * Get the default sender
+     */
+    getDefaultSender(provider?: string): Promise<SenderConfiguration | null>;
+    /**
+     * Get senders by domain
+     */
+    getSendersByDomain(domain: string): Promise<SenderConfiguration[]>;
+    /**
+     * Register a provider plugin
+     */
+    registerProvider(provider: SenderProviderPlugin): Promise<void>;
+    /**
+     * Get provider senders
+     */
+    getProviderSenders(providerId: string): Promise<ProviderSender[]>;
+    /**
+     * Sync with all providers
+     */
+    syncWithProviders(): Promise<SyncResult[]>;
+    /**
+     * Clean up inactive senders
+     */
+    cleanupInactiveSenders(): Promise<CleanupResult>;
+    /**
+     * Map database row to SenderConfiguration
+     */
+    private mapRowToSender;
+    /**
+     * Generate unique sender ID
+     */
+    private generateId;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EAKf,MAAM,YAAY,CAAC;AASpB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,mBAAmB;IA0CvC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,eAAe,CAAC;IAanD;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgF9E;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8C1F;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAShE;;OAEG;IACG,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;IA8DlG;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmBjE;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiDhF;;OAEG;IACG,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAczE;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAqBtC;;OAEG;IACG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAiB9E;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAKxE;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrE;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IASvE;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAwBhD;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,aAAa,CAAC;IAkBtD;;OAEG;IACH,OAAO,CAAC,cAAc;IAgDtB;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}