@soulcraft/brainy 0.39.0 → 0.41.0

package/dist/utils/logger.d.ts

@@ -1,99 +1,52 @@
 /**
  * Centralized logging utility for Brainy
- *
- * This utility provides controlled logging that can be enabled/disabled
- * based on debug mode configuration. By default, all logging is disabled
- * unless explicitly enabled via environment variables or configuration.
- */
-/**
- * Logger configuration interface
- */
+ * Provides configurable log levels and consistent logging across the codebase
+ */
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3,
+    TRACE = 4
+}
 export interface LoggerConfig {
-    /**
-     * Whether debug logging is enabled
-     * @default false
-     */
-    debug?: boolean;
-    /**
-     * Whether to show log prefixes
-     * @default true
-     */
-    showPrefix?: boolean;
-    /**
-     * Custom prefix for log messages
-     * @default 'Brainy'
-     */
-    prefix?: string;
+    level: LogLevel;
+    modules?: {
+        [moduleName: string]: LogLevel;
+    };
+    timestamps?: boolean;
+    includeModule?: boolean;
+    handler?: (level: LogLevel, module: string, message: string, ...args: any[]) => void;
 }
-/**
- * Configure the global logger
- */
-export declare function configureLogger(config: LoggerConfig): void;
-/**
- * Get current logger configuration
- */
-export declare function getLoggerConfig(): Required<LoggerConfig>;
-/**
- * Check if debug mode is enabled
- */
-export declare function isDebugEnabled(): boolean;
-/**
- * Controlled logging methods
- */
-export declare const logger: {
-    /**
-     * Log debug information (only shown when debug mode is enabled)
-     */
-    debug: (message: string, ...args: any[]) => void;
-    /**
-     * Log informational messages (only shown when debug mode is enabled)
-     */
-    info: (message: string, ...args: any[]) => void;
-    /**
-     * Log warning messages (always shown, but can be controlled)
-     */
-    warn: (message: string, ...args: any[]) => void;
-    /**
-     * Log error messages (always shown)
-     */
+declare class Logger {
+    private static instance;
+    private config;
+    private constructor();
+    static getInstance(): Logger;
+    configure(config: Partial<LoggerConfig>): void;
+    private shouldLog;
+    private formatMessage;
+    private log;
+    error(module: string, message: string, ...args: any[]): void;
+    warn(module: string, message: string, ...args: any[]): void;
+    info(module: string, message: string, ...args: any[]): void;
+    debug(module: string, message: string, ...args: any[]): void;
+    trace(module: string, message: string, ...args: any[]): void;
+    createModuleLogger(module: string): {
+        error: (message: string, ...args: any[]) => void;
+        warn: (message: string, ...args: any[]) => void;
+        info: (message: string, ...args: any[]) => void;
+        debug: (message: string, ...args: any[]) => void;
+        trace: (message: string, ...args: any[]) => void;
+    };
+}
+export declare const logger: Logger;
+export declare function createModuleLogger(module: string): {
     error: (message: string, ...args: any[]) => void;
-    /**
-     * Log with custom prefix (only shown when debug mode is enabled)
-     */
-    debugWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
-    /**
-     * Log info with custom prefix (only shown when debug mode is enabled)
-     */
-    infoWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
-    /**
-     * Log warning with custom prefix (controlled by debug mode)
-     */
-    warnWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
-    /**
-     * Log error with custom prefix (always shown)
-     */
-    errorWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
-};
-/**
- * Legacy console methods for backward compatibility
- * These will respect the debug mode setting
- */
-export declare const debugConsole: {
-    log: (message: string, ...args: any[]) => void;
-    debug: (message: string, ...args: any[]) => void;
-    info: (message: string, ...args: any[]) => void;
     warn: (message: string, ...args: any[]) => void;
-    error: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    debug: (message: string, ...args: any[]) => void;
+    trace: (message: string, ...args: any[]) => void;
 };
-/**
- * Enable debug mode programmatically
- */
-export declare function enableDebugMode(): void;
-/**
- * Disable debug mode programmatically
- */
-export declare function disableDebugMode(): void;
-/**
- * Create a scoped logger with a specific prefix
- */
-export declare function createScopedLogger(prefix: string): typeof logger;
+export declare function configureLogger(config: Partial<LoggerConfig>): void;
+export {};

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqDD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAeD;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;qBACc,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAM9C;;OAEG;oBACa,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAM7C;;OAEG;oBACa,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAM7C;;OAEG;qBACc,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAI9C;;OAEG;8BACuB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAMxE;;OAEG;6BACsB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAMvE;;OAEG;6BACsB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAMvE;;OAEG;8BACuB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;CAGzE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;mBA7DP,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;qBAT5B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;oBAS9B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;oBAS7B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;qBAS5B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;CAiD/C,CAAA;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,MAAM,CAWhE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAA;IAEf,OAAO,CAAC,EAAE;QACR,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAA;KAC/B,CAAA;IAED,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CACrF;AAED,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAQ;IAC/B,OAAO,CAAC,MAAM,CAIb;IAED,OAAO;IAqBP,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAI9C,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,GAAG;IA6BX,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI5D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI5D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAK5D,kBAAkB,CAAC,MAAM,EAAE,MAAM;yBAEZ,MAAM,WAAW,GAAG,EAAE;wBACvB,MAAM,WAAW,GAAG,EAAE;wBACtB,MAAM,WAAW,GAAG,EAAE;yBACrB,MAAM,WAAW,GAAG,EAAE;yBACtB,MAAM,WAAW,GAAG,EAAE;;CAG5C;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAA;AAG1C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM;qBAb1B,MAAM,WAAW,GAAG,EAAE;oBACvB,MAAM,WAAW,GAAG,EAAE;oBACtB,MAAM,WAAW,GAAG,EAAE;qBACrB,MAAM,WAAW,GAAG,EAAE;qBACtB,MAAM,WAAW,GAAG,EAAE;EAW5C;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,QAE5D"}

package/dist/utils/statisticsCollector.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Lightweight statistics collector for Brainy
+ * Designed to have minimal performance impact even with millions of entries
+ */
+import { StatisticsData } from '../coreTypes.js';
+export declare class StatisticsCollector {
+    private contentTypes;
+    private oldestTimestamp;
+    private newestTimestamp;
+    private updateTimestamps;
+    private searchMetrics;
+    private verbTypes;
+    private storageSizeCache;
+    private readonly MAX_TIMESTAMPS;
+    private readonly MAX_SEARCH_TERMS;
+    private readonly SIZE_UPDATE_INTERVAL;
+    /**
+     * Track content type (very lightweight)
+     */
+    trackContentType(type: string): void;
+    /**
+     * Track data update timestamp (lightweight)
+     */
+    trackUpdate(timestamp?: number): void;
+    /**
+     * Track search performance (lightweight)
+     */
+    trackSearch(searchTerm: string, durationMs: number): void;
+    /**
+     * Track verb type (lightweight)
+     */
+    trackVerbType(type: string): void;
+    /**
+     * Update storage size estimates (called periodically, not on every operation)
+     */
+    updateStorageSizes(sizes: {
+        nouns: number;
+        verbs: number;
+        metadata: number;
+        index: number;
+    }): void;
+    /**
+     * Get comprehensive statistics
+     */
+    getStatistics(): Partial<StatisticsData>;
+    /**
+     * Merge statistics from storage (for distributed systems)
+     */
+    mergeFromStorage(stored: Partial<StatisticsData>): void;
+    /**
+     * Reset statistics (for testing)
+     */
+    reset(): void;
+    private pruneSearchTerms;
+}

package/dist/utils/statisticsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statisticsCollector.d.ts","sourceRoot":"","sources":["../../src/utils/statisticsCollector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAOhD,qBAAa,mBAAmB;IAE9B,OAAO,CAAC,YAAY,CAAiC;IAGrD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,gBAAgB,CAAuB;IAG/C,OAAO,CAAC,aAAa,CAKpB;IAGD,OAAO,CAAC,SAAS,CAAiC;IAGlD,OAAO,CAAC,gBAAgB,CAQvB;IAED,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAM;IACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;IAE7C;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBrC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAyBzD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,IAAI;IAOR;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAmFxC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IA4BvD;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb,OAAO,CAAC,gBAAgB;CAWzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "0.39.0",
+  "version": "0.41.0",
   "description": "A vector graph database using HNSW indexing with Origin Private File System storage",
   "main": "dist/unified.js",
   "module": "dist/unified.js",
@@ -48,6 +48,9 @@
   "engines": {
     "node": ">=24.4.0"
   },
+  "overrides": {
+    "form-data": "^4.0.4"
+  },
   "scripts": {
     "prebuild": "echo 'Prebuild step - no version generation needed'",
     "build": "BUILD_TYPE=unified rollup -c rollup.config.js",