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

package/dist/Composite/index.d.ts

@@ -1,9 +1,9 @@
-import { GetLogsFilter, ILogDatasource, Log } from "..";
+import { IGetLogsFilter, ILogDatasource, ILog } from "../config";
 export declare class CompositeDatasource implements ILogDatasource {
     private readonly datasources;
     constructor(datasources: ILogDatasource[]);
-    save(log: Log): Promise<void>;
-    find(filter?: GetLogsFilter): Promise<Log[]>;
+    save(log: ILog): Promise<void>;
+    find(filter?: IGetLogsFilter): Promise<ILog[]>;
     flush(): Promise<void>;
     dispose(): Promise<void>;
 }

package/dist/Composite/index.js

@@ -7,17 +7,48 @@ class CompositeDatasource {
         this.datasources = datasources;
     }
     async save(log) {
-        await Promise.allSettled(this.datasources.map((ds) => ds.save(log)));
+        const results = await Promise.allSettled(this.datasources.map((ds) => ds.save(log)));
+        for (const r of results) {
+            if (r.status === "rejected") {
+                // Evita romper el flujo si un destino falla.
+                // Aquí podrías enrutar a "dead-letter", métricas, etc.
+                // eslint-disable-next-line no-console
+                console.warn("[CompositeDatasource] save failed:", r.reason);
+            }
+        }
     }
     async find(filter = {}) {
-        const primary = this.datasources[0];
-        return (await primary?.find?.(filter)) ?? [];
+        for (const ds of this.datasources) {
+            if (typeof ds.find === "function") {
+                try {
+                    return await ds.find(filter);
+                }
+                catch (e) {
+                    // eslint-disable-next-line no-console
+                    console.warn("[CompositeDatasource] find failed on a datasource:", e);
+                    // probar siguiente datasource
+                }
+            }
+        }
+        return [];
     }
     async flush() {
-        await Promise.all(this.datasources.map((ds) => ds.flush?.() ?? Promise.resolve()));
+        const results = await Promise.allSettled(this.datasources.map((ds) => ds.flush?.() ?? Promise.resolve()));
+        for (const r of results) {
+            if (r.status === "rejected") {
+                // eslint-disable-next-line no-console
+                console.warn("[CompositeDatasource] flush failed:", r.reason);
+            }
+        }
     }
     async dispose() {
-        await Promise.all(this.datasources.map((ds) => ds.dispose?.() ?? Promise.resolve()));
+        const results = await Promise.allSettled(this.datasources.map((ds) => ds.dispose?.() ?? Promise.resolve()));
+        for (const r of results) {
+            if (r.status === "rejected") {
+                // eslint-disable-next-line no-console
+                console.warn("[CompositeDatasource] dispose failed:", r.reason);
+            }
+        }
     }
 }
 exports.CompositeDatasource = CompositeDatasource;

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./interfaces";
+export * from "./types";

package/dist/config/index.js

@@ -0,0 +1,18 @@
+"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("./interfaces"), exports);
+__exportStar(require("./types"), exports);

package/dist/config/interfaces/index.d.ts

@@ -0,0 +1,67 @@
+import { LogLevel, LogMessage, PiiReplacement } from "..";
+export interface ILog {
+    level: LogLevel;
+    message: string;
+    meta?: unknown;
+    timestamp: number;
+}
+export interface IGetLogsFilter {
+    levelMin?: LogLevel;
+    since?: number;
+    until?: number;
+}
+export interface ILogDatasource {
+    save(log: ILog): Promise<void>;
+    find?(filter?: IGetLogsFilter): Promise<ILog[]>;
+    flush?(): Promise<void>;
+    dispose?(): Promise<void>;
+}
+export interface ILogger {
+    trace: (msg: LogMessage, meta?: unknown) => Promise<void>;
+    debug: (msg: LogMessage, meta?: unknown) => Promise<void>;
+    info: (msg: LogMessage, meta?: unknown) => Promise<void>;
+    warn: (msg: LogMessage, meta?: unknown) => Promise<void>;
+    error: (msg: LogMessage, meta?: unknown) => Promise<void>;
+    fatal: (msg: LogMessage, meta?: unknown) => Promise<void>;
+    flush?: () => Promise<void>;
+    dispose?: () => Promise<void>;
+}
+export interface IPiiPattern {
+    /** (Opcional) Nombre del patrón para debug/telemetría */
+    name?: string;
+    /** Expresión regular a aplicar sobre strings */
+    regex: RegExp;
+    /** Reemplazo, por defecto "[REDACTED]" si no se provee */
+    replacement?: PiiReplacement;
+}
+export interface IPiiRedactorOptions {
+    /** Habilita/deshabilita redacción (permite control fino además del flag redactPII) */
+    enabled?: boolean;
+    /**
+     * Incluye patrones default (true) y fusiona con los custom. Si false, usa solo los personalizados
+     * por el cliente.
+     */
+    includeDefaultPatterns?: boolean;
+    /** Patrones adicionales o propios del cliente */
+    patterns?: IPiiPattern[];
+    /**
+     * Redactar por nombre de clave (deep). Cualquier key que haga match será redacatada
+     * con "[REDACTED]". Acepta exacto o RegExp.
+     */
+    redactKeys?: Array<string | RegExp>;
+    /**
+     * Claves que NO se deben redactar aunque coincidan con patrones o redactKeys.
+     * Prioridad: preserveKeys > redactKeys > patterns.
+     */
+    preserveKeys?: Array<string | RegExp>;
+}
+export interface ICreateLoggerOptions {
+    minLevel?: LogLevel;
+    /** compatibilidad con lo que ya tienes */
+    redactPII?: boolean;
+    /** NUEVO: bloque de configuración PII */
+    pii?: IPiiRedactorOptions & {
+        /** atajo para permitir que el cliente mande solo patterns sin escribir PiiRedactorOptions */
+        patterns?: IPiiPattern[];
+    };
+}

package/dist/config/interfaces/index.js

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

package/dist/config/types/index.d.ts

@@ -0,0 +1,10 @@
+export declare enum LogLevel {
+    TRACE = 0,
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    FATAL = 5
+}
+export type PiiReplacement = string | ((match: string, keyPath: string[]) => string);
+export type LogMessage = string | Record<string, unknown> | Error;

package/dist/config/types/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = void 0;
+// ---- Types ----
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 5] = "FATAL";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));

package/dist/domain/index.d.ts

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

package/dist/domain/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("./services"), exports);

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

@@ -0,0 +1 @@
+export * from "./pii-redactor";

package/dist/domain/services/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("./pii-redactor"), exports);

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

@@ -0,0 +1,27 @@
+/**
+ * Domain Service: PiiRedactor
+ *
+ * Propósito:
+ * - Redactar/anonimizar PII en strings, objetos y arrays (deep).
+ * - Permitir que el cliente pase patrones adicionales/propios.
+ * - Controlar redacción por nombre de clave (whitelist/blacklist).
+ */
+import { IPiiPattern, IPiiRedactorOptions } from "../../config";
+export declare class PiiRedactor {
+    private readonly enabled;
+    private readonly patterns;
+    private readonly redactKeys;
+    private readonly preserveKeys;
+    constructor(opts?: IPiiRedactorOptions);
+    /** Patrones por defecto (seguros y genéricos). Ajusta según tu dominio/región si lo deseas. */
+    static defaultPatterns(): IPiiPattern[];
+    /** Punto de entrada público: redacción deep de cualquier estructura */
+    redact<T = unknown>(value: T): T;
+    /** === Internos === */
+    private redactValue;
+    private applyPatterns;
+    private isRedactedKey;
+    private isPreservedKey;
+    private keyRedactionReplacement;
+    private clone;
+}

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

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Domain Service: PiiRedactor
+ *
+ * Propósito:
+ * - Redactar/anonimizar PII en strings, objetos y arrays (deep).
+ * - Permitir que el cliente pase patrones adicionales/propios.
+ * - Controlar redacción por nombre de clave (whitelist/blacklist).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PiiRedactor = void 0;
+class PiiRedactor {
+    constructor(opts = {}) {
+        const { enabled = true, includeDefaultPatterns = true, patterns = [], redactKeys = [], preserveKeys = [], } = opts;
+        this.enabled = enabled;
+        this.patterns = includeDefaultPatterns
+            ? [...PiiRedactor.defaultPatterns(), ...patterns]
+            : [...patterns];
+        this.redactKeys = redactKeys;
+        this.preserveKeys = preserveKeys;
+    }
+    /** Patrones por defecto (seguros y genéricos). Ajusta según tu dominio/región si lo deseas. */
+    static defaultPatterns() {
+        return [
+            // Tarjetas (13–19 dígitos con espacios o guiones) — patrón simple
+            {
+                name: "credit_card",
+                regex: /\b(?:\d[ -]*?){13,19}\b/g,
+                replacement: "[REDACTED_CARD]",
+            },
+            // Emails
+            {
+                name: "email",
+                regex: /\b[\w._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g,
+                replacement: "[REDACTED_EMAIL]",
+            },
+            // Teléfonos: 10+ dígitos (ajusta a tu región si hace falta)
+            {
+                name: "phone",
+                regex: /\b\d{10,}\b/g,
+                replacement: "[REDACTED_PHONE]",
+            },
+            // Documento genérico: ABC-123456… o similar
+            {
+                name: "document_id",
+                regex: /\b[A-Z]{1,3}-?\d{6,10}\b/g,
+                replacement: "[REDACTED_ID]",
+            },
+            // IPv4
+            {
+                name: "ipv4",
+                regex: /\b(?:(?:25[0-5]|2[0-4]\d|1?\d?\d)(?:\.|$)){4}\b/g,
+                replacement: "[REDACTED_IP]",
+            },
+        ];
+    }
+    /** Punto de entrada público: redacción deep de cualquier estructura */
+    redact(value) {
+        if (!this.enabled)
+            return value;
+        return this.redactValue(value, []);
+    }
+    /** === Internos === */
+    redactValue(value, keyPath) {
+        // Strings → aplicar patrones
+        if (typeof value === "string") {
+            return this.applyPatterns(value, keyPath);
+        }
+        // Números / boolean / null / undefined → retornar tal cual
+        if (typeof value === "number" ||
+            typeof value === "boolean" ||
+            value === null ||
+            typeof value === "undefined") {
+            return value;
+        }
+        // Arrays → deep
+        if (Array.isArray(value)) {
+            return value.map((v, i) => this.redactValue(v, [...keyPath, String(i)]));
+        }
+        // Objetos → deep + reglas por nombre de clave
+        if (typeof value === "object") {
+            const src = value;
+            const out = {};
+            for (const [k, v] of Object.entries(src)) {
+                const path = [...keyPath, k];
+                if (this.isPreservedKey(k)) {
+                    out[k] = this.clone(v); // explícitamente preservado
+                    continue;
+                }
+                if (this.isRedactedKey(k)) {
+                    out[k] = this.keyRedactionReplacement(k, path);
+                    continue;
+                }
+                out[k] = this.redactValue(v, path);
+            }
+            return out;
+        }
+        // funciones, símbolos, etc.
+        return value;
+    }
+    applyPatterns(text, keyPath) {
+        let result = text;
+        for (const p of this.patterns) {
+            const replacement = p.replacement ?? "[REDACTED]";
+            // Soporta función de reemplazo con contexto (ruta de claves)
+            if (typeof replacement === "function") {
+                result = result.replace(p.regex, (m) => replacement(m, keyPath));
+            }
+            else {
+                result = result.replace(p.regex, replacement);
+            }
+        }
+        return result;
+    }
+    isRedactedKey(key) {
+        return this.redactKeys.some((r) => typeof r === "string" ? r === key : r.test(key));
+    }
+    isPreservedKey(key) {
+        return this.preserveKeys.some((r) => typeof r === "string" ? r === key : r.test(key));
+    }
+    keyRedactionReplacement(_key, _path) {
+        return "[REDACTED]";
+    }
+    clone(v) {
+        if (v && typeof v === "object") {
+            try {
+                return JSON.parse(JSON.stringify(v));
+            }
+            catch {
+                // fallback shallow
+                if (Array.isArray(v))
+                    return [...v];
+                return { ...v };
+            }
+        }
+        return v;
+    }
+}
+exports.PiiRedactor = PiiRedactor;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-export * from "./interfaces";
-export * from "./Factory";
-export * from "./Composite";
+export * from "./composite";
+export * from "./domain";
+export * from "./presentation";
+export * from "./config";

package/dist/index.js

@@ -14,6 +14,7 @@ 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("./interfaces"), exports);
-__exportStar(require("./Factory"), exports);
-__exportStar(require("./Composite"), exports);
+__exportStar(require("./composite"), exports);
+__exportStar(require("./domain"), exports);
+__exportStar(require("./presentation"), exports);
+__exportStar(require("./config"), exports);

package/dist/presentation/factory/index.d.ts

@@ -0,0 +1,2 @@
+import { ICreateLoggerOptions, ILogDatasource, ILogger } from "../..";
+export declare function createLogger(ds: ILogDatasource, opts?: ICreateLoggerOptions): ILogger;

package/dist/presentation/factory/index.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const __1 = require("../..");
+/**
+ * Normaliza cualquier LogMessage a string, aplicando PII (si procede) ANTES de serializar.
+ */
+function normalizeLogMessage(value, redactEnabled, redactor) {
+    const v = redactEnabled ? redactor.redact(value) : value;
+    if (typeof v === "string")
+        return v;
+    // Si soportas Error en LogMessage, lo serializamos “bonito”
+    if (v instanceof Error) {
+        const err = v;
+        const obj = {
+            error: err.name || "Error",
+            message: err.message,
+            stack: err.stack,
+            code: err.code,
+            cause: err.cause,
+        };
+        try {
+            return JSON.stringify(obj);
+        }
+        catch {
+            return `${obj.error}: ${obj.message}`;
+        }
+    }
+    // Objeto → JSON
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        // fallback ultra defensivo
+        return String(v);
+    }
+}
+function createLogger(ds, opts = {}) {
+    const minLevel = opts.minLevel ?? __1.LogLevel.INFO;
+    // Compatibilidad: redactPII (boolean) o pii.enabled
+    const redactEnabled = (opts.redactPII ?? false) || (opts.pii?.enabled ?? false);
+    // Inicializa redactor con opciones del cliente (incluye defaults por defecto)
+    const redactor = new __1.PiiRedactor({
+        enabled: redactEnabled,
+        includeDefaultPatterns: opts.pii?.includeDefaultPatterns ?? true,
+        patterns: opts.pii?.patterns,
+        redactKeys: opts.pii?.redactKeys,
+        preserveKeys: opts.pii?.preserveKeys,
+    });
+    const emit = async (level, message, meta) => {
+        if (level < minLevel)
+            return;
+        const msgStr = normalizeLogMessage(message, redactEnabled, redactor);
+        const metaVal = redactEnabled ? redactor.redact(meta) : meta;
+        const payload = {
+            level,
+            timestamp: Date.now(),
+            message: msgStr, // <- garantizamos string
+            meta: metaVal,
+        };
+        await ds.save(payload);
+    };
+    const logger = {
+        trace: (m, meta) => emit(__1.LogLevel.TRACE, m, meta),
+        debug: (m, meta) => emit(__1.LogLevel.DEBUG, m, meta),
+        info: (m, meta) => emit(__1.LogLevel.INFO, m, meta),
+        warn: (m, meta) => emit(__1.LogLevel.WARN, m, meta),
+        error: (m, meta) => emit(__1.LogLevel.ERROR, m, meta),
+        fatal: (m, meta) => emit(__1.LogLevel.FATAL, m, meta),
+        flush: () => ds.flush?.() ?? Promise.resolve(),
+        dispose: () => ds.dispose?.() ?? Promise.resolve(),
+    };
+    return logger;
+}

package/dist/presentation/index.d.ts

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

package/dist/presentation/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("./factory"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmlq/logger",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.2",
   "author": "MLahuasi",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,7 +9,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "pnpm build"
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",