@nekzus/liop 2.4.0-alpha.13 → 2.4.0-alpha.15

package/dist/chunk-K3DGJLUY.js

@@ -0,0 +1,106 @@
+// src/utils/logger.ts
+var LiopLogger = class _LiopLogger {
+  static instance;
+  level = "info";
+  interceptor;
+  _isIntercepting = false;
+  constructor() {
+    this.setLevelFromEnv();
+  }
+  static getInstance() {
+    if (!_LiopLogger.instance) {
+      _LiopLogger.instance = new _LiopLogger();
+    }
+    return _LiopLogger.instance;
+  }
+  setLevelFromEnv() {
+    const envLevel = process.env.LIOP_LOG_LEVEL?.toLowerCase();
+    if (envLevel === "silent" || envLevel === "error" || envLevel === "warn" || envLevel === "info" || envLevel === "debug") {
+      this.level = envLevel;
+    } else {
+      this.level = "info";
+    }
+  }
+  setLevel(level) {
+    this.level = level;
+  }
+  /**
+   * Registers a technology-agnostic log interceptor.
+   * Pass `undefined` to disable interception (zero overhead).
+   */
+  setInterceptor(interceptor) {
+    this.interceptor = interceptor;
+  }
+  shouldLog(targetLevel) {
+    const levels = {
+      silent: 0,
+      error: 1,
+      warn: 2,
+      info: 3,
+      debug: 4
+    };
+    return levels[this.level] >= levels[targetLevel];
+  }
+  formatMessage(level, message) {
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    return `[${ts}] [${level}] ${message}`;
+  }
+  /**
+   * Fire-and-forget async dispatch to the registered interceptor.
+   * Recursion guard prevents infinite loops when the interceptor
+   * itself triggers logging (directly or transitively).
+   */
+  emitToInterceptor(level, formattedMessage, args) {
+    if (!this.interceptor || this._isIntercepting) return;
+    this._isIntercepting = true;
+    const event = Object.freeze({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      message: formattedMessage,
+      args: Object.freeze([...args])
+    });
+    try {
+      const result = this.interceptor(event);
+      if (result && typeof result === "object" && "catch" in result) {
+        result.catch(() => {
+        });
+      }
+    } catch {
+    } finally {
+      this._isIntercepting = false;
+    }
+  }
+  error(message, ...args) {
+    if (this.shouldLog("error")) {
+      const formatted = this.formatMessage("ERROR", message);
+      console.error(formatted, ...args);
+      this.emitToInterceptor("error", formatted, args);
+    }
+  }
+  warn(message, ...args) {
+    if (this.shouldLog("warn")) {
+      const formatted = this.formatMessage("WARN", message);
+      console.error(formatted, ...args);
+      this.emitToInterceptor("warn", formatted, args);
+    }
+  }
+  info(message, ...args) {
+    if (this.shouldLog("info")) {
+      const formatted = this.formatMessage("INFO", message);
+      console.error(formatted, ...args);
+      this.emitToInterceptor("info", formatted, args);
+    }
+  }
+  debug(message, ...args) {
+    if (this.shouldLog("debug")) {
+      const formatted = this.formatMessage("DEBUG", message);
+      console.error(formatted, ...args);
+      this.emitToInterceptor("debug", formatted, args);
+    }
+  }
+};
+var log = LiopLogger.getInstance();
+
+export { LiopLogger, log };
+//# sourceMappingURL=chunk-K3DGJLUY.js.map
+//# sourceMappingURL=chunk-K3DGJLUY.js.map

package/dist/chunk-K3DGJLUY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/logger.ts"],"names":[],"mappings":"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","file":"chunk-K3DGJLUY.js","sourcesContent":["// Copyright 2026 Nekzus Solutions and contributors\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { LogInterceptor } from \"../interceptors/log-interceptor.js\";\n\nexport type LogLevel = \"silent\" | \"error\" | \"warn\" | \"info\" | \"debug\";\n\n/**\n * LiopLogger - Structured Logging Abstraction\n * Configurable via `process.env.LIOP_LOG_LEVEL`.\n * Emits strictly to stderr to comply with MCP stdio protocols.\n */\nexport class LiopLogger {\n\tprivate static instance: LiopLogger;\n\tprivate level: LogLevel = \"info\";\n\tprivate interceptor?: LogInterceptor;\n\tprivate _isIntercepting = false;\n\n\tprivate constructor() {\n\t\tthis.setLevelFromEnv();\n\t}\n\n\tpublic static getInstance(): LiopLogger {\n\t\tif (!LiopLogger.instance) {\n\t\t\tLiopLogger.instance = new LiopLogger();\n\t\t}\n\t\treturn LiopLogger.instance;\n\t}\n\n\tprivate setLevelFromEnv() {\n\t\tconst envLevel = process.env.LIOP_LOG_LEVEL?.toLowerCase();\n\t\tif (\n\t\t\tenvLevel === \"silent\" ||\n\t\t\tenvLevel === \"error\" ||\n\t\t\tenvLevel === \"warn\" ||\n\t\t\tenvLevel === \"info\" ||\n\t\t\tenvLevel === \"debug\"\n\t\t) {\n\t\t\tthis.level = envLevel as LogLevel;\n\t\t} else {\n\t\t\t// Default level: info\n\t\t\tthis.level = \"info\";\n\t\t}\n\t}\n\n\tpublic setLevel(level: LogLevel) {\n\t\tthis.level = level;\n\t}\n\n\t/**\n\t * Registers a technology-agnostic log interceptor.\n\t * Pass `undefined` to disable interception (zero overhead).\n\t */\n\tpublic setInterceptor(interceptor: LogInterceptor | undefined) {\n\t\tthis.interceptor = interceptor;\n\t}\n\n\tprivate shouldLog(targetLevel: LogLevel): boolean {\n\t\tconst levels: Record<LogLevel, number> = {\n\t\t\tsilent: 0,\n\t\t\terror: 1,\n\t\t\twarn: 2,\n\t\t\tinfo: 3,\n\t\t\tdebug: 4,\n\t\t};\n\t\treturn levels[this.level] >= levels[targetLevel];\n\t}\n\n\tprivate formatMessage(level: string, message: string): string {\n\t\tconst ts = new Date().toISOString();\n\t\treturn `[${ts}] [${level}] ${message}`;\n\t}\n\n\t/**\n\t * Fire-and-forget async dispatch to the registered interceptor.\n\t * Recursion guard prevents infinite loops when the interceptor\n\t * itself triggers logging (directly or transitively).\n\t */\n\tprivate emitToInterceptor(\n\t\tlevel: LogLevel,\n\t\tformattedMessage: string,\n\t\targs: unknown[],\n\t): void {\n\t\tif (!this.interceptor || this._isIntercepting) return;\n\t\tthis._isIntercepting = true;\n\t\tconst event: Readonly<{\n\t\t\ttimestamp: string;\n\t\t\tlevel: LogLevel;\n\t\t\tmessage: string;\n\t\t\targs: readonly unknown[];\n\t\t}> = Object.freeze({\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tlevel,\n\t\t\tmessage: formattedMessage,\n\t\t\targs: Object.freeze([...args]),\n\t\t});\n\t\ttry {\n\t\t\tconst result = this.interceptor(event);\n\t\t\tif (result && typeof result === \"object\" && \"catch\" in result) {\n\t\t\t\t(result as Promise<void>).catch(() => {});\n\t\t\t}\n\t\t} catch {\n\t\t\t// Interceptor errors are silenced to protect protocol throughput\n\t\t} finally {\n\t\t\tthis._isIntercepting = false;\n\t\t}\n\t}\n\n\tpublic error(message: string, ...args: unknown[]) {\n\t\tif (this.shouldLog(\"error\")) {\n\t\t\tconst formatted = this.formatMessage(\"ERROR\", message);\n\t\t\tconsole.error(formatted, ...args);\n\t\t\tthis.emitToInterceptor(\"error\", formatted, args);\n\t\t}\n\t}\n\n\tpublic warn(message: string, ...args: unknown[]) {\n\t\tif (this.shouldLog(\"warn\")) {\n\t\t\tconst formatted = this.formatMessage(\"WARN\", message);\n\t\t\tconsole.error(formatted, ...args);\n\t\t\tthis.emitToInterceptor(\"warn\", formatted, args);\n\t\t}\n\t}\n\n\tpublic info(message: string, ...args: unknown[]) {\n\t\tif (this.shouldLog(\"info\")) {\n\t\t\tconst formatted = this.formatMessage(\"INFO\", message);\n\t\t\tconsole.error(formatted, ...args);\n\t\t\tthis.emitToInterceptor(\"info\", formatted, args);\n\t\t}\n\t}\n\n\tpublic debug(message: string, ...args: unknown[]) {\n\t\tif (this.shouldLog(\"debug\")) {\n\t\t\tconst formatted = this.formatMessage(\"DEBUG\", message);\n\t\t\tconsole.error(formatted, ...args);\n\t\t\tthis.emitToInterceptor(\"debug\", formatted, args);\n\t\t}\n\t}\n}\n\nexport const log = LiopLogger.getInstance();\n"]}

package/dist/{chunk-UWC7OY7K.js → chunk-O37AERO7.js}

@@ -1,9 +1,9 @@
 import { sanitizeOutput } from './chunk-Y62GORQF.js';
 import { LIOP_SCOPES, Dilithium65Wrapper, authorizeRequest } from './chunk-VH4K4U45.js';
-import { GRPC_CHANNEL_OPTIONS, liopV1, createServerCredentials } from './chunk-3BJ5QQHK.js';
+import { GRPC_CHANNEL_OPTIONS, liopV1, createServerCredentials } from './chunk-3UBNOYMH.js';
 import { egressBlocksTotal, toolCallsTotal, fuelConsumed, wireEgressBytesTotal, wireSavedBytesTotal, toolCallErrorsTotal } from './chunk-PAICJCKJ.js';
-import { MeshNode } from './chunk-7RXOIDXP.js';
-import { log } from './chunk-HA6YZ42O.js';
+import { MeshNode } from './chunk-XRDN232O.js';
+import { log } from './chunk-K3DGJLUY.js';
 import { Buffer } from 'buffer';
 import * as crypto3 from 'crypto';
 import crypto3__default from 'crypto';
@@ -94,12 +94,23 @@ var AuditLogger = class {
   entries = [];
   lastEntryHash = GENESIS_HASH;
   filePath;
+  interceptor;
   constructor(filePath) {
     this.filePath = filePath;
     if (this.filePath && fs2.existsSync(this.filePath)) {
       this.loadFromFile(this.filePath);
     }
   }
+  /**
+   * Registers a technology-agnostic audit interceptor.
+   * The interceptor fires AFTER the entry is sealed (hash computed)
+   * and appended to the chain. It receives a frozen deep-clone
+   * that cannot tamper with the hash chain.
+   * Pass `undefined` to disable interception (zero overhead).
+   */
+  setInterceptor(interceptor) {
+    this.interceptor = interceptor;
+  }
   recordExecution(params) {
     const id = crypto3.randomUUID();
     const timestamp = params.timestamp || (/* @__PURE__ */ new Date()).toISOString();
@@ -136,6 +147,17 @@ var AuditLogger = class {
         "utf8"
       );
     }
+    if (this.interceptor) {
+      const frozenClone = Object.freeze(structuredClone(fullEntry));
+      try {
+        const result = this.interceptor(frozenClone);
+        if (result && typeof result === "object" && "catch" in result) {
+          result.catch(() => {
+          });
+        }
+      } catch {
+      }
+    }
     return fullEntry;
   }
   getEntries() {
@@ -3630,5 +3652,5 @@ Data structure: ${schemaDigest}. Full schema: resource ${uri}. Guidelines: resou
 };
 
 export { AUTH_DEFAULTS, AuditLogger, GENESIS_HASH, JwtValidator, LiopRpcServer, LiopServer, NerScanner, PII_PATTERNS, PII_PRESETS, PiiScanner, computeEntryHash, createOAuthServer, globalAuditLogger };
-//# sourceMappingURL=chunk-UWC7OY7K.js.map
-//# sourceMappingURL=chunk-UWC7OY7K.js.map
+//# sourceMappingURL=chunk-O37AERO7.js.map
+//# sourceMappingURL=chunk-O37AERO7.js.map