attio-mcp 0.1.2 → 1.1.0

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/handlers/error-interceptor.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"error-interceptor.d.ts","sourceRoot":"","sources":["../../src/handlers/error-interceptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAM3D"}
+{"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

@@ -7,8 +7,14 @@
 // 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) {
-    console.warn('[placeholderInterceptorLogic] This is a placeholder in src/handlers/error-interceptor.ts. Original error passed through:', error?.message);
+    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,

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

@@ -1 +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,MAAM,UAAU,2BAA2B,CAAC,KAAU;IACpD,OAAO,CAAC,IAAI,CACV,0HAA0H,EAC1H,KAAK,EAAE,OAAO,CACf,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qEAAqE;AACrE,iCAAiC;AACjC,qGAAqG"}
+{"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

@@ -1,3 +1,13 @@
+/**
+ * Generic API response interface
+ */
+export interface ApiResponse {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}
 /**
  * Apply rate limiting to a filter-based handler
  *
@@ -5,7 +15,7 @@
  * @param endpointName - Name of the endpoint for rate limiting tracking
  * @returns Rate-limited handler function
  */
-export declare function withRateLimiting<T extends any[]>(handler: (...args: T) => Promise<any>, endpointName: string): (...args: T) => Promise<any>;
+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
  *
@@ -13,5 +23,5 @@ export declare function withRateLimiting<T extends any[]>(handler: (...args: T)
  * @param endpointName - Name of the endpoint for rate limiting tracking
  * @returns Rate-limited handler function with headers
  */
-export declare function withSearchRateLimiting<T extends any[]>(handler: (...args: T) => Promise<any>, endpointName: string): (...args: T) => Promise<any>;
+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

@@ -1 +1 @@
-{"version":3,"file":"rate-limited-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/rate-limited-handler.ts"],"names":[],"mappings":"AA2BA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAAE,EAC9C,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EACrC,YAAY,EAAE,MAAM,GACnB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAoD9B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,GAAG,EAAE,EACpD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EACrC,YAAY,EAAE,MAAM,GACnB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAwE9B"}
+{"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"}

package/dist/handlers/rate-limited-handler.js

@@ -77,16 +77,20 @@ export function withSearchRateLimiting(handler, endpointName) {
         // Check rate limit
         const rateLimit = checkFilterRateLimit(req, endpointName);
         // Add rate limit headers
-        req.res.setHeader('X-RateLimit-Limit', 60);
-        req.res.setHeader('X-RateLimit-Remaining', rateLimit.remaining);
-        req.res.setHeader('X-RateLimit-Reset', rateLimit.resetTime);
+        if (req.res) {
+            req.res.setHeader('X-RateLimit-Limit', 60);
+            req.res.setHeader('X-RateLimit-Remaining', rateLimit.remaining);
+            req.res.setHeader('X-RateLimit-Reset', rateLimit.resetTime);
+        }
         // If rate limit exceeded, return error
         if (!rateLimit.allowed) {
-            req.res.status(429).json({
-                error: 'Rate limit exceeded',
-                message: `Too many requests. Try again in ${Math.ceil(rateLimit.msUntilReset / 1000)} seconds.`,
-                retryAfter: Math.ceil(rateLimit.msUntilReset / 1000),
-            });
+            if (req.res) {
+                req.res.status(429).json({
+                    error: 'Rate limit exceeded',
+                    message: `Too many requests. Try again in ${Math.ceil(rateLimit.msUntilReset / 1000)} seconds.`,
+                    retryAfter: Math.ceil(rateLimit.msUntilReset / 1000),
+                });
+            }
             // Format error for API response
             const response = {
                 content: [

package/dist/handlers/rate-limited-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limited-handler.js","sourceRoot":"","sources":["../../src/handlers/rate-limited-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rate-limited-handler.js","sourceRoot":"","sources":["../../src/handlers/rate-limited-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAiChE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAmC,EACnC,YAAoB;IAEpB,OAAO,KAAK,EAAE,GAAG,IAAO,EAAE,EAAE;QAC1B,iDAAiD;QACjD,MAAM,GAAG,GAAwB,IAAI,CAAC,CAAC,CAAwB,CAAC;QAEhE,mBAAmB;QACnB,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAE1D,uCAAuC;QACvC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,KAAK,GAAmB;gBAC5B,KAAK,EAAE,qBAAqB;gBAC5B,OAAO,EAAE,mCAAmC,IAAI,CAAC,IAAI,CACnD,SAAS,CAAC,YAAY,GAAG,IAAI,CAC9B,WAAW;gBACZ,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC;aACrD,CAAC;YAEF,gCAAgC;YAChC,MAAM,QAAQ,GAAgB;gBAC5B,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE;qBAChC;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;YAEF,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACH,wBAAwB;YACxB,OAAO,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,gCAAgC;YAChC,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAgB;gBAC5B,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,YAAY,EAAE;qBAC/B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;YAEF,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAmC,EACnC,YAAoB;IAEpB,OAAO,KAAK,EAAE,GAAG,IAAO,EAAE,EAAE;QAC1B,iDAAiD;QACjD,MAAM,GAAG,GAAwB,IAAI,CAAC,CAAC,CAAwB,CAAC;QAEhE,qCAAqC;QACrC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,GAAG,GAAG;gBACR,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;gBACnB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;aACnC,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAE1D,yBAAyB;QACzB,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;YAC3C,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YAChE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9D,CAAC;QAED,uCAAuC;QACvC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;gBACZ,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACvB,KAAK,EAAE,qBAAqB;oBAC5B,OAAO,EAAE,mCAAmC,IAAI,CAAC,IAAI,CACnD,SAAS,CAAC,YAAY,GAAG,IAAI,CAC9B,WAAW;oBACZ,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;YAED,gCAAgC;YAChC,MAAM,QAAQ,GAAgB;gBAC5B,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4CAA4C,IAAI,CAAC,IAAI,CACzD,SAAS,CAAC,YAAY,GAAG,IAAI,CAC9B,WAAW;qBACb;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;YAEF,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACH,wBAAwB;YACxB,OAAO,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,gCAAgC;YAChC,MAAM,YAAY,GAChB,KAAK,YAAY,qBAAqB;gBACpC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,KAAK,YAAY,KAAK;oBACtB,CAAC,CAAC,qBAAqB,KAAK,CAAC,OAAO,EAAE;oBACtC,CAAC,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAE1C,MAAM,QAAQ,GAAgB;gBAC5B,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,YAAY,EAAE;qBAC/B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;YAEF,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/handlers/resources.d.ts

@@ -2,10 +2,11 @@
  * Handlers for resource-related requests
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ServerContext } from '../server/createServer.js';
 /**
  * Registers resource-related request handlers with the server
  *
  * @param server - The MCP server instance
  */
-export declare function registerResourceHandlers(server: Server): void;
+export declare function registerResourceHandlers(server: Server, context?: ServerContext): void;
 //# sourceMappingURL=resources.d.ts.map

package/dist/handlers/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/handlers/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA6BnE;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAuH7D"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/handlers/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOnE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAgE1D;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAkKN"}