@x12i/logxer 4.0.0

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * logxer - Main Entry Point
+ *
+ * This file exports all public APIs and provides the main factory function.
+ */
+export type { LogLevel, LogFormat, LoggingConfig, SanitizationConfig, CustomLogxer, LogxerPackageConfig, LogEntry, InternalLoggingConfig, LogMeta, RoutingMeta, UnifiedLoggerConfig, UnifiedLoggerTransports, ShadowConfig, ShadowController } from './types';
+export { Logxer } from './logxer';
+import { Logxer } from './logxer';
+import type { LogxerPackageConfig, LoggingConfig } from './types';
+export { parsePackageLogsLevelString, resolvePackageLogsLevel, packageLogsLevelEnvKey, legacyPackageLogLevelEnvKey } from './utils/package-logs-level';
+export type { ResolvePackageLogsLevelOptions } from './utils/package-logs-level';
+/**
+ * Create a package-specific logxer instance
+ *
+ * @param packageConfig - Package identification (name, env prefix, debug namespace)
+ * @param userConfig - Optional logging configuration
+ * @returns Logxer instance configured for the package
+ *
+ * @example
+ * ```typescript
+ * import { createLogxer } from '@x12i/logxer';
+ *
+ * // Zero-config mode (ERC 2.0): Auto-discovers from environment variables
+ * // Set MY_APP_LOGS_LEVEL (canonical) or MY_APP_LOG_LEVEL (legacy) — see docs/package-usage.md
+ * const logxer = createLogxer(
+ *   { packageName: 'MY_APP', envPrefix: 'MY_APP', debugNamespace: 'my-app' }
+ * );
+ *
+ * // Advanced mode: Explicit configuration
+ * const logxer = createLogxer(
+ *   { packageName: 'MY_APP', envPrefix: 'MY_APP', debugNamespace: 'my-app' },
+ *   { logToFile: true, logFilePath: '/var/log/myapp.log' }
+ * );
+ *
+ * logxer.info('Application initialized');
+ * ```
+ */
+export declare function createLogxer(packageConfig: LogxerPackageConfig, userConfig?: LoggingConfig): Logxer;
+declare const _default: {
+    createLogxer: typeof createLogxer;
+    Logxer: typeof Logxer;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,qBAAqB,EACrB,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlC,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAiF,MAAM,SAAS,CAAC;AAEjJ,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,mBAAmB,EAClC,UAAU,CAAC,EAAE,aAAa,GACzB,MAAM,CAkLR;;;;;AAGD,wBAGE"}

package/dist/index.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * logxer - Main Entry Point
+ *
+ * This file exports all public APIs and provides the main factory function.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.legacyPackageLogLevelEnvKey = exports.packageLogsLevelEnvKey = exports.resolvePackageLogsLevel = exports.parsePackageLogsLevelString = exports.Logxer = void 0;
+exports.createLogxer = createLogxer;
+// Re-export the Logxer class
+var logxer_1 = require("./logxer");
+Object.defineProperty(exports, "Logxer", { enumerable: true, get: function () { return logxer_1.Logxer; } });
+// Import Logxer for the factory function
+const logxer_2 = require("./logxer");
+const unified_logger_output_1 = require("./outputs/unified-logger-output");
+const yaml_formatter_1 = require("./formatters/yaml-formatter");
+const table_formatter_1 = require("./formatters/table-formatter");
+const app_info_1 = require("./app-info");
+var package_logs_level_1 = require("./utils/package-logs-level");
+Object.defineProperty(exports, "parsePackageLogsLevelString", { enumerable: true, get: function () { return package_logs_level_1.parsePackageLogsLevelString; } });
+Object.defineProperty(exports, "resolvePackageLogsLevel", { enumerable: true, get: function () { return package_logs_level_1.resolvePackageLogsLevel; } });
+Object.defineProperty(exports, "packageLogsLevelEnvKey", { enumerable: true, get: function () { return package_logs_level_1.packageLogsLevelEnvKey; } });
+Object.defineProperty(exports, "legacyPackageLogLevelEnvKey", { enumerable: true, get: function () { return package_logs_level_1.legacyPackageLogLevelEnvKey; } });
+/**
+ * Create a package-specific logxer instance
+ *
+ * @param packageConfig - Package identification (name, env prefix, debug namespace)
+ * @param userConfig - Optional logging configuration
+ * @returns Logxer instance configured for the package
+ *
+ * @example
+ * ```typescript
+ * import { createLogxer } from '@x12i/logxer';
+ *
+ * // Zero-config mode (ERC 2.0): Auto-discovers from environment variables
+ * // Set MY_APP_LOGS_LEVEL (canonical) or MY_APP_LOG_LEVEL (legacy) — see docs/package-usage.md
+ * const logxer = createLogxer(
+ *   { packageName: 'MY_APP', envPrefix: 'MY_APP', debugNamespace: 'my-app' }
+ * );
+ *
+ * // Advanced mode: Explicit configuration
+ * const logxer = createLogxer(
+ *   { packageName: 'MY_APP', envPrefix: 'MY_APP', debugNamespace: 'my-app' },
+ *   { logToFile: true, logFilePath: '/var/log/myapp.log' }
+ * );
+ *
+ * logxer.info('Application initialized');
+ * ```
+ */
+function createLogxer(packageConfig, userConfig) {
+    // Resolve configuration with defaults
+    const resolved = {
+        logToConsole: userConfig?.logToConsole ?? true,
+        logToFile: userConfig?.logToFile ?? false,
+        logFilePath: userConfig?.logFilePath ?? '',
+        logLevel: userConfig?.logLevel ?? 'info',
+        logFormat: userConfig?.logFormat ?? 'table', // Default to table format
+        showFullTimestamp: userConfig?.showFullTimestamp ?? false, // Default to false
+        ...(userConfig?.consolePackagesShow !== undefined ? { consolePackagesShow: userConfig.consolePackagesShow } : {}),
+        ...(userConfig?.consolePackagesHide !== undefined ? { consolePackagesHide: userConfig.consolePackagesHide } : {}),
+        enableUnifiedLogger: userConfig?.enableUnifiedLogger ?? false,
+        unifiedLogger: userConfig?.unifiedLogger ?? {},
+        defaultSource: userConfig?.defaultSource ?? 'application',
+        sanitization: userConfig?.sanitization ?? {},
+        customLogger: userConfig?.customLogger,
+        transports: userConfig?.transports ?? undefined,
+        tracing: userConfig?.tracing ?? undefined,
+        trails: userConfig?.trails ?? undefined,
+        schemaCheck: userConfig?.schemaCheck ?? { enabled: false },
+        shadow: userConfig?.shadow ?? undefined,
+        debugScoping: userConfig?.debugScoping ?? undefined
+    };
+    const sinks = {};
+    // Automatically detect consuming application's package name and version
+    const appInfo = (0, app_info_1.detectAppInfo)();
+    // Console sink (existing behavior)
+    // Priority order: table (default) → yaml → json → text
+    if (resolved.logToConsole) {
+        sinks.console = (level, msg, meta) => {
+            if (resolved.logFormat === 'table') {
+                // Table format (default): create envelope and output as table
+                const envelope = {
+                    timestamp: new Date().toISOString(),
+                    package: packageConfig.packageName,
+                    level: level.toUpperCase(),
+                    message: msg,
+                    source: meta?.source ?? resolved.defaultSource ?? 'application',
+                    ...(meta && { data: meta }),
+                    ...(appInfo.name && { appName: appInfo.name }),
+                    ...(appInfo.version && { appVersion: appInfo.version }),
+                    // Include other metadata fields if present
+                    ...(meta?.identity && { identity: meta.identity }),
+                    ...(meta?.correlationId && { correlationId: meta.correlationId }),
+                    ...(meta?.jobId && { jobId: meta.jobId }),
+                    ...(meta?.runId && { runId: meta.runId }),
+                    ...(meta?.sessionId && { sessionId: meta.sessionId }),
+                    ...(meta?.tags && { tags: meta.tags })
+                };
+                const showFullTimestamp = userConfig?.showFullTimestamp ?? false;
+                (0, table_formatter_1.outputLogAsTable)(envelope, showFullTimestamp);
+            }
+            else if (resolved.logFormat === 'yaml') {
+                // YAML format: create envelope and format as YAML
+                const envelope = {
+                    timestamp: new Date().toISOString(),
+                    package: packageConfig.packageName,
+                    level: level.toUpperCase(),
+                    message: msg,
+                    source: meta?.source ?? resolved.defaultSource ?? 'application',
+                    ...(meta && { data: meta }),
+                    ...(appInfo.name && { appName: appInfo.name }),
+                    ...(appInfo.version && { appVersion: appInfo.version }),
+                    // Include other metadata fields if present
+                    ...(meta?.identity && { identity: meta.identity }),
+                    ...(meta?.correlationId && { correlationId: meta.correlationId }),
+                    ...(meta?.tags && { tags: meta.tags }),
+                    ...(meta?._routing && { _routing: meta._routing })
+                };
+                console.log((0, yaml_formatter_1.formatLogEntryAsYaml)(envelope));
+            }
+            else if (resolved.logFormat === 'json') {
+                // JSON format: keep v1 JSON structure stable; add source/correlation when present
+                const payload = {
+                    timestamp: new Date().toISOString(),
+                    package: packageConfig.packageName,
+                    level: level.toUpperCase(),
+                    message: msg,
+                    data: meta ? { ...meta } : undefined,
+                    ...(appInfo.name && { appName: appInfo.name }),
+                    ...(appInfo.version && { appVersion: appInfo.version }),
+                    ...(meta?.identity && { identity: meta.identity })
+                };
+                // Avoid nesting _routing/noise into "data" twice
+                if (meta?._routing) {
+                    delete payload.data._routing;
+                }
+                console.log(JSON.stringify(payload));
+            }
+            else {
+                // Text format: fallback
+                const ts = new Date().toISOString();
+                const src = meta?.source ? `[${meta.source}] ` : '';
+                const tail = meta ? ' ' + JSON.stringify(meta) : '';
+                // Text format from v1 preserved, with optional source
+                console.log(`[${ts}] [${packageConfig.packageName}] [${level.toUpperCase()}] ${src}${msg}${tail}`);
+            }
+        };
+    }
+    // File sink (existing behavior preserved)
+    // Table format is console-only, so fall back to text for file output
+    const fileFormat = resolved.logFormat === 'table' ? 'text' : resolved.logFormat;
+    if (resolved.logToFile && resolved.logFilePath) {
+        sinks.file = (level, msg, meta) => {
+            try {
+                let formatted;
+                if (fileFormat === 'json') {
+                    // JSON format for file
+                    const payload = {
+                        timestamp: new Date().toISOString(),
+                        package: packageConfig.packageName,
+                        level: level.toUpperCase(),
+                        message: msg,
+                        data: meta ? { ...meta } : undefined,
+                        ...(appInfo.name && { appName: appInfo.name }),
+                        ...(appInfo.version && { appVersion: appInfo.version })
+                    };
+                    if (meta?._routing) {
+                        delete payload.data._routing;
+                    }
+                    formatted = JSON.stringify(payload);
+                }
+                else if (fileFormat === 'yaml') {
+                    // YAML format: create envelope and format as YAML
+                    const envelope = {
+                        timestamp: new Date().toISOString(),
+                        package: packageConfig.packageName,
+                        level: level.toUpperCase(),
+                        message: msg,
+                        source: meta?.source ?? resolved.defaultSource ?? 'application',
+                        ...(meta && { data: meta }),
+                        ...(appInfo.name && { appName: appInfo.name }),
+                        ...(appInfo.version && { appVersion: appInfo.version }),
+                        // Include other metadata fields if present
+                        ...(meta?.correlationId && { correlationId: meta.correlationId }),
+                        ...(meta?.tags && { tags: meta.tags }),
+                        ...(meta?._routing && { _routing: meta._routing })
+                    };
+                    formatted = (0, yaml_formatter_1.formatLogEntryAsYaml)(envelope);
+                }
+                else {
+                    // Text format (default fallback, including when table is specified)
+                    const ts = new Date().toISOString();
+                    const src = meta?.source ? `[${meta.source}] ` : '';
+                    const tail = meta ? ' ' + JSON.stringify(meta) : '';
+                    formatted = `[${ts}] [${packageConfig.packageName}] [${level.toUpperCase()}] ${src}${msg}${tail}`;
+                }
+                const dir = require('path').dirname(resolved.logFilePath);
+                if (!require('fs').existsSync(dir)) {
+                    require('fs').mkdirSync(dir, { recursive: true });
+                }
+                require('fs').appendFileSync(resolved.logFilePath, formatted + '\n', 'utf8');
+            }
+            catch (err) {
+                console.error(`[logs-gateway] ${packageConfig.packageName}: Failed to write to log file:`, err);
+            }
+        };
+    }
+    // Unified-logger (NEW, optional)
+    if (resolved.enableUnifiedLogger) {
+        sinks.unified = new unified_logger_output_1.UnifiedLoggerOutput(resolved.unifiedLogger);
+    }
+    return new logxer_2.Logxer(packageConfig, userConfig, sinks);
+}
+// Default export for convenience
+exports.default = {
+    createLogxer,
+    Logxer: logxer_2.Logxer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logxer.d.ts

@@ -0,0 +1,145 @@
+/**
+ * logxer - Core Logxer Implementation
+ *
+ * This file contains the main Logxer class that handles all logging functionality.
+ */
+import { LogLevel, LoggingConfig, LogxerPackageConfig, InternalLoggingConfig, LogMeta, ShadowController } from './types';
+import { UnifiedLoggerOutput } from './outputs/unified-logger-output';
+/**
+ * Main Logxer class for handling all logging operations
+ */
+export declare class Logxer {
+    private config;
+    private packageConfig;
+    private sanitizer;
+    private shadowSink?;
+    readonly shadow: ShadowController;
+    private appInfo;
+    private debugScopingConfig;
+    private levelPriority;
+    private sinks;
+    private activeBetweenRanges;
+    constructor(packageConfig: LogxerPackageConfig, userConfig?: LoggingConfig, sinks?: {
+        console?: (level: LogLevel, msg: string, meta?: LogMeta) => void;
+        file?: (level: LogLevel, msg: string, meta?: LogMeta) => void;
+        unified?: UnifiedLoggerOutput;
+    });
+    /**
+     * Parse shadow configuration from user config and environment variables
+     */
+    private parseShadowConfig;
+    /**
+     * Create a no-op shadow controller for when shadow is disabled
+     */
+    private createNoOpController;
+    /**
+     * Ensure the log directory exists, creating it if necessary
+     */
+    private ensureLogDirectory;
+    /**
+     * Check if a log level should be output based on current configuration
+     */
+    private shouldLog;
+    /**
+     * Check if a specific output should receive the log based on routing metadata
+     */
+    private shouldSend;
+    /**
+     * Check if a search string matches any identity in a list
+     *
+     * @param searchString - The string to search for
+     * @param identityList - List of identity patterns to match against
+     * @param exactMatch - If true: exact match (case sensitive), if false: partial match (case insensitive)
+     * @returns true if any identity in the list matches
+     */
+    private matchesIdentity;
+    /**
+     * Extract searchable text from log entry
+     * Combines message, identity, and all meta fields (recursively stringified)
+     *
+     * @param message - Log message
+     * @param identity - Log identity
+     * @param meta - Log metadata
+     * @returns Combined searchable string
+     */
+    private getSearchableLogText;
+    /**
+     * Update the state of between ranges based on current log entry
+     *
+     * @param message - Log message
+     * @param identity - Log identity
+     * @param meta - Log metadata
+     */
+    private updateBetweenRangeState;
+    /**
+     * Check if a log should be included based on debug scoping configuration
+     * Filters logs at runtime based on identity and application name
+     *
+     * @param message - Log message
+     * @param identity - Log identity (file:function format)
+     * @param appName - Application name
+     * @param meta - Log metadata
+     * @returns true if log should be included, false if it should be filtered out
+     */
+    private shouldIncludeLog;
+    /**
+     * Check if a package should be shown in console output based on filtering rules
+     * Only affects console output, not file or unified-logger
+     */
+    private shouldShowPackageInConsole;
+    /**
+     * Get call site identity from stack trace
+     * Extracts file path and function name from the call stack
+     * Returns a clean identity string like "src/file.ts:functionName" or "src/file.ts:lineNumber"
+     */
+    private getCallSiteIdentity;
+    /**
+     * Format a log entry according to the configured format
+     */
+    private formatLogEntry;
+    /**
+     * Write formatted message to console
+     */
+    private writeToConsole;
+    /**
+     * Write formatted message to log file
+     */
+    private writeToFile;
+    /**
+     * Core logging method that handles all log output
+     */
+    private emit;
+    /**
+     * Log verbose message (only shown when logLevel is 'verbose' or 'debug')
+     */
+    verbose(message: string, data?: LogMeta): void;
+    /**
+     * Log debug message (only shown when logLevel is 'debug' or 'verbose')
+     */
+    debug(message: string, data?: LogMeta): void;
+    /**
+     * Log informational message
+     */
+    info(message: string, data?: LogMeta): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, data?: LogMeta): void;
+    /**
+     * Log error message
+     */
+    error(message: string, data?: LogMeta): void;
+    /**
+     * Log success message (maps to INFO level)
+     */
+    success(message: string, data?: LogMeta): void;
+    /**
+     * Get current logxer configuration (for debugging/testing)
+     */
+    getConfig(): Readonly<InternalLoggingConfig>;
+    /**
+     * Check if a specific log level is enabled
+     */
+    isLevelEnabled(level: LogLevel): boolean;
+}
+//# sourceMappingURL=logxer.d.ts.map

package/dist/logxer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logxer.d.ts","sourceRoot":"","sources":["../src/logxer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,QAAQ,EAER,aAAa,EACb,mBAAmB,EAEnB,qBAAqB,EACrB,OAAO,EAEP,gBAAgB,EACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAStE;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,SAAgB,MAAM,EAAE,gBAAgB,CAAC;IACzC,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,kBAAkB,CAAqC;IAC/D,OAAO,CAAC,aAAa,CAMnB;IACF,OAAO,CAAC,KAAK,CAIX;IACF,OAAO,CAAC,mBAAmB,CAA0B;gBAGnD,aAAa,EAAE,mBAAmB,EAClC,UAAU,CAAC,EAAE,aAAa,EAC1B,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QACjE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QAC9D,OAAO,CAAC,EAAE,mBAAmB,CAAC;KAC/B;IA4IH;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAoE/B;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IA2ExB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAelC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAyE3B;;OAEG;IACH,OAAO,CAAC,cAAc;IA2DtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,IAAI;IA+GZ;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,qBAAqB,CAAC;IAI5C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;CAGzC"}