@leancodepl/logger 10.4.0 → 10.5.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file. See
 [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [10.5.0](https://github.com/leancodepl/js_corelibrary/compare/v10.4.0...v10.5.0) (2026-07-01)
+
+### Bug Fixes
+
+- **logger:** add tsconfig.spec project reference to fix typecheck
+  ([88911da](https://github.com/leancodepl/js_corelibrary/commit/88911da2459efb5694d375602c3277f6ed819080))
+- resolve pre-existing typecheck errors in logger affected set
+  ([9bb40cf](https://github.com/leancodepl/js_corelibrary/commit/9bb40cf62ffd84b55f1bb20a19aef1fcf7a15dff))
+
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
 # [10.4.0](https://github.com/leancodepl/js_corelibrary/compare/v10.3.1...v10.4.0) (2026-06-23)
 
 **Note:** Version bump only for package @leancodepl/logger

package/README.md

@@ -7,9 +7,151 @@ A lightweight, type-safe logger with middleware support and contextual messages.
 - **`@leancodepl/logger`** – Core API below (custom handlers, context, middleware).
 - **`@leancodepl/logger/cli`** – Colored console preset with log levels: `createCliLogger`, `LogLevel`, `allLogLevels`.
 - **`@leancodepl/logger/json`** – JSON lines to stdout: `createJsonLogger` with the same level options as CLI.
-- **`@leancodepl/logger/nest`** – NestJS adapter: `createNestJsonLogger()` implementing `LoggerService` with JSON output.
+- **`@leancodepl/logger/nest`** – NestJS adapter: `createNestJsonLogger()` implementing `LoggerService` with JSON
+  output.
 
-## Creating a Logger
+## Installation
+
+```bash
+npm install @leancodepl/logger
+# or
+yarn add @leancodepl/logger
+```
+
+## API
+
+### `createLogger(methods)`
+
+Creates a logger from a map of method definitions. Each definition becomes a callable method on the returned logger, and
+the logger starts with an empty context that can be extended via `withContext`.
+
+**Parameters:**
+
+- `methods: TDefs` - Map of method name to its `MethodHandler`
+
+**Returns:** A logger exposing the defined methods plus `withContext` and `withMiddleware`.
+
+```typescript
+import { createLogger } from "@leancodepl/logger"
+
+const logger = createLogger({
+  info: (context, ...messages) => console.info(...messages),
+})
+
+logger.withContext({ requestId: "req-1" }).info("started")
+```
+
+### `isContextualMessage(message)`
+
+Type guard that narrows a `LoggerMessage` to a `ContextualLoggerMessage`. Used by logger implementations to decide
+whether a message must be invoked with the context or logged as-is.
+
+**Parameters:**
+
+- `message: LoggerMessage<TContext, TOutput>` - The message to inspect
+
+**Returns:** `true` when the message is a context-consuming function.
+
+```typescript
+import { isContextualMessage } from "@leancodepl/logger"
+
+const resolved = isContextualMessage(message) ? message(context) : message
+```
+
+### `createCliLogger(options)`
+
+Creates a logger preset for command-line output. Each log level maps to the matching `console` method and is prefixed
+with a colorized `[LEVEL]` label via middleware. Messages below the enabled threshold are skipped.
+
+**Parameters:**
+
+- `options?: { enabledLogLevels?: LogLevel[] }` - Levels that should be emitted; defaults to `defaultEnabledLogLevels`
+  (error, warn, success, info)
+
+**Returns:** A logger with one method per `LogLevel` label.
+
+```typescript
+import { createCliLogger } from "@leancodepl/logger/cli"
+
+const logger = createCliLogger()
+logger.info("server started")
+logger.error("something failed", new Error("boom"))
+```
+
+### `createJsonLogger(options)`
+
+Creates a logger preset that writes one JSON object per line to `process.stdout`. Each entry includes the level label,
+an ISO timestamp, the joined message, and the context (when non-empty). `Error` values are serialized to
+`{ message, stack }`. Messages below the enabled threshold are skipped.
+
+**Parameters:**
+
+- `options?: { enabledLogLevels?: LogLevel[] }` - Levels that should be emitted; defaults to `defaultEnabledLogLevels`
+  (error, warn, success, info)
+
+**Returns:** A logger with one method per `LogLevel` label.
+
+```typescript
+import { createJsonLogger } from "@leancodepl/logger/json"
+
+const logger = createJsonLogger()
+logger.withContext({ requestId: "req-1" }).info("request handled")
+// {"level":"info","timestamp":"...","message":"request handled","context":{"requestId":"req-1"}}
+```
+
+### `createNestJsonLogger()`
+
+Creates a NestJS-compatible `LoggerService` that emits one JSON object per line to `process.stdout`. When the final
+optional parameter is a string, it is treated as Nest's `context` argument and recorded separately; remaining params are
+joined into the message, with `Error` values reduced to their message.
+
+**Returns:** A logger implementing Nest's `log`/`error`/`warn`/`debug`/`verbose`/`fatal` methods.
+
+```typescript
+import { createNestJsonLogger } from "@leancodepl/logger/nest"
+
+const app = await NestFactory.create(AppModule, { logger: createNestJsonLogger() })
+```
+
+### `isLogLevelEnabled(logLevel, enabledLogLevels)`
+
+Returns whether a given level is present in the list of enabled levels.
+
+**Parameters:**
+
+- `logLevel: LogLevel` - The level to test
+- `enabledLogLevels: LogLevel[]` - The currently enabled levels
+
+**Returns:** `true` when `logLevel` is enabled.
+
+```typescript
+import { isLogLevelEnabled, LogLevel, defaultEnabledLogLevels } from "@leancodepl/logger"
+
+isLogLevelEnabled(LogLevel.Debug, defaultEnabledLogLevels) // false
+```
+
+### Exported values and types
+
+- `LogLevel` - Severity levels enum, ordered from most to least severe (lower numeric value is more severe): `Error`
+  (0), `Warn` (1), `Success` (2), `Info` (3), `Verbose` (4), `Debug` (5).
+- `allLogLevels: LogLevel[]` - Every `LogLevel` in severity order.
+- `defaultEnabledLogLevels: LogLevel[]` - Levels emitted by default by the presets: error, warn, success, and info.
+- `logLevelToLabel` - Maps each `LogLevel` to its lowercase string label.
+- `SupportedOutput` - The value types a logger method can accept and emit: `boolean | number | object | string`.
+- `DefaultContext` - Default shape of a logger's context: `Record<string, unknown>`.
+- `LoggerMessage<TContext, TOutput>` - A log argument: either a plain value or a function deriving the value from
+  context.
+- `MethodHandler<TOutput>` - Low-level handler backing a single log method; receives the resolved context as its first
+  argument.
+- `Logger<TContext, TDefs>` - A fully built logger: its methods plus `withMiddleware` and `withContext`.
+- `LoggerWithContext<TContext, TLogger>` - Re-derives a built logger's public shape for a given context; use it to type
+  values that hold a logger.
+- `CliLogger`, `JsonLogger`, `NestJsonLogger` - The logger types produced by the respective preset factories.
+- `LoggerService` - Subset of the NestJS `LoggerService` interface implemented by `createNestJsonLogger`.
+
+## Usage Examples
+
+### Creating a Logger
 
 ```typescript
 import { createLogger, isContextualMessage } from "@leancodepl/logger"
@@ -23,7 +165,7 @@ const logger = createLogger({
 logger.info("Hello", "world") // "Hello world"
 ```
 
-## Adding Context
+### Adding Context
 
 Use `withContext` to add context values. Context accumulates across calls.
 
@@ -32,7 +174,7 @@ const appLogger = logger.withContext({ appName: "MyApp" })
 const requestLogger = appLogger.withContext({ requestId: "req-123" })
 ```
 
-## Using Context in Messages
+### Using Context in Messages
 
 Messages can be functions that receive the current context.
 
@@ -43,7 +185,7 @@ userLogger.info(({ userId }) => `User ${userId} logged in`)
 // "User user-456 logged in"
 ```
 
-## Adding Middleware
+### Adding Middleware
 
 Use `withMiddleware` to wrap log methods. Middleware receives `next` (it is used to call a middleware from `logger` in
 this case) and returns a new handler.
@@ -60,7 +202,7 @@ const loggerWithPrefix = logger.withMiddleware({
 loggerWithPrefix.info("test") // "[INFO] test"
 ```
 
-## Modifying Context in Middleware
+### Modifying Context in Middleware
 
 Middleware can modify context before passing to the next handler.
 
@@ -75,7 +217,7 @@ const loggerWithTimestamp = logger.withMiddleware({
 })
 ```
 
-## Chaining Middleware
+### Chaining Middleware
 
 Middleware is applied in order, with later middleware being executed first, and passing its changes to the middleware
 that was created before it.
@@ -100,7 +242,7 @@ const logger2 = logger
 logger2.info("test") // "[1] [2] test"
 ```
 
-## Typing Functions
+### Typing Functions
 
 When passing a logger to functions, use `LoggerWithContext` for proper typing.
 
@@ -230,7 +372,8 @@ const timedLogger = logger.withMiddleware({
 
 ## JSON preset (`@leancodepl/logger/json`)
 
-Logger that writes one JSON object per line to stdout (level, timestamp, msg, optional context). Same log levels and `enabledLogLevels` option as the CLI preset.
+Logger that writes one JSON object per line to stdout (level, timestamp, msg, optional context). Same log levels and
+`enabledLogLevels` option as the CLI preset.
 
 ```typescript
 import { createJsonLogger, allLogLevels, LogLevel } from "@leancodepl/logger/json"
@@ -248,7 +391,8 @@ Supports `withContext` and `withMiddleware` like the base logger.
 
 ## Nest preset (`@leancodepl/logger/nest`)
 
-NestJS `LoggerService` implementation that outputs JSON (same shape as the JSON preset). Use as a drop-in logger in Nest apps.
+NestJS `LoggerService` implementation that outputs JSON (same shape as the JSON preset). Use as a drop-in logger in Nest
+apps.
 
 ```typescript
 import { createNestJsonLogger, type LoggerService } from "@leancodepl/logger/nest"
@@ -258,4 +402,5 @@ logger.log("Application started")
 logger.error("Something went wrong", "MyService")
 ```
 
-If the last argument is a string, it is used as the `context` field in the JSON output (same behavior as Nest’s built-in logger).
+If the last argument is a string, it is used as the `context` field in the JSON output (same behavior as Nest’s built-in
+logger).

package/dist/cli.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./cliLogger-xnFprY-d.cjs");exports.createCliLogger=e.createCliLogger;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./cliLogger-DrCrhkRC.cjs");exports.createCliLogger=e.createCliLogger;

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { c as o } from "./cliLogger-BIKHGxBN.js";
+import { c as o } from "./cliLogger-B-IrZcje.js";
 export {
   o as createCliLogger
 };

package/dist/{cliLogger-BIKHGxBN.js → cliLogger-B-IrZcje.js}

@@ -1,5 +1,5 @@
 import l from "chalk";
-import { c as u, i } from "./logger-Xwf0bgzB.js";
+import { c as u, i } from "./logger-CFrlEist.js";
 import { a as c, l as t, d as b, i as d, L as r } from "./logLevels-DN78PoTJ.js";
 const L = {
   [r.Error]: l.red,

package/dist/{cliLogger-xnFprY-d.cjs → cliLogger-DrCrhkRC.cjs}

@@ -1 +1 @@
-"use strict";const a=require("chalk"),L=require("./logger-CSPbXuiG.cjs"),e=require("./logLevels-B68KoC22.cjs"),c={[e.LogLevel.Error]:a.red,[e.LogLevel.Warn]:a.yellow,[e.LogLevel.Success]:a.green,[e.LogLevel.Info]:a.blue,[e.LogLevel.Verbose]:a.gray,[e.LogLevel.Debug]:a.magenta};function t(l,s){return s.map(o=>L.isContextualMessage(o)?o(l):o)}function u(l,s){return(o,...g)=>{if(e.isLogLevelEnabled(l,s)){const r=t(o,g);switch(l){case e.LogLevel.Error:console.error(...r);break;case e.LogLevel.Warn:console.warn(...r);break;case e.LogLevel.Success:console.log(...r);break;case e.LogLevel.Info:console.info(...r);break;case e.LogLevel.Verbose:console.log(...r);break;case e.LogLevel.Debug:console.log(...r);break}}}}function b(l){return s=>(o,...g)=>{const r=c[l],n=e.logLevelToLabel[l];s(o,r(`[${n.toUpperCase()}]`),...g)}}function i({enabledLogLevels:l=e.defaultEnabledLogLevels}={}){return L.createLogger({...e.allLogLevels.reduce((o,g)=>{const r=e.logLevelToLabel[g];return o[r]=u(g,l),o},{})}).withMiddleware({...e.allLogLevels.reduce((o,g)=>{const r=e.logLevelToLabel[g];return o[r]=b(g),o},{})})}exports.createCliLogger=i;
+"use strict";const a=require("chalk"),L=require("./logger-RyIBF1kr.cjs"),e=require("./logLevels-B68KoC22.cjs"),c={[e.LogLevel.Error]:a.red,[e.LogLevel.Warn]:a.yellow,[e.LogLevel.Success]:a.green,[e.LogLevel.Info]:a.blue,[e.LogLevel.Verbose]:a.gray,[e.LogLevel.Debug]:a.magenta};function t(l,s){return s.map(o=>L.isContextualMessage(o)?o(l):o)}function u(l,s){return(o,...g)=>{if(e.isLogLevelEnabled(l,s)){const r=t(o,g);switch(l){case e.LogLevel.Error:console.error(...r);break;case e.LogLevel.Warn:console.warn(...r);break;case e.LogLevel.Success:console.log(...r);break;case e.LogLevel.Info:console.info(...r);break;case e.LogLevel.Verbose:console.log(...r);break;case e.LogLevel.Debug:console.log(...r);break}}}}function b(l){return s=>(o,...g)=>{const r=c[l],n=e.logLevelToLabel[l];s(o,r(`[${n.toUpperCase()}]`),...g)}}function i({enabledLogLevels:l=e.defaultEnabledLogLevels}={}){return L.createLogger({...e.allLogLevels.reduce((o,g)=>{const r=e.logLevelToLabel[g];return o[r]=u(g,l),o},{})}).withMiddleware({...e.allLogLevels.reduce((o,g)=>{const r=e.logLevelToLabel[g];return o[r]=b(g),o},{})})}exports.createCliLogger=i;

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./logger-CSPbXuiG.cjs"),g=require("./json.cjs"),l=require("./nest.cjs"),e=require("./logLevels-B68KoC22.cjs"),r=require("./cliLogger-xnFprY-d.cjs");exports.createLogger=o.createLogger;exports.isContextualMessage=o.isContextualMessage;exports.createJsonLogger=g.createJsonLogger;exports.createNestJsonLogger=l.createNestJsonLogger;exports.LogLevel=e.LogLevel;exports.allLogLevels=e.allLogLevels;exports.defaultEnabledLogLevels=e.defaultEnabledLogLevels;exports.isLogLevelEnabled=e.isLogLevelEnabled;exports.logLevelToLabel=e.logLevelToLabel;exports.createCliLogger=r.createCliLogger;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./logger-RyIBF1kr.cjs"),g=require("./json.cjs"),l=require("./nest.cjs"),e=require("./logLevels-B68KoC22.cjs"),r=require("./cliLogger-DrCrhkRC.cjs");exports.createLogger=o.createLogger;exports.isContextualMessage=o.isContextualMessage;exports.createJsonLogger=g.createJsonLogger;exports.createNestJsonLogger=l.createNestJsonLogger;exports.LogLevel=e.LogLevel;exports.allLogLevels=e.allLogLevels;exports.defaultEnabledLogLevels=e.defaultEnabledLogLevels;exports.isLogLevelEnabled=e.isLogLevelEnabled;exports.logLevelToLabel=e.logLevelToLabel;exports.createCliLogger=r.createCliLogger;

package/dist/index.js

@@ -1,8 +1,8 @@
-import { c as a, i as r } from "./logger-Xwf0bgzB.js";
+import { c as a, i as r } from "./logger-CFrlEist.js";
 import { createJsonLogger as l } from "./json.js";
 import { createNestJsonLogger as g } from "./nest.js";
 import { L as c, a as f, d as x, i, l as m } from "./logLevels-DN78PoTJ.js";
-import { c as p } from "./cliLogger-BIKHGxBN.js";
+import { c as p } from "./cliLogger-B-IrZcje.js";
 export {
   c as LogLevel,
   f as allLogLevels,

package/dist/json.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./logger-CSPbXuiG.cjs"),s=require("./logLevels-B68KoC22.cjs");function c(e,r){return r.map(t=>o.isContextualMessage(t)?t(e):t)}function u(e){return e instanceof Error?{message:e.message,stack:e.stack}:e}function f(e){return typeof e=="object"&&e!==null?JSON.stringify(e):String(e)}function L(e,r){const t=s.logLevelToLabel[e];return(n,...a)=>{if(!s.isLogLevelEnabled(e,r))return;const g=c(n,a).map(l=>f(u(l))).join(" "),i={level:t,timestamp:new Date().toISOString(),message:g,...Object.keys(n).length>0?{context:n}:{}};process.stdout.write(JSON.stringify(i)+`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./logger-RyIBF1kr.cjs"),s=require("./logLevels-B68KoC22.cjs");function c(e,r){return r.map(t=>o.isContextualMessage(t)?t(e):t)}function u(e){return e instanceof Error?{message:e.message,stack:e.stack}:e}function f(e){return typeof e=="object"&&e!==null?JSON.stringify(e):String(e)}function L(e,r){const t=s.logLevelToLabel[e];return(n,...a)=>{if(!s.isLogLevelEnabled(e,r))return;const g=c(n,a).map(l=>f(u(l))).join(" "),i={level:t,timestamp:new Date().toISOString(),message:g,...Object.keys(n).length>0?{context:n}:{}};process.stdout.write(JSON.stringify(i)+`
 `)}}function p({enabledLogLevels:e=s.defaultEnabledLogLevels}={}){return o.createLogger({...s.allLogLevels.reduce((r,t)=>{const n=s.logLevelToLabel[t];return r[n]=L(t,e),r},{})})}exports.createJsonLogger=p;

package/dist/json.js

@@ -1,4 +1,4 @@
-import { c, i as f } from "./logger-Xwf0bgzB.js";
+import { c, i as f } from "./logger-CFrlEist.js";
 import { a as l, l as n, d as u, i as m } from "./logLevels-DN78PoTJ.js";
 function p(e, s) {
   return s.map((t) => f(t) ? t(e) : t);

package/dist/lib/cliLogger.d.ts

@@ -1,16 +1,35 @@
-import { MethodHandler } from './logger';
+import { MethodHandler, SupportedOutput } from './logger';
 import { LogLevel } from './logLevels';
 type CreateCliLoggerOptions = {
     enabledLogLevels?: LogLevel[];
 };
+/**
+ * Creates a logger preset for command-line output. Each log level maps to the
+ * matching `console` method and is prefixed with a colorized `[LEVEL]` label
+ * via middleware. Messages below the enabled threshold are skipped.
+ *
+ * @param options - Configuration for the CLI logger
+ * @param options.enabledLogLevels - Levels that should be emitted; defaults to
+ *   {@link defaultEnabledLogLevels} (error, warn, success, info)
+ * @returns A logger with one method per {@link LogLevel} label
+ * @example
+ * ```typescript
+ * const logger = createCliLogger()
+ * logger.info("server started")
+ * logger.error("something failed", new Error("boom"))
+ * ```
+ */
 declare function createCliLogger({ enabledLogLevels }?: CreateCliLoggerOptions): import('./logger').Logger<{}, {
-    error: MethodHandler<unknown>;
-    warn: MethodHandler<unknown>;
-    success: MethodHandler<unknown>;
-    info: MethodHandler<unknown>;
-    verbose: MethodHandler<unknown>;
-    debug: MethodHandler<unknown>;
+    error: MethodHandler<SupportedOutput>;
+    warn: MethodHandler<SupportedOutput>;
+    success: MethodHandler<SupportedOutput>;
+    info: MethodHandler<SupportedOutput>;
+    verbose: MethodHandler<SupportedOutput>;
+    debug: MethodHandler<SupportedOutput>;
 }>;
+/**
+ * The logger type produced by {@link createCliLogger}.
+ */
 type CliLogger = ReturnType<typeof createCliLogger>;
 export { type CliLogger, createCliLogger };
 //# sourceMappingURL=cliLogger.d.ts.map

package/dist/lib/cliLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cliLogger.d.ts","sourceRoot":"","sources":["../../src/lib/cliLogger.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,aAAa,EAEd,MAAM,UAAU,CAAA;AACjB,OAAO,EAIL,QAAQ,EAGT,MAAM,aAAa,CAAA;AAwDpB,KAAK,sBAAsB,GAAG;IAAE,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAE/D,iBAAS,eAAe,CAAC,EAAE,gBAA0C,EAAE,GAAE,sBAA2B;;;;;;;GAsBnG;AAED,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnD,OAAO,EAAE,KAAK,SAAS,EAAE,eAAe,EAAE,CAAA"}
+{"version":3,"file":"cliLogger.d.ts","sourceRoot":"","sources":["../../src/lib/cliLogger.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,aAAa,EACb,eAAe,EAChB,MAAM,UAAU,CAAA;AACjB,OAAO,EAIL,QAAQ,EAGT,MAAM,aAAa,CAAA;AAwDpB,KAAK,sBAAsB,GAAG;IAAE,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,eAAe,CAAC,EAAE,gBAA0C,EAAE,GAAE,sBAA2B;;;;;;;GAsBnG;AAED;;GAEG;AACH,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnD,OAAO,EAAE,KAAK,SAAS,EAAE,eAAe,EAAE,CAAA"}

package/dist/lib/jsonLogger.d.ts

@@ -1,16 +1,37 @@
-import { MethodHandler } from './logger';
+import { MethodHandler, SupportedOutput } from './logger';
 import { LogLevel } from './logLevels';
 type CreateJsonLoggerOptions = {
     enabledLogLevels?: LogLevel[];
 };
+/**
+ * Creates a logger preset that writes one JSON object per line to
+ * `process.stdout`. Each entry includes the level label, an ISO timestamp, the
+ * joined message, and the context (when non-empty). `Error` values are
+ * serialized to `{ message, stack }`. Messages below the enabled threshold are
+ * skipped.
+ *
+ * @param options - Configuration for the JSON logger
+ * @param options.enabledLogLevels - Levels that should be emitted; defaults to
+ *   {@link defaultEnabledLogLevels} (error, warn, success, info)
+ * @returns A logger with one method per {@link LogLevel} label
+ * @example
+ * ```typescript
+ * const logger = createJsonLogger()
+ * logger.withContext({ requestId: "req-1" }).info("request handled")
+ * // {"level":"info","timestamp":"...","message":"request handled","context":{"requestId":"req-1"}}
+ * ```
+ */
 declare function createJsonLogger({ enabledLogLevels }?: CreateJsonLoggerOptions): import('./logger').Logger<{}, {
-    error: MethodHandler<unknown>;
-    warn: MethodHandler<unknown>;
-    success: MethodHandler<unknown>;
-    info: MethodHandler<unknown>;
-    verbose: MethodHandler<unknown>;
-    debug: MethodHandler<unknown>;
+    error: MethodHandler<SupportedOutput>;
+    warn: MethodHandler<SupportedOutput>;
+    success: MethodHandler<SupportedOutput>;
+    info: MethodHandler<SupportedOutput>;
+    verbose: MethodHandler<SupportedOutput>;
+    debug: MethodHandler<SupportedOutput>;
 }>;
+/**
+ * The logger type produced by {@link createJsonLogger}.
+ */
 type JsonLogger = ReturnType<typeof createJsonLogger>;
 export { createJsonLogger, type JsonLogger };
 //# sourceMappingURL=jsonLogger.d.ts.map

package/dist/lib/jsonLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonLogger.d.ts","sourceRoot":"","sources":["../../src/lib/jsonLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,aAAa,EAEd,MAAM,UAAU,CAAA;AACjB,OAAO,EAIL,QAAQ,EAGT,MAAM,aAAa,CAAA;AAyCpB,KAAK,uBAAuB,GAAG;IAAE,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAEhE,iBAAS,gBAAgB,CAAC,EAAE,gBAA0C,EAAE,GAAE,uBAA4B;;;;;;;GAWrG;AAED,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAErD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,CAAA"}
+{"version":3,"file":"jsonLogger.d.ts","sourceRoot":"","sources":["../../src/lib/jsonLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,aAAa,EACb,eAAe,EAChB,MAAM,UAAU,CAAA;AACjB,OAAO,EAIL,QAAQ,EAGT,MAAM,aAAa,CAAA;AAyCpB,KAAK,uBAAuB,GAAG;IAAE,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,gBAAgB,CAAC,EAAE,gBAA0C,EAAE,GAAE,uBAA4B;;;;;;;GAWrG;AAED;;GAEG;AACH,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAErD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,CAAA"}

package/dist/lib/logLevels.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Severity levels supported by the loggers, ordered from most to least severe.
+ * Lower numeric values are more severe.
+ */
 declare enum LogLevel {
     Error = 0,
     Warn = 1,
@@ -6,8 +10,19 @@ declare enum LogLevel {
     Verbose = 4,
     Debug = 5
 }
+/**
+ * Every {@link LogLevel} in severity order. Useful for building a logger method
+ * per level.
+ */
 declare const allLogLevels: LogLevel[];
+/**
+ * Levels emitted by default by the logger presets: error, warn, success, and
+ * info. Verbose and debug are excluded.
+ */
 declare const defaultEnabledLogLevels: LogLevel[];
+/**
+ * Maps each {@link LogLevel} to its lowercase string label.
+ */
 declare const logLevelToLabel: {
     readonly 0: "error";
     readonly 1: "warn";
@@ -16,7 +31,17 @@ declare const logLevelToLabel: {
     readonly 4: "verbose";
     readonly 5: "debug";
 };
+/**
+ * Union of the lowercase string labels for every {@link LogLevel}.
+ */
 type LogLevelLabel = (typeof logLevelToLabel)[keyof typeof logLevelToLabel];
+/**
+ * Returns whether a given level is present in the list of enabled levels.
+ *
+ * @param logLevel - The level to test
+ * @param enabledLogLevels - The currently enabled levels
+ * @returns `true` when `logLevel` is enabled
+ */
 declare function isLogLevelEnabled(logLevel: LogLevel, enabledLogLevels: LogLevel[]): boolean;
 export { allLogLevels, defaultEnabledLogLevels, isLogLevelEnabled, LogLevel, logLevelToLabel };
 export type { LogLevelLabel };

package/dist/lib/logLevels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logLevels.d.ts","sourceRoot":"","sources":["../../src/lib/logLevels.ts"],"names":[],"mappings":"AAAA,aAAK,QAAQ;IACX,KAAK,IAAI;IACT,IAAI,IAAI;IACR,OAAO,IAAI;IACX,IAAI,IAAI;IACR,OAAO,IAAI;IACX,KAAK,IAAI;CACV;AAED,QAAA,MAAM,YAAY,YAAqG,CAAA;AAEvH,QAAA,MAAM,uBAAuB,YAAmE,CAAA;AAEhG,QAAA,MAAM,eAAe;;;;;;;CAOX,CAAA;AAEV,KAAK,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAE3E,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAE1E;AAED,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;AAC9F,YAAY,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"logLevels.d.ts","sourceRoot":"","sources":["../../src/lib/logLevels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,aAAK,QAAQ;IACX,KAAK,IAAI;IACT,IAAI,IAAI;IACR,OAAO,IAAI;IACX,IAAI,IAAI;IACR,OAAO,IAAI;IACX,KAAK,IAAI;CACV;AAED;;;GAGG;AACH,QAAA,MAAM,YAAY,YAAqG,CAAA;AAEvH;;;GAGG;AACH,QAAA,MAAM,uBAAuB,YAAmE,CAAA;AAEhG;;GAEG;AACH,QAAA,MAAM,eAAe;;;;;;;CAOX,CAAA;AAEV;;GAEG;AACH,KAAK,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAE3E;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAE1E;AAED,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;AAC9F,YAAY,EAAE,aAAa,EAAE,CAAA"}

package/dist/lib/logger.d.ts

@@ -1,26 +1,108 @@
-type SupportedOutput = boolean | number | object | string | unknown;
+/**
+ * The set of value types a logger method can accept and emit.
+ *
+ * The `unknown` member was intentionally dropped: a union containing `unknown`
+ * collapses to `unknown`, which silently widened every output type and defeated
+ * the generic inference the logger relies on. The remaining members cover every
+ * value the built-in loggers produce (strings, numbers, booleans, and arbitrary
+ * objects — including serialized `Error`s).
+ */
+type SupportedOutput = boolean | number | object | string;
+/**
+ * Default shape of the contextual data carried by a logger. Any object keyed by
+ * string is accepted; richer context types narrow this via the generic
+ * parameters on {@link Logger} and {@link createLogger}.
+ */
 type DefaultContext = Record<string, unknown>;
+/**
+ * A message that is computed lazily from the logger's current context. Receives
+ * the context and returns the value to log, so the value can depend on whatever
+ * context was attached via {@link Logger.withContext}.
+ *
+ * @template TContext - The context shape passed to the message factory
+ * @template TOutput - The value type the factory produces
+ */
 type ContextualLoggerMessage<TContext extends DefaultContext, TOutput = SupportedOutput> = (context: TContext) => TOutput;
+/**
+ * A single argument accepted by a log method: either a plain value to log or a
+ * {@link ContextualLoggerMessage} that derives the value from the context.
+ *
+ * @template TContext - The context shape available to contextual messages
+ * @template TOutput - The value type produced
+ */
 type LoggerMessage<TContext extends DefaultContext = DefaultContext, TOutput extends SupportedOutput = string> = ContextualLoggerMessage<TContext, TOutput> | TOutput;
+/**
+ * Call signature of a log method on a built logger. Accepts any number of
+ * messages (plain or contextual) and returns nothing.
+ *
+ * @template TContext - The context shape available to contextual messages
+ * @template TOutput - The value type each message produces
+ */
 interface LogMethod<TContext extends DefaultContext = DefaultContext, TOutput extends SupportedOutput = string> {
     (...messages: LoggerMessage<TContext, TOutput>[]): void;
 }
+/**
+ * Low-level handler backing a single log method. Unlike {@link LogMethod}, it
+ * receives the resolved context explicitly as its first argument, which is what
+ * lets middleware wrap and transform it.
+ *
+ * @template TOutput - The value type each message produces
+ */
 type MethodHandler<TOutput extends SupportedOutput = string> = (context: DefaultContext, ...messages: LoggerMessage<DefaultContext, TOutput>[]) => void;
+/**
+ * Map of method name to {@link MethodHandler}. This is the definition object
+ * passed to {@link createLogger} to describe the methods a logger exposes.
+ *
+ * @template TOutput - The value type each handler produces
+ */
 type MethodDefinitions<TOutput extends SupportedOutput = string> = Record<string, MethodHandler<TOutput>>;
 type MethodsFromDefinitions<TContext extends DefaultContext, TDefs extends MethodDefinitions<SupportedOutput>> = {
     [K in keyof TDefs]: TDefs[K] extends MethodHandler<infer TOutput> ? LogMethod<TContext, TOutput> : never;
 };
+/**
+ * A middleware wrapping a {@link MethodHandler}. Given the next handler in the
+ * chain, it returns a new handler, allowing it to transform the context or
+ * messages before (or after) delegating to `next`.
+ *
+ * @template TOutput - The value type the wrapped handler produces
+ */
 type Middleware<TOutput extends SupportedOutput = string> = (next: MethodHandler<TOutput>) => MethodHandler<TOutput>;
 type MiddlewaresFor<TDefs extends MethodDefinitions<SupportedOutput>> = {
     [K in keyof TDefs]?: TDefs[K] extends MethodHandler<infer TOutput> ? Middleware<TOutput> : never;
 };
+/**
+ * A fully built logger: every method from its definitions plus the
+ * {@link Logger.withMiddleware} and {@link Logger.withContext} combinators for
+ * deriving new loggers.
+ *
+ * @template TContext - The context shape carried by this logger
+ * @template TDefs - The method definitions backing this logger
+ */
 type Logger<TContext extends DefaultContext, TDefs extends MethodDefinitions<SupportedOutput>> = MethodsFromDefinitions<TContext, TDefs> & {
+    /**
+     * Returns a new logger whose listed methods are wrapped by the given
+     * middleware. Methods not listed are left untouched, and the original logger
+     * is not modified.
+     */
     withMiddleware: (middlewares: MiddlewaresFor<TDefs>) => Logger<TContext, TDefs>;
+    /**
+     * Returns a new logger with `context` merged into the existing context. The
+     * original logger is not modified, so derived loggers can be created freely.
+     */
     withContext: <TNewContext extends DefaultContext>(context: TNewContext) => Logger<TContext & TNewContext, TDefs>;
 };
 type ExtractMethodDefs<T> = {
     [K in keyof T as K extends "withContext" | "withMiddleware" ? never : T[K] extends LogMethod<DefaultContext, SupportedOutput> ? K : never]: T[K] extends LogMethod<DefaultContext, infer TOutput> ? MethodHandler<TOutput> : never;
 };
+/**
+ * Re-derives a logger's public shape for a given context from the logger type
+ * itself (rather than from its method definitions). Useful for typing values
+ * that hold an already-built logger while preserving its method signatures and
+ * the {@link Logger.withMiddleware} / {@link Logger.withContext} combinators.
+ *
+ * @template TContext - The context shape to expose
+ * @template TLogger - The source logger type to extract methods from
+ */
 type LoggerWithContext<TContext extends DefaultContext, TLogger> = {
     [K in keyof ExtractMethodDefs<TLogger>]: ExtractMethodDefs<TLogger>[K] extends MethodHandler<infer TOutput> ? LogMethod<TContext, TOutput> : never;
 } & {
@@ -29,7 +111,38 @@ type LoggerWithContext<TContext extends DefaultContext, TLogger> = {
     }) => LoggerWithContext<TContext, TLogger>;
     withContext: <TNewContext extends DefaultContext>(context: TNewContext) => LoggerWithContext<TContext & TNewContext, TLogger>;
 };
+/**
+ * Type guard that narrows a {@link LoggerMessage} to a
+ * {@link ContextualLoggerMessage}. Used by logger implementations to decide
+ * whether a message must be invoked with the context or logged as-is.
+ *
+ * @template TContext - The context shape available to contextual messages
+ * @template TOutput - The value type produced
+ * @param message - The message to inspect
+ * @returns `true` when the message is a context-consuming function
+ * @example
+ * ```typescript
+ * const resolved = isContextualMessage(message) ? message(context) : message
+ * ```
+ */
 declare function isContextualMessage<TContext extends DefaultContext, TOutput extends SupportedOutput>(message: LoggerMessage<TContext, TOutput>): message is ContextualLoggerMessage<TContext, TOutput>;
+/**
+ * Creates a logger from a map of method definitions. Each definition becomes a
+ * callable method on the returned logger, and the logger starts with an empty
+ * context that can be extended via {@link Logger.withContext}.
+ *
+ * @template TDefs - The method definitions backing the logger
+ * @param methods - Map of method name to its {@link MethodHandler}
+ * @returns A logger exposing the defined methods plus `withContext` and `withMiddleware`
+ * @example
+ * ```typescript
+ * const logger = createLogger({
+ *   info: (context, ...messages) => console.info(...messages),
+ * })
+ *
+ * logger.withContext({ requestId: "req-1" }).info("started")
+ * ```
+ */
 declare function createLogger<TDefs extends MethodDefinitions<SupportedOutput>>(methods: TDefs): Logger<{}, TDefs>;
 export { createLogger, isContextualMessage };
 export type { DefaultContext, Logger, LoggerMessage, LoggerWithContext, MethodHandler, SupportedOutput };

package/dist/lib/logger.d.ts.map

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

package/dist/lib/nestLogger.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Subset of the NestJS `LoggerService` interface implemented by
+ * {@link createNestJsonLogger}. Mirrors Nest's expected logger contract so the
+ * JSON logger can be passed directly to a Nest application.
+ */
 export interface LoggerService {
     log(message: any, ...optionalParams: any[]): any;
     error(message: any, ...optionalParams: any[]): any;
@@ -7,7 +12,23 @@ export interface LoggerService {
     fatal?(message: any, ...optionalParams: any[]): any;
     setLogLevels?(levels: any[]): any;
 }
+/**
+ * Creates a NestJS-compatible {@link LoggerService} that emits one JSON object
+ * per line to `process.stdout`. When the final optional parameter is a string,
+ * it is treated as Nest's `context` argument and recorded separately; remaining
+ * params are joined into the message, with `Error` values reduced to their
+ * message.
+ *
+ * @returns A logger implementing Nest's `log`/`error`/`warn`/`debug`/`verbose`/`fatal` methods
+ * @example
+ * ```typescript
+ * const app = await NestFactory.create(AppModule, { logger: createNestJsonLogger() })
+ * ```
+ */
 declare function createNestJsonLogger(): LoggerService;
+/**
+ * The logger type produced by {@link createNestJsonLogger}.
+ */
 type NestJsonLogger = ReturnType<typeof createNestJsonLogger>;
 export { createNestJsonLogger, type NestJsonLogger };
 //# sourceMappingURL=nestLogger.d.ts.map

package/dist/lib/nestLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nestLogger.d.ts","sourceRoot":"","sources":["../../src/lib/nestLogger.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAChD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAClD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACjD,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACnD,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACrD,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACnD,YAAY,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;CAClC;AAED,iBAAS,oBAAoB,IAAI,aAAa,CA8B7C;AAED,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE7D,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,CAAA"}
+{"version":3,"file":"nestLogger.d.ts","sourceRoot":"","sources":["../../src/lib/nestLogger.ts"],"names":[],"mappings":"AA2CA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAChD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IAClD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACjD,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACnD,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACrD,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACnD,YAAY,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,oBAAoB,IAAI,aAAa,CA8B7C;AAED;;GAEG;AACH,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE7D,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,CAAA"}

package/dist/{logger-Xwf0bgzB.js → logger-CFrlEist.js}

@@ -9,7 +9,7 @@ function c(e, a) {
   for (const n of Object.keys(t))
     Object.defineProperty(r, n, {
       value: (...o) => {
-        t[n](e, ...o);
+        t[n]?.(e, ...o);
       },
       enumerable: !0,
       configurable: !0

package/dist/logger-RyIBF1kr.cjs

@@ -0,0 +1 @@
+"use strict";function f(e){return typeof e=="function"}function g(e){return u({},e)}function u(e,a){const n={...a},r={};for(const t of Object.keys(n))Object.defineProperty(r,t,{value:(...o)=>{n[t]?.(e,...o)},enumerable:!0,configurable:!0});return r.withMiddleware=t=>{const o={...n};for(const s of Object.keys(t)){const c=t[s],i=n[s];c&&i&&(o[s]=c(i))}return u(e,o)},r.withContext=t=>u({...e,...t},n),r}exports.createLogger=g;exports.isContextualMessage=f;

package/dist/nest.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./logger-CSPbXuiG.cjs");function u(r,t){return[r,...t].map(o=>o instanceof Error?o.message:typeof o=="object"&&o!==null?JSON.stringify(o):String(o)).join(" ")}function f(r,t,e){const o=e.at(-1),s=typeof o=="string"?o:void 0,g=s!==void 0?e.slice(0,-1):e,a=u(t,g),i={level:r,timestamp:new Date().toISOString(),message:a,...s!==void 0?{context:s}:{}};process.stdout.write(JSON.stringify(i)+`
-`)}function n(r){return(t,...e)=>{const[o="",...s]=e;f(r,o,s)}}function l(){const r=c.createLogger({log:n("info"),error:n("error"),warn:n("warn"),debug:n("debug"),verbose:n("verbose"),fatal:n("fatal")});return{log(t,...e){r.log(t,...e)},error(t,...e){r.error(t,...e)},warn(t,...e){r.warn(t,...e)},debug(t,...e){r.debug(t,...e)},verbose(t,...e){r.verbose(t,...e)},fatal(t,...e){r.fatal(t,...e)}}}exports.createNestJsonLogger=l;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("./logger-RyIBF1kr.cjs");function n(r){return r}function f(r,t){return[r,...t].map(o=>o instanceof Error?o.message:typeof o=="object"&&o!==null?JSON.stringify(o):String(o)).join(" ")}function m(r,t,e){const o=e.at(-1),a=typeof o=="string"?o:void 0,g=a!==void 0?e.slice(0,-1):e,i=f(t,g),c={level:r,timestamp:new Date().toISOString(),message:i,...a!==void 0?{context:a}:{}};process.stdout.write(JSON.stringify(c)+`
+`)}function s(r){return(t,...e)=>{const[o="",...a]=e;m(r,o,a)}}function l(){const r=u.createLogger({log:s("info"),error:s("error"),warn:s("warn"),debug:s("debug"),verbose:s("verbose"),fatal:s("fatal")});return{log(t,...e){r.log(t,...e.map(n))},error(t,...e){r.error(t,...e.map(n))},warn(t,...e){r.warn(t,...e.map(n))},debug(t,...e){r.debug(t,...e.map(n))},verbose(t,...e){r.verbose(t,...e.map(n))},fatal(t,...e){r.fatal(t,...e.map(n))}}}exports.createNestJsonLogger=l;

package/dist/nest.js

@@ -1,53 +1,56 @@
-import { c } from "./logger-Xwf0bgzB.js";
-function f(t, r) {
-  return [t, ...r].map((o) => o instanceof Error ? o.message : typeof o == "object" && o !== null ? JSON.stringify(o) : String(o)).join(" ");
+import { c as u } from "./logger-CFrlEist.js";
+function o(r) {
+  return r;
 }
-function u(t, r, e) {
-  const o = e.at(-1), s = typeof o == "string" ? o : void 0, a = s !== void 0 ? e.slice(0, -1) : e, g = f(r, a), i = {
-    level: t,
+function f(r, e) {
+  return [r, ...e].map((n) => n instanceof Error ? n.message : typeof n == "object" && n !== null ? JSON.stringify(n) : String(n)).join(" ");
+}
+function m(r, e, t) {
+  const n = t.at(-1), a = typeof n == "string" ? n : void 0, g = a !== void 0 ? t.slice(0, -1) : t, i = f(e, g), c = {
+    level: r,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    message: g,
-    ...s !== void 0 ? { context: s } : {}
+    message: i,
+    ...a !== void 0 ? { context: a } : {}
   };
-  process.stdout.write(JSON.stringify(i) + `
+  process.stdout.write(JSON.stringify(c) + `
 `);
 }
-function n(t) {
-  return (r, ...e) => {
-    const [o = "", ...s] = e;
-    u(t, o, s);
+function s(r) {
+  return (e, ...t) => {
+    const [n = "", ...a] = t;
+    m(r, n, a);
   };
 }
-function m() {
-  const t = c({
-    log: n("info"),
-    error: n("error"),
-    warn: n("warn"),
-    debug: n("debug"),
-    verbose: n("verbose"),
-    fatal: n("fatal")
+function l() {
+  const r = u({
+    log: s("info"),
+    error: s("error"),
+    warn: s("warn"),
+    debug: s("debug"),
+    verbose: s("verbose"),
+    fatal: s("fatal")
   });
   return {
-    log(r, ...e) {
-      t.log(r, ...e);
+    log(e, ...t) {
+      r.log(e, ...t.map(o));
     },
-    error(r, ...e) {
-      t.error(r, ...e);
+    error(e, ...t) {
+      r.error(e, ...t.map(o));
     },
-    warn(r, ...e) {
-      t.warn(r, ...e);
+    warn(e, ...t) {
+      r.warn(e, ...t.map(o));
     },
-    debug(r, ...e) {
-      t.debug(r, ...e);
+    debug(e, ...t) {
+      r.debug(e, ...t.map(o));
     },
-    verbose(r, ...e) {
-      t.verbose(r, ...e);
+    verbose(e, ...t) {
+      r.verbose(e, ...t.map(o));
     },
-    fatal(r, ...e) {
-      t.fatal(r, ...e);
+    fatal(e, ...t) {
+      r.fatal(e, ...t.map(o));
     }
   };
 }
 export {
-  m as createNestJsonLogger
+  l as createNestJsonLogger
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leancodepl/logger",
-  "version": "10.4.0",
+  "version": "10.5.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",

package/dist/logger-CSPbXuiG.cjs

@@ -1 +0,0 @@
-"use strict";function f(e){return typeof e=="function"}function g(e){return u({},e)}function u(e,a){const n={...a},r={};for(const t of Object.keys(n))Object.defineProperty(r,t,{value:(...o)=>{n[t](e,...o)},enumerable:!0,configurable:!0});return r.withMiddleware=t=>{const o={...n};for(const s of Object.keys(t)){const c=t[s],i=n[s];c&&i&&(o[s]=c(i))}return u(e,o)},r.withContext=t=>u({...e,...t},n),r}exports.createLogger=g;exports.isContextualMessage=f;