@ayepi/log 0.4.1 → 0.5.0

package/README.md

@@ -29,7 +29,8 @@ Builds a record from mixed arguments:
 - object args are **merged** into the record;
 - `Error` args become `error` / `additionalErrors` (serialized with `name`, `message`,
   `stack`, recursive `cause`, own props) — and **any trace context attached to the error
-  is merged in** (so a caught error carries the context from where it was thrown);
+  is merged in** (so a caught error carries the context from where it was thrown); a string
+  `error` field becomes `{ name: 'Error', message }`;
 - emitted only if `level >= ` the configured threshold (`debug < info < warn < error`).
 
 ```ts

package/ayepi-log-errors-console.md

@@ -35,6 +35,12 @@ The first `Error` arg becomes the record's `error`; any further `Error` args bec
 `additionalErrors`. Non‑`Error` values become `{ name: 'NonError', message }` (the message
 is the string itself, or `String(value)`, guarded against unstringifiable values).
 
+An object arg's `error` field lands on the same reserved key when no `Error` arg took it, and
+is normalized to a `SerializedError` too: a string becomes `{ name: 'Error', message }` (so
+`log.warn('job.failed', { error: 'timed out' })` renders `error=Error: timed out`), a value
+that already has a string `name` and `message` is kept, and anything else is serialized as
+above. With an `Error` arg present, the field's value moves aside to `error2`.
+
 ```ts
 const e1 = new Error('first'); (e1 as { code?: string }).code = 'E1'
 const e2 = new TypeError('second')

package/ayepi-log-transports.md

@@ -63,7 +63,7 @@ const cap: Transport = { name: 'cap', write: (_r, text) => { line = text } }
 function consoleTransport(opts?: ConsoleTransportOptions): Transport
 
 interface ConsoleTransportOptions {
-  /** The console to write through — should be the original (pre-interception) console to avoid recursion. */
+  /** The console to write through (default the global console); its methods are bound when the transport is made. */
   readonly console?: ConsoleLike
   /** Map a record level to a console method (default: error→error, warn→warn, debug→debug, else→log). */
   readonly method?: (level: Level) => keyof ConsoleLike
@@ -82,6 +82,10 @@ Writes the pre‑formatted `text` to the level‑mapped console method. The defa
 method mapping is `error → error`, `warn → warn`, `debug → debug`, everything else →
 `log`.
 
+The console's methods are bound when `consoleTransport()` is called, so a transport made
+before `interceptConsole()` keeps writing to the original methods afterwards, and no line
+loops back into the logger.
+
 The default logger's default transport is a `consoleTransport` bound to the **captured
 original** console (taken before any interception is installed), so logs aren't recursed
 even when console interception is on. If `globalThis.console` is absent it falls back to a

package/dist/index.cjs

@@ -33,9 +33,12 @@ const noopConsole = {
 };
 const globalConsole = () => globalThis.console ?? noopConsole;
 const defaultMethod = (level) => level === "error" ? "error" : level === "warn" ? "warn" : level === "debug" ? "debug" : "log";
-/** A {@link Transport} that writes the formatted line to a console. */
+/**
+* A {@link Transport} that writes the formatted line to a console. The console's methods are captured when the
+* transport is made, so make it before intercepting the console.
+*/
 function consoleTransport(opts = {}) {
-	const target = opts.console ?? globalConsole();
+	const target = captureConsole(opts.console ?? globalConsole());
 	const pick = opts.method ?? defaultMethod;
 	return {
 		name: "console",

package/dist/index.d.cts

@@ -12,12 +12,18 @@ interface ConsoleLike {
 }
 /** Options for {@link consoleTransport}. */
 interface ConsoleTransportOptions {
-  /** The console to **write through** — should be the original (pre-interception) console to avoid recursion. */
+  /**
+   * The console to write through (default the global `console`). Its methods are bound when the transport is made,
+   * so a later `interceptConsole()` that replaces them never feeds a line back into the logger.
+   */
   readonly console?: ConsoleLike;
   /** Map a record level to a console method (default: error→error, warn→warn, debug→debug, else→log). */
   readonly method?: (level: Level) => keyof ConsoleLike;
 }
-/** A {@link Transport} that writes the formatted line to a console. */
+/**
+ * A {@link Transport} that writes the formatted line to a console. The console's methods are captured when the
+ * transport is made, so make it before intercepting the console.
+ */
 declare function consoleTransport(opts?: ConsoleTransportOptions): Transport;
 /** Configuration for {@link createLogger}. */
 interface LoggerConfig {

package/dist/index.d.ts

@@ -12,12 +12,18 @@ interface ConsoleLike {
 }
 /** Options for {@link consoleTransport}. */
 interface ConsoleTransportOptions {
-  /** The console to **write through** — should be the original (pre-interception) console to avoid recursion. */
+  /**
+   * The console to write through (default the global `console`). Its methods are bound when the transport is made,
+   * so a later `interceptConsole()` that replaces them never feeds a line back into the logger.
+   */
   readonly console?: ConsoleLike;
   /** Map a record level to a console method (default: error→error, warn→warn, debug→debug, else→log). */
   readonly method?: (level: Level) => keyof ConsoleLike;
 }
-/** A {@link Transport} that writes the formatted line to a console. */
+/**
+ * A {@link Transport} that writes the formatted line to a console. The console's methods are captured when the
+ * transport is made, so make it before intercepting the console.
+ */
 declare function consoleTransport(opts?: ConsoleTransportOptions): Transport;
 /** Configuration for {@link createLogger}. */
 interface LoggerConfig {

package/dist/index.js

@@ -32,9 +32,12 @@ const noopConsole = {
 };
 const globalConsole = () => globalThis.console ?? noopConsole;
 const defaultMethod = (level) => level === "error" ? "error" : level === "warn" ? "warn" : level === "debug" ? "debug" : "log";
-/** A {@link Transport} that writes the formatted line to a console. */
+/**
+* A {@link Transport} that writes the formatted line to a console. The console's methods are captured when the
+* transport is made, so make it before intercepting the console.
+*/
 function consoleTransport(opts = {}) {
-	const target = opts.console ?? globalConsole();
+	const target = captureConsole(opts.console ?? globalConsole());
 	const pick = opts.method ?? defaultMethod;
 	return {
 		name: "console",

package/dist/internal.cjs

@@ -269,8 +269,27 @@ function buildRecord(level, args, opts) {
 	record = merge(record, getContext());
 	for (const o of objects) record = merge(record, o);
 	for (const c of errorContexts) record = merge(record, c);
+	if (record.error !== void 0) record.error = asSerializedError(record.error);
 	return record;
 }
+/** Whether `v` already has the {@link SerializedError} shape (a string `name` and `message`). */
+function isSerializedError(v) {
+	if (v === null || typeof v !== "object") return false;
+	const o = v;
+	return typeof o.name === "string" && typeof o.message === "string";
+}
+/**
+* Normalize whatever landed on the reserved `error` key (an `Error` arg, or a field such as
+* `{ error: 'timed out' }`) to a {@link SerializedError}: a string becomes `{ name: 'Error', message }`,
+* an already serialized shape is kept, and anything else goes through {@link serializeError}.
+*/
+function asSerializedError(v) {
+	if (typeof v === "string") return {
+		name: "Error",
+		message: v
+	};
+	return !(v instanceof Error) && isSerializedError(v) ? v : serializeError(v);
+}
 const renderValue = (v) => {
 	if (typeof v === "string") return v;
 	if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint") return String(v);

package/dist/internal.js

@@ -269,8 +269,27 @@ function buildRecord(level, args, opts) {
 	record = merge(record, getContext());
 	for (const o of objects) record = merge(record, o);
 	for (const c of errorContexts) record = merge(record, c);
+	if (record.error !== void 0) record.error = asSerializedError(record.error);
 	return record;
 }
+/** Whether `v` already has the {@link SerializedError} shape (a string `name` and `message`). */
+function isSerializedError(v) {
+	if (v === null || typeof v !== "object") return false;
+	const o = v;
+	return typeof o.name === "string" && typeof o.message === "string";
+}
+/**
+* Normalize whatever landed on the reserved `error` key (an `Error` arg, or a field such as
+* `{ error: 'timed out' }`) to a {@link SerializedError}: a string becomes `{ name: 'Error', message }`,
+* an already serialized shape is kept, and anything else goes through {@link serializeError}.
+*/
+function asSerializedError(v) {
+	if (typeof v === "string") return {
+		name: "Error",
+		message: v
+	};
+	return !(v instanceof Error) && isSerializedError(v) ? v : serializeError(v);
+}
 const renderValue = (v) => {
 	if (typeof v === "string") return v;
 	if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint") return String(v);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ayepi/log",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Structured logging for ayepi — AsyncLocalStorage trace context, console interception, console/file transports, error serialization, middleware",
   "license": "MIT",
   "publishConfig": {
@@ -68,7 +68,7 @@
     "node": ">=18"
   },
   "peerDependencies": {
-    "@ayepi/core": "^0.4.1"
+    "@ayepi/core": "^0.5.0"
   },
   "peerDependenciesMeta": {
     "@ayepi/core": {
@@ -80,8 +80,8 @@
     "publint": "^0.3.0",
     "tsdown": "^0.12.0",
     "vitest": "^2.1.8",
-    "zod": "^4.4.3",
-    "@ayepi/core": "0.4.1"
+    "zod": "^4.6.7",
+    "@ayepi/core": "0.5.0"
   },
   "keywords": [
     "ayepi",