@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/logger.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Enhanced structured logging utility for consistent logging across the application
+ */
+import type { JsonObject } from '../types/attio.js';
+/**
+ * Log level enum for controlling verbosity
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * Operation types for better log categorization
+ */
+export declare enum OperationType {
+    API_CALL = "api_call",
+    TOOL_EXECUTION = "tool_execution",
+    DATA_PROCESSING = "data_processing",
+    VALIDATION = "validation",
+    TRANSFORMATION = "transformation",
+    SYSTEM = "system"
+}
+/**
+ * Structured log metadata interface
+ */
+export interface LogMetadata {
+    timestamp: string;
+    level: string;
+    module: string;
+    operation?: string;
+    operationType?: OperationType;
+    correlationId?: string;
+    sessionId?: string;
+    duration?: number;
+    requestId?: string;
+    userId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Structured log entry interface
+ */
+export interface LogEntry {
+    message: string;
+    metadata: LogMetadata;
+    data?: JsonObject;
+    error?: {
+        message: string;
+        name: string;
+        stack?: string;
+        code?: string | number;
+    };
+}
+/**
+ * Context for tracking related operations
+ */
+interface LogContext {
+    correlationId?: string;
+    sessionId?: string;
+    requestId?: string;
+    userId?: string;
+    operation?: string;
+    operationType?: OperationType;
+}
+/**
+ * Current log level based on environment configuration
+ * Priority: MCP_LOG_LEVEL > LOG_LEVEL > NODE_ENV-based defaults
+ */
+export declare const CURRENT_LOG_LEVEL: LogLevel;
+/**
+ * Set global logging context for correlation tracking
+ */
+export declare function setLogContext(context: Partial<LogContext>): void;
+/**
+ * Get current logging context
+ */
+export declare function getLogContext(): LogContext;
+/**
+ * Clear logging context
+ */
+export declare function clearLogContext(): void;
+/**
+ * Generate a new correlation ID
+ */
+export declare function generateCorrelationId(): string;
+/**
+ * Log a debug message (only in development)
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param data - Optional data to include with the log
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export declare function debug(module: string, message: string, data?: JsonObject, operation?: string, operationType?: OperationType): void;
+/**
+ * Log an info message
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param data - Optional data to include with the log
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export declare function info(module: string, message: string, data?: JsonObject, operation?: string, operationType?: OperationType): void;
+/**
+ * Log a warning message
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param data - Optional data to include with the log
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export declare function warn(module: string, message: string, data?: JsonObject, operation?: string, operationType?: OperationType): void;
+/**
+ * Log an error message
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param errorObj - Optional error object
+ * @param data - Optional additional data
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export declare function error(module: string, message: string, errorObj?: unknown, data?: JsonObject, operation?: string, operationType?: OperationType): void;
+/**
+ * Performance timing utility for tracking operation duration
+ */
+export declare class PerformanceTimer {
+    private startTime;
+    private module;
+    private operation;
+    private operationType;
+    constructor(module: string, operation: string, operationType?: OperationType);
+    /**
+     * End timing and log the duration
+     */
+    end(message?: string, data?: Record<string, unknown>): number;
+}
+/**
+ * Enhanced operation start logging with timing
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the operation being performed
+ * @param operationType - Type of operation for categorization
+ * @param params - Parameters for the operation
+ * @returns PerformanceTimer instance for tracking duration
+ */
+export declare function operationStart(module: string, operation: string, operationType?: OperationType, params?: JsonObject): PerformanceTimer;
+/**
+ * Logs the successful completion of an API operation
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the operation being performed
+ * @param resultSummary - Summary of the operation result (e.g., count of items)
+ * @param operationType - Type of operation for categorization
+ * @param duration - Optional duration in milliseconds
+ */
+export declare function operationSuccess(module: string, operation: string, resultSummary?: JsonObject, operationType?: OperationType, duration?: number): void;
+/**
+ * Logs the failure of an API operation
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the operation that failed
+ * @param errorObj - The error object
+ * @param context - Additional context information
+ * @param operationType - Type of operation for categorization
+ * @param duration - Optional duration in milliseconds
+ */
+export declare function operationFailure(module: string, operation: string, errorObj: unknown, context?: JsonObject, operationType?: OperationType, duration?: number): void;
+/**
+ * Logs the start of a fallback API operation
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the fallback operation
+ * @param reason - Reason for falling back
+ * @param operationType - Type of operation for categorization
+ */
+export declare function fallbackStart(module: string, operation: string, reason: string, operationType?: OperationType): void;
+/**
+ * Creates a scoped logger instance with pre-configured context
+ */
+export declare class SecureLogger {
+    private readonly module;
+    private readonly operation?;
+    private readonly operationType;
+    constructor(module: string, operation?: string | undefined, operationType?: OperationType);
+    debug(message: string, data?: JsonObject): void;
+    info(message: string, data?: JsonObject): void;
+    warn(message: string, data?: JsonObject): void;
+    error(message: string, errorObj?: unknown, data?: JsonObject): void;
+    operationStart(op?: string, opType?: OperationType, params?: JsonObject): PerformanceTimer;
+    operationSuccess(op?: string, resultSummary?: JsonObject, opType?: OperationType, duration?: number): void;
+    operationFailure(op?: string, errorObj?: unknown, context?: JsonObject, opType?: OperationType, duration?: number): void;
+}
+export declare function createScopedLogger(module: string, operation?: string, operationType?: OperationType): SecureLogger;
+/**
+ * Utility for wrapping async operations with automatic logging
+ */
+export declare function withLogging<T>(module: string, operation: string, operationType: OperationType, fn: () => Promise<T>, context?: JsonObject): Promise<T>;
+export declare function safeMcpLog(message: string, ...args: unknown[]): void;
+declare const _default: {
+    debug: typeof debug;
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+    operationStart: typeof operationStart;
+    operationSuccess: typeof operationSuccess;
+    operationFailure: typeof operationFailure;
+    fallbackStart: typeof fallbackStart;
+    setLogContext: typeof setLogContext;
+    getLogContext: typeof getLogContext;
+    clearLogContext: typeof clearLogContext;
+    generateCorrelationId: typeof generateCorrelationId;
+    createScopedLogger: typeof createScopedLogger;
+    SecureLogger: typeof SecureLogger;
+    withLogging: typeof withLogging;
+    safeMcpLog: typeof safeMcpLog;
+    PerformanceTimer: typeof PerformanceTimer;
+    LogLevel: typeof LogLevel;
+    OperationType: typeof OperationType;
+};
+export default _default;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

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

package/dist/utils/logger.js

@@ -0,0 +1,401 @@
+/**
+ * Enhanced structured logging utility for consistent logging across the application
+ */
+import { randomUUID } from 'crypto';
+import { safeJsonStringify } from '../utils/json-serializer.js';
+import { sanitizeErrorDetail, sanitizeLogMessage, sanitizeLogPayload, sanitizeMetadata, } from '../utils/log-sanitizer.js';
+/**
+ * Log level enum for controlling verbosity
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["NONE"] = 4] = "NONE";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Operation types for better log categorization
+ */
+export var OperationType;
+(function (OperationType) {
+    OperationType["API_CALL"] = "api_call";
+    OperationType["TOOL_EXECUTION"] = "tool_execution";
+    OperationType["DATA_PROCESSING"] = "data_processing";
+    OperationType["VALIDATION"] = "validation";
+    OperationType["TRANSFORMATION"] = "transformation";
+    OperationType["SYSTEM"] = "system";
+})(OperationType || (OperationType = {}));
+/**
+ * Parse log level from environment variable
+ */
+function parseLogLevel(envValue) {
+    if (!envValue)
+        return LogLevel.DEBUG;
+    const normalized = envValue.toUpperCase();
+    switch (normalized) {
+        case 'DEBUG':
+            return LogLevel.DEBUG;
+        case 'INFO':
+            return LogLevel.INFO;
+        case 'WARN':
+        case 'WARNING':
+            return LogLevel.WARN;
+        case 'ERROR':
+            return LogLevel.ERROR;
+        case 'NONE':
+        case 'OFF':
+            return LogLevel.NONE;
+        default:
+            // If invalid, fallback to environment-based defaults
+            return process.env.NODE_ENV === 'production'
+                ? LogLevel.INFO
+                : LogLevel.DEBUG;
+    }
+}
+/**
+ * Current log level based on environment configuration
+ * Priority: MCP_LOG_LEVEL > LOG_LEVEL > NODE_ENV-based defaults
+ */
+export const CURRENT_LOG_LEVEL = (() => {
+    // Force DEBUG during Vitest runs for deterministic logging in tests
+    if (process.env.VITEST === 'true') {
+        return LogLevel.DEBUG;
+    }
+    // First check MCP-specific log level
+    if (process.env.MCP_LOG_LEVEL) {
+        return parseLogLevel(process.env.MCP_LOG_LEVEL);
+    }
+    // Then check generic log level
+    if (process.env.LOG_LEVEL) {
+        return parseLogLevel(process.env.LOG_LEVEL);
+    }
+    // Finally fallback to NODE_ENV-based defaults
+    return process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG;
+})();
+/**
+ * Global log context storage
+ */
+let globalContext = {};
+/**
+ * Set global logging context for correlation tracking
+ */
+export function setLogContext(context) {
+    globalContext = { ...globalContext, ...context };
+}
+/**
+ * Get current logging context
+ */
+export function getLogContext() {
+    return { ...globalContext };
+}
+/**
+ * Clear logging context
+ */
+export function clearLogContext() {
+    globalContext = {};
+}
+/**
+ * Generate a new correlation ID
+ */
+export function generateCorrelationId() {
+    return randomUUID();
+}
+/**
+ * Create structured log metadata
+ */
+function createLogMetadata(level, module, operation, operationType, additionalMetadata) {
+    const sanitizedMetadata = sanitizeMetadata(additionalMetadata);
+    return {
+        timestamp: new Date().toISOString(),
+        level,
+        module,
+        operation: operation || globalContext.operation,
+        operationType: operationType || globalContext.operationType,
+        correlationId: globalContext.correlationId,
+        sessionId: globalContext.sessionId,
+        requestId: globalContext.requestId,
+        userId: globalContext.userId,
+        ...(sanitizedMetadata || {}),
+    };
+}
+/**
+ * Format and output structured log entry
+ */
+function outputLog(entry, logFunction) {
+    if (process.env.LOG_FORMAT === 'json') {
+        // Output compact JSON using safe stringify to prevent errors
+        logFunction(safeJsonStringify(entry, { indent: 0 }));
+    }
+    else {
+        // Output pretty-printed JSON to maintain human readability for console,
+        // while ensuring it's a single, valid JSON string to prevent MCP parsing errors.
+        logFunction(safeJsonStringify(entry, { indent: 2 }));
+    }
+}
+/**
+ * Log a debug message (only in development)
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param data - Optional data to include with the log
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export function debug(module, message, data, operation, operationType) {
+    if (CURRENT_LOG_LEVEL <= LogLevel.DEBUG) {
+        const sanitizedMessage = sanitizeLogMessage(message);
+        const sanitizedData = data
+            ? sanitizeLogPayload(data)
+            : undefined;
+        const entry = {
+            message: sanitizedMessage,
+            metadata: createLogMetadata('DEBUG', module, operation, operationType),
+            ...(sanitizedData ? { data: sanitizedData } : {}),
+        };
+        outputLog(entry, console.error); // Use stderr instead of stdout to avoid interfering with MCP protocol
+    }
+}
+/**
+ * Log an info message
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param data - Optional data to include with the log
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export function info(module, message, data, operation, operationType) {
+    if (CURRENT_LOG_LEVEL <= LogLevel.INFO) {
+        const sanitizedMessage = sanitizeLogMessage(message);
+        const sanitizedData = data
+            ? sanitizeLogPayload(data)
+            : undefined;
+        const entry = {
+            message: sanitizedMessage,
+            metadata: createLogMetadata('INFO', module, operation, operationType),
+            ...(sanitizedData ? { data: sanitizedData } : {}),
+        };
+        outputLog(entry, console.error); // Use stderr instead of stdout to avoid interfering with MCP protocol
+    }
+}
+/**
+ * Log a warning message
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param data - Optional data to include with the log
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export function warn(module, message, data, operation, operationType) {
+    if (CURRENT_LOG_LEVEL <= LogLevel.WARN) {
+        const sanitizedMessage = sanitizeLogMessage(message);
+        const sanitizedData = data
+            ? sanitizeLogPayload(data)
+            : undefined;
+        const entry = {
+            message: sanitizedMessage,
+            metadata: createLogMetadata('WARN', module, operation, operationType),
+            ...(sanitizedData ? { data: sanitizedData } : {}),
+        };
+        outputLog(entry, console.warn);
+    }
+}
+/**
+ * Log an error message
+ *
+ * @param module - Name of the module/function logging the message
+ * @param message - Message to log
+ * @param errorObj - Optional error object
+ * @param data - Optional additional data
+ * @param operation - Optional operation name
+ * @param operationType - Optional operation type
+ */
+export function error(module, message, errorObj, data, operation, operationType) {
+    if (CURRENT_LOG_LEVEL <= LogLevel.ERROR) {
+        const sanitizedMessage = sanitizeLogMessage(message);
+        const sanitizedData = data
+            ? sanitizeLogPayload(data)
+            : undefined;
+        const sanitizedError = sanitizeErrorDetail(errorObj);
+        const entry = {
+            message: sanitizedMessage,
+            metadata: createLogMetadata('ERROR', module, operation, operationType),
+            ...(sanitizedData ? { data: sanitizedData } : {}),
+            ...(sanitizedError ? { error: sanitizedError } : {}),
+        };
+        outputLog(entry, console.error);
+    }
+}
+/**
+ * Performance timing utility for tracking operation duration
+ */
+export class PerformanceTimer {
+    startTime;
+    module;
+    operation;
+    operationType;
+    constructor(module, operation, operationType = OperationType.SYSTEM) {
+        this.module = module;
+        this.operation = operation;
+        this.operationType = operationType;
+        this.startTime = Date.now();
+    }
+    /**
+     * End timing and log the duration
+     */
+    end(message, data) {
+        const duration = Date.now() - this.startTime;
+        debug(this.module, message || `Operation completed: ${this.operation}`, { ...data, duration: `${duration}ms` }, this.operation, this.operationType);
+        return duration;
+    }
+}
+/**
+ * Enhanced operation start logging with timing
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the operation being performed
+ * @param operationType - Type of operation for categorization
+ * @param params - Parameters for the operation
+ * @returns PerformanceTimer instance for tracking duration
+ */
+export function operationStart(module, operation, operationType = OperationType.SYSTEM, params) {
+    debug(module, `Starting operation: ${operation}`, params, operation, operationType);
+    return new PerformanceTimer(module, operation, operationType);
+}
+/**
+ * Logs the successful completion of an API operation
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the operation being performed
+ * @param resultSummary - Summary of the operation result (e.g., count of items)
+ * @param operationType - Type of operation for categorization
+ * @param duration - Optional duration in milliseconds
+ */
+export function operationSuccess(module, operation, resultSummary, operationType = OperationType.SYSTEM, duration) {
+    const logData = {
+        ...resultSummary,
+        ...(duration && { duration: `${duration}ms` }),
+    };
+    info(module, `Operation successful: ${operation}`, logData, operation, operationType);
+}
+/**
+ * Logs the failure of an API operation
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the operation that failed
+ * @param errorObj - The error object
+ * @param context - Additional context information
+ * @param operationType - Type of operation for categorization
+ * @param duration - Optional duration in milliseconds
+ */
+export function operationFailure(module, operation, errorObj, context, operationType = OperationType.SYSTEM, duration) {
+    const logData = {
+        ...context,
+        ...(duration && { duration: `${duration}ms` }),
+    };
+    error(module, `Operation failed: ${operation}`, errorObj, logData, operation, operationType);
+}
+/**
+ * Logs the start of a fallback API operation
+ *
+ * @param module - Name of the module/function
+ * @param operation - Name of the fallback operation
+ * @param reason - Reason for falling back
+ * @param operationType - Type of operation for categorization
+ */
+export function fallbackStart(module, operation, reason, operationType = OperationType.API_CALL) {
+    warn(module, `Trying fallback: ${operation}. Reason: ${reason}`, { reason }, operation, operationType);
+}
+/**
+ * Creates a scoped logger instance with pre-configured context
+ */
+export class SecureLogger {
+    module;
+    operation;
+    operationType;
+    constructor(module, operation, operationType = OperationType.SYSTEM) {
+        this.module = module;
+        this.operation = operation;
+        this.operationType = operationType;
+    }
+    debug(message, data) {
+        debug(this.module, message, data, this.operation, this.operationType);
+    }
+    info(message, data) {
+        info(this.module, message, data, this.operation, this.operationType);
+    }
+    warn(message, data) {
+        warn(this.module, message, data, this.operation, this.operationType);
+    }
+    error(message, errorObj, data) {
+        error(this.module, message, errorObj, data, this.operation, this.operationType);
+    }
+    operationStart(op, opType, params) {
+        return operationStart(this.module, op || this.operation || 'unknown', opType || this.operationType, params);
+    }
+    operationSuccess(op, resultSummary, opType, duration) {
+        operationSuccess(this.module, op || this.operation || 'unknown', resultSummary, opType || this.operationType, duration);
+    }
+    operationFailure(op, errorObj, context, opType, duration) {
+        operationFailure(this.module, op || this.operation || 'unknown', errorObj, context, opType || this.operationType, duration);
+    }
+}
+export function createScopedLogger(module, operation, operationType) {
+    return new SecureLogger(module, operation, operationType);
+}
+/**
+ * Utility for wrapping async operations with automatic logging
+ */
+export async function withLogging(module, operation, operationType, fn, context) {
+    const timer = operationStart(module, operation, operationType, context);
+    try {
+        const result = await fn();
+        const duration = timer.end();
+        operationSuccess(module, operation, { success: true }, operationType, duration);
+        return result;
+    }
+    catch (error) {
+        const duration = timer.end();
+        operationFailure(module, operation, error, context, operationType, duration);
+        throw error;
+    }
+}
+export function safeMcpLog(message, ...args) {
+    // Always use console.error to avoid interfering with MCP protocol
+    const sanitizedMessage = sanitizeLogMessage(message);
+    const sanitizedArgs = args.map((arg) => {
+        if (typeof arg === 'string') {
+            return sanitizeLogMessage(arg);
+        }
+        if (typeof arg === 'object' && arg !== null) {
+            return sanitizeLogPayload(arg);
+        }
+        return arg;
+    });
+    console.error(`[MCP_SAFE_LOG] ${sanitizedMessage}`, ...sanitizedArgs);
+}
+export default {
+    debug,
+    info,
+    warn,
+    error,
+    operationStart,
+    operationSuccess,
+    operationFailure,
+    fallbackStart,
+    setLogContext,
+    getLogContext,
+    clearLogContext,
+    generateCorrelationId,
+    createScopedLogger,
+    SecureLogger,
+    withLogging,
+    safeMcpLog,
+    PerformanceTimer,
+    LogLevel,
+    OperationType,
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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