@jmlq/logger 0.1.0-alpha.1 → 0.1.0-alpha.11

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

@@ -1,139 +0,0 @@
-"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,4 +0,0 @@
-export * from "./composite";
-export * from "./domain";
-export * from "./presentation";
-export * from "./config";

package/dist/interfaces/index.d.ts

@@ -1,35 +0,0 @@
-export declare enum LogLevel {
-    TRACE = 0,
-    DEBUG = 1,
-    INFO = 2,
-    WARN = 3,
-    ERROR = 4,
-    FATAL = 5
-}
-export interface Log {
-    level: LogLevel;
-    message: string;
-    meta?: unknown;
-    timestamp: number;
-}
-export interface GetLogsFilter {
-    levelMin?: LogLevel;
-    since?: number;
-    until?: number;
-}
-export interface ILogDatasource {
-    save(log: Log): Promise<void>;
-    find?(filter?: GetLogsFilter): Promise<Log[]>;
-    flush?(): Promise<void>;
-    dispose?(): Promise<void>;
-}
-export interface Logger {
-    trace: (msg: string, meta?: unknown) => Promise<void>;
-    debug: (msg: string, meta?: unknown) => Promise<void>;
-    info: (msg: string, meta?: unknown) => Promise<void>;
-    warn: (msg: string, meta?: unknown) => Promise<void>;
-    error: (msg: string, meta?: unknown) => Promise<void>;
-    fatal: (msg: string, meta?: unknown) => Promise<void>;
-    flush?: () => Promise<void>;
-    dispose?: () => Promise<void>;
-}

package/dist/interfaces/index.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogLevel = void 0;
-// ---- Types & contratos ----
-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/presentation/factory/index.js

@@ -1,74 +0,0 @@
-"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

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