@iflow-mcp/attio-mcp 1.3.6

package/dist/errors/enhanced-api-errors.js

@@ -0,0 +1,371 @@
+/**
+ * Enhanced API Error System for Consolidated Issues #415, #416, #417
+ *
+ * This module provides comprehensive error messaging with contextual information
+ * to address:
+ * - Issue #415: Poor error message quality and user experience
+ * - Issue #416: Misleading "Invalid format" vs "Not found" confusion
+ * - Issue #417: Task-specific error guidance and field mapping help
+ */
+import { AttioApiError } from './api-errors.js';
+import { isValidUUID } from '../utils/validation/uuid-validation.js';
+/**
+ * Enhanced API Error class that provides contextual error messages
+ *
+ * This class extends the base AttioApiError with rich context information
+ * to provide actionable error messages that guide users toward solutions.
+ */
+export class EnhancedApiError extends AttioApiError {
+    context;
+    constructor(message, statusCode, endpoint, method, context) {
+        super(message, statusCode, endpoint, method);
+        this.context = context;
+        this.name = 'EnhancedApiError';
+        Object.setPrototypeOf(this, EnhancedApiError.prototype);
+    }
+    /**
+     * Check if this is a user error (400-level)
+     */
+    isUserError() {
+        return this.statusCode >= 400 && this.statusCode < 500;
+    }
+    /**
+     * Get error category for classification
+     */
+    getErrorCategory() {
+        if ([401, 403].includes(this.statusCode))
+            return 'auth';
+        if ([400, 404, 422].includes(this.statusCode))
+            return 'user';
+        if ([500, 502, 503, 504].includes(this.statusCode))
+            return 'system';
+        if ([429, 408].includes(this.statusCode))
+            return 'network';
+        return 'unknown';
+    }
+    /**
+     * Generate a contextual error message with actionable guidance
+     *
+     * This method analyzes the error context and constructs helpful messages
+     * that address the specific issues identified in the consolidated issues.
+     */
+    getContextualMessage() {
+        let msg = this.message;
+        // Issue #416: Handle "Not Found" vs "Invalid Format" confusion
+        const notFoundMessage = this.getNotFoundErrorMessage();
+        if (notFoundMessage) {
+            return notFoundMessage;
+        }
+        // Apply various enhancements to the message
+        msg += this.getTaskErrorMessage();
+        msg += this.getFieldValidationMessage();
+        msg += this.getFieldSuggestions();
+        msg += this.getGeneralGuidanceMessage();
+        return msg;
+    }
+    /**
+     * Generate "Record not found" error message for Issue #416
+     */
+    getNotFoundErrorMessage() {
+        if (this.context?.httpStatus === 404 && this.context?.recordId) {
+            let msg = `Record not found: No ${this.context.resourceType} with ID '${this.context.recordId}' exists.`;
+            if (this.context.documentationHint) {
+                msg += ` ${this.context.documentationHint}`;
+            }
+            return msg;
+        }
+        return null;
+    }
+    /**
+     * Generate field suggestions for typos
+     */
+    getFieldSuggestions() {
+        if (this.context?.suggestedFields &&
+            this.context.suggestedFields.length > 0) {
+            return `\n\nDid you mean: ${this.context.suggestedFields.join(', ')}?`;
+        }
+        return '';
+    }
+    /**
+     * Generate task-specific error guidance for Issue #417
+     */
+    getTaskErrorMessage() {
+        if (this.context?.resourceType === 'tasks' && this.context?.field) {
+            return this.getTaskSpecificGuidance();
+        }
+        return '';
+    }
+    /**
+     * Generate field validation error messages for Issue #415
+     */
+    getFieldValidationMessage() {
+        let msg = '';
+        if (this.context?.field && this.context.fieldType) {
+            msg += ` Field '${this.context.field}' expects values of type '${this.context.fieldType}'.`;
+        }
+        // Enhanced select field validation errors
+        if (this.context?.validValues?.length) {
+            msg += ` Valid options for '${this.context.field}' are: [${this.context.validValues.join(', ')}].`;
+        }
+        // Field name suggestions for typos
+        if (this.context?.suggestedFields?.length) {
+            msg += ` Did you mean: ${this.context.suggestedFields.join(', ')}?`;
+        }
+        // Read-only field guidance
+        if (this.context?.isReadOnly && this.context?.field) {
+            msg += ` Field '${this.context.field}' is read-only and cannot be modified. This is a system-managed field.`;
+            if (this.context.resourceType) {
+                msg += ` Use get-attributes ${this.context.resourceType} --categories writable to see updatable fields.`;
+            }
+        }
+        return msg;
+    }
+    /**
+     * Generate general guidance messages
+     */
+    getGeneralGuidanceMessage() {
+        let msg = '';
+        // General documentation hints (avoid duplicating for 404 errors)
+        // Only skip if it's a 404 error (already handled in getNotFoundErrorMessage)
+        if (this.context?.documentationHint && this.context.httpStatus !== 404) {
+            msg += ` ${this.context.documentationHint}`;
+        }
+        // Retry guidance for temporary issues
+        if (this.context?.retryable) {
+            msg += ' This error may be temporary - please try again in a moment.';
+        }
+        return msg;
+    }
+    /**
+     * Generate task-specific error guidance
+     *
+     * Addresses Issue #417 by providing clear guidance for task field mappings
+     * and common task-related errors.
+     */
+    getTaskSpecificGuidance() {
+        const field = this.context?.field;
+        if (!field)
+            return '';
+        // Task field mapping guidance
+        const taskFieldMappings = {
+            title: ' For tasks, use "content" instead of "title" for the main task text.',
+            name: ' For tasks, use "content" instead of "name" for the main task text.',
+            description: ' For tasks, use "content" instead of "description" for the main task text.',
+            assignee: ' For tasks, use "assignee_id" with a workspace member ID, not "assignee".',
+            due: ' For tasks, use "due_date" with ISO date format (YYYY-MM-DD), not "due".',
+            record: ' For tasks, use "record_id" to link to a specific record, not "record".',
+        };
+        const guidance = taskFieldMappings[field.toLowerCase()];
+        if (guidance) {
+            return guidance;
+        }
+        // General task guidance
+        return ` For tasks, valid fields are: content, status, due_date, assignee_id, record_id. Check task API documentation for field requirements.`;
+    }
+    /**
+     * Check if this error is likely retryable
+     */
+    isRetryable() {
+        if (this.context?.retryable !== undefined) {
+            return this.context.retryable;
+        }
+        // 429 (rate limit), 5xx errors are generally retryable
+        const retryableStatuses = [429, 500, 502, 503, 504];
+        return retryableStatuses.includes(this.statusCode);
+    }
+}
+/**
+ * Factory function to create enhanced API errors with proper context
+ */
+export function createEnhancedApiError(message, statusCode, endpoint, method, context) {
+    return new EnhancedApiError(message, statusCode, endpoint, method, context);
+}
+/**
+ * Enhanced error templates for common scenarios
+ *
+ * These templates provide consistent, helpful error messages across the application
+ */
+export const ErrorTemplates = {
+    /**
+     * Issue #415: Invalid select option template
+     */
+    INVALID_SELECT_OPTION: (field, value, validOptions, resourceType) => createEnhancedApiError(`Invalid value '${value}' for field '${field}'`, 400, resourceType ? `/objects/${resourceType}` : '/unknown', 'POST', {
+        field,
+        fieldType: 'select',
+        validValues: validOptions,
+        resourceType,
+        documentationHint: `Use get-attributes${resourceType ? ` ${resourceType}` : ''} to see all available values.`,
+    }),
+    /**
+     * Issue #415: Read-only field template
+     */
+    READ_ONLY_FIELD: (field, resourceType) => createEnhancedApiError(`Field '${field}' cannot be modified`, 400, `/objects/${resourceType}`, 'POST', {
+        field,
+        resourceType,
+        isReadOnly: true,
+        documentationHint: `Use get-attributes ${resourceType} --categories writable to see updatable fields.`,
+    }),
+    /**
+     * Issue #415: Unknown field template
+     */
+    UNKNOWN_FIELD: (field, suggestions, resourceType) => createEnhancedApiError(`Unknown field '${field}' for resource type '${resourceType}'`, 400, `/objects/${resourceType}`, 'POST', {
+        field,
+        suggestedFields: suggestions,
+        resourceType,
+        documentationHint: `Use get-attributes ${resourceType} to see all available fields with their correct names.`,
+    }),
+    /**
+     * Issue #416: Record not found template (vs invalid format)
+     */
+    RECORD_NOT_FOUND: (recordId, resourceType) => createEnhancedApiError(`Record not found`, 404, `/objects/${resourceType}/${recordId}`, 'GET', {
+        recordId,
+        resourceType,
+        httpStatus: 404,
+        documentationHint: `Use search-records to find valid ${resourceType} IDs.`,
+    }),
+    /**
+     * Issue #416: Invalid UUID format template (vs not found)
+     */
+    INVALID_UUID_FORMAT: (recordId, resourceType) => createEnhancedApiError(`Invalid record identifier format: '${recordId}'`, 400, `/objects/${resourceType}`, 'GET', {
+        field: 'record_id',
+        fieldType: 'uuid',
+        resourceType,
+        documentationHint: `Expected UUID format (e.g., 'a1b2c3d4-e5f6-7890-abcd-ef1234567890').`,
+    }),
+    /**
+     * Issue #417: Task field mapping template
+     */
+    TASK_FIELD_MAPPING: (originalField, correctField) => createEnhancedApiError(`Unknown field '${originalField}' for resource type 'tasks'`, 400, '/objects/tasks', 'POST', {
+        field: originalField,
+        fieldType: 'string',
+        suggestedFields: [correctField],
+        resourceType: 'tasks',
+        documentationHint: `For tasks, use "${correctField}" instead of "${originalField}". Valid task fields: content, status, due_date, assignee_id, record_id.`,
+    }),
+    /**
+     * Issue #798: Phone number format error template
+     */
+    PHONE_NUMBER_FORMAT_ERROR: (field, resourceType) => createEnhancedApiError(`Invalid phone number format for field '${field}'`, 400, `/objects/${resourceType}`, 'POST', {
+        field,
+        fieldType: 'phone_number',
+        resourceType,
+        documentationHint: `Phone numbers require 'original_phone_number' key, not 'phone_number'. Example: [{"original_phone_number": "+1-555-0100"}]. E.164 format (+country code) recommended. The system will auto-normalize most formats.`,
+    }),
+    /**
+     * Generic enhanced error template
+     */
+    GENERIC: (message, statusCode, endpoint, method, context) => createEnhancedApiError(message, statusCode, endpoint, method, context),
+};
+/**
+ * Error enhancement utilities
+ */
+export class ErrorEnhancer {
+    /**
+     * Enhance a standard API error with context
+     */
+    static enhance(error, context) {
+        if (error instanceof EnhancedApiError) {
+            return error; // Already enhanced
+        }
+        if (error instanceof AttioApiError) {
+            return new EnhancedApiError(error.message, error.statusCode, error.endpoint, error.method, context);
+        }
+        // Generic error - make reasonable assumptions
+        return new EnhancedApiError(error.message, 500, '/unknown', 'UNKNOWN', {
+            originalError: error,
+            ...context,
+        });
+    }
+    /**
+     * Issue #425: Safe error message extraction utility
+     * Extracts a contextual message from any error type safely
+     * Handles: EnhancedApiError, AttioApiError, UniversalValidationError, and generic errors
+     */
+    static getErrorMessage(error) {
+        // If it's an EnhancedApiError, use getContextualMessage
+        if (error instanceof EnhancedApiError) {
+            return error.getContextualMessage();
+        }
+        // If it's an AttioApiError, UniversalValidationError, or has a message property, use that
+        if (error &&
+            typeof error === 'object' &&
+            'message' in error &&
+            typeof error.message === 'string') {
+            return error.message;
+        }
+        // Fallback to string representation
+        return String(error);
+    }
+    /**
+     * Issue #425: Convert any error to EnhancedApiError
+     * Ensures all errors are properly enhanced for consistent handling
+     */
+    static ensureEnhanced(error, defaultContext) {
+        if (error instanceof EnhancedApiError) {
+            return error;
+        }
+        // Handle AttioApiError from axios interceptor
+        if (error instanceof AttioApiError) {
+            return new EnhancedApiError(error.message, error.statusCode, error.endpoint, error.method, defaultContext);
+        }
+        // Handle generic errors with status codes
+        const errorObj = error;
+        const statusCode = errorObj?.statusCode || errorObj?.status || 500;
+        const endpoint = errorObj?.endpoint || errorObj?.path || '/unknown';
+        const method = errorObj?.method || 'UNKNOWN';
+        return new EnhancedApiError(errorObj?.message || 'An error occurred', statusCode, endpoint, method, {
+            originalError: error && typeof error === 'object' ? error : undefined,
+            ...defaultContext,
+        });
+    }
+    /**
+     * Auto-detect error type and apply appropriate enhancement
+     */
+    static autoEnhance(error, resourceType, operation, recordId) {
+        const message = error.message.toLowerCase();
+        // Issue #416: Detect "not found" vs "invalid format" scenarios
+        if (message.includes('not found') && recordId && isValidUUID(recordId)) {
+            return ErrorTemplates.RECORD_NOT_FOUND(recordId, resourceType || 'unknown');
+        }
+        if ((message.includes('invalid') || message.includes('format')) &&
+            recordId &&
+            !isValidUUID(recordId)) {
+            return ErrorTemplates.INVALID_UUID_FORMAT(recordId, resourceType || 'unknown');
+        }
+        // Issue #417: Detect task field mapping issues
+        if (resourceType === 'tasks') {
+            const taskFieldMatch = message.match(/unknown field['\s]*([^']*)/i);
+            if (taskFieldMatch) {
+                const field = taskFieldMatch[1].replace(/['"]/g, '').trim();
+                const correctField = this.getTaskFieldMapping(field);
+                if (correctField) {
+                    return ErrorTemplates.TASK_FIELD_MAPPING(field, correctField);
+                }
+            }
+        }
+        // Issue #415: Detect invalid select options
+        // Fixed: ReDoS vulnerability (Issue #106) - replaced greedy quantifiers
+        const selectMatch = message.match(/invalid value\s*['"]?([^'"]+)['"]?\s*for field\s*['"]?([^'"]+)['"]?/i);
+        if (selectMatch) {
+            const [, value, field] = selectMatch;
+            return ErrorTemplates.INVALID_SELECT_OPTION(field, value, [], resourceType);
+        }
+        // Generic enhancement
+        return this.enhance(error, { resourceType, operation, recordId });
+    }
+    /**
+     * Get correct task field mapping
+     */
+    static getTaskFieldMapping(field) {
+        const mappings = {
+            title: 'content',
+            name: 'content',
+            description: 'content',
+            assignee: 'assignee_id',
+            due: 'due_date',
+            record: 'record_id',
+        };
+        return mappings[field.toLowerCase()] || null;
+    }
+}
+//# sourceMappingURL=enhanced-api-errors.js.map

package/dist/errors/enhanced-api-errors.js.map

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

package/dist/errors/enhanced-helpers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Enhanced API Error helpers for duck-typing approach
+ * Avoids class import issues with mocked modules
+ */
+export interface EnhancedApiErrorLike extends Error {
+    name: 'EnhancedApiError';
+    statusCode?: number;
+    endpoint?: string;
+    method?: string;
+    context?: Record<string, unknown>;
+}
+export declare function isEnhancedApiError(e: unknown): e is EnhancedApiErrorLike;
+export declare function withEnumerableMessage<T extends Error>(e: T): T;
+export declare function ensureEnhanced(e: unknown, ctx?: Record<string, unknown>): EnhancedApiErrorLike;
+//# sourceMappingURL=enhanced-helpers.d.ts.map

package/dist/errors/enhanced-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-helpers.d.ts","sourceRoot":"","sources":["../../src/errors/enhanced-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,oBAAqB,SAAQ,KAAK;IACjD,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,oBAAoB,CAaxE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAe9D;AAED,wBAAgB,cAAc,CAC5B,CAAC,EAAE,OAAO,EACV,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,oBAAoB,CAsBtB"}

package/dist/errors/enhanced-helpers.js

@@ -0,0 +1,53 @@
+/**
+ * Enhanced API Error helpers for duck-typing approach
+ * Avoids class import issues with mocked modules
+ */
+export function isEnhancedApiError(e) {
+    if (!e || typeof e !== 'object') {
+        return false;
+    }
+    const errorObj = e;
+    return (errorObj.name === 'EnhancedApiError' ||
+        // Check if it has the typical EnhancedApiError properties (from real class or mock)
+        (typeof errorObj.statusCode === 'number' &&
+            typeof errorObj.endpoint === 'string' &&
+            typeof errorObj.method === 'string'));
+}
+export function withEnumerableMessage(e) {
+    try {
+        const desc = Object.getOwnPropertyDescriptor(e, 'message');
+        if (!desc || desc.enumerable !== true) {
+            Object.defineProperty(e, 'message', {
+                value: e.message,
+                enumerable: true,
+                configurable: true,
+                writable: true,
+            });
+        }
+    }
+    catch {
+        /* best-effort only */
+    }
+    return e;
+}
+export function ensureEnhanced(e, ctx) {
+    if (isEnhancedApiError(e)) {
+        // Enrich context and return as-is
+        const enhanced = e;
+        enhanced.context = { ...enhanced.context, ...ctx };
+        return enhanced;
+    }
+    const errorObj = e;
+    const err = new Error(errorObj?.message ?? String(e));
+    err.name = 'EnhancedApiError';
+    err.statusCode =
+        errorObj?.statusCode ??
+            errorObj?.status ??
+            errorObj?.response?.status ??
+            500;
+    err.endpoint = ctx?.endpoint;
+    err.method = ctx?.method;
+    err.context = { ...ctx, originalError: e };
+    return err;
+}
+//# sourceMappingURL=enhanced-helpers.js.map

package/dist/errors/enhanced-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-helpers.js","sourceRoot":"","sources":["../../src/errors/enhanced-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,UAAU,kBAAkB,CAAC,CAAU;IAC3C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,CAA4B,CAAC;IAC9C,OAAO,CACL,QAAQ,CAAC,IAAI,KAAK,kBAAkB;QACpC,oFAAoF;QACpF,CAAC,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ;YACtC,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ;YACrC,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAkB,CAAI;IACzD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACtC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE;gBAClC,KAAK,EAAE,CAAC,CAAC,OAAO;gBAChB,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;gBAClB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,CAAU,EACV,GAA6B;IAE7B,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1B,kCAAkC;QAClC,MAAM,QAAQ,GAAG,CAAyB,CAAC;QAC3C,QAAQ,CAAC,OAAO,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,CAA4B,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,KAAK,CAClB,QAAQ,EAAE,OAAkB,IAAI,MAAM,CAAC,CAAC,CAAC,CACnB,CAAC;IAC1B,GAAG,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAC9B,GAAG,CAAC,UAAU;QACX,QAAQ,EAAE,UAAqB;YAC/B,QAAQ,EAAE,MAAiB;YAC1B,QAAQ,EAAE,QAAoC,EAAE,MAAiB;YACnE,GAAG,CAAC;IACN,GAAG,CAAC,QAAQ,GAAG,GAAG,EAAE,QAAkB,CAAC;IACvC,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,MAAgB,CAAC;IACnC,GAAG,CAAC,OAAO,GAAG,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/errors/value-match-error.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error for when a field value doesn't match any valid options
+ * Includes suggestions for similar values
+ */
+import { AttioApiError } from './api-errors.js';
+import { ValueMatchResult } from '../utils/value-matcher.js';
+export declare class ValueMatchError extends AttioApiError {
+    readonly fieldName: string;
+    readonly searchValue: string;
+    readonly suggestions: string[];
+    readonly bestMatch?: string;
+    readonly originalError?: Error;
+    constructor(fieldName: string, searchValue: string, matchResult: ValueMatchResult, originalErrorParam?: Error);
+}
+//# sourceMappingURL=value-match-error.d.ts.map

package/dist/errors/value-match-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-match-error.d.ts","sourceRoot":"","sources":["../../src/errors/value-match-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,qBAAa,eAAgB,SAAQ,aAAa;IAChD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAGpC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,gBAAgB,EAC7B,kBAAkB,CAAC,EAAE,KAAK;CAmC7B"}

package/dist/errors/value-match-error.js

@@ -0,0 +1,40 @@
+/**
+ * Error for when a field value doesn't match any valid options
+ * Includes suggestions for similar values
+ */
+import { AttioApiError } from './api-errors.js';
+export class ValueMatchError extends AttioApiError {
+    fieldName;
+    searchValue;
+    suggestions;
+    bestMatch;
+    originalError;
+    constructor(fieldName, searchValue, matchResult, originalErrorParam) {
+        let message = `'${searchValue}' is not a valid value for ${fieldName}.`;
+        if (matchResult.bestMatch && matchResult.bestMatch.similarity >= 0.7) {
+            message += ` Did you mean '${matchResult.bestMatch.value}'?`;
+        }
+        else if (matchResult.suggestions.length > 0) {
+            message += '\n\nDid you mean one of these?';
+            matchResult.suggestions.forEach((suggestion) => {
+                message += `\n  • ${suggestion.value} (${Math.round(suggestion.similarity * 100)}% similar)`;
+            });
+        }
+        super(message, 400, // HTTP status code for bad request
+        fieldName, // Use fieldName as endpoint
+        'POST', // Typical method for searches
+        {
+            // Additional details
+            searchValue,
+            suggestions: matchResult.suggestions,
+            bestMatch: matchResult.bestMatch,
+            originalErrorMessage: originalErrorParam?.message,
+        });
+        this.fieldName = fieldName;
+        this.searchValue = searchValue;
+        this.suggestions = matchResult.suggestions.map((s) => s.value);
+        this.bestMatch = matchResult.bestMatch?.value;
+        this.originalError = originalErrorParam;
+    }
+}
+//# sourceMappingURL=value-match-error.js.map

package/dist/errors/value-match-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-match-error.js","sourceRoot":"","sources":["../../src/errors/value-match-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChC,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,WAAW,CAAW;IACtB,SAAS,CAAU;IACnB,aAAa,CAAS;IAEtC,YACE,SAAiB,EACjB,WAAmB,EACnB,WAA6B,EAC7B,kBAA0B;QAE1B,IAAI,OAAO,GAAG,IAAI,WAAW,8BAA8B,SAAS,GAAG,CAAC;QAExE,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACrE,OAAO,IAAI,kBAAkB,WAAW,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;QAC/D,CAAC;aAAM,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,OAAO,IAAI,gCAAgC,CAAC;YAC5C,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC7C,OAAO,IAAI,SAAS,UAAU,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CACjD,UAAU,CAAC,UAAU,GAAG,GAAG,CAC5B,YAAY,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CACH,OAAO,EACP,GAAG,EAAE,mCAAmC;QACxC,SAAS,EAAE,4BAA4B;QACvC,MAAM,EAAE,8BAA8B;QACtC;YACE,qBAAqB;YACrB,WAAW;YACX,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,oBAAoB,EAAE,kBAAkB,EAAE,OAAO;SAClD,CACF,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC;QAC9C,IAAI,CAAC,aAAa,GAAG,kBAAkB,CAAC;IAC1C,CAAC;CACF"}

package/dist/handlers/error-interceptor.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Placeholder for error interception logic.
+ * Currently, primary Axios error enhancement is handled in src/api/client.ts.
+ */
+export declare function placeholderInterceptorLogic(error: unknown): unknown;
+//# sourceMappingURL=error-interceptor.d.ts.map

package/dist/handlers/error-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-interceptor.d.ts","sourceRoot":"","sources":["../../src/handlers/error-interceptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASnE"}

package/dist/handlers/error-interceptor.js

@@ -0,0 +1,23 @@
+/**
+ * Placeholder for error interception logic.
+ * Currently, primary Axios error enhancement is handled in src/api/client.ts.
+ */
+// import { enhanceApiError, isValueMismatchError } from '../utils/error-enhancer.js';
+// import { createErrorResult } from '../utils/error-handler.js';
+// This file might have previously contained specific error handling logic
+// or an alternative interceptor. For now, it's a placeholder to avoid build issues
+// stemming from previous incorrect edits.
+import { createScopedLogger } from '../utils/logger.js';
+const log = createScopedLogger('error-interceptor');
+export function placeholderInterceptorLogic(error) {
+    const message = 'Placeholder interceptor invoked. Original error passed through.';
+    const data = error instanceof Error
+        ? { error: { message: error.message, name: error.name } }
+        : { error: { message: String(error) } };
+    log.warn(message, data);
+    return error;
+}
+// If this file was intended to export an Axios interceptor function,
+// it would look different, e.g.:
+// export const attioErrorResponseInterceptor = (error: any) => { ... return Promise.reject(error) };
+//# sourceMappingURL=error-interceptor.js.map

package/dist/handlers/error-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-interceptor.js","sourceRoot":"","sources":["../../src/handlers/error-interceptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sFAAsF;AACtF,iEAAiE;AAEjE,0EAA0E;AAC1E,mFAAmF;AACnF,0CAA0C;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,GAAG,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;AAEpD,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,MAAM,OAAO,GACX,iEAAiE,CAAC;IACpE,MAAM,IAAI,GACR,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE;QACzD,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC5C,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qEAAqE;AACrE,iCAAiC;AACjC,qGAAqG"}

package/dist/handlers/rate-limited-handler.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Generic API response interface
+ */
+export interface ApiResponse {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}
+/**
+ * Apply rate limiting to a filter-based handler
+ *
+ * @param handler - The original handler function
+ * @param endpointName - Name of the endpoint for rate limiting tracking
+ * @returns Rate-limited handler function
+ */
+export declare function withRateLimiting<T extends readonly unknown[], R>(handler: (...args: T) => Promise<R>, endpointName: string): (...args: T) => Promise<R | ApiResponse>;
+/**
+ * Apply rate limiting to a search handler with proper headers
+ *
+ * @param handler - The original handler function
+ * @param endpointName - Name of the endpoint for rate limiting tracking
+ * @returns Rate-limited handler function with headers
+ */
+export declare function withSearchRateLimiting<T extends readonly unknown[], R>(handler: (...args: T) => Promise<R>, endpointName: string): (...args: T) => Promise<R | ApiResponse>;
+//# sourceMappingURL=rate-limited-handler.d.ts.map

package/dist/handlers/rate-limited-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limited-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/rate-limited-handler.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,OAAO,EAAE,OAAO,CAAC;CAClB;AAaD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,CAAC,EAC9D,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,YAAY,EAAE,MAAM,GACnB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,CAoD1C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,CAAC,EACpE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,YAAY,EAAE,MAAM,GACnB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,CA4E1C"}