@zudojs/logger 1.4.0 → 1.4.1

package/README.md

@@ -151,9 +151,14 @@ logger.info("login", { user: "alice", password: "hunter2" });
 // metadata: { user: "alice", password: "[REDACTED]" }
 
 createLogger({ redact: { keys: ["ssn"], replacement: "***" } });
-createLogger({ redact: { enabled: false } }); // opt out
+createLogger({ redact: false }); // opt out
+createLogger({ redact: { enabled: false } }); // same as redact: false
 ```
 
+`redact` takes a boolean or an options object (`enabled`, `keys`, `pattern`,
+`replacement`). `true` or omitting it keeps the default. Child loggers inherit
+the parent's setting.
+
 ## Log injection
 
 Text-shaped formatters escape control characters (C0, DEL, C1 and

package/dist/loggerOptions/loggerOptions.redact.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Normalization of the `redact` logger option.
+ */
+import type { LoggerRedactionOptions } from "../loggerEntry/loggerEntryHelpers/loggerEntryHelpers.sanitize.js";
+/**
+ * Resolves the `redact` option into frozen redaction settings.
+ *
+ * `false` turns redaction off and `true` (or omitting it) keeps the default.
+ * An object is used as given. Spreading `false` into an object yields `{}`,
+ * which is the default, so a boolean must be mapped explicitly.
+ *
+ * @param redact - The `redact` value passed to `createLogger`.
+ * @returns The normalized redaction settings.
+ */
+export declare function resolveRedactionOptions(redact: boolean | LoggerRedactionOptions | undefined): LoggerRedactionOptions;
+//# sourceMappingURL=loggerOptions.redact.d.ts.map

package/dist/loggerOptions/loggerOptions.redact.js

@@ -0,0 +1,22 @@
+/**
+ * Normalization of the `redact` logger option.
+ */
+/**
+ * Resolves the `redact` option into frozen redaction settings.
+ *
+ * `false` turns redaction off and `true` (or omitting it) keeps the default.
+ * An object is used as given. Spreading `false` into an object yields `{}`,
+ * which is the default, so a boolean must be mapped explicitly.
+ *
+ * @param redact - The `redact` value passed to `createLogger`.
+ * @returns The normalized redaction settings.
+ */
+export function resolveRedactionOptions(redact) {
+    if (redact === false)
+        return Object.freeze({ enabled: false });
+    if (redact === true || redact === undefined || redact === null) {
+        return Object.freeze({});
+    }
+    return Object.freeze({ ...redact });
+}
+//# sourceMappingURL=loggerOptions.redact.js.map

package/dist/loggerOptions/loggerOptions.type.d.ts

@@ -24,9 +24,10 @@ export interface LoggerOptions {
      * Redaction is ON by default: fields whose NAME looks like a secret
      * (password, token, api key, credential, authorization, cookie) are
      * replaced with "[REDACTED]" before an entry reaches a formatter.
-     * Pass `{ enabled: false }` to opt out.
+     * Pass `false` (or `{ enabled: false }`) to opt out, or an options object
+     * to customize the matched keys, pattern and replacement.
      */
-    readonly redact?: LoggerRedactionOptions;
+    readonly redact?: boolean | LoggerRedactionOptions;
 }
 /** Options used when creating a child logger. */
 export interface ChildLoggerOptions {

package/dist/loggerOptions/loggerOptions.type.js

@@ -1,4 +1,5 @@
 import { LoggerLevel, resolveLoggerLevel, } from "../loggerLevel/loggerLevel.type.js";
+import { resolveRedactionOptions } from "./loggerOptions.redact.js";
 /** Default logger configuration values. */
 export const DEFAULT_LOGGER_OPTIONS = {
     enabled: true,
@@ -43,7 +44,7 @@ export function resolveLoggerOptions(options = {}) {
         transportTimeout: options.transportTimeout ?? DEFAULT_LOGGER_OPTIONS.transportTimeout,
         inheritContext: options.inheritContext ?? DEFAULT_LOGGER_OPTIONS.inheritContext,
         mutable: options.mutable ?? DEFAULT_LOGGER_OPTIONS.mutable,
-        redact: Object.freeze({ ...(options.redact ?? {}) }),
+        redact: resolveRedactionOptions(options.redact),
     });
 }
 /** Merges two logger option objects. Values from `override` take precedence. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/logger",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Structured logging with transports, log levels, and context propagation for Zudojs applications.",
   "license": "MIT",
   "author": {