@nanocollective/nanocoder 1.17.3 → 1.19.0

package/dist/utils/logging/console-facade.js

@@ -0,0 +1,295 @@
+/**
+ * Console API facade for backward compatibility
+ * Provides drop-in replacement for console methods that routes through structured logging
+ *
+ * This allows gradual migration from console.log to structured logging
+ * without breaking existing code patterns
+ */
+import { createErrorInfo } from '../../utils/error-formatter.js';
+import { generateCorrelationId, getLogger, withNewCorrelationContext, } from '../../utils/logging/index.js';
+// Get logger instance directly to avoid circular dependencies
+const logger = getLogger();
+/**
+ * Create a console method with specific logging level and special handling
+ * This factory reduces code duplication across different console methods
+ */
+function createConsoleMethod(level, options) {
+    const { specialErrorHandling = false, isInfoMethod = false } = options || {};
+    return (...args) => {
+        const _correlationId = generateCorrelationId();
+        withNewCorrelationContext(context => {
+            if (args.length === 0) {
+                logger[level](`Empty console.${level} call`, {
+                    correlationId: context.id,
+                    source: 'console-facade',
+                });
+                return;
+            }
+            // Special handling for Error objects in console.error
+            if (specialErrorHandling &&
+                args.length === 1 &&
+                args[0] instanceof Error) {
+                const errorInfo = createErrorInfo(args[0], undefined, _correlationId);
+                logger.error('Error logged via console.error', {
+                    errorInfo,
+                    correlationId: context.id,
+                    source: 'console-facade',
+                });
+                return;
+            }
+            // Handle single argument case
+            if (args.length === 1) {
+                const arg = args[0];
+                if (typeof arg === 'string') {
+                    logger[level](arg, {
+                        correlationId: context.id,
+                        source: 'console-facade',
+                    });
+                }
+                else if (typeof arg === 'object' && arg !== null) {
+                    const message = `${level === 'error' ? 'Error' : 'Object'} logged via console.${level}`;
+                    logger[level](message, {
+                        object: arg,
+                        correlationId: context.id,
+                        source: 'console-facade',
+                    });
+                }
+                else {
+                    logger[level](String(arg), {
+                        correlationId: context.id,
+                        source: 'console-facade',
+                    });
+                }
+                return;
+            }
+            // Multiple arguments - join strings and log objects separately
+            const strings = args.filter(arg => typeof arg === 'string');
+            const objects = args.filter(arg => typeof arg === 'object' && arg !== null);
+            const primitives = args.filter(arg => typeof arg !== 'string' && typeof arg !== 'object');
+            let message = strings.join(' ');
+            if (primitives.length > 0) {
+                message += ' ' + primitives.map(String).join(' ');
+            }
+            const logData = {
+                correlationId: context.id,
+                source: 'console-facade',
+                argumentCount: args.length,
+                stringArgs: strings.length,
+                objectArgs: objects.length,
+                primitiveArgs: primitives.length,
+            };
+            if (objects.length > 0) {
+                logData.objects = objects;
+            }
+            // Check for error-like objects that aren't Error instances (only for error level)
+            if (level === 'error') {
+                const errorLikeObjects = objects.filter(obj => obj &&
+                    typeof obj === 'object' &&
+                    ('message' in obj || 'error' in obj || 'err' in obj));
+                if (errorLikeObjects.length > 0) {
+                    logData.errorLikeObjects = errorLikeObjects;
+                }
+            }
+            // Use appropriate logger level (info for both log and info methods)
+            const loggerLevel = isInfoMethod ? 'info' : level;
+            logger[loggerLevel](message || `console.${level} called`, logData);
+        });
+    };
+}
+/**
+ * Console replacement that routes to structured logging
+ * Maintains the same API as global console but adds structured logging benefits
+ */
+const StructuredConsole = {
+    /**
+     * Replacement for console.log - routes to logger.info
+     * Accepts any number of arguments and formats them appropriately
+     */
+    log: createConsoleMethod('info', { isInfoMethod: true }),
+    /**
+     * Replacement for console.error - routes to logger.error with error analysis
+     */
+    error: createConsoleMethod('error', { specialErrorHandling: true }),
+    /**
+     * Replacement for console.warn - routes to logger.warn
+     */
+    warn: createConsoleMethod('warn'),
+    /**
+     * Replacement for console.info - routes to logger.info
+     */
+    info: createConsoleMethod('info', { isInfoMethod: true }),
+    /**
+     * Replacement for console.debug - routes to logger.debug
+     */
+    debug: createConsoleMethod('debug'),
+};
+/**
+ * Global console replacement hook
+ * Can be used to temporarily replace global console for testing or specific modules
+ */
+export class ConsoleInterceptor {
+    originalConsole;
+    isActive = false;
+    constructor() {
+        this.originalConsole = { ...console };
+    }
+    /**
+     * Replace global console with structured logging version
+     */
+    activate() {
+        if (this.isActive) {
+            return;
+        }
+        console.log = StructuredConsole.log;
+        console.error = StructuredConsole.error;
+        console.warn = StructuredConsole.warn;
+        console.info = StructuredConsole.info;
+        console.debug = StructuredConsole.debug;
+        this.isActive = true;
+    }
+    /**
+     * Restore original global console
+     */
+    deactivate = () => {
+        if (!this.isActive) {
+            return;
+        }
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        console.log = this.originalConsole.log;
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        console.error = this.originalConsole.error;
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        console.warn = this.originalConsole.warn;
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        console.info = this.originalConsole.info;
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        console.debug = this.originalConsole.debug;
+        this.isActive = false;
+    };
+    /**
+     * Check if interceptor is active
+     */
+    isInterceptorActive() {
+        return this.isActive;
+    }
+    /**
+     * Execute a function with console temporarily replaced
+     */
+    withStructuredConsole(fn) {
+        this.activate();
+        try {
+            return fn();
+        }
+        finally {
+            this.deactivate();
+        }
+    }
+}
+/**
+ * Global console interceptor instance
+ */
+export const globalConsoleInterceptor = new ConsoleInterceptor();
+/**
+ * Decorator to automatically route console calls in a function to structured logging
+ * @internal
+ */
+export function useStructuredConsoleDecorator(_target, _propertyName, descriptor) {
+    const originalMethod = descriptor.value;
+    if (typeof originalMethod === 'function') {
+        descriptor.value = function (...args) {
+            return globalConsoleInterceptor.withStructuredConsole(() => {
+                return Reflect.apply(originalMethod, this, args);
+            });
+        };
+    }
+    return descriptor;
+}
+/**
+ * Convenience function to create a module-scoped console
+ * Useful for gradual migration of individual modules
+ */
+export function createModuleConsole(moduleName) {
+    return {
+        log: (...args) => {
+            logger.info(`[${moduleName}] ${args.filter(a => typeof a === 'string').join(' ')}`, {
+                moduleName,
+                allArgs: args,
+                correlationId: generateCorrelationId(),
+                source: 'module-console',
+            });
+        },
+        error: (...args) => {
+            logger.error(`[${moduleName}] ${args.filter(a => typeof a === 'string').join(' ')}`, {
+                moduleName,
+                allArgs: args,
+                correlationId: generateCorrelationId(),
+                source: 'module-console',
+            });
+        },
+        warn: (...args) => {
+            logger.warn(`[${moduleName}] ${args.filter(a => typeof a === 'string').join(' ')}`, {
+                moduleName,
+                allArgs: args,
+                correlationId: generateCorrelationId(),
+                source: 'module-console',
+            });
+        },
+        info: (...args) => {
+            logger.info(`[${moduleName}] ${args.filter(a => typeof a === 'string').join(' ')}`, {
+                moduleName,
+                allArgs: args,
+                correlationId: generateCorrelationId(),
+                source: 'module-console',
+            });
+        },
+        debug: (...args) => {
+            logger.debug(`[${moduleName}] ${args.filter(a => typeof a === 'string').join(' ')}`, {
+                moduleName,
+                allArgs: args,
+                correlationId: generateCorrelationId(),
+                source: 'module-console',
+            });
+        },
+    };
+}
+/**
+ * Migration helper to identify console usage patterns
+ * Returns statistics about console method usage in the current execution
+ */
+export class ConsoleUsageTracker {
+    usage = new Map();
+    constructor() {
+        // Track console method calls by wrapping them
+        const methods = ['log', 'error', 'warn', 'info', 'debug'];
+        methods.forEach(method => {
+            const original = console[method];
+            this.usage.set(method, 0);
+            console[method] = (...args) => {
+                this.usage.set(method, (this.usage.get(method) || 0) + 1);
+                return original.apply(console, args);
+            };
+        });
+    }
+    getUsageStats() {
+        return Object.fromEntries(this.usage);
+    }
+    reportUsage() {
+        const stats = this.getUsageStats();
+        const total = Object.values(stats).reduce((sum, count) => sum + count, 0);
+        logger.info('Console usage statistics', {
+            total,
+            methodBreakdown: stats,
+            source: 'console-usage-tracker',
+        });
+    }
+    restore() {
+        // This would need to restore the original console methods
+        // Implementation depends on how the original methods are stored
+        logger.info('Console usage tracker deactivated', {
+            source: 'console-usage-tracker',
+        });
+    }
+}
+// Export for testing purposes only
+export { StructuredConsole, useStructuredConsoleDecorator as useStructuredConsole, };
+//# sourceMappingURL=console-facade.js.map

package/dist/utils/logging/console-facade.js.map

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

package/dist/utils/logging/console-facade.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=console-facade.spec.d.ts.map

package/dist/utils/logging/console-facade.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-facade.spec.d.ts","sourceRoot":"","sources":["../../../source/utils/logging/console-facade.spec.ts"],"names":[],"mappings":""}

package/dist/utils/logging/console-facade.spec.js

@@ -0,0 +1,143 @@
+import test from 'ava';
+// Implementation imports
+import { ConsoleInterceptor, ConsoleUsageTracker, StructuredConsole, createModuleConsole, globalConsoleInterceptor, } from './console-facade.js';
+// Since the console-facade uses the real logger at module load time,
+// we'll test the behavior by checking that the methods work correctly
+// and produce the expected output structure.
+test('StructuredConsole.log handles empty arguments', t => {
+    // This test verifies that StructuredConsole.log works without throwing
+    // The real logger will handle the call, so we just check it doesn't throw
+    t.notThrows(() => {
+        StructuredConsole.log();
+    }, 'Should handle empty arguments without throwing');
+});
+test('StructuredConsole.log handles single string argument', t => {
+    const testMessage = 'Test log message';
+    t.notThrows(() => {
+        StructuredConsole.log(testMessage);
+    }, 'Should handle single string argument without throwing');
+});
+test('StructuredConsole.log handles single object argument', t => {
+    const testObject = { key: 'value', number: 42 };
+    t.notThrows(() => {
+        StructuredConsole.log(testObject);
+    }, 'Should handle single object argument without throwing');
+});
+test('StructuredConsole.log handles single primitive argument', t => {
+    const testValue = 123;
+    t.notThrows(() => {
+        StructuredConsole.log(testValue);
+    }, 'Should handle single primitive argument without throwing');
+});
+test('StructuredConsole.log handles multiple arguments', t => {
+    const stringArg = 'Test message';
+    const objectArg = { data: 'test' };
+    const numberArg = 42;
+    t.notThrows(() => {
+        StructuredConsole.log(stringArg, objectArg, numberArg);
+    }, 'Should handle multiple arguments without throwing');
+});
+test('StructuredConsole.error handles Error objects', t => {
+    const testError = new Error('Test error');
+    t.notThrows(() => {
+        StructuredConsole.error(testError);
+    }, 'Should handle Error objects without throwing');
+});
+test('StructuredConsole.warn handles arguments correctly', t => {
+    t.notThrows(() => {
+        StructuredConsole.warn('Warning message', { context: 'test' });
+    }, 'Should handle arguments correctly without throwing');
+});
+test('ConsoleInterceptor activates and deactivates correctly', t => {
+    const originalConsole = {
+        log: console.log,
+        error: console.error,
+        warn: console.warn,
+        info: console.info,
+        debug: console.debug,
+    };
+    const interceptor = new ConsoleInterceptor();
+    // Test activation
+    interceptor.activate();
+    t.true(interceptor.isInterceptorActive());
+    // Verify console methods are replaced
+    t.is(console.log, StructuredConsole.log);
+    t.is(console.error, StructuredConsole.error);
+    t.is(console.warn, StructuredConsole.warn);
+    t.is(console.info, StructuredConsole.info);
+    t.is(console.debug, StructuredConsole.debug);
+    // Test deactivation
+    interceptor.deactivate();
+    t.false(interceptor.isInterceptorActive());
+    // Verify original methods are restored
+    t.is(console.log, originalConsole.log);
+    t.is(console.error, originalConsole.error);
+    t.is(console.warn, originalConsole.warn);
+    t.is(console.info, originalConsole.info);
+    t.is(console.debug, originalConsole.debug);
+});
+test('ConsoleInterceptor handles multiple activation calls', t => {
+    const interceptor = new ConsoleInterceptor();
+    interceptor.activate();
+    const firstActivation = interceptor.isInterceptorActive();
+    interceptor.activate(); // Should not cause issues
+    const secondActivation = interceptor.isInterceptorActive();
+    t.true(firstActivation);
+    t.true(secondActivation);
+    t.is(console.log, StructuredConsole.log);
+    interceptor.deactivate();
+});
+test('ConsoleInterceptor handles deactivation when not active', t => {
+    const interceptor = new ConsoleInterceptor();
+    // Should not throw when deactivating while not active
+    t.notThrows(() => {
+        interceptor.deactivate();
+    }, 'Deactivation when not active should not throw');
+    t.false(interceptor.isInterceptorActive());
+});
+test('globalConsoleInterceptor is available and functional', t => {
+    t.truthy(globalConsoleInterceptor);
+    t.true(globalConsoleInterceptor instanceof ConsoleInterceptor);
+    t.false(globalConsoleInterceptor.isInterceptorActive());
+});
+test('createModuleConsole creates properly scoped console', t => {
+    const moduleName = 'test-module';
+    const moduleConsole = createModuleConsole(moduleName);
+    t.truthy(moduleConsole);
+    t.truthy(typeof moduleConsole.log === 'function');
+    t.truthy(typeof moduleConsole.error === 'function');
+    t.truthy(typeof moduleConsole.warn === 'function');
+    t.truthy(typeof moduleConsole.info === 'function');
+    t.truthy(typeof moduleConsole.debug === 'function');
+});
+test('ConsoleUsageTracker tracks console usage', t => {
+    const tracker = new ConsoleUsageTracker();
+    // Simulate some console calls
+    console.log('test log');
+    console.error('test error');
+    console.log('another log');
+    const stats = tracker.getUsageStats();
+    t.true(typeof stats === 'object');
+});
+test('ConsoleUsageTracker.reportUsage logs statistics', t => {
+    const tracker = new ConsoleUsageTracker();
+    t.notThrows(() => {
+        tracker.reportUsage();
+    }, 'Should report usage without throwing');
+});
+test('ConsoleUsageTracker.restore works without errors', t => {
+    const tracker = new ConsoleUsageTracker();
+    t.notThrows(() => {
+        tracker.restore();
+    }, 'Restore should not throw errors');
+});
+test('StructuredConsole handles all console methods consistently', t => {
+    const methods = ['log', 'error', 'warn', 'info', 'debug'];
+    methods.forEach(method => {
+        // Call the method with a test message
+        t.notThrows(() => {
+            StructuredConsole[method](`Test ${method} message`);
+        }, `${method} should work without throwing`);
+    });
+});
+//# sourceMappingURL=console-facade.spec.js.map

package/dist/utils/logging/console-facade.spec.js.map

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

package/dist/utils/logging/correlation.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Correlation ID management for tracking requests across components
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+import type { CorrelationContext, CorrelationHttpRequest, CorrelationHttpResponse } from './types.js';
+/**
+ * Async local storage for correlation context
+ * Provides thread-safe context storage across async operations
+ */
+export declare const correlationStorage: AsyncLocalStorage<CorrelationContext>;
+/**
+ * Correlation Context Monitoring Metrics
+ * Tracks usage, performance, and potential issues for production monitoring
+ */
+declare const correlationMonitoring: {
+    contextsCreated: number;
+    activeContexts: number;
+    errors: number;
+    lastError: string | null;
+    lastErrorTime: number;
+    startTime: number;
+};
+/**
+ * Legacy context has been removed in favor of AsyncLocalStorage-only approach
+ * This eliminates race conditions in concurrent operations
+ * All code should now use withCorrelationContext() or withNewCorrelationContext()
+ */
+/**
+ * Get correlation context monitoring metrics
+ * Provides insights into context usage, performance, and health
+ */
+export declare function getCorrelationMonitoring(): typeof correlationMonitoring;
+/**
+ * Log correlation context monitoring metrics
+ * Useful for periodic logging of system health
+ * @internal
+ */
+export declare function logCorrelationMonitoring(level?: 'debug' | 'info' | 'warn' | 'error'): void;
+/**
+ * Reset correlation context monitoring metrics
+ * Useful for testing or periodic reporting
+ */
+export declare function resetCorrelationMonitoring(): void;
+/**
+ * Perform health check on correlation context system
+ * Verifies that the AsyncLocalStorage context system is functioning properly
+ */
+export declare function checkCorrelationHealth(): {
+    healthy: boolean;
+    message: string;
+    metrics: typeof correlationMonitoring;
+};
+/**
+ * Generate a new correlation ID
+ */
+export declare function generateCorrelationId(): string;
+/**
+ * Generate a short correlation ID (8 characters) for display
+ */
+export declare function generateShortCorrelationId(): string;
+/**
+ * Create a new correlation context with specific ID
+ */
+export declare function createCorrelationContextWithId(id: string, metadata?: Record<string, unknown>): CorrelationContext;
+/**
+ * Create a new correlation context with optional parent ID
+ */
+export declare function createCorrelationContext(parentId?: string, metadata?: Record<string, unknown>): CorrelationContext;
+/**
+ * Get the current correlation context
+ * Now uses AsyncLocalStorage exclusively - no legacy fallback
+ */
+export declare function getCurrentCorrelationContext(): CorrelationContext | null;
+/**
+ * Set the current correlation context (runs function with context)
+ * Note: AsyncLocalStorage doesn't support direct setting, use withCorrelationContext instead
+ * @deprecated Use withCorrelationContext or withNewCorrelationContext
+ */
+export declare function setCorrelationContext(_context: CorrelationContext): void;
+/**
+ * Clear the current correlation context
+ * Note: AsyncLocalStorage handles cleanup automatically
+ * @deprecated Context is automatically cleared when async operation completes
+ */
+export declare function clearCorrelationContext(): void;
+/**
+ * Run a function with a specific correlation context
+ */
+export declare function withCorrelationContext<T>(context: CorrelationContext, fn: () => T): T;
+/**
+ * Run a function with a new correlation context
+ */
+export declare function withNewCorrelationContext<T>(fn: (context: CorrelationContext) => T, correlationId?: string, metadata?: Record<string, unknown>): T;
+/**
+ * Get the correlation ID for the current context
+ */
+export declare function getCorrelationId(): string | null;
+/**
+ * Check if correlation is enabled
+ */
+export declare function isCorrelationEnabled(): boolean;
+/**
+ * Get correlation header for HTTP requests
+ */
+export declare function getCorrelationHeader(): {
+    'X-Correlation-ID': string;
+} | Record<string, never>;
+/**
+ * Extract correlation ID from HTTP headers
+ */
+export declare function extractCorrelationId(headers: Record<string, string>): string | null;
+/**
+ * Create a correlation context from HTTP headers
+ */
+export declare function createCorrelationFromHeaders(headers: Record<string, string>, metadata?: Record<string, unknown>): CorrelationContext | null;
+/**
+ * Add correlation metadata
+ * Note: Creates a new context with updated metadata since AsyncLocalStorage is immutable
+ * @deprecated Use withNewCorrelationContext with metadata parameter
+ */
+export declare function addCorrelationMetadata(_key: string, _value: unknown): void;
+/**
+ * Get correlation metadata
+ */
+export declare function getCorrelationMetadata(key?: string): unknown;
+/**
+ * Format correlation context for logging
+ */
+export declare function formatCorrelationForLog(): Record<string, string>;
+/**
+ * Correlation middleware for Express-like frameworks
+ */
+export declare function correlationMiddleware(): (req: CorrelationHttpRequest, res: CorrelationHttpResponse, next: () => void) => void;
+/**
+ * Wrap an async function with correlation tracking
+ */
+export declare function withCorrelation<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, getCorrelationIdFromArgs?: (...args: Parameters<T>) => string): T;
+export {};
+//# sourceMappingURL=correlation.d.ts.map

package/dist/utils/logging/correlation.d.ts.map

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