@iflow-mcp/attio-mcp 1.3.6

package/dist/services/UniversalUpdateService.js

@@ -0,0 +1,414 @@
+/**
+ * UniversalUpdateService - Centralized record update operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal update functionality across all resource types.
+ *
+ * ENVIRONMENT VARIABLES (Runtime Behavior Configuration):
+ *
+ * @env ENABLE_ENHANCED_VALIDATION - Enable additional validation checks (default: false)
+ *      Values: "true" | "false" | undefined
+ *      Example: ENABLE_ENHANCED_VALIDATION="true"
+ *      Impact: Adds extra field validation before API calls
+ *      Production Risk: May reject previously valid requests
+ *
+ * @env ENABLE_FIELD_VERIFICATION - Enable post-update field verification (default: true)
+ *      Values: "true" | "false" | undefined
+ *      Example: ENABLE_FIELD_VERIFICATION="false"
+ *      Impact: Skips verification that fields were persisted correctly
+ *      Production Risk: Silent data consistency issues if disabled
+ *
+ * @env STRICT_FIELD_VALIDATION - Fail operations on verification failures (default: false)
+ *      Values: "true" | "false" | undefined
+ *      Example: STRICT_FIELD_VALIDATION="true"
+ *      Impact: Throws errors when field verification fails instead of logging warnings
+ *      Production Risk: Operations may fail that previously succeeded with warnings
+ *
+ * PRODUCTION SAFETY NOTES:
+ * - These environment variables significantly change runtime behavior
+ * - Test thoroughly in staging before changing production values
+ * - Monitor error rates and data consistency when changing validation settings
+ * - Consider gradual rollout with feature flags for validation strictness changes
+ * - Document all environment variable usage in deployment runbooks
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import { UniversalValidationError, ErrorType, } from '../handlers/tool-configs/universal/schemas.js';
+import { debug } from '../utils/logger.js';
+// Import shared type definitions for better type safety
+import { createNotFoundError, } from '../types/universal-service-types.js';
+// Import services
+import { ValidationService } from '../services/ValidationService.js';
+// Import field mapping utilities
+import { mapRecordFields, validateResourceType, validateFields, getValidResourceTypes, mapTaskFields, } from '../handlers/tool-configs/universal/field-mapper.js';
+// Import validation utilities
+import { validateRecordFields } from '../utils/validation-utils.js';
+// Note: Deal defaults configuration removed as unused in update service
+// Note: Removed unused resource-specific function imports as service now uses strategy pattern
+/**
+ * UniversalUpdateService provides centralized record update functionality
+ *
+ * **Type Safety Enhancements**: This service uses Record<string, unknown> instead of any
+ * for better type safety. This provides compile-time checking while allowing dynamic
+ * property access needed for flexible API data handling.
+ *
+ * **Design Rationale**: Record<string, unknown> prevents accidental misuse of properties
+ * while maintaining the flexibility required for varied API response structures.
+ */
+export class UniversalUpdateService {
+    /**
+     * Enhanced update method that returns validation metadata
+     */
+    static async updateRecordWithValidation(params) {
+        // Validate resource type is supported
+        const validResourceTypes = Object.values(UniversalResourceType);
+        if (!validResourceTypes.includes(params.resource_type)) {
+            throw new UniversalValidationError(`Unsupported resource type: ${params.resource_type}`, ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: `Valid resource types are: ${validResourceTypes.join(', ')}`,
+            });
+        }
+        try {
+            return await this._updateRecordInternalWithValidation(params);
+        }
+        catch (error) {
+            // Check if this is already a structured HTTP response - if so, pass it through unchanged
+            if (error &&
+                typeof error === 'object' &&
+                'status' in error &&
+                'body' in error) {
+                throw error; // Pass through HTTP-like errors unchanged
+            }
+            // Handle TypeError exceptions that occur from malformed data
+            if (error instanceof TypeError &&
+                error.message.includes('Cannot read properties of undefined')) {
+                // For TypeErrors caused by malformed data structure, return 404 for tasks
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Also handle wrapped TypeErrors from MockService
+            if (error instanceof Error &&
+                error.message.includes('Failed to update task: Cannot read properties of undefined')) {
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Re-throw all other errors with cause preserved
+            throw error;
+        }
+    }
+    static async updateRecord(params) {
+        // Validate resource type is supported
+        const validResourceTypes = Object.values(UniversalResourceType);
+        if (!validResourceTypes.includes(params.resource_type)) {
+            throw new UniversalValidationError(`Unsupported resource type: ${params.resource_type}`, ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: `Valid resource types are: ${validResourceTypes.join(', ')}`,
+            });
+        }
+        try {
+            return await this._updateRecordInternal(params);
+        }
+        catch (error) {
+            // Check if this is already a structured HTTP response - if so, pass it through unchanged
+            if (error &&
+                typeof error === 'object' &&
+                'status' in error &&
+                'body' in error) {
+                throw error; // Pass through HTTP-like errors unchanged
+            }
+            // Handle TypeError exceptions that occur from malformed data
+            if (error instanceof TypeError &&
+                error.message.includes('Cannot read properties of undefined')) {
+                // For TypeErrors caused by malformed data structure, return 404 for tasks
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Also handle wrapped TypeErrors from MockService
+            if (error instanceof Error &&
+                error.message.includes('Failed to update task: Cannot read properties of undefined')) {
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Re-throw all other errors with cause preserved
+            throw error;
+        }
+    }
+    /**
+     * Internal update record implementation with validation tracking
+     */
+    static async _updateRecordInternalWithValidation(params) {
+        const validationResult = {
+            warnings: [],
+            actualValues: {},
+            suggestions: [],
+        };
+        const { resource_type, record_id, record_data } = params;
+        const legacyData = params.data;
+        const actualRecordData = (record_data ?? legacyData);
+        // Enhanced null-safety: Guard against undefined values access
+        /**
+         * **Record<string, unknown> Rationale**: Using Record<string, unknown> instead of any
+         * ensures type safety while allowing dynamic property access for API data structures.
+         * This prevents runtime errors while maintaining flexibility for varied data formats.
+         */
+        const raw = actualRecordData && typeof actualRecordData === 'object'
+            ? actualRecordData
+            : {};
+        const values = raw.values ?? raw;
+        // Pre-validate fields and provide helpful suggestions (less strict for updates)
+        const fieldValidation = validateFields(resource_type, values);
+        if (fieldValidation.warnings.length > 0) {
+            validationResult.warnings.push(...fieldValidation.warnings);
+            // Use structured logging for field validation warnings
+            debug('UniversalUpdateService', 'Field validation warnings', {
+                warnings: fieldValidation.warnings.join('\n'),
+            });
+        }
+        if (fieldValidation.suggestions.length > 0) {
+            validationResult.suggestions.push(...fieldValidation.suggestions);
+            const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+            debug('UniversalUpdateService', 'Field suggestions:', {
+                suggestions: truncated.join('\n'),
+            });
+        }
+        // Apply deal-specific validation for deals
+        if (resource_type === UniversalResourceType.DEALS) {
+            try {
+                const { applyDealDefaultsWithValidation } = await import('../config/deal-defaults.js');
+                const dealValidation = await applyDealDefaultsWithValidation(values, false // Don't skip API validation for user requests
+                );
+                // Update values with validated deal data
+                Object.assign(values, dealValidation.dealData);
+                // Collect deal-specific warnings and suggestions
+                validationResult.warnings.push(...dealValidation.warnings);
+                validationResult.suggestions.push(...dealValidation.suggestions);
+                debug('UniversalUpdateService', 'Deal validation applied', {
+                    warnings: dealValidation.warnings,
+                    suggestions: dealValidation.suggestions,
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                validationResult.warnings.push(`Deal validation warning: ${errorMessage}`);
+                debug('UniversalUpdateService', 'Deal validation failed', {
+                    error: errorMessage,
+                });
+            }
+        }
+        // Continue with the rest of the update process using existing logic
+        // Skip verification in _updateRecordInternal to avoid duplication
+        const record = await this._updateRecordInternal(params, true);
+        // Store actual values for comparison
+        validationResult.actualValues = record.values || {};
+        // Capture field persistence verification warnings if enabled
+        if (process.env.ENABLE_FIELD_VERIFICATION !== 'false') {
+            try {
+                // Reconstruct sanitized data for verification
+                const { mapped: mappedData } = await mapRecordFields(resource_type, values);
+                const attioPayload = { values: mappedData };
+                const { UpdateValidation } = await import('./update/UpdateValidation.js');
+                const { FieldPersistenceHandler } = await import('./update/FieldPersistenceHandler.js');
+                const sanitizedData = UpdateValidation.sanitizeSpecialCharacters(attioPayload.values);
+                // UNIFIED: Single call to FieldPersistenceHandler (Issue #984 extension)
+                // Eliminates duplicate semantic filtering logic by using shared implementation
+                const verification = await FieldPersistenceHandler.verifyPersistence(resource_type, record_id, sanitizedData, validationResult.actualValues, // Pass actual values from line 326
+                {
+                    strict: process.env.STRICT_FIELD_VALIDATION === 'true',
+                    skip: false,
+                });
+                // Surface complete VerificationResult into validationResult
+                validationResult.warnings.push(...verification.warnings);
+                validationResult.fieldVerification = {
+                    verified: verification.verified,
+                    discrepancies: verification.discrepancies,
+                };
+                // Also add discrepancies as warnings for backward compatibility
+                if (verification.discrepancies.length > 0) {
+                    validationResult.warnings.push(...verification.discrepancies.map((discrepancy) => `Field persistence issue: ${discrepancy}`));
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                validationResult.warnings.push(`Field verification warning: ${errorMessage}`);
+            }
+        }
+        return {
+            record,
+            validation: validationResult,
+        };
+    }
+    /**
+     * Internal update record implementation
+     */
+    static async _updateRecordInternal(params, skipVerification = false) {
+        const { resource_type, record_id, record_data } = params;
+        const legacyData = params.data;
+        const actualRecordData = (record_data ?? legacyData);
+        // Enhanced null-safety: Guard against undefined values access
+        /**
+         * **Record<string, unknown> Rationale**: Using Record<string, unknown> instead of any
+         * ensures type safety while allowing dynamic property access for API data structures.
+         * This prevents runtime errors while maintaining flexibility for varied data formats.
+         */
+        const raw = actualRecordData && typeof actualRecordData === 'object'
+            ? actualRecordData
+            : {};
+        const values = raw.values ?? raw;
+        // Pre-validate fields and provide helpful suggestions (less strict for updates)
+        const fieldValidation = validateFields(resource_type, values);
+        if (fieldValidation.warnings.length > 0) {
+            // Use structured logging for field validation warnings
+            debug('UniversalUpdateService', 'Field validation warnings', {
+                warnings: fieldValidation.warnings.join('\n'),
+            });
+        }
+        if (fieldValidation.suggestions.length > 0) {
+            const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+            debug('UniversalUpdateService', 'Field suggestions:', {
+                suggestions: truncated.join('\n'),
+            });
+        }
+        // Issue #984: Fetch metadata once using MetadataResolver
+        const { MetadataResolver } = await import('./update/MetadataResolver.js');
+        const { metadataMap, availableAttributes } = await MetadataResolver.fetchMetadata(resource_type, actualRecordData);
+        // Map field names to correct ones with collision detection
+        const mappingResult = await mapRecordFields(resource_type, values, availableAttributes);
+        if (mappingResult.errors && mappingResult.errors.length > 0) {
+            throw new UniversalValidationError(mappingResult.errors.join(' '), ErrorType.USER_ERROR, {
+                field: 'record_data',
+                suggestion: 'Please use only one field for each target. Multiple aliases mapping to the same field are not allowed.',
+                cause: undefined, // No specific cause for mapping errors
+            });
+        }
+        const { mapped: mappedData, warnings } = mappingResult;
+        if (warnings.length > 0) {
+            debug('UniversalUpdateService', 'Field mapping applied:', {
+                warnings: warnings.join('\n'),
+            });
+        }
+        // Always wrap in Attio envelope format
+        const attioPayload = {
+            values: mappedData,
+        };
+        // Apply operation-specific field mapping for tasks (prevent content injection on update)
+        if (resource_type === UniversalResourceType.TASKS) {
+            const updatedTaskData = mapTaskFields('update', mappedData);
+            attioPayload.values = updatedTaskData;
+        }
+        // Normalize values (e.g., phone numbers to E.164)
+        const { normalizeValues } = await import('./normalizers/AttributeAwareNormalizer.js');
+        attioPayload.values = await normalizeValues(resource_type, attioPayload.values, availableAttributes);
+        // Sanitize special characters while preserving intended content
+        const { UpdateValidation } = await import('./update/UpdateValidation.js');
+        const sanitizedData = UpdateValidation.sanitizeSpecialCharacters(attioPayload.values);
+        attioPayload.values = sanitizedData;
+        // Optional enhanced validation
+        // WARNING: This environment variable changes runtime behavior
+        // Production Impact: May reject previously valid requests
+        if (process.env.ENABLE_ENHANCED_VALIDATION === 'true') {
+            const validation = await validateRecordFields(resource_type, attioPayload.values, false);
+            if (!validation.isValid) {
+                const errorMessage = validation.error || 'Validation failed';
+                throw new UniversalValidationError(errorMessage, ErrorType.USER_ERROR, {
+                    suggestion: 'Please fix the validation errors and try again.',
+                    field: undefined,
+                    cause: undefined, // No specific cause for validation errors
+                });
+            }
+        }
+        // FEATURE: Auto-transform values for Issue #980 UX improvements
+        // Transforms: status titles → {status_id: uuid}, single values → arrays for multi-select
+        try {
+            const { transformRecordValues, mayNeedTransformation } = await import('./value-transformer/index.js');
+            // Quick check to avoid unnecessary async work
+            if (mayNeedTransformation(attioPayload.values, resource_type)) {
+                const transformResult = await transformRecordValues(attioPayload.values, {
+                    resourceType: resource_type,
+                    operation: 'update',
+                    recordId: record_id,
+                    // Issue #984: Pass metadata to avoid duplicate fetch
+                    attributeMetadata: metadataMap,
+                });
+                attioPayload.values = transformResult.data;
+                // Log transformations for debugging
+                if (transformResult.transformations.length > 0) {
+                    debug('UniversalUpdateService', 'Value transformations applied', {
+                        transformations: transformResult.transformations.map((t) => ({
+                            field: t.field,
+                            type: t.type,
+                        })),
+                    });
+                }
+                if (transformResult.warnings.length > 0) {
+                    debug('UniversalUpdateService', 'Value transformation warnings', {
+                        warnings: transformResult.warnings,
+                    });
+                }
+            }
+        }
+        catch (transformError) {
+            // If transformation throws (e.g., invalid status value), propagate the error
+            if (transformError instanceof Error) {
+                throw new UniversalValidationError(transformError.message, ErrorType.USER_ERROR, {
+                    suggestion: 'Check that field values match the expected format. Use records_get_attribute_options to see valid options.',
+                    field: undefined,
+                    cause: undefined,
+                });
+            }
+            throw transformError;
+        }
+        // Capture post-transform data for verification (PR #981 review feedback)
+        // This ensures verification compares what was actually sent to API
+        const dataForVerification = { ...attioPayload.values };
+        // Issue #984: Use UpdateOrchestrator for strategy dispatch
+        const { UpdateOrchestrator } = await import('./update/UpdateOrchestrator.js');
+        // Use centralized object slug extraction (fixes DEALS slug inconsistency)
+        // MetadataResolver already imported at line 468
+        const objectSlug = MetadataResolver.extractObjectSlug(resource_type, actualRecordData);
+        const updatedRecord = await UpdateOrchestrator.executeUpdate({
+            resourceType: resource_type,
+            recordId: record_id,
+            sanitizedValues: attioPayload.values,
+            objectSlug,
+        });
+        const { ResponseNormalizer } = await import('./update/ResponseNormalizer.js');
+        const normalizedRecord = ResponseNormalizer.normalizeResponseFormat(resource_type, updatedRecord);
+        // Issue #984: Use FieldPersistenceHandler for verification
+        if (!skipVerification) {
+            const { FieldPersistenceHandler } = await import('./update/FieldPersistenceHandler.js');
+            await FieldPersistenceHandler.verifyPersistence(resource_type, record_id, dataForVerification, normalizedRecord.values || {}, { strict: false });
+        }
+        return normalizedRecord;
+    }
+    static async handleUnsupportedResourceType(resource_type, params) {
+        // Check if resource type can be corrected
+        const resourceValidation = validateResourceType(resource_type);
+        if (resourceValidation.corrected) {
+            // Retry with corrected resource type
+            debug('UniversalUpdateService', `Resource type corrected`, {
+                from: resource_type,
+                to: resourceValidation.corrected,
+            });
+            return this.updateRecord({
+                ...params,
+                resource_type: resourceValidation.corrected,
+            });
+        }
+        throw new UniversalValidationError(`Unsupported resource type: ${resource_type}`, ErrorType.USER_ERROR, {
+            suggestion: resourceValidation.suggestion ||
+                `Valid resource types are: ${getValidResourceTypes()}`,
+        });
+    }
+}
+//# sourceMappingURL=UniversalUpdateService.js.map

package/dist/services/UniversalUpdateService.js.map

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

package/dist/services/UniversalUtilityService.d.ts

@@ -0,0 +1,92 @@
+/**
+ * UniversalUtilityService - Centralized utility functions
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal utility functions for resource type formatting, validation, and data conversion.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import { AttioRecord, AttioTask, AttioRecordValues } from '../types/attio.js';
+/**
+ * UniversalUtilityService provides centralized utility functions
+ */
+export declare class UniversalUtilityService {
+    /**
+     * Utility function to format resource type for display
+     */
+    static formatResourceType(resourceType: UniversalResourceType): string;
+    /**
+     * Utility function to get singular form of resource type
+     */
+    static getSingularResourceType(resourceType: UniversalResourceType): string;
+    /**
+     * Utility function to validate resource type
+     */
+    static isValidResourceType(resourceType: string): resourceType is UniversalResourceType;
+    /**
+     * Converts an AttioTask to an AttioRecord for universal tool compatibility.
+     *
+     * This function provides proper type conversion from the task-specific format
+     * to the generic record format used by universal tools, ensuring data integrity
+     * without unsafe type casting.
+     *
+     * @param task - The AttioTask object to convert
+     * @returns An AttioRecord representation of the task with properly mapped fields
+     *
+     * @example
+     * const task = await getTask('task-123');
+     * const record = UniversalUtilityService.convertTaskToRecord(task);
+     * // record.values now contains: content, status, assignee, due_date, linked_records
+     */
+    static convertTaskToRecord(task: AttioTask): AttioRecord;
+    /**
+     * Extract display name from AttioRecord values with proper field priority
+     *
+     * Centralizes the logic for determining display names from record field values.
+     * Handles both direct object access and array-wrapped values patterns used
+     * throughout the codebase. Eliminates code duplication between formatResult functions.
+     *
+     * Field Priority Order:
+     * 1. name (checks both 'value' and 'full_name' properties)
+     * 2. full_name
+     * 3. title
+     * 4. content
+     * 5. fallback to 'Unnamed'
+     *
+     * @param values - The record values object (can be from record.values or direct values)
+     * @returns The extracted display name string or 'Unnamed' if no suitable field found
+     *
+     * @example
+     * ```typescript
+     * const displayName = UniversalUtilityService.extractDisplayName(record.values);
+     * // For tasks: "Follow up with client" (from content field)
+     * // For companies: "Acme Corp" (from name field)
+     * // For empty record: "Unnamed"
+     * ```
+     */
+    static extractDisplayName(values: AttioRecordValues | Record<string, unknown>): string;
+    /**
+     * Get the plural form of a resource type (opposite of getSingularResourceType)
+     */
+    static getPluralResourceType(resourceType: UniversalResourceType): string;
+    /**
+     * Check if a resource type supports object records API
+     */
+    static supportsObjectRecordsApi(resourceType: UniversalResourceType): boolean;
+    /**
+     * Get the API endpoint pattern for a resource type
+     */
+    static getApiEndpoint(resourceType: UniversalResourceType): string;
+    /**
+     * Check if a resource type requires special handling
+     */
+    static requiresSpecialHandling(resourceType: UniversalResourceType): boolean;
+    /**
+     * Normalize resource type string (handle case variations and common aliases)
+     */
+    static normalizeResourceType(input: string): UniversalResourceType | null;
+    /**
+     * Get human-readable description of a resource type
+     */
+    static getResourceTypeDescription(resourceType: UniversalResourceType): string;
+}
+//# sourceMappingURL=UniversalUtilityService.d.ts.map

package/dist/services/UniversalUtilityService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniversalUtilityService.d.ts","sourceRoot":"","sources":["../../src/services/UniversalUtilityService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EACL,WAAW,EACX,SAAS,EACT,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,qBAAa,uBAAuB;IAClC;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM;IAmBtE;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM;IAI3E;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,YAAY,EAAE,MAAM,GACnB,YAAY,IAAI,qBAAqB;IAMxC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW;IAuExD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClD,MAAM;IAiDT;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM;IAIzE;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,YAAY,EAAE,qBAAqB,GAClC,OAAO;IAgBV;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM;IAmBlE;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO;IAY5E;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IA+BzE;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,YAAY,EAAE,qBAAqB,GAClC,MAAM;CAkBV"}