@soulcraft/brainy 0.28.0 → 0.30.0

package/dist/storage/opfsStorage.d.ts

@@ -0,0 +1,236 @@
+/**
+ * OPFS (Origin Private File System) Storage Adapter
+ * Provides persistent storage for the vector database using the Origin Private File System API
+ */
+import { GraphVerb, HNSWNoun, StorageAdapter } from '../coreTypes.js';
+import '../types/fileSystemTypes.js';
+declare global {
+    interface FileSystemDirectoryHandle {
+        entries(): AsyncIterableIterator<[string, FileSystemHandle]>;
+    }
+}
+type HNSWNode = HNSWNoun;
+type Edge = GraphVerb;
+export declare class OPFSStorage implements StorageAdapter {
+    private rootDir;
+    private nounsDir;
+    private verbsDir;
+    private metadataDir;
+    private isInitialized;
+    private isAvailable;
+    private isPersistentRequested;
+    private isPersistentGranted;
+    constructor();
+    /**
+     * Initialize the storage adapter
+     */
+    init(): Promise<void>;
+    /**
+     * Check if OPFS is available in the current environment
+     */
+    isOPFSAvailable(): boolean;
+    /**
+     * Request persistent storage permission from the user
+     * @returns Promise that resolves to true if permission was granted, false otherwise
+     */
+    requestPersistentStorage(): Promise<boolean>;
+    /**
+     * Check if persistent storage is granted
+     * @returns Promise that resolves to true if persistent storage is granted, false otherwise
+     */
+    isPersistent(): Promise<boolean>;
+    /**
+     * Save a noun to storage
+     */
+    saveNoun(noun: HNSWNoun): Promise<void>;
+    /**
+     * Get a noun from storage
+     */
+    getNoun(id: string): Promise<HNSWNoun | null>;
+    /**
+     * 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
+     */
+    getNounsByNounType(nounType: string): Promise<HNSWNoun[]>;
+    /**
+     * Get all nouns from storage
+     */
+    getAllNouns(): Promise<HNSWNoun[]>;
+    /**
+     * Delete a noun from storage
+     */
+    deleteNoun(id: string): Promise<void>;
+    /**
+     * Save a verb to storage
+     */
+    saveVerb(verb: GraphVerb): Promise<void>;
+    /**
+     * Get a verb from storage
+     */
+    getVerb(id: string): Promise<GraphVerb | null>;
+    /**
+     * Get all edges from storage
+     */
+    getAllEdges(): Promise<Edge[]>;
+    /**
+     * Get all verbs from storage (alias for getAllEdges)
+     */
+    getAllVerbs(): Promise<GraphVerb[]>;
+    /**
+     * Delete an edge from storage
+     */
+    deleteEdge(id: string): Promise<void>;
+    /**
+     * Delete a verb from storage (alias for deleteEdge)
+     */
+    deleteVerb(id: string): Promise<void>;
+    /**
+     * Get edges by source node ID
+     */
+    getEdgesBySource(sourceId: string): Promise<Edge[]>;
+    /**
+     * Get verbs by source node ID (alias for getEdgesBySource)
+     */
+    getVerbsBySource(sourceId: string): Promise<GraphVerb[]>;
+    /**
+     * Get edges by target node ID
+     */
+    getEdgesByTarget(targetId: string): Promise<Edge[]>;
+    /**
+     * Get verbs by target node ID (alias for getEdgesByTarget)
+     */
+    getVerbsByTarget(targetId: string): Promise<GraphVerb[]>;
+    /**
+     * Get edges by type
+     */
+    getEdgesByType(type: string): Promise<Edge[]>;
+    /**
+     * Get verbs by type (alias for getEdgesByType)
+     */
+    getVerbsByType(type: string): Promise<GraphVerb[]>;
+    /**
+     * Save metadata for a node
+     */
+    saveMetadata(id: string, metadata: any): Promise<void>;
+    /**
+     * Get metadata for a node
+     */
+    getMetadata(id: string): Promise<any | null>;
+    /**
+     * Clear all data from storage
+     */
+    clear(): Promise<void>;
+    /**
+     * Ensure the storage adapter is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Convert a Map to a plain object for serialization
+     */
+    private mapToObject;
+    /**
+     * Get the directory for a node - now all nouns use the same directory
+     */
+    private getNodeDirectory;
+    /**
+     * Get information about storage usage and capacity
+     */
+    getStorageStatus(): Promise<{
+        type: string;
+        used: number;
+        quota: number | null;
+        details?: Record<string, any>;
+    }>;
+}
+/**
+ * In-memory storage adapter for environments where OPFS is not available
+ */
+export declare class MemoryStorage implements StorageAdapter {
+    private nouns;
+    private verbs;
+    private metadata;
+    constructor();
+    saveNoun(noun: HNSWNoun): Promise<void>;
+    getNoun(id: string): Promise<HNSWNoun | null>;
+    getAllNouns(): Promise<HNSWNoun[]>;
+    getNounsByNounType(nounType: string): Promise<HNSWNoun[]>;
+    deleteNoun(id: string): Promise<void>;
+    saveVerb(verb: GraphVerb): Promise<void>;
+    getVerb(id: string): Promise<GraphVerb | null>;
+    getAllVerbs(): Promise<GraphVerb[]>;
+    getVerbsBySource(sourceId: string): Promise<GraphVerb[]>;
+    getVerbsByTarget(targetId: string): Promise<GraphVerb[]>;
+    getVerbsByType(type: string): Promise<GraphVerb[]>;
+    deleteVerb(id: string): Promise<void>;
+    init(): Promise<void>;
+    /**
+     * Get the noun type for a node from its metadata
+     */
+    private getNounType;
+    saveNode(node: HNSWNode): Promise<void>;
+    getNode(id: string): Promise<HNSWNode | null>;
+    /**
+     * 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
+     */
+    getNodesByNounType(nounType: string): Promise<HNSWNode[]>;
+    getAllNodes(): Promise<HNSWNode[]>;
+    deleteNode(id: string): Promise<void>;
+    saveMetadata(id: string, metadata: any): Promise<void>;
+    getMetadata(id: string): Promise<any | null>;
+    saveEdge(edge: Edge): Promise<void>;
+    getEdge(id: string): Promise<Edge | null>;
+    getAllEdges(): Promise<Edge[]>;
+    getEdgesBySource(sourceId: string): Promise<Edge[]>;
+    getEdgesByTarget(targetId: string): Promise<Edge[]>;
+    getEdgesByType(type: string): Promise<Edge[]>;
+    deleteEdge(id: string): Promise<void>;
+    clear(): Promise<void>;
+    /**
+     * Get information about storage usage and capacity
+     */
+    getStorageStatus(): Promise<{
+        type: string;
+        used: number;
+        quota: number | null;
+        details?: Record<string, any>;
+    }>;
+}
+/**
+ * Factory function to create the appropriate storage adapter based on the environment
+ * @param options Configuration options for storage
+ * @returns Promise that resolves to a StorageAdapter instance
+ */
+export declare function createStorage(options?: {
+    requestPersistentStorage?: boolean;
+    r2Storage?: {
+        bucketName?: string;
+        accountId?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+    };
+    s3Storage?: {
+        bucketName?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        region?: string;
+    };
+    gcsStorage?: {
+        bucketName?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        endpoint?: string;
+    };
+    customS3Storage?: {
+        bucketName?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        endpoint?: string;
+        region?: string;
+    };
+    forceFileSystemStorage?: boolean;
+    forceMemoryStorage?: boolean;
+}): Promise<StorageAdapter>;
+export {};

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

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

package/dist/storage/s3CompatibleStorage.d.ts

@@ -0,0 +1,157 @@
+import { GraphVerb, HNSWNoun, StorageAdapter } from '../coreTypes.js';
+type HNSWNode = HNSWNoun;
+type Edge = GraphVerb;
+export { S3CompatibleStorage as R2Storage };
+/**
+ * S3-compatible storage adapter for server environments
+ * Uses the AWS S3 client to interact with S3-compatible storage services
+ * including Amazon S3, Cloudflare R2, and Google Cloud Storage
+ *
+ * To use this adapter with Cloudflare R2, you need to provide:
+ * - bucketName: Your bucket name
+ * - accountId: Your Cloudflare account ID
+ * - accessKeyId: R2 access key ID
+ * - secretAccessKey: R2 secret access key
+ * - serviceType: 'r2'
+ *
+ * To use this adapter with Amazon S3, you need to provide:
+ * - bucketName: Your S3 bucket name
+ * - accessKeyId: AWS access key ID
+ * - secretAccessKey: AWS secret access key
+ * - region: AWS region (e.g., 'us-east-1')
+ * - serviceType: 's3'
+ *
+ * To use this adapter with Google Cloud Storage, you need to provide:
+ * - bucketName: Your GCS bucket name
+ * - accessKeyId: HMAC access key
+ * - secretAccessKey: HMAC secret
+ * - endpoint: GCS endpoint (e.g., 'https://storage.googleapis.com')
+ * - serviceType: 'gcs'
+ *
+ * For other S3-compatible services, provide:
+ * - bucketName: Your bucket name
+ * - accessKeyId: Access key ID
+ * - secretAccessKey: Secret access key
+ * - endpoint: Service endpoint URL
+ * - region: Region (if required)
+ * - serviceType: 'custom'
+ */
+export declare class S3CompatibleStorage implements StorageAdapter {
+    private bucketName;
+    private accessKeyId;
+    private secretAccessKey;
+    private endpoint?;
+    private region?;
+    private accountId?;
+    private serviceType;
+    private s3Client;
+    private isInitialized;
+    saveNoun(noun: HNSWNoun): Promise<void>;
+    getNoun(id: string): Promise<HNSWNoun | null>;
+    getAllNouns(): Promise<HNSWNoun[]>;
+    getNounsByNounType(nounType: string): Promise<HNSWNoun[]>;
+    deleteNoun(id: string): Promise<void>;
+    saveVerb(verb: GraphVerb): Promise<void>;
+    getVerb(id: string): Promise<GraphVerb | null>;
+    getAllVerbs(): Promise<GraphVerb[]>;
+    getVerbsBySource(sourceId: string): Promise<GraphVerb[]>;
+    getVerbsByTarget(targetId: string): Promise<GraphVerb[]>;
+    getVerbsByType(type: string): Promise<GraphVerb[]>;
+    deleteVerb(id: string): Promise<void>;
+    constructor(options: {
+        bucketName: string;
+        accessKeyId: string;
+        secretAccessKey: string;
+        serviceType: 'r2' | 's3' | 'gcs' | 'custom';
+        accountId?: string;
+        region?: string;
+        endpoint?: string;
+    });
+    /**
+     * Initialize the storage adapter
+     */
+    init(): Promise<void>;
+    /**
+     * Save a node to storage
+     */
+    saveNode(node: HNSWNode): Promise<void>;
+    /**
+     * Get a node from storage
+     */
+    getNode(id: string): Promise<HNSWNode | null>;
+    /**
+     * 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
+     */
+    getNodesByNounType(nounType: string): Promise<HNSWNode[]>;
+    /**
+     * Get all nodes from storage
+     */
+    getAllNodes(): Promise<HNSWNode[]>;
+    /**
+     * Delete a node from storage
+     */
+    deleteNode(id: string): Promise<void>;
+    /**
+     * Save an edge to storage
+     */
+    saveEdge(edge: Edge): Promise<void>;
+    /**
+     * Get an edge from storage
+     */
+    getEdge(id: string): Promise<Edge | null>;
+    /**
+     * Get all edges from storage
+     */
+    getAllEdges(): Promise<Edge[]>;
+    /**
+     * Get edges by source node ID
+     */
+    getEdgesBySource(sourceId: string): Promise<Edge[]>;
+    /**
+     * Get edges by target node ID
+     */
+    getEdgesByTarget(targetId: string): Promise<Edge[]>;
+    /**
+     * Get edges by type
+     */
+    getEdgesByType(type: string): Promise<Edge[]>;
+    /**
+     * Delete an edge from storage
+     */
+    deleteEdge(id: string): Promise<void>;
+    /**
+     * Save metadata to storage
+     */
+    saveMetadata(id: string, metadata: any): Promise<void>;
+    /**
+     * Get metadata from storage
+     */
+    getMetadata(id: string): Promise<any | null>;
+    /**
+     * Clear all data from storage
+     */
+    clear(): Promise<void>;
+    /**
+     * Get information about storage usage and capacity
+     */
+    getStorageStatus(): Promise<{
+        type: string;
+        used: number;
+        quota: number | null;
+        details?: Record<string, any>;
+    }>;
+    /**
+     * Ensure the storage adapter is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Get the appropriate prefix for a node - now all nouns use the same prefix
+     */
+    private getNodePrefix;
+    /**
+     * Convert a Map to a plain object for serialization
+     */
+    private mapToObject;
+}

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

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

package/dist/types/paginationTypes.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Types for pagination and filtering in data retrieval operations
+ */
+/**
+ * Pagination options for data retrieval
+ */
+export interface PaginationOptions {
+    /**
+     * The number of items to skip (for offset-based pagination)
+     */
+    offset?: number;
+    /**
+     * The maximum number of items to return
+     */
+    limit?: number;
+    /**
+     * Token for cursor-based pagination (for continuing from a previous page)
+     */
+    cursor?: string;
+}
+/**
+ * Filter options for noun retrieval
+ */
+export interface NounFilterOptions {
+    /**
+     * Filter by noun type
+     */
+    nounType?: string | string[];
+    /**
+     * Filter by service
+     */
+    service?: string | string[];
+    /**
+     * Filter by metadata fields (key-value pairs)
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Filter by creation date range
+     */
+    createdAt?: {
+        from?: Date | number;
+        to?: Date | number;
+    };
+    /**
+     * Filter by update date range
+     */
+    updatedAt?: {
+        from?: Date | number;
+        to?: Date | number;
+    };
+}
+/**
+ * Filter options for verb retrieval
+ */
+export interface VerbFilterOptions {
+    /**
+     * Filter by verb type
+     */
+    verbType?: string | string[];
+    /**
+     * Filter by source noun ID
+     */
+    sourceId?: string | string[];
+    /**
+     * Filter by target noun ID
+     */
+    targetId?: string | string[];
+    /**
+     * Filter by service
+     */
+    service?: string | string[];
+    /**
+     * Filter by metadata fields (key-value pairs)
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Filter by creation date range
+     */
+    createdAt?: {
+        from?: Date | number;
+        to?: Date | number;
+    };
+    /**
+     * Filter by update date range
+     */
+    updatedAt?: {
+        from?: Date | number;
+        to?: Date | number;
+    };
+}
+/**
+ * Result of a paginated query
+ */
+export interface PaginatedResult<T> {
+    /**
+     * The items for the current page
+     */
+    items: T[];
+    /**
+     * The total number of items matching the query (may be estimated)
+     */
+    totalCount?: number;
+    /**
+     * Whether there are more items available
+     */
+    hasMore: boolean;
+    /**
+     * Cursor for fetching the next page (for cursor-based pagination)
+     */
+    nextCursor?: string;
+}

package/dist/types/paginationTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginationTypes.d.ts","sourceRoot":"","sources":["../../src/types/paginationTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACrB,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;KACpB,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACrB,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACrB,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;KACpB,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACrB,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC;;OAEG;IACH,KAAK,EAAE,CAAC,EAAE,CAAC;IAEX;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}