attio-mcp 0.1.2 → 1.1.0

package/dist/utils/mock-state.js

@@ -0,0 +1,192 @@
+/**
+ * Mock State Manager for Test Environments
+ *
+ * Provides shared state storage for mock company data during testing
+ * to ensure consistency between createCompany, updateCompany, and getCompanyDetails
+ * when using mock responses instead of real API calls.
+ *
+ * This is only active in test environments (E2E_MODE=true or NODE_ENV=test)
+ */
+import { createScopedLogger } from './logger.js';
+// In-memory storage for mock company data (test environments only)
+const mockCompanyStorage = new Map();
+/**
+ * Checks if mock state should be used (test environments only)
+ */
+function shouldUseMockState() {
+    return process.env.E2E_MODE === 'true' || process.env.NODE_ENV === 'test';
+}
+/**
+ * Stores a mock company in shared state
+ * Only active in test environments
+ */
+export function setMockCompany(companyId, company) {
+    if (!shouldUseMockState()) {
+        return; // No-op in production
+    }
+    if (!companyId || !company) {
+        createScopedLogger('utils/mock-state', 'setMockCompany').warn('Invalid parameters for setMockCompany', {
+            companyId,
+            company,
+        });
+        return;
+    }
+    mockCompanyStorage.set(companyId, { ...company });
+    if (process.env.NODE_ENV === 'development' ||
+        process.env.E2E_MODE === 'true') {
+        createScopedLogger('utils/mock-state', 'setMockCompany').debug('Stored mock company', {
+            companyId,
+            totalStoredCompanies: mockCompanyStorage.size,
+        });
+    }
+}
+/**
+ * Retrieves a mock company from shared state
+ * Returns null if not found or not in test environment
+ */
+export function getMockCompany(companyId) {
+    if (!shouldUseMockState() || !companyId) {
+        return null;
+    }
+    const company = mockCompanyStorage.get(companyId);
+    if (process.env.NODE_ENV === 'development' ||
+        process.env.E2E_MODE === 'true') {
+        createScopedLogger('utils/mock-state', 'getMockCompany').debug('Retrieved mock company', {
+            companyId,
+            found: !!company,
+        });
+    }
+    return company ? { ...company } : null;
+}
+/**
+ * Updates a mock company with new attributes (partial update)
+ * Merges new attributes with existing ones
+ */
+export function updateMockCompany(companyId, attributes) {
+    if (!shouldUseMockState() || !companyId || !attributes) {
+        return null;
+    }
+    const existingCompany = mockCompanyStorage.get(companyId);
+    if (!existingCompany) {
+        if (process.env.NODE_ENV === 'development' ||
+            process.env.E2E_MODE === 'true') {
+            createScopedLogger('utils/mock-state', 'updateMockCompany').warn('Cannot update company: not found in mock storage', { companyId });
+        }
+        return null;
+    }
+    // Merge the new attributes with existing values
+    const updatedValues = {
+        ...existingCompany.values,
+        ...attributes,
+    };
+    const updatedCompany = {
+        ...existingCompany,
+        values: updatedValues,
+    };
+    mockCompanyStorage.set(companyId, updatedCompany);
+    if (process.env.NODE_ENV === 'development' ||
+        process.env.E2E_MODE === 'true') {
+        createScopedLogger('utils/mock-state', 'updateMockCompany').debug('Updated mock company', { companyId, updatedFields: Object.keys(attributes) });
+    }
+    return { ...updatedCompany };
+}
+/**
+ * Checks if a company exists in mock storage
+ */
+export function hasMockCompany(companyId) {
+    if (!shouldUseMockState() || !companyId) {
+        return false;
+    }
+    return mockCompanyStorage.has(companyId);
+}
+/**
+ * Clears all mock companies from storage
+ * Useful for test cleanup
+ */
+export function clearMockCompanies() {
+    if (!shouldUseMockState()) {
+        return;
+    }
+    const count = mockCompanyStorage.size;
+    mockCompanyStorage.clear();
+    if (process.env.NODE_ENV === 'development' ||
+        process.env.E2E_MODE === 'true') {
+        createScopedLogger('utils/mock-state', 'clearMockCompanies').info('Cleared mock companies from storage', { count });
+    }
+}
+/**
+ * Gets all mock company IDs (for debugging)
+ */
+export function getAllMockCompanyIds() {
+    if (!shouldUseMockState()) {
+        return [];
+    }
+    return Array.from(mockCompanyStorage.keys());
+}
+/**
+ * Creates a properly formatted Attio API value structure
+ * Attio API stores values as arrays of objects with metadata
+ */
+export function createAttioApiValue(value, attributeType = 'text') {
+    if (value === null || value === undefined) {
+        return [];
+    }
+    return [
+        {
+            active_from: new Date().toISOString(),
+            active_until: null,
+            created_by_actor: {
+                type: 'system',
+                id: null,
+            },
+            value: String(value),
+            attribute_type: attributeType,
+        },
+    ];
+}
+/**
+ * Creates a company mock with proper Attio API structure
+ * This ensures our mocks match the real API response format
+ */
+export function createMockCompanyWithApiStructure(companyId, attributes) {
+    // Convert simple attributes to Attio API format
+    const apiFormattedValues = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        if (value !== null && value !== undefined) {
+            // Special handling for specific field types
+            if (key === 'categories') {
+                // Categories are select fields with option structure
+                apiFormattedValues[key] = [
+                    {
+                        active_from: new Date().toISOString(),
+                        active_until: null,
+                        created_by_actor: { type: 'system', id: null },
+                        option: {
+                            title: String(value),
+                            is_archived: false,
+                        },
+                        attribute_type: 'select',
+                    },
+                ];
+            }
+            else {
+                // Default text field format
+                apiFormattedValues[key] = createAttioApiValue(value, 'text');
+            }
+        }
+        else {
+            apiFormattedValues[key] = [];
+        }
+    }
+    return {
+        id: {
+            workspace_id: 'test-workspace',
+            object_id: 'companies',
+            record_id: companyId,
+        },
+        values: apiFormattedValues,
+        created_at: new Date().toISOString(),
+        record_url: `https://app.attio.com/workspace/test-workspace/object/companies/${companyId}`,
+    };
+}
+//# sourceMappingURL=mock-state.js.map

package/dist/utils/mock-state.js.map

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

package/dist/utils/normalization/email-validation-config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Email Validation Configuration
+ *
+ * Provides configurable email validation behavior to support backward compatibility
+ * while transitioning to stricter validation.
+ */
+/**
+ * Email validation mode options
+ */
+export declare enum EmailValidationMode {
+    /** Strict mode: Throw errors for invalid emails (default, recommended) */
+    STRICT = "strict",
+    /** Legacy mode: Silently skip invalid emails (backward compatibility) */
+    LEGACY = "legacy",
+    /** Warn mode: Log warnings for invalid emails but don't throw (transition mode) */
+    WARN = "warn"
+}
+/**
+ * Email validation configuration options
+ */
+export interface EmailValidationConfig {
+    /** Validation mode to use */
+    mode: EmailValidationMode;
+    /** Whether to log deprecation warnings for legacy mode usage */
+    logDeprecationWarnings?: boolean;
+    /** Custom logger function for warnings */
+    logger?: (message: string, level: 'warn' | 'error' | 'info') => void;
+}
+export declare const DEFAULT_EMAIL_VALIDATION_CONFIG: EmailValidationConfig;
+/**
+ * Legacy email validation configuration for backward compatibility
+ */
+export declare const LEGACY_EMAIL_VALIDATION_CONFIG: EmailValidationConfig;
+/**
+ * Warn mode configuration for gradual migration
+ */
+export declare const WARN_EMAIL_VALIDATION_CONFIG: EmailValidationConfig;
+/**
+ * Get validation config based on environment or explicit mode
+ */
+export declare function getEmailValidationConfig(explicitMode?: EmailValidationMode): EmailValidationConfig;
+//# sourceMappingURL=email-validation-config.d.ts.map

package/dist/utils/normalization/email-validation-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-validation-config.d.ts","sourceRoot":"","sources":["../../../src/utils/normalization/email-validation-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,0EAA0E;IAC1E,MAAM,WAAW;IAEjB,yEAAyE;IACzE,MAAM,WAAW;IAEjB,mFAAmF;IACnF,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,IAAI,EAAE,mBAAmB,CAAC;IAE1B,gEAAgE;IAChE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;CACtE;AAQD,eAAO,MAAM,+BAA+B,EAAE,qBAkB7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,qBAkB5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,qBAkB1C,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,CAAC,EAAE,mBAAmB,GACjC,qBAAqB,CAmBvB"}

package/dist/utils/normalization/email-validation-config.js

@@ -0,0 +1,107 @@
+/**
+ * Email Validation Configuration
+ *
+ * Provides configurable email validation behavior to support backward compatibility
+ * while transitioning to stricter validation.
+ */
+/**
+ * Email validation mode options
+ */
+export var EmailValidationMode;
+(function (EmailValidationMode) {
+    /** Strict mode: Throw errors for invalid emails (default, recommended) */
+    EmailValidationMode["STRICT"] = "strict";
+    /** Legacy mode: Silently skip invalid emails (backward compatibility) */
+    EmailValidationMode["LEGACY"] = "legacy";
+    /** Warn mode: Log warnings for invalid emails but don't throw (transition mode) */
+    EmailValidationMode["WARN"] = "warn";
+})(EmailValidationMode || (EmailValidationMode = {}));
+/**
+ * Default email validation configuration
+ */
+import { createScopedLogger } from '../logger.js';
+const evLogger = createScopedLogger('utils.email-validation', 'config');
+export const DEFAULT_EMAIL_VALIDATION_CONFIG = {
+    mode: EmailValidationMode.STRICT,
+    logDeprecationWarnings: true,
+    logger: (message, level) => {
+        switch (level) {
+            case 'warn':
+                evLogger.warn(message);
+                break;
+            case 'error':
+                evLogger.error(message);
+                break;
+            case 'info':
+                evLogger.info(message);
+                break;
+            default:
+                evLogger.warn(message);
+        }
+    },
+};
+/**
+ * Legacy email validation configuration for backward compatibility
+ */
+export const LEGACY_EMAIL_VALIDATION_CONFIG = {
+    mode: EmailValidationMode.LEGACY,
+    logDeprecationWarnings: true,
+    logger: (message, level) => {
+        switch (level) {
+            case 'warn':
+                evLogger.warn(message);
+                break;
+            case 'error':
+                evLogger.error(message);
+                break;
+            case 'info':
+                evLogger.info(message);
+                break;
+            default:
+                evLogger.warn(message);
+        }
+    },
+};
+/**
+ * Warn mode configuration for gradual migration
+ */
+export const WARN_EMAIL_VALIDATION_CONFIG = {
+    mode: EmailValidationMode.WARN,
+    logDeprecationWarnings: false, // Warnings are already being generated
+    logger: (message, level) => {
+        switch (level) {
+            case 'warn':
+                evLogger.warn(message);
+                break;
+            case 'error':
+                evLogger.error(message);
+                break;
+            case 'info':
+                evLogger.info(message);
+                break;
+            default:
+                evLogger.warn(message);
+        }
+    },
+};
+/**
+ * Get validation config based on environment or explicit mode
+ */
+export function getEmailValidationConfig(explicitMode) {
+    // Allow environment variable override for easier migration
+    const envMode = process.env.EMAIL_VALIDATION_MODE;
+    if (explicitMode) {
+        return {
+            ...DEFAULT_EMAIL_VALIDATION_CONFIG,
+            mode: explicitMode,
+        };
+    }
+    if (envMode && Object.values(EmailValidationMode).includes(envMode)) {
+        return {
+            ...DEFAULT_EMAIL_VALIDATION_CONFIG,
+            mode: envMode,
+        };
+    }
+    return DEFAULT_EMAIL_VALIDATION_CONFIG;
+}
+//# sourceMappingURL=email-validation-config.js.map

package/dist/utils/normalization/email-validation-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-validation-config.js","sourceRoot":"","sources":["../../../src/utils/normalization/email-validation-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,0EAA0E;IAC1E,wCAAiB,CAAA;IAEjB,yEAAyE;IACzE,wCAAiB,CAAA;IAEjB,mFAAmF;IACnF,oCAAa,CAAA;AACf,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AAgBD;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,+BAA+B,GAA0B;IACpE,IAAI,EAAE,mBAAmB,CAAC,MAAM;IAChC,sBAAsB,EAAE,IAAI;IAC5B,MAAM,EAAE,CAAC,OAAe,EAAE,KAAa,EAAE,EAAE;QACzC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,MAAM;gBACT,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM;YACR;gBACE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAA0B;IACnE,IAAI,EAAE,mBAAmB,CAAC,MAAM;IAChC,sBAAsB,EAAE,IAAI;IAC5B,MAAM,EAAE,CAAC,OAAe,EAAE,KAAa,EAAE,EAAE;QACzC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,MAAM;gBACT,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM;YACR;gBACE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA0B;IACjE,IAAI,EAAE,mBAAmB,CAAC,IAAI;IAC9B,sBAAsB,EAAE,KAAK,EAAE,uCAAuC;IACtE,MAAM,EAAE,CAAC,OAAe,EAAE,KAAa,EAAE,EAAE;QACzC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,MAAM;gBACT,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM;YACR;gBACE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAAkC;IAElC,2DAA2D;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,qBAA4C,CAAC;IAEzE,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,GAAG,+BAA+B;YAClC,IAAI,EAAE,YAAY;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,OAAO;YACL,GAAG,+BAA+B;YAClC,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED,OAAO,+BAA+B,CAAC;AACzC,CAAC"}

package/dist/utils/normalization/people-normalization.d.ts

@@ -0,0 +1,100 @@
+/**
+ * People Input Normalization
+ *
+ * Handles normalization of people data to support multiple input formats.
+ * Converts various input shapes to the standard Attio API format.
+ */
+import { EmailValidationConfig } from './email-validation-config.js';
+/**
+ * People name input formats
+ */
+export interface NameStringInput {
+    name: string;
+}
+export interface NameObjectInput {
+    first_name?: string;
+    last_name?: string;
+    full_name?: string;
+}
+export type NameInput = string | NameStringInput | NameObjectInput;
+/**
+ * Email input formats
+ */
+export type EmailInput = string | string[] | {
+    email_address: string;
+} | {
+    email_addresses: string[];
+};
+/**
+ * Normalized people data
+ */
+export interface NormalizedPeopleData {
+    first_name?: string;
+    last_name?: string;
+    full_name?: string;
+    email_addresses?: Array<{
+        email_address: string;
+        email_type?: string;
+    }>;
+    phone_numbers?: Array<{
+        phone_number: string;
+        phone_type?: string;
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Normalizes people input data to standard format
+ */
+export declare class PeopleDataNormalizer {
+    /**
+     * Normalize name input to standard format
+     */
+    static normalizeName(input: unknown, options?: {
+        includeFullName?: boolean;
+    }): {
+        first_name?: string;
+        last_name?: string;
+        full_name?: string;
+    } | undefined;
+    /**
+     * Extract email value from various input formats
+     */
+    private static extractEmailValue;
+    /**
+     * Validate and process a single email based on configuration
+     */
+    private static validateAndProcessEmail;
+    /**
+     * Normalize email input to standard format
+     *
+     * @param input - Email input in various formats
+     * @param config - Email validation configuration (optional)
+     */
+    static normalizeEmails(input: unknown, config?: EmailValidationConfig): Array<{
+        email_address: string;
+        email_type?: string;
+    }> | undefined;
+    /**
+     * Normalize phone number input
+     */
+    static normalizePhones(input: unknown): Array<{
+        phone_number: string;
+        phone_type?: string;
+    }> | undefined;
+    /**
+     * Normalize a single phone number
+     */
+    private static normalizePhoneNumber;
+    /**
+     * Normalize complete people record data
+     *
+     * @param data - People data to normalize
+     * @param emailConfig - Email validation configuration (optional)
+     */
+    static normalizePeopleData(data: unknown, emailConfig?: EmailValidationConfig): NormalizedPeopleData;
+    /**
+     * Check if data needs people normalization
+     */
+    static needsNormalization(data: unknown): boolean;
+}
+//# sourceMappingURL=people-normalization.d.ts.map

package/dist/utils/normalization/people-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"people-normalization.d.ts","sourceRoot":"","sources":["../../../src/utils/normalization/people-normalization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EACL,qBAAqB,EAGtB,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,EAAE,GACR;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAErC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,SAAS;IAiHb;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAyBhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA2DtC;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,qBAAuD,GAC9D,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IAsJpE;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,OAAO,GACb,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IA6EnE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAsBnC;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CACxB,IAAI,EAAE,OAAO,EACb,WAAW,GAAE,qBAAuD,GACnE,oBAAoB;IAoGvB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAoBlD"}