@nanocollective/nanocoder 1.17.3 → 1.19.0

package/dist/utils/logging/index.js

@@ -0,0 +1,186 @@
+/**
+ * Main logging interface with facade pattern for backward compatibility
+ * Uses dependency injection pattern to avoid circular dependencies
+ */
+import { loggerProvider } from './logger-provider.js';
+/**
+ * Initialize the logger with configuration
+ */
+export function initializeLogger(config) {
+    return loggerProvider.initializeLogger(config);
+}
+/**
+ * Get the current logger instance
+ */
+export function getLogger() {
+    return loggerProvider.getLogger();
+}
+/**
+ * Get the current configuration
+ */
+export function getLoggerConfig() {
+    return loggerProvider.getLoggerConfig();
+}
+/**
+ * Create a child logger with additional context
+ */
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic bindings for logger context
+export function createChildLogger(bindings) {
+    return loggerProvider.createChildLogger(bindings);
+}
+/**
+ * Check if a log level is enabled
+ */
+export function isLevelEnabled(level) {
+    return loggerProvider.isLevelEnabled(level);
+}
+/**
+ * Convenience methods that match console.log API
+ */
+export const log = {
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for logger methods
+    fatal: (msg, ...args) => getLogger().fatal(msg, ...args),
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for logger methods
+    error: (msg, ...args) => getLogger().error(msg, ...args),
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for logger methods
+    warn: (msg, ...args) => getLogger().warn(msg, ...args),
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for logger methods
+    info: (msg, ...args) => getLogger().info(msg, ...args),
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for logger methods
+    http: (msg, ...args) => getLogger().http(msg, ...args),
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for logger methods
+    debug: (msg, ...args) => getLogger().debug(msg, ...args),
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for logger methods
+    trace: (msg, ...args) => getLogger().trace(msg, ...args),
+};
+/**
+ * Backward compatibility facade - wraps console during transition
+ * This will be gradually replaced with structured logging
+ */
+export const console = {
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for console compatibility
+    log: (...args) => {
+        // For now, use info level for console.log
+        log.info(args.join(' '));
+        // TODO: Add deprecation warning in development mode
+        if (process.env.NODE_ENV === 'development') {
+            process.stderr.write('\x1b[33m[DEPRECATED]\x1b[0m console.log() is deprecated. Use logger.info() instead.\n');
+        }
+    },
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for console compatibility
+    error: (...args) => {
+        log.error(args.join(' '));
+    },
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for console compatibility
+    warn: (...args) => {
+        log.warn(args.join(' '));
+    },
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for console compatibility
+    info: (...args) => {
+        log.info(args.join(' '));
+    },
+    // biome-ignore lint/suspicious/noExplicitAny: Variadic arguments for console compatibility
+    debug: (...args) => {
+        log.debug(args.join(' '));
+    },
+};
+/**
+ * Flush any pending logs
+ */
+export async function flush() {
+    await loggerProvider.flush();
+}
+/**
+ * End the logger and close all streams
+ */
+export async function end() {
+    await loggerProvider.end();
+}
+// Setup graceful shutdown handlers
+process.on('SIGTERM', () => {
+    void (async () => {
+        log.info('\n[LOGGER] Received SIGTERM, flushing logs...');
+        await flush();
+        await end();
+        log.info('[LOGGER] Graceful shutdown completed');
+    })();
+});
+process.on('SIGINT', () => {
+    void (async () => {
+        log.info('\n[LOGGER] Received SIGINT, flushing logs...');
+        await flush();
+        await end();
+        log.info('[LOGGER] Graceful shutdown completed');
+    })();
+});
+// Handle uncaught exceptions and unhandled rejections
+process.on('uncaughtException', err => {
+    void (async () => {
+        const logger = getLogger();
+        logger.fatal({ err }, 'Uncaught exception');
+        await flush();
+        process.exit(1);
+    })();
+});
+process.on('unhandledRejection', (reason, promise) => {
+    void (async () => {
+        const logger = getLogger();
+        logger.fatal({ reason, promise }, 'Unhandled promise rejection');
+        await flush();
+        process.exit(1);
+    })();
+});
+// Export for testing purposes only
+export { 
+/** @internal */
+createCorrelationFromHeaders, 
+/** @internal */
+extractCorrelationId, 
+/** @internal */
+formatCorrelationForLog, 
+/** @internal */
+correlationMiddleware, } from './correlation.js';
+// Export correlation utilities
+export { generateCorrelationId, withNewCorrelationContext, getCorrelationId, } from './correlation.js';
+// Export performance utilities
+export { startMetrics, endMetrics, calculateMemoryDelta, formatMemoryUsage, 
+/** @internal */
+formatBytes, 
+/** @internal */
+globalPerformanceMonitor, } from './performance.js';
+// Export configuration utilities
+export { 
+/** @internal */
+getDefaultLogDirectory, 
+/** @internal */
+getEnvironmentConfig, 
+/** @internal */
+validateLogLevel, 
+/** @internal */
+normalizeLogLevel, 
+/** @internal */
+createConfig, } from './config.js';
+// Export transport utilities (used internally only)
+// No exports from transports.js as they are only used internally
+// Console facade exports (only used in tests)
+// No exports from console-facade.js as they are only used internally and in tests
+// Export request tracking utilities (specific instances used by other modules)
+export { healthChecks } from './health-monitor.js';
+// Internal exports that knip should ignore
+/** @internal */
+export { httpTracker } from './request-tracker.js';
+/** @internal */
+export { aiTracker } from './request-tracker.js';
+/** @internal */
+export { mcpTracker } from './request-tracker.js';
+export { globalRequestTracker } from './request-tracker.js';
+// Export log storage for tests
+export { globalLogStorage } from './log-query.js';
+// Internal exports that knip should ignore
+/** @internal */
+export { globalHealthMonitor } from './health-monitor.js';
+/** @internal */
+export { initializeHealthMonitoring } from './health-monitor.js';
+/** @internal */
+export { healthCheckMiddleware } from './health-monitor.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/logging/index.js.map

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

package/dist/utils/logging/index.spec.d.ts

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

package/dist/utils/logging/index.spec.d.ts.map

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

package/dist/utils/logging/index.spec.js

@@ -0,0 +1,214 @@
+import { existsSync, mkdirSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import test from 'ava';
+console.log(`\nlogging/index.spec.ts`);
+// Import the logging functions we want to test
+import { createChildLogger, end, flush, getLogger, getLoggerConfig, initializeLogger, isLevelEnabled, log, console as structuredConsole, } from './index.js';
+// Import logger provider for reset functionality
+import { LoggerProvider } from './logger-provider.js';
+// Create a temporary test directory
+const testDir = join(tmpdir(), `nanocoder-logging-test-${Date.now()}`);
+test.before(() => {
+    // Create test directory
+    mkdirSync(testDir, { recursive: true });
+    // Set test environment variables
+    process.env.NODE_ENV = 'test';
+    process.env.LOG_LEVEL = 'debug';
+});
+test.after.always(async () => {
+    // Clean up test directory
+    if (existsSync(testDir)) {
+        rmSync(testDir, { recursive: true, force: true });
+    }
+    // Reset logger state
+    await end();
+});
+test('initializeLogger creates a logger instance', t => {
+    const logger = initializeLogger({
+        level: 'debug',
+        pretty: true,
+    });
+    t.truthy(logger, 'Logger should be created');
+    t.is(typeof logger.info, 'function', 'Logger should have info method');
+    t.is(typeof logger.error, 'function', 'Logger should have error method');
+    t.is(typeof logger.warn, 'function', 'Logger should have warn method');
+    t.is(typeof logger.debug, 'function', 'Logger should have debug method');
+});
+test('getLogger returns the same logger instance', t => {
+    // Reset logger state first
+    const logger1 = initializeLogger({ level: 'info' });
+    const logger2 = getLogger();
+    const logger3 = getLogger();
+    t.is(logger1, logger2, 'Should return same instance');
+    t.is(logger2, logger3, 'Should return same instance');
+});
+test('getLogger auto-initializes with defaults', async (t) => {
+    // Reset logger state
+    await end();
+    const logger = getLogger();
+    t.truthy(logger, 'Should auto-initialize logger');
+    t.is(typeof logger.info, 'function', 'Should have info method');
+});
+test('getLoggerConfig returns current configuration', t => {
+    const config = {
+        level: 'warn',
+        pretty: false,
+        redact: ['apiKey'],
+        correlation: true,
+        serialize: true,
+    };
+    initializeLogger(config);
+    const retrievedConfig = getLoggerConfig();
+    t.truthy(retrievedConfig, 'Should return configuration');
+    // Note: The logger provider may apply default configuration overrides
+    // so we check that the level is set appropriately rather than exact match
+    t.truthy(retrievedConfig.level, 'Should have level');
+    t.is(retrievedConfig.pretty, config.pretty, 'Should match pretty setting');
+    // Check that the redaction rules include our custom rule
+    t.true(retrievedConfig.redact.includes('apiKey'), 'Should include custom redaction rule');
+});
+test('createChildLogger creates child with bindings', t => {
+    const parentLogger = initializeLogger({ level: 'debug' });
+    const childBindings = { module: 'test', userId: '123' };
+    const childLogger = createChildLogger(childBindings);
+    t.truthy(childLogger, 'Should create child logger');
+    t.is(typeof childLogger.info, 'function', 'Child should have info method');
+    t.not(parentLogger, childLogger, 'Should be different instance');
+});
+test('isLevelEnabled checks log level correctly', t => {
+    // Reset logger to ensure clean state
+    const provider = LoggerProvider.getInstance();
+    provider.reset();
+    // Initialize with debug level to ensure logging is enabled in tests
+    initializeLogger({ level: 'debug' });
+    // With debug level, these should all be enabled
+    t.true(isLevelEnabled('debug'), 'Debug should be enabled');
+    t.true(isLevelEnabled('trace'), 'Trace should be enabled');
+    t.true(isLevelEnabled('warn'), 'Warn should be enabled');
+    t.true(isLevelEnabled('error'), 'Error should be enabled');
+    t.true(isLevelEnabled('fatal'), 'Fatal should be enabled');
+});
+test('log convenience methods work correctly', t => {
+    const logger = initializeLogger({ level: 'debug' });
+    t.notThrows(() => {
+        log.debug('Debug message');
+        log.info('Info message');
+        log.warn('Warning message');
+        log.error('Error message');
+        log.fatal('Fatal message');
+        log.http('HTTP message');
+        log.trace('Trace message');
+    }, 'Log methods should not throw');
+});
+test('structured console facade provides backward compatibility', t => {
+    t.notThrows(() => {
+        structuredConsole.log('Test log message');
+        structuredConsole.info('Test info message');
+        structuredConsole.warn('Test warning message');
+        structuredConsole.error('Test error message');
+        structuredConsole.debug('Test debug message');
+    }, 'Console facade methods should not throw');
+});
+test('flush and end methods work correctly', async (t) => {
+    const logger = initializeLogger({ level: 'info' });
+    logger.info('Test message for flushing');
+    await t.notThrowsAsync(async () => {
+        await flush();
+        await end();
+    }, 'Flush and end should not throw');
+});
+test('logger handles different log levels correctly', t => {
+    const logger = initializeLogger({ level: 'warn' });
+    // These should be filtered out
+    t.notThrows(() => {
+        logger.trace('trace message');
+        logger.debug('debug message');
+        logger.info('info message');
+        logger.http('http message');
+    }, 'Filtered levels should not throw');
+    // These should be logged
+    t.notThrows(() => {
+        logger.warn('warn message');
+        logger.error('error message');
+        logger.fatal('fatal message');
+    }, 'Active levels should not throw');
+});
+test('logger handles structured data correctly', t => {
+    const logger = initializeLogger({ level: 'debug' });
+    const testData = {
+        userId: '123',
+        action: 'login',
+        metadata: { ip: '127.0.0.1', userAgent: 'test-agent' },
+    };
+    t.notThrows(() => {
+        logger.info('User action', testData);
+        logger.warn('Warning with data', { type: 'validation', details: testData });
+        logger.error('Error with context', {
+            error: new Error('test'),
+            context: testData,
+        });
+    }, 'Structured data should be handled correctly');
+});
+test('logger handles edge cases gracefully', t => {
+    const logger = initializeLogger({ level: 'debug' });
+    // Empty message
+    t.notThrows(() => {
+        logger.info('');
+        logger.info(null);
+        logger.info(undefined);
+    }, 'Edge cases should not throw');
+    // Large objects
+    const largeObject = { data: 'x'.repeat(10000) };
+    t.notThrows(() => {
+        logger.info('Large object', largeObject);
+    }, 'Large objects should be handled');
+    // Circular references
+    const circular = { a: 1 };
+    circular.self = circular;
+    t.notThrows(() => {
+        logger.info('Circular reference', circular);
+    }, 'Circular references should be handled');
+});
+test('logger maintains correlation context', t => {
+    const logger = initializeLogger({
+        level: 'debug',
+        correlation: true,
+    });
+    t.notThrows(() => {
+        logger.info('Message with correlation');
+        logger.child({ requestId: 'req-123' }).info('Child message');
+    }, 'Correlation context should be maintained');
+});
+test('logger respects redaction rules', t => {
+    const logger = initializeLogger({
+        level: 'debug',
+        redact: ['apiKey', 'token', 'password', 'secret'],
+    });
+    const sensitiveData = {
+        username: 'user123',
+        apiKey: 'sk-1234567890',
+        password: 'secret123',
+        token: 'abc123xyz',
+        safeField: 'public-data',
+    };
+    t.notThrows(() => {
+        logger.info('Login attempt', sensitiveData);
+    }, 'Redaction should not throw errors');
+    // The actual redaction would be verified by checking log output,
+    // but that requires more complex test setup with output capture
+});
+test('multiple logger instances do not interfere', t => {
+    const logger1 = initializeLogger({
+        level: 'debug',
+        pretty: true,
+    });
+    // This should return the existing instance
+    const logger2 = getLogger();
+    t.is(logger1, logger2, 'Should return same instance');
+    t.notThrows(() => {
+        logger1.info('Message from logger1');
+        logger2.debug('Message from logger2');
+    }, 'Multiple references should work');
+});
+//# sourceMappingURL=index.spec.js.map

package/dist/utils/logging/index.spec.js.map

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

package/dist/utils/logging/integration.spec.d.ts

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

package/dist/utils/logging/integration.spec.d.ts.map

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