@soulcraft/brainy 0.39.0 → 0.40.0

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.40.0",
   "description": "A vector graph database using HNSW indexing with Origin Private File System storage",
   "main": "dist/unified.js",
   "module": "dist/unified.js",