@x12i/logxer 4.0.0

package/dist/outputs/unified-logger-output.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * logs-gateway - Unified Logger Output Implementation
+ *
+ * This file handles integration with @x-developer/unified-logger for Papertrail/UDP/Console output.
+ *
+ * Note: This transport always receives structured data (JSON format) regardless of the
+ * configured logFormat setting. YAML formatting only applies to console and file outputs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnifiedLoggerOutput = void 0;
+const unified_logger_1 = require("@x-developer/unified-logger");
+const app_info_1 = require("../app-info");
+/**
+ * Unified logger output handler
+ */
+class UnifiedLoggerOutput {
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.initialized = false;
+    }
+    /**
+     * Initialize the unified logger if not already done
+     */
+    ensureInit() {
+        if (this.initialized)
+            return;
+        try {
+            if (this.cfg.configPath) {
+                (0, unified_logger_1.initLogger)(this.cfg.configPath);
+            }
+            else if (this.cfg.configInline) {
+                (0, unified_logger_1.initLogger)(this.cfg.configInline);
+            }
+            else {
+                // Create inline configuration
+                const inline = {
+                    service: this.cfg.service ?? 'logs-gateway',
+                    env: this.cfg.env ?? process.env.NODE_ENV ?? 'production',
+                    level: (this.cfg.level ?? 'info').toUpperCase(),
+                    transports: {
+                        console: {
+                            enabled: this.cfg.transports?.console ?? false
+                        },
+                        papertrail: {
+                            enabled: this.cfg.transports?.papertrail ?? false,
+                            host: process.env.PAPERTRAIL_HOST || '',
+                            port: Number(process.env.PAPERTRAIL_PORT || 0),
+                            program: this.cfg.service ?? 'logs-gateway'
+                        },
+                        udpRelay: {
+                            enabled: this.cfg.transports?.udpRelay ?? false,
+                            host: process.env.UDP_RELAY_HOST || '127.0.0.1',
+                            port: Number(process.env.UDP_RELAY_PORT || 0),
+                            maxPacketBytes: 65000
+                        }
+                    }
+                };
+                (0, unified_logger_1.initLogger)(inline);
+            }
+            this.initialized = true;
+        }
+        catch (err) {
+            console.error('[logs-gateway] Failed to initialize unified-logger:', err);
+            // Don't throw - this is an optional output
+        }
+    }
+    /**
+     * Map logs-gateway log levels to unified-logger levels
+     */
+    mapLevel(level) {
+        switch (level) {
+            case 'debug': return 'debug';
+            case 'info': return 'info';
+            case 'warn': return 'warn';
+            case 'error': return 'error';
+            default: return 'info';
+        }
+    }
+    /**
+     * Write a log entry to unified-logger
+     */
+    write(level, message, meta) {
+        // Check level filter
+        if (this.cfg.levels && !this.cfg.levels.includes(level)) {
+            return;
+        }
+        // Respect routing metadata when present
+        if (meta?._routing?.blockOutputs?.includes('unified-logger')) {
+            return;
+        }
+        if (meta?._routing?.allowedOutputs && !meta._routing.allowedOutputs.includes('unified-logger')) {
+            return;
+        }
+        this.ensureInit();
+        if (!this.initialized) {
+            return; // Failed to initialize, skip silently
+        }
+        try {
+            const mappedLevel = this.mapLevel(level);
+            const appInfo = (0, app_info_1.detectAppInfo)();
+            const payload = {
+                ...meta,
+                source: meta?.source ?? 'application',
+                ...(appInfo.name && { appName: appInfo.name }),
+                ...(appInfo.version && { appVersion: appInfo.version })
+            };
+            if (meta?.correlationId) {
+                payload.correlationId = meta.correlationId;
+            }
+            if (meta?.identity) {
+                payload.identity = meta.identity;
+            }
+            // Remove routing metadata from the payload to avoid noise
+            delete payload._routing;
+            unified_logger_1.logger[mappedLevel](message, payload);
+        }
+        catch (err) {
+            console.error('[logs-gateway] Failed to write to unified-logger:', err);
+            // Don't throw - this is an optional output
+        }
+    }
+}
+exports.UnifiedLoggerOutput = UnifiedLoggerOutput;
+//# sourceMappingURL=unified-logger-output.js.map

package/dist/outputs/unified-logger-output.js.map

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

package/dist/sanitizer.d.ts

@@ -0,0 +1,69 @@
+/**
+ * logs-gateway - PII/Credentials Sanitizer
+ *
+ * This file contains the sanitization logic for detecting and masking sensitive data.
+ * Uses established npm packages for robust PII detection and sanitization.
+ */
+import { SanitizationConfig } from './types';
+/**
+ * Sanitization result with metadata about what was sanitized
+ */
+export interface SanitizationResult {
+    sanitized: any;
+    redactionCount: number;
+    truncated: boolean;
+}
+/**
+ * Main sanitizer class for detecting and masking PII/credentials
+ */
+export declare class LogSanitizer {
+    private config;
+    constructor(config: SanitizationConfig);
+    /**
+     * Initialize fast-redact with configuration
+     */
+    /**
+     * Sanitize a log entry's message and metadata
+     */
+    sanitize(message: string, meta?: any): SanitizationResult;
+    /**
+     * Whether `fullPath` (lowercase, dot-separated) matches a deny/allow pattern.
+     * - `password` matches only path `password` (single segment).
+     * - `user.password` matches exactly that path.
+     * - `*.token` matches one segment + `.token` (e.g. `api.token`).
+     */
+    private pathMatchesPattern;
+    /**
+     * Sanitize an object recursively
+     */
+    private sanitizeObject;
+    /**
+     * Sanitize a string value
+     */
+    private sanitizeString;
+    /**
+     * Detect and mask sensitive patterns in a string using npm packages
+     */
+    detectAndMask(str: string): string;
+    /**
+     * Fallback pattern detection if npm packages fail
+     */
+    private fallbackPatternDetection;
+    /**
+     * Detect credentials and API keys using custom patterns
+     */
+    detectCredentials(str: string): string;
+    /**
+     * Apply pattern detection to object values
+     */
+    private applyPatternDetectionToObject;
+    /**
+     * Hash a value using SHA-256
+     */
+    private hashValue;
+    /**
+     * Validate credit card number using Luhn algorithm
+     */
+    private isValidCreditCard;
+}
+//# sourceMappingURL=sanitizer.d.ts.map

package/dist/sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../src/sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,GAAG,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA+B;gBAGjC,MAAM,EAAE,kBAAkB;IA6BtC;;OAEG;IAgBH;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,kBAAkB;IAsEzD;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmHtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAyCzC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+ChC;;OAEG;IACI,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAqE7C;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA4CrC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA2B1B"}