@eventuras/logger 0.7.0

package/dist/transports/console.d.ts

@@ -0,0 +1,11 @@
+import { LogLevel, LogTransport } from '../types';
+export declare class ConsoleTransport implements LogTransport {
+    private readonly bindings;
+    /** Create a ConsoleTransport with optional pre-bound context fields. */
+    constructor(bindings?: Record<string, unknown>);
+    /** Write a log entry to the appropriate `console` method. */
+    log(level: LogLevel, data: Record<string, unknown>, msg?: string): void;
+    /** Return a new ConsoleTransport with the given bindings merged in. */
+    child(bindings: Record<string, unknown>): LogTransport;
+}
+//# sourceMappingURL=console.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/transports/console.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAWvD,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IAEnD,wEAAwE;gBAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI9C,6DAA6D;IAC7D,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAcvE,uEAAuE;IACvE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;CAGvD"}

package/dist/transports/pino.d.ts

@@ -0,0 +1,24 @@
+import { Logger as PinoLogger, LoggerOptions as PinoLoggerOptions } from 'pino';
+import { LogLevel, LogTransport } from '../types';
+/** Options for creating a PinoTransport. */
+export type PinoTransportOptions = {
+    /** Minimum log level. Defaults to `'info'`. */
+    level?: LogLevel;
+    /** Field paths to redact from output. */
+    redact?: string[];
+    /** Enable pretty-printed, human-readable output. */
+    prettyPrint?: boolean;
+    /** File path destination (omit for stdout). */
+    destination?: string;
+    /** Raw Pino options for advanced tuning (merged after built-in defaults). */
+    pinoOptions?: PinoLoggerOptions;
+};
+export declare class PinoTransport implements LogTransport {
+    /** The underlying Pino instance. Exposed for advanced integrations only. */
+    readonly pino: PinoLogger;
+    constructor(options?: PinoTransportOptions);
+    log(level: LogLevel, data: Record<string, unknown>, msg?: string): void;
+    child(bindings: Record<string, unknown>): LogTransport;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=pino.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pino.d.ts","sourceRoot":"","sources":["../../src/transports/pino.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAa,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,KAAK,aAAa,IAAI,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGvD,4CAA4C;AAC5C,MAAM,MAAM,oBAAoB,GAAG;IACjC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC,CAAC;AAEF,qBAAa,aAAc,YAAW,YAAY;IAChD,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;gBAEd,OAAO,GAAE,oBAAyB;IAwB9C,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQvE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAKhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/transports/pretty.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Lightweight pretty-print formatter for development.
+ * Zero external dependencies — uses ANSI colors and simple formatting.
+ *
+ * Produces output like:
+ *   12:34:56 INFO  (web:auth) → User logged in
+ *   12:34:56 ERROR (web:auth) → Failed to authenticate { error: "invalid token" }
+ */
+/**
+ * Format a Pino JSON log line into a human-readable string.
+ * @param line Raw JSON string from Pino
+ * @returns Formatted string, or the original line if parsing fails
+ */
+export declare function formatLogLine(line: string): string;
+/**
+ * Creates a Node.js writable stream that formats Pino JSON output.
+ * Used as the destination for PinoTransport when prettyPrint is enabled.
+ */
+export declare function createPrettyStream(): NodeJS.WritableStream;
+//# sourceMappingURL=pretty.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pretty.d.ts","sourceRoot":"","sources":["../../src/transports/pretty.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBlD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,cAAc,CAa1D"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Core type definitions for @eventuras/logger.
+ *
+ * The `LogTransport` interface is the primary extension point — implement it
+ * to send logs to any backend (Pino, Winston, console, a test spy, etc.).
+ */
+/** Standard log levels ordered by severity (lowest → highest). */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Pluggable transport interface for log output.
+ *
+ * Implement this to send structured log data to any backend.
+ * The library ships with `PinoTransport` (default) and `ConsoleTransport`.
+ *
+ * @example
+ * // Custom transport
+ * const myTransport: LogTransport = {
+ *   log(level, data, msg) { fetch('/logs', { body: JSON.stringify({ level, ...data, msg }) }); },
+ *   child(bindings) { return { ...myTransport, log(l, d, m) { myTransport.log(l, { ...bindings, ...d }, m); } }; },
+ * };
+ */
+export interface LogTransport {
+    /** Write a log entry at the given level. */
+    log(level: LogLevel, data: Record<string, unknown>, msg?: string): void;
+    /** Create a child transport with additional bound fields. */
+    child(bindings: Record<string, unknown>): LogTransport;
+    /** Flush any buffered log entries. */
+    flush?(): Promise<void>;
+    /** Graceful shutdown — flush and release resources. */
+    shutdown?(): Promise<void>;
+}
+/** Options for creating a scoped Logger instance. */
+export type LoggerOptions = {
+    /** If true, only logs in development mode. */
+    developerOnly?: boolean;
+    /** Namespace for filtering logs (e.g., 'web:admin:events'). */
+    namespace?: string;
+    /** Minimum log level for this logger instance. */
+    level?: LogLevel;
+    /** Persistent context fields included in every log entry. */
+    context?: Record<string, unknown>;
+    /** Correlation ID for request tracing. */
+    correlationId?: string;
+};
+/** Extended options for error/fatal log methods. */
+export type ErrorLoggerOptions = LoggerOptions & {
+    error?: unknown;
+};
+/** Global logger configuration. */
+export type LoggerConfig = {
+    /** Global minimum log level. */
+    level?: LogLevel;
+    /** Field paths to redact from log output (e.g., ['password', 'token']). */
+    redact?: string[];
+    /** Enable pretty-printed output (auto-enabled in development). */
+    prettyPrint?: boolean;
+    /** Optional file path for log output (Pino only). */
+    destination?: string;
+    /** Custom transport implementation. Defaults to PinoTransport. */
+    transport?: LogTransport;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kEAAkE;AAClE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExE,6DAA6D;IAC7D,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC;IAEvD,sCAAsC;IACtC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG;IAC1B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG;IACzB,gCAAgC;IAChC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@eventuras/logger",
+  "version": "0.7.0",
+  "description": "Structured logging with Pino and optional OpenTelemetry integration",
+  "keywords": [
+    "logger",
+    "logging",
+    "structured-logging",
+    "pino",
+    "opentelemetry",
+    "otel"
+  ],
+  "homepage": "https://github.com/losol/eventuras/tree/main/libs/logger#readme",
+  "bugs": {
+    "url": "https://github.com/losol/eventuras/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/losol/eventuras.git",
+    "directory": "libs/logger"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    },
+    "./opentelemetry": {
+      "types": "./dist/opentelemetry.d.ts",
+      "import": "./dist/opentelemetry.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "pino": "^10.3.1"
+  },
+  "devDependencies": {
+    "@eventuras/vite-config": "workspace:*",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/api-logs": "^0.214.0",
+    "@opentelemetry/instrumentation-pino": "^0.60.0",
+    "@opentelemetry/sdk-logs": "^0.214.0",
+    "vite": "^8.0.3",
+    "vitest": "^4.1.4"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": ">=0.200.0",
+    "@opentelemetry/instrumentation-pino": ">=0.50.0",
+    "@opentelemetry/sdk-logs": ">=0.200.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "@opentelemetry/api-logs": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation-pino": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-logs": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}