attio-mcp 0.1.2 → 1.1.0

package/dist/utils/error-enhancer.js

@@ -4,22 +4,15 @@
 import { ValueMatchError } from '../errors/value-match-error.js';
 import { findBestValueMatch, } from './value-matcher.js';
 import axios from 'axios';
+import { createScopedLogger } from './logger.js';
 // Known valid values for select fields - this should ideally come from Attio API
 const KNOWN_FIELD_VALUES = {
-    type_persona: [
-        'Plastic Surgeon',
-        'Medical Spa/Aesthetics',
-        'Dermatologist',
-        'Medical Practice',
-        'Wellness Center',
-        'Cosmetic Surgery',
-        'Aesthetic Medicine',
-        'Primary Care',
-        'Specialist',
-        'Hospital',
-        'Clinic',
-    ],
-    industry: [
+    // Note: type_persona removed as it doesn't exist in Attio API
+    // Custom fields should be discovered via CLI or auto-discovery
+    categories: [
+        'B2B',
+        'B2C',
+        'SaaS',
         'Healthcare',
         'Technology',
         'Finance',
@@ -45,51 +38,65 @@ const KNOWN_FIELD_VALUES = {
  * Parse API error to extract context
  */
 function parseApiError(error) {
-    console.error(`[enhancer-parseApiError] --- ENTERING parseApiError ---`);
-    console.error(`[enhancer-parseApiError] error type: ${typeof error}, constructor: ${error?.constructor?.name}`);
+    // Use imported createScopedLogger
+    const log = createScopedLogger('utils.error-enhancer', 'parseApiError');
+    log.debug('ENTERING parseApiError');
+    log.debug('Error type info', {
+        type: typeof error,
+        ctor: error?.constructor?.name,
+    });
     if (error && typeof error === 'object') {
-        console.error(`[enhancer-parseApiError] error keys: ${JSON.stringify(Object.keys(error))}`);
-        console.error(`[enhancer-parseApiError] error.message from input: ${error.message}`);
+        log.debug('Error keys', { keys: Object.keys(error) });
+        log.debug('Error message from input', { message: error.message });
     }
     const isAxios = axios.isAxiosError(error);
-    console.error(`[enhancer-parseApiError] Step 1: axios.isAxiosError(error) result: ${isAxios}`);
+    log.debug('axios.isAxiosError result', { isAxios });
     let responseExists = false;
     let responseDataExists = false;
     let responseDataContent = 'N/A';
     if (isAxios && error.response) {
         responseExists = true;
-        console.error(`[enhancer-parseApiError] Step 2: error.response exists. Keys: ${JSON.stringify(Object.keys(error.response))}`);
+        log.debug('Response exists. Keys', { keys: Object.keys(error.response) });
         if (error.response.data) {
             responseDataExists = true;
             try {
                 responseDataContent = JSON.stringify(error.response.data);
             }
-            catch (e) {
+            catch {
+                // Failed to stringify response data
                 responseDataContent = 'Error stringifying response.data';
             }
-            console.error(`[enhancer-parseApiError] Step 3: error.response.data exists. Type: ${typeof error
-                .response.data}, Content: ${responseDataContent}`);
+            log.debug('Response data exists', {
+                type: typeof error.response.data,
+                content: responseDataContent,
+            });
         }
         else {
-            console.error(`[enhancer-parseApiError] Step 3: error.response.data is FALSY.`);
+            log.debug('Response data is falsy');
         }
     }
     else {
-        console.error(`[enhancer-parseApiError] Step 2: error.response is FALSY or not an Axios error for this check.`);
-        console.error(`[enhancer-parseApiError] Step 3: error.response.data is FALSY (because error.response was not available).`);
+        log.debug('Response is falsy or not an Axios error for this check');
+        log.debug('Response data is falsy (no response)');
     }
-    console.error(`[enhancer-parseApiError] FINAL CHECK BEFORE CONDITION: isAxios=${isAxios}, responseExists=${responseExists}, responseDataExists=${responseDataExists}`);
+    log.debug('Final check before condition', {
+        isAxios,
+        responseExists,
+        responseDataExists,
+    });
     if (isAxios &&
         responseExists &&
         responseDataExists &&
         error.response &&
         error.response.data) {
-        console.error(`[enhancer-parseApiError] --- CONDITION MET --- Processing error.response.data...`);
+        // Use imported createScopedLogger
+        const log = createScopedLogger('utils.error-enhancer', 'parseApiError');
+        log.debug('Condition met: processing error.response.data');
         const data = error.response.data;
         const message = typeof data.message === 'string' ? data.message : '';
         const pathArray = Array.isArray(data.path) && data.path.length > 0 ? data.path : [];
         const path = typeof pathArray[0] === 'string' ? pathArray[0] : undefined;
-        console.error(`[enhancer-parseApiError] Extracted from data: message='${message}', path='${path}'`);
+        log.debug('Extracted from response.data', { message, path });
         if (message.includes('Unknown select option name') ||
             message.includes('Unknown multi-select option names')) {
             const valueMatch = message.match(/constraint: (.*)/);
@@ -103,44 +110,54 @@ function parseApiError(error) {
                 errorMessage: message,
             };
         }
-        console.error(`[enhancer-parseApiError] --- RETURNING Non-ValueMismatch Axios context: field='${path}' ---`);
+        createScopedLogger('utils.error-enhancer', 'parseApiError').debug('Returning Non-ValueMismatch Axios context', { field: path });
         return { fieldSlug: path, errorMessage: message };
     }
-    console.error(`[enhancer-parseApiError] --- CONDITION NOT MET ---`);
+    createScopedLogger('utils.error-enhancer', 'parseApiError').debug('Condition not met');
     const genericErrorMessage = error && typeof error.message === 'string'
         ? error.message
         : 'Unknown error';
-    console.error(`[enhancer-parseApiError] Returning generic message: '${genericErrorMessage}'`);
+    createScopedLogger('utils.error-enhancer', 'parseApiError').debug('Returning generic message', { genericErrorMessage });
     return { errorMessage: genericErrorMessage };
 }
 /**
  * Enhance an API error with value suggestions if applicable
  */
 export function enhanceApiError(error) {
-    console.error('[enhancer] Called with error type:', error?.constructor?.name, '. Is Axios Error:', error?.isAxiosError);
-    console.error('[enhancer] Attempting to enhance error. Message property:', error?.message, '. ResponseData property:', JSON.stringify(error?.response?.data));
+    // Use imported createScopedLogger
+    const log = createScopedLogger('utils.error-enhancer', 'enhanceApiError');
+    log.debug('Called with error', {
+        type: error?.constructor?.name,
+        isAxiosError: !!error?.isAxiosError,
+    });
+    log.debug('Attempting to enhance error', {
+        message: error?.message,
+        responseData: error?.response?.data,
+    });
     const mismatchCheck = isValueMismatchError(error);
-    console.error('[enhancer] Mismatch check result:', JSON.stringify(mismatchCheck));
+    log.debug('Mismatch check result', mismatchCheck);
     if (mismatchCheck.isMismatch &&
         mismatchCheck.fieldSlug &&
         mismatchCheck.searchValue) {
         const fieldSlug = mismatchCheck.fieldSlug;
         const searchValue = mismatchCheck.searchValue;
         const knownValues = KNOWN_FIELD_VALUES[fieldSlug]; // Already checked in isValueMismatchError, but good for clarity
-        console.error(`[enhancer] Value mismatch confirmed for field: ${fieldSlug}, value: ${searchValue}.`);
+        log.debug('Value mismatch confirmed', { fieldSlug, searchValue });
         if (knownValues) {
-            console.error(`[enhancer] Attempting to find best match for '${searchValue}' in known values for '${fieldSlug}'.`);
+            log.debug('Attempting to find best match', { fieldSlug, searchValue });
             const matchResult = findBestValueMatch(searchValue, knownValues);
-            console.error('[enhancer] Match result from findBestValueMatch:', JSON.stringify(matchResult));
-            console.error('[enhancer] Returning NEW ValueMatchError');
+            log.debug('Match result from findBestValueMatch', matchResult);
+            log.debug('Returning NEW ValueMatchError');
             return new ValueMatchError(fieldSlug, searchValue, matchResult, error // Pass original Axios error for reference
             );
         }
     }
     else {
-        console.error('[enhancer] No value mismatch, or field/value not actionable. Error message from mismatchCheck:', mismatchCheck.errorMessage);
+        log.debug('No actionable mismatch', {
+            errorMessage: mismatchCheck.errorMessage,
+        });
     }
-    console.error('[enhancer] No specific enhancement applied. Returning original error.');
+    log.debug('No specific enhancement applied; returning original error');
     return error; // Fallback: return original error if not enhanced
 }
 /**
@@ -148,14 +165,14 @@ export function enhanceApiError(error) {
  */
 export function isValueMismatchError(error) {
     const context = parseApiError(error);
-    console.error('[enhancer-isValueMismatchError] Context from parseApiError:', JSON.stringify(context));
+    createScopedLogger('utils.error-enhancer', 'isValueMismatchError').debug('Context from parseApiError', context);
     if (context.fieldSlug &&
         context.searchValue &&
         KNOWN_FIELD_VALUES[context.fieldSlug]) {
         const knownValues = KNOWN_FIELD_VALUES[context.fieldSlug];
         if (knownValues &&
             !knownValues.some((v) => v.toLowerCase() === context.searchValue?.toLowerCase())) {
-            console.error(`[enhancer-isValueMismatchError] Mismatch found for field '${context.fieldSlug}', value '${context.searchValue}'.`);
+            createScopedLogger('utils.error-enhancer', 'isValueMismatchError').debug('Mismatch found', { fieldSlug: context.fieldSlug, searchValue: context.searchValue });
             return {
                 isMismatch: true,
                 fieldSlug: context.fieldSlug,
@@ -164,7 +181,7 @@ export function isValueMismatchError(error) {
             };
         }
     }
-    console.error('[enhancer-isValueMismatchError] No mismatch or field/value not in KNOWN_FIELD_VALUES.');
+    createScopedLogger('utils.error-enhancer', 'isValueMismatchError').debug('No mismatch or field/value not in KNOWN_FIELD_VALUES');
     return { isMismatch: false, errorMessage: context.errorMessage };
 }
 /**

package/dist/utils/error-enhancer.js.map

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

package/dist/utils/error-examples.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Error examples utility
+ *
+ * Provides helpful examples for common error scenarios to enhance error messages
+ */
+import { ErrorType } from './error-handler.js';
+import { UnknownObject } from './types/common.js';
+interface ErrorExample {
+    description: string;
+    example: UnknownObject;
+    tip?: string;
+}
+/**
+ * Get helpful examples based on error context
+ */
+export declare function getErrorExamples(errorType: ErrorType, context: {
+    toolName?: string;
+    paramName?: string;
+    expectedType?: string;
+    actualValue?: unknown;
+    path?: string;
+}): ErrorExample[];
+/**
+ * Enhance an error message with helpful examples and field suggestions
+ */
+export declare function enhanceErrorMessage(originalMessage: string, errorType: ErrorType, context: {
+    toolName?: string;
+    paramName?: string;
+    expectedType?: string;
+    actualValue?: unknown;
+    path?: string;
+    fieldName?: string;
+    validFields?: string[];
+    validValues?: string[];
+    resourceType?: string;
+    isReadOnly?: boolean;
+    operation?: 'create' | 'update';
+}): string;
+export {};
+//# sourceMappingURL=error-examples.d.ts.map

package/dist/utils/error-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-examples.d.ts","sourceRoot":"","sources":["../../src/utils/error-examples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,YAAY,EAAE,CAuGhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACjC,GACA,MAAM,CA+ER"}

package/dist/utils/error-examples.js

@@ -0,0 +1,163 @@
+/**
+ * Error examples utility
+ *
+ * Provides helpful examples for common error scenarios to enhance error messages
+ */
+import { ErrorType } from './error-handler.js';
+import { generateFieldSuggestionMessage, generateEnumSuggestionMessage, generateReadOnlyFieldMessage, generateResourceTypeSuggestionMessage, VALID_RESOURCE_TYPES, } from './field-suggestions.js';
+/**
+ * Get helpful examples based on error context
+ */
+export function getErrorExamples(errorType, context) {
+    const examples = [];
+    switch (errorType) {
+        case ErrorType.PARAMETER_ERROR:
+            if (context.paramName === 'filters') {
+                examples.push({
+                    description: 'Correct filters format',
+                    example: {
+                        filters: {
+                            filters: [
+                                {
+                                    attribute: { slug: 'name' },
+                                    condition: 'contains',
+                                    value: 'Company Inc',
+                                },
+                            ],
+                        },
+                    },
+                    tip: 'The filters parameter must contain a "filters" property with an array of filter conditions',
+                });
+            }
+            else if (context.paramName === 'updates' ||
+                context.paramName === 'attributes') {
+                examples.push({
+                    description: 'Correct attributes format',
+                    example: {
+                        name: 'New Company Name',
+                        lead_score: 90,
+                        team_size: 50,
+                        website: 'https://example.com',
+                    },
+                    tip: 'Provide a flat object with field names as keys and values as the new values',
+                });
+            }
+            else if (context.paramName?.includes('Id')) {
+                examples.push({
+                    description: 'Correct ID format',
+                    example: {
+                        [context.paramName]: 'rec_1234567890abcdef',
+                    },
+                    tip: 'IDs should be the full record ID from Attio, not a numeric value',
+                });
+            }
+            break;
+        case ErrorType.VALIDATION_ERROR:
+            if (context.expectedType === 'number' &&
+                typeof context.actualValue === 'string') {
+                examples.push({
+                    description: 'String values for numeric fields are automatically converted',
+                    example: {
+                        lead_score: '90', // Will be converted to 90
+                        team_size: '50', // Will be converted to 50
+                    },
+                    tip: 'You can provide numeric values as strings - they will be converted automatically',
+                });
+            }
+            else if (context.expectedType === 'boolean') {
+                examples.push({
+                    description: 'Boolean field formats',
+                    example: {
+                        is_customer: true,
+                        active: 'true', // String 'true' is accepted
+                        verified: 1, // 1 is accepted as true
+                    },
+                    tip: 'Boolean fields accept: true/false, "true"/"false", 1/0',
+                });
+            }
+            break;
+        case ErrorType.FORMAT_ERROR:
+            if (context.toolName?.includes('note')) {
+                examples.push({
+                    description: 'Create note requires both title and content',
+                    example: {
+                        title: 'Meeting Notes',
+                        content: 'Discussed Q4 strategy and budget planning',
+                    },
+                    tip: 'Both title and content are required when creating notes',
+                });
+            }
+            break;
+        default:
+            // Generic helpful examples
+            if (context.toolName?.includes('update')) {
+                examples.push({
+                    description: 'Update operations accept multiple parameter names',
+                    example: {
+                        // Option 1: Resource-specific ID
+                        companyId: 'rec_1234567890abcdef',
+                        // Option 2: Generic recordId
+                        recordId: 'rec_1234567890abcdef',
+                    },
+                    tip: 'You can use either resource-specific IDs (companyId, personId) or the generic recordId',
+                });
+            }
+    }
+    return examples;
+}
+/**
+ * Enhance an error message with helpful examples and field suggestions
+ */
+export function enhanceErrorMessage(originalMessage, errorType, context) {
+    let enhancedMessage = originalMessage;
+    // Apply field name suggestions if we have validation errors
+    if (errorType === ErrorType.VALIDATION_ERROR ||
+        errorType === ErrorType.PARAMETER_ERROR) {
+        // Check for invalid field name scenarios
+        if (context.fieldName &&
+            context.validFields &&
+            context.validFields.length > 0) {
+            if (!context.validFields.includes(context.fieldName)) {
+                enhancedMessage = generateFieldSuggestionMessage(context.fieldName, context.validFields, context.resourceType);
+            }
+            else if (context.isReadOnly) {
+                enhancedMessage = generateReadOnlyFieldMessage(context.fieldName, context.operation);
+            }
+        }
+        // Check for invalid enum values
+        if (context.fieldName &&
+            context.validValues &&
+            context.validValues.length > 0) {
+            if (context.actualValue !== undefined && context.actualValue !== null) {
+                const valueStr = String(context.actualValue);
+                if (!context.validValues.includes(valueStr)) {
+                    // Only pass primitive values to generateEnumSuggestionMessage
+                    const primitiveValue = typeof context.actualValue === 'string' ||
+                        typeof context.actualValue === 'number' ||
+                        typeof context.actualValue === 'boolean'
+                        ? context.actualValue
+                        : valueStr;
+                    enhancedMessage = generateEnumSuggestionMessage(primitiveValue, context.validValues, context.fieldName);
+                }
+            }
+        }
+        // Check for invalid resource types
+        if (context.resourceType &&
+            !VALID_RESOURCE_TYPES.includes(context.resourceType)) {
+            enhancedMessage = generateResourceTypeSuggestionMessage(context.resourceType, VALID_RESOURCE_TYPES);
+        }
+    }
+    // Add examples to the enhanced message
+    const examples = getErrorExamples(errorType, context);
+    if (examples.length > 0) {
+        examples.forEach((example) => {
+            enhancedMessage += `\n\n${example.description}:`;
+            enhancedMessage += `\n${JSON.stringify(example.example, null, 2)}`;
+            if (example.tip) {
+                enhancedMessage += `\n\nTIP: ${example.tip}`;
+            }
+        });
+    }
+    return enhancedMessage;
+}
+//# sourceMappingURL=error-examples.js.map

package/dist/utils/error-examples.js.map

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

package/dist/utils/error-handler.d.ts

@@ -30,9 +30,9 @@ export interface ErrorDetails {
         method?: string;
         path?: string;
         detail?: string;
-        responseData?: Record<string, any>;
+        responseData?: Record<string, unknown>;
         originalError?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 /**
@@ -43,9 +43,9 @@ export declare class AttioApiError extends Error {
     detail: string;
     path: string;
     method: string;
-    responseData: any;
+    responseData: Record<string, unknown>;
     type: ErrorType;
-    constructor(message: string, status: number, detail: string, path: string, method: string, type?: ErrorType, responseData?: any);
+    constructor(message: string, status: number, detail: string, path: string, method: string, type?: ErrorType, responseData?: Record<string, unknown>);
 }
 /**
  * Creates a specific API error based on status code and context
@@ -56,7 +56,7 @@ export declare class AttioApiError extends Error {
  * @param responseData - Response data from API
  * @returns Appropriate error instance
  */
-export declare function createAttioError(error: any): Error;
+export declare function createAttioError(error: Error | Record<string, unknown>): Error;
 /**
  * Creates a specific API error based on status code and context
  *
@@ -66,7 +66,7 @@ export declare function createAttioError(error: any): Error;
  * @param responseData - Response data from API
  * @returns Appropriate error instance
  */
-export declare function createApiError(status: number, path: string, method: string, responseData?: any): Error;
+export declare function createApiError(status: number, path: string, method: string, responseData?: Record<string, unknown>): Error;
 /**
  * Format an error into a standardized response based on error type
  *
@@ -75,7 +75,7 @@ export declare function createApiError(status: number, path: string, method: str
  * @param details - Additional error details
  * @returns Formatted error response
  */
-export declare function formatErrorResponse(error: Error, type?: ErrorType, details?: any): any;
+export declare function formatErrorResponse(error: Error, type?: ErrorType, details?: Record<string, unknown>): unknown;
 /**
  * Creates a detailed error response for API errors, suitable for returning to MCP clients
  *
@@ -85,5 +85,8 @@ export declare function formatErrorResponse(error: Error, type?: ErrorType, deta
  * @param responseData - Any response data received
  * @returns Formatted error result
  */
-export declare function createErrorResult(error: Error | any, url: string, method: string, responseData?: AttioErrorResponse): any;
+export declare function createErrorResult(error: Error | Record<string, unknown>, url: string, method: string, responseData?: AttioErrorResponse & {
+    toolName?: string;
+    paramName?: string;
+}): unknown;
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,oBAAY,SAAS;IACnB,gBAAgB,qBAAqB;IACrC,SAAS,cAAc;IACvB,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,GAAG,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;gBAGd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,SAA+B,EACrC,YAAY,GAAE,GAAQ;CAWzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,CAgBlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,GAAQ,GACrB,KAAK,CA6GP;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,SAAmC,EACzC,OAAO,CAAC,EAAE,GAAG,OAoGd;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,GAAG,GAAG,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,kBAAuB,OA8FtC"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKvD;;GAEG;AACH,oBAAY,SAAS;IACnB,gBAAgB,qBAAqB;IACrC,SAAS,cAAc;IACvB,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;CAChC;AAeD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,EAAE,SAAS,CAAC;gBAGd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,SAA+B,EACrC,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAW7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,KAAK,CAmCP;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACzC,KAAK,CAoHP;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,SAAmC,EACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAoHlC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,kBAAkB,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,WAyGP"}