@soulcraft/brainy 3.37.0 → 3.37.2

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [3.37.2](https://github.com/soulcraftlabs/brainy/compare/v3.37.1...v3.37.2) (2025-10-10)
+
+- fix: ensure GCS storage initialization before pagination (2565685)
+
+
+### [3.37.1](https://github.com/soulcraftlabs/brainy/compare/v3.37.0...v3.37.1) (2025-10-10)
+
+
+### 🐛 Bug Fixes
+
+* combine vector and metadata in getNoun/getVerb internal methods ([cb1e37c](https://github.com/soulcraftlabs/brainy/commit/cb1e37c0e8132f53be0f359feaef5dcf342462d2))
+
 ### [3.37.0](https://github.com/soulcraftlabs/brainy/compare/v3.36.1...v3.37.0) (2025-10-10)
 
 - fix: implement 2-file storage architecture for GCS scalability (59da5f6)

package/dist/coreTypes.d.ts

@@ -82,6 +82,7 @@ export interface HNSWVerb {
     id: string;
     vector: Vector;
     connections: Map<number, Set<string>>;
+    metadata?: any;
 }
 /**
  * Verb representing a relationship between nouns

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

@@ -161,7 +161,8 @@ export declare class FileSystemStorage extends BaseStorage {
      */
     protected saveNoun_internal(noun: HNSWNoun): Promise<void>;
     /**
-     * Get a noun from storage
+     * Get a noun from storage (internal implementation)
+     * Combines vector data from getNode() with metadata from getNounMetadata()
      */
     protected getNoun_internal(id: string): Promise<HNSWNoun | null>;
     /**
@@ -177,7 +178,8 @@ export declare class FileSystemStorage extends BaseStorage {
      */
     protected saveVerb_internal(verb: HNSWVerb): Promise<void>;
     /**
-     * Get a verb from storage
+     * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     protected getVerb_internal(id: string): Promise<HNSWVerb | null>;
     /**

package/dist/storage/adapters/fileSystemStorage.js

@@ -863,10 +863,22 @@ export class FileSystemStorage extends BaseStorage {
         return this.saveNode(noun);
     }
     /**
-     * Get a noun from storage
+     * Get a noun from storage (internal implementation)
+     * Combines vector data from getNode() with metadata from getNounMetadata()
      */
     async getNoun_internal(id) {
-        return this.getNode(id);
+        // Get vector data (lightweight)
+        const node = await this.getNode(id);
+        if (!node) {
+            return null;
+        }
+        // Get metadata (entity data in 2-file system)
+        const metadata = await this.getNounMetadata(id);
+        // Combine into complete noun object
+        return {
+            ...node,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get nouns by noun type
@@ -887,10 +899,22 @@ export class FileSystemStorage extends BaseStorage {
         return this.saveEdge(verb);
     }
     /**
-     * Get a verb from storage
+     * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     async getVerb_internal(id) {
-        return this.getEdge(id);
+        // Get vector data (lightweight)
+        const edge = await this.getEdge(id);
+        if (!edge) {
+            return null;
+        }
+        // Get metadata (relationship data in 2-file system)
+        const metadata = await this.getVerbMetadata(id);
+        // Combine into complete verb object
+        return {
+            ...edge,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get verbs by source

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

@@ -148,6 +148,7 @@ export declare class GcsStorage extends BaseStorage {
     private saveNodeDirect;
     /**
      * Get a noun from storage (internal implementation)
+     * Combines vector data from getNode() with metadata from getNounMetadata()
      */
     protected getNoun_internal(id: string): Promise<HNSWNoun | null>;
     /**
@@ -196,6 +197,7 @@ export declare class GcsStorage extends BaseStorage {
     private saveEdgeDirect;
     /**
      * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     protected getVerb_internal(id: string): Promise<HNSWVerb | null>;
     /**

package/dist/storage/adapters/gcsStorage.js

@@ -359,9 +359,21 @@ export class GcsStorage extends BaseStorage {
     }
     /**
      * Get a noun from storage (internal implementation)
+     * Combines vector data from getNode() with metadata from getNounMetadata()
      */
     async getNoun_internal(id) {
-        return this.getNode(id);
+        // Get vector data (lightweight)
+        const node = await this.getNode(id);
+        if (!node) {
+            return null;
+        }
+        // Get metadata (entity data in 2-file system)
+        const metadata = await this.getNounMetadata(id);
+        // Combine into complete noun object
+        return {
+            ...node,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get a node from storage
@@ -619,9 +631,21 @@ export class GcsStorage extends BaseStorage {
     }
     /**
      * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     async getVerb_internal(id) {
-        return this.getEdge(id);
+        // Get vector data (lightweight)
+        const edge = await this.getEdge(id);
+        if (!edge) {
+            return null;
+        }
+        // Get metadata (relationship data in 2-file system)
+        const metadata = await this.getVerbMetadata(id);
+        // Combine into complete verb object
+        return {
+            ...edge,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get an edge from storage
@@ -758,6 +782,7 @@ export class GcsStorage extends BaseStorage {
      * Iterates through UUID-based shards for consistent pagination
      */
     async getNodesWithPagination(options) {
+        await this.ensureInitialized(); // CRITICAL: Must initialize before using this.bucket
         const limit = options.limit || 100;
         const useCache = options.useCache !== false;
         try {

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

@@ -28,7 +28,8 @@ export declare class MemoryStorage extends BaseStorage {
      */
     protected saveNoun_internal(noun: HNSWNoun): Promise<void>;
     /**
-     * Get a noun from storage
+     * Get a noun from storage (internal implementation)
+     * Combines vector data from nouns map with metadata from getNounMetadata()
      */
     protected getNoun_internal(id: string): Promise<HNSWNoun | null>;
     /**
@@ -77,7 +78,8 @@ export declare class MemoryStorage extends BaseStorage {
      */
     protected saveVerb_internal(verb: HNSWVerb): Promise<void>;
     /**
-     * Get a verb from storage
+     * Get a verb from storage (internal implementation)
+     * Combines vector data from verbs map with metadata from getVerbMetadata()
      */
     protected getVerb_internal(id: string): Promise<HNSWVerb | null>;
     /**

package/dist/storage/adapters/memoryStorage.js

@@ -63,7 +63,8 @@ export class MemoryStorage extends BaseStorage {
         }
     }
     /**
-     * Get a noun from storage
+     * Get a noun from storage (internal implementation)
+     * Combines vector data from nouns map with metadata from getNounMetadata()
      */
     async getNoun_internal(id) {
         // Get the noun directly from the nouns map
@@ -73,20 +74,23 @@ export class MemoryStorage extends BaseStorage {
             return null;
         }
         // Return a deep copy to avoid reference issues
-        // CRITICAL: Only return lightweight vector data (no metadata)
-        // Metadata is retrieved separately via getNounMetadata() (2-file system)
         const nounCopy = {
             id: noun.id,
             vector: [...noun.vector],
             connections: new Map(),
             level: noun.level || 0
-            // NO metadata field - retrieved separately for scalability
         };
         // Copy connections
         for (const [level, connections] of noun.connections.entries()) {
             nounCopy.connections.set(level, new Set(connections));
         }
-        return nounCopy;
+        // Get metadata (entity data in 2-file system)
+        const metadata = await this.getNounMetadata(id);
+        // Combine into complete noun object
+        return {
+            ...nounCopy,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get nouns with pagination and filtering
@@ -237,7 +241,8 @@ export class MemoryStorage extends BaseStorage {
         // since HNSWVerb doesn't contain type information
     }
     /**
-     * Get a verb from storage
+     * Get a verb from storage (internal implementation)
+     * Combines vector data from verbs map with metadata from getVerbMetadata()
      */
     async getVerb_internal(id) {
         // Get the verb directly from the verbs map
@@ -246,16 +251,6 @@ export class MemoryStorage extends BaseStorage {
         if (!verb) {
             return null;
         }
-        // Create default timestamp if not present
-        const defaultTimestamp = {
-            seconds: Math.floor(Date.now() / 1000),
-            nanoseconds: (Date.now() % 1000) * 1000000
-        };
-        // Create default createdBy if not present
-        const defaultCreatedBy = {
-            augmentation: 'unknown',
-            version: '1.0'
-        };
         // Return a deep copy of the HNSWVerb
         const verbCopy = {
             id: verb.id,
@@ -266,7 +261,13 @@ export class MemoryStorage extends BaseStorage {
         for (const [level, connections] of verb.connections.entries()) {
             verbCopy.connections.set(level, new Set(connections));
         }
-        return verbCopy;
+        // Get metadata (relationship data in 2-file system)
+        const metadata = await this.getVerbMetadata(id);
+        // Combine into complete verb object
+        return {
+            ...verbCopy,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get verbs with pagination and filtering

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

@@ -53,7 +53,8 @@ export declare class OPFSStorage extends BaseStorage {
      */
     protected saveNoun_internal(noun: HNSWNoun_internal): Promise<void>;
     /**
-     * Get a noun from storage
+     * Get a noun from storage (internal implementation)
+     * Combines vector data from file with metadata from getNounMetadata()
      */
     protected getNoun_internal(id: string): Promise<HNSWNoun_internal | null>;
     /**
@@ -86,6 +87,7 @@ export declare class OPFSStorage extends BaseStorage {
     protected saveEdge(edge: Edge): Promise<void>;
     /**
      * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     protected getVerb_internal(id: string): Promise<HNSWVerb | null>;
     /**

package/dist/storage/adapters/opfsStorage.js

@@ -173,7 +173,8 @@ export class OPFSStorage extends BaseStorage {
         }
     }
     /**
-     * Get a noun from storage
+     * Get a noun from storage (internal implementation)
+     * Combines vector data from file with metadata from getNounMetadata()
      */
     async getNoun_internal(id) {
         await this.ensureInitialized();
@@ -193,12 +194,19 @@ export class OPFSStorage extends BaseStorage {
             for (const [level, nounIds] of Object.entries(data.connections)) {
                 connections.set(Number(level), new Set(nounIds));
             }
-            return {
+            const node = {
                 id: data.id,
                 vector: data.vector,
                 connections,
                 level: data.level || 0
             };
+            // Get metadata (entity data in 2-file system)
+            const metadata = await this.getNounMetadata(id);
+            // Combine into complete noun object
+            return {
+                ...node,
+                metadata: metadata || {}
+            };
         }
         catch (error) {
             // Noun not found or other error
@@ -333,9 +341,21 @@ export class OPFSStorage extends BaseStorage {
     }
     /**
      * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     async getVerb_internal(id) {
-        return this.getEdge(id);
+        // Get vector data (lightweight)
+        const edge = await this.getEdge(id);
+        if (!edge) {
+            return null;
+        }
+        // Get metadata (relationship data in 2-file system)
+        const metadata = await this.getVerbMetadata(id);
+        // Combine into complete verb object
+        return {
+            ...edge,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get an edge from storage

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

@@ -222,6 +222,7 @@ export declare class S3CompatibleStorage extends BaseStorage {
     protected saveNode(node: HNSWNode): Promise<void>;
     /**
      * Get a noun from storage (internal implementation)
+     * Combines vector data from getNode() with metadata from getNounMetadata()
      */
     protected getNoun_internal(id: string): Promise<HNSWNoun | null>;
     /**
@@ -297,6 +298,7 @@ export declare class S3CompatibleStorage extends BaseStorage {
     protected saveEdge(edge: Edge): Promise<void>;
     /**
      * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     protected getVerb_internal(id: string): Promise<HNSWVerb | null>;
     /**

package/dist/storage/adapters/s3CompatibleStorage.js

@@ -787,9 +787,21 @@ export class S3CompatibleStorage extends BaseStorage {
     }
     /**
      * Get a noun from storage (internal implementation)
+     * Combines vector data from getNode() with metadata from getNounMetadata()
      */
     async getNoun_internal(id) {
-        return this.getNode(id);
+        // Get vector data (lightweight)
+        const node = await this.getNode(id);
+        if (!node) {
+            return null;
+        }
+        // Get metadata (entity data in 2-file system)
+        const metadata = await this.getNounMetadata(id);
+        // Combine into complete noun object
+        return {
+            ...node,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get a node from storage
@@ -1170,9 +1182,21 @@ export class S3CompatibleStorage extends BaseStorage {
     }
     /**
      * Get a verb from storage (internal implementation)
+     * Combines vector data from getEdge() with metadata from getVerbMetadata()
      */
     async getVerb_internal(id) {
-        return this.getEdge(id);
+        // Get vector data (lightweight)
+        const edge = await this.getEdge(id);
+        if (!edge) {
+            return null;
+        }
+        // Get metadata (relationship data in 2-file system)
+        const metadata = await this.getVerbMetadata(id);
+        // Combine into complete verb object
+        return {
+            ...edge,
+            metadata: metadata || {}
+        };
     }
     /**
      * Get an edge from storage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.37.0",
+  "version": "3.37.2",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",