@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/batch-validation.js.map

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

package/dist/utils/cli-colors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CLI color utilities for consistent console output formatting
+ */
+declare const colors: {
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+};
+/**
+ * Applies ANSI color codes to text for terminal display
+ *
+ * @param text The text to colorize
+ * @param color The color to apply
+ * @returns Colored text with reset codes
+ *
+ * @example
+ * ```typescript
+ * console.error(colorize('Success!', 'green'));
+ * console.error(colorize('Warning', 'yellow'));
+ * ```
+ */
+export declare function colorize(text: string, color: keyof typeof colors): string;
+/**
+ * Available color options for the colorize function
+ */
+export type ColorName = keyof typeof colors;
+/**
+ * Raw ANSI color codes (exported for direct use if needed)
+ */
+export { colors };
+//# sourceMappingURL=cli-colors.d.ts.map

package/dist/utils/cli-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-colors.d.ts","sourceRoot":"","sources":["../../src/utils/cli-colors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,QAAA,MAAM,MAAM;;;;;;;;;CASF,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAC;AAE5C;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/utils/cli-colors.js

@@ -0,0 +1,35 @@
+/**
+ * CLI color utilities for consistent console output formatting
+ */
+// ANSI color codes for console output
+const colors = {
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+};
+/**
+ * Applies ANSI color codes to text for terminal display
+ *
+ * @param text The text to colorize
+ * @param color The color to apply
+ * @returns Colored text with reset codes
+ *
+ * @example
+ * ```typescript
+ * console.error(colorize('Success!', 'green'));
+ * console.error(colorize('Warning', 'yellow'));
+ * ```
+ */
+export function colorize(text, color) {
+    return `${colors[color]}${text}${colors.reset}`;
+}
+/**
+ * Raw ANSI color codes (exported for direct use if needed)
+ */
+export { colors };
+//# sourceMappingURL=cli-colors.js.map

package/dist/utils/cli-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-colors.js","sourceRoot":"","sources":["../../src/utils/cli-colors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sCAAsC;AACtC,MAAM,MAAM,GAAG;IACb,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;CACP,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAA0B;IAC/D,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC;AAOD;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/utils/client-resolver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Type-safe client resolver for Attio API client factory methods
+ * Updated to use unified createAttioClient interface with backward compatibility
+ */
+import { AxiosInstance } from 'axios';
+/**
+ * Resolves an Attio client instance using the unified interface.
+ * Uses getAttioClient() which handles caching, environment detection, and strategy pattern.
+ *
+ * This simplification fixes Issue #904 client initialization validation failures by using
+ * the proven getAttioClient() code path instead of attempting multiple factory methods.
+ */
+export declare function resolveAttioClient(): AxiosInstance;
+/**
+ * Checks whether an arbitrary value looks like an Attio Axios client.
+ */
+export declare function isAttioClient(client: unknown): client is AxiosInstance;
+/**
+ * Resolves and validates the client, guaranteeing callers receive a proper
+ * Axios instance or a descriptive error.
+ */
+export declare function getValidatedAttioClient(): AxiosInstance;
+//# sourceMappingURL=client-resolver.d.ts.map

package/dist/utils/client-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAmEtC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CA4ElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAIvD"}

package/dist/utils/client-resolver.js

@@ -0,0 +1,133 @@
+/**
+ * Type-safe client resolver for Attio API client factory methods
+ * Updated to use unified createAttioClient interface with backward compatibility
+ */
+import * as AttioClientModule from '../api/attio-client.js';
+import { getContextApiKey } from '../api/client-context.js';
+import { createScopedLogger } from './logger.js';
+const logger = createScopedLogger('client-resolver');
+/**
+ * Guards that the resolved value behaves like an Axios instance. We keep the
+ * checks intentionally simple so tests can provide lightweight mocks.
+ */
+function assertAxiosInstance(value, source) {
+    const candidate = value;
+    const hasGetMethod = !!candidate &&
+        typeof candidate === 'object' &&
+        typeof candidate.get === 'function';
+    const hasDefaults = hasGetMethod &&
+        'defaults' in candidate &&
+        typeof candidate.defaults === 'object';
+    if (!hasGetMethod || !hasDefaults) {
+        // Enhanced diagnostic information
+        const diagnostics = {
+            valueType: typeof value,
+            isNull: value === null,
+            isUndefined: value === undefined,
+            isObject: typeof value === 'object' && value !== null,
+            hasGetMethod,
+            hasDefaults,
+            hasDefaultsProperty: candidate && typeof candidate === 'object' && 'defaults' in candidate,
+            defaultsType: candidate && typeof candidate === 'object' && 'defaults' in candidate
+                ? typeof candidate.defaults
+                : 'N/A',
+            availableProperties: candidate && typeof candidate === 'object'
+                ? Object.keys(candidate).slice(0, 10)
+                : [],
+        };
+        logger.debug(`Validation failed for ${source}`, diagnostics);
+        throw new Error(`${source} returned invalid Axios client instance (hasGetMethod=${hasGetMethod}, hasDefaults=${hasDefaults})`);
+    }
+}
+/**
+ * Resolves an Attio client instance using the unified interface.
+ * Uses getAttioClient() which handles caching, environment detection, and strategy pattern.
+ *
+ * This simplification fixes Issue #904 client initialization validation failures by using
+ * the proven getAttioClient() code path instead of attempting multiple factory methods.
+ */
+export function resolveAttioClient() {
+    const mod = AttioClientModule;
+    // Debug logging for API key resolution (informational only)
+    if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
+        const contextApiKey = getContextApiKey();
+        const envApiKey = process.env.ATTIO_API_KEY;
+        const resolvedApiKey = envApiKey || contextApiKey;
+        logger.debug('API key resolution', {
+            hasEnvApiKey: Boolean(envApiKey),
+            envKeyLength: envApiKey?.length || 0,
+            hasContextApiKey: Boolean(contextApiKey),
+            contextKeyLength: contextApiKey?.length || 0,
+            resolved: Boolean(resolvedApiKey),
+            resolvedKeyLength: resolvedApiKey?.length || 0,
+            source: resolvedApiKey === envApiKey
+                ? 'env'
+                : resolvedApiKey === contextApiKey
+                    ? 'context'
+                    : 'none',
+            timestamp: new Date().toISOString(),
+        });
+    }
+    // Use getAttioClient() - it handles all the complexity:
+    // - Caching (ClientCache and legacy apiInstance)
+    // - Environment detection (E2E, test, production modes)
+    // - Strategy pattern (ProductionClientStrategy, E2EClientStrategy, etc.)
+    // - API key resolution (env, context, config)
+    // This is the proven code path used throughout the codebase
+    if (typeof mod.getAttioClient === 'function') {
+        logger.debug('Using getAttioClient()');
+        const client = mod.getAttioClient();
+        assertAxiosInstance(client, 'getAttioClient()');
+        return client;
+    }
+    // Fallback to createAttioClient with config object
+    if (typeof mod.createAttioClient === 'function') {
+        logger.debug('Fallback to createAttioClient(config)');
+        try {
+            const config = {};
+            const client = mod.createAttioClient(config);
+            assertAxiosInstance(client, 'createAttioClient(config)');
+            return client;
+        }
+        catch (error) {
+            logger.debug('createAttioClient failed', { error });
+            // Continue to last resort
+        }
+    }
+    // Last resort: buildAttioClient
+    if (typeof mod.buildAttioClient === 'function') {
+        const contextApiKey = getContextApiKey();
+        const envApiKey = process.env.ATTIO_API_KEY;
+        const resolvedApiKey = envApiKey || contextApiKey;
+        if (!resolvedApiKey) {
+            throw new Error('Attio API key is required for client initialization. Please set ATTIO_API_KEY environment variable.');
+        }
+        logger.debug('Last resort: buildAttioClient');
+        const client = mod.buildAttioClient({ apiKey: resolvedApiKey });
+        assertAxiosInstance(client, 'buildAttioClient()');
+        return client;
+    }
+    throw new Error('Failed to initialize Attio client. Please check your API configuration and ensure the client module is properly installed.');
+}
+/**
+ * Checks whether an arbitrary value looks like an Attio Axios client.
+ */
+export function isAttioClient(client) {
+    try {
+        assertAxiosInstance(client, 'isAttioClient check');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolves and validates the client, guaranteeing callers receive a proper
+ * Axios instance or a descriptive error.
+ */
+export function getValidatedAttioClient() {
+    const client = resolveAttioClient();
+    assertAxiosInstance(client, 'getValidatedAttioClient()');
+    return client;
+}
+//# sourceMappingURL=client-resolver.js.map

package/dist/utils/client-resolver.js.map

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

package/dist/utils/complex-type-validation.d.ts

@@ -0,0 +1,16 @@
+type UnknownRecord = Record<string, unknown>;
+/**
+ * Validates and normalizes a location value. Ensures an object shape and adds all 10 fields.
+ */
+export declare function validateLocationValue(value: unknown, fieldName: string): unknown;
+/**
+ * Validates and normalizes a personal-name value.
+ * Accepts string or object with first_name/last_name/full_name.
+ */
+export declare function validatePersonalNameValue(value: unknown, fieldName: string): UnknownRecord | null;
+/**
+ * Validates phone-number values. Ensures each entry has phone_number or original_phone_number.
+ */
+export declare function validatePhoneNumberValue(value: unknown, fieldName: string): unknown;
+export {};
+//# sourceMappingURL=complex-type-validation.d.ts.map

package/dist/utils/complex-type-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex-type-validation.d.ts","sourceRoot":"","sources":["../../src/utils/complex-type-validation.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAe7C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAiDT;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI,CAmFtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CA8FT"}

package/dist/utils/complex-type-validation.js

@@ -0,0 +1,196 @@
+import { UniversalValidationError, ErrorType, } from '../handlers/tool-configs/universal/errors/validation-errors.js';
+import { normalizeLocation } from './location-normalizer.js';
+import { parsePersonalName } from './personal-name-parser.js';
+const LOCATION_EXAMPLE = {
+    line_1: '123 Main St',
+    line_2: null,
+    line_3: null,
+    line_4: null,
+    locality: 'City',
+    region: 'State',
+    postcode: '12345',
+    country_code: 'US',
+    latitude: null,
+    longitude: null,
+};
+/**
+ * Validates and normalizes a location value. Ensures an object shape and adds all 10 fields.
+ */
+export function validateLocationValue(value, fieldName) {
+    // Allow null/undefined to pass through for clears
+    if (value === null || value === undefined) {
+        return value;
+    }
+    const normalizeSingle = (input) => {
+        if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+            throw new UniversalValidationError(`"${fieldName}" must be an object with location fields (line_1, locality, region, postcode, country_code, latitude, longitude).`, ErrorType.USER_ERROR, {
+                field: fieldName,
+                example: JSON.stringify(LOCATION_EXAMPLE),
+                suggestion: 'Provide a location object; all missing fields will be set to null automatically.',
+            });
+        }
+        return normalizeLocation(input);
+    };
+    if (Array.isArray(value)) {
+        return value.map((item, idx) => {
+            try {
+                if (item === null || item === undefined) {
+                    return null;
+                }
+                return normalizeSingle(item);
+            }
+            catch (err) {
+                if (err instanceof UniversalValidationError) {
+                    throw new UniversalValidationError(`${err.message} (item ${idx})`, err.errorType, {
+                        field: fieldName,
+                        suggestion: err.suggestion,
+                        example: err.example,
+                        cause: err,
+                    });
+                }
+                throw err;
+            }
+        });
+    }
+    return normalizeSingle(value);
+}
+/**
+ * Validates and normalizes a personal-name value.
+ * Accepts string or object with first_name/last_name/full_name.
+ */
+export function validatePersonalNameValue(value, fieldName) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item, idx) => {
+            if (item === null || item === undefined) {
+                return null;
+            }
+            try {
+                return validatePersonalNameValue(item, `${fieldName}[${idx}]`);
+            }
+            catch (err) {
+                if (err instanceof UniversalValidationError) {
+                    throw new UniversalValidationError(`${err.message} (item ${idx})`, err.errorType, {
+                        field: fieldName,
+                        suggestion: err.suggestion,
+                        example: err.example,
+                        cause: err,
+                    });
+                }
+                throw err;
+            }
+        });
+    }
+    const ensureHasNameParts = (nameObj) => {
+        const hasName = ['first_name', 'last_name', 'full_name'].some((k) => {
+            const v = nameObj[k];
+            return typeof v === 'string' && v.trim().length > 0;
+        });
+        if (!hasName) {
+            throw new UniversalValidationError(`"${fieldName}" must include at least one of first_name, last_name, or full_name.`, ErrorType.USER_ERROR, {
+                field: fieldName,
+                example: JSON.stringify({
+                    first_name: 'Jane',
+                    last_name: 'Doe',
+                    full_name: 'Jane Doe',
+                }),
+                suggestion: 'Provide first_name/last_name or a full_name string.',
+            });
+        }
+    };
+    if (typeof value === 'string') {
+        const parsed = parsePersonalName(value);
+        if (parsed) {
+            return parsed;
+        }
+        throw new UniversalValidationError(`"${fieldName}" cannot be an empty name string.`, ErrorType.USER_ERROR, {
+            field: fieldName,
+            suggestion: 'Provide a non-empty name such as "Jane Doe".',
+        });
+    }
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        ensureHasNameParts(value);
+        return parsePersonalName(value);
+    }
+    throw new UniversalValidationError(`"${fieldName}" must be a string or object with name fields.`, ErrorType.USER_ERROR, {
+        field: fieldName,
+        example: JSON.stringify({ full_name: 'Jane Doe' }),
+        suggestion: 'Provide a string ("Jane Doe") or an object with first_name/last_name.',
+    });
+}
+/**
+ * Validates phone-number values. Ensures each entry has phone_number or original_phone_number.
+ */
+export function validatePhoneNumberValue(value, fieldName) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    const normalizeSingle = (input) => {
+        if (typeof input === 'string') {
+            const trimmed = input.trim();
+            if (!trimmed) {
+                throw new UniversalValidationError(`"${fieldName}" phone number cannot be empty.`, ErrorType.USER_ERROR, {
+                    field: fieldName,
+                    suggestion: 'Provide a phone number like +15551234567.',
+                    example: '+15551234567',
+                });
+            }
+            return { original_phone_number: trimmed };
+        }
+        if (typeof input === 'object' && input !== null && !Array.isArray(input)) {
+            const record = { ...input };
+            const phone = typeof record.phone_number === 'string'
+                ? record.phone_number
+                : typeof record.original_phone_number === 'string'
+                    ? record.original_phone_number
+                    : undefined;
+            if (!phone || phone.trim().length === 0) {
+                throw new UniversalValidationError(`"${fieldName}" requires phone_number or original_phone_number.`, ErrorType.USER_ERROR, {
+                    field: fieldName,
+                    example: JSON.stringify({
+                        phone_number: '+15551234567',
+                        country_code: 'US',
+                    }),
+                    suggestion: 'Add a phone_number string; optional country_code is ISO 2-letter.',
+                });
+            }
+            // Attio expects original_phone_number key; accept phone_number input for compatibility.
+            const normalizedPhone = phone.trim();
+            record.original_phone_number = normalizedPhone;
+            if ('phone_number' in record) {
+                delete record.phone_number;
+            }
+            return record;
+        }
+        throw new UniversalValidationError(`"${fieldName}" must be a phone number string or object.`, ErrorType.USER_ERROR, {
+            field: fieldName,
+            example: '+15551234567',
+            suggestion: 'Provide a string or { phone_number: "..." } object.',
+        });
+    };
+    if (Array.isArray(value)) {
+        return value.map((item, idx) => {
+            try {
+                if (item === null || item === undefined) {
+                    return null;
+                }
+                return normalizeSingle(item);
+            }
+            catch (err) {
+                if (err instanceof UniversalValidationError) {
+                    throw new UniversalValidationError(`${err.message} (item ${idx})`, err.errorType, {
+                        field: fieldName,
+                        suggestion: err.suggestion,
+                        example: err.example,
+                        cause: err,
+                    });
+                }
+                throw err;
+            }
+        });
+    }
+    return normalizeSingle(value);
+}
+//# sourceMappingURL=complex-type-validation.js.map

package/dist/utils/complex-type-validation.js.map

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

package/dist/utils/config-loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Interface for mapping configuration
+ */
+export interface MappingConfig {
+    version: string;
+    metadata?: Record<string, unknown>;
+    mappings: {
+        attributes: {
+            common: Record<string, string>;
+            objects: Record<string, Record<string, string>>;
+            custom: Record<string, string>;
+        };
+        objects: Record<string, string>;
+        lists: Record<string, string>;
+        relationships: Record<string, string>;
+        [key: string]: Record<string, unknown>;
+    };
+}
+/**
+ * Invalidates the cached mapping configuration
+ * Call this when the config files are updated (e.g., after attio-discover)
+ */
+export declare function invalidateMappingConfigCache(): void;
+/**
+ * Loads and merges the mapping configuration from default and user files
+ * Uses caching to avoid repeated disk I/O on hot paths
+ *
+ * @returns The merged mapping configuration
+ */
+export declare function loadMappingConfig(): MappingConfig;
+/**
+ * Writes a mapping configuration to a file
+ *
+ * @param config - The configuration to write
+ * @param filePath - The file path to write to (defaults to user.json)
+ */
+export declare function writeMappingConfig(config: MappingConfig, filePath?: string): Promise<void>;
+/**
+ * Updates a specific section of the mapping configuration
+ *
+ * @param section - The section to update (e.g., 'attributes.common')
+ * @param mappings - The mappings to set or merge
+ * @param merge - Whether to merge with existing mappings (default: true)
+ * @param filePath - The file path to write to (defaults to user.json)
+ */
+export declare function updateMappingSection(section: string, mappings: Record<string, unknown>, merge?: boolean, filePath?: string): Promise<void>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAE;QACR,UAAU,EAAE;YACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAChC,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;CACH;AAgBD;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAoKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAoCjD;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,GAAE,OAAc,EACrB,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAqCf"}