@jmlq/logger 0.1.0-alpha.0 → 0.1.0-alpha.10

package/dist/src/application/use-cases/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./save-log.use-case"), exports);
+__exportStar(require("./get-logs.use-case"), exports);
+__exportStar(require("./flush-buffers.use-case"), exports);

package/dist/src/application/use-cases/save-log.use-case.d.ts

@@ -0,0 +1,8 @@
+import { ISaveLogProps } from "../../domain/request";
+import { LogMessage } from "../../domain/types";
+import { LogLevel } from "../../domain/value-objects";
+export declare class SaveLogUseCase {
+    private readonly props;
+    constructor(props: ISaveLogProps);
+    execute(level: LogLevel, message: LogMessage, meta?: unknown): Promise<void>;
+}

package/dist/src/application/use-cases/save-log.use-case.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaveLogUseCase = void 0;
+const services_1 = require("../../domain/services");
+class SaveLogUseCase {
+    constructor(props) {
+        this.props = props;
+    }
+    async execute(level, message, meta) {
+        // 1) Filtro por nivel (evita hacer trabajo innecesario)
+        if (level < this.props.minLevel)
+            return; // no se loggea
+        // 2) Normalización + PII
+        const normalized = (0, services_1.normalizeMessage)(message, this.props.redactor);
+        // 3) Construcción del evento
+        const log = {
+            level,
+            message: normalized,
+            meta: meta === undefined ? undefined : this.props.redactor.redact(meta),
+            timestamp: Date.now(),
+        };
+        // 4) Persistencia (fan-out lo maneja el ds si es composite)
+        await this.props.ds.save(log);
+    }
+}
+exports.SaveLogUseCase = SaveLogUseCase;

package/dist/src/domain/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./ports";
+export * from "./request";
+export * from "./response";
+export * from "./services";
+export * from "./types";
+export * from "./value-objects";

package/dist/src/domain/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ports"), exports);
+__exportStar(require("./request"), exports);
+__exportStar(require("./response"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./value-objects"), exports);

package/dist/src/domain/ports/create-logger-options.port.d.ts

@@ -0,0 +1,7 @@
+import { IPiiOptionsProps } from "../request";
+import { LogLevel } from "../value-objects";
+export interface ICreateLoggerOptions {
+    minLevel?: LogLevel;
+    redactPII?: boolean;
+    pii?: IPiiOptionsProps;
+}

package/dist/src/domain/ports/create-logger-options.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/ports/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./log-datasource.port";
+export * from "./logger.port";
+export * from "./pii-redactor.port";
+export * from "./create-logger-options.port";
+export * from "./logger-factory-config.port";
+export * from "./logger-service.port";

package/dist/src/domain/ports/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./log-datasource.port"), exports);
+__exportStar(require("./logger.port"), exports);
+__exportStar(require("./pii-redactor.port"), exports);
+__exportStar(require("./create-logger-options.port"), exports);
+__exportStar(require("./logger-factory-config.port"), exports);
+__exportStar(require("./logger-service.port"), exports);

package/dist/src/domain/ports/log-datasource.port.d.ts

@@ -0,0 +1,9 @@
+import { IGetLogsFilterProps, ILogProps } from "../request";
+import { ILogResponse } from "../response";
+export interface ILogDatasource {
+    save(log: ILogProps): Promise<void>;
+    find?(filter?: IGetLogsFilterProps): Promise<ILogResponse[]>;
+    flush?(): Promise<void>;
+    dispose?(): Promise<void>;
+    readonly name?: string;
+}

package/dist/src/domain/ports/log-datasource.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/ports/logger-factory-config.port.d.ts

@@ -0,0 +1,28 @@
+import { ILogDatasource, IPiiRedactor } from ".";
+import { IPiiOptionsProps } from "../request";
+import { LogLevel } from "../value-objects";
+/**
+ * Configuración de alto nivel para construir el logger.
+ * Es lo que recibe el usuario del paquete npm.
+ */
+export interface ILoggerFactoryConfig {
+    /**
+     * Datasource(s) concretos donde se van a persistir los logs.
+     * Pueden venir uno o varios; si hay más de uno se compone con DataSourceService (fan-out).
+     */
+    datasources: ILogDatasource | ILogDatasource[];
+    /**
+     * Nivel mínimo de logging. Por defecto: INFO.
+     */
+    minLevel?: LogLevel;
+    /**
+     * Instancia de redactor de PII personalizada.
+     * Si no se proporciona, se creará internamente un PiiRedactor con las opciones dadas.
+     */
+    redactor?: IPiiRedactor;
+    /**
+     * Opciones para el redactor de PII interno.
+     * Solo se usan si no se pasa `redactor` explícito.
+     */
+    redactorOptions?: IPiiOptionsProps;
+}

package/dist/src/domain/ports/logger-factory-config.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/ports/logger-service.port.d.ts

@@ -0,0 +1,19 @@
+import { IGetLogsFilterProps } from "../request";
+import { ILogResponse } from "../response";
+import { LogMessage } from "../types";
+import { LogLevel } from "../value-objects";
+/**
+ * Facade de alto nivel que expone el comportamiento del logger
+ * listo para ser usado por el cliente del paquete.
+ */
+export interface ILoggerService {
+    log(level: LogLevel, message: LogMessage, meta?: unknown): Promise<void>;
+    trace(message: LogMessage, meta?: unknown): Promise<void>;
+    debug(message: LogMessage, meta?: unknown): Promise<void>;
+    info(message: LogMessage, meta?: unknown): Promise<void>;
+    warn(message: LogMessage, meta?: unknown): Promise<void>;
+    error(message: LogMessage, meta?: unknown): Promise<void>;
+    fatal(message: LogMessage, meta?: unknown): Promise<void>;
+    getLogs(filter?: IGetLogsFilterProps): Promise<ILogResponse[]>;
+    flush(): Promise<void>;
+}

package/dist/src/domain/ports/logger-service.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/ports/logger.port.d.ts

@@ -0,0 +1,10 @@
+export interface ILogger {
+    trace: (message: unknown, meta?: unknown) => void | Promise<void>;
+    debug: (message: unknown, meta?: unknown) => void | Promise<void>;
+    info: (message: unknown, meta?: unknown) => void | Promise<void>;
+    warn: (message: unknown, meta?: unknown) => void | Promise<void>;
+    error: (message: unknown, meta?: unknown) => void | Promise<void>;
+    fatal: (message: unknown, meta?: unknown) => void | Promise<void>;
+    flush?: () => Promise<void>;
+    dispose?: () => Promise<void>;
+}

package/dist/src/domain/ports/logger.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/ports/pii-redactor.port.d.ts

@@ -0,0 +1,5 @@
+import { IPiiOptionsProps } from "../request";
+export interface IPiiRedactor {
+    redact<T = unknown>(value: T): T;
+    updateOptions?(opts: IPiiOptionsProps): void;
+}

package/dist/src/domain/ports/pii-redactor.port.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/request/get-logs-filter.props.d.ts

@@ -0,0 +1,9 @@
+import { LogLevel } from "../value-objects";
+export interface IGetLogsFilterProps {
+    levelMin?: LogLevel;
+    since?: number;
+    until?: number;
+    limit?: number;
+    offset?: number;
+    query?: string;
+}

package/dist/src/domain/request/get-logs-filter.props.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/request/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./save-log.props";
+export * from "./pii-options.props";
+export * from "./log.props";
+export * from "./get-logs-filter.props";
+export * from "./pii-replacement.props";

package/dist/src/domain/request/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./save-log.props"), exports);
+__exportStar(require("./pii-options.props"), exports);
+__exportStar(require("./log.props"), exports);
+__exportStar(require("./get-logs-filter.props"), exports);
+__exportStar(require("./pii-replacement.props"), exports);

package/dist/src/domain/request/log.props.d.ts

@@ -0,0 +1,7 @@
+import { LogLevel } from "../value-objects";
+export interface ILogProps {
+    level: LogLevel;
+    message: string | Record<string, unknown>;
+    meta?: unknown;
+    timestamp: number;
+}

package/dist/src/domain/request/log.props.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/request/pii-options.props.d.ts

@@ -0,0 +1,8 @@
+import { IPiiReplacementProps } from ".";
+export interface IPiiOptionsProps {
+    enabled?: boolean;
+    whitelistKeys?: string[];
+    blacklistKeys?: string[];
+    patterns?: IPiiReplacementProps[];
+    deep?: boolean;
+}

package/dist/src/domain/request/pii-options.props.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/request/pii-replacement.props.d.ts

@@ -0,0 +1,5 @@
+export interface IPiiReplacementProps {
+    pattern: string;
+    flags?: string;
+    replaceWith: string;
+}

package/dist/src/domain/request/pii-replacement.props.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/request/save-log.props.d.ts

@@ -0,0 +1,7 @@
+import { ILogDatasource, IPiiRedactor } from "../ports";
+import { LogLevel } from "../value-objects";
+export interface ISaveLogProps {
+    ds: ILogDatasource;
+    minLevel: LogLevel;
+    redactor: IPiiRedactor;
+}

package/dist/src/domain/request/save-log.props.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/response/index.d.ts

@@ -0,0 +1 @@
+export * from "./log.response";

package/dist/src/domain/response/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./log.response"), exports);

package/dist/src/domain/response/log.response.d.ts

@@ -0,0 +1,7 @@
+import { LogLevel } from "../value-objects";
+export interface ILogResponse {
+    level: LogLevel;
+    message: string | Record<string, unknown>;
+    meta?: unknown;
+    timestamp: number;
+}

package/dist/src/domain/response/log.response.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/domain/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./pii-redactor.service";
+export * from "./message-normalizer.service";
+export * from "./pii-pattern.service";
+export * from "./log-level.service";

package/dist/src/domain/services/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./pii-redactor.service"), exports);
+__exportStar(require("./message-normalizer.service"), exports);
+__exportStar(require("./pii-pattern.service"), exports);
+__exportStar(require("./log-level.service"), exports);

package/dist/src/domain/services/log-level.service.d.ts

@@ -0,0 +1,2 @@
+import { LogLevel } from "../value-objects";
+export declare function toLogLevel(level: string | number | undefined, def?: LogLevel): LogLevel;

package/dist/src/domain/services/log-level.service.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLogLevel = toLogLevel;
+const value_objects_1 = require("../value-objects");
+// Convierte string a LogLevel con fallback seguro
+function toLogLevel(level, def = value_objects_1.LogLevel.INFO) {
+    if (typeof level === "number")
+        return (Object.values(value_objects_1.LogLevel).includes(level) ? level : def);
+    if (!level)
+        return def;
+    switch (String(level).toLowerCase()) {
+        case "trace":
+            return value_objects_1.LogLevel.TRACE;
+        case "debug":
+            return value_objects_1.LogLevel.DEBUG;
+        case "info":
+            return value_objects_1.LogLevel.INFO;
+        case "warn":
+            return value_objects_1.LogLevel.WARN;
+        case "error":
+            return value_objects_1.LogLevel.ERROR;
+        case "fatal":
+            return value_objects_1.LogLevel.FATAL;
+        default:
+            return def; // evita lanzar excepción por valores inesperados
+    }
+}

package/dist/src/domain/services/message-normalizer.service.d.ts

@@ -0,0 +1,3 @@
+import { IPiiRedactor } from "../ports";
+import { LogMessage } from "../types";
+export declare function normalizeMessage(message: LogMessage, redactor: IPiiRedactor): string | Record<string, unknown>;

package/dist/src/domain/services/message-normalizer.service.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeMessage = normalizeMessage;
+// Normaliza el mensaje: si es función, la evalúa; si es objeto, se redacta; si es string, se redacta
+function normalizeMessage(message, redactor) {
+    const resolved = typeof message === "function" ? message() : message; // eval laziness
+    return redactor.redact(resolved);
+}

package/dist/src/domain/services/pii-pattern.service.d.ts

@@ -0,0 +1,2 @@
+import { IPiiReplacementProps } from "../request";
+export declare function toPiiRegex(props: IPiiReplacementProps): RegExp;

package/dist/src/domain/services/pii-pattern.service.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPiiRegex = toPiiRegex;
+// Convierte un patrón PII declarativo a un RegExp seguro
+function toPiiRegex(props) {
+    try {
+        return new RegExp(props.pattern, props.flags ?? "g");
+    }
+    catch {
+        // fallback: RegExp imposible que nunca hace match
+        return /$a/;
+    }
+}

package/dist/src/domain/services/pii-redactor.d.ts

@@ -0,0 +1,10 @@
+import { IPiiRedactor } from "../ports";
+import { IPiiOptionsProps } from "../request";
+export declare class PiiRedactor implements IPiiRedactor {
+    private props;
+    constructor(props?: IPiiOptionsProps);
+    updateOptions(opts: IPiiOptionsProps): void;
+    redact<T = unknown>(value: T): T;
+    private applyPatterns;
+    private redactDeep;
+}

package/dist/src/domain/services/pii-redactor.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PiiRedactor = void 0;
+const pii_pattern_service_1 = require("./pii-pattern.service");
+class PiiRedactor {
+    constructor(props = {}) {
+        this.props = props;
+    }
+    updateOptions(opts) {
+        // merge superficial de opciones; no muta referencias externas
+        this.props = { ...this.props, ...opts };
+    }
+    redact(value) {
+        if (!this.props.enabled)
+            return value; // early exit si PII apagado
+        if (value == null)
+            return value;
+        // Si es string → aplicar patrones
+        if (typeof value === "string") {
+            return this.applyPatterns(value);
+        }
+        // Si es objeto/array → redacción profunda si corresponde
+        if (typeof value === "object") {
+            return this.redactDeep(value);
+        }
+        // Otros tipos (number, boolean, function) no se redactan
+        return value;
+    }
+    applyPatterns(input) {
+        const patterns = this.props.patterns ?? [];
+        let out = input;
+        for (const p of patterns) {
+            const rx = (0, pii_pattern_service_1.toPiiRegex)(p);
+            // replace con patrón RegExp
+            out = out.replace(rx, p.replaceWith);
+        }
+        return out;
+    }
+    redactDeep(obj) {
+        // Evita mutar el objeto original → copia superficial
+        const clone = Array.isArray(obj)
+            ? [...obj]
+            : { ...obj };
+        const { whitelistKeys = [], blacklistKeys = [], deep = true } = this.props;
+        for (const key of Object.keys(clone)) {
+            const val = clone[key];
+            // Si está en whitelist, se respeta siempre
+            if (whitelistKeys.includes(key))
+                continue;
+            // Si está en blacklist y es string → reemplazar completamente
+            if (blacklistKeys.includes(key)) {
+                clone[key] = "[REDACTED]"; // fuerza redacción total de claves sensibles
+                continue;
+            }
+            // Para strings comunes → aplicar patrones
+            if (typeof val === "string") {
+                clone[key] = this.applyPatterns(val);
+                continue;
+            }
+            // Para objetos/arrays y deep===true → recursión
+            if (deep && val && typeof val === "object") {
+                clone[key] = this.redactDeep(val);
+            }
+        }
+        return clone;
+    }
+}
+exports.PiiRedactor = PiiRedactor;

package/dist/src/domain/services/pii-redactor.service.d.ts

@@ -0,0 +1,10 @@
+import { IPiiRedactor } from "../ports";
+import { IPiiOptionsProps } from "../request";
+export declare class PiiRedactor implements IPiiRedactor {
+    private props;
+    constructor(props?: IPiiOptionsProps);
+    updateOptions(opts: IPiiOptionsProps): void;
+    redact<T = unknown>(value: T): T;
+    private applyPatterns;
+    private redactDeep;
+}

package/dist/src/domain/services/pii-redactor.service.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PiiRedactor = void 0;
+const pii_pattern_service_1 = require("./pii-pattern.service");
+class PiiRedactor {
+    constructor(props = {}) {
+        this.props = props;
+    }
+    updateOptions(opts) {
+        // merge superficial de opciones; no muta referencias externas
+        this.props = { ...this.props, ...opts };
+    }
+    redact(value) {
+        if (!this.props.enabled)
+            return value; // early exit si PII apagado
+        if (value == null)
+            return value;
+        // Si es string → aplicar patrones
+        if (typeof value === "string") {
+            return this.applyPatterns(value);
+        }
+        // Si es objeto/array → redacción profunda si corresponde
+        if (typeof value === "object") {
+            return this.redactDeep(value);
+        }
+        // Otros tipos (number, boolean, function) no se redactan
+        return value;
+    }
+    applyPatterns(input) {
+        const patterns = this.props.patterns ?? [];
+        let out = input;
+        for (const p of patterns) {
+            const rx = (0, pii_pattern_service_1.toPiiRegex)(p);
+            // replace con patrón RegExp
+            out = out.replace(rx, p.replaceWith);
+        }
+        return out;
+    }
+    redactDeep(obj) {
+        // Evita mutar el objeto original → copia superficial
+        const clone = Array.isArray(obj)
+            ? [...obj]
+            : { ...obj };
+        const { whitelistKeys = [], blacklistKeys = [], deep = true } = this.props;
+        for (const key of Object.keys(clone)) {
+            const val = clone[key];
+            // Si está en whitelist, se respeta siempre
+            if (whitelistKeys.includes(key))
+                continue;
+            // Si está en blacklist y es string → reemplazar completamente
+            if (blacklistKeys.includes(key)) {
+                clone[key] = "[REDACTED]"; // fuerza redacción total de claves sensibles
+                continue;
+            }
+            // Para strings comunes → aplicar patrones
+            if (typeof val === "string") {
+                clone[key] = this.applyPatterns(val);
+                continue;
+            }
+            // Para objetos/arrays y deep===true → recursión
+            if (deep && val && typeof val === "object") {
+                clone[key] = this.redactDeep(val);
+            }
+        }
+        return clone;
+    }
+}
+exports.PiiRedactor = PiiRedactor;

package/dist/src/domain/types/index.d.ts

@@ -0,0 +1 @@
+export * from "./log-message.type";

package/dist/src/domain/types/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./log-message.type"), exports);