@xopcai/xopcbot 0.1.0

package/dist/utils/log-store.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Log Store - Enhanced File-based Log Storage
+ *
+ * Features:
+ * - Query logs across multiple files with filtering
+ * - Support for compressed (.gz) log files
+ * - Pagination and sorting
+ * - Statistics and analytics
+ * - Safe log cleanup with actual deletion
+ */
+import type { LogLevel, LogFileMeta, LogQuery, LogStats, LogEntry } from './logger.types.js';
+declare const LOG_DIR: string;
+/**
+ * Get all log files (including compressed)
+ */
+export declare function getLogFiles(): LogFileMeta[];
+/**
+ * Get log file path for a specific date and type
+ */
+export declare function getLogPath(date?: Date, type?: 'app' | 'error' | 'audit' | 'access'): string;
+/**
+ * Get available log files for a date range
+ */
+export declare function getLogFilesForRange(from: Date, to: Date): LogFileMeta[];
+/**
+ * Query logs across multiple files
+ */
+export declare function queryLogs(query?: LogQuery): Promise<LogEntry[]>;
+/**
+ * Get recent logs (convenience method)
+ */
+export declare function getRecentLogs(options?: {
+    level?: LogLevel;
+    limit?: number;
+    module?: string;
+}): Promise<LogEntry[]>;
+/**
+ * Search logs by keyword
+ */
+export declare function searchLogs(keyword: string, options?: {
+    from?: string;
+    to?: string;
+    limit?: number;
+}): Promise<LogEntry[]>;
+/**
+ * Get logs for a specific request/session
+ */
+export declare function getLogsByContext(contextType: 'requestId' | 'sessionId', contextValue: string, limit?: number): Promise<LogEntry[]>;
+/**
+ * Get available log levels from actual log data
+ */
+export declare function getLogLevels(): Promise<LogLevel[]>;
+/**
+ * Get available modules from log data
+ */
+export declare function getLogModules(): Promise<string[]>;
+/**
+ * Get log statistics by level (sampled from recent files)
+ */
+export declare function getLogStats(): Promise<LogStats>;
+/**
+ * Clean old logs (actually deletes files)
+ */
+export declare function cleanOldLogs(keepDays?: number): {
+    deleted: number;
+    freedBytes: number;
+    errors: string[];
+};
+/**
+ * Clean logs by size (keep total under limit)
+ */
+export declare function cleanBySize(maxTotalMB?: number): {
+    deleted: number;
+    freedBytes: number;
+    errors: string[];
+};
+export { LOG_DIR };
+export type { LogEntry, LogQuery, LogFileMeta, LogStats } from './logger.types.js';

package/dist/utils/log-store.js

@@ -0,0 +1,432 @@
+/**
+ * Log Store - Enhanced File-based Log Storage
+ *
+ * Features:
+ * - Query logs across multiple files with filtering
+ * - Support for compressed (.gz) log files
+ * - Pagination and sorting
+ * - Statistics and analytics
+ * - Safe log cleanup with actual deletion
+ */
+import { existsSync, mkdirSync, readdirSync, statSync, createReadStream, unlinkSync, } from 'fs';
+import { readFile } from 'fs/promises';
+import { join, basename } from 'path';
+import { createInterface } from 'readline';
+import { gunzip } from 'zlib';
+import { promisify } from 'util';
+import { Readable } from 'stream';
+const gunzipAsync = promisify(gunzip);
+// ============================================
+// Configuration
+// ============================================
+const LOG_DIR = process.env.XOPCBOT_LOG_DIR || join(process.env.HOME || '.', '.xopcbot', 'logs');
+function ensureLogDir() {
+    if (!existsSync(LOG_DIR)) {
+        mkdirSync(LOG_DIR, { recursive: true });
+    }
+}
+// ============================================
+// File Management
+// ============================================
+/**
+ * Get all log files (including compressed)
+ */
+export function getLogFiles() {
+    ensureLogDir();
+    const files = readdirSync(LOG_DIR)
+        .filter(f => f.endsWith('.log') || f.endsWith('.log.gz'))
+        .map(f => {
+        const filePath = join(LOG_DIR, f);
+        const stats = statSync(filePath);
+        let type = 'app';
+        if (f.includes('error'))
+            type = 'error';
+        else if (f.includes('audit'))
+            type = 'audit';
+        else if (f.includes('access'))
+            type = 'access';
+        return {
+            name: f,
+            path: filePath,
+            size: stats.size,
+            created: stats.birthtime.toISOString(),
+            modified: stats.mtime.toISOString(),
+            type,
+        };
+    })
+        .sort((a, b) => new Date(b.modified).getTime() - new Date(a.modified).getTime());
+    return files;
+}
+/**
+ * Get log file path for a specific date and type
+ */
+export function getLogPath(date = new Date(), type = 'app') {
+    ensureLogDir();
+    const dateStr = date.toISOString().split('T')[0];
+    return join(LOG_DIR, `${type}-${dateStr}.log`);
+}
+/**
+ * Get available log files for a date range
+ */
+export function getLogFilesForRange(from, to) {
+    const allFiles = getLogFiles();
+    return allFiles.filter(f => {
+        // Extract date from filename (e.g., app-2024-01-01.log)
+        const match = f.name.match(/(\d{4}-\d{2}-\d{2})/);
+        if (!match)
+            return false;
+        const fileDate = new Date(match[1]);
+        return fileDate >= from && fileDate <= to;
+    });
+}
+// ============================================
+// Log Parsing
+// ============================================
+/**
+ * Parse a single log line (JSON format from pino)
+ */
+function parseLogLine(line, source, lineNumber) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    try {
+        // Try JSON format (pino default)
+        const parsed = JSON.parse(trimmed);
+        // Convert pino numeric level to string (10=trace, 20=debug, 30=info, 40=warn, 50=error, 60=fatal)
+        const levelNum = typeof parsed.level === 'number' ? parsed.level : 30;
+        const levelMap = {
+            10: 'trace',
+            20: 'debug',
+            30: 'info',
+            40: 'warn',
+            50: 'error',
+            60: 'fatal',
+        };
+        return {
+            timestamp: parsed.time || parsed.timestamp || '',
+            level: levelMap[levelNum] || (parsed.level?.toString() || 'info').toLowerCase(),
+            message: parsed.msg || parsed.message || '',
+            module: parsed.module,
+            prefix: parsed.prefix,
+            service: parsed.service,
+            plugin: parsed.plugin,
+            requestId: parsed.requestId,
+            sessionId: parsed.sessionId,
+            _source: source,
+            _lineNumber: lineNumber,
+            ...parsed,
+        };
+    }
+    catch {
+        // Fallback: try to parse pino's text format
+        const match = trimmed.match(/^\[([^\]]+)\]\s+(\w+):\s+(.+)$/);
+        if (match) {
+            return {
+                timestamp: match[1],
+                level: match[2].toLowerCase(),
+                message: match[3],
+                _source: source,
+                _lineNumber: lineNumber,
+            };
+        }
+        // Plain text fallback
+        return {
+            timestamp: new Date().toISOString(),
+            level: 'info',
+            message: trimmed,
+            _source: source,
+            _lineNumber: lineNumber,
+        };
+    }
+}
+// ============================================
+// Streaming
+// ============================================
+/**
+ * Create a readable stream for a log file (handles .gz files)
+ */
+async function createLogFileStream(filePath) {
+    if (filePath.endsWith('.gz')) {
+        const compressed = await readFile(filePath);
+        const decompressed = await gunzipAsync(compressed);
+        return Readable.from(decompressed.toString('utf-8').split('\n'));
+    }
+    return createReadStream(filePath, { encoding: 'utf-8' });
+}
+/**
+ * Stream and filter log entries from a file
+ */
+async function* streamLogFile(filePath, query = {}) {
+    if (!existsSync(filePath))
+        return;
+    const fileName = basename(filePath);
+    let stream;
+    try {
+        stream = await createLogFileStream(filePath);
+    }
+    catch {
+        return;
+    }
+    const rl = createInterface({
+        input: stream,
+        crlfDelay: Infinity
+    });
+    let lineNumber = 0;
+    try {
+        for await (const line of rl) {
+            lineNumber++;
+            const entry = parseLogLine(line, fileName, lineNumber);
+            if (!entry)
+                continue;
+            // Apply filters
+            if (!matchesQuery(entry, query))
+                continue;
+            yield entry;
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Check if a log entry matches the query filters
+ */
+function matchesQuery(entry, query) {
+    // Filter by levels
+    if (query.levels?.length && !query.levels.includes(entry.level)) {
+        return false;
+    }
+    // Filter by time range
+    if (query.from) {
+        const fromDate = new Date(query.from);
+        const entryDate = new Date(entry.timestamp);
+        if (entryDate < fromDate)
+            return false;
+    }
+    if (query.to) {
+        const toDate = new Date(query.to);
+        const entryDate = new Date(entry.timestamp);
+        if (entryDate > toDate)
+            return false;
+    }
+    // Filter by keyword (search in message and context fields)
+    if (query.q) {
+        const keyword = query.q.toLowerCase();
+        const searchable = [
+            entry.message,
+            entry.module,
+            entry.prefix,
+            entry.service,
+            entry.plugin,
+            entry.requestId,
+            entry.sessionId,
+        ]
+            .filter(Boolean)
+            .map(String)
+            .join(' ')
+            .toLowerCase();
+        if (!searchable.includes(keyword))
+            return false;
+    }
+    // Filter by specific fields
+    if (query.module && entry.module !== query.module)
+        return false;
+    if (query.plugin && entry.plugin !== query.plugin)
+        return false;
+    if (query.service && entry.service !== query.service)
+        return false;
+    if (query.requestId && entry.requestId !== query.requestId)
+        return false;
+    if (query.sessionId && entry.sessionId !== query.sessionId)
+        return false;
+    return true;
+}
+// ============================================
+// Query API
+// ============================================
+/**
+ * Query logs across multiple files
+ */
+export async function queryLogs(query = {}) {
+    ensureLogDir();
+    const results = [];
+    const files = getLogFiles();
+    // Filter files by date range if specified
+    let relevantFiles = files;
+    if (query.from || query.to) {
+        const fromDate = query.from ? new Date(query.from) : new Date(0);
+        const toDate = query.to ? new Date(query.to) : new Date();
+        relevantFiles = getLogFilesForRange(fromDate, toDate);
+    }
+    // Query each file
+    for (const file of relevantFiles) {
+        for await (const entry of streamLogFile(file.path, query)) {
+            results.push(entry);
+            // Early exit if limit reached
+            const limit = query.limit || 100;
+            if (results.length >= limit) {
+                break;
+            }
+        }
+        if (query.limit && results.length >= query.limit) {
+            break;
+        }
+    }
+    // Sort by timestamp
+    const order = query.order || 'desc';
+    results.sort((a, b) => {
+        const diff = new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime();
+        return order === 'desc' ? diff : -diff;
+    });
+    // Apply offset/limit
+    const offset = query.offset || 0;
+    const limit = query.limit || 100;
+    return results.slice(offset, offset + limit).map(({ _source, _lineNumber, ...rest }) => rest);
+}
+/**
+ * Get recent logs (convenience method)
+ */
+export async function getRecentLogs(options) {
+    return queryLogs({
+        levels: options?.level ? [options.level] : undefined,
+        limit: options?.limit || 50,
+        module: options?.module,
+        order: 'desc',
+    });
+}
+/**
+ * Search logs by keyword
+ */
+export async function searchLogs(keyword, options) {
+    return queryLogs({
+        q: keyword,
+        ...options,
+        limit: options?.limit || 100,
+    });
+}
+/**
+ * Get logs for a specific request/session
+ */
+export async function getLogsByContext(contextType, contextValue, limit = 100) {
+    return queryLogs({
+        [contextType]: contextValue,
+        limit,
+        order: 'asc',
+    });
+}
+// ============================================
+// Statistics
+// ============================================
+/**
+ * Get available log levels from actual log data
+ */
+export async function getLogLevels() {
+    const levels = new Set();
+    const files = getLogFiles().slice(0, 3); // Check last 3 files
+    for (const file of files) {
+        for await (const entry of streamLogFile(file.path, { limit: 500 })) {
+            levels.add(entry.level);
+        }
+    }
+    return Array.from(levels).sort();
+}
+/**
+ * Get available modules from log data
+ */
+export async function getLogModules() {
+    const modules = new Set();
+    const files = getLogFiles().slice(0, 7);
+    for (const file of files) {
+        for await (const entry of streamLogFile(file.path, { limit: 1000 })) {
+            if (entry.module)
+                modules.add(entry.module);
+            if (entry.prefix)
+                modules.add(entry.prefix);
+        }
+    }
+    return Array.from(modules).filter(Boolean).sort();
+}
+/**
+ * Get log statistics by level (sampled from recent files)
+ */
+export async function getLogStats() {
+    const files = getLogFiles();
+    // Count by level (sample from recent files)
+    const byLevel = {
+        trace: 0,
+        debug: 0,
+        info: 0,
+        warn: 0,
+        error: 0,
+        fatal: 0,
+        silent: 0,
+    };
+    for (const file of files.slice(0, 7)) {
+        for await (const entry of streamLogFile(file.path, { limit: 1000 })) {
+            if (entry.level in byLevel) {
+                byLevel[entry.level]++;
+            }
+        }
+    }
+    return { byLevel };
+}
+// ============================================
+// Cleanup
+// ============================================
+/**
+ * Clean old logs (actually deletes files)
+ */
+export function cleanOldLogs(keepDays = 7) {
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - keepDays);
+    let deleted = 0;
+    let freedBytes = 0;
+    const errors = [];
+    const files = getLogFiles();
+    for (const file of files) {
+        const fileDate = new Date(file.modified);
+        if (fileDate < cutoff) {
+            try {
+                const size = file.size;
+                unlinkSync(file.path);
+                deleted++;
+                freedBytes += size;
+            }
+            catch (err) {
+                errors.push(`Failed to delete ${file.name}: ${err}`);
+            }
+        }
+    }
+    return { deleted, freedBytes, errors };
+}
+/**
+ * Clean logs by size (keep total under limit)
+ */
+export function cleanBySize(maxTotalMB = 500) {
+    const maxBytes = maxTotalMB * 1024 * 1024;
+    const files = getLogFiles();
+    let totalSize = files.reduce((sum, f) => sum + f.size, 0);
+    let deleted = 0;
+    let freedBytes = 0;
+    const errors = [];
+    // Delete oldest files until under limit
+    for (const file of files.slice().reverse()) {
+        if (totalSize <= maxBytes)
+            break;
+        try {
+            unlinkSync(file.path);
+            freedBytes += file.size;
+            totalSize -= file.size;
+            deleted++;
+        }
+        catch (err) {
+            errors.push(`Failed to delete ${file.name}: ${err}`);
+        }
+    }
+    return { deleted, freedBytes, errors };
+}
+// ============================================
+// Exports
+// ============================================
+export { LOG_DIR };
+//# sourceMappingURL=log-store.js.map

package/dist/utils/log-store.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,127 @@
+/**
+ * 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 type { LogLevel, LogContext, ContextualLogger, LoggerConfig, RotationResult } from './logger.types.js';
+export declare const logger: ContextualLogger;
+export { pino as Pino };
+/**
+ * Create a child logger with a specific prefix/context
+ */
+export declare function createLogger(prefix: string, context?: LogContext): ContextualLogger;
+/**
+ * Create a logger for a specific module/component
+ */
+export declare function createModuleLogger(moduleName: string, modulePath?: string): ContextualLogger;
+/**
+ * Create a logger for plugins with consistent interface
+ */
+export declare function createPluginLogger(pluginName: string): ContextualLogger;
+/**
+ * Create a logger for cron services
+ */
+export declare function createServiceLogger(serviceId: string): ContextualLogger;
+/**
+ * Create a request-scoped logger with tracking ID
+ */
+export declare function createRequestLogger(requestId: string, initialContext?: LogContext): ContextualLogger;
+/**
+ * Remove request context when done
+ */
+export declare function clearRequestContext(requestId: string): void;
+/**
+ * Get context for a request ID
+ */
+export declare function getRequestContext(requestId: string): LogContext | undefined;
+export { LogLevel };
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+/**
+ * Temporarily change log level for a block of code
+ */
+export declare function withLogLevel<T>(level: LogLevel, fn: () => T): T;
+/**
+ * Rotate logs if they exceed max size
+ */
+export declare function rotateLogs(): Promise<RotationResult>;
+/**
+ * Clean old logs based on retention policy
+ */
+export declare function cleanOldLogs(keepDays?: number): RotationResult;
+/**
+ * Get current log directory
+ */
+export declare function getLogDir(): string;
+/**
+ * Get logger configuration
+ */
+export declare function getLoggerConfig(): Readonly<LoggerConfig>;
+/**
+ * Register shutdown handler to flush logs
+ */
+export declare function registerShutdownHandler(): void;
+/**
+ * Check if a log level is enabled
+ */
+export declare function isLevelEnabled(level: LogLevel): boolean;
+/**
+ * Log with sampling (for high-frequency debug logs)
+ */
+export declare function logWithSample(logger: ContextualLogger, level: LogLevel, sampleRate: number, message: string, data?: unknown): void;
+export type { ContextualLogger as Logger, LogContext } from './logger.types.js';
+/**
+ * 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
+ */