@xopcai/xopcbot 0.1.0

package/dist/utils/logger.js

@@ -0,0 +1,481 @@
+/**
+ * Logger Module - Optimized Version
+ *
+ * Centralized logging system using pino with enhanced features:
+ * - Contextual logging with requestId/sessionId tracking
+ * - Log rotation with automatic cleanup
+ * - Sampling for high-frequency debug logs
+ * - Async logging with proper flush on shutdown
+ * - Unified configuration via XOPCBOT_* environment variables
+ *
+ * Log Levels (in order of severity):
+ * - trace:   Most detailed, for development debugging only
+ * - debug:   Detailed info for troubleshooting (supports sampling)
+ * - info:    General operational events (startup, shutdown, major state changes)
+ * - warn:    Unexpected but non-fatal issues
+ * - error:   Errors that affect functionality
+ * - fatal:   Critical errors that prevent operation
+ */
+import pino from 'pino';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync, mkdirSync, createWriteStream, unlinkSync, readdirSync, statSync, readFileSync } from 'fs';
+import { gzip } from 'zlib';
+import { promisify } from 'util';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const compressAsync = promisify(gzip);
+// ============================================
+// Configuration
+// ============================================
+const DEFAULT_CONFIG = {
+    level: 'info',
+    logDir: path.join(process.env.HOME || '.', '.xopcbot', 'logs'),
+    consoleOutput: true,
+    fileOutput: true,
+    errorFileOutput: true,
+    retentionDays: 7,
+    maxFileSizeMB: 100,
+    prettyPrint: false,
+    async: true,
+    debugSampleRate: 1.0,
+};
+function loadConfig() {
+    const config = { ...DEFAULT_CONFIG };
+    // Log level - unified environment variable
+    const logLevel = process.env.XOPCBOT_LOG_LEVEL || process.env.LOG_LEVEL;
+    if (logLevel) {
+        config.level = logLevel.toLowerCase();
+    }
+    else if (process.env.DEBUG) {
+        config.level = 'debug';
+    }
+    // Log directory
+    if (process.env.XOPCBOT_LOG_DIR) {
+        config.logDir = process.env.XOPCBOT_LOG_DIR;
+    }
+    // Output options
+    if (process.env.XOPCBOT_LOG_CONSOLE === 'false') {
+        config.consoleOutput = false;
+    }
+    if (process.env.XOPCBOT_LOG_FILE === 'false') {
+        config.fileOutput = false;
+    }
+    // Retention
+    if (process.env.XOPCBOT_LOG_RETENTION_DAYS) {
+        config.retentionDays = parseInt(process.env.XOPCBOT_LOG_RETENTION_DAYS, 10);
+    }
+    // Pretty print for development
+    if (process.env.NODE_ENV === 'development' || process.env.XOPCBOT_PRETTY_LOGS === 'true') {
+        config.prettyPrint = true;
+    }
+    return config;
+}
+const config = loadConfig();
+// Ensure log directory exists
+if (!existsSync(config.logDir)) {
+    mkdirSync(config.logDir, { recursive: true });
+}
+// ============================================
+// Log File Management
+// ============================================
+function getLogPath(type = 'app', date = new Date()) {
+    const dateStr = date.toISOString().split('T')[0];
+    return path.join(config.logDir, `${type}-${dateStr}.log`);
+}
+function getCompressedLogPath(originalPath) {
+    return `${originalPath}.gz`;
+}
+function createLogStream(filePath) {
+    return createWriteStream(filePath, { flags: 'a', encoding: 'utf-8' });
+}
+// Create streams
+const streams = [];
+if (config.consoleOutput) {
+    streams.push({
+        stream: process.stdout,
+        level: config.level,
+    });
+}
+if (config.fileOutput) {
+    streams.push({
+        stream: createLogStream(getLogPath('app')),
+        level: config.level,
+    });
+}
+if (config.errorFileOutput) {
+    streams.push({
+        stream: createLogStream(getLogPath('error')),
+        level: 'error',
+    });
+}
+// ============================================
+// Custom Log Levels with Sampling
+// ============================================
+const customLevels = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+// ============================================
+// Base Logger Creation
+// ============================================
+const pinoOptions = {
+    level: config.level,
+    base: {
+        service: 'xopcbot',
+        version: process.env.npm_package_version || '0.1.0',
+    },
+    timestamp: pino.stdTimeFunctions.isoTime,
+    formatters: {
+        level: (label) => ({ level: label }),
+        bindings: (bindings) => ({
+            pid: bindings.pid,
+            host: bindings.host,
+        }),
+    },
+    customLevels,
+};
+// Add pretty print for development
+if (config.prettyPrint) {
+    pinoOptions.transport = {
+        target: 'pino-pretty',
+        options: {
+            colorize: true,
+            translateTime: 'SYS:standard',
+            ignore: 'pid,host',
+        },
+    };
+}
+const baseLogger = pino(pinoOptions, pino.multistream(streams));
+// ============================================
+// Context Tracking
+// ============================================
+const contextStore = new Map();
+function mergeContext(base, additional) {
+    return { ...base, ...additional };
+}
+function createProxyLogger(logger, defaultContext = {}) {
+    const contextRef = { current: defaultContext };
+    const proxy = new Proxy(logger, {
+        get(target, prop) {
+            const propKey = prop;
+            if (prop === 'withContext') {
+                return (context) => {
+                    contextRef.current = mergeContext(contextRef.current, context);
+                    return proxy;
+                };
+            }
+            if (prop === 'childContext') {
+                return (context) => {
+                    const merged = mergeContext(contextRef.current, context);
+                    const child = target.child({ ...merged });
+                    return createProxyLogger(child, merged);
+                };
+            }
+            return target[propKey];
+        },
+    });
+    // Wrap logging methods to inject context
+    const wrappedLogger = proxy;
+    return wrappedLogger;
+}
+// ============================================
+// Public API
+// ============================================
+export const logger = createProxyLogger(baseLogger);
+export { pino as Pino };
+/**
+ * Create a child logger with a specific prefix/context
+ */
+export function createLogger(prefix, context) {
+    const child = baseLogger.child({ prefix });
+    return createProxyLogger(child, { module: prefix, ...context });
+}
+/**
+ * Create a logger for a specific module/component
+ */
+export function createModuleLogger(moduleName, modulePath) {
+    const base = modulePath
+        ? path.relative(path.join(__dirname, '..'), modulePath).replace(/\.ts$/, '')
+        : moduleName;
+    const child = baseLogger.child({ module: base });
+    return createProxyLogger(child, { module: base });
+}
+/**
+ * Create a logger for plugins with consistent interface
+ */
+export function createPluginLogger(pluginName) {
+    const child = baseLogger.child({ plugin: pluginName });
+    return createProxyLogger(child, { plugin: pluginName });
+}
+/**
+ * Create a logger for cron services
+ */
+export function createServiceLogger(serviceId) {
+    const child = baseLogger.child({ service: 'cron', scope: serviceId });
+    return createProxyLogger(child, { service: 'cron', scope: serviceId });
+}
+/**
+ * Create a request-scoped logger with tracking ID
+ */
+export function createRequestLogger(requestId, initialContext) {
+    const context = { requestId, ...initialContext };
+    contextStore.set(requestId, context);
+    const child = baseLogger.child({ requestId });
+    const proxy = createProxyLogger(child, context);
+    return proxy;
+}
+/**
+ * Remove request context when done
+ */
+export function clearRequestContext(requestId) {
+    contextStore.delete(requestId);
+}
+/**
+ * Get context for a request ID
+ */
+export function getRequestContext(requestId) {
+    return contextStore.get(requestId);
+}
+export function setLogLevel(level) {
+    baseLogger.level = level;
+}
+export function getLogLevel() {
+    return baseLogger.level;
+}
+/**
+ * Temporarily change log level for a block of code
+ */
+export function withLogLevel(level, fn) {
+    const previous = baseLogger.level;
+    baseLogger.level = level;
+    try {
+        return fn();
+    }
+    finally {
+        baseLogger.level = previous;
+    }
+}
+// ============================================
+// Log Rotation
+// ============================================
+/**
+ * Rotate logs if they exceed max size
+ */
+export async function rotateLogs() {
+    const result = {
+        rotated: 0,
+        deleted: 0,
+        compressed: 0,
+        errors: [],
+    };
+    try {
+        const files = readdirSync(config.logDir);
+        const maxSizeBytes = config.maxFileSizeMB * 1024 * 1024;
+        for (const file of files) {
+            if (!file.endsWith('.log') || file.endsWith('.gz'))
+                continue;
+            const filePath = path.join(config.logDir, file);
+            const stats = statSync(filePath);
+            if (stats.size >= maxSizeBytes) {
+                // Rotate: compress and create new file
+                const compressedPath = getCompressedLogPath(filePath);
+                try {
+                    const content = readFileSync(filePath);
+                    const compressed = await compressAsync(content);
+                    // Write compressed file
+                    const { writeFile } = await import('fs/promises');
+                    await writeFile(compressedPath, compressed);
+                    unlinkSync(filePath);
+                    result.compressed++;
+                    result.rotated++;
+                }
+                catch (err) {
+                    result.errors.push(`Failed to compress ${file}: ${err}`);
+                }
+            }
+        }
+    }
+    catch (err) {
+        result.errors.push(`Rotation failed: ${err}`);
+    }
+    return result;
+}
+/**
+ * Clean old logs based on retention policy
+ */
+export function cleanOldLogs(keepDays = config.retentionDays) {
+    const result = {
+        rotated: 0,
+        deleted: 0,
+        compressed: 0,
+        errors: [],
+    };
+    try {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - keepDays);
+        const files = readdirSync(config.logDir);
+        for (const file of files) {
+            if (!file.endsWith('.log') && !file.endsWith('.log.gz'))
+                continue;
+            const filePath = path.join(config.logDir, file);
+            const stats = statSync(filePath);
+            if (new Date(stats.mtime) < cutoff) {
+                try {
+                    unlinkSync(filePath);
+                    result.deleted++;
+                }
+                catch (err) {
+                    result.errors.push(`Failed to delete ${file}: ${err}`);
+                }
+            }
+        }
+    }
+    catch (err) {
+        result.errors.push(`Cleanup failed: ${err}`);
+    }
+    return result;
+}
+/**
+ * Get current log directory
+ */
+export function getLogDir() {
+    return config.logDir;
+}
+/**
+ * Get logger configuration
+ */
+export function getLoggerConfig() {
+    return { ...config };
+}
+// ============================================
+// Graceful Shutdown
+// ============================================
+let shutdownHandler = null;
+/**
+ * Register shutdown handler to flush logs
+ */
+export function registerShutdownHandler() {
+    if (shutdownHandler)
+        return;
+    shutdownHandler = async () => {
+        try {
+            // Flush any pending logs
+            await new Promise((resolve) => {
+                baseLogger.flush();
+                setTimeout(resolve, 100);
+            });
+        }
+        catch {
+            // Ignore flush errors on shutdown
+        }
+    };
+    process.on('SIGINT', shutdownHandler);
+    process.on('SIGTERM', shutdownHandler);
+    process.on('exit', () => {
+        if (shutdownHandler) {
+            shutdownHandler();
+        }
+    });
+}
+// Auto-register shutdown handler
+registerShutdownHandler();
+// ============================================
+// Utilities
+// ============================================
+/**
+ * Check if a log level is enabled
+ */
+export function isLevelEnabled(level) {
+    const levelValue = {
+        trace: 10,
+        debug: 20,
+        info: 30,
+        warn: 40,
+        error: 50,
+        fatal: 60,
+        silent: Number.MAX_VALUE,
+    }[level];
+    const currentLevelValue = {
+        trace: 10,
+        debug: 20,
+        info: 30,
+        warn: 40,
+        error: 50,
+        fatal: 60,
+        silent: Number.MAX_VALUE,
+    }[getLogLevel()];
+    return levelValue >= currentLevelValue;
+}
+/**
+ * Log with sampling (for high-frequency debug logs)
+ */
+export function logWithSample(logger, level, sampleRate, message, data) {
+    if (Math.random() > sampleRate)
+        return;
+    switch (level) {
+        case 'trace':
+            logger.trace(data, message);
+            break;
+        case 'debug':
+            logger.debug(data, message);
+            break;
+        case 'info':
+            logger.info(data, message);
+            break;
+        case 'warn':
+            logger.warn(data, message);
+            break;
+        case 'error':
+            logger.error(data, message);
+            break;
+        case 'fatal':
+            logger.fatal(data, message);
+            break;
+    }
+}
+/**
+ * Logging Best Practices:
+ *
+ * 1. TRACE (development only):
+ *    - Function entry/exit with parameters
+ *    - Variable values during execution
+ *    - Loop iterations and detailed state
+ *
+ * 2. DEBUG:
+ *    - Detailed troubleshooting information
+ *    - Request/response payloads (sanitized)
+ *    - State transitions and decisions
+ *    - Use sampling for high-frequency logs
+ *
+ * 3. INFO (default level):
+ *    - Service startup/shutdown
+ *    - Major state transitions
+ *    - Important business events
+ *    - Configuration changes
+ *    - User actions (login, logout, etc.)
+ *
+ * 4. WARN:
+ *    - Deprecated feature usage
+ *    - Recoverable errors with fallback
+ *    - Performance degradation
+ *    - Missing optional configuration
+ *    - Rate limit approaching
+ *
+ * 5. ERROR:
+ *    - Failed operations with impact
+ *    - Unhandled exceptions
+ *    - Data validation failures
+ *    - External service failures
+ *    - Always include error context
+ *
+ * 6. FATAL:
+ *    - System cannot continue operating
+ *    - Critical initialization failure
+ *    - Data corruption detected
+ *    - Requires immediate attention
+ */
+//# 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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"}

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

@@ -0,0 +1,152 @@
+/**
+ * Logger Types
+ *
+ * Centralized type definitions for the logging system.
+ */
+import type { Logger } from 'pino';
+/**
+ * Basic log entry structure
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    message: string;
+    module?: string;
+    prefix?: string;
+    service?: string;
+    plugin?: string;
+    requestId?: string;
+    sessionId?: string;
+    userId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Log levels in order of severity
+ */
+export declare const LogLevel: {
+    readonly TRACE: "trace";
+    readonly DEBUG: "debug";
+    readonly INFO: "info";
+    readonly WARN: "warn";
+    readonly ERROR: "error";
+    readonly FATAL: "fatal";
+    readonly SILENT: "silent";
+};
+export type LogLevel = typeof LogLevel[keyof typeof LogLevel];
+/**
+ * Log level numeric values (for comparison)
+ */
+export declare const LogLevelValue: Record<LogLevel, number>;
+/**
+ * Common log context fields
+ */
+export interface LogContext {
+    /** Request/operation ID for tracing */
+    requestId?: string;
+    /** Session ID for user tracking */
+    sessionId?: string;
+    /** User ID */
+    userId?: string;
+    /** Module/component name */
+    module?: string;
+    /** Plugin name */
+    plugin?: string;
+    /** Service name */
+    service?: string;
+    /** Additional context */
+    [key: string]: unknown;
+}
+/**
+ * Extended logger with context support
+ */
+export interface ContextualLogger extends Logger {
+    /**
+     * Set default context for all subsequent logs
+     */
+    withContext(context: LogContext): ContextualLogger;
+    /**
+     * Create a child logger with additional context
+     */
+    childContext(context: LogContext): ContextualLogger;
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Minimum log level */
+    level: LogLevel;
+    /** Log directory */
+    logDir: string;
+    /** Enable console output */
+    consoleOutput: boolean;
+    /** Enable file output */
+    fileOutput: boolean;
+    /** Enable error-only file output */
+    errorFileOutput: boolean;
+    /** Log rotation: max days to keep */
+    retentionDays: number;
+    /** Log rotation: max file size in MB */
+    maxFileSizeMB: number;
+    /** Enable pretty print for console (dev only) */
+    prettyPrint: boolean;
+    /** Enable async logging */
+    async: boolean;
+    /** Sample rate for debug logs (0-1, 1 = all) */
+    debugSampleRate?: number;
+}
+/**
+ * Log file metadata
+ */
+export interface LogFileMeta {
+    name: string;
+    path: string;
+    size: number;
+    created: string;
+    modified: string;
+    type: 'app' | 'error' | 'audit' | 'access';
+    lines?: number;
+}
+/**
+ * Log query options
+ */
+export interface LogQuery {
+    /** Filter by log levels */
+    levels?: LogLevel[];
+    /** Start timestamp (ISO 8601) */
+    from?: string;
+    /** End timestamp (ISO 8601) */
+    to?: string;
+    /** Keyword search */
+    q?: string;
+    /** Filter by module */
+    module?: string;
+    /** Filter by plugin */
+    plugin?: string;
+    /** Filter by service */
+    service?: string;
+    /** Filter by request ID */
+    requestId?: string;
+    /** Filter by session ID */
+    sessionId?: string;
+    /** Pagination offset */
+    offset?: number;
+    /** Pagination limit */
+    limit?: number;
+    /** Sort order: 'asc' | 'desc' */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Log statistics
+ */
+export interface LogStats {
+    byLevel: Record<LogLevel, number>;
+}
+/**
+ * Log rotation result
+ */
+export interface RotationResult {
+    rotated: number;
+    deleted: number;
+    compressed: number;
+    errors: string[];
+}

package/dist/utils/logger.types.js

@@ -0,0 +1,30 @@
+/**
+ * Logger Types
+ *
+ * Centralized type definitions for the logging system.
+ */
+/**
+ * Log levels in order of severity
+ */
+export const LogLevel = {
+    TRACE: 'trace',
+    DEBUG: 'debug',
+    INFO: 'info',
+    WARN: 'warn',
+    ERROR: 'error',
+    FATAL: 'fatal',
+    SILENT: 'silent',
+};
+/**
+ * Log level numeric values (for comparison)
+ */
+export const LogLevelValue = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+    silent: Number.MAX_VALUE,
+};
+//# sourceMappingURL=logger.types.js.map

package/dist/utils/logger.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.types.js","sourceRoot":"","sources":["../../src/utils/logger.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAA6B;IACrD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,MAAM,CAAC,SAAS;CACzB,CAAC"}