@soulcraft/brainy 0.22.0 → 0.24.0

package/dist/brainyData.d.ts

@@ -8,19 +8,12 @@ import { NounType, VerbType } from './types/graphTypes.js';
 import { WebSocketConnection } from './types/augmentations.js';
 import { BrainyDataInterface } from './types/brainyDataInterface.js';
 export interface BrainyDataConfig {
-    /**
-     * Vector dimensions (required if not using an embedding function that auto-detects dimensions)
-     */
-    dimensions?: number;
     /**
      * HNSW index configuration
+     * Uses the optimized HNSW implementation which supports large datasets
+     * through product quantization and disk-based storage
      */
-    hnsw?: Partial<HNSWConfig>;
-    /**
-     * Optimized HNSW index configuration
-     * If provided, will use the optimized HNSW index instead of the standard one
-     */
-    hnswOptimized?: Partial<HNSWOptimizedConfig>;
+    hnsw?: Partial<HNSWOptimizedConfig>;
     /**
      * Distance function to use for similarity calculations
      */
@@ -403,6 +396,12 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
      * @private
      */
     private getNounCount;
+    /**
+     * Force an immediate flush of statistics to storage
+     * This ensures that any pending statistics updates are written to persistent storage
+     * @returns Promise that resolves when the statistics have been flushed
+     */
+    flushStatistics(): Promise<void>;
     /**
      * Get statistics about the current state of the database
      * @param options Additional options for retrieving statistics

package/dist/coreTypes.d.ts

@@ -193,4 +193,9 @@ export interface StorageAdapter {
      * @param size The new size of the HNSW index
      */
     updateHnswIndexSize(size: number): Promise<void>;
+    /**
+     * Force an immediate flush of statistics to storage
+     * This ensures that any pending statistics updates are written to persistent storage
+     */
+    flushStatisticsToStorage(): Promise<void>;
 }

package/dist/storage/adapters/baseStorageAdapter.d.ts

@@ -74,6 +74,11 @@ export declare abstract class BaseStorageAdapter implements StorageAdapter {
      * @param size The new size of the HNSW index
      */
     updateHnswIndexSize(size: number): Promise<void>;
+    /**
+     * Force an immediate flush of statistics to storage
+     * This ensures that any pending statistics updates are written to persistent storage
+     */
+    flushStatisticsToStorage(): Promise<void>;
     /**
      * Create default statistics data
      * @returns Default statistics data

package/dist/storage/adapters/baseStorageAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"baseStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/baseStorageAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"baseStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/baseStorageAdapter.ts"],"names":[],"mappings":"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"}

package/dist/storage/adapters/memoryStorage.d.ts

@@ -4,14 +4,6 @@
  */
 import { GraphVerb, HNSWNoun, StatisticsData } from '../../coreTypes.js';
 import { BaseStorage } from '../baseStorage.js';
-/**
- * Type alias for HNSWNoun to make the code more readable
- */
-type HNSWNoun_internal = HNSWNoun;
-/**
- * Type alias for GraphVerb to make the code more readable
- */
-type Verb = GraphVerb;
 /**
  * In-memory storage adapter
  * Uses Maps to store data in memory
@@ -30,21 +22,21 @@ export declare class MemoryStorage extends BaseStorage {
     /**
      * Save a noun to storage
      */
-    protected saveNoun_internal(noun: HNSWNoun_internal): Promise<void>;
+    protected saveNoun_internal(noun: HNSWNoun): Promise<void>;
     /**
      * Get a noun from storage
      */
-    protected getNoun_internal(id: string): Promise<HNSWNoun_internal | null>;
+    protected getNoun_internal(id: string): Promise<HNSWNoun | null>;
     /**
      * Get all nouns from storage
      */
-    protected getAllNouns_internal(): Promise<HNSWNoun_internal[]>;
+    protected getAllNouns_internal(): Promise<HNSWNoun[]>;
     /**
      * Get nouns by noun type
      * @param nounType The noun type to filter by
      * @returns Promise that resolves to an array of nouns of the specified noun type
      */
-    protected getNounsByNounType_internal(nounType: string): Promise<HNSWNoun_internal[]>;
+    protected getNounsByNounType_internal(nounType: string): Promise<HNSWNoun[]>;
     /**
      * Delete a noun from storage
      */
@@ -52,27 +44,27 @@ export declare class MemoryStorage extends BaseStorage {
     /**
      * Save a verb to storage
      */
-    protected saveVerb_internal(verb: Verb): Promise<void>;
+    protected saveVerb_internal(verb: GraphVerb): Promise<void>;
     /**
      * Get a verb from storage
      */
-    protected getVerb_internal(id: string): Promise<Verb | null>;
+    protected getVerb_internal(id: string): Promise<GraphVerb | null>;
     /**
      * Get all verbs from storage
      */
-    protected getAllVerbs_internal(): Promise<Verb[]>;
+    protected getAllVerbs_internal(): Promise<GraphVerb[]>;
     /**
      * Get verbs by source
      */
-    protected getVerbsBySource_internal(sourceId: string): Promise<Verb[]>;
+    protected getVerbsBySource_internal(sourceId: string): Promise<GraphVerb[]>;
     /**
      * Get verbs by target
      */
-    protected getVerbsByTarget_internal(targetId: string): Promise<Verb[]>;
+    protected getVerbsByTarget_internal(targetId: string): Promise<GraphVerb[]>;
     /**
      * Get verbs by type
      */
-    protected getVerbsByType_internal(type: string): Promise<Verb[]>;
+    protected getVerbsByType_internal(type: string): Promise<GraphVerb[]>;
     /**
      * Delete a verb from storage
      */
@@ -109,4 +101,3 @@ export declare class MemoryStorage extends BaseStorage {
      */
     protected getStatisticsData(): Promise<StatisticsData | null>;
 }
-export {};

package/dist/storage/adapters/memoryStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memoryStorage.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/memoryStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAA;AAE/D;;GAEG;AACH,KAAK,iBAAiB,GAAG,QAAQ,CAAA;AAEjC;;GAEG;AACH,KAAK,IAAI,GAAG,SAAS,CAAA;AAErB;;;GAGG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAE5C,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAA8B;;IAMhD;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;OAEG;cACa,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzE;;OAEG;cACa,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAwB/E;;OAEG;cACa,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAuBpE;;;;OAIG;cACa,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6B3F;;OAEG;cACa,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;OAEG;cACa,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5D;;OAEG;cACa,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IA8ClE;;OAEG;cACa,oBAAoB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IA6CvD;;OAEG;cACa,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAK5E;;OAEG;cACa,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAK5E;;OAEG;cACa,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAKtE;;OAEG;cACa,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;OAEG;IACU,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE;;OAEG;IACU,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IASzD;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnC;;OAEG;IACU,gBAAgB,IAAI,OAAO,CAAC;QACvC,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAC9B,CAAC;IAaF;;;OAGG;cACa,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7E;;;OAGG;cACa,iBAAiB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAiBpE"}
+{"version":3,"file":"memoryStorage.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/memoryStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAA;AAI/D;;;GAGG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAE5C,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAA8B;;IAMhD;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;OAEG;cACa,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhE;;OAEG;cACa,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAwBtE;;OAEG;cACa,oBAAoB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuB3D;;;;OAIG;cACa,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA6BlF;;OAEG;cACa,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;OAEG;cACa,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBjE;;OAEG;cACa,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA8CvE;;OAEG;cACa,oBAAoB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA6C5D;;OAEG;cACa,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjF;;OAEG;cACa,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjF;;OAEG;cACa,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAK3E;;OAEG;cACa,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;OAEG;IACU,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE;;OAEG;IACU,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IASzD;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnC;;OAEG;IACU,gBAAgB,IAAI,OAAO,CAAC;QACvC,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAC9B,CAAC;IAaF;;;OAGG;cACa,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7E;;;OAGG;cACa,iBAAiB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAiBpE"}

package/dist/unified.js

@@ -5405,6 +5405,18 @@ class BaseStorageAdapter {
         // Schedule a batch update instead of saving immediately
         this.scheduleBatchUpdate();
     }
+    /**
+     * Force an immediate flush of statistics to storage
+     * This ensures that any pending statistics updates are written to persistent storage
+     */
+    async flushStatisticsToStorage() {
+        // If there are no statistics in cache or they haven't been modified, nothing to flush
+        if (!this.statisticsCache || !this.statisticsModified) {
+            return;
+        }
+        // Call the protected flushStatistics method to immediately write to storage
+        await this.flushStatistics();
+    }
     /**
      * Create default statistics data
      * @returns Default statistics data
@@ -5549,6 +5561,7 @@ class BaseStorage extends BaseStorageAdapter {
  * Memory Storage Adapter
  * In-memory storage adapter for environments where persistent storage is not available or needed
  */
+// No type aliases needed - using the original types directly
 /**
  * In-memory storage adapter
  * Uses Maps to store data in memory
@@ -10861,24 +10874,13 @@ class BrainyData {
         this.remoteServerConfig = null;
         this.serverSearchConduit = null;
         this.serverConnection = null;
-        // Validate dimensions
-        if (config.dimensions !== undefined && config.dimensions <= 0) {
-            throw new Error('Dimensions must be a positive number');
-        }
-        // Set dimensions (default to 512 for embedding functions, or require explicit config)
-        this._dimensions = config.dimensions || 512;
+        // Set dimensions to fixed value of 512 (Universal Sentence Encoder dimension)
+        this._dimensions = 512;
         // Set distance function
         this.distanceFunction = config.distanceFunction || cosineDistance$1;
-        // Check if optimized HNSW index configuration is provided
-        if (config.hnswOptimized) {
-            // Initialize optimized HNSW index
-            this.index = new HNSWIndexOptimized(config.hnswOptimized, this.distanceFunction, config.storageAdapter || null);
-            this.useOptimizedIndex = true;
-        }
-        else {
-            // Initialize standard HNSW index
-            this.index = new HNSWIndex(config.hnsw, this.distanceFunction);
-        }
+        // Always use the optimized HNSW index implementation
+        this.index = new HNSWIndexOptimized(config.hnsw || {}, this.distanceFunction, config.storageAdapter || null);
+        this.useOptimizedIndex = true;
         // Set storage if provided, otherwise it will be initialized in init()
         this.storage = config.storageAdapter || null;
         // Store logging configuration
@@ -11408,6 +11410,10 @@ class BrainyData {
             if (!queryVector) {
                 throw new Error('Query vector is undefined or null');
             }
+            // Check if query vector dimensions match the expected dimensions
+            if (queryVector.length !== this._dimensions) {
+                throw new Error(`Query vector dimension mismatch: expected ${this._dimensions}, got ${queryVector.length}`);
+            }
             // If no noun types specified, search all nouns
             if (!nounTypes || nounTypes.length === 0) {
                 // Search in the index
@@ -12144,6 +12150,19 @@ class BrainyData {
         }
         return nounCount;
     }
+    /**
+     * Force an immediate flush of statistics to storage
+     * This ensures that any pending statistics updates are written to persistent storage
+     * @returns Promise that resolves when the statistics have been flushed
+     */
+    async flushStatistics() {
+        await this.ensureInitialized();
+        if (!this.storage) {
+            throw new Error('Storage not initialized');
+        }
+        // Call the flushStatisticsToStorage method on the storage adapter
+        await this.storage.flushStatisticsToStorage();
+    }
     /**
      * Get statistics about the current state of the database
      * @param options Additional options for retrieving statistics
@@ -12725,6 +12744,16 @@ class BrainyData {
      */
     async shutDown() {
         try {
+            // Flush statistics to ensure they're saved before shutting down
+            if (this.storage && this.isInitialized) {
+                try {
+                    await this.flushStatistics();
+                }
+                catch (statsError) {
+                    console.warn('Failed to flush statistics during shutdown:', statsError);
+                    // Continue with shutdown even if statistics flush fails
+                }
+            }
             // Disconnect from remote server if connected
             if (this.isConnectedToRemoteServer()) {
                 await this.disconnectFromRemoteServer();
@@ -12896,7 +12925,9 @@ class BrainyData {
                 try {
                     console.log('Reconstructing HNSW index from backup data...');
                     // Create a new index with the restored configuration
-                    this.index = new HNSWIndex(data.hnswIndex.config, this.distanceFunction);
+                    // Always use the optimized implementation for consistency
+                    this.index = new HNSWIndexOptimized(data.hnswIndex.config, this.distanceFunction, this.storage);
+                    this.useOptimizedIndex = true;
                     // Re-add all nouns to the index
                     for (const noun of data.nouns) {
                         if (noun.vector && noun.vector.length > 0) {