agentdb 1.6.0 → 2.0.0-alpha.1

package/dist/browser/browser/index.js

@@ -0,0 +1,233 @@
+/**
+ * AgentDB Browser Advanced Features
+ *
+ * Unified export for all browser-compatible advanced features.
+ *
+ * Features:
+ * - Product Quantization (PQ8/PQ16/PQ32) - 4-32x memory compression
+ * - HNSW Indexing - 10-20x faster approximate search
+ * - Graph Neural Networks - Graph attention and message passing
+ * - MMR Diversity - Maximal marginal relevance ranking
+ * - Tensor Compression - SVD dimension reduction
+ * - Batch Operations - Optimized vector processing
+ *
+ * Bundle Size: ~35 KB minified (~12 KB gzipped)
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+// ============================================================================
+// Product Quantization
+// ============================================================================
+export { ProductQuantization, createPQ8, createPQ16, createPQ32 } from './ProductQuantization';
+// ============================================================================
+// HNSW Indexing
+// ============================================================================
+export { HNSWIndex, createHNSW, createFastHNSW, createAccurateHNSW } from './HNSWIndex';
+// ============================================================================
+// Advanced Features
+// ============================================================================
+export { GraphNeuralNetwork, MaximalMarginalRelevance, TensorCompression, BatchProcessor } from './AdvancedFeatures';
+// ============================================================================
+// Feature Detection
+// ============================================================================
+/**
+ * Detect available browser features
+ */
+export function detectFeatures() {
+    return {
+        indexedDB: 'indexedDB' in globalThis,
+        broadcastChannel: 'BroadcastChannel' in globalThis,
+        webWorkers: typeof Worker !== 'undefined',
+        wasmSIMD: detectWasmSIMD(),
+        sharedArrayBuffer: typeof SharedArrayBuffer !== 'undefined'
+    };
+}
+/**
+ * Detect WASM SIMD support
+ */
+function detectWasmSIMD() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // WASM SIMD detection via feature test
+            const simdTest = new Uint8Array([
+                0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00,
+                0x01, 0x05, 0x01, 0x60, 0x00, 0x01, 0x7b, 0x03,
+                0x02, 0x01, 0x00, 0x0a, 0x0a, 0x01, 0x08, 0x00,
+                0xfd, 0x0c, 0xfd, 0x0c, 0xfd, 0x54, 0x0b
+            ]);
+            const module = yield WebAssembly.instantiate(simdTest);
+            return module instanceof WebAssembly.Instance;
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+// ============================================================================
+// Configuration Presets
+// ============================================================================
+/**
+ * Recommended configuration for small datasets (<1K vectors)
+ */
+export const SMALL_DATASET_CONFIG = {
+    pq: { enabled: false },
+    hnsw: { enabled: false },
+    gnn: { enabled: true, numHeads: 2 },
+    mmr: { enabled: true, lambda: 0.7 },
+    svd: { enabled: false }
+};
+/**
+ * Recommended configuration for medium datasets (1K-10K vectors)
+ */
+export const MEDIUM_DATASET_CONFIG = {
+    pq: { enabled: true, subvectors: 8 },
+    hnsw: { enabled: true, M: 16 },
+    gnn: { enabled: true, numHeads: 4 },
+    mmr: { enabled: true, lambda: 0.7 },
+    svd: { enabled: false }
+};
+/**
+ * Recommended configuration for large datasets (10K-100K vectors)
+ */
+export const LARGE_DATASET_CONFIG = {
+    pq: { enabled: true, subvectors: 16 },
+    hnsw: { enabled: true, M: 32 },
+    gnn: { enabled: true, numHeads: 4 },
+    mmr: { enabled: true, lambda: 0.7 },
+    svd: { enabled: true, targetDim: 128 }
+};
+/**
+ * Memory-optimized configuration (minimal memory usage)
+ */
+export const MEMORY_OPTIMIZED_CONFIG = {
+    pq: { enabled: true, subvectors: 32 }, // 16x compression
+    hnsw: { enabled: true, M: 8 }, // Fewer connections
+    gnn: { enabled: false },
+    mmr: { enabled: false },
+    svd: { enabled: true, targetDim: 64 } // Aggressive dimension reduction
+};
+/**
+ * Speed-optimized configuration (fastest search)
+ */
+export const SPEED_OPTIMIZED_CONFIG = {
+    pq: { enabled: false }, // No compression overhead
+    hnsw: { enabled: true, M: 32, efSearch: 100 }, // Maximum HNSW quality
+    gnn: { enabled: false },
+    mmr: { enabled: false },
+    svd: { enabled: false }
+};
+/**
+ * Quality-optimized configuration (best result quality)
+ */
+export const QUALITY_OPTIMIZED_CONFIG = {
+    pq: { enabled: false }, // No compression
+    hnsw: { enabled: true, M: 48, efConstruction: 400 }, // Highest quality
+    gnn: { enabled: true, numHeads: 8 }, // More attention heads
+    mmr: { enabled: true, lambda: 0.8 }, // More diversity
+    svd: { enabled: false } // No dimension loss
+};
+// ============================================================================
+// Version Information
+// ============================================================================
+export const VERSION = {
+    major: 2,
+    minor: 0,
+    patch: 0,
+    prerelease: 'alpha.2',
+    features: 'advanced',
+    full: '2.0.0-alpha.2+advanced'
+};
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Estimate memory usage for configuration
+ */
+export function estimateMemoryUsage(numVectors, dimension, config) {
+    var _a, _b, _c;
+    let vectorBytes = numVectors * dimension * 4; // Float32Array
+    // Apply PQ compression
+    if ((_a = config.pq) === null || _a === void 0 ? void 0 : _a.enabled) {
+        const subvectors = config.pq.subvectors || 8;
+        vectorBytes = numVectors * (subvectors + 4); // codes + norm
+    }
+    // Apply SVD compression
+    if ((_b = config.svd) === null || _b === void 0 ? void 0 : _b.enabled) {
+        const targetDim = config.svd.targetDim || dimension / 2;
+        vectorBytes = numVectors * targetDim * 4;
+    }
+    // HNSW index overhead
+    let indexBytes = 0;
+    if ((_c = config.hnsw) === null || _c === void 0 ? void 0 : _c.enabled) {
+        const M = config.hnsw.M || 16;
+        const avgConnections = M * 1.5; // Estimate
+        indexBytes = numVectors * avgConnections * 4; // Connection IDs
+    }
+    const total = vectorBytes + indexBytes;
+    return {
+        vectors: vectorBytes,
+        index: indexBytes,
+        total,
+        totalMB: total / (1024 * 1024)
+    };
+}
+/**
+ * Recommend configuration based on dataset size
+ */
+export function recommendConfig(numVectors, dimension) {
+    if (numVectors < 1000) {
+        return {
+            name: 'SMALL_DATASET',
+            config: SMALL_DATASET_CONFIG,
+            reason: 'Small dataset, linear search is fast enough'
+        };
+    }
+    else if (numVectors < 10000) {
+        return {
+            name: 'MEDIUM_DATASET',
+            config: MEDIUM_DATASET_CONFIG,
+            reason: 'Medium dataset, HNSW + PQ8 recommended'
+        };
+    }
+    else {
+        return {
+            name: 'LARGE_DATASET',
+            config: LARGE_DATASET_CONFIG,
+            reason: 'Large dataset, aggressive compression + HNSW recommended'
+        };
+    }
+}
+/**
+ * Benchmark search performance
+ */
+export function benchmarkSearch(searchFn_1) {
+    return __awaiter(this, arguments, void 0, function* (searchFn, numQueries = 100, k = 10, dimension = 384) {
+        const times = [];
+        for (let i = 0; i < numQueries; i++) {
+            const query = new Float32Array(dimension);
+            for (let d = 0; d < dimension; d++) {
+                query[d] = Math.random() - 0.5;
+            }
+            const start = performance.now();
+            searchFn(query, k);
+            const end = performance.now();
+            times.push(end - start);
+        }
+        times.sort((a, b) => a - b);
+        return {
+            avgTimeMs: times.reduce((a, b) => a + b, 0) / times.length,
+            minTimeMs: times[0],
+            maxTimeMs: times[times.length - 1],
+            p50Ms: times[Math.floor(times.length * 0.5)],
+            p95Ms: times[Math.floor(times.length * 0.95)],
+            p99Ms: times[Math.floor(times.length * 0.99)]
+        };
+    });
+}

package/dist/browser/index.d.ts

@@ -0,0 +1,223 @@
+/**
+ * AgentDB Browser Advanced Features
+ *
+ * Unified export for all browser-compatible advanced features.
+ *
+ * Features:
+ * - Product Quantization (PQ8/PQ16/PQ32) - 4-32x memory compression
+ * - HNSW Indexing - 10-20x faster approximate search
+ * - Graph Neural Networks - Graph attention and message passing
+ * - MMR Diversity - Maximal marginal relevance ranking
+ * - Tensor Compression - SVD dimension reduction
+ * - Batch Operations - Optimized vector processing
+ *
+ * Bundle Size: ~35 KB minified (~12 KB gzipped)
+ */
+export { ProductQuantization, createPQ8, createPQ16, createPQ32, type PQConfig, type PQCodebook, type CompressedVector } from './ProductQuantization';
+export { HNSWIndex, createHNSW, createFastHNSW, createAccurateHNSW, type HNSWConfig, type HNSWNode, type SearchResult } from './HNSWIndex';
+export { GraphNeuralNetwork, MaximalMarginalRelevance, TensorCompression, BatchProcessor, type GNNNode, type GNNEdge, type GNNConfig, type MMRConfig } from './AdvancedFeatures';
+/**
+ * Detect available browser features
+ */
+export declare function detectFeatures(): {
+    indexedDB: boolean;
+    broadcastChannel: boolean;
+    webWorkers: boolean;
+    wasmSIMD: Promise<boolean>;
+    sharedArrayBuffer: boolean;
+};
+/**
+ * Recommended configuration for small datasets (<1K vectors)
+ */
+export declare const SMALL_DATASET_CONFIG: {
+    pq: {
+        enabled: boolean;
+    };
+    hnsw: {
+        enabled: boolean;
+    };
+    gnn: {
+        enabled: boolean;
+        numHeads: number;
+    };
+    mmr: {
+        enabled: boolean;
+        lambda: number;
+    };
+    svd: {
+        enabled: boolean;
+    };
+};
+/**
+ * Recommended configuration for medium datasets (1K-10K vectors)
+ */
+export declare const MEDIUM_DATASET_CONFIG: {
+    pq: {
+        enabled: boolean;
+        subvectors: number;
+    };
+    hnsw: {
+        enabled: boolean;
+        M: number;
+    };
+    gnn: {
+        enabled: boolean;
+        numHeads: number;
+    };
+    mmr: {
+        enabled: boolean;
+        lambda: number;
+    };
+    svd: {
+        enabled: boolean;
+    };
+};
+/**
+ * Recommended configuration for large datasets (10K-100K vectors)
+ */
+export declare const LARGE_DATASET_CONFIG: {
+    pq: {
+        enabled: boolean;
+        subvectors: number;
+    };
+    hnsw: {
+        enabled: boolean;
+        M: number;
+    };
+    gnn: {
+        enabled: boolean;
+        numHeads: number;
+    };
+    mmr: {
+        enabled: boolean;
+        lambda: number;
+    };
+    svd: {
+        enabled: boolean;
+        targetDim: number;
+    };
+};
+/**
+ * Memory-optimized configuration (minimal memory usage)
+ */
+export declare const MEMORY_OPTIMIZED_CONFIG: {
+    pq: {
+        enabled: boolean;
+        subvectors: number;
+    };
+    hnsw: {
+        enabled: boolean;
+        M: number;
+    };
+    gnn: {
+        enabled: boolean;
+    };
+    mmr: {
+        enabled: boolean;
+    };
+    svd: {
+        enabled: boolean;
+        targetDim: number;
+    };
+};
+/**
+ * Speed-optimized configuration (fastest search)
+ */
+export declare const SPEED_OPTIMIZED_CONFIG: {
+    pq: {
+        enabled: boolean;
+    };
+    hnsw: {
+        enabled: boolean;
+        M: number;
+        efSearch: number;
+    };
+    gnn: {
+        enabled: boolean;
+    };
+    mmr: {
+        enabled: boolean;
+    };
+    svd: {
+        enabled: boolean;
+    };
+};
+/**
+ * Quality-optimized configuration (best result quality)
+ */
+export declare const QUALITY_OPTIMIZED_CONFIG: {
+    pq: {
+        enabled: boolean;
+    };
+    hnsw: {
+        enabled: boolean;
+        M: number;
+        efConstruction: number;
+    };
+    gnn: {
+        enabled: boolean;
+        numHeads: number;
+    };
+    mmr: {
+        enabled: boolean;
+        lambda: number;
+    };
+    svd: {
+        enabled: boolean;
+    };
+};
+export declare const VERSION: {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: string;
+    features: string;
+    full: string;
+};
+/**
+ * Estimate memory usage for configuration
+ */
+export declare function estimateMemoryUsage(numVectors: number, dimension: number, config: any): {
+    vectors: number;
+    index: number;
+    total: number;
+    totalMB: number;
+};
+/**
+ * Recommend configuration based on dataset size
+ */
+export declare function recommendConfig(numVectors: number, dimension: number): {
+    name: string;
+    config: {
+        pq: {
+            enabled: boolean;
+        };
+        hnsw: {
+            enabled: boolean;
+        };
+        gnn: {
+            enabled: boolean;
+            numHeads: number;
+        };
+        mmr: {
+            enabled: boolean;
+            lambda: number;
+        };
+        svd: {
+            enabled: boolean;
+        };
+    };
+    reason: string;
+};
+/**
+ * Benchmark search performance
+ */
+export declare function benchmarkSearch(searchFn: (query: Float32Array, k: number) => any[], numQueries?: number, k?: number, dimension?: number): Promise<{
+    avgTimeMs: number;
+    minTimeMs: number;
+    maxTimeMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EACL,SAAS,EACT,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAM5B;;GAEG;AACH,wBAAgB,cAAc;;;;;;EAQ7B;AAgCD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAMhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;CAMjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;CAMnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;CAMlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;CAMpC,CAAC;AAMF,eAAO,MAAM,OAAO;;;;;;;CAOnB,CAAC;AAMF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,GAAG,GACV;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CA+BA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;EAoBpE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,KAAK,GAAG,EAAE,EACnD,UAAU,GAAE,MAAY,EACxB,CAAC,GAAE,MAAW,EACd,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CA0BD"}

package/dist/browser/index.js

@@ -0,0 +1,225 @@
+/**
+ * AgentDB Browser Advanced Features
+ *
+ * Unified export for all browser-compatible advanced features.
+ *
+ * Features:
+ * - Product Quantization (PQ8/PQ16/PQ32) - 4-32x memory compression
+ * - HNSW Indexing - 10-20x faster approximate search
+ * - Graph Neural Networks - Graph attention and message passing
+ * - MMR Diversity - Maximal marginal relevance ranking
+ * - Tensor Compression - SVD dimension reduction
+ * - Batch Operations - Optimized vector processing
+ *
+ * Bundle Size: ~35 KB minified (~12 KB gzipped)
+ */
+// ============================================================================
+// Product Quantization
+// ============================================================================
+export { ProductQuantization, createPQ8, createPQ16, createPQ32 } from './ProductQuantization';
+// ============================================================================
+// HNSW Indexing
+// ============================================================================
+export { HNSWIndex, createHNSW, createFastHNSW, createAccurateHNSW } from './HNSWIndex';
+// ============================================================================
+// Advanced Features
+// ============================================================================
+export { GraphNeuralNetwork, MaximalMarginalRelevance, TensorCompression, BatchProcessor } from './AdvancedFeatures';
+// ============================================================================
+// Feature Detection
+// ============================================================================
+/**
+ * Detect available browser features
+ */
+export function detectFeatures() {
+    return {
+        indexedDB: 'indexedDB' in globalThis,
+        broadcastChannel: 'BroadcastChannel' in globalThis,
+        webWorkers: typeof globalThis.Worker !== 'undefined',
+        wasmSIMD: detectWasmSIMD(),
+        sharedArrayBuffer: typeof SharedArrayBuffer !== 'undefined'
+    };
+}
+/**
+ * Detect WASM SIMD support
+ */
+async function detectWasmSIMD() {
+    try {
+        // Check if WebAssembly is available (browser context)
+        if (typeof globalThis.WebAssembly === 'undefined') {
+            return false;
+        }
+        // WASM SIMD detection via feature test
+        const simdTest = new Uint8Array([
+            0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00,
+            0x01, 0x05, 0x01, 0x60, 0x00, 0x01, 0x7b, 0x03,
+            0x02, 0x01, 0x00, 0x0a, 0x0a, 0x01, 0x08, 0x00,
+            0xfd, 0x0c, 0xfd, 0x0c, 0xfd, 0x54, 0x0b
+        ]);
+        const WA = globalThis.WebAssembly;
+        const module = await WA.instantiate(simdTest);
+        return module instanceof WA.Instance;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Configuration Presets
+// ============================================================================
+/**
+ * Recommended configuration for small datasets (<1K vectors)
+ */
+export const SMALL_DATASET_CONFIG = {
+    pq: { enabled: false },
+    hnsw: { enabled: false },
+    gnn: { enabled: true, numHeads: 2 },
+    mmr: { enabled: true, lambda: 0.7 },
+    svd: { enabled: false }
+};
+/**
+ * Recommended configuration for medium datasets (1K-10K vectors)
+ */
+export const MEDIUM_DATASET_CONFIG = {
+    pq: { enabled: true, subvectors: 8 },
+    hnsw: { enabled: true, M: 16 },
+    gnn: { enabled: true, numHeads: 4 },
+    mmr: { enabled: true, lambda: 0.7 },
+    svd: { enabled: false }
+};
+/**
+ * Recommended configuration for large datasets (10K-100K vectors)
+ */
+export const LARGE_DATASET_CONFIG = {
+    pq: { enabled: true, subvectors: 16 },
+    hnsw: { enabled: true, M: 32 },
+    gnn: { enabled: true, numHeads: 4 },
+    mmr: { enabled: true, lambda: 0.7 },
+    svd: { enabled: true, targetDim: 128 }
+};
+/**
+ * Memory-optimized configuration (minimal memory usage)
+ */
+export const MEMORY_OPTIMIZED_CONFIG = {
+    pq: { enabled: true, subvectors: 32 }, // 16x compression
+    hnsw: { enabled: true, M: 8 }, // Fewer connections
+    gnn: { enabled: false },
+    mmr: { enabled: false },
+    svd: { enabled: true, targetDim: 64 } // Aggressive dimension reduction
+};
+/**
+ * Speed-optimized configuration (fastest search)
+ */
+export const SPEED_OPTIMIZED_CONFIG = {
+    pq: { enabled: false }, // No compression overhead
+    hnsw: { enabled: true, M: 32, efSearch: 100 }, // Maximum HNSW quality
+    gnn: { enabled: false },
+    mmr: { enabled: false },
+    svd: { enabled: false }
+};
+/**
+ * Quality-optimized configuration (best result quality)
+ */
+export const QUALITY_OPTIMIZED_CONFIG = {
+    pq: { enabled: false }, // No compression
+    hnsw: { enabled: true, M: 48, efConstruction: 400 }, // Highest quality
+    gnn: { enabled: true, numHeads: 8 }, // More attention heads
+    mmr: { enabled: true, lambda: 0.8 }, // More diversity
+    svd: { enabled: false } // No dimension loss
+};
+// ============================================================================
+// Version Information
+// ============================================================================
+export const VERSION = {
+    major: 2,
+    minor: 0,
+    patch: 0,
+    prerelease: 'alpha.2',
+    features: 'advanced',
+    full: '2.0.0-alpha.2+advanced'
+};
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Estimate memory usage for configuration
+ */
+export function estimateMemoryUsage(numVectors, dimension, config) {
+    let vectorBytes = numVectors * dimension * 4; // Float32Array
+    // Apply PQ compression
+    if (config.pq?.enabled) {
+        const subvectors = config.pq.subvectors || 8;
+        vectorBytes = numVectors * (subvectors + 4); // codes + norm
+    }
+    // Apply SVD compression
+    if (config.svd?.enabled) {
+        const targetDim = config.svd.targetDim || dimension / 2;
+        vectorBytes = numVectors * targetDim * 4;
+    }
+    // HNSW index overhead
+    let indexBytes = 0;
+    if (config.hnsw?.enabled) {
+        const M = config.hnsw.M || 16;
+        const avgConnections = M * 1.5; // Estimate
+        indexBytes = numVectors * avgConnections * 4; // Connection IDs
+    }
+    const total = vectorBytes + indexBytes;
+    return {
+        vectors: vectorBytes,
+        index: indexBytes,
+        total,
+        totalMB: total / (1024 * 1024)
+    };
+}
+/**
+ * Recommend configuration based on dataset size
+ */
+export function recommendConfig(numVectors, dimension) {
+    if (numVectors < 1000) {
+        return {
+            name: 'SMALL_DATASET',
+            config: SMALL_DATASET_CONFIG,
+            reason: 'Small dataset, linear search is fast enough'
+        };
+    }
+    else if (numVectors < 10000) {
+        return {
+            name: 'MEDIUM_DATASET',
+            config: MEDIUM_DATASET_CONFIG,
+            reason: 'Medium dataset, HNSW + PQ8 recommended'
+        };
+    }
+    else {
+        return {
+            name: 'LARGE_DATASET',
+            config: LARGE_DATASET_CONFIG,
+            reason: 'Large dataset, aggressive compression + HNSW recommended'
+        };
+    }
+}
+/**
+ * Benchmark search performance
+ */
+export async function benchmarkSearch(searchFn, numQueries = 100, k = 10, dimension = 384) {
+    const times = [];
+    for (let i = 0; i < numQueries; i++) {
+        const query = new Float32Array(dimension);
+        for (let d = 0; d < dimension; d++) {
+            query[d] = Math.random() - 0.5;
+        }
+        const start = performance.now();
+        searchFn(query, k);
+        const end = performance.now();
+        times.push(end - start);
+    }
+    times.sort((a, b) => a - b);
+    return {
+        avgTimeMs: times.reduce((a, b) => a + b, 0) / times.length,
+        minTimeMs: times[0],
+        maxTimeMs: times[times.length - 1],
+        p50Ms: times[Math.floor(times.length * 0.5)],
+        p95Ms: times[Math.floor(times.length * 0.95)],
+        p99Ms: times[Math.floor(times.length * 0.99)]
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

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