attio-mcp 0.1.2 → 1.1.0

package/dist/utils/error-handler.js

@@ -1,4 +1,6 @@
 import { safeJsonStringify, sanitizeMcpResponse } from './json-serializer.js';
+import { enhanceErrorMessage } from './error-examples.js';
+import { createScopedLogger, OperationType } from './logger.js';
 /**
  * Enum for categorizing different types of errors
  */
@@ -51,15 +53,21 @@ export function createAttioError(error) {
     if (error instanceof AttioApiError) {
         return error;
     }
-    // Handle Axios errors
-    if (error.isAxiosError && error.response) {
-        const { status, data, config } = error.response;
+    // Handle Axios errors - check if it's an object with axios error properties
+    if (error &&
+        typeof error === 'object' &&
+        'isAxiosError' in error &&
+        error.isAxiosError &&
+        'response' in error &&
+        error.response) {
+        const axiosError = error;
+        const { status, data, config } = axiosError.response;
         const path = config?.url || 'unknown';
         const method = config?.method?.toUpperCase() || 'UNKNOWN';
         return createApiError(status, path, method, data);
     }
     // Return the original error if we can't enhance it
-    return error;
+    return error instanceof Error ? error : new Error(String(error));
 }
 /**
  * Creates a specific API error based on status code and context
@@ -71,21 +79,23 @@ export function createAttioError(error) {
  * @returns Appropriate error instance
  */
 export function createApiError(status, path, method, responseData = {}) {
-    const defaultMessage = responseData?.error?.message ||
-        responseData?.message ||
-        'Unknown API error';
-    const detail = responseData?.error?.detail ||
-        responseData?.detail ||
-        'No additional details';
+    const apiResponse = responseData;
+    const defaultMessage = String(apiResponse?.error?.message || apiResponse?.message || 'Unknown API error');
+    const detail = String(apiResponse?.error?.detail || apiResponse?.detail || 'No additional details');
     let errorType = ErrorType.API_ERROR;
     let message = '';
     // Create specific error messages based on status code and context
     switch (status) {
-        case 400:
+        case 400: {
             // Detect common parameter and format errors in the 400 response
+            const apiResponse = responseData;
+            const errorDetails = apiResponse?.error?.details;
+            const detailsString = typeof errorDetails === 'string'
+                ? errorDetails
+                : safeJsonStringify(errorDetails ?? '', { indent: 0 });
             if (defaultMessage.includes('parameter') ||
                 defaultMessage.includes('param') ||
-                responseData?.error?.details?.includes('parameter')) {
+                detailsString.includes('parameter')) {
                 errorType = ErrorType.PARAMETER_ERROR;
                 message = `Parameter Error: ${defaultMessage}`;
             }
@@ -104,6 +114,7 @@ export function createApiError(status, path, method, responseData = {}) {
                 message = `Bad Request: ${defaultMessage}`;
             }
             break;
+        }
         case 401:
         case 403:
             errorType = ErrorType.AUTHENTICATION_ERROR;
@@ -173,12 +184,23 @@ export function createApiError(status, path, method, responseData = {}) {
  * @returns Formatted error response
  */
 export function formatErrorResponse(error, type = ErrorType.UNKNOWN_ERROR, details) {
+    const log = createScopedLogger('utils.error-handler', 'formatErrorResponse', OperationType.SYSTEM);
     // Ensure we have a valid error object
     const normalizedError = error instanceof Error
         ? error
         : new Error(typeof error === 'string' ? error : 'Unknown error');
     // Prevent "undefined" from being returned as an error message
-    const errorMessage = normalizedError.message || 'An unknown error occurred';
+    let errorMessage = normalizedError.message || 'An unknown error occurred';
+    // Enhance error message with examples if details contain context
+    if (details && (details.toolName || details.paramName || details.path)) {
+        errorMessage = enhanceErrorMessage(errorMessage, type, {
+            toolName: String(details.toolName || ''),
+            paramName: String(details.paramName || ''),
+            expectedType: String(details.expectedType || ''),
+            actualValue: String(details.actualValue || ''),
+            path: String(details.path || details.url || ''),
+        });
+    }
     // Determine appropriate status code based on error type
     const errorCode = type === ErrorType.VALIDATION_ERROR
         ? 400
@@ -217,11 +239,11 @@ export function formatErrorResponse(error, type = ErrorType.UNKNOWN_ERROR, detai
         try {
             // Use createSafeCopy which handles circular references and non-serializable values
             safeDetails = JSON.parse(safeJsonStringify(details, {
-                includeStackTraces: process.env.NODE_ENV === 'development',
+                includeStackTraces: false,
             }));
         }
         catch (err) {
-            console.error('[formatErrorResponse] Error with safe stringification:', err instanceof Error ? err.message : String(err));
+            log.error('Error during safe stringification while formatting error response', err instanceof Error ? err : undefined);
             // Ultimate fallback
             safeDetails = {
                 note: 'Error details could not be serialized',
@@ -232,7 +254,10 @@ export function formatErrorResponse(error, type = ErrorType.UNKNOWN_ERROR, detai
     }
     // Log the error for debugging purposes
     if (process.env.DEBUG || process.env.NODE_ENV === 'development') {
-        console.error(`[formatErrorResponse] Formatted error [${type}]:`, errorMessage);
+        log.debug('Formatted error response', {
+            errorType: type,
+            message: errorMessage,
+        });
     }
     // Return properly formatted MCP error response
     const errorResponse = {
@@ -265,12 +290,17 @@ export function formatErrorResponse(error, type = ErrorType.UNKNOWN_ERROR, detai
  * @returns Formatted error result
  */
 export function createErrorResult(error, url, method, responseData = {}) {
+    const log = createScopedLogger('utils.error-handler', 'createErrorResult', OperationType.SYSTEM);
     // Ensure we have a valid error object to work with
     const normalizedError = error instanceof Error
         ? error
         : new Error(typeof error === 'string' ? error : 'Unknown error');
     if (process.env.DEBUG || process.env.NODE_ENV === 'development') {
-        console.error(`[createErrorResult] Processing error for ${method} ${url}:`, normalizedError.message);
+        log.debug('Processing error result', {
+            method,
+            url,
+            message: normalizedError.message,
+        });
     }
     // If it's already an AttioApiError, use it directly
     if (error instanceof AttioApiError) {
@@ -295,12 +325,14 @@ export function createErrorResult(error, url, method, responseData = {}) {
                 detail: apiError.detail,
                 responseData: apiError.responseData,
                 originalError: normalizedError.message,
+                toolName: responseData.toolName,
+                paramName: responseData.paramName,
             };
             return formatErrorResponse(apiError, apiError.type, errorDetails);
         }
         catch (formattingError) {
             // If error formatting fails, preserve the original error
-            console.error('Error while formatting API error:', formattingError);
+            log.error('Error while formatting API error', formattingError instanceof Error ? formattingError : undefined);
             const originalErrorDetails = {
                 url,
                 method,

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * Enhanced error response utilities for structured error handling
+ *
+ * This module provides structured error response formats that include:
+ * - Human-readable error messages
+ * - Machine-readable error codes
+ * - Actionable suggestions
+ * - Context information
+ * - Links to documentation
+ */
+import { UnknownObject } from './types/common.js';
+export interface EnhancedErrorResponse {
+    error: string;
+    error_code: string;
+    field?: string;
+    suggestions?: string[];
+    help_url?: string;
+    context?: Record<string, unknown>;
+}
+/**
+ * Error codes for different types of validation failures
+ */
+export declare enum ValidationErrorCode {
+    FIELD_VALIDATION_ERROR = "FIELD_VALIDATION_ERROR",
+    INVALID_SELECT_OPTION = "INVALID_SELECT_OPTION",
+    INVALID_MULTI_SELECT_OPTION = "INVALID_MULTI_SELECT_OPTION",
+    READ_ONLY_FIELD_UPDATE = "READ_ONLY_FIELD_UPDATE",
+    UNKNOWN_FIELD = "UNKNOWN_FIELD",
+    FIELD_TYPE_MISMATCH = "FIELD_TYPE_MISMATCH",
+    REQUIRED_FIELD_MISSING = "REQUIRED_FIELD_MISSING"
+}
+/**
+ * Create a field validation error response
+ */
+export declare function createFieldValidationError(fieldName: string, resourceType: string, issue: string, suggestions?: string[]): EnhancedErrorResponse;
+/**
+ * Create a select option validation error response
+ */
+export declare function createSelectOptionError(fieldName: string, invalidValue: string, validOptions: string[]): EnhancedErrorResponse;
+/**
+ * Create a multi-select option validation error response
+ */
+export declare function createMultiSelectOptionError(fieldName: string, invalidValues: string[], validOptions: string[]): EnhancedErrorResponse;
+/**
+ * Create a read-only field error response
+ */
+export declare function createReadOnlyFieldError(fieldNames: string[], resourceType: string): EnhancedErrorResponse;
+/**
+ * Create an unknown field error response
+ */
+export declare function createUnknownFieldError(fieldName: string, resourceType: string, suggestions?: string[]): EnhancedErrorResponse;
+/**
+ * Create a field type mismatch error response
+ */
+export declare function createFieldTypeMismatchError(fieldName: string, expectedType: string, actualType: string, resourceType: string): EnhancedErrorResponse;
+/**
+ * Create a required field missing error response
+ */
+export declare function createRequiredFieldError(fieldNames: string[], resourceType: string): EnhancedErrorResponse;
+/**
+ * Format an enhanced error response for MCP client consumption
+ */
+export declare function formatEnhancedErrorResponse(errorResponse: EnhancedErrorResponse): UnknownObject;
+/**
+ * Create a simple error response (for backward compatibility)
+ */
+export declare function createErrorResponse(message: string): UnknownObject;
+//# sourceMappingURL=error-response-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-response-utils.d.ts","sourceRoot":"","sources":["../../src/utils/error-response-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,sBAAsB,2BAA2B;IACjD,qBAAqB,0BAA0B;IAC/C,2BAA2B,gCAAgC;IAC3D,sBAAsB,2BAA2B;IACjD,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;IAC3C,sBAAsB,2BAA2B;CAClD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,MAAM,EAAO,GACzB,qBAAqB,CAYvB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,qBAAqB,CAmBvB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EAAE,EACvB,YAAY,EAAE,MAAM,EAAE,GACrB,qBAAqB,CAuBvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,GACnB,qBAAqB,CAsBvB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,WAAW,GAAE,MAAM,EAAO,GACzB,qBAAqB,CA2BvB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,qBAAqB,CAiBvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,GACnB,qBAAqB,CAsBvB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,qBAAqB,GACnC,aAAa,CAiCf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAalE"}

package/dist/utils/error-response-utils.js

@@ -0,0 +1,223 @@
+/**
+ * Enhanced error response utilities for structured error handling
+ *
+ * This module provides structured error response formats that include:
+ * - Human-readable error messages
+ * - Machine-readable error codes
+ * - Actionable suggestions
+ * - Context information
+ * - Links to documentation
+ */
+/**
+ * Error codes for different types of validation failures
+ */
+export var ValidationErrorCode;
+(function (ValidationErrorCode) {
+    ValidationErrorCode["FIELD_VALIDATION_ERROR"] = "FIELD_VALIDATION_ERROR";
+    ValidationErrorCode["INVALID_SELECT_OPTION"] = "INVALID_SELECT_OPTION";
+    ValidationErrorCode["INVALID_MULTI_SELECT_OPTION"] = "INVALID_MULTI_SELECT_OPTION";
+    ValidationErrorCode["READ_ONLY_FIELD_UPDATE"] = "READ_ONLY_FIELD_UPDATE";
+    ValidationErrorCode["UNKNOWN_FIELD"] = "UNKNOWN_FIELD";
+    ValidationErrorCode["FIELD_TYPE_MISMATCH"] = "FIELD_TYPE_MISMATCH";
+    ValidationErrorCode["REQUIRED_FIELD_MISSING"] = "REQUIRED_FIELD_MISSING";
+})(ValidationErrorCode || (ValidationErrorCode = {}));
+/**
+ * Create a field validation error response
+ */
+export function createFieldValidationError(fieldName, resourceType, issue, suggestions = []) {
+    return {
+        error: `Field validation failed for '${fieldName}' in ${resourceType}: ${issue}`,
+        error_code: ValidationErrorCode.FIELD_VALIDATION_ERROR,
+        field: fieldName,
+        suggestions: suggestions.length > 0
+            ? suggestions
+            : [`Use get-attributes to see valid fields for ${resourceType}`],
+        help_url: `https://docs.attio.com/api-reference/${resourceType}`,
+        context: { resource_type: resourceType, field_name: fieldName },
+    };
+}
+/**
+ * Create a select option validation error response
+ */
+export function createSelectOptionError(fieldName, invalidValue, validOptions) {
+    return {
+        error: `Invalid value '${invalidValue}' for select field '${fieldName}'. Valid options are: [${validOptions
+            .map((opt) => `'${opt}'`)
+            .join(', ')}].`,
+        error_code: ValidationErrorCode.INVALID_SELECT_OPTION,
+        field: fieldName,
+        suggestions: [
+            `Choose one of: ${validOptions.slice(0, 3).join(', ')}${validOptions.length > 3 ? '...' : ''}`,
+            'Use get-attributes to see all available options',
+        ],
+        context: {
+            field_name: fieldName,
+            provided_value: invalidValue,
+            valid_options: validOptions,
+        },
+    };
+}
+/**
+ * Create a multi-select option validation error response
+ */
+export function createMultiSelectOptionError(fieldName, invalidValues, validOptions) {
+    return {
+        error: `Invalid values [${invalidValues
+            .map((v) => `'${v}'`)
+            .join(', ')}] for multi-select field '${fieldName}'. Valid options are: [${validOptions
+            .map((opt) => `'${opt}'`)
+            .join(', ')}].`,
+        error_code: ValidationErrorCode.INVALID_MULTI_SELECT_OPTION,
+        field: fieldName,
+        suggestions: [
+            `Valid options include: ${validOptions.slice(0, 5).join(', ')}${validOptions.length > 5 ? '...' : ''}`,
+            'Use get-attributes to see all available options',
+        ],
+        context: {
+            field_name: fieldName,
+            invalid_values: invalidValues,
+            valid_options: validOptions,
+        },
+    };
+}
+/**
+ * Create a read-only field error response
+ */
+export function createReadOnlyFieldError(fieldNames, resourceType) {
+    const plural = fieldNames.length > 1;
+    const fieldList = fieldNames.map((field) => `'${field}'`).join(', ');
+    return {
+        error: `Cannot update read-only field${plural ? 's' : ''} ${fieldList}. ${plural ? 'These fields are' : 'This field is'} automatically managed by the system and cannot be modified.`,
+        error_code: ValidationErrorCode.READ_ONLY_FIELD_UPDATE,
+        field: fieldNames.length === 1 ? fieldNames[0] : undefined,
+        suggestions: [
+            `Remove ${plural ? 'these fields' : 'this field'} from your update request`,
+            `Use get-attributes to see which fields are read-only for ${resourceType}`,
+        ],
+        help_url: `https://docs.attio.com/api-reference/${resourceType}`,
+        context: {
+            resource_type: resourceType,
+            read_only_fields: fieldNames,
+        },
+    };
+}
+/**
+ * Create an unknown field error response
+ */
+export function createUnknownFieldError(fieldName, resourceType, suggestions = []) {
+    let errorMessage = `Unknown field '${fieldName}' for resource type '${resourceType}'.`;
+    const actionableSuggestions = [];
+    if (suggestions.length > 0) {
+        errorMessage += ` Did you mean: ${suggestions
+            .map((s) => `'${s}'`)
+            .join(', ')}?`;
+        actionableSuggestions.push(`Try using: ${suggestions[0]}`);
+    }
+    actionableSuggestions.push(`Use get-attributes to see all available fields for ${resourceType}`);
+    return {
+        error: errorMessage,
+        error_code: ValidationErrorCode.UNKNOWN_FIELD,
+        field: fieldName,
+        suggestions: actionableSuggestions,
+        help_url: `https://docs.attio.com/api-reference/${resourceType}`,
+        context: {
+            resource_type: resourceType,
+            invalid_field: fieldName,
+            suggested_fields: suggestions,
+        },
+    };
+}
+/**
+ * Create a field type mismatch error response
+ */
+export function createFieldTypeMismatchError(fieldName, expectedType, actualType, resourceType) {
+    return {
+        error: `Field '${fieldName}' expects type '${expectedType}' but received '${actualType}'.`,
+        error_code: ValidationErrorCode.FIELD_TYPE_MISMATCH,
+        field: fieldName,
+        suggestions: [
+            `Convert the value to ${expectedType} format`,
+            `Check the field definition using get-attributes`,
+        ],
+        help_url: `https://docs.attio.com/api-reference/${resourceType}`,
+        context: {
+            resource_type: resourceType,
+            field_name: fieldName,
+            expected_type: expectedType,
+            actual_type: actualType,
+        },
+    };
+}
+/**
+ * Create a required field missing error response
+ */
+export function createRequiredFieldError(fieldNames, resourceType) {
+    const plural = fieldNames.length > 1;
+    const fieldList = fieldNames.map((field) => `'${field}'`).join(', ');
+    return {
+        error: `Required field${plural ? 's' : ''} ${fieldList} ${plural ? 'are' : 'is'} missing.`,
+        error_code: ValidationErrorCode.REQUIRED_FIELD_MISSING,
+        field: fieldNames.length === 1 ? fieldNames[0] : undefined,
+        suggestions: [
+            `Add ${plural ? 'these required fields' : 'this required field'} to your request`,
+            `Use get-attributes to see all required fields for ${resourceType}`,
+        ],
+        help_url: `https://docs.attio.com/api-reference/${resourceType}`,
+        context: {
+            resource_type: resourceType,
+            missing_fields: fieldNames,
+        },
+    };
+}
+/**
+ * Format an enhanced error response for MCP client consumption
+ */
+export function formatEnhancedErrorResponse(errorResponse) {
+    const formattedError = {
+        content: [
+            {
+                type: 'text',
+                text: errorResponse.error,
+            },
+        ],
+        isError: true,
+        error: {
+            code: errorResponse.error_code,
+            message: errorResponse.error,
+            field: errorResponse.field,
+            suggestions: errorResponse.suggestions,
+            help_url: errorResponse.help_url,
+            context: errorResponse.context,
+        },
+    };
+    // Add suggestions to the text content if available
+    if (errorResponse.suggestions && errorResponse.suggestions.length > 0) {
+        formattedError.content[0].text += '\n\n💡 Suggestions:\n';
+        formattedError.content[0].text += errorResponse.suggestions
+            .map((s) => `  • ${s}`)
+            .join('\n');
+    }
+    // Add help URL if available
+    if (errorResponse.help_url) {
+        formattedError.content[0].text += `\n\n📖 Documentation: ${errorResponse.help_url}`;
+    }
+    return formattedError;
+}
+/**
+ * Create a simple error response (for backward compatibility)
+ */
+export function createErrorResponse(message) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: message,
+            },
+        ],
+        isError: true,
+        error: {
+            message: message,
+        },
+    };
+}
+//# sourceMappingURL=error-response-utils.js.map

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * Error message sanitization utility to prevent information disclosure
+ *
+ * This module provides secure error handling by sanitizing error messages
+ * that might expose sensitive information to potential attackers.
+ */
+/**
+ * Options for error sanitization
+ */
+export interface SanitizationOptions {
+    /** Include safe context in the sanitized message */
+    includeContext?: boolean;
+    /** Log the full error internally before sanitizing */
+    logOriginal?: boolean;
+    /** Module name for logging */
+    module?: string;
+    /** Operation name for logging */
+    operation?: string;
+    /** Additional safe metadata to include */
+    safeMetadata?: Record<string, unknown>;
+}
+/**
+ * Sanitize an error message to remove sensitive information
+ *
+ * @param error - The error to sanitize (Error object or string)
+ * @param options - Sanitization options
+ * @returns Sanitized error message safe for external exposure
+ */
+export declare function sanitizeErrorMessage(error: Error | string | Record<string, unknown>, options?: SanitizationOptions): string;
+/**
+ * Create a sanitized error object with safe properties
+ */
+export interface SanitizedError {
+    message: string;
+    type: string;
+    statusCode?: number;
+    safeMetadata?: Record<string, unknown>;
+}
+/**
+ * Create a fully sanitized error object
+ *
+ * @param error - The error to sanitize
+ * @param statusCode - Optional HTTP status code
+ * @param options - Sanitization options
+ * @returns Sanitized error object
+ */
+export declare function createSanitizedError(error: Error | string | Record<string, unknown>, statusCode?: number, options?: SanitizationOptions): SanitizedError;
+/**
+ * Type alias for async functions that can be wrapped with error sanitization
+ */
+type AsyncFunction = (...args: Record<string, unknown>[]) => Promise<Record<string, unknown>>;
+/**
+ * Middleware-style error sanitizer for wrapping async functions
+ *
+ * @param fn - The async function to wrap
+ * @param options - Sanitization options
+ * @returns Wrapped function that sanitizes errors
+ */
+export declare function withErrorSanitization<T extends AsyncFunction>(fn: T, options?: SanitizationOptions): T;
+/**
+ * Check if a message contains sensitive information
+ *
+ * @param message - The message to check
+ * @returns True if sensitive information is detected
+ */
+export declare function containsSensitiveInfo(message: string): boolean;
+/**
+ * Get a safe error summary for logging or metrics
+ *
+ * @param error - The error to summarize
+ * @returns Safe summary string
+ */
+export declare function getErrorSummary(error: Error | string | Record<string, unknown>): string;
+declare const _default: {
+    sanitizeErrorMessage: typeof sanitizeErrorMessage;
+    createSanitizedError: typeof createSanitizedError;
+    withErrorSanitization: typeof withErrorSanitization;
+    containsSensitiveInfo: typeof containsSensitiveInfo;
+    getErrorSummary: typeof getErrorSummary;
+};
+export default _default;
+//# sourceMappingURL=error-sanitizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/error-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6MH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,OAAO,GAAE,mBAAwB,GAChC,MAAM,CA8HR;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,mBAAwB,GAChC,cAAc,CA4BhB;AAuDD;;GAEG;AACH,KAAK,aAAa,GAAG,CACnB,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,aAAa,EAC3D,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,mBAAwB,GAChC,CAAC,CAoBH;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,MAAM,CASR;;;;;;;;AAED,wBAME"}