@xopcai/xopc 0.0.92 → 0.0.94

package/dist/src/utils/index.js

@@ -1,17 +1,17 @@
 import { getLogDir, getLoggerConfig } from "./logger/config.js";
-import { getLogStats } from "./logger/stats.js";
+import { getRuntimeLogStats } from "./logger/stats.js";
 import { flushAndClose, isLoggerShuttingDown, setShuttingDown } from "./logger/shutdown.js";
 import { cleanOldLogs, rotateLogs } from "./logger/rotation.js";
-import { clearRequestContext, getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, setRequestContext, updateAsyncLogContext } from "./logger/context.js";
+import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { isLogRedactionEnabled, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./logger/redact.js";
 import { exportLog, flushExporters, getExporters, initializeExporters } from "./logger/exporters.js";
 import { configureAuditLog, getAuditConfig, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./logger/audit.js";
-import { Pino as pino, baseLogger as logger, createExtensionLogger, createLogger, createModuleLogger, createRequestLogger, createServiceLogger, getLogLevel, isLevelEnabled, registerShutdownHandler, setLogLevel, withLogLevel } from "./logger/index.js";
+import { Pino as pino, baseLogger as logger, createExtensionLogger, createLogger, createModuleLogger, createServiceLogger, getLogLevel, isLevelEnabled, setLogLevel, withLogLevel } from "./logger/index.js";
 import { init_logger } from "./logger.js";
 import { createPathResolver, getWorkspacePath, resolveToCwd } from "./helpers.js";
 //#region src/utils/index.ts
 init_logger();
 //#endregion
-export { pino as Pino, logger as baseLogger, logger, cleanOldLogs, clearRequestContext as clearRequestLogger, configureAuditLog, createExtensionLogger, createLogger, createModuleLogger, createPathResolver, createRequestLogger, createServiceLogger, exportLog, flushAndClose, flushExporters, getAsyncLogContext, getAuditConfig, getExporters, getLogDir, getLogLevel, getLogStats, getLoggerConfig, getWorkspacePath, inboundCorrelationMetadataFromAsyncLogContext, initializeExporters, isLevelEnabled, isLogRedactionEnabled, isLoggerShuttingDown, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo, registerShutdownHandler, resolveToCwd, rotateLogs, runWithLogContext, setLogLevel, setRequestContext as setRequestLogger, setShuttingDown, updateAsyncLogContext, withLogLevel };
+export { pino as Pino, logger as baseLogger, logger, cleanOldLogs, configureAuditLog, createExtensionLogger, createLogger, createModuleLogger, createPathResolver, createServiceLogger, exportLog, flushAndClose, flushExporters, getAsyncLogContext, getAuditConfig, getExporters, getLogDir, getLogLevel, getLoggerConfig, getRuntimeLogStats, getWorkspacePath, inboundCorrelationMetadataFromAsyncLogContext, initializeExporters, isLevelEnabled, isLogRedactionEnabled, isLoggerShuttingDown, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo, resolveToCwd, rotateLogs, runWithLogContext, setLogLevel, setShuttingDown, updateAsyncLogContext, withLogLevel };
 
 //# sourceMappingURL=index.js.map

package/dist/src/utils/logger/config.js

@@ -10,9 +10,7 @@ import path from "path";
 */
 function loadConfig() {
 	const config = { ...DEFAULT_CONFIG };
-	const logLevel = process.env.XOPC_LOG_LEVEL || process.env.LOG_LEVEL;
-	if (logLevel) config.level = logLevel.toLowerCase();
-	else if (process.env.DEBUG) config.level = "debug";
+	if (process.env.XOPC_LOG_LEVEL) config.level = process.env.XOPC_LOG_LEVEL.toLowerCase();
 	if (process.env.XOPC_LOG_DIR) config.logDir = process.env.XOPC_LOG_DIR;
 	if (process.env.XOPC_LOG_CONSOLE === "false") config.consoleOutput = false;
 	if (process.env.XOPC_LOG_FILE === "false") config.fileOutput = false;
@@ -42,9 +40,7 @@ var init_config = __esmMin((() => {
 		errorFileOutput: true,
 		retentionDays: 7,
 		maxFileSizeMB: 100,
-		prettyPrint: false,
-		async: true,
-		debugSampleRate: 1
+		prettyPrint: false
 	};
 	config = loadConfig();
 }));

package/dist/src/utils/logger/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../../src/utils/logger/config.ts"],"sourcesContent":["/**\n * Logger Configuration\n * Centralized configuration loading from environment variables\n */\n\nimport path from 'path';\nimport type { LoggerConfig, LogLevel } from './types.js';\n\nconst DEFAULT_CONFIG: LoggerConfig = {\n  level: 'info',\n  logDir: path.join(process.env.HOME || '.', '.xopc', 'logs'),\n  consoleOutput: true,\n  fileOutput: true,\n  errorFileOutput: true,\n  retentionDays: 7,\n  maxFileSizeMB: 100,\n  prettyPrint: false,\n  async: true,\n  debugSampleRate: 1.0,\n};\n\n/**\n * Load configuration from environment variables\n */\nexport function loadConfig(): LoggerConfig {\n  const config: LoggerConfig = { ...DEFAULT_CONFIG };\n\n  // Log level - unified environment variable\n  const logLevel = process.env.XOPC_LOG_LEVEL || process.env.LOG_LEVEL;\n  if (logLevel) {\n    config.level = logLevel.toLowerCase() as LogLevel;\n  } else if (process.env.DEBUG) {\n    config.level = 'debug';\n  }\n\n  // Log directory\n  if (process.env.XOPC_LOG_DIR) {\n    config.logDir = process.env.XOPC_LOG_DIR;\n  }\n\n  // Output options\n  if (process.env.XOPC_LOG_CONSOLE === 'false') {\n    config.consoleOutput = false;\n  }\n  if (process.env.XOPC_LOG_FILE === 'false') {\n    config.fileOutput = false;\n  }\n\n  // Retention\n  if (process.env.XOPC_LOG_RETENTION_DAYS) {\n    config.retentionDays = parseInt(process.env.XOPC_LOG_RETENTION_DAYS, 10);\n  }\n\n  // Pretty print for development\n  if (process.env.NODE_ENV === 'development' || process.env.XOPC_PRETTY_LOGS === 'true') {\n    config.prettyPrint = true;\n  }\n\n  return config;\n}\n\n// Singleton config instance\nexport const config = loadConfig();\n\n/**\n * Get current log directory\n */\nexport function getLogDir(): string {\n  return config.logDir;\n}\n\n/**\n * Get logger configuration\n */\nexport function getLoggerConfig(): Readonly<LoggerConfig> {\n  return { ...config };\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,aAA2B;CACzC,MAAM,SAAuB,EAAE,GAAG,gBAAgB;CAGlD,MAAM,WAAW,QAAQ,IAAI,kBAAkB,QAAQ,IAAI;AAC3D,KAAI,SACF,QAAO,QAAQ,SAAS,aAAa;UAC5B,QAAQ,IAAI,MACrB,QAAO,QAAQ;AAIjB,KAAI,QAAQ,IAAI,aACd,QAAO,SAAS,QAAQ,IAAI;AAI9B,KAAI,QAAQ,IAAI,qBAAqB,QACnC,QAAO,gBAAgB;AAEzB,KAAI,QAAQ,IAAI,kBAAkB,QAChC,QAAO,aAAa;AAItB,KAAI,QAAQ,IAAI,wBACd,QAAO,gBAAgB,SAAS,QAAQ,IAAI,yBAAyB,GAAG;AAI1E,KAA8C,QAAQ,IAAI,qBAAqB,OAC7E,QAAO,cAAc;AAGvB,QAAO;;;;;AAST,SAAgB,YAAoB;AAClC,QAAO,OAAO;;;;;AAMhB,SAAgB,kBAA0C;AACxD,QAAO,EAAE,GAAG,QAAQ;;;;AAnEhB,kBAA+B;EACnC,OAAO;EACP,QAAQ,KAAK,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,OAAO;EAC3D,eAAe;EACf,YAAY;EACZ,iBAAiB;EACjB,eAAe;EACf,eAAe;EACf,aAAa;EACb,OAAO;EACP,iBAAiB;EAClB;AA2CY,UAAS,YAAY"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/utils/logger/config.ts"],"sourcesContent":["/**\n * Logger Configuration\n * Centralized configuration loading from environment variables\n */\n\nimport path from 'path';\nimport type { LoggerConfig, LogLevel } from './types.js';\n\nconst DEFAULT_CONFIG: LoggerConfig = {\n  level: 'info',\n  logDir: path.join(process.env.HOME || '.', '.xopc', 'logs'),\n  consoleOutput: true,\n  fileOutput: true,\n  errorFileOutput: true,\n  retentionDays: 7,\n  maxFileSizeMB: 100,\n  prettyPrint: false,\n};\n\n/**\n * Load configuration from environment variables\n */\nexport function loadConfig(): LoggerConfig {\n  const config: LoggerConfig = { ...DEFAULT_CONFIG };\n\n  // Log level\n  if (process.env.XOPC_LOG_LEVEL) {\n    config.level = process.env.XOPC_LOG_LEVEL.toLowerCase() as LogLevel;\n  }\n\n  // Log directory\n  if (process.env.XOPC_LOG_DIR) {\n    config.logDir = process.env.XOPC_LOG_DIR;\n  }\n\n  // Output options\n  if (process.env.XOPC_LOG_CONSOLE === 'false') {\n    config.consoleOutput = false;\n  }\n  if (process.env.XOPC_LOG_FILE === 'false') {\n    config.fileOutput = false;\n  }\n\n  // Retention\n  if (process.env.XOPC_LOG_RETENTION_DAYS) {\n    config.retentionDays = parseInt(process.env.XOPC_LOG_RETENTION_DAYS, 10);\n  }\n\n  // Pretty print for development\n  if (process.env.NODE_ENV === 'development' || process.env.XOPC_PRETTY_LOGS === 'true') {\n    config.prettyPrint = true;\n  }\n\n  return config;\n}\n\n// Singleton config instance\nexport const config = loadConfig();\n\n/**\n * Get current log directory\n */\nexport function getLogDir(): string {\n  return config.logDir;\n}\n\n/**\n * Get logger configuration\n */\nexport function getLoggerConfig(): Readonly<LoggerConfig> {\n  return { ...config };\n}\n"],"mappings":";;;;;;;;;;AAsBA,SAAgB,aAA2B;CACzC,MAAM,SAAuB,EAAE,GAAG,gBAAgB;AAGlD,KAAI,QAAQ,IAAI,eACd,QAAO,QAAQ,QAAQ,IAAI,eAAe,aAAa;AAIzD,KAAI,QAAQ,IAAI,aACd,QAAO,SAAS,QAAQ,IAAI;AAI9B,KAAI,QAAQ,IAAI,qBAAqB,QACnC,QAAO,gBAAgB;AAEzB,KAAI,QAAQ,IAAI,kBAAkB,QAChC,QAAO,aAAa;AAItB,KAAI,QAAQ,IAAI,wBACd,QAAO,gBAAgB,SAAS,QAAQ,IAAI,yBAAyB,GAAG;AAI1E,KAA8C,QAAQ,IAAI,qBAAqB,OAC7E,QAAO,cAAc;AAGvB,QAAO;;;;;AAST,SAAgB,YAAoB;AAClC,QAAO,OAAO;;;;;AAMhB,SAAgB,kBAA0C;AACxD,QAAO,EAAE,GAAG,QAAQ;;;;AA9DhB,kBAA+B;EACnC,OAAO;EACP,QAAQ,KAAK,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,OAAO;EAC3D,eAAe;EACf,YAAY;EACZ,iBAAiB;EACjB,eAAe;EACf,eAAe;EACf,aAAa;EACd;AAwCY,UAAS,YAAY"}

package/dist/src/utils/logger/context.d.ts

@@ -1,8 +1,8 @@
 /**
  * Logger Context
- * Context tracking and propagation for structured logging
+ * AsyncLocalStorage correlation for structured logging
  */
-import type { LogContext, ContextualLogger } from './types.js';
+import type { LogContext } from './types.js';
 /** Correlation fields merged into every log line while the store is active (via pino mixin). */
 declare const ASYNC_LOG_CORRELATION_KEYS: readonly ["requestId", "sessionId", "userId", "correlationId"];
 type AsyncLogCorrelationKey = (typeof ASYNC_LOG_CORRELATION_KEYS)[number];
@@ -21,25 +21,6 @@ export declare function updateAsyncLogContext(partial: LogContext): void;
 /** Keys injected from async context into log records (used by logger mixin). */
 export declare function getAsyncLogCorrelationKeys(): readonly AsyncLogCorrelationKey[];
 export declare function inboundCorrelationMetadataFromAsyncLogContext(): Record<string, unknown> | undefined;
-/**
- * Merge two contexts
- */
+/** Shallow-merge two log context objects. */
 export declare function mergeContext(base: LogContext, additional: LogContext): LogContext;
-/**
- * Store context for a request ID
- */
-export declare function setRequestContext(requestId: string, context: LogContext): void;
-/**
- * Get context for a request ID
- */
-export declare function getRequestContext(requestId: string): LogContext | undefined;
-/**
- * Clear context for a request ID
- */
-export declare function clearRequestContext(requestId: string): void;
-/**
- * Create a child logger with additional context
- * This is a placeholder for the actual implementation
- */
-export declare function withContext(logger: ContextualLogger, context: LogContext): ContextualLogger;
 export {};

package/dist/src/utils/logger/context.js

@@ -3,7 +3,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/utils/logger/context.ts
 /**
 * Logger Context
-* Context tracking and propagation for structured logging
+* AsyncLocalStorage correlation for structured logging
 */
 /**
 * Run *fn* with merged async log context. Propagates through async/await (Node AsyncLocalStorage).
@@ -40,43 +40,15 @@ function inboundCorrelationMetadataFromAsyncLogContext() {
 	}
 	return Object.keys(meta).length > 0 ? meta : void 0;
 }
-/**
-* Merge two contexts
-*/
+/** Shallow-merge two log context objects. */
 function mergeContext(base, additional) {
 	return {
 		...base,
 		...additional
 	};
 }
-/**
-* Store context for a request ID
-*/
-function setRequestContext(requestId, context) {
-	contextStore.set(requestId, context);
-}
-/**
-* Get context for a request ID
-*/
-function getRequestContext(requestId) {
-	return contextStore.get(requestId);
-}
-/**
-* Clear context for a request ID
-*/
-function clearRequestContext(requestId) {
-	contextStore.delete(requestId);
-}
-/**
-* Create a child logger with additional context
-* This is a placeholder for the actual implementation
-*/
-function withContext(logger, context) {
-	return logger.withContext(context);
-}
-var contextStore, ASYNC_LOG_CORRELATION_KEYS, logContextStorage, INBOUND_METADATA_FROM_ASYNC;
+var ASYNC_LOG_CORRELATION_KEYS, logContextStorage, INBOUND_METADATA_FROM_ASYNC;
 var init_context = __esmMin((() => {
-	contextStore = /* @__PURE__ */ new Map();
 	ASYNC_LOG_CORRELATION_KEYS = [
 		"requestId",
 		"sessionId",
@@ -92,6 +64,6 @@ var init_context = __esmMin((() => {
 }));
 //#endregion
 init_context();
-export { clearRequestContext, getAsyncLogContext, getAsyncLogCorrelationKeys, getRequestContext, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, setRequestContext, updateAsyncLogContext, withContext };
+export { getAsyncLogContext, getAsyncLogCorrelationKeys, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, updateAsyncLogContext };
 
 //# sourceMappingURL=context.js.map

package/dist/src/utils/logger/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../../src/utils/logger/context.ts"],"sourcesContent":["/**\n * Logger Context\n * Context tracking and propagation for structured logging\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nimport type { LogContext, ContextualLogger } from './types.js';\n\nconst contextStore = new Map<string, LogContext>();\n\n/** Correlation fields merged into every log line while the store is active (via pino mixin). */\nconst ASYNC_LOG_CORRELATION_KEYS = ['requestId', 'sessionId', 'userId', 'correlationId'] as const;\n\ntype AsyncLogCorrelationKey = (typeof ASYNC_LOG_CORRELATION_KEYS)[number];\n\nconst logContextStorage = new AsyncLocalStorage<{ ctx: LogContext }>();\n\n/**\n * Run *fn* with merged async log context. Propagates through async/await (Node AsyncLocalStorage).\n * Nested calls merge over the parent context (shallow per key).\n */\nexport function runWithLogContext<T>(context: LogContext, fn: () => T): T {\n  const parent = logContextStorage.getStore();\n  const merged = parent ? mergeContext(parent.ctx, context) : { ...context };\n  return logContextStorage.run({ ctx: { ...merged } }, fn);\n}\n\n/** Current async log context, if any. */\nexport function getAsyncLogContext(): LogContext | undefined {\n  return logContextStorage.getStore()?.ctx;\n}\n\n/**\n * Shallow-merge fields into the current async log context (e.g. set sessionId after parsing a body).\n * No-op when not inside {@link runWithLogContext}.\n */\nexport function updateAsyncLogContext(partial: LogContext): void {\n  const ref = logContextStorage.getStore();\n  if (ref) {\n    ref.ctx = mergeContext(ref.ctx, partial);\n  }\n}\n\n/** Keys injected from async context into log records (used by logger mixin). */\nexport function getAsyncLogCorrelationKeys(): readonly AsyncLogCorrelationKey[] {\n  return ASYNC_LOG_CORRELATION_KEYS;\n}\n\n/**\n * Fields to copy from ALS onto {@link InboundMessage.metadata} when the gateway enqueues\n * a message for the agent bus. Omits `sessionId` so channel routing / sessionKey stays\n * authoritative; the agent sets log sessionId after `routeMessage`.\n */\nconst INBOUND_METADATA_FROM_ASYNC: readonly (keyof LogContext)[] = [\n  'requestId',\n  'correlationId',\n  'userId',\n];\n\nexport function inboundCorrelationMetadataFromAsyncLogContext(): Record<string, unknown> | undefined {\n  const ctx = getAsyncLogContext();\n  if (!ctx) return undefined;\n  const meta: Record<string, unknown> = {};\n  for (const key of INBOUND_METADATA_FROM_ASYNC) {\n    const v = ctx[key];\n    if (v !== undefined && v !== '') {\n      meta[key] = v;\n    }\n  }\n  return Object.keys(meta).length > 0 ? meta : undefined;\n}\n\n/**\n * Merge two contexts\n */\nexport function mergeContext(base: LogContext, additional: LogContext): LogContext {\n  return { ...base, ...additional };\n}\n\n/**\n * Store context for a request ID\n */\nexport function setRequestContext(requestId: string, context: LogContext): void {\n  contextStore.set(requestId, context);\n}\n\n/**\n * Get context for a request ID\n */\nexport function getRequestContext(requestId: string): LogContext | undefined {\n  return contextStore.get(requestId);\n}\n\n/**\n * Clear context for a request ID\n */\nexport function clearRequestContext(requestId: string): void {\n  contextStore.delete(requestId);\n}\n\n/**\n * Create a child logger with additional context\n * This is a placeholder for the actual implementation\n */\nexport function withContext(logger: ContextualLogger, context: LogContext): ContextualLogger {\n  return logger.withContext(context);\n}\n"],"mappings":";;;;;;;;;;;AAsBA,SAAgB,kBAAqB,SAAqB,IAAgB;CACxE,MAAM,SAAS,kBAAkB,UAAU;CAC3C,MAAM,SAAS,SAAS,aAAa,OAAO,KAAK,QAAQ,GAAG,EAAE,GAAG,SAAS;AAC1E,QAAO,kBAAkB,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,EAAE,GAAG;;;AAI1D,SAAgB,qBAA6C;AAC3D,QAAO,kBAAkB,UAAU,EAAE;;;;;;AAOvC,SAAgB,sBAAsB,SAA2B;CAC/D,MAAM,MAAM,kBAAkB,UAAU;AACxC,KAAI,IACF,KAAI,MAAM,aAAa,IAAI,KAAK,QAAQ;;;AAK5C,SAAgB,6BAAgE;AAC9E,QAAO;;AAcT,SAAgB,gDAAqF;CACnG,MAAM,MAAM,oBAAoB;AAChC,KAAI,CAAC,IAAK,QAAO,KAAA;CACjB,MAAM,OAAgC,EAAE;AACxC,MAAK,MAAM,OAAO,6BAA6B;EAC7C,MAAM,IAAI,IAAI;AACd,MAAI,MAAM,KAAA,KAAa,MAAM,GAC3B,MAAK,OAAO;;AAGhB,QAAO,OAAO,KAAK,KAAK,CAAC,SAAS,IAAI,OAAO,KAAA;;;;;AAM/C,SAAgB,aAAa,MAAkB,YAAoC;AACjF,QAAO;EAAE,GAAG;EAAM,GAAG;EAAY;;;;;AAMnC,SAAgB,kBAAkB,WAAmB,SAA2B;AAC9E,cAAa,IAAI,WAAW,QAAQ;;;;;AAMtC,SAAgB,kBAAkB,WAA2C;AAC3E,QAAO,aAAa,IAAI,UAAU;;;;;AAMpC,SAAgB,oBAAoB,WAAyB;AAC3D,cAAa,OAAO,UAAU;;;;;;AAOhC,SAAgB,YAAY,QAA0B,SAAuC;AAC3F,QAAO,OAAO,YAAY,QAAQ;;;;AAjG9B,gCAAe,IAAI,KAAyB;AAG5C,8BAA6B;EAAC;EAAa;EAAa;EAAU;EAAgB;AAIlF,qBAAoB,IAAI,mBAAwC;AAsChE,+BAA6D;EACjE;EACA;EACA;EACD"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../../src/utils/logger/context.ts"],"sourcesContent":["/**\n * Logger Context\n * AsyncLocalStorage correlation for structured logging\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nimport type { LogContext } from './types.js';\n\n/** Correlation fields merged into every log line while the store is active (via pino mixin). */\nconst ASYNC_LOG_CORRELATION_KEYS = ['requestId', 'sessionId', 'userId', 'correlationId'] as const;\n\ntype AsyncLogCorrelationKey = (typeof ASYNC_LOG_CORRELATION_KEYS)[number];\n\nconst logContextStorage = new AsyncLocalStorage<{ ctx: LogContext }>();\n\n/**\n * Run *fn* with merged async log context. Propagates through async/await (Node AsyncLocalStorage).\n * Nested calls merge over the parent context (shallow per key).\n */\nexport function runWithLogContext<T>(context: LogContext, fn: () => T): T {\n  const parent = logContextStorage.getStore();\n  const merged = parent ? mergeContext(parent.ctx, context) : { ...context };\n  return logContextStorage.run({ ctx: { ...merged } }, fn);\n}\n\n/** Current async log context, if any. */\nexport function getAsyncLogContext(): LogContext | undefined {\n  return logContextStorage.getStore()?.ctx;\n}\n\n/**\n * Shallow-merge fields into the current async log context (e.g. set sessionId after parsing a body).\n * No-op when not inside {@link runWithLogContext}.\n */\nexport function updateAsyncLogContext(partial: LogContext): void {\n  const ref = logContextStorage.getStore();\n  if (ref) {\n    ref.ctx = mergeContext(ref.ctx, partial);\n  }\n}\n\n/** Keys injected from async context into log records (used by logger mixin). */\nexport function getAsyncLogCorrelationKeys(): readonly AsyncLogCorrelationKey[] {\n  return ASYNC_LOG_CORRELATION_KEYS;\n}\n\n/**\n * Fields to copy from ALS onto {@link InboundMessage.metadata} when the gateway enqueues\n * a message for the agent bus. Omits `sessionId` so channel routing / sessionKey stays\n * authoritative; the agent sets log sessionId after `routeMessage`.\n */\nconst INBOUND_METADATA_FROM_ASYNC: readonly (keyof LogContext)[] = [\n  'requestId',\n  'correlationId',\n  'userId',\n];\n\nexport function inboundCorrelationMetadataFromAsyncLogContext(): Record<string, unknown> | undefined {\n  const ctx = getAsyncLogContext();\n  if (!ctx) return undefined;\n  const meta: Record<string, unknown> = {};\n  for (const key of INBOUND_METADATA_FROM_ASYNC) {\n    const v = ctx[key];\n    if (v !== undefined && v !== '') {\n      meta[key] = v;\n    }\n  }\n  return Object.keys(meta).length > 0 ? meta : undefined;\n}\n\n/** Shallow-merge two log context objects. */\nexport function mergeContext(base: LogContext, additional: LogContext): LogContext {\n  return { ...base, ...additional };\n}\n"],"mappings":";;;;;;;;;;;AAoBA,SAAgB,kBAAqB,SAAqB,IAAgB;CACxE,MAAM,SAAS,kBAAkB,UAAU;CAC3C,MAAM,SAAS,SAAS,aAAa,OAAO,KAAK,QAAQ,GAAG,EAAE,GAAG,SAAS;AAC1E,QAAO,kBAAkB,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,EAAE,GAAG;;;AAI1D,SAAgB,qBAA6C;AAC3D,QAAO,kBAAkB,UAAU,EAAE;;;;;;AAOvC,SAAgB,sBAAsB,SAA2B;CAC/D,MAAM,MAAM,kBAAkB,UAAU;AACxC,KAAI,IACF,KAAI,MAAM,aAAa,IAAI,KAAK,QAAQ;;;AAK5C,SAAgB,6BAAgE;AAC9E,QAAO;;AAcT,SAAgB,gDAAqF;CACnG,MAAM,MAAM,oBAAoB;AAChC,KAAI,CAAC,IAAK,QAAO,KAAA;CACjB,MAAM,OAAgC,EAAE;AACxC,MAAK,MAAM,OAAO,6BAA6B;EAC7C,MAAM,IAAI,IAAI;AACd,MAAI,MAAM,KAAA,KAAa,MAAM,GAC3B,MAAK,OAAO;;AAGhB,QAAO,OAAO,KAAK,KAAK,CAAC,SAAS,IAAI,OAAO,KAAA;;;AAI/C,SAAgB,aAAa,MAAkB,YAAoC;AACjF,QAAO;EAAE,GAAG;EAAM,GAAG;EAAY;;;;AA/D7B,8BAA6B;EAAC;EAAa;EAAa;EAAU;EAAgB;AAIlF,qBAAoB,IAAI,mBAAwC;AAsChE,+BAA6D;EACjE;EACA;EACA;EACD"}

package/dist/src/utils/logger/index.d.ts

@@ -10,26 +10,23 @@
 import pino from 'pino';
 import type { LogLevel, LogContext, ContextualLogger } from './types.js';
 import { getLogDir, getLoggerConfig } from './config.js';
-import { getLogStats } from './stats.js';
+import { getRuntimeLogStats } from './stats.js';
 import { isLoggerShuttingDown, flushAndClose, setShuttingDown } from './shutdown.js';
 import { rotateLogs, cleanOldLogs } from './rotation.js';
 export declare const logger: ContextualLogger;
-export declare function createLogger(prefix: string, context?: LogContext): ContextualLogger;
+export declare function createLogger(module: string, context?: LogContext): ContextualLogger;
 export declare function createModuleLogger(moduleName: string, _modulePath?: string): ContextualLogger;
 export declare function createExtensionLogger(extensionName: string): ContextualLogger;
 export declare function createServiceLogger(serviceId: string): ContextualLogger;
-export declare function createRequestLogger(requestId: string, initialContext?: LogContext): ContextualLogger;
 export declare function setLogLevel(level: LogLevel): void;
 export declare function getLogLevel(): LogLevel;
 export declare function withLogLevel<T>(level: LogLevel, fn: () => T): T;
 export declare function isLevelEnabled(level: LogLevel): boolean;
 export type { LogLevel, LogContext, LogEntry, LoggerConfig, LogFileMeta, LogQuery, LogStats, RotationResult, ContextualLogger, } from './types.js';
-export { getLogDir, getLoggerConfig, getLogStats, isLoggerShuttingDown, flushAndClose, setShuttingDown, rotateLogs, cleanOldLogs, };
+export { getLogDir, getLoggerConfig, getRuntimeLogStats, isLoggerShuttingDown, flushAndClose, setShuttingDown, rotateLogs, cleanOldLogs, };
 export { type LogExporter, type ExporterConfig, type LokiConfig, type ElkConfig, type DatadogConfig, type WebhookConfig, initializeExporters, exportLog, flushExporters, getExporters, } from './exporters.js';
 export { redactSensitiveInfo, redactObject, redactPemBlock, redactSecret, isLogRedactionEnabled, } from './redact.js';
 export { type AuditEvent, type AuditEventType, type AuditLogConfig, logAuditEvent, logAuthEvent, logConfigChange, logPermissionChange, logDataAccess, configureAuditLog, getAuditConfig, } from './audit.js';
-export { logger as default };
 export { logger as baseLogger };
 export { pino as Pino };
-export declare function registerShutdownHandler(): void;
-export { runWithLogContext, getAsyncLogContext, updateAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, setRequestContext as setRequestLogger, clearRequestContext as clearRequestLogger, } from './context.js';
+export { runWithLogContext, getAsyncLogContext, updateAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, } from './context.js';

package/dist/src/utils/logger/index.js

@@ -2,10 +2,10 @@ import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
 import { config, getLogDir, getLoggerConfig, init_config } from "./config.js";
 import { init_streams, initializeStreams } from "./streams.js";
-import { getLogStats, incrementStats, init_stats } from "./stats.js";
+import { getRuntimeLogStats, incrementStats, init_stats } from "./stats.js";
 import { flushAndClose, init_shutdown, isLoggerShuttingDown, setShuttingDown } from "./shutdown.js";
 import { cleanOldLogs, init_rotation, rotateLogs } from "./rotation.js";
-import { clearRequestContext, getAsyncLogContext, getAsyncLogCorrelationKeys, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, setRequestContext, updateAsyncLogContext } from "./context.js";
+import { getAsyncLogContext, getAsyncLogCorrelationKeys, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, updateAsyncLogContext } from "./context.js";
 import { init_redact, isLogRedactionEnabled, redactLogRecord, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./redact.js";
 import { exportLog, flushExporters, getExporters, init_exporters, initializeExporters } from "./exporters.js";
 import { configureAuditLog, getAuditConfig, init_audit, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./audit.js";
@@ -25,7 +25,8 @@ function wrapLogMethod(method, defaultContext, level) {
 		if (isLoggerShuttingDown()) {
 			if (level !== "error" && level !== "fatal") return;
 		}
-		incrementStats(level, defaultContext.module || defaultContext.prefix);
+		const module = defaultContext.module;
+		incrementStats(level, module);
 		return msg !== void 0 ? method.call(this, data, msg) : method.call(this, data);
 	};
 }
@@ -35,9 +36,6 @@ function createProxyLogger(logger, defaultContext = {}) {
 		if (prop === "withContext") return (context) => {
 			return createProxyLogger(target.child({ ...context }), mergeContext(defaultContext, context));
 		};
-		if (prop === "childContext") return (context) => {
-			return createProxyLogger(target.child({ ...context }), mergeContext(defaultContext, context));
-		};
 		const value = target[propKey];
 		if (typeof value === "function") {
 			if ([
@@ -52,9 +50,9 @@ function createProxyLogger(logger, defaultContext = {}) {
 		return value;
 	} });
 }
-function createLogger(prefix, context) {
-	return createProxyLogger(baseLogger.child({ prefix }), {
-		module: prefix,
+function createLogger(module, context) {
+	return createProxyLogger(baseLogger.child({ module }), {
+		module,
 		...context
 	});
 }
@@ -73,13 +71,6 @@ function createServiceLogger(serviceId) {
 		scope: serviceId
 	});
 }
-function createRequestLogger(requestId, initialContext) {
-	const context = {
-		requestId,
-		...initialContext
-	};
-	return createProxyLogger(baseLogger.child({ requestId }), context);
-}
 function setLogLevel(level) {
 	baseLogger.level = level;
 }
@@ -105,18 +96,8 @@ function isLevelEnabled(level) {
 		fatal: 60,
 		silent: Number.MAX_VALUE
 	};
-	const currentLevelValues = {
-		trace: 10,
-		debug: 20,
-		info: 30,
-		warn: 40,
-		error: 50,
-		fatal: 60,
-		silent: Number.MAX_VALUE
-	};
-	return levelValues[level] >= currentLevelValues[getLogLevel()];
+	return levelValues[level] >= levelValues[getLogLevel()];
 }
-function registerShutdownHandler() {}
 var pinoOptions, streams, baseLogger, logger;
 var init_logger = __esmMin((() => {
 	init_config();
@@ -199,6 +180,6 @@ var init_logger = __esmMin((() => {
 }));
 //#endregion
 init_logger();
-export { pino as Pino, logger as baseLogger, logger as default, logger, cleanOldLogs, clearRequestContext as clearRequestLogger, configureAuditLog, createExtensionLogger, createLogger, createModuleLogger, createRequestLogger, createServiceLogger, exportLog, flushAndClose, flushExporters, getAsyncLogContext, getAuditConfig, getExporters, getLogDir, getLogLevel, getLogStats, getLoggerConfig, inboundCorrelationMetadataFromAsyncLogContext, init_logger, initializeExporters, isLevelEnabled, isLogRedactionEnabled, isLoggerShuttingDown, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo, registerShutdownHandler, rotateLogs, runWithLogContext, setLogLevel, setRequestContext as setRequestLogger, setShuttingDown, updateAsyncLogContext, withLogLevel };
+export { pino as Pino, logger as baseLogger, logger, cleanOldLogs, configureAuditLog, createExtensionLogger, createLogger, createModuleLogger, createServiceLogger, exportLog, flushAndClose, flushExporters, getAsyncLogContext, getAuditConfig, getExporters, getLogDir, getLogLevel, getLoggerConfig, getRuntimeLogStats, inboundCorrelationMetadataFromAsyncLogContext, init_logger, initializeExporters, isLevelEnabled, isLogRedactionEnabled, isLoggerShuttingDown, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo, rotateLogs, runWithLogContext, setLogLevel, setShuttingDown, updateAsyncLogContext, withLogLevel };
 
 //# sourceMappingURL=index.js.map

package/dist/src/utils/logger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/utils/logger/index.ts"],"sourcesContent":["/**\n * Modular Logger System\n * \n * Production-grade logging with:\n * - Modular architecture\n * - Context tracking\n * - Statistics\n * - Graceful shutdown\n */\n\nimport pino from 'pino';\nimport type { Logger as PinoLogger } from 'pino';\nimport type { LogLevel, LogContext, ContextualLogger } from './types.js';\n\n// Internal modules\nimport { config, getLogDir, getLoggerConfig } from './config.js';\nimport { initializeStreams } from './streams.js';\nimport { incrementStats, getLogStats } from './stats.js';\nimport { isLoggerShuttingDown, flushAndClose, setShuttingDown } from './shutdown.js';\nimport { rotateLogs, cleanOldLogs } from './rotation.js';\nimport { getAsyncLogContext, getAsyncLogCorrelationKeys, mergeContext } from './context.js';\nimport { redactLogRecord } from './redact.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\n\n// ============================================\n// Base Logger Creation\n// ============================================\n\nconst customLevels = {\n  trace: 10,\n  debug: 20,\n  info: 30,\n  warn: 40,\n  error: 50,\n  fatal: 60,\n};\n\nconst pinoOptions: pino.LoggerOptions = {\n  level: config.level,\n  base: {\n    service: 'xopc',\n    version: process.env.npm_package_version || PACKAGE_VERSION,\n  },\n  timestamp: pino.stdTimeFunctions.isoTime,\n  mixin(mergeObject, _level, logger) {\n    const ctx = getAsyncLogContext();\n    if (!ctx) return {};\n    const bindings =\n      logger && typeof logger.bindings === 'function'\n        ? (logger.bindings() as Record<string, unknown>)\n        : {};\n    const mo = mergeObject as Record<string, unknown>;\n    const out: Record<string, unknown> = {};\n    for (const key of getAsyncLogCorrelationKeys()) {\n      const v = ctx[key];\n      if (v === undefined || v === '') continue;\n      if (mo[key] !== undefined) continue;\n      if (bindings[key] !== undefined) continue;\n      out[key] = v;\n    }\n    return out;\n  },\n  formatters: {\n    level: (label) => ({ level: label }),\n    bindings: (bindings) => ({\n      pid: bindings.pid,\n      host: bindings.host,\n    }),\n    log: (object) => {\n      // Serialize errors with full stack trace\n      if (object.err && object.err instanceof Error) {\n        object.err = {\n          name: object.err.name,\n          message: object.err.message,\n          stack: object.err.stack,\n          cause: object.err.cause instanceof Error \n            ? { name: object.err.cause.name, message: object.err.cause.message, stack: object.err.cause.stack }\n            : object.err.cause,\n        };\n      }\n      for (const key of Object.keys(object)) {\n        if (object[key] instanceof Error) {\n          object[key] = {\n            name: object[key].name,\n            message: object[key].message,\n            stack: object[key].stack,\n          };\n        }\n      }\n      return redactLogRecord(object as Record<string, unknown>);\n    },\n  },\n  customLevels,\n};\n\n// Add pretty print for development\nif (config.prettyPrint) {\n  pinoOptions.transport = {\n    target: 'pino-pretty',\n    options: {\n      colorize: true,\n      translateTime: 'SYS:standard',\n      ignore: 'pid,host',\n    },\n  };\n}\n\nconst streams = initializeStreams();\nconst baseLogger = pino(pinoOptions, pino.multistream(streams));\n\n// ============================================\n// Contextual Logger\n// ============================================\n\nfunction wrapLogMethod(method: Function, defaultContext: LogContext, level: LogLevel) {\n  return function (data: unknown, msg?: string) {\n    // During shutdown, only allow error and fatal logs\n    if (isLoggerShuttingDown()) {\n      if (level !== 'error' && level !== 'fatal') {\n        return;\n      }\n    }\n    \n    const module = (defaultContext.module || defaultContext.prefix) as string | undefined;\n    incrementStats(level, module);\n    \n    return msg !== undefined ? method.call(this, data, msg) : method.call(this, data);\n  };\n}\n\nfunction createProxyLogger(logger: PinoLogger, defaultContext: LogContext = {}): ContextualLogger {\n  const proxy = new Proxy(logger, {\n    get(target, prop) {\n      const propKey = prop as string;\n      \n      if (prop === 'withContext') {\n        return (context: LogContext) => {\n          return createProxyLogger(target.child({ ...context }), mergeContext(defaultContext, context));\n        };\n      }\n      if (prop === 'childContext') {\n        return (context: LogContext) => {\n          return createProxyLogger(target.child({ ...context }), mergeContext(defaultContext, context));\n        };\n      }\n      \n      const value = (target as unknown as Record<string, unknown>)[propKey];\n      if (typeof value === 'function') {\n        if (['trace', 'debug', 'info', 'warn', 'error', 'fatal'].includes(propKey)) {\n          return wrapLogMethod(value, defaultContext, propKey as LogLevel);\n        }\n      }\n      \n      return value;\n    },\n  });\n\n  return proxy as ContextualLogger;\n}\n\n// ============================================\n// Public API\n// ============================================\n\nexport const logger = createProxyLogger(baseLogger);\n\nexport function createLogger(prefix: string, context?: LogContext): ContextualLogger {\n  const child = baseLogger.child({ prefix });\n  return createProxyLogger(child, { module: prefix, ...context });\n}\n\nexport function createModuleLogger(moduleName: string, _modulePath?: string): ContextualLogger {\n  const child = baseLogger.child({ module: moduleName });\n  return createProxyLogger(child, { module: moduleName });\n}\n\nexport function createExtensionLogger(extensionName: string): ContextualLogger {\n  const child = baseLogger.child({ extension: extensionName });\n  return createProxyLogger(child, { extension: extensionName });\n}\n\nexport function createServiceLogger(serviceId: string): ContextualLogger {\n  const child = baseLogger.child({ service: 'cron', scope: serviceId });\n  return createProxyLogger(child, { service: 'cron', scope: serviceId });\n}\n\nexport function createRequestLogger(requestId: string, initialContext?: LogContext): ContextualLogger {\n  const context: LogContext = { requestId, ...initialContext };\n  const child = baseLogger.child({ requestId });\n  return createProxyLogger(child, context);\n}\n\n// ============================================\n// Log Level Management\n// ============================================\n\nexport function setLogLevel(level: LogLevel): void {\n  baseLogger.level = level;\n}\n\nexport function getLogLevel(): LogLevel {\n  return baseLogger.level as LogLevel;\n}\n\nexport function withLogLevel<T>(level: LogLevel, fn: () => T): T {\n  const previous = baseLogger.level;\n  baseLogger.level = level;\n  try {\n    return fn();\n  } finally {\n    baseLogger.level = previous;\n  }\n}\n\nexport function isLevelEnabled(level: LogLevel): boolean {\n  const levelValues: Record<LogLevel, number> = {\n    trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60, silent: Number.MAX_VALUE,\n  };\n  const currentLevelValues: Record<LogLevel, number> = {\n    trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60, silent: Number.MAX_VALUE,\n  };\n  return levelValues[level] >= currentLevelValues[getLogLevel()];\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\nexport type {\n  LogLevel,\n  LogContext,\n  LogEntry,\n  LoggerConfig,\n  LogFileMeta,\n  LogQuery,\n  LogStats,\n  RotationResult,\n  ContextualLogger,\n} from './types.js';\n\nexport {\n  // Config\n  getLogDir,\n  getLoggerConfig,\n  \n  // Stats\n  getLogStats,\n  \n  // Shutdown\n  isLoggerShuttingDown,\n  flushAndClose,\n  setShuttingDown,\n  \n  // Rotation\n  rotateLogs,\n  cleanOldLogs,\n};\n\n//  Exporters\nexport {\n  type LogExporter,\n  type ExporterConfig,\n  type LokiConfig,\n  type ElkConfig,\n  type DatadogConfig,\n  type WebhookConfig,\n  initializeExporters,\n  exportLog,\n  flushExporters,\n  getExporters,\n} from './exporters.js';\n\nexport {\n  redactSensitiveInfo,\n  redactObject,\n  redactPemBlock,\n  redactSecret,\n  isLogRedactionEnabled,\n} from './redact.js';\n\n//  Audit Log\nexport {\n  type AuditEvent,\n  type AuditEventType,\n  type AuditLogConfig,\n  logAuditEvent,\n  logAuthEvent,\n  logConfigChange,\n  logPermissionChange,\n  logDataAccess,\n  configureAuditLog,\n  getAuditConfig,\n} from './audit.js';\n\nexport { logger as default };\nexport { logger as baseLogger };\nexport { pino as Pino };\n\nexport function registerShutdownHandler(): void {}\n\nexport {\n  runWithLogContext,\n  getAsyncLogContext,\n  updateAsyncLogContext,\n  inboundCorrelationMetadataFromAsyncLogContext,\n  setRequestContext as setRequestLogger,\n  clearRequestContext as clearRequestLogger,\n} from './context.js';\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/utils/logger/index.ts"],"sourcesContent":["/**\n * Modular Logger System\n * \n * Production-grade logging with:\n * - Modular architecture\n * - Context tracking\n * - Statistics\n * - Graceful shutdown\n */\n\nimport pino from 'pino';\nimport type { Logger as PinoLogger } from 'pino';\nimport type { LogLevel, LogContext, ContextualLogger } from './types.js';\n\n// Internal modules\nimport { config, getLogDir, getLoggerConfig } from './config.js';\nimport { initializeStreams } from './streams.js';\nimport { incrementStats, getRuntimeLogStats } from './stats.js';\nimport { isLoggerShuttingDown, flushAndClose, setShuttingDown } from './shutdown.js';\nimport { rotateLogs, cleanOldLogs } from './rotation.js';\nimport { getAsyncLogContext, getAsyncLogCorrelationKeys, mergeContext } from './context.js';\nimport { redactLogRecord } from './redact.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\n\n// ============================================\n// Base Logger Creation\n// ============================================\n\nconst customLevels = {\n  trace: 10,\n  debug: 20,\n  info: 30,\n  warn: 40,\n  error: 50,\n  fatal: 60,\n};\n\nconst pinoOptions: pino.LoggerOptions = {\n  level: config.level,\n  base: {\n    service: 'xopc',\n    version: process.env.npm_package_version || PACKAGE_VERSION,\n  },\n  timestamp: pino.stdTimeFunctions.isoTime,\n  mixin(mergeObject, _level, logger) {\n    const ctx = getAsyncLogContext();\n    if (!ctx) return {};\n    const bindings =\n      logger && typeof logger.bindings === 'function'\n        ? (logger.bindings() as Record<string, unknown>)\n        : {};\n    const mo = mergeObject as Record<string, unknown>;\n    const out: Record<string, unknown> = {};\n    for (const key of getAsyncLogCorrelationKeys()) {\n      const v = ctx[key];\n      if (v === undefined || v === '') continue;\n      if (mo[key] !== undefined) continue;\n      if (bindings[key] !== undefined) continue;\n      out[key] = v;\n    }\n    return out;\n  },\n  formatters: {\n    level: (label) => ({ level: label }),\n    bindings: (bindings) => ({\n      pid: bindings.pid,\n      host: bindings.host,\n    }),\n    log: (object) => {\n      // Serialize errors with full stack trace\n      if (object.err && object.err instanceof Error) {\n        object.err = {\n          name: object.err.name,\n          message: object.err.message,\n          stack: object.err.stack,\n          cause: object.err.cause instanceof Error \n            ? { name: object.err.cause.name, message: object.err.cause.message, stack: object.err.cause.stack }\n            : object.err.cause,\n        };\n      }\n      for (const key of Object.keys(object)) {\n        if (object[key] instanceof Error) {\n          object[key] = {\n            name: object[key].name,\n            message: object[key].message,\n            stack: object[key].stack,\n          };\n        }\n      }\n      return redactLogRecord(object as Record<string, unknown>);\n    },\n  },\n  customLevels,\n};\n\n// Add pretty print for development\nif (config.prettyPrint) {\n  pinoOptions.transport = {\n    target: 'pino-pretty',\n    options: {\n      colorize: true,\n      translateTime: 'SYS:standard',\n      ignore: 'pid,host',\n    },\n  };\n}\n\nconst streams = initializeStreams();\nconst baseLogger = pino(pinoOptions, pino.multistream(streams));\n\n// ============================================\n// Contextual Logger\n// ============================================\n\nfunction wrapLogMethod(method: Function, defaultContext: LogContext, level: LogLevel) {\n  return function (data: unknown, msg?: string) {\n    // During shutdown, only allow error and fatal logs\n    if (isLoggerShuttingDown()) {\n      if (level !== 'error' && level !== 'fatal') {\n        return;\n      }\n    }\n    \n    const module = defaultContext.module as string | undefined;\n    incrementStats(level, module);\n    \n    return msg !== undefined ? method.call(this, data, msg) : method.call(this, data);\n  };\n}\n\nfunction createProxyLogger(logger: PinoLogger, defaultContext: LogContext = {}): ContextualLogger {\n  const proxy = new Proxy(logger, {\n    get(target, prop) {\n      const propKey = prop as string;\n      \n      if (prop === 'withContext') {\n        return (context: LogContext) => {\n          return createProxyLogger(target.child({ ...context }), mergeContext(defaultContext, context));\n        };\n      }\n      \n      const value = (target as unknown as Record<string, unknown>)[propKey];\n      if (typeof value === 'function') {\n        if (['trace', 'debug', 'info', 'warn', 'error', 'fatal'].includes(propKey)) {\n          return wrapLogMethod(value, defaultContext, propKey as LogLevel);\n        }\n      }\n      \n      return value;\n    },\n  });\n\n  return proxy as ContextualLogger;\n}\n\n// ============================================\n// Public API\n// ============================================\n\nexport const logger = createProxyLogger(baseLogger);\n\nexport function createLogger(module: string, context?: LogContext): ContextualLogger {\n  const child = baseLogger.child({ module });\n  return createProxyLogger(child, { module, ...context });\n}\n\nexport function createModuleLogger(moduleName: string, _modulePath?: string): ContextualLogger {\n  const child = baseLogger.child({ module: moduleName });\n  return createProxyLogger(child, { module: moduleName });\n}\n\nexport function createExtensionLogger(extensionName: string): ContextualLogger {\n  const child = baseLogger.child({ extension: extensionName });\n  return createProxyLogger(child, { extension: extensionName });\n}\n\nexport function createServiceLogger(serviceId: string): ContextualLogger {\n  const child = baseLogger.child({ service: 'cron', scope: serviceId });\n  return createProxyLogger(child, { service: 'cron', scope: serviceId });\n}\n\n// ============================================\n// Log Level Management\n// ============================================\n\nexport function setLogLevel(level: LogLevel): void {\n  baseLogger.level = level;\n}\n\nexport function getLogLevel(): LogLevel {\n  return baseLogger.level as LogLevel;\n}\n\nexport function withLogLevel<T>(level: LogLevel, fn: () => T): T {\n  const previous = baseLogger.level;\n  baseLogger.level = level;\n  try {\n    return fn();\n  } finally {\n    baseLogger.level = previous;\n  }\n}\n\nexport function isLevelEnabled(level: LogLevel): boolean {\n  const levelValues: Record<LogLevel, number> = {\n    trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60, silent: Number.MAX_VALUE,\n  };\n  return levelValues[level] >= levelValues[getLogLevel()];\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\nexport type {\n  LogLevel,\n  LogContext,\n  LogEntry,\n  LoggerConfig,\n  LogFileMeta,\n  LogQuery,\n  LogStats,\n  RotationResult,\n  ContextualLogger,\n} from './types.js';\n\nexport {\n  // Config\n  getLogDir,\n  getLoggerConfig,\n  \n  // Stats\n  getRuntimeLogStats,\n  \n  // Shutdown\n  isLoggerShuttingDown,\n  flushAndClose,\n  setShuttingDown,\n  \n  // Rotation\n  rotateLogs,\n  cleanOldLogs,\n};\n\n//  Exporters\nexport {\n  type LogExporter,\n  type ExporterConfig,\n  type LokiConfig,\n  type ElkConfig,\n  type DatadogConfig,\n  type WebhookConfig,\n  initializeExporters,\n  exportLog,\n  flushExporters,\n  getExporters,\n} from './exporters.js';\n\nexport {\n  redactSensitiveInfo,\n  redactObject,\n  redactPemBlock,\n  redactSecret,\n  isLogRedactionEnabled,\n} from './redact.js';\n\n//  Audit Log\nexport {\n  type AuditEvent,\n  type AuditEventType,\n  type AuditLogConfig,\n  logAuditEvent,\n  logAuthEvent,\n  logConfigChange,\n  logPermissionChange,\n  logDataAccess,\n  configureAuditLog,\n  getAuditConfig,\n} from './audit.js';\n\nexport { logger as baseLogger };\nexport { pino as Pino };\n\nexport {\n  runWithLogContext,\n  getAsyncLogContext,\n  updateAsyncLogContext,\n  inboundCorrelationMetadataFromAsyncLogContext,\n} from './context.js';\n"],"mappings":"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"}

package/dist/src/utils/logger/log-store.d.ts

@@ -22,46 +22,28 @@ export declare function getLogPath(date?: Date, type?: 'app' | 'error' | 'audit'
  * Query logs across multiple files
  */
 export declare function queryLogs(query?: LogQuery): Promise<LogEntry[]>;
+export declare function getLogModules(): Promise<string[]>;
 /**
- * Get recent logs (convenience method)
+ * Get log statistics by level (sampled from recent files)
  */
-export declare function getRecentLogs(options?: {
-    level?: LogLevel;
-    limit?: number;
+export declare function getFileLogStats(): Promise<LogStats>;
+export interface LogErrorSummaryItem {
+    key: string;
+    errName: string;
+    phase?: string;
     module?: string;
-}): Promise<LogEntry[]>;
+    count: number;
+    lastSeen: string;
+    sampleMessage: string;
+}
 /**
- * Search logs by keyword
+ * Aggregate recent error/fatal logs by err name + phase + module.
  */
-export declare function searchLogs(keyword: string, options?: {
+export declare function getLogErrorSummary(options?: {
     from?: string;
     to?: string;
     limit?: number;
-}): Promise<LogEntry[]>;
-/**
- * Get logs for a specific request/session
- */
-export declare function getLogsByContext(contextType: 'requestId' | 'sessionId', contextValue: string, limit?: number): Promise<LogEntry[]>;
-/**
- * Get available log levels from actual log data
- */
-export declare function getLogLevelsFromData(): Promise<LogLevel[]>;
-/**
- * Get available modules from log data
- */
-export declare function getLogModules(): Promise<string[]>;
-/**
- * Get log statistics by level (sampled from recent files)
- */
-export declare function getLogStats(): Promise<LogStats>;
-/**
- * Clean old logs (actually deletes files)
- */
-export declare function cleanOldLogs(keepDays?: number): {
-    deleted: number;
-    freedBytes: number;
-    errors: string[];
-};
+}): Promise<LogErrorSummaryItem[]>;
 /**
  * Get available log levels
  */