@rapidd/core 2.1.2 → 2.1.4

package/src/utils/Logger.ts

@@ -0,0 +1,237 @@
+import { appendFileSync, mkdirSync, existsSync } from 'fs';
+import path from 'path';
+
+// ── Types ────────────────────────────────────────────────────────────────────
+
+export type LogLevel = 'essential' | 'fine' | 'finest';
+
+// ── Level Config ─────────────────────────────────────────────────────────────
+
+const LEVELS: LogLevel[] = ['essential', 'fine', 'finest'];
+
+function parseLevel(value: string | undefined): LogLevel {
+    if (value && LEVELS.includes(value as LogLevel)) {
+        return value as LogLevel;
+    }
+    return 'essential';
+}
+
+// ── State ────────────────────────────────────────────────────────────────────
+
+const _level: LogLevel = parseLevel(process.env.LOG_LEVEL);
+const _silent: boolean = process.env.NODE_ENV === 'test';
+const _logDir: string = process.env.LOG_DIR ?? 'logs';
+
+// ── File Writing ─────────────────────────────────────────────────────────────
+
+let _dirChecked = false;
+
+function ensureLogDir(): void {
+    if (_dirChecked || !_logDir) return;
+    const dir = path.isAbsolute(_logDir) ? _logDir : path.join(process.cwd(), _logDir);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    _dirChecked = true;
+}
+
+function writeToFile(filename: string, line: string): void {
+    if (!_logDir) return;
+    try {
+        ensureLogDir();
+        const dir = path.isAbsolute(_logDir) ? _logDir : path.join(process.cwd(), _logDir);
+        appendFileSync(path.join(dir, filename), line + '\n');
+    } catch {
+        // Silently ignore file write failures — don't crash the app for logging
+    }
+}
+
+// ── Formatting ───────────────────────────────────────────────────────────────
+
+function timestamp(): string {
+    return new Date().toISOString();
+}
+
+function formatData(data: unknown[]): string {
+    if (data.length === 0) return '';
+    const parts = data.map(d => {
+        if (d === null || d === undefined) return String(d);
+        if (typeof d === 'object') {
+            try { return JSON.stringify(d); } catch { return String(d); }
+        }
+        return String(d);
+    });
+    return ' ' + parts.join(' ');
+}
+
+function formatDataPretty(data: unknown[]): string {
+    if (data.length === 0) return '';
+    const parts = data.map(d => {
+        if (d === null || d === undefined) return String(d);
+        if (typeof d === 'object') {
+            try { return JSON.stringify(d, null, 2); } catch { return String(d); }
+        }
+        return String(d);
+    });
+    return '\n' + parts.join('\n');
+}
+
+function formatHeaders(headers: Record<string, unknown>): string {
+    return Object.entries(headers)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => `  ${k}: ${Array.isArray(v) ? v.join(', ') : v}`)
+        .join('\n');
+}
+
+function formatBody(body: unknown): string {
+    if (body === null || body === undefined) return '  (empty)';
+    if (typeof body === 'string') {
+        try {
+            return '  ' + JSON.stringify(JSON.parse(body), null, 2).replace(/\n/g, '\n  ');
+        } catch {
+            return '  ' + body;
+        }
+    }
+    if (typeof body === 'object') {
+        try {
+            return '  ' + JSON.stringify(body, null, 2).replace(/\n/g, '\n  ');
+        } catch {
+            return '  ' + String(body);
+        }
+    }
+    return '  ' + String(body);
+}
+
+function formatError(error: Error | string | unknown): { message: string; toString: string; stack: string } {
+    if (error instanceof Error) {
+        return {
+            message: error.message,
+            toString: error.toString(),
+            stack: error.stack || error.toString(),
+        };
+    }
+    const str = String(error);
+    return { message: str, toString: str, stack: str };
+}
+
+// ── Logger ───────────────────────────────────────────────────────────────────
+
+export const Logger = {
+    log(message: string, ...data: unknown[]): void {
+        if (_silent) return;
+
+        let output: string;
+        switch (_level) {
+            case 'essential':
+                output = `[${timestamp()}] [LOG] ${message}`;
+                break;
+            case 'fine':
+                output = `[${timestamp()}] [LOG] ${message}${formatData(data)}`;
+                break;
+            case 'finest':
+                output = `[${timestamp()}] [LOG] ${message}${formatDataPretty(data)}`;
+                break;
+        }
+
+        console.log(output);
+        writeToFile('app.log', output);
+    },
+
+    warn(message: string, ...data: unknown[]): void {
+        if (_silent) return;
+
+        let output: string;
+        switch (_level) {
+            case 'essential':
+                output = `[${timestamp()}] [WARN] ${message}`;
+                break;
+            case 'fine':
+                output = `[${timestamp()}] [WARN] ${message}${formatData(data)}`;
+                break;
+            case 'finest':
+                output = `[${timestamp()}] [WARN] ${message}${formatDataPretty(data)}`;
+                break;
+        }
+
+        console.warn(output);
+        writeToFile('app.log', output);
+    },
+
+    error(error: Error | string | unknown, ...data: unknown[]): void {
+        if (_silent) return;
+
+        const err = formatError(error);
+        let output: string;
+
+        switch (_level) {
+            case 'essential':
+                output = `[${timestamp()}] [ERROR] ${err.message}`;
+                break;
+            case 'fine':
+                output = `[${timestamp()}] [ERROR] ${err.toString}${formatData(data)}`;
+                break;
+            case 'finest':
+                output = `[${timestamp()}] [ERROR] ${err.stack}${formatDataPretty(data)}`;
+                break;
+        }
+
+        console.error(output);
+        writeToFile('error.log', output);
+    },
+
+    request(info: {
+        method: string;
+        url: string;
+        status: number;
+        time: number;
+        ip?: string;
+        contentLength?: string;
+        userId?: string | number;
+        userAgent?: string;
+        requestHeaders?: Record<string, unknown>;
+        requestBody?: unknown;
+        responseHeaders?: Record<string, unknown>;
+        responseBody?: unknown;
+    }): void {
+        if (_silent) return;
+
+        const { method, url, status, time } = info;
+        const timeStr = `${time.toFixed(0)}ms`;
+        let output: string;
+
+        switch (_level) {
+            case 'essential':
+                output = `[${timestamp()}] ${method} ${url} ${status} ${timeStr}`;
+                break;
+            case 'fine':
+                output = `[${timestamp()}] ${method} ${url} ${status} ${timeStr} | ${info.ip || '-'}${info.userId ? ` | user:${info.userId}` : ''}`;
+                break;
+            case 'finest': {
+                const lines = [`[${timestamp()}] ${method} ${url} ${status} ${timeStr} | ${info.ip || '-'}${info.userId ? ` | user:${info.userId}` : ''}`];
+                if (info.requestHeaders) {
+                    lines.push('  ── Request Headers');
+                    lines.push(formatHeaders(info.requestHeaders));
+                }
+                if (info.requestBody !== undefined && info.requestBody !== null) {
+                    lines.push('  ── Request Body');
+                    lines.push(formatBody(info.requestBody));
+                }
+                if (info.responseHeaders) {
+                    lines.push('  ── Response Headers');
+                    lines.push(formatHeaders(info.responseHeaders));
+                }
+                if (info.responseBody !== undefined && info.responseBody !== null) {
+                    lines.push('  ── Response Body');
+                    lines.push(formatBody(info.responseBody));
+                }
+                output = lines.join('\n');
+                break;
+            }
+        }
+
+        console.log(output);
+        writeToFile('access.log', output);
+    },
+};
+
+export default Logger;

package/src/utils/index.ts

@@ -4,6 +4,9 @@ export type { ServiceConfig, EndpointConfig, AuthConfig, RequestOptions, ApiResp
 export { Mailer } from './Mailer';
 export type { EmailConfig, EmailOptions, EmailAttachment, EmailResult } from './Mailer';
 
+export { Logger } from './Logger';
+export type { LogLevel } from './Logger';
+
 export const env = {
     isProduction: () => process.env.NODE_ENV === 'production',
     isDevelopment: () => __filename.endsWith('.ts') || process.env.NODE_ENV === 'development',