dotdo 0.0.1 → 0.1.0

package/dist/lib/logging/index.js

@@ -0,0 +1,160 @@
+/**
+ * Structured Logging Abstraction
+ *
+ * Provides a structured logging API that replaces console.log with:
+ * - Log levels (debug, info, warn, error)
+ * - Structured JSON output
+ * - Correlation ID support for request tracing
+ * - Child loggers for context inheritance
+ *
+ * @example
+ * ```typescript
+ * import { createLogger, LogLevel } from '@/lib/logging'
+ *
+ * const logger = createLogger({
+ *   name: 'my-service',
+ *   level: LogLevel.INFO,
+ *   context: { service: 'api', version: '1.0.0' }
+ * })
+ *
+ * logger.info('Request received', { requestId: 'req-123' })
+ * // Output: {"timestamp":"2024-01-10T12:00:00.000Z","level":"info","name":"my-service","message":"Request received","service":"api","version":"1.0.0","requestId":"req-123"}
+ * ```
+ */
+/**
+ * Log levels for controlling output verbosity.
+ * Lower numbers are more verbose.
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Level string names for output
+ */
+const levelNames = {
+    [LogLevel.DEBUG]: 'debug',
+    [LogLevel.INFO]: 'info',
+    [LogLevel.WARN]: 'warn',
+    [LogLevel.ERROR]: 'error',
+};
+/**
+ * Safe JSON stringify that handles circular references
+ */
+function safeStringify(obj) {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (_, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        return value;
+    });
+}
+/**
+ * Serialize an Error object to a plain object for JSON output
+ */
+function serializeError(error) {
+    return {
+        name: error.name,
+        message: error.message,
+        stack: error.stack,
+    };
+}
+/**
+ * Process context to handle special values like Error objects
+ */
+function processContext(context) {
+    const result = {};
+    for (const [key, value] of Object.entries(context)) {
+        if (value instanceof Error) {
+            result[key] = serializeError(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Create a structured logger instance.
+ *
+ * @param options - Logger configuration options
+ * @returns A Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger({
+ *   name: 'api',
+ *   level: LogLevel.INFO,
+ *   context: { service: 'my-service' }
+ * })
+ *
+ * // Create child logger with additional context
+ * const authLogger = logger.child({ component: 'auth' })
+ * authLogger.info('User logged in', { userId: 123 })
+ * ```
+ */
+export function createLogger(options = {}) {
+    const { name, level = LogLevel.INFO, context = {} } = options;
+    const log = (logLevel, message, callContext) => {
+        // Check if this level should be logged
+        if (logLevel < level || level === LogLevel.SILENT) {
+            return;
+        }
+        // Build log entry
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: levelNames[logLevel],
+            message,
+        };
+        // Add name if provided
+        if (name) {
+            entry.name = name;
+        }
+        // Merge default context
+        const processedDefaultContext = processContext(context);
+        Object.assign(entry, processedDefaultContext);
+        // Merge call-specific context (overrides defaults)
+        if (callContext) {
+            const processedCallContext = processContext(callContext);
+            Object.assign(entry, processedCallContext);
+        }
+        // Output as JSON
+        console.log(safeStringify(entry));
+    };
+    const logger = {
+        debug(message, ctx) {
+            log(LogLevel.DEBUG, message, ctx);
+        },
+        info(message, ctx) {
+            log(LogLevel.INFO, message, ctx);
+        },
+        warn(message, ctx) {
+            log(LogLevel.WARN, message, ctx);
+        },
+        error(message, ctx) {
+            log(LogLevel.ERROR, message, ctx);
+        },
+        child(childContext) {
+            return createLogger({
+                name,
+                level,
+                context: { ...context, ...childContext },
+            });
+        },
+    };
+    return logger;
+}
+/**
+ * Default logger instance for convenience.
+ * Use createLogger() for custom configuration.
+ */
+export const logger = createLogger();
+//# sourceMappingURL=index.js.map

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

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