Utilities

Standalone functions exported from @warlock.js/logger alongside the Logger class and channels.

captureAnyUnhandledRejection()

function captureAnyUnhandledRejection(): void;

Attaches process-level listeners for unhandledRejection and uncaughtException, forwarding each to log.error("app", "<event>", error). Call once at startup, after channels are registered. See Capturing unhandled errors for the gotchas (not idempotent, doesn’t prevent exit, also console.logs the rejected promise).

clearMessage(message)

function clearMessage(message: any): any;

Strips ANSI escape codes from a string. Non-string values are returned unchanged; only strings containing escape sequences are modified. The logger applies this automatically to entries bound for non-terminal channels (terminal: false).

import { clearMessage } from "@warlock.js/logger";

clearMessage("[32mDeployment succeeded[0m"); // → "Deployment succeeded"

safeJsonStringify(value, space?)

function safeJsonStringify(value: unknown, space?: number): string;

JSON-serializes a value through safe-stable-stringify, handling circular references, BigInt, and repeated references; functions and symbols are dropped (standard JSON behavior). Error instances are expanded so the non-enumerable name / message / stack survive (a plain spread would drop them), plus any enumerable props you attached such as code. This is what JSONFileLog writes through.

applyRedact(data, config)

function applyRedact(data: LoggingData, config: RedactConfig | undefined): LoggingData;

Returns a new LoggingData with every path in config.paths replaced by config.censor. The input is never mutated. No-op (returns the input by reference) when config is undefined or paths is empty. Date and Error instances are reconstructed; circular references are tolerated. See Redaction for path syntax.

mergeRedact(base, extra)

function mergeRedact(
  base: RedactConfig | undefined,
  extra: RedactConfig | undefined,
): RedactConfig | undefined;

Combines two redact configs into one. paths are concatenated (duplicates kept); censor from extra wins, falling back to base, then to the default "[REDACTED]". This is how a channel’s additive redact layers on top of the logger-wide floor.

See also

• Redaction — applyRedact / mergeRedact in context
• Capturing unhandled errors — captureAnyUnhandledRejection in context
• Channels Overview — where clearMessage fits the fan-out