@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/error-utilities.js

@@ -0,0 +1,310 @@
+/**
+ * Common error handling utility functions to reduce code duplication
+ * These utilities provide consistent error handling patterns across the codebase
+ */
+import axios from 'axios';
+import { createErrorResult, AttioApiError } from './error-handler.js';
+import { createScopedLogger } from './logger.js';
+const logger = createScopedLogger('error-utilities');
+/**
+ * Safely gets the error message from an unknown error type
+ *
+ * @param error - The error of unknown type
+ * @param fallbackMessage - Optional fallback message if error cannot be converted to string
+ * @returns A string error message
+ *
+ * @example
+ * try {
+ *   // some operation
+ * } catch (error: unknown) {
+ *   const message = getErrorMessage(error);
+ *   console.error('Operation failed:', message);
+ * }
+ */
+export function getErrorMessage(error, fallbackMessage = 'An unknown error occurred') {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return fallbackMessage;
+}
+/**
+ * Wraps an error with additional context
+ *
+ * @param error - The original error
+ * @param context - Additional context to add to the error message
+ * @returns A new Error with the enhanced message
+ *
+ * @example
+ * try {
+ *   // some operation
+ * } catch (error: unknown) {
+ *   throw wrapError(error, 'Failed to fetch user data');
+ * }
+ */
+export function wrapError(error, context) {
+    const originalMessage = getErrorMessage(error);
+    return new Error(`${context}: ${originalMessage}`);
+}
+/**
+ * Handles an error by wrapping it with context and optionally logging it
+ *
+ * @param error - The error to handle
+ * @param context - Context message for the error
+ * @param options - Optional configuration
+ * @returns The wrapped error
+ *
+ * @example
+ * try {
+ *   // some operation
+ * } catch (error: unknown) {
+ *   throw handleError(error, 'Failed to process company data', { log: true });
+ * }
+ */
+export function handleError(error, context, options) {
+    const wrappedError = wrapError(error, context);
+    if (options?.log) {
+        const logLevel = options.logLevel || 'error';
+        const logMessage = options.includeStack && error instanceof Error && error.stack
+            ? `${wrappedError.message}\nStack: ${error.stack}`
+            : wrappedError.message;
+        const logger = createScopedLogger('utils.error-utilities', 'handleError');
+        switch (logLevel) {
+            case 'warn':
+                logger.warn(logMessage);
+                break;
+            case 'debug':
+                logger.debug(logMessage);
+                break;
+            default:
+                logger.error(logMessage);
+                break;
+        }
+    }
+    return wrappedError;
+}
+/**
+ * Type guard to check if an error is an Axios error
+ *
+ * @param error - The error to check
+ * @returns True if the error is an AxiosError
+ */
+export function isAxiosError(error) {
+    return axios.isAxiosError(error);
+}
+/**
+ * Handles Axios errors with consistent formatting
+ *
+ * @param error - The error to handle
+ * @param operation - Description of the operation that failed
+ * @returns A formatted error with Axios response details
+ *
+ * @example
+ * try {
+ *   const response = await axios.get(url);
+ * } catch (error: unknown) {
+ *   throw handleAxiosError(error, 'fetch company attributes');
+ * }
+ */
+export function handleAxiosError(error, operation) {
+    if (!isAxiosError(error)) {
+        return handleError(error, `Failed to ${operation}`);
+    }
+    if (error.response) {
+        const { status, statusText, data } = error.response;
+        const errorDetails = typeof data === 'object' ? JSON.stringify(data, null, 2) : String(data);
+        return new Error(`Failed to ${operation}: ${status} ${statusText}\n${errorDetails}`);
+    }
+    if (error.request) {
+        return new Error(`Failed to ${operation}: No response received from server`);
+    }
+    return new Error(`Failed to ${operation}: ${error.message}`);
+}
+/**
+ * Creates a standardized error result for API operations
+ * This is a wrapper around createErrorResult with common defaults
+ *
+ * @param error - The error that occurred
+ * @param operation - The operation that was being performed
+ * @param resource - The resource type being operated on
+ * @param additionalDetails - Additional details to include in the error
+ * @returns Formatted error result for MCP response
+ *
+ * @example
+ * try {
+ *   // API operation
+ * } catch (error: unknown) {
+ *   return createStandardErrorResult(error, 'create', 'company', { companyId: '123' });
+ * }
+ */
+export function createStandardErrorResult(error, operation, resource, additionalDetails) {
+    const errorObj = error instanceof Error ? error : new Error(getErrorMessage(error));
+    const url = String(additionalDetails?.url || `/${resource}/${operation}`);
+    const method = String(additionalDetails?.method || 'POST');
+    return createErrorResult(errorObj, url, method, {
+        ...additionalDetails,
+        operation,
+        resource,
+    });
+}
+/**
+ * Logs an error with context and returns it
+ * Useful for debugging while maintaining error flow
+ *
+ * @param error - The error to log
+ * @param context - Context for the error
+ * @param details - Additional details to log
+ * @returns The original error (for chaining)
+ *
+ * @example
+ * try {
+ *   // some operation
+ * } catch (error: unknown) {
+ *   throw logAndReturn(error, 'CompanyService.create', { companyId });
+ * }
+ */
+export function logAndReturn(error, context, details) {
+    const message = getErrorMessage(error);
+    logger.error(message, {
+        context,
+        details,
+        stack: error instanceof Error ? error.stack : undefined,
+    });
+    return error;
+}
+/**
+ * Ensures an error is an Error instance
+ * Useful when you need to guarantee an Error object
+ *
+ * @param error - The error to normalize
+ * @param fallbackMessage - Message to use if error cannot be converted
+ * @returns An Error instance
+ *
+ * @example
+ * try {
+ *   // some operation
+ * } catch (error: unknown) {
+ *   const errorObj = ensureError(error);
+ *   // Now errorObj is guaranteed to be an Error instance
+ * }
+ */
+export function ensureError(error, fallbackMessage = 'An unknown error occurred') {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(getErrorMessage(error, fallbackMessage));
+}
+/**
+ * Safely executes an async operation with error handling
+ *
+ * @param operation - The async operation to execute
+ * @param errorHandler - Function to handle errors
+ * @returns The result of the operation or the error handler
+ *
+ * @example
+ * const result = await safeAsync(
+ *   () => fetchCompanyData(id),
+ *   (error) => {
+ *     console.error('Failed to fetch:', error);
+ *     return defaultCompanyData;
+ *   }
+ * );
+ */
+export async function safeAsync(operation, errorHandler) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        return errorHandler(error);
+    }
+}
+/**
+ * Type guard to check if an error is an AttioApiError
+ *
+ * @param error - The error to check
+ * @returns True if the error is an AttioApiError
+ */
+export function isAttioApiError(error) {
+    return error instanceof AttioApiError;
+}
+/**
+ * Extracts status code from various error types
+ *
+ * @param error - The error to extract status from
+ * @returns The HTTP status code or undefined
+ *
+ * @example
+ * try {
+ *   // API call
+ * } catch (error: unknown) {
+ *   const status = getErrorStatus(error);
+ *   if (status === 404) {
+ *     // Handle not found
+ *   }
+ * }
+ */
+export function getErrorStatus(error) {
+    if (isAttioApiError(error)) {
+        return error.status;
+    }
+    if (isAxiosError(error) && error.response) {
+        return error.response.status;
+    }
+    // Some internal wrappers lose the structured status, but keep it in the message
+    // e.g. "Request failed with status code 400"
+    if (error instanceof Error) {
+        const match = error.message.match(/status code (\d{3})/i);
+        if (match?.[1]) {
+            const parsed = Number(match[1]);
+            if (Number.isFinite(parsed))
+                return parsed;
+        }
+    }
+    if (error && typeof error === 'object' && 'status' in error) {
+        const status = error.status;
+        return typeof status === 'number' ? status : undefined;
+    }
+    return undefined;
+}
+/**
+ * Determines if an error is retryable based on its type and status
+ *
+ * @param error - The error to check
+ * @returns True if the error is potentially retryable
+ *
+ * @example
+ * try {
+ *   // API call
+ * } catch (error: unknown) {
+ *   if (isRetryableError(error)) {
+ *     // Implement retry logic
+ *   }
+ * }
+ */
+export function isRetryableError(error) {
+    const status = getErrorStatus(error);
+    // Retryable HTTP status codes
+    if (status) {
+        return (status === 429 || // Rate limit
+            status === 503 || // Service unavailable
+            status === 504 || // Gateway timeout
+            (status >= 500 && status < 600) // Server errors
+        );
+    }
+    // Check for network errors
+    if (isAxiosError(error)) {
+        return !error.response && !!error.request; // Network error, no response
+    }
+    // Check for specific error messages
+    const message = getErrorMessage(error).toLowerCase();
+    return (message.includes('timeout') ||
+        message.includes('network') ||
+        message.includes('econnrefused') ||
+        message.includes('enotfound'));
+}
+//# sourceMappingURL=error-utilities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-utilities.js","sourceRoot":"","sources":["../../src/utils/error-utilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,eAAe,GAAG,2BAA2B;IAE7C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,OAAe;IACvD,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,eAAe,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,OAAe,EACf,OAIC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE/C,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;QAC7C,MAAM,UAAU,GACd,OAAO,CAAC,YAAY,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK;YAC3D,CAAC,CAAC,GAAG,YAAY,CAAC,OAAO,YAAY,KAAK,CAAC,KAAK,EAAE;YAClD,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC;QAE3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;QAC1E,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,MAAM;gBACT,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACzB,MAAM;YACR;gBACE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACzB,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,SAAiB;IAChE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,KAAK,EAAE,aAAa,SAAS,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;QACpD,MAAM,YAAY,GAChB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE1E,OAAO,IAAI,KAAK,CACd,aAAa,SAAS,KAAK,MAAM,IAAI,UAAU,KAAK,YAAY,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,KAAK,CACd,aAAa,SAAS,oCAAoC,CAC3D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,aAAa,SAAS,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,SAAiB,EACjB,QAAgB,EAChB,iBAA2C;IAE3C,MAAM,QAAQ,GACZ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,MAAM,CAAC,iBAAiB,EAAE,GAAG,IAAI,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC;IAE3D,OAAO,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE;QAC9C,GAAG,iBAAiB;QACpB,SAAS;QACT,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAc,EACd,OAAe,EACf,OAAiC;IAEjC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAEvC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;QACpB,OAAO;QACP,OAAO;QACP,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KACxD,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,eAAe,GAAG,2BAA2B;IAE7C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAA2B,EAC3B,YAAgD;IAEhD,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,gFAAgF;IAChF,6CAA6C;IAC7C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1D,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAI,KAAiC,CAAC,MAAM,CAAC;QACzD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAErC,8BAA8B;IAC9B,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CACL,MAAM,KAAK,GAAG,IAAI,aAAa;YAC/B,MAAM,KAAK,GAAG,IAAI,sBAAsB;YACxC,MAAM,KAAK,GAAG,IAAI,kBAAkB;YACpC,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,gBAAgB;SACjD,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,6BAA6B;IAC1E,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC9B,CAAC;AACJ,CAAC"}

package/dist/utils/field-suggestions.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Field suggestion utilities for improved error messages
+ * Provides fuzzy matching and suggestion capabilities for field names,
+ * resource types, and enum values
+ */
+/**
+ * Calculate Levenshtein distance between two strings
+ * Used for fuzzy matching to find similar field names
+ */
+export declare function levenshteinDistance(str1: string, str2: string): number;
+/**
+ * Find the most similar strings from a list of valid options
+ * @param input - The incorrect input string
+ * @param validOptions - List of valid options to match against
+ * @param maxSuggestions - Maximum number of suggestions to return (default: 3)
+ * @param threshold - Maximum distance threshold for suggestions (default: 3)
+ * @returns Array of similar options sorted by similarity
+ */
+export declare function findSimilarOptions(input: string, validOptions: string[], maxSuggestions?: number, threshold?: number): string[];
+/**
+ * Generate a helpful error message with field suggestions
+ * @param fieldName - The incorrect field name provided
+ * @param validFields - List of valid field names
+ * @param context - Additional context (e.g., resource type)
+ * @returns Enhanced error message with suggestions
+ */
+export declare function generateFieldSuggestionMessage(fieldName: string, validFields: string[], context?: string): string;
+/**
+ * Generate error message for invalid enum/select values
+ * @param value - The invalid value provided
+ * @param validValues - List of valid enum values
+ * @param fieldName - Name of the field
+ * @returns Enhanced error message with valid options
+ */
+export declare function generateEnumSuggestionMessage(value: string | number | boolean, validValues: string[], fieldName: string): string;
+/**
+ * Generate error message for read-only field attempts
+ * @param fieldName - Name of the read-only field
+ * @param operation - The attempted operation (create, update)
+ * @returns Clear error message about read-only status
+ */
+export declare function generateReadOnlyFieldMessage(fieldName: string, operation?: 'create' | 'update'): string;
+/**
+ * Generate error message for invalid resource types
+ * @param resourceType - The invalid resource type provided
+ * @param validTypes - List of valid resource types
+ * @returns Enhanced error message with valid types
+ */
+export declare function generateResourceTypeSuggestionMessage(resourceType: string, validTypes: string[]): string;
+/**
+ * Known Attio resource types for validation
+ */
+export declare const VALID_RESOURCE_TYPES: string[];
+/**
+ * Common field name mappings for better suggestions
+ * Maps common incorrect names to correct Attio field names
+ */
+export declare const FIELD_NAME_MAPPINGS: Record<string, string>;
+/**
+ * Check if a field name might be a common mistake and suggest correction
+ * @param fieldName - The field name to check
+ * @returns The suggested correct field name or null
+ */
+export declare function getMappedFieldName(fieldName: string): string | null;
+/**
+ * Enhanced field validation with helpful suggestions
+ * @param fieldName - Field name to validate
+ * @param validFields - List of valid field names
+ * @param readOnlyFields - List of read-only field names
+ * @param operation - The operation being performed
+ * @returns Validation result with error message if invalid
+ */
+export declare function validateFieldWithSuggestions(fieldName: string, validFields: string[], readOnlyFields?: string[], operation?: 'create' | 'update'): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=field-suggestions.d.ts.map

package/dist/utils/field-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-suggestions.d.ts","sourceRoot":"","sources":["../../src/utils/field-suggestions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA4BtE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,GAAE,MAAU,EAC1B,SAAS,GAAE,MAAU,GACpB,MAAM,EAAE,CA+BV;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAyBR;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAChC,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,GAChB,MAAM,CA0BR;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,QAAQ,GAAG,QAAmB,GACxC,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CAgBR;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAgBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+BtD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EAAE,EACrB,cAAc,GAAE,MAAM,EAAO,EAC7B,SAAS,GAAE,QAAQ,GAAG,QAAmB,GACxC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA4BpC"}

package/dist/utils/field-suggestions.js

@@ -0,0 +1,252 @@
+/**
+ * Field suggestion utilities for improved error messages
+ * Provides fuzzy matching and suggestion capabilities for field names,
+ * resource types, and enum values
+ */
+/**
+ * Calculate Levenshtein distance between two strings
+ * Used for fuzzy matching to find similar field names
+ */
+export function levenshteinDistance(str1, str2) {
+    const matrix = [];
+    // Initialize first row and column
+    for (let i = 0; i <= str2.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= str1.length; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill in the matrix
+    for (let i = 1; i <= str2.length; i++) {
+        for (let j = 1; j <= str1.length; j++) {
+            if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[str2.length][str1.length];
+}
+/**
+ * Find the most similar strings from a list of valid options
+ * @param input - The incorrect input string
+ * @param validOptions - List of valid options to match against
+ * @param maxSuggestions - Maximum number of suggestions to return (default: 3)
+ * @param threshold - Maximum distance threshold for suggestions (default: 3)
+ * @returns Array of similar options sorted by similarity
+ */
+export function findSimilarOptions(input, validOptions, maxSuggestions = 3, threshold = 3) {
+    if (!input || !validOptions.length) {
+        return [];
+    }
+    const normalizedInput = input.toLowerCase().trim();
+    // Calculate distances for all options
+    const distances = validOptions.map((option) => ({
+        option,
+        distance: levenshteinDistance(normalizedInput, option.toLowerCase()),
+    }));
+    // Filter by threshold and sort by distance
+    const suggestions = distances
+        .filter((d) => d.distance <= threshold)
+        .sort((a, b) => a.distance - b.distance)
+        .slice(0, maxSuggestions)
+        .map((d) => d.option);
+    // If no suggestions found with Levenshtein, try substring matching
+    if (suggestions.length === 0) {
+        const substringMatches = validOptions.filter((option) => option.toLowerCase().includes(normalizedInput) ||
+            normalizedInput.includes(option.toLowerCase()));
+        return substringMatches.slice(0, maxSuggestions);
+    }
+    return suggestions;
+}
+/**
+ * Generate a helpful error message with field suggestions
+ * @param fieldName - The incorrect field name provided
+ * @param validFields - List of valid field names
+ * @param context - Additional context (e.g., resource type)
+ * @returns Enhanced error message with suggestions
+ */
+export function generateFieldSuggestionMessage(fieldName, validFields, context) {
+    const suggestions = findSimilarOptions(fieldName, validFields);
+    let message = `Invalid field name: "${fieldName}"`;
+    if (context) {
+        message += ` for ${context}`;
+    }
+    if (suggestions.length > 0) {
+        message += `. Did you mean: ${suggestions
+            .map((s) => `"${s}"`)
+            .join(', ')}?`;
+    }
+    else if (validFields.length > 0) {
+        // Show first few valid fields if no close matches found
+        const preview = validFields.slice(0, 5);
+        message += `. Valid fields include: ${preview
+            .map((f) => `"${f}"`)
+            .join(', ')}`;
+        if (validFields.length > 5) {
+            message += ` (and ${validFields.length - 5} more)`;
+        }
+    }
+    return message;
+}
+/**
+ * Generate error message for invalid enum/select values
+ * @param value - The invalid value provided
+ * @param validValues - List of valid enum values
+ * @param fieldName - Name of the field
+ * @returns Enhanced error message with valid options
+ */
+export function generateEnumSuggestionMessage(value, validValues, fieldName) {
+    const valueStr = String(value);
+    const suggestions = findSimilarOptions(valueStr, validValues, 2, 2);
+    let message = `Invalid value "${valueStr}" for field "${fieldName}"`;
+    if (suggestions.length > 0) {
+        message += `. Did you mean: ${suggestions
+            .map((s) => `"${s}"`)
+            .join(' or ')}?`;
+    }
+    // Always show all valid options for enums (usually limited set)
+    if (validValues.length <= 10) {
+        message += ` Valid options are: ${validValues
+            .map((v) => `"${v}"`)
+            .join(', ')}.`;
+    }
+    else {
+        // For large sets, show a subset
+        const preview = validValues.slice(0, 5);
+        message += ` Valid options include: ${preview
+            .map((v) => `"${v}"`)
+            .join(', ')} (and ${validValues.length - 5} more).`;
+    }
+    return message;
+}
+/**
+ * Generate error message for read-only field attempts
+ * @param fieldName - Name of the read-only field
+ * @param operation - The attempted operation (create, update)
+ * @returns Clear error message about read-only status
+ */
+export function generateReadOnlyFieldMessage(fieldName, operation = 'update') {
+    return `Field "${fieldName}" is read-only and cannot be ${operation === 'create' ? 'set during creation' : 'modified'}. This field is automatically managed by the system.`;
+}
+/**
+ * Generate error message for invalid resource types
+ * @param resourceType - The invalid resource type provided
+ * @param validTypes - List of valid resource types
+ * @returns Enhanced error message with valid types
+ */
+export function generateResourceTypeSuggestionMessage(resourceType, validTypes) {
+    const suggestions = findSimilarOptions(resourceType, validTypes, 3, 5); // Increase threshold for resource types
+    let message = `Invalid resource type: "${resourceType}"`;
+    if (suggestions.length > 0) {
+        message += `. Did you mean: ${suggestions
+            .map((s) => `"${s}"`)
+            .join(', ')}?`;
+    }
+    message += ` Valid resource types are: ${validTypes
+        .map((t) => `"${t}"`)
+        .join(', ')}.`;
+    return message;
+}
+/**
+ * Known Attio resource types for validation
+ */
+export const VALID_RESOURCE_TYPES = [
+    'people',
+    'companies',
+    'deals',
+    'workspaces',
+    'users',
+    'lists',
+    'objects',
+    'records',
+    'tasks',
+    'notes',
+    'comments',
+    'threads',
+    'entries',
+    'attributes',
+    'webhooks',
+];
+/**
+ * Common field name mappings for better suggestions
+ * Maps common incorrect names to correct Attio field names
+ */
+export const FIELD_NAME_MAPPINGS = {
+    // Common person field mappings
+    firstname: 'first_name',
+    first_name: 'first_name', // Support hyphen/space variations
+    lastname: 'last_name',
+    last_name: 'last_name', // Support hyphen/space variations
+    fullname: 'name',
+    phone: 'phone_numbers',
+    email: 'email_addresses',
+    company: 'primary_company',
+    title: 'job_title',
+    position: 'job_title',
+    // Common company field mappings
+    company_name: 'name',
+    website: 'domain',
+    employees: 'employee_count',
+    size: 'company_size',
+    // Common timestamp mappings
+    created: 'created_at',
+    updated: 'updated_at',
+    modified: 'updated_at',
+    date_created: 'created_at',
+    date_updated: 'updated_at',
+    // Common ID mappings
+    person_id: 'id',
+    company_id: 'id',
+    record_id: 'id',
+    object_id: 'id',
+};
+/**
+ * Check if a field name might be a common mistake and suggest correction
+ * @param fieldName - The field name to check
+ * @returns The suggested correct field name or null
+ */
+export function getMappedFieldName(fieldName) {
+    const normalized = fieldName.toLowerCase().replace(/[- ]/g, '_');
+    return FIELD_NAME_MAPPINGS[normalized] || null;
+}
+/**
+ * Enhanced field validation with helpful suggestions
+ * @param fieldName - Field name to validate
+ * @param validFields - List of valid field names
+ * @param readOnlyFields - List of read-only field names
+ * @param operation - The operation being performed
+ * @returns Validation result with error message if invalid
+ */
+export function validateFieldWithSuggestions(fieldName, validFields, readOnlyFields = [], operation = 'update') {
+    // Check if field exists
+    if (!validFields.includes(fieldName)) {
+        // Check for common mapping
+        const mappedName = getMappedFieldName(fieldName);
+        if (mappedName && validFields.includes(mappedName)) {
+            return {
+                valid: false,
+                error: `Invalid field name: "${fieldName}". Did you mean "${mappedName}"?`,
+            };
+        }
+        // Generate suggestion message
+        return {
+            valid: false,
+            error: generateFieldSuggestionMessage(fieldName, validFields),
+        };
+    }
+    // Check if field is read-only
+    if (readOnlyFields.includes(fieldName)) {
+        return {
+            valid: false,
+            error: generateReadOnlyFieldMessage(fieldName, operation),
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=field-suggestions.js.map

package/dist/utils/field-suggestions.js.map

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

package/dist/utils/filters/builders/activity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Activity related filter builders.
+ */
+import { ListEntryFilters, DateRange, ActivityFilter, InteractionType } from './types.js';
+/**
+ * Creates an activity filter for finding records with specific interaction types within a date range.
+ */
+export declare function createActivityFilter(activityFilter: ActivityFilter): ListEntryFilters;
+/**
+ * Creates a filter for records based on their last interaction date.
+ */
+export declare function createLastInteractionFilter(dateRange: DateRange, interactionType?: InteractionType): ListEntryFilters;
+//# sourceMappingURL=activity.d.ts.map