@soulcraft/brainy 0.36.0 → 0.38.0

package/dist/utils/autoConfiguration.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Automatic Configuration System for Brainy Vector Database
+ * Detects environment, resources, and data patterns to provide optimal settings
+ */
+export interface AutoConfigResult {
+    environment: 'browser' | 'nodejs' | 'serverless' | 'unknown';
+    availableMemory: number;
+    cpuCores: number;
+    threadingAvailable: boolean;
+    persistentStorageAvailable: boolean;
+    s3StorageDetected: boolean;
+    recommendedConfig: {
+        expectedDatasetSize: number;
+        maxMemoryUsage: number;
+        targetSearchLatency: number;
+        enablePartitioning: boolean;
+        enableCompression: boolean;
+        enableDistributedSearch: boolean;
+        enablePredictiveCaching: boolean;
+        partitionStrategy: 'semantic' | 'hash';
+        maxNodesPerPartition: number;
+        semanticClusters: number;
+    };
+    optimizationFlags: {
+        useMemoryMapping: boolean;
+        aggressiveCaching: boolean;
+        backgroundOptimization: boolean;
+        compressionLevel: 'none' | 'light' | 'aggressive';
+    };
+}
+export interface DatasetAnalysis {
+    estimatedSize: number;
+    vectorDimension?: number;
+    growthRate?: number;
+    accessPatterns?: 'read-heavy' | 'write-heavy' | 'balanced';
+}
+/**
+ * Automatic configuration system that detects environment and optimizes settings
+ */
+export declare class AutoConfiguration {
+    private static instance;
+    private cachedConfig;
+    private datasetStats;
+    private constructor();
+    static getInstance(): AutoConfiguration;
+    /**
+     * Detect environment and generate optimal configuration
+     */
+    detectAndConfigure(hints?: {
+        expectedDataSize?: number;
+        s3Available?: boolean;
+        memoryBudget?: number;
+    }): Promise<AutoConfigResult>;
+    /**
+     * Update configuration based on runtime dataset analysis
+     */
+    adaptToDataset(analysis: DatasetAnalysis): Promise<AutoConfigResult>;
+    /**
+     * Learn from performance metrics and adjust configuration
+     */
+    learnFromPerformance(metrics: {
+        averageSearchTime: number;
+        memoryUsage: number;
+        cacheHitRate: number;
+        errorRate: number;
+    }): Promise<Partial<AutoConfigResult['recommendedConfig']>>;
+    /**
+     * Get minimal configuration for quick setup
+     */
+    getQuickSetupConfig(scenario: 'small' | 'medium' | 'large' | 'enterprise'): Promise<{
+        expectedDatasetSize: number;
+        maxMemoryUsage: number;
+        targetSearchLatency: number;
+        s3Required: boolean;
+    }>;
+    /**
+     * Detect the current runtime environment
+     */
+    private detectEnvironment;
+    /**
+     * Detect available system resources
+     */
+    private detectResources;
+    /**
+     * Detect available storage capabilities
+     */
+    private detectStorageCapabilities;
+    /**
+     * Generate recommended configuration based on detected environment and resources
+     */
+    private generateRecommendedConfig;
+    /**
+     * Generate optimization flags based on environment and resources
+     */
+    private generateOptimizationFlags;
+    /**
+     * Adapt configuration based on actual dataset analysis
+     */
+    private adaptConfigurationToData;
+    /**
+     * Estimate dataset size if not provided
+     */
+    private estimateDatasetSize;
+    /**
+     * Reset cached configuration (for testing or manual refresh)
+     */
+    resetCache(): void;
+}
+/**
+ * Convenience function for quick auto-configuration
+ */
+export declare function autoConfigureBrainy(hints?: {
+    expectedDataSize?: number;
+    s3Available?: boolean;
+    memoryBudget?: number;
+}): Promise<AutoConfigResult>;
+/**
+ * Get quick setup configuration for common scenarios
+ */
+export declare function getQuickSetup(scenario: 'small' | 'medium' | 'large' | 'enterprise'): Promise<{
+    expectedDatasetSize: number;
+    maxMemoryUsage: number;
+    targetSearchLatency: number;
+    s3Required: boolean;
+}>;

package/dist/utils/autoConfiguration.d.ts.map

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

package/dist/utils/crypto.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cross-platform crypto utilities
+ * Provides hashing functions that work in both Node.js and browser environments
+ */
+/**
+ * Simple string hash function that works in all environments
+ * Uses djb2 algorithm - fast and good distribution
+ * @param str - String to hash
+ * @returns Positive integer hash
+ */
+export declare function hashString(str: string): number;
+/**
+ * Alternative: FNV-1a hash algorithm
+ * Good distribution and fast
+ * @param str - String to hash
+ * @returns Positive integer hash
+ */
+export declare function fnv1aHash(str: string): number;
+/**
+ * Generate a deterministic hash for partitioning
+ * Uses the most appropriate algorithm for the environment
+ * @param input - Input string to hash
+ * @returns Positive integer hash suitable for modulo operations
+ */
+export declare function getPartitionHash(input: string): number;

package/dist/utils/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "description": "A vector graph database using HNSW indexing with Origin Private File System storage",
   "main": "dist/unified.js",
   "module": "dist/unified.js",