@beethovn/logging 1.0.0

package/dist/core/CorrelationContextManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CorrelationContextManager.js","sourceRoot":"","sources":["../../src/core/CorrelationContextManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAC5B,MAAM,CAAC,OAAO,GAAG,IAAI,iBAAiB,EAAc,CAAC;IAE7D;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,GAAG,CAAI,OAAmB,EAAE,EAAW;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,aAAa,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC;IACrC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,CAAC,OAA4B;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;IACtC,CAAC"}

package/dist/core/Logger.d.ts

@@ -0,0 +1,105 @@
+import { type BeethovnError } from '@beethovn/errors';
+import { type LoggerConfig } from './types.js';
+import type { LogTransport } from '../transports/LogTransport.js';
+/**
+ * Structured logger with correlation tracking
+ *
+ * Features:
+ * - Structured JSON logging
+ * - Automatic correlation ID tracking
+ * - Integration with BeethovnError
+ * - Multiple log levels
+ * - Transport abstraction
+ *
+ * @example
+ * ```typescript
+ * const logger = new Logger({
+ *   level: LogLevel.INFO,
+ *   service: 'payment-service',
+ *   json: true,
+ * });
+ *
+ * logger.info('Payment processed', { paymentId: '123', amount: 100 });
+ * logger.error('Payment failed', error, { paymentId: '123' });
+ * ```
+ */
+export declare class Logger {
+    private config;
+    private transports;
+    constructor(config?: Partial<LoggerConfig>);
+    /**
+     * Add a transport for outputting logs
+     *
+     * @param transport - The transport to add
+     */
+    addTransport(transport: LogTransport): void;
+    /**
+     * Log a debug message
+     *
+     * @param message - Log message
+     * @param metadata - Additional structured data
+     */
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log an info message
+     *
+     * @param message - Log message
+     * @param metadata - Additional structured data
+     */
+    info(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     *
+     * @param message - Log message
+     * @param metadata - Additional structured data
+     */
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     *
+     * @param message - Log message
+     * @param error - Error object (optional)
+     * @param metadata - Additional structured data
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await operation();
+     * } catch (error: unknown) {
+     *   const err = ErrorFactory.fromUnknown(error);
+     *   logger.error('Operation failed', err, { operationId: '123' });
+     * }
+     * ```
+     */
+    error(message: string, error?: BeethovnError | Error | unknown, metadata?: Record<string, unknown>): void;
+    /**
+     * Core logging method
+     *
+     * @param level - Log level
+     * @param message - Log message
+     * @param metadata - Additional data
+     */
+    private log;
+    /**
+     * Extract error details from various error types
+     */
+    private extractErrorDetails;
+    /**
+     * Default console output (used when no transports configured)
+     */
+    private defaultOutput;
+    /**
+     * Create a child logger with additional context
+     *
+     * @param context - Context to add to all logs
+     * @returns New logger instance with context
+     *
+     * @example
+     * ```typescript
+     * const paymentLogger = logger.child({ service: 'payment-processor' });
+     * paymentLogger.info('Processing payment'); // includes service context
+     * ```
+     */
+    child(context: Partial<LoggerConfig>): Logger;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/core/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/core/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAA+C,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAsB;gBAE5B,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAU9C;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAI3C;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,aAAa,GAAG,KAAK,GAAG,OAAO,EACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAQP;;;;;;OAMG;IACH,OAAO,CAAC,GAAG;IAkCX;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmC3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM;CAQ9C"}

package/dist/core/Logger.js

@@ -0,0 +1,210 @@
+import { isBeethovnError } from '@beethovn/errors';
+import { LogLevel, LOG_LEVEL_PRIORITY } from './types.js';
+import { CorrelationContextManager } from './CorrelationContextManager.js';
+/**
+ * Structured logger with correlation tracking
+ *
+ * Features:
+ * - Structured JSON logging
+ * - Automatic correlation ID tracking
+ * - Integration with BeethovnError
+ * - Multiple log levels
+ * - Transport abstraction
+ *
+ * @example
+ * ```typescript
+ * const logger = new Logger({
+ *   level: LogLevel.INFO,
+ *   service: 'payment-service',
+ *   json: true,
+ * });
+ *
+ * logger.info('Payment processed', { paymentId: '123', amount: 100 });
+ * logger.error('Payment failed', error, { paymentId: '123' });
+ * ```
+ */
+export class Logger {
+    config;
+    transports = [];
+    constructor(config = {}) {
+        this.config = {
+            level: config.level ?? LogLevel.INFO,
+            service: config.service ?? 'beethovn',
+            json: config.json ?? true,
+            timestamps: config.timestamps ?? true,
+            colorize: config.colorize ?? false,
+        };
+    }
+    /**
+     * Add a transport for outputting logs
+     *
+     * @param transport - The transport to add
+     */
+    addTransport(transport) {
+        this.transports.push(transport);
+    }
+    /**
+     * Log a debug message
+     *
+     * @param message - Log message
+     * @param metadata - Additional structured data
+     */
+    debug(message, metadata) {
+        this.log(LogLevel.DEBUG, message, metadata);
+    }
+    /**
+     * Log an info message
+     *
+     * @param message - Log message
+     * @param metadata - Additional structured data
+     */
+    info(message, metadata) {
+        this.log(LogLevel.INFO, message, metadata);
+    }
+    /**
+     * Log a warning message
+     *
+     * @param message - Log message
+     * @param metadata - Additional structured data
+     */
+    warn(message, metadata) {
+        this.log(LogLevel.WARN, message, metadata);
+    }
+    /**
+     * Log an error message
+     *
+     * @param message - Log message
+     * @param error - Error object (optional)
+     * @param metadata - Additional structured data
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await operation();
+     * } catch (error: unknown) {
+     *   const err = ErrorFactory.fromUnknown(error);
+     *   logger.error('Operation failed', err, { operationId: '123' });
+     * }
+     * ```
+     */
+    error(message, error, metadata) {
+        const errorDetails = this.extractErrorDetails(error);
+        this.log(LogLevel.ERROR, message, {
+            ...metadata,
+            ...(errorDetails && { error: errorDetails }),
+        });
+    }
+    /**
+     * Core logging method
+     *
+     * @param level - Log level
+     * @param message - Log message
+     * @param metadata - Additional data
+     */
+    log(level, message, metadata) {
+        // Check if this level should be logged
+        if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.config.level]) {
+            return;
+        }
+        // Get correlation context
+        const context = CorrelationContextManager.getContext();
+        // Build log entry
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            service: this.config.service,
+            correlationId: context?.correlationId,
+            userId: context?.userId,
+            tenantId: context?.tenantId,
+            ...(metadata && { metadata }),
+        };
+        // Output to transports
+        if (this.transports.length > 0) {
+            this.transports.forEach(transport => transport.log(entry));
+        }
+        else {
+            // Default: console output
+            this.defaultOutput(entry);
+        }
+    }
+    /**
+     * Extract error details from various error types
+     */
+    extractErrorDetails(error) {
+        if (!error) {
+            return undefined;
+        }
+        // BeethovnError - use toJSON()
+        if (isBeethovnError(error)) {
+            const json = error.toJSON();
+            return {
+                name: json.name,
+                code: json.code,
+                message: json.message,
+                stack: json.stack,
+                metadata: json.metadata,
+            };
+        }
+        // Standard Error
+        if (error instanceof Error) {
+            return {
+                name: error.name,
+                code: 'UNKNOWN_ERROR',
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        // Unknown error type
+        return {
+            name: 'UnknownError',
+            code: 'UNKNOWN_ERROR',
+            message: String(error),
+        };
+    }
+    /**
+     * Default console output (used when no transports configured)
+     */
+    defaultOutput(entry) {
+        if (this.config.json) {
+            console.log(JSON.stringify(entry));
+        }
+        else {
+            const parts = [
+                entry.timestamp,
+                `[${entry.level.toUpperCase()}]`,
+                entry.service,
+                entry.correlationId && `(${entry.correlationId})`,
+                entry.message,
+            ].filter(Boolean);
+            console.log(parts.join(' '));
+            if (entry.metadata) {
+                console.log('  Metadata:', entry.metadata);
+            }
+            if (entry.error) {
+                console.error('  Error:', entry.error);
+            }
+        }
+    }
+    /**
+     * Create a child logger with additional context
+     *
+     * @param context - Context to add to all logs
+     * @returns New logger instance with context
+     *
+     * @example
+     * ```typescript
+     * const paymentLogger = logger.child({ service: 'payment-processor' });
+     * paymentLogger.info('Processing payment'); // includes service context
+     * ```
+     */
+    child(context) {
+        const childLogger = new Logger({
+            ...this.config,
+            ...context,
+        });
+        childLogger.transports = this.transports;
+        return childLogger;
+    }
+}
+//# sourceMappingURL=Logger.js.map

package/dist/core/Logger.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Log levels supported by the logging system
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * Numeric priority for log levels (higher = more severe)
+ */
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+/**
+ * Structured log entry
+ */
+export interface LogEntry {
+    /** Timestamp in ISO 8601 format */
+    timestamp: string;
+    /** Log level */
+    level: LogLevel;
+    /** Log message */
+    message: string;
+    /** Service/application name */
+    service?: string;
+    /** Correlation ID for request tracking */
+    correlationId?: string;
+    /** User ID if available */
+    userId?: string;
+    /** Tenant ID if available */
+    tenantId?: string;
+    /** Additional structured metadata */
+    metadata?: Record<string, unknown>;
+    /** Error details if logging an error */
+    error?: {
+        name: string;
+        code: string;
+        message: string;
+        stack?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+/**
+ * Log context - carries information across async operations
+ */
+export interface LogContext {
+    /** Correlation ID for request tracking */
+    correlationId?: string;
+    /** User ID */
+    userId?: string;
+    /** Tenant ID */
+    tenantId?: string;
+    /** Service name */
+    service?: string;
+    /** Additional context data */
+    [key: string]: unknown;
+}
+/**
+ * Logger configuration
+ */
+export interface LoggerConfig {
+    /** Minimum log level to output */
+    level: LogLevel;
+    /** Service/application name */
+    service: string;
+    /** Whether to output JSON format */
+    json: boolean;
+    /** Whether to include timestamps */
+    timestamps: boolean;
+    /** Whether to colorize output (for console) */
+    colorize: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAKvD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,gBAAgB;IAChB,KAAK,EAAE,QAAQ,CAAC;IAEhB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,wCAAwC;IACxC,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,QAAQ,CAAC;IAEhB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IAEd,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAC;IAEpB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/core/types.js

@@ -0,0 +1,20 @@
+/**
+ * Log levels supported by the logging system
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Numeric priority for log levels (higher = more severe)
+ */
+export const LOG_LEVEL_PRIORITY = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.WARN]: 2,
+    [LogLevel.ERROR]: 3,
+};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;CACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Logger } from './core/Logger.js';
+export { CorrelationContextManager } from './core/CorrelationContextManager.js';
+export { LogLevel, LOG_LEVEL_PRIORITY, type LogEntry, type LogContext, type LoggerConfig, } from './core/types.js';
+export { type LogTransport } from './transports/LogTransport.js';
+export { ConsoleTransport } from './transports/ConsoleTransport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Core
+export { Logger } from './core/Logger.js';
+export { CorrelationContextManager } from './core/CorrelationContextManager.js';
+export { LogLevel, LOG_LEVEL_PRIORITY, } from './core/types.js';
+export { ConsoleTransport } from './transports/ConsoleTransport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EACL,QAAQ,EACR,kBAAkB,GAInB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/transports/ConsoleTransport.d.ts

@@ -0,0 +1,27 @@
+import { type LogEntry } from '../core/types.js';
+import type { LogTransport } from './LogTransport.js';
+/**
+ * Console log transport
+ *
+ * Outputs logs to stdout (info/debug) or stderr (warn/error)
+ * with optional colorization and formatting
+ */
+export declare class ConsoleTransport implements LogTransport {
+    private json;
+    private colorize;
+    private static readonly COLORS;
+    constructor(options?: {
+        json?: boolean;
+        colorize?: boolean;
+    });
+    log(entry: LogEntry): void;
+    /**
+     * Output JSON log entry
+     */
+    private logJson;
+    /**
+     * Output formatted (human-readable) log entry
+     */
+    private logFormatted;
+}
+//# sourceMappingURL=ConsoleTransport.d.ts.map

package/dist/transports/ConsoleTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleTransport.d.ts","sourceRoot":"","sources":["../../src/transports/ConsoleTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,QAAQ,CAAU;IAG1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAM5B;gBAEU,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAKhE,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAQ1B;;OAEG;IACH,OAAO,CAAC,OAAO;IAWf;;OAEG;IACH,OAAO,CAAC,YAAY;CAyCrB"}

package/dist/transports/ConsoleTransport.js

@@ -0,0 +1,85 @@
+import { LogLevel } from '../core/types.js';
+/**
+ * Console log transport
+ *
+ * Outputs logs to stdout (info/debug) or stderr (warn/error)
+ * with optional colorization and formatting
+ */
+export class ConsoleTransport {
+    json;
+    colorize;
+    // ANSI color codes
+    static COLORS = {
+        debug: '\x1b[36m', // Cyan
+        info: '\x1b[32m', // Green
+        warn: '\x1b[33m', // Yellow
+        error: '\x1b[31m', // Red
+        reset: '\x1b[0m',
+    };
+    constructor(options = {}) {
+        this.json = options.json ?? true;
+        this.colorize = options.colorize ?? false;
+    }
+    log(entry) {
+        if (this.json) {
+            this.logJson(entry);
+        }
+        else {
+            this.logFormatted(entry);
+        }
+    }
+    /**
+     * Output JSON log entry
+     */
+    logJson(entry) {
+        const output = JSON.stringify(entry);
+        // Use stderr for errors and warnings
+        if (entry.level === LogLevel.ERROR || entry.level === LogLevel.WARN) {
+            console.error(output);
+        }
+        else {
+            console.log(output);
+        }
+    }
+    /**
+     * Output formatted (human-readable) log entry
+     */
+    logFormatted(entry) {
+        const color = this.colorize ? ConsoleTransport.COLORS[entry.level] : '';
+        const reset = this.colorize ? ConsoleTransport.COLORS.reset : '';
+        // Build log line
+        const parts = [
+            entry.timestamp,
+            `${color}[${entry.level.toUpperCase()}]${reset}`,
+            entry.service,
+            entry.correlationId && `(${entry.correlationId})`,
+            entry.message,
+        ].filter(Boolean);
+        const logLine = parts.join(' ');
+        // Output main log line
+        if (entry.level === LogLevel.ERROR || entry.level === LogLevel.WARN) {
+            console.error(logLine);
+        }
+        else {
+            console.log(logLine);
+        }
+        // Output metadata if present
+        if (entry.metadata && Object.keys(entry.metadata).length > 0) {
+            console.log('  Metadata:', JSON.stringify(entry.metadata, null, 2));
+        }
+        // Output error details if present
+        if (entry.error) {
+            console.error('  Error:', entry.error.name, '-', entry.error.message);
+            if (entry.error.code) {
+                console.error('  Code:', entry.error.code);
+            }
+            if (entry.error.stack) {
+                console.error('  Stack:', entry.error.stack);
+            }
+            if (entry.error.metadata) {
+                console.error('  Error Metadata:', JSON.stringify(entry.error.metadata, null, 2));
+            }
+        }
+    }
+}
+//# sourceMappingURL=ConsoleTransport.js.map

package/dist/transports/ConsoleTransport.js.map

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

package/dist/transports/LogTransport.d.ts

@@ -0,0 +1,16 @@
+import type { LogEntry } from '../core/types.js';
+/**
+ * Interface for log transports
+ *
+ * A transport is responsible for outputting log entries
+ * to a specific destination (console, file, external service, etc.)
+ */
+export interface LogTransport {
+    /**
+     * Output a log entry
+     *
+     * @param entry - The log entry to output
+     */
+    log(entry: LogEntry): void;
+}
+//# sourceMappingURL=LogTransport.d.ts.map

package/dist/transports/LogTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogTransport.d.ts","sourceRoot":"","sources":["../../src/transports/LogTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC5B"}

package/dist/transports/LogTransport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LogTransport.js.map

package/dist/transports/LogTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogTransport.js","sourceRoot":"","sources":["../../src/transports/LogTransport.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@beethovn/logging",
+  "version": "1.0.0",
+  "description": "Structured logging with correlation tracking for the Beethovn platform",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "logging",
+    "structured-logging",
+    "correlation",
+    "typescript",
+    "beethovn"
+  ],
+  "author": "Beethovn Team",
+  "license": "MIT",
+  "dependencies": {
+    "@beethovn/errors": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "type-check": "tsc --noEmit"
+  }
+}