@soulcraft/brainy 5.3.5 → 5.4.0

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

@@ -2,18 +2,18 @@
  * OPFS (Origin Private File System) Storage Adapter
  * Provides persistent storage for the vector database using the Origin Private File System API
  */
-import { HNSWNoun, HNSWVerb, HNSWNounWithMetadata, HNSWVerbWithMetadata, StatisticsData } from '../../coreTypes.js';
+import { StatisticsData } from '../../coreTypes.js';
 import { BaseStorage, StorageBatchConfig } from '../baseStorage.js';
 import '../../types/fileSystemTypes.js';
-type HNSWNode = HNSWNoun;
-/**
- * Type alias for HNSWVerb to make the code more readable
- */
-type Edge = HNSWVerb;
-type HNSWNoun_internal = HNSWNoun;
 /**
  * OPFS storage adapter for browser environments
  * Uses the Origin Private File System API to store data persistently
+ *
+ * v5.4.0: Type-aware storage now built into BaseStorage
+ * - Removed 10 *_internal method overrides (now inherit from BaseStorage's type-first implementation)
+ * - Removed 2 pagination method overrides (getNounsWithPagination, getVerbsWithPagination)
+ * - Updated HNSW methods to use BaseStorage's getNoun/saveNoun (type-first paths)
+ * - All operations now use type-first paths: entities/nouns/{type}/vectors/{shard}/{id}.json
  */
 export declare class OPFSStorage extends BaseStorage {
     private rootDir;
@@ -61,85 +61,6 @@ export declare class OPFSStorage extends BaseStorage {
      * @returns Promise that resolves to true if persistent storage is granted, false otherwise
      */
     isPersistent(): Promise<boolean>;
-    /**
-     * Save a noun to storage
-     */
-    protected saveNoun_internal(noun: HNSWNoun_internal): Promise<void>;
-    /**
-     * 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>;
-    /**
-     * Get nouns by noun type (internal implementation)
-     * @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[]>;
-    /**
-     * Get nodes by noun type
-     * @param nounType The noun type to filter by
-     * @returns Promise that resolves to an array of nodes of the specified noun type
-     */
-    protected getNodesByNounType(nounType: string): Promise<HNSWNode[]>;
-    /**
-     * Delete a noun from storage (internal implementation)
-     */
-    protected deleteNoun_internal(id: string): Promise<void>;
-    /**
-     * Delete a node from storage
-     */
-    protected deleteNode(id: string): Promise<void>;
-    /**
-     * Save a verb to storage (internal implementation)
-     */
-    protected saveVerb_internal(verb: HNSWVerb): Promise<void>;
-    /**
-     * Save an edge to storage
-     */
-    protected saveEdge(edge: Edge): Promise<void>;
-    /**
-     * Get a verb from storage (internal implementation)
-     * v4.0.0: Returns ONLY vector + core relational fields (no metadata field)
-     * Base class combines with metadata via getVerb() -> HNSWVerbWithMetadata
-     */
-    protected getVerb_internal(id: string): Promise<HNSWVerb | null>;
-    /**
-     * Get an edge from storage
-     */
-    protected getEdge(id: string): Promise<Edge | null>;
-    /**
-     * Get all edges from storage
-     */
-    protected getAllEdges(): Promise<Edge[]>;
-    /**
-     * Get verbs by source (internal implementation)
-     */
-    protected getVerbsBySource_internal(sourceId: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Get edges by source
-     */
-    protected getEdgesBySource(sourceId: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Get verbs by target (internal implementation)
-     */
-    protected getVerbsByTarget_internal(targetId: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Get edges by target
-     */
-    protected getEdgesByTarget(targetId: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Get verbs by type (internal implementation)
-     */
-    protected getVerbsByType_internal(type: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Get edges by type
-     */
-    protected getEdgesByType(type: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Delete a verb from storage (internal implementation)
-     */
-    protected deleteVerb_internal(id: string): Promise<void>;
     /**
      * Delete an edge from storage
      */
@@ -268,41 +189,6 @@ export declare class OPFSStorage extends BaseStorage {
      * @param options Pagination and filter options
      * @returns Promise that resolves to a paginated result of nouns
      */
-    getNounsWithPagination(options?: {
-        limit?: number;
-        cursor?: string;
-        filter?: {
-            nounType?: string | string[];
-            service?: string | string[];
-            metadata?: Record<string, any>;
-        };
-    }): Promise<{
-        items: HNSWNounWithMetadata[];
-        totalCount?: number;
-        hasMore: boolean;
-        nextCursor?: string;
-    }>;
-    /**
-     * Get verbs with pagination support
-     * @param options Pagination and filter options
-     * @returns Promise that resolves to a paginated result of verbs
-     */
-    getVerbsWithPagination(options?: {
-        limit?: number;
-        cursor?: string;
-        filter?: {
-            verbType?: string | string[];
-            sourceId?: string | string[];
-            targetId?: string | string[];
-            service?: string | string[];
-            metadata?: Record<string, any>;
-        };
-    }): Promise<{
-        items: HNSWVerbWithMetadata[];
-        totalCount?: number;
-        hasMore: boolean;
-        nextCursor?: string;
-    }>;
     /**
      * Initialize counts from OPFS storage
      */
@@ -318,15 +204,17 @@ export declare class OPFSStorage extends BaseStorage {
     /**
      * Get a noun's vector for HNSW rebuild
      */
+    /**
+     * Get vector for a noun
+     * v5.4.0: Uses BaseStorage's getNoun (type-first paths)
+     */
     getNounVector(id: string): Promise<number[] | null>;
     private hnswLocks;
     /**
      * Save HNSW graph data for a noun
-     * Storage path: nouns/hnsw/{shard}/{id}.json
      *
-     * CRITICAL FIX (v4.10.1): Mutex locking to prevent race conditions during concurrent HNSW updates
-     * Browser is single-threaded but async operations can interleave - mutex prevents this
-     * Prevents data corruption when multiple entities connect to same neighbor simultaneously
+     * v5.4.0: Uses BaseStorage's getNoun/saveNoun (type-first paths)
+     * CRITICAL: Preserves mutex locking to prevent read-modify-write races
      */
     saveHNSWData(nounId: string, hnswData: {
         level: number;
@@ -334,7 +222,7 @@ export declare class OPFSStorage extends BaseStorage {
     }): Promise<void>;
     /**
      * Get HNSW graph data for a noun
-     * Storage path: nouns/hnsw/{shard}/{id}.json
+     * v5.4.0: Uses BaseStorage's getNoun (type-first paths)
      */
     getHNSWData(nounId: string): Promise<{
         level: number;
@@ -359,4 +247,3 @@ export declare class OPFSStorage extends BaseStorage {
         maxLevel: number;
     } | null>;
 }
-export {};