@bitsbound/mcp-server 1.0.4 → 1.0.6

package/logger/Bitsbound_Kings_McpServer_Backend_Logger.ts

@@ -0,0 +1,130 @@
+////////////////////////////////////////
+// # GOLDEN RULE!!!! HONOR ABOVE ALL!!!!
+////////////////////////////////////////
+// NO NEW FILES!!!!!!!!!
+////////////////////////////////////////
+
+/*
+░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+*/
+// ##                                                                                                               REQUIREMENTS 'R'
+/*
+░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+*/
+
+
+/*
+§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§
+*/
+// ###                                                                                                         DEFINITIONS, VALIDATIONS, AND TRANSFORMATIONS 'R_DVT'
+/*
+§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§
+*/
+
+
+/*
+######################################################################################################################################################################################################
+*/
+// ####                                                                                                    GLOBAL 'R_DVT_G' - Logger Definitions
+/*
+######################################################################################################################################################################################################
+*/
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+interface LogEntry {
+  readonly timestamp: string;
+  readonly level: LogLevel;
+  readonly component: string;
+  readonly message: string;
+  readonly data?: Record<string, unknown>;
+}
+
+// ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+// MCP Logger 'R_DVT_G_T_Logger' - Logs to stderr (MCP protocol uses stdout for messages)
+// ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+
+class McpLogger {
+  private readonly component: string;
+  private readonly minLevel: LogLevel;
+  private readonly levelPriority: Record<LogLevel, number> = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+  };
+
+  constructor(component: string, minLevel: LogLevel = 'info') {
+    this.component = component;
+    this.minLevel = minLevel;
+  }
+
+  private shouldLog(level: LogLevel): boolean {
+    return this.levelPriority[level] >= this.levelPriority[this.minLevel];
+  }
+
+  private formatEntry(entry: LogEntry): string {
+    const dataStr = entry.data ? ` ${JSON.stringify(entry.data)}` : '';
+    return `[${entry.timestamp}] [${entry.level.toUpperCase()}] [${entry.component}] ${entry.message}${dataStr}`;
+  }
+
+  private log(level: LogLevel, message: string, data?: Record<string, unknown>): void {
+    if (!this.shouldLog(level)) return;
+
+    const entry: LogEntry = {
+      timestamp: new Date().toISOString(),
+      level,
+      component: this.component,
+      message,
+      data
+    };
+
+    // MCP protocol: stdout is for JSON-RPC messages, stderr is for logs
+    console.error(this.formatEntry(entry));
+  }
+
+  debug(message: string, data?: Record<string, unknown>): void {
+    this.log('debug', message, data);
+  }
+
+  info(message: string, data?: Record<string, unknown>): void {
+    this.log('info', message, data);
+  }
+
+  warn(message: string, data?: Record<string, unknown>): void {
+    this.log('warn', message, data);
+  }
+
+  error(message: string, data?: Record<string, unknown>): void {
+    this.log('error', message, data);
+  }
+
+  child(subComponent: string): McpLogger {
+    return new McpLogger(`${this.component}:${subComponent}`, this.minLevel);
+  }
+}
+
+
+/*
+######################################################################################################################################################################################################
+*/
+// ####                                                                                                         LOCAL 'R_DVT_L' - Logger Factory
+/*
+######################################################################################################################################################################################################
+*/
+
+// ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+// Logger Factory 'R_DVT_L_T_Factory' - Creates component-specific loggers
+// ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+
+const logLevel = (process.env.LOG_LEVEL as LogLevel) || 'info';
+
+export const createLogger = (component: string): McpLogger => {
+  return new McpLogger(`bitsbound-mcp:${component}`, logLevel);
+};
+
+export const serverLogger = createLogger('server');
+export const toolLogger = createLogger('tools');
+export const apiLogger = createLogger('api');
+
+export type { McpLogger, LogLevel, LogEntry };