@zudojs/logger 1.4.3 → 1.5.0

package/README.md

@@ -28,6 +28,34 @@ logger.error("Connection failed", { error: err.message });
 await logger.flush(); // drain in-flight writes before exit
 ```
 
+## Logging errors
+
+```typescript
+logger.log(LoggerLevel.ERROR, "payment failed", {
+  error: err,
+  metadata: { orderId },
+}); // typed: err is the entry's `error`, stack included
+
+logger.error("payment failed", { err }); // err becomes plain data in metadata
+```
+
+The level methods take `(message, metadata?)`. In JavaScript, or loosely
+typed TypeScript, `logger.error("payment failed", err)` also works at
+runtime — the `Error` is recorded as the entry's `error` — but that call
+does not type-check; the typed way to attach an error is
+`log(level, message, { error, metadata })`. (The signature is kept single
+on purpose: an overload or a widened union broke custom `Logger`
+implementations and structural logger types.)
+
+An `Error` placed _inside_ metadata or context (`{ err }`, `{ cause: err }`,
+nested anywhere) is normalized when the entry is built into
+`{ name, message, stack, ...ownFields, cause }`, with secret-named own
+fields redacted and a self-referential `cause` shown as `"[Circular]"`, so
+a custom transport that stringifies `entry.metadata` sees the error rather
+than `{}`. `isLogErrorValue(value)` tells such an object apart from
+ordinary metadata; the text formatter's `includeStackTrace: false` still
+leaves its `stack` out.
+
 ## Levels
 
 `fatal` (0), `error` (1), `warn` (2), `info` (3), `debug` (4), `trace`
@@ -159,6 +187,12 @@ createLogger({ redact: { enabled: false } }); // same as redact: false
 `replacement`). `true` or omitting it keeps the default. Child loggers inherit
 the parent's setting.
 
+This is `@zudojs/logger`'s own redaction and it needs no setup.
+`@zudojs/core`'s `ConsoleLogger` is a different logger with a different
+mechanism — a `createLogRedactor()` hook with its own key list — and this
+package has no `createLogRedactor`. If an application uses both, configure
+each; a key added to one is not redacted by the other.
+
 ## Log injection
 
 Text-shaped formatters escape control characters (C0, DEL, C1 and

package/dist/index.d.ts

@@ -13,4 +13,3 @@ export * from "./loggerErrors/index.js";
 export * from "./loggerManager/index.js";
 export * from "./loggerFactory/index.js";
 export * from "./loggerLevel/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -23,4 +23,3 @@ export * from "./loggerManager/index.js";
 export * from "./loggerFactory/index.js";
 // Level
 export * from "./loggerLevel/index.js";
-//# sourceMappingURL=index.js.map

package/dist/loggerContext/index.d.ts

@@ -6,4 +6,3 @@
 export * from "./loggerContext.type.js";
 export * from "./loggerContext.core.js";
 export * from "./loggerContextStorage.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/loggerContext/index.js

@@ -6,4 +6,3 @@
 export * from "./loggerContext.type.js";
 export * from "./loggerContext.core.js";
 export * from "./loggerContextStorage.js";
-//# sourceMappingURL=index.js.map

package/dist/loggerContext/loggerContext.core.d.ts

@@ -5,4 +5,3 @@ export type { LoggerContextValue, LoggerContextData, LoggerContextIdentifiers, L
 export { createLoggerContextStorage } from "./loggerContextStorage.js";
 export { createLoggerContextId, createLoggerContext, createEmptyLoggerContext, mergeLoggerContexts, withLoggerContext, withLoggerIdentifiers, } from "./loggerContextCreate.js";
 export { contextToLogMetadata, serializeLoggerContext, isLoggerContext, getCurrentLoggerContextMetadata, } from "./loggerContextSerialize.js";
-//# sourceMappingURL=loggerContext.core.d.ts.map

package/dist/loggerContext/loggerContext.core.js

@@ -4,4 +4,3 @@
 export { createLoggerContextStorage } from "./loggerContextStorage.js";
 export { createLoggerContextId, createLoggerContext, createEmptyLoggerContext, mergeLoggerContexts, withLoggerContext, withLoggerIdentifiers, } from "./loggerContextCreate.js";
 export { contextToLogMetadata, serializeLoggerContext, isLoggerContext, getCurrentLoggerContextMetadata, } from "./loggerContextSerialize.js";
-//# sourceMappingURL=loggerContext.core.js.map

package/dist/loggerContext/loggerContext.type.d.ts

@@ -85,4 +85,3 @@ export interface LoggerSource {
     readonly column?: number;
     readonly function?: string;
 }
-//# sourceMappingURL=loggerContext.type.d.ts.map

package/dist/loggerContext/loggerContext.type.js

@@ -2,4 +2,3 @@
  * Logger context types.
  */
 export {};
-//# sourceMappingURL=loggerContext.type.js.map

package/dist/loggerContext/loggerContextCreate.d.ts

@@ -28,4 +28,3 @@ export declare function withLoggerContext(context: LoggerContext, metadata: Logg
  * Extends a logger context with identifiers.
  */
 export declare function withLoggerIdentifiers(context: LoggerContext, identifiers: LoggerContextIdentifiers): LoggerContext;
-//# sourceMappingURL=loggerContextCreate.d.ts.map

package/dist/loggerContext/loggerContextCreate.js

@@ -83,4 +83,3 @@ export function withLoggerIdentifiers(context, identifiers) {
         ...identifiers,
     });
 }
-//# sourceMappingURL=loggerContextCreate.js.map

package/dist/loggerContext/loggerContextSerialize.d.ts

@@ -21,4 +21,3 @@ export declare function isLoggerContext(value: unknown): value is LoggerContext;
  * Creates a context-aware metadata object.
  */
 export declare function getCurrentLoggerContextMetadata(storage: LoggerContextStorage): LogMetadata;
-//# sourceMappingURL=loggerContextSerialize.d.ts.map

package/dist/loggerContext/loggerContextSerialize.js

@@ -48,4 +48,3 @@ export function getCurrentLoggerContextMetadata(storage) {
     }
     return contextToLogMetadata(context);
 }
-//# sourceMappingURL=loggerContextSerialize.js.map

package/dist/loggerContext/loggerContextStorage.d.ts

@@ -10,4 +10,3 @@ import type { LoggerContextStorage } from "./loggerContext.core.js";
  * Node-specific dependencies.
  */
 export declare function createLoggerContextStorage(): LoggerContextStorage;
-//# sourceMappingURL=loggerContextStorage.d.ts.map

package/dist/loggerContext/loggerContextStorage.js

@@ -42,4 +42,3 @@ export function createLoggerContextStorage() {
         },
     };
 }
-//# sourceMappingURL=loggerContextStorage.js.map

package/dist/loggerCore/core/index.d.ts

@@ -6,4 +6,3 @@
 export * from "./loggerCore.type.js";
 export * from "./loggerCore.core.js";
 export * from "./loggerCore.context.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/loggerCore/core/index.js

@@ -6,4 +6,3 @@
 export * from "./loggerCore.type.js";
 export * from "./loggerCore.core.js";
 export * from "./loggerCore.context.js";
-//# sourceMappingURL=index.js.map

package/dist/loggerCore/core/loggerCore.context.d.ts

@@ -39,4 +39,3 @@ export declare class ContextLogger implements Logger {
     close(): Promise<void>;
     private run;
 }
-//# sourceMappingURL=loggerCore.context.d.ts.map

package/dist/loggerCore/core/loggerCore.context.js

@@ -79,4 +79,3 @@ export class ContextLogger {
         this.storage.run(this.context, callback);
     }
 }
-//# sourceMappingURL=loggerCore.context.js.map

package/dist/loggerCore/core/loggerCore.core.d.ts

@@ -75,4 +75,3 @@ export declare class ZudojsLogger implements Logger, ZudojsLoggerContext {
  * Creates a Zudojs logger.
  */
 export declare function createLogger(options?: LoggerOptions): Logger;
-//# sourceMappingURL=loggerCore.core.d.ts.map

package/dist/loggerCore/core/loggerCore.core.js

@@ -169,4 +169,3 @@ export class ZudojsLogger {
 export function createLogger(options = {}) {
     return new ZudojsLogger(options);
 }
-//# sourceMappingURL=loggerCore.core.js.map

package/dist/loggerCore/core/loggerCore.type.d.ts

@@ -37,4 +37,3 @@ export interface Logger {
     flush(): Promise<void>;
     close(): Promise<void>;
 }
-//# sourceMappingURL=loggerCore.type.d.ts.map

package/dist/loggerCore/core/loggerCore.type.js

@@ -2,4 +2,3 @@
  * Logger core types and interfaces.
  */
 export {};
-//# sourceMappingURL=loggerCore.type.js.map

package/dist/loggerCore/helpers/index.d.ts

@@ -8,4 +8,3 @@ export * from "./loggerCoreHelpers.js";
 export * from "./loggerCoreMethods.loggerProps.js";
 export * from "./loggerCoreMethods.logLevels.js";
 export * from "./loggerCoreMethods/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/loggerCore/helpers/index.js

@@ -8,4 +8,3 @@ export * from "./loggerCoreHelpers.js";
 export * from "./loggerCoreMethods.loggerProps.js";
 export * from "./loggerCoreMethods.logLevels.js";
 export * from "./loggerCoreMethods/index.js";
-//# sourceMappingURL=index.js.map

package/dist/loggerCore/helpers/loggerCore.helper.d.ts

@@ -26,4 +26,3 @@ export declare function withLoggerContext<T>(logger: Logger, context: LoggerCont
  * Creates a default application logger.
  */
 export declare function createDefaultLogger(name?: string): Logger;
-//# sourceMappingURL=loggerCore.helper.d.ts.map

package/dist/loggerCore/helpers/loggerCore.helper.js

@@ -45,4 +45,3 @@ export function createDefaultLogger(name = "zudojs") {
         transports: [createConsoleLoggerTransport()],
     });
 }
-//# sourceMappingURL=loggerCore.helper.js.map

package/dist/loggerCore/helpers/loggerCoreHelpers.d.ts

@@ -18,4 +18,3 @@ export declare function assertMutable(mutable: boolean): void;
  * Handles infrastructure errors (transport/formatter errors).
  */
 export declare function handleInfrastructureError(throwTransportErrors: boolean, error: Error): void;
-//# sourceMappingURL=loggerCoreHelpers.d.ts.map

package/dist/loggerCore/helpers/loggerCoreHelpers.js

@@ -50,4 +50,3 @@ export function handleInfrastructureError(throwTransportErrors, error) {
         throw error;
     }
 }
-//# sourceMappingURL=loggerCoreHelpers.js.map

package/dist/loggerCore/helpers/loggerCoreMethods/index.d.ts

@@ -8,4 +8,3 @@ export { dispatchEntry, dispatchEntrySync, } from "./loggerCoreMethods.dispatch.
 export { logAtLevel, levelOptions } from "./loggerCoreMethods.level.js";
 export { childLogger, withContextLogger } from "./loggerCoreMethods.child.js";
 export { setLoggerLevel, enableLogger, disableLogger, flushLogger, closeLogger, } from "./loggerCoreMethods.lifecycle.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods/index.js

@@ -8,4 +8,3 @@ export { dispatchEntry, dispatchEntrySync, } from "./loggerCoreMethods.dispatch.
 export { logAtLevel, levelOptions } from "./loggerCoreMethods.level.js";
 export { childLogger, withContextLogger } from "./loggerCoreMethods.child.js";
 export { setLoggerLevel, enableLogger, disableLogger, flushLogger, closeLogger, } from "./loggerCoreMethods.lifecycle.js";
-//# sourceMappingURL=index.js.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.child.d.ts

@@ -13,4 +13,3 @@ export declare function childLogger(ctx: ZudojsLoggerContext, options?: ChildLog
  * Creates a logger with scoped context.
  */
 export declare function withContextLogger(ctx: ZudojsLoggerContext, context: LoggerContext): Logger;
-//# sourceMappingURL=loggerCoreMethods.child.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.child.js

@@ -21,4 +21,3 @@ export function withContextLogger(ctx, context) {
     // scope THAT storage for the context to reach created entries.
     return new ContextLogger(child, context, ctx.contextStorage);
 }
-//# sourceMappingURL=loggerCoreMethods.child.js.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.dispatch.d.ts

@@ -18,4 +18,3 @@ export declare function dispatchEntry(configuration: LoggerConfiguration, entry:
  * both settings behaved identically.
  */
 export declare function dispatchEntrySync(configuration: LoggerConfiguration, entry: LoggerEntry, handleError: (error: Error) => void): void | Promise<void>;
-//# sourceMappingURL=loggerCoreMethods.dispatch.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.dispatch.js

@@ -228,4 +228,3 @@ export function dispatchEntrySync(configuration, entry, handleError) {
     }
     return Promise.all(pending).then(() => undefined);
 }
-//# sourceMappingURL=loggerCoreMethods.dispatch.js.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.entry.d.ts

@@ -15,4 +15,3 @@ import type { LoggerConfiguration, LogOptions } from "../../../loggerOptions/log
 export declare function createEntry(configuration: LoggerConfiguration, contextStorage: {
     get(): import("../../../loggerContext/loggerContext.core.js").LoggerContext | undefined;
 }, level: LoggerLevel, message: string, options: LogOptions, onMetadataError?: (key: string, error: unknown) => void): LoggerEntry;
-//# sourceMappingURL=loggerCoreMethods.entry.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.entry.js

@@ -62,4 +62,3 @@ export function createEntry(configuration, contextStorage, level, message, optio
     };
     return createLoggerEntry(input);
 }
-//# sourceMappingURL=loggerCoreMethods.entry.js.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.level.d.ts

@@ -15,4 +15,3 @@ export declare function levelOptions(metadata: LogOptions["metadata"] | undefine
  * Level logging methods extracted from ZudojsLogger.
  */
 export declare function logAtLevel(ctx: ZudojsLoggerContext, level: LoggerLevel, message: string, options?: LogOptions): void;
-//# sourceMappingURL=loggerCoreMethods.level.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.level.js

@@ -60,4 +60,3 @@ export function logAtLevel(ctx, level, message, options = {}) {
         ctx.handleInfrastructureError(failure);
     }
 }
-//# sourceMappingURL=loggerCoreMethods.level.js.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.lifecycle.d.ts

@@ -32,4 +32,3 @@ export declare function flushLogger(ctx: ZudojsLoggerContext): Promise<void>;
  * the failures are rethrown afterwards.
  */
 export declare function closeLogger(ctx: ZudojsLoggerContext): Promise<void>;
-//# sourceMappingURL=loggerCoreMethods.lifecycle.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods/loggerCoreMethods.lifecycle.js

@@ -116,4 +116,3 @@ export async function closeLogger(ctx) {
     }
     throwCollectedFailures(failures, "Logger close failed.");
 }
-//# sourceMappingURL=loggerCoreMethods.lifecycle.js.map

package/dist/loggerCore/helpers/loggerCoreMethods.logLevels.d.ts

@@ -17,4 +17,3 @@ export declare function createLogMethods(ctx: ZudojsLoggerContext): {
     trace: (message: string, metadata?: LogMetadata) => void;
     log: (level: LoggerLevel, message: string, options?: LogOptions) => void;
 };
-//# sourceMappingURL=loggerCoreMethods.logLevels.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods.logLevels.js

@@ -17,4 +17,3 @@ export function createLogMethods(ctx) {
         log: (level, message, options) => logAtLevel(ctx, level, message, options),
     };
 }
-//# sourceMappingURL=loggerCoreMethods.logLevels.js.map

package/dist/loggerCore/helpers/loggerCoreMethods.loggerProps.d.ts

@@ -15,4 +15,3 @@ export declare function getLoggerLevel(ctx: ZudojsLoggerContext): LoggerLevel;
  * Gets whether the logger is enabled.
  */
 export declare function getLoggerEnabled(ctx: ZudojsLoggerContext): boolean;
-//# sourceMappingURL=loggerCoreMethods.loggerProps.d.ts.map

package/dist/loggerCore/helpers/loggerCoreMethods.loggerProps.js

@@ -22,4 +22,3 @@ export function getLoggerLevel(ctx) {
 export function getLoggerEnabled(ctx) {
     return !ctx.isDisposed() && ctx.configuration.enabled;
 }
-//# sourceMappingURL=loggerCoreMethods.loggerProps.js.map

package/dist/loggerCore/index.d.ts

@@ -5,4 +5,3 @@
  */
 export * from "./core/index.js";
 export * from "./helpers/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/loggerCore/index.js

@@ -5,4 +5,3 @@
  */
 export * from "./core/index.js";
 export * from "./helpers/index.js";
-//# sourceMappingURL=index.js.map

package/dist/loggerEntry/index.d.ts

@@ -6,4 +6,3 @@
 export * from "./loggerEntryHelpers/index.js";
 export * from "./loggerEntry.core.js";
 export { DEFAULT_LOGGER_SECRET_FIELDS, createDefaultSecretFieldMatcher, } from "./loggerEntry.secretFields.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/loggerEntry/index.js

@@ -6,4 +6,3 @@
 export * from "./loggerEntryHelpers/index.js";
 export * from "./loggerEntry.core.js";
 export { DEFAULT_LOGGER_SECRET_FIELDS, createDefaultSecretFieldMatcher, } from "./loggerEntry.secretFields.js";
-//# sourceMappingURL=index.js.map

package/dist/loggerEntry/loggerEntry.core.d.ts

@@ -16,4 +16,3 @@ export declare function normalizeLogMetadata(value: unknown): LogMetadata;
  * Creates a LoggerEntry from an Error.
  */
 export declare function createErrorLoggerEntry(error: Error, level: LoggerLevel, message?: string, metadata?: LogMetadata): LoggerEntry;
-//# sourceMappingURL=loggerEntry.core.d.ts.map

package/dist/loggerEntry/loggerEntry.core.js

@@ -42,4 +42,3 @@ export function createErrorLoggerEntry(error, level, message, metadata) {
         error,
     });
 }
-//# sourceMappingURL=loggerEntry.core.js.map

package/dist/loggerEntry/loggerEntry.secretFields.d.ts

@@ -16,4 +16,3 @@ export declare const DEFAULT_LOGGER_SECRET_FIELDS: readonly string[];
  * Builds the default secret-field predicate from a word list.
  */
 export declare function createDefaultSecretFieldMatcher(fields?: readonly string[]): (key: string) => boolean;
-//# sourceMappingURL=loggerEntry.secretFields.d.ts.map

package/dist/loggerEntry/loggerEntry.secretFields.js

@@ -87,4 +87,3 @@ export function createDefaultSecretFieldMatcher(fields = DEFAULT_LOGGER_SECRET_F
         return SUBSTRING_SECRET_WORDS.some((word) => compact.includes(word));
     };
 }
-//# sourceMappingURL=loggerEntry.secretFields.js.map

package/dist/loggerEntry/loggerEntry.type.d.ts

@@ -5,4 +5,3 @@
  * types from their new location.
  */
 export type { LogValue, LogMetadata, LoggerSource, LoggerEntryContext, LoggerEntry, LoggerEntryInput, } from "./loggerEntryHelpers/index.js";
-//# sourceMappingURL=loggerEntry.type.d.ts.map

package/dist/loggerEntry/loggerEntry.type.js

@@ -5,4 +5,3 @@
  * types from their new location.
  */
 export {};
-//# sourceMappingURL=loggerEntry.type.js.map

package/dist/loggerEntry/loggerEntryCreate.d.ts

@@ -6,4 +6,3 @@ import type { LoggerEntry, LoggerEntryInput } from "./loggerEntry.type.js";
  * Creates a normalized LoggerEntry.
  */
 export declare function createLoggerEntry(input: LoggerEntryInput): LoggerEntry;
-//# sourceMappingURL=loggerEntryCreate.d.ts.map

package/dist/loggerEntry/loggerEntryCreate.js

@@ -38,4 +38,3 @@ export function createLoggerEntry(input) {
         environment: input.environment,
     });
 }
-//# sourceMappingURL=loggerEntryCreate.js.map

package/dist/loggerEntry/loggerEntryHelpers/index.d.ts

@@ -6,6 +6,5 @@
 export type { LogValue, LogMetadata, LoggerSource, LoggerEntryContext, } from "./loggerEntryHelpers.types.js";
 export type { LoggerEntry, LoggerEntryInput, } from "./loggerEntryHelpers.interfaces.js";
 export { serializeLoggerEntry, serializeLoggerError, serializeLoggerValue, loggerLevelNameFallback, } from "./loggerEntryHelpers.serialize.js";
-export { LOGGER_REDACTION_TOKEN, LOGGER_UNREADABLE_TOKEN, DEFAULT_LOGGER_SECRET_PATTERN, escapeLogText, hasLogControlCharacters, createSecretMatcher, redactLogValue, } from "./loggerEntryHelpers.sanitize.js";
-export type { LoggerRedactionOptions } from "./loggerEntryHelpers.sanitize.js";
-//# sourceMappingURL=index.d.ts.map
+export { LOGGER_ERROR_VALUE, LOGGER_REDACTION_TOKEN, LOGGER_UNREADABLE_TOKEN, DEFAULT_LOGGER_SECRET_PATTERN, escapeLogText, hasLogControlCharacters, createSecretMatcher, isLogErrorValue, redactLogValue, } from "./loggerEntryHelpers.sanitize.js";
+export type { LogErrorValue, LoggerRedactionOptions, } from "./loggerEntryHelpers.sanitize.js";

package/dist/loggerEntry/loggerEntryHelpers/index.js

@@ -4,5 +4,4 @@
  * Logger entry helper types and utilities.
  */
 export { serializeLoggerEntry, serializeLoggerError, serializeLoggerValue, loggerLevelNameFallback, } from "./loggerEntryHelpers.serialize.js";
-export { LOGGER_REDACTION_TOKEN, LOGGER_UNREADABLE_TOKEN, DEFAULT_LOGGER_SECRET_PATTERN, escapeLogText, hasLogControlCharacters, createSecretMatcher, redactLogValue, } from "./loggerEntryHelpers.sanitize.js";
-//# sourceMappingURL=index.js.map
+export { LOGGER_ERROR_VALUE, LOGGER_REDACTION_TOKEN, LOGGER_UNREADABLE_TOKEN, DEFAULT_LOGGER_SECRET_PATTERN, escapeLogText, hasLogControlCharacters, createSecretMatcher, isLogErrorValue, redactLogValue, } from "./loggerEntryHelpers.sanitize.js";

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.interfaces.d.ts

@@ -92,4 +92,3 @@ export interface LoggerEntryInput {
     readonly hostname?: string;
     readonly environment?: string;
 }
-//# sourceMappingURL=loggerEntryHelpers.interfaces.d.ts.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.interfaces.js

@@ -2,4 +2,3 @@
  * Logger entry interfaces.
  */
 export {};
-//# sourceMappingURL=loggerEntryHelpers.interfaces.js.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.sanitize.d.ts

@@ -69,6 +69,24 @@ export declare function hasLogControlCharacters(value: string): boolean;
  * Builds a predicate deciding whether a field name holds a secret.
  */
 export declare function createSecretMatcher(options?: LoggerRedactionOptions): (key: string) => boolean;
+/**
+ * Marks a plain object that {@link redactLogValue} produced from an
+ * `Error`, so a serializer can still tell it apart from ordinary metadata
+ * (the text formatter leaves its `stack` out when `includeStackTrace` is
+ * off). The property is a non-enumerable symbol: `JSON.stringify`, spreads
+ * and `Object.keys` never see it.
+ */
+export declare const LOGGER_ERROR_VALUE: unique symbol;
+/** A normalized `Error` as it appears inside entry metadata and context. */
+export interface LogErrorValue {
+    readonly name: string;
+    readonly message: string;
+    readonly stack?: string;
+    readonly cause?: unknown;
+    readonly [key: string]: unknown;
+}
+/** True when `value` is an `Error` normalized by {@link redactLogValue}. */
+export declare function isLogErrorValue(value: unknown): value is LogErrorValue;
 /**
  * Recursively replaces secret-named fields with a redaction token.
  *
@@ -83,4 +101,3 @@ export declare function createSecretMatcher(options?: LoggerRedactionOptions): (
  * object merely referenced twice in one payload is logged both times.
  */
 export declare function redactLogValue(value: unknown, isSecret: (key: string) => boolean, replacement?: string, seen?: WeakSet<object>, onReadError?: (key: string, error: unknown) => void): unknown;
-//# sourceMappingURL=loggerEntryHelpers.sanitize.d.ts.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.sanitize.js

@@ -105,6 +105,48 @@ function defineLogProperty(target, key, value) {
         configurable: true,
     });
 }
+/**
+ * Marks a plain object that {@link redactLogValue} produced from an
+ * `Error`, so a serializer can still tell it apart from ordinary metadata
+ * (the text formatter leaves its `stack` out when `includeStackTrace` is
+ * off). The property is a non-enumerable symbol: `JSON.stringify`, spreads
+ * and `Object.keys` never see it.
+ */
+export const LOGGER_ERROR_VALUE = Symbol.for("zudojs.logger.errorValue");
+/** True when `value` is an `Error` normalized by {@link redactLogValue}. */
+export function isLogErrorValue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[LOGGER_ERROR_VALUE] === true);
+}
+/**
+ * Copies an `Error` into a plain object: `name`, `message` and `stack`
+ * first (they are non-enumerable on the error itself, which is why a
+ * stringified error is `{}`), then its own enumerable fields with their
+ * descriptors intact so a getter is still read by the redaction walk, then
+ * `cause`. The walk redacts and descends into all of them.
+ */
+function errorToPlainObject(error) {
+    const plain = {};
+    defineLogProperty(plain, "name", error.name);
+    defineLogProperty(plain, "message", error.message);
+    if (typeof error.stack === "string") {
+        defineLogProperty(plain, "stack", error.stack);
+    }
+    for (const key of Object.keys(error)) {
+        if (Object.hasOwn(plain, key))
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(error, key);
+        if (descriptor)
+            Object.defineProperty(plain, key, descriptor);
+    }
+    if (!Object.hasOwn(plain, "cause") &&
+        "cause" in error &&
+        error.cause !== undefined) {
+        defineLogProperty(plain, "cause", error.cause);
+    }
+    return plain;
+}
 /**
  * Recursively replaces secret-named fields with a redaction token.
  *
@@ -122,12 +164,27 @@ export function redactLogValue(value, isSecret, replacement = LOGGER_REDACTION_T
     if (value === null || typeof value !== "object") {
         return value;
     }
-    if (value instanceof Date || value instanceof Error) {
+    if (value instanceof Date) {
         return value;
     }
     if (seen.has(value)) {
         return "[Circular]";
     }
+    // An Error keeps name/message/stack non-enumerable, so a transport that
+    // stringified `entry.metadata` saw `{ cause: {} }`. It becomes plain data
+    // here, before the entry is frozen, so every transport sees the same
+    // thing; its own fields are redacted like any other metadata.
+    if (value instanceof Error) {
+        seen.add(value);
+        try {
+            const redacted = redactLogValue(errorToPlainObject(value), isSecret, replacement, seen, onReadError);
+            Object.defineProperty(redacted, LOGGER_ERROR_VALUE, { value: true });
+            return redacted;
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
     seen.add(value);
     try {
         const descend = (item) => redactLogValue(item, isSecret, replacement, seen, onReadError);
@@ -168,4 +225,3 @@ export function redactLogValue(value, isSecret, replacement = LOGGER_REDACTION_T
         seen.delete(value);
     }
 }
-//# sourceMappingURL=loggerEntryHelpers.sanitize.js.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.serialize.d.ts

@@ -18,4 +18,3 @@ export { serializeLoggerError, serializeLoggerValue, } from "./loggerEntryHelper
  * a circular dependency into logger-entry.ts.
  */
 export declare function loggerLevelNameFallback(level: import("../../loggerLevel/loggerLevel.type.js").LoggerLevel): import("../../loggerLevel/loggerLevel.type.js").LoggerLevelName;
-//# sourceMappingURL=loggerEntryHelpers.serialize.d.ts.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.serialize.js

@@ -53,4 +53,3 @@ export function loggerLevelNameFallback(level) {
             throw new InvalidLoggerLevelError(level);
     }
 }
-//# sourceMappingURL=loggerEntryHelpers.serialize.js.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.types.d.ts

@@ -73,4 +73,3 @@ export interface LoggerEntryContext {
      */
     readonly metadata?: LogMetadata;
 }
-//# sourceMappingURL=loggerEntryHelpers.types.d.ts.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.types.js

@@ -2,4 +2,3 @@
  * Logger entry value and metadata types.
  */
 export {};
-//# sourceMappingURL=loggerEntryHelpers.types.js.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.valueSerialize.d.ts

@@ -22,4 +22,3 @@ export declare function serializeLoggerError(error: {
  * stack out of every Error found in the value.
  */
 export declare function serializeLoggerValue(value: unknown, seen?: WeakSet<object>, includeErrorStack?: boolean): unknown;
-//# sourceMappingURL=loggerEntryHelpers.valueSerialize.d.ts.map

package/dist/loggerEntry/loggerEntryHelpers/loggerEntryHelpers.valueSerialize.js

@@ -1,7 +1,7 @@
 /**
  * Logger entry value serialization.
  */
-import { LOGGER_UNREADABLE_TOKEN } from "./loggerEntryHelpers.sanitize.js";
+import { LOGGER_UNREADABLE_TOKEN, isLogErrorValue, } from "./loggerEntryHelpers.sanitize.js";
 /**
  * Serializes an error-like object into a plain object.
  *
@@ -77,7 +77,12 @@ export function serializeLoggerValue(value, seen = new WeakSet(), includeErrorSt
             }
             return result;
         }
+        // An Error already normalized by redaction is plain data; honour
+        // `includeErrorStack` for it exactly as for a live Error.
+        const omitStack = !includeErrorStack && isLogErrorValue(value);
         for (const key of Object.keys(value)) {
+            if (omitStack && key === "stack")
+                continue;
             let item;
             try {
                 item = value[key];
@@ -94,4 +99,3 @@ export function serializeLoggerValue(value, seen = new WeakSet(), includeErrorSt
         seen.delete(value);
     }
 }
-//# sourceMappingURL=loggerEntryHelpers.valueSerialize.js.map

package/dist/loggerEntry/loggerEntrySerialize.d.ts

@@ -5,4 +5,3 @@
  * serialization functions from their new location.
  */
 export { serializeLoggerEntry, serializeLoggerError, serializeLoggerValue, loggerLevelNameFallback, } from "./loggerEntryHelpers/loggerEntryHelpers.serialize.js";
-//# sourceMappingURL=loggerEntrySerialize.d.ts.map

package/dist/loggerEntry/loggerEntrySerialize.js

@@ -5,4 +5,3 @@
  * serialization functions from their new location.
  */
 export { serializeLoggerEntry, serializeLoggerError, serializeLoggerValue, loggerLevelNameFallback, } from "./loggerEntryHelpers/loggerEntryHelpers.serialize.js";
-//# sourceMappingURL=loggerEntrySerialize.js.map