@volontariapp/logger 0.2.7 → 0.3.0-snap-271697b

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.3.0
+
+### Minor Changes
+
+- Mask personal data and add trace correlation (tickets 3.0 and 3.1).
+
+  - Masking (3.0): metadata, positional params, error details and the message are masked before serialization, in JSON and text. Keys are matched by fragment, case-insensitively and ignoring `-` and `_` (`password`, `token`, `authorization`, `cookie`, `apikey`, `email`, `phone`, `iban`... so `x-internal-token` and `refresh_token` are covered), and strings are scanned for emails, JWTs and `Bearer` credentials. The walk is recursive, handles arrays, class instances, errors and circular references (`[Circular]`), and never mutates the object passed by the caller.
+  - Configurable: `new Logger({ masking: { keys, patterns, replacement } })` extends the defaults, `masking: false` disables it. New exports: `Masker`, `MaskingConfig`, `DEFAULT_SENSITIVE_KEYS`, `DEFAULT_SENSITIVE_PATTERNS`, `DEFAULT_REDACTION`, `CIRCULAR_REFERENCE`.
+  - Trace correlation (3.1): inside an active OpenTelemetry span, the JSON payload carries `trace_id` (hex), `dd.trace_id` (lower 64 bits, decimal) and `dd.span_id` (decimal). They are written after the caller metadata, which cannot override them. The text format is unchanged. New exports: `getTraceFields`, `TraceFields`. New dependency: `@opentelemetry/api` (`^1.9.0`, no SDK).
+
+  Behavior change: masking is on by default, so a consumer that logged an `email`, `phone` or `token` field will now see `[REDACTED]` once it bumps.
+
 ## 0.2.7
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from './colors.js';
 export * from './logger.js';
+export * from './masking.js';
+export * from './trace-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
 export * from './colors.js';
 export * from './logger.js';
+export * from './masking.js';
+export * from './trace-context.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/logger.d.ts

@@ -1,13 +1,16 @@
 import type { LogLevel } from './colors.js';
+import type { MaskingConfig } from './masking.js';
 export interface LoggerConfig {
     context?: string;
     format?: 'json' | 'text';
     minLevel?: LogLevel;
+    masking?: MaskingConfig | false;
 }
 export declare class Logger {
     private readonly context;
     private readonly format;
     private readonly minLevel;
+    private readonly masker;
     private readonly levels;
     constructor(config?: LoggerConfig);
     log(message: unknown, ...optionalParams: unknown[]): void;

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;gBAEU,MAAM,CAAC,EAAE,YAAY;IAM1B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAIzD,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI1D,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI1D,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI3D,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAIpE,OAAO,CAAC,KAAK;IAkDb,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,WAAW;CAoBpB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,OAAO,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC;CACjC;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;gBAEU,MAAM,CAAC,EAAE,YAAY;IAO1B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAIzD,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI1D,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI1D,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAI3D,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAIpE,OAAO,CAAC,KAAK;IAqDb,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,WAAW;CAoBpB"}

package/dist/logger.js

@@ -1,8 +1,11 @@
 import { Colors, getLevelColor } from './colors.js';
+import { Masker } from './masking.js';
+import { getTraceFields } from './trace-context.js';
 export class Logger {
     context;
     format;
     minLevel;
+    masker;
     levels = {
         debug: 0,
         info: 1,
@@ -14,6 +17,7 @@ export class Logger {
         this.context = config?.context ?? 'App';
         this.format = config?.format ?? 'text';
         this.minLevel = config?.minLevel ?? 'debug';
+        this.masker = config?.masking === false ? undefined : new Masker(config?.masking);
     }
     log(message, ...optionalParams) {
         this.info(message, ...optionalParams);
@@ -47,8 +51,10 @@ export class Logger {
             contextOverride = params[params.length - 1];
             optionalArgs = params.slice(0, params.length - 1);
         }
-        const parsedMessage = typeof message === 'string' ? message : this.stringifyUnknown(message);
-        const meta = this.parseParams(optionalArgs);
+        const rawMessage = typeof message === 'string' ? message : this.stringifyUnknown(message);
+        const parsedMessage = this.masker?.maskString(rawMessage) ?? rawMessage;
+        const rawMeta = this.parseParams(optionalArgs);
+        const meta = this.masker?.maskRecord(rawMeta) ?? rawMeta;
         const logMethod = level === 'error' || level === 'fatal' ? 'error' : level === 'warn' ? 'warn' : 'log';
         if (this.format === 'json') {
             const payload = {
@@ -57,6 +63,7 @@ export class Logger {
                 context: contextOverride,
                 message: parsedMessage,
                 ...meta,
+                ...getTraceFields(),
             };
             console[logMethod](JSON.stringify(payload));
             return;

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQpD,MAAM,OAAO,MAAM;IACA,OAAO,CAAS;IAChB,MAAM,CAAkB;IACxB,QAAQ,CAAW;IAEnB,MAAM,GAA6B;QAClD,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,YAAY,MAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,KAAK,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAC;IAC9C,CAAC;IAEM,GAAG,CAAC,OAAgB,EAAE,GAAG,cAAyB;QACvD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,OAAgB,EAAE,GAAG,cAAyB;QACzD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;IAEM,IAAI,CAAC,OAAgB,EAAE,GAAG,cAAyB;QACxD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,CAAC;IAEM,IAAI,CAAC,OAAgB,EAAE,GAAG,cAAyB;QACxD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,OAAgB,EAAE,GAAG,cAAyB;QACzD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,OAAgB,EAAE,GAAG,cAAyB;QACzD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;IAEM,OAAO,CAAC,OAAgB,EAAE,GAAG,cAAyB;QAC3D,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;IAEO,KAAK,CAAC,KAAe,EAAE,OAAgB,EAAE,MAAiB;QAChE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,IAAI,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC;QACnC,IAAI,YAAY,GAAG,MAAM,CAAC;QAE1B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACvE,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAW,CAAC;YACtD,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,SAAS,GACb,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAEvF,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG;gBACd,SAAS;gBACT,KAAK;gBACL,OAAO,EAAE,eAAe;gBACxB,OAAO,EAAE,aAAa;gBACtB,GAAG,IAAI;aACR,CAAC;YAEF,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAEvB,MAAM,QAAQ,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,eAAe,IAAI,KAAK,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,GAAG,GAAG,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAE7C,IAAI,MAAM,GAAG,GAAG,OAAO,IAAI,QAAQ,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;QAErE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;QAChE,CAAC;QAED,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAEO,gBAAgB,CAAC,GAAY;QACnC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,IAAI,CAAC;YACH,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,MAAiB;QACnC,MAAM,IAAI,GAA4B,EAAE,CAAC;QAEzC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/E,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC/B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,OAAO,MAAM,CAAC,CAAC,CAA4B,CAAC;YAC9C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/masking.d.ts

@@ -0,0 +1,21 @@
+export declare const DEFAULT_REDACTION = "[REDACTED]";
+export declare const CIRCULAR_REFERENCE = "[Circular]";
+export declare const DEFAULT_SENSITIVE_KEYS: readonly string[];
+export declare const DEFAULT_SENSITIVE_PATTERNS: readonly RegExp[];
+export interface MaskingConfig {
+    keys?: readonly string[];
+    patterns?: readonly RegExp[];
+    replacement?: string;
+}
+export declare class Masker {
+    private readonly keys;
+    private readonly patterns;
+    private readonly replacement;
+    constructor(config?: MaskingConfig);
+    maskString(value: string): string;
+    mask(value: unknown): unknown;
+    maskRecord(value: Record<string, unknown>): Record<string, unknown>;
+    private isSensitiveKey;
+    private visit;
+}
+//# sourceMappingURL=masking.d.ts.map

package/dist/masking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"masking.d.ts","sourceRoot":"","sources":["../src/masking.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAC9C,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAkBnD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAIvD,CAAC;AAEF,MAAM,WAAW,aAAa;IAE5B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAOD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,CAAC,EAAE,aAAa;IAU3B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQjC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI7B,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1E,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,KAAK;CAiCd"}

package/dist/masking.js

@@ -0,0 +1,86 @@
+export const DEFAULT_REDACTION = '[REDACTED]';
+export const CIRCULAR_REFERENCE = '[Circular]';
+export const DEFAULT_SENSITIVE_KEYS = [
+    'password',
+    'passwd',
+    'secret',
+    'token',
+    'authorization',
+    'cookie',
+    'apikey',
+    'privatekey',
+    'email',
+    'phone',
+    'firstname',
+    'lastname',
+    'birthdate',
+    'iban',
+    'creditcard',
+    'cardnumber',
+    'cvv',
+];
+export const DEFAULT_SENSITIVE_PATTERNS = [
+    /[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}/g,
+    /eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]*/g,
+    /Bearer\s+[A-Za-z0-9._~+/=-]+/gi,
+];
+const normalizeKey = (key) => key.toLowerCase().replace(/[-_\s]/g, '');
+const withGlobalFlag = (pattern) => pattern.global ? pattern : new RegExp(pattern.source, `${pattern.flags}g`);
+export class Masker {
+    keys;
+    patterns;
+    replacement;
+    constructor(config) {
+        this.keys = [...DEFAULT_SENSITIVE_KEYS, ...(config?.keys ?? [])]
+            .map(normalizeKey)
+            .filter((key) => key.length > 0);
+        this.patterns = [...DEFAULT_SENSITIVE_PATTERNS, ...(config?.patterns ?? [])].map(withGlobalFlag);
+        this.replacement = config?.replacement ?? DEFAULT_REDACTION;
+    }
+    maskString(value) {
+        return this.patterns.reduce((masked, pattern) => masked.replace(pattern, this.replacement), value);
+    }
+    mask(value) {
+        return this.visit(value, new WeakSet());
+    }
+    maskRecord(value) {
+        return this.visit(value, new WeakSet());
+    }
+    isSensitiveKey(key) {
+        const normalized = normalizeKey(key);
+        return this.keys.some((fragment) => normalized.includes(fragment));
+    }
+    visit(value, ancestors) {
+        if (typeof value === 'string') {
+            return this.maskString(value);
+        }
+        if (typeof value !== 'object' || value === null || value instanceof Date) {
+            return value;
+        }
+        if (ancestors.has(value)) {
+            return CIRCULAR_REFERENCE;
+        }
+        ancestors.add(value);
+        try {
+            if (Array.isArray(value)) {
+                return value.map((item) => this.visit(item, ancestors));
+            }
+            if (value instanceof Error) {
+                return {
+                    name: value.name,
+                    message: this.maskString(value.message),
+                    stack: value.stack === undefined ? undefined : this.maskString(value.stack),
+                };
+            }
+            const masked = {};
+            for (const [key, child] of Object.entries(value)) {
+                masked[key] = this.isSensitiveKey(key) ? this.replacement : this.visit(child, ancestors);
+            }
+            return masked;
+        }
+        finally {
+            ancestors.delete(value);
+        }
+    }
+}
+//# sourceMappingURL=masking.js.map

package/dist/masking.js.map

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

package/dist/test/core/logger-masking.unit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger-masking.unit.spec.d.ts.map

package/dist/test/core/logger-masking.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-masking.unit.spec.d.ts","sourceRoot":"","sources":["../../../src/test/core/logger-masking.unit.spec.ts"],"names":[],"mappings":""}

package/dist/test/core/logger-masking.unit.spec.js

@@ -0,0 +1,62 @@
+import { jest, describe, it, expect, beforeEach, afterEach } from '@jest/globals';
+import { Logger } from '../../logger.js';
+import { DEFAULT_REDACTION } from '../../masking.js';
+describe('Logger masking', () => {
+    let consoleLogSpy;
+    let consoleErrorSpy;
+    beforeEach(() => {
+        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    const lastOutput = () => consoleLogSpy.mock.calls[0][0];
+    it('should mask metadata in json format', () => {
+        const logger = new Logger({ format: 'json' });
+        logger.info('Login', { email: 'jane@example.com', password: 'hunter2', userId: 7 });
+        const payload = JSON.parse(lastOutput());
+        expect(payload).toMatchObject({
+            email: DEFAULT_REDACTION,
+            password: DEFAULT_REDACTION,
+            userId: 7,
+        });
+        expect(lastOutput()).not.toContain('hunter2');
+        expect(lastOutput()).not.toContain('jane@example.com');
+    });
+    it('should mask metadata in text format', () => {
+        const logger = new Logger({ format: 'text' });
+        logger.info('Login', { nested: { token: 'abc123' } });
+        expect(lastOutput()).toContain(DEFAULT_REDACTION);
+        expect(lastOutput()).not.toContain('abc123');
+    });
+    it('should mask patterns inside the message and error details', () => {
+        const logger = new Logger({ format: 'json' });
+        logger.error('Failed for jane@example.com', new Error('boom jane@example.com'));
+        const output = consoleErrorSpy.mock.calls[0][0];
+        expect(output).toContain(DEFAULT_REDACTION);
+        expect(output).not.toContain('jane@example.com');
+    });
+    it('should mask positional params', () => {
+        const logger = new Logger({ format: 'json' });
+        logger.info('Params', 'a@b.io', 3);
+        expect(lastOutput()).not.toContain('a@b.io');
+    });
+    it('should not mutate the metadata passed by the caller', () => {
+        const logger = new Logger({ format: 'json' });
+        const meta = { password: 'hunter2' };
+        logger.info('Login', meta);
+        expect(meta.password).toBe('hunter2');
+    });
+    it('should apply the configured keys and replacement', () => {
+        const logger = new Logger({ format: 'json', masking: { keys: ['ssn'], replacement: '***' } });
+        logger.info('Profile', { ssn: '123', password: 'x' });
+        expect(JSON.parse(lastOutput())).toMatchObject({ ssn: '***', password: '***' });
+    });
+    it('should let masking be disabled explicitly', () => {
+        const logger = new Logger({ format: 'json', masking: false });
+        logger.info('Login', { password: 'hunter2' });
+        expect(JSON.parse(lastOutput())).toMatchObject({ password: 'hunter2' });
+    });
+});
+//# sourceMappingURL=logger-masking.unit.spec.js.map

package/dist/test/core/logger-masking.unit.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-masking.unit.spec.js","sourceRoot":"","sources":["../../../src/test/core/logger-masking.unit.spec.ts"],"names":[],"mappings":"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"}

package/dist/test/core/masking.unit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=masking.unit.spec.d.ts.map

package/dist/test/core/masking.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"masking.unit.spec.d.ts","sourceRoot":"","sources":["../../../src/test/core/masking.unit.spec.ts"],"names":[],"mappings":""}

package/dist/test/core/masking.unit.spec.js

@@ -0,0 +1,117 @@
+import { describe, it, expect } from '@jest/globals';
+import { CIRCULAR_REFERENCE, DEFAULT_REDACTION, Masker } from '../../masking.js';
+const JWT = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U';
+describe('Masker', () => {
+    describe('keys', () => {
+        it('should mask sensitive keys whatever their casing or separators', () => {
+            const masked = new Masker().mask({
+                password: 'hunter2',
+                'x-internal-token': 'abc',
+                Authorization: 'Bearer abc',
+                refresh_token: 'def',
+                userEmail: 'jane@example.com',
+                phoneNumber: '0612345678',
+            });
+            expect(masked).toEqual({
+                password: DEFAULT_REDACTION,
+                'x-internal-token': DEFAULT_REDACTION,
+                Authorization: DEFAULT_REDACTION,
+                refresh_token: DEFAULT_REDACTION,
+                userEmail: DEFAULT_REDACTION,
+                phoneNumber: DEFAULT_REDACTION,
+            });
+        });
+        it('should keep non sensitive keys untouched', () => {
+            const input = { port: 3000, host: 'localhost', ok: true, nothing: null };
+            expect(new Masker().mask(input)).toEqual(input);
+        });
+        it('should accept extra keys and a custom replacement', () => {
+            const masker = new Masker({ keys: ['ssn'], replacement: '***' });
+            expect(masker.mask({ SSN: '123', password: 'x' })).toEqual({ SSN: '***', password: '***' });
+        });
+    });
+    describe('patterns', () => {
+        it('should mask emails and JWTs found inside strings', () => {
+            const masked = new Masker().maskString(`user jane.doe+tag@example.co.uk sent ${JWT}`);
+            expect(masked).toBe(`user ${DEFAULT_REDACTION} sent ${DEFAULT_REDACTION}`);
+        });
+        it('should mask bearer credentials', () => {
+            expect(new Masker().maskString('header Bearer abc.def-123')).toBe(`header ${DEFAULT_REDACTION}`);
+        });
+        it('should accept extra patterns, even without the global flag', () => {
+            const masker = new Masker({ patterns: [/\d{4}-\d{4}/] });
+            expect(masker.maskString('a 1234-5678 b 8765-4321')).toBe(`a ${DEFAULT_REDACTION} b ${DEFAULT_REDACTION}`);
+        });
+        it('should be stable across repeated calls', () => {
+            const masker = new Masker();
+            expect(masker.maskString('a@b.io')).toBe(DEFAULT_REDACTION);
+            expect(masker.maskString('a@b.io')).toBe(DEFAULT_REDACTION);
+        });
+    });
+    describe('nested structures', () => {
+        it('should mask recursively in objects and arrays', () => {
+            const masked = new Masker().mask({
+                request: {
+                    headers: { authorization: 'secret-value', accept: 'json' },
+                    users: [
+                        { id: 1, email: 'a@b.io' },
+                        { id: 2, note: 'contact c@d.io' },
+                    ],
+                },
+            });
+            expect(masked).toEqual({
+                request: {
+                    headers: { authorization: DEFAULT_REDACTION, accept: 'json' },
+                    users: [
+                        { id: 1, email: DEFAULT_REDACTION },
+                        { id: 2, note: `contact ${DEFAULT_REDACTION}` },
+                    ],
+                },
+            });
+        });
+        it('should not mutate the original object', () => {
+            const input = { password: 'hunter2', nested: { token: 'abc' }, list: ['a@b.io'] };
+            const snapshot = JSON.stringify(input);
+            new Masker().mask(input);
+            expect(JSON.stringify(input)).toBe(snapshot);
+        });
+        it('should mask class instances', () => {
+            class UserDto {
+                id;
+                email;
+                constructor(id, email) {
+                    this.id = id;
+                    this.email = email;
+                }
+            }
+            expect(new Masker().mask(new UserDto(1, 'a@b.io'))).toEqual({
+                id: 1,
+                email: DEFAULT_REDACTION,
+            });
+        });
+        it('should mask errors and keep their shape', () => {
+            const error = new Error('failed for a@b.io');
+            const masked = new Masker().mask(error);
+            expect(masked.name).toBe('Error');
+            expect(masked.message).toBe(`failed for ${DEFAULT_REDACTION}`);
+        });
+        it('should keep dates and primitives', () => {
+            const date = new Date('2026-10-07T00:00:00.000Z');
+            expect(new Masker().mask({ date, count: 3, flag: false })).toEqual({
+                date,
+                count: 3,
+                flag: false,
+            });
+        });
+        it('should survive circular references', () => {
+            const input = { id: 1 };
+            input.self = input;
+            expect(new Masker().mask(input)).toEqual({ id: 1, self: CIRCULAR_REFERENCE });
+        });
+        it('should not flag a shared reference as circular', () => {
+            const shared = { id: 1 };
+            expect(new Masker().mask({ a: shared, b: shared })).toEqual({ a: shared, b: shared });
+        });
+    });
+});
+//# sourceMappingURL=masking.unit.spec.js.map

package/dist/test/core/masking.unit.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"masking.unit.spec.js","sourceRoot":"","sources":["../../../src/test/core/masking.unit.spec.ts"],"names":[],"mappings":"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"}

package/dist/test/core/trace-context.unit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace-context.unit.spec.d.ts.map

package/dist/test/core/trace-context.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.unit.spec.d.ts","sourceRoot":"","sources":["../../../src/test/core/trace-context.unit.spec.ts"],"names":[],"mappings":""}

package/dist/test/core/trace-context.unit.spec.js

@@ -0,0 +1,69 @@
+import { jest, describe, it, expect, beforeEach, afterEach } from '@jest/globals';
+import { trace } from '@opentelemetry/api';
+import { Logger } from '../../logger.js';
+import { getTraceFields } from '../../trace-context.js';
+import { SPAN_ID_HEX, TRACE_ID_HEX, createSpanContext } from '../factories/span-context.factory.js';
+const DD_TRACE_ID = '9532127138774266268';
+const DD_SPAN_ID = '13235353014750950193';
+describe('Trace correlation', () => {
+    let consoleLogSpy;
+    beforeEach(() => {
+        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    const activateSpan = (overrides) => {
+        jest
+            .spyOn(trace, 'getActiveSpan')
+            .mockReturnValue(trace.wrapSpanContext(createSpanContext(overrides)));
+    };
+    describe('getTraceFields', () => {
+        it('should return undefined without an active span', () => {
+            expect(getTraceFields()).toBeUndefined();
+        });
+        it('should convert the ids to the Datadog decimal format', () => {
+            activateSpan();
+            expect(getTraceFields()).toEqual({
+                trace_id: TRACE_ID_HEX,
+                'dd.trace_id': DD_TRACE_ID,
+                'dd.span_id': DD_SPAN_ID,
+            });
+        });
+        it('should ignore an invalid span context', () => {
+            activateSpan({ traceId: '0'.repeat(32), spanId: '0'.repeat(16) });
+            expect(getTraceFields()).toBeUndefined();
+        });
+    });
+    describe('Logger json output', () => {
+        const lastPayload = () => JSON.parse(consoleLogSpy.mock.calls[0][0]);
+        it('should add the trace fields inside an active span', () => {
+            activateSpan();
+            new Logger({ format: 'json' }).info('inside span');
+            expect(lastPayload()).toMatchObject({
+                message: 'inside span',
+                trace_id: TRACE_ID_HEX,
+                'dd.trace_id': DD_TRACE_ID,
+                'dd.span_id': DD_SPAN_ID,
+            });
+        });
+        it('should not add the trace fields outside a span', () => {
+            new Logger({ format: 'json' }).info('outside span');
+            const payload = lastPayload();
+            expect(payload).not.toHaveProperty('trace_id');
+            expect(payload).not.toHaveProperty('dd.trace_id');
+            expect(payload).not.toHaveProperty('dd.span_id');
+        });
+        it('should not let caller metadata override the trace fields', () => {
+            activateSpan();
+            new Logger({ format: 'json' }).info('spoof', { 'dd.trace_id': '1' });
+            expect(lastPayload()['dd.trace_id']).toBe(DD_TRACE_ID);
+        });
+        it('should leave the text format untouched', () => {
+            activateSpan();
+            new Logger({ format: 'text' }).info('text');
+            expect(consoleLogSpy.mock.calls[0][0]).not.toContain(SPAN_ID_HEX);
+        });
+    });
+});
+//# sourceMappingURL=trace-context.unit.spec.js.map

package/dist/test/core/trace-context.unit.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.unit.spec.js","sourceRoot":"","sources":["../../../src/test/core/trace-context.unit.spec.ts"],"names":[],"mappings":"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"}

package/dist/test/factories/span-context.factory.d.ts

@@ -0,0 +1,5 @@
+import type { SpanContext } from '@opentelemetry/api';
+export declare const TRACE_ID_HEX = "0af7651916cd43dd8448eb211c80319c";
+export declare const SPAN_ID_HEX = "b7ad6b7169203331";
+export declare const createSpanContext: (overrides?: Partial<SpanContext>) => SpanContext;
+//# sourceMappingURL=span-context.factory.d.ts.map

package/dist/test/factories/span-context.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-context.factory.d.ts","sourceRoot":"","sources":["../../../src/test/factories/span-context.factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,eAAO,MAAM,YAAY,qCAAqC,CAAC;AAC/D,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAE9C,eAAO,MAAM,iBAAiB,eAAe,OAAO,CAAC,WAAW,CAAC,KAAQ,WAKvE,CAAC"}

package/dist/test/factories/span-context.factory.js

@@ -0,0 +1,10 @@
+import { TraceFlags } from '@opentelemetry/api';
+export const TRACE_ID_HEX = '0af7651916cd43dd8448eb211c80319c';
+export const SPAN_ID_HEX = 'b7ad6b7169203331';
+export const createSpanContext = (overrides = {}) => ({
+    traceId: TRACE_ID_HEX,
+    spanId: SPAN_ID_HEX,
+    traceFlags: TraceFlags.SAMPLED,
+    ...overrides,
+});
+//# sourceMappingURL=span-context.factory.js.map

package/dist/test/factories/span-context.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-context.factory.js","sourceRoot":"","sources":["../../../src/test/factories/span-context.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,MAAM,CAAC,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAE9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAkC,EAAE,EAAe,EAAE,CAAC,CAAC;IACvF,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,UAAU,CAAC,OAAO;IAC9B,GAAG,SAAS;CACb,CAAC,CAAC"}

package/dist/trace-context.d.ts

@@ -0,0 +1,7 @@
+export interface TraceFields {
+    trace_id: string;
+    'dd.trace_id': string;
+    'dd.span_id': string;
+}
+export declare function getTraceFields(): TraceFields | undefined;
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAYxD"}

package/dist/trace-context.js

@@ -0,0 +1,15 @@
+import { trace } from '@opentelemetry/api';
+const DATADOG_ID_HEX_LENGTH = 16;
+const toDatadogId = (hex) => BigInt(`0x${hex.slice(-DATADOG_ID_HEX_LENGTH)}`).toString();
+export function getTraceFields() {
+    const spanContext = trace.getActiveSpan()?.spanContext();
+    if (spanContext === undefined || !trace.isSpanContextValid(spanContext)) {
+        return undefined;
+    }
+    return {
+        trace_id: spanContext.traceId,
+        'dd.trace_id': toDatadogId(spanContext.traceId),
+        'dd.span_id': toDatadogId(spanContext.spanId),
+    };
+}
+//# sourceMappingURL=trace-context.js.map

package/dist/trace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.js","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQ3C,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAGjC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CAC1C,MAAM,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AAE9D,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC;IAEzD,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,OAAO;QAC7B,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC;QAC/C,YAAY,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volontariapp/logger",
-  "version": "0.2.7",
+  "version": "0.3.0-snap-271697b",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -33,6 +33,9 @@
     "test": "node --experimental-vm-modules $(yarn bin jest)",
     "test:coverage": "node --experimental-vm-modules $(yarn bin jest) --coverage --coverageReporters=\"text\" --coverageReporters=\"json-summary\" --coverageReporters=\"lcov\""
   },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
   "devDependencies": {
     "@jest/globals": "^30.3.0",
     "@types/jest": "^30.0.0",