@eventuras/logger 0.9.0 → 0.9.1

package/dist/Logger.d.ts

@@ -1,4 +1,32 @@
-import { ErrorLoggerOptions, LoggerConfig, LoggerOptions, LogTransport } from './types';
+/**
+ * Structured logger with pluggable transports.
+ *
+ * Uses a `LogTransport` abstraction so the logging backend can be swapped
+ * without changing application code. Ships with PinoTransport (default,
+ * production-grade) and ConsoleTransport (browser/testing).
+ *
+ * Standard log levels:
+ * fatal: 60 | error: 50 | warn: 40 | info: 30 | debug: 20 | trace: 10
+ *
+ * @example
+ * // Scoped logger (recommended pattern)
+ * const logger = Logger.create({
+ *   namespace: 'CollectionEditor',
+ *   context: { collectionId: 123 },
+ * });
+ * logger.info('Event added', { eventId: 456 });
+ *
+ * @example
+ * // Static one-off logs
+ * Logger.info('Simple message');
+ * Logger.error({ error: err }, 'Something failed');
+ *
+ * @example
+ * // Custom transport
+ * import { ConsoleTransport } from '@eventuras/logger';
+ * Logger.configure({ transport: new ConsoleTransport() });
+ */
+import type { ErrorLoggerOptions, LoggerConfig, LoggerOptions, LogTransport } from './types';
 export declare class Logger {
     private static transport;
     private static config;

package/dist/node.d.ts

@@ -1,5 +1,5 @@
-import { PinoTransportOptions } from './transports/pino';
-import { LoggerConfig } from './types';
+import { type PinoTransportOptions } from './transports/pino';
+import type { LoggerConfig } from './types';
 export { formatLogLine, createPrettyStream } from './transports/pretty';
 /** Options for `configureNodeLogger`. */
 export type NodeLoggerOptions = Omit<LoggerConfig, 'transport'> & {

package/dist/transports/console.d.ts

@@ -1,4 +1,10 @@
-import { LogLevel, LogTransport } from '../types';
+/**
+ * Console-based transport for browser environments and testing.
+ *
+ * Uses `console.log/warn/error` — no dependencies, works everywhere.
+ * Useful as a lightweight fallback when Pino is not available or desired.
+ */
+import type { LogLevel, LogTransport } from '../types';
 export declare class ConsoleTransport implements LogTransport {
     private readonly bindings;
     /** Create a ConsoleTransport with optional pre-bound context fields. */

package/dist/transports/pino.d.ts

@@ -1,5 +1,15 @@
-import { Logger as PinoLogger, LoggerOptions as PinoLoggerOptions } from 'pino';
-import { LogLevel, LogTransport } from '../types';
+/**
+ * Pino-based transport — the default production backend.
+ *
+ * Wraps a Pino logger instance to satisfy the `LogTransport` interface,
+ * keeping Pino as an implementation detail that consumers never interact with directly.
+ *
+ * For pretty-printed dev output, see `configureNodeLogger` in
+ * `@eventuras/logger/node` — this module intentionally stays free of
+ * `node:stream` imports so the main entry stays browser/edge-safe.
+ */
+import { type Logger as PinoLogger, type LoggerOptions as PinoLoggerOptions } from 'pino';
+import type { LogLevel, LogTransport } from '../types';
 /**
  * Minimal structural type for a Pino destination stream — accepts anything
  * with a `write` method. Defined locally so this file (re-exported from the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventuras/logger",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Structured logging with Pino and optional OpenTelemetry integration",
   "keywords": [
     "logger",
@@ -47,11 +47,12 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-logs": "^0.222.0",
+    "typescript": "^6.0.2",
     "vite": "^8.1.0",
     "vitest": "^5.0.0",
     "@eventuras/eslint-config": "1.0.5",
-    "@eventuras/typescript-config": "1.0.0",
-    "@eventuras/vite-config": "0.3.1"
+    "@eventuras/typescript-config": "1.1.0",
+    "@eventuras/vite-config": "0.4.0"
   },
   "peerDependencies": {
     "@opentelemetry/sdk-logs": ">=0.200.0 <1.0.0"
@@ -65,7 +66,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "build": "vite build",
+    "build": "vite build && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "dev": "vite build --watch",
     "test": "vitest run",
     "test:watch": "vitest"