agentdb 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/src/backends/rvf/SqlJsRvfBackend.js

@@ -0,0 +1,382 @@
+/**
+ * SqlJsRvfBackend - Built-in RVF persistence using sql.js (WASM SQLite)
+ *
+ * Provides zero-dependency vector storage in .rvf files when the native
+ * @ruvector/rvf SDK is not installed. Uses sql.js (always available as a
+ * hard dependency) for SQLite persistence and SIMD-accelerated brute-force
+ * search from src/simd/simd-vector-ops.ts.
+ *
+ * When @ruvector/rvf is installed, the factory auto-selects the native
+ * RvfBackend instead for HNSW-indexed search.
+ *
+ * Design:
+ * - Reports name='rvf' for compatibility with existing backend checks
+ * - Vectors stored as raw Float32Array bytes in BLOB columns
+ * - In-memory cache for brute-force search via SIMD ops
+ * - Pending write queue with flushSync() before search
+ * - save() → db.export() → write Uint8Array to .rvf file
+ * - load() → read file → new SQL.Database(buffer) → rebuild cache
+ */
+import { validatePath, validateId, validateMetadata, validateDimension, MAX_BATCH_SIZE, MAX_PENDING_WRITES, MAX_SEARCH_K, DEFAULT_BATCH_THRESHOLD, } from './validation.js';
+import { cosineSimilaritySIMD, euclideanDistanceSIMD, dotProductSIMD, } from '../../simd/simd-vector-ops.js';
+/**
+ * SqlJsRvfBackend - VectorBackend + VectorBackendAsync using sql.js WASM
+ */
+export class SqlJsRvfBackend {
+    name = 'rvf';
+    // sql.js database handle
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    db = null;
+    dim;
+    metricType;
+    initialized = false;
+    storagePath;
+    // In-memory vector cache for brute-force search
+    cache = new Map();
+    // Sync insert queue
+    pending = [];
+    batchThreshold;
+    constructor(config) {
+        const dimension = config.dimension ?? config.dimensions;
+        if (!dimension) {
+            throw new Error('Vector dimension is required (use dimension or dimensions)');
+        }
+        validateDimension(dimension);
+        this.dim = dimension;
+        this.metricType = config.metric ?? 'cosine';
+        this.storagePath = config.storagePath ?? ':memory:';
+        this.batchThreshold = Math.min(Math.max(1, config.batchThreshold ?? DEFAULT_BATCH_THRESHOLD), MAX_BATCH_SIZE);
+    }
+    /**
+     * Initialize the sql.js database and create schema.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.storagePath !== ':memory:') {
+            validatePath(this.storagePath);
+        }
+        const initSqlJs = (await import('sql.js')).default;
+        const SQL = await initSqlJs();
+        // Try to load existing file
+        let fileBuffer = null;
+        if (this.storagePath !== ':memory:') {
+            try {
+                const fs = await import('fs');
+                if (fs.existsSync(this.storagePath)) {
+                    fileBuffer = new Uint8Array(fs.readFileSync(this.storagePath));
+                }
+            }
+            catch {
+                // File doesn't exist or can't be read — start fresh
+            }
+        }
+        this.db = fileBuffer ? new SQL.Database(fileBuffer) : new SQL.Database();
+        this.createSchema();
+        this.rebuildCache();
+        this.initialized = true;
+    }
+    // ─── Sync VectorBackend interface ───
+    insert(id, embedding, metadata) {
+        this.ensureInitialized();
+        validateId(id);
+        if (embedding.length !== this.dim) {
+            throw new Error(`Vector dimension ${embedding.length} does not match expected ${this.dim}`);
+        }
+        if (this.pending.length >= MAX_PENDING_WRITES) {
+            throw new Error(`Pending write queue full (${MAX_PENDING_WRITES}). Call flush() first.`);
+        }
+        this.pending.push({
+            id,
+            vector: embedding instanceof Float32Array ? embedding : new Float32Array(embedding),
+            metadata: validateMetadata(metadata),
+        });
+        if (this.pending.length >= this.batchThreshold) {
+            this.flush().catch((err) => {
+                console.error('[SqlJsRvfBackend] Auto-flush failed:', err.message);
+            });
+        }
+    }
+    insertBatch(items) {
+        this.ensureInitialized();
+        if (items.length > MAX_BATCH_SIZE) {
+            throw new Error(`Batch size ${items.length} exceeds maximum of ${MAX_BATCH_SIZE}`);
+        }
+        for (const item of items) {
+            this.insert(item.id, item.embedding, item.metadata);
+        }
+    }
+    search(query, k, options) {
+        this.ensureInitialized();
+        // Flush pending writes synchronously by writing directly
+        this.flushSync();
+        return this.bruteForceSearch(query, k, options);
+    }
+    remove(id) {
+        this.ensureInitialized();
+        validateId(id);
+        this.db.run('DELETE FROM rvf_vectors WHERE id = ?', [id]);
+        this.cache.delete(id);
+        return true;
+    }
+    getStats() {
+        return {
+            count: this.cache.size + this.pending.length,
+            dimension: this.dim,
+            metric: this.metricType,
+            backend: 'rvf',
+            memoryUsage: 0,
+        };
+    }
+    async save(savePath) {
+        this.ensureInitialized();
+        await this.flush();
+        const targetPath = savePath || this.storagePath;
+        if (targetPath === ':memory:')
+            return;
+        validatePath(targetPath);
+        const data = this.db.export();
+        const fs = await import('fs');
+        fs.writeFileSync(targetPath, data);
+    }
+    async load(loadPath) {
+        validatePath(loadPath);
+        const fs = await import('fs');
+        const buffer = new Uint8Array(fs.readFileSync(loadPath));
+        const initSqlJs = (await import('sql.js')).default;
+        const SQL = await initSqlJs();
+        if (this.db) {
+            this.db.close();
+        }
+        this.db = new SQL.Database(buffer);
+        this.createSchema(); // ensure schema exists
+        this.rebuildCache();
+        this.storagePath = loadPath;
+        this.initialized = true;
+    }
+    close() {
+        if (this.db) {
+            // Flush pending writes
+            this.flushSync();
+            // Auto-save if we have a file path
+            if (this.storagePath !== ':memory:') {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-var-requires
+                    const fs = require('fs');
+                    const data = this.db.export();
+                    fs.writeFileSync(this.storagePath, data);
+                }
+                catch {
+                    // Best-effort save on close
+                }
+            }
+            this.db.close();
+            this.db = null;
+        }
+        this.pending = [];
+        this.cache.clear();
+        this.initialized = false;
+    }
+    // ─── Async VectorBackendAsync interface ───
+    async insertAsync(id, embedding, metadata) {
+        this.ensureInitialized();
+        validateId(id);
+        if (embedding.length !== this.dim) {
+            throw new Error(`Vector dimension ${embedding.length} does not match expected ${this.dim}`);
+        }
+        const vec = embedding instanceof Float32Array ? embedding : new Float32Array(embedding);
+        const cleanMeta = validateMetadata(metadata);
+        this.writeVector(id, vec, cleanMeta);
+    }
+    async insertBatchAsync(items) {
+        this.ensureInitialized();
+        if (items.length > MAX_BATCH_SIZE) {
+            throw new Error(`Batch size ${items.length} exceeds maximum of ${MAX_BATCH_SIZE}`);
+        }
+        if (items.length === 0)
+            return;
+        this.db.run('BEGIN TRANSACTION');
+        try {
+            for (const item of items) {
+                validateId(item.id);
+                if (item.embedding.length !== this.dim) {
+                    throw new Error(`Vector dimension ${item.embedding.length} does not match expected ${this.dim}`);
+                }
+                const vec = item.embedding instanceof Float32Array ? item.embedding : new Float32Array(item.embedding);
+                const cleanMeta = validateMetadata(item.metadata);
+                this.writeVector(item.id, vec, cleanMeta);
+            }
+            this.db.run('COMMIT');
+        }
+        catch (err) {
+            this.db.run('ROLLBACK');
+            throw err;
+        }
+    }
+    async searchAsync(query, k, options) {
+        this.ensureInitialized();
+        if (this.pending.length > 0) {
+            await this.flush();
+        }
+        return this.bruteForceSearch(query, k, options);
+    }
+    async removeAsync(id) {
+        this.ensureInitialized();
+        if (!id || typeof id !== 'string')
+            return false;
+        validateId(id);
+        this.db.run('DELETE FROM rvf_vectors WHERE id = ?', [id]);
+        const existed = this.cache.has(id);
+        this.cache.delete(id);
+        return existed;
+    }
+    async getStatsAsync() {
+        return this.getStats();
+    }
+    async flush() {
+        if (this.pending.length === 0)
+            return;
+        this.ensureInitialized();
+        this.flushSync();
+    }
+    // ─── Extra public helpers ───
+    /**
+     * Expose the raw sql.js Database instance for unified single-file mode.
+     * AgentDB uses this to load relational schemas into the same database.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getDatabase() {
+        if (!this.initialized || !this.db) {
+            throw new Error('SqlJsRvfBackend not initialized. Call initialize() first.');
+        }
+        return this.db;
+    }
+    getStoragePath() {
+        return this.storagePath;
+    }
+    isInitialized() {
+        return this.initialized;
+    }
+    // ─── Private implementation ───
+    createSchema() {
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS rvf_meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      )
+    `);
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS rvf_vectors (
+        id TEXT PRIMARY KEY,
+        embedding BLOB NOT NULL,
+        metadata TEXT,
+        created_at INTEGER DEFAULT (strftime('%s','now'))
+      )
+    `);
+        // Store dimension and metric for validation on load
+        this.db.run(`INSERT OR REPLACE INTO rvf_meta (key, value) VALUES ('dimension', ?), ('metric', ?)`, [String(this.dim), this.metricType]);
+    }
+    rebuildCache() {
+        this.cache.clear();
+        const rows = this.db.exec('SELECT id, embedding, metadata FROM rvf_vectors');
+        if (rows.length === 0)
+            return;
+        const result = rows[0];
+        for (const row of result.values) {
+            const id = row[0];
+            const blob = row[1];
+            const metaStr = row[2];
+            const embedding = new Float32Array(blob.buffer, blob.byteOffset, blob.byteLength / 4);
+            let metadata;
+            if (metaStr) {
+                try {
+                    metadata = JSON.parse(metaStr);
+                }
+                catch { /* skip bad metadata */ }
+            }
+            this.cache.set(id, { embedding: new Float32Array(embedding), metadata });
+        }
+    }
+    writeVector(id, vec, metadata) {
+        const blob = new Uint8Array(vec.buffer, vec.byteOffset, vec.byteLength);
+        const metaStr = metadata ? JSON.stringify(metadata) : null;
+        this.db.run('INSERT OR REPLACE INTO rvf_vectors (id, embedding, metadata) VALUES (?, ?, ?)', [id, blob, metaStr]);
+        this.cache.set(id, { embedding: new Float32Array(vec), metadata });
+    }
+    flushSync() {
+        if (this.pending.length === 0)
+            return;
+        const batch = this.pending.splice(0, this.pending.length);
+        this.db.run('BEGIN TRANSACTION');
+        try {
+            for (const item of batch) {
+                this.writeVector(item.id, item.vector, item.metadata);
+            }
+            this.db.run('COMMIT');
+        }
+        catch (err) {
+            this.db.run('ROLLBACK');
+            throw err;
+        }
+    }
+    bruteForceSearch(query, k, options) {
+        if (!Number.isFinite(k) || k < 1) {
+            throw new Error('k must be a positive finite integer');
+        }
+        const safeK = Math.min(Math.floor(k), MAX_SEARCH_K);
+        const queryVec = query instanceof Float32Array ? query : new Float32Array(query);
+        if (queryVec.length !== this.dim) {
+            throw new Error(`Query dimension ${queryVec.length} does not match expected ${this.dim}`);
+        }
+        const threshold = options?.threshold ?? 0;
+        const results = [];
+        for (const [id, entry] of this.cache) {
+            // Apply metadata filter if provided
+            if (options?.filter && !this.matchesFilter(entry.metadata, options.filter)) {
+                continue;
+            }
+            const { similarity, distance } = this.computeScore(queryVec, entry.embedding);
+            if (similarity >= threshold) {
+                results.push({ id, distance, similarity, metadata: entry.metadata });
+            }
+        }
+        // Sort by similarity descending
+        results.sort((a, b) => b.similarity - a.similarity);
+        return results.slice(0, safeK);
+    }
+    computeScore(query, candidate) {
+        switch (this.metricType) {
+            case 'cosine': {
+                const similarity = cosineSimilaritySIMD(query, candidate);
+                return { similarity, distance: 1 - similarity };
+            }
+            case 'l2': {
+                const distance = euclideanDistanceSIMD(query, candidate);
+                return { similarity: Math.exp(-distance), distance };
+            }
+            case 'ip': {
+                const dp = dotProductSIMD(query, candidate);
+                return { similarity: dp, distance: -dp };
+            }
+            default: {
+                const sim = cosineSimilaritySIMD(query, candidate);
+                return { similarity: sim, distance: 1 - sim };
+            }
+        }
+    }
+    matchesFilter(metadata, filter) {
+        if (!metadata)
+            return false;
+        for (const [key, value] of Object.entries(filter)) {
+            if (metadata[key] !== value)
+                return false;
+        }
+        return true;
+    }
+    ensureInitialized() {
+        if (!this.initialized || !this.db) {
+            throw new Error('SqlJsRvfBackend not initialized. Call initialize() first.');
+        }
+    }
+}
+//# sourceMappingURL=SqlJsRvfBackend.js.map

package/dist/src/backends/rvf/SqlJsRvfBackend.js.map

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

package/dist/src/backends/rvf/WasmStoreBridge.d.ts

@@ -0,0 +1,27 @@
+/**
+ * WasmStoreBridge - WASM in-memory vector store bridge
+ *
+ * Delegates to @ruvector/rvf-wasm store functions for browser-side
+ * in-memory vector storage. All methods handle the case where
+ * rvf-wasm init() hasn't been called and return safe defaults.
+ */
+export interface WasmStoreQueryResult {
+    id: number;
+    distance: number;
+}
+export declare class WasmStoreBridge {
+    private _storeCreate;
+    private _storeIngest;
+    private _storeQuery;
+    private _storeExport;
+    private _storeClose;
+    private _initialized;
+    get available(): boolean;
+    initialize(): Promise<boolean>;
+    wasmStoreCreate(dim: number, metric: number): number | null;
+    wasmStoreIngest(handle: number, vecs: Float32Array, ids: number[], count: number): number;
+    wasmStoreQuery(handle: number, query: Float32Array, k: number, metric: number): WasmStoreQueryResult[] | null;
+    wasmStoreExport(handle: number): Uint8Array | null;
+    wasmStoreClose(handle: number): boolean;
+}
+//# sourceMappingURL=WasmStoreBridge.d.ts.map

package/dist/src/backends/rvf/WasmStoreBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WasmStoreBridge.d.ts","sourceRoot":"","sources":["../../../../src/backends/rvf/WasmStoreBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAA0D;IAC9E,OAAO,CAAC,YAAY,CAAiG;IACrH,OAAO,CAAC,WAAW,CAA0F;IAC7G,OAAO,CAAC,YAAY,CAAiD;IACrE,OAAO,CAAC,WAAW,CAA8C;IAEjE,OAAO,CAAC,YAAY,CAAS;IAE7B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAcpC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO3D,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IASzF,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,GAAG,IAAI;IAW7G,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAOlD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAMxC"}

package/dist/src/backends/rvf/WasmStoreBridge.js

@@ -0,0 +1,87 @@
+/**
+ * WasmStoreBridge - WASM in-memory vector store bridge
+ *
+ * Delegates to @ruvector/rvf-wasm store functions for browser-side
+ * in-memory vector storage. All methods handle the case where
+ * rvf-wasm init() hasn't been called and return safe defaults.
+ */
+export class WasmStoreBridge {
+    _storeCreate = null;
+    _storeIngest = null;
+    _storeQuery = null;
+    _storeExport = null;
+    _storeClose = null;
+    _initialized = false;
+    get available() {
+        return this._storeCreate !== null;
+    }
+    async initialize() {
+        if (this._initialized)
+            return this.available;
+        try {
+            const wasm = await import('@ruvector/rvf-wasm');
+            if (wasm.rvf_store_create)
+                this._storeCreate = wasm.rvf_store_create;
+            if (wasm.rvf_store_ingest)
+                this._storeIngest = wasm.rvf_store_ingest;
+            if (wasm.rvf_store_query)
+                this._storeQuery = wasm.rvf_store_query;
+            if (wasm.rvf_store_export)
+                this._storeExport = wasm.rvf_store_export;
+            if (wasm.rvf_store_close)
+                this._storeClose = wasm.rvf_store_close;
+        }
+        catch { /* not available */ }
+        this._initialized = true;
+        return this.available;
+    }
+    wasmStoreCreate(dim, metric) {
+        if (this._storeCreate) {
+            try {
+                return this._storeCreate(dim, metric);
+            }
+            catch { /* fallback */ }
+        }
+        return null;
+    }
+    wasmStoreIngest(handle, vecs, ids, count) {
+        if (this._storeIngest) {
+            try {
+                return this._storeIngest(handle, vecs, new Int32Array(ids), count);
+            }
+            catch { /* fallback */ }
+        }
+        return 0;
+    }
+    wasmStoreQuery(handle, query, k, metric) {
+        if (this._storeQuery) {
+            try {
+                const raw = this._storeQuery(handle, query, k, metric);
+                if (Array.isArray(raw))
+                    return raw;
+                return null;
+            }
+            catch { /* fallback */ }
+        }
+        return null;
+    }
+    wasmStoreExport(handle) {
+        if (this._storeExport) {
+            try {
+                return this._storeExport(handle);
+            }
+            catch { /* fallback */ }
+        }
+        return null;
+    }
+    wasmStoreClose(handle) {
+        if (this._storeClose) {
+            try {
+                return this._storeClose(handle);
+            }
+            catch { /* fallback */ }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=WasmStoreBridge.js.map

package/dist/src/backends/rvf/WasmStoreBridge.js.map

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

package/dist/src/backends/rvf/validation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared validation utilities for RVF backends (native + sql.js fallback)
+ *
+ * Extracted from RvfBackend.ts to avoid duplication between
+ * RvfBackend (native @ruvector/rvf) and SqlJsRvfBackend (built-in sql.js).
+ */
+export declare const MAX_VECTOR_DIMENSION = 4096;
+export declare const MAX_BATCH_SIZE = 10000;
+export declare const MAX_PATH_LENGTH = 4096;
+export declare const DEFAULT_BATCH_THRESHOLD = 100;
+export declare const MAX_PENDING_WRITES = 50000;
+export declare const MAX_METADATA_BYTES = 65536;
+export declare const MAX_ID_LENGTH = 1024;
+export declare const MAX_SEARCH_K = 10000;
+export declare const FORBIDDEN_PATH_PATTERNS: RegExp[];
+export declare function validatePath(inputPath: string): void;
+export declare function validateId(id: string): void;
+export declare function validateMetadata(metadata: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+export declare function validateDimension(dimension: number): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/backends/rvf/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/backends/rvf/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,cAAc,QAAQ,CAAC;AACpC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,uBAAuB,UAMnC,CAAC;AAEF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmBpD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAU3C;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAiBnH;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIzD"}

package/dist/src/backends/rvf/validation.js

@@ -0,0 +1,78 @@
+/**
+ * Shared validation utilities for RVF backends (native + sql.js fallback)
+ *
+ * Extracted from RvfBackend.ts to avoid duplication between
+ * RvfBackend (native @ruvector/rvf) and SqlJsRvfBackend (built-in sql.js).
+ */
+// Security constants (aligned with RuVectorBackend)
+export const MAX_VECTOR_DIMENSION = 4096;
+export const MAX_BATCH_SIZE = 10000;
+export const MAX_PATH_LENGTH = 4096;
+export const DEFAULT_BATCH_THRESHOLD = 100;
+export const MAX_PENDING_WRITES = 50000;
+export const MAX_METADATA_BYTES = 65536;
+export const MAX_ID_LENGTH = 1024;
+export const MAX_SEARCH_K = 10000;
+export const FORBIDDEN_PATH_PATTERNS = [
+    /\.\./, // Path traversal
+    /^\/etc\//i, // System config
+    /^\/proc\//i, // Process info
+    /^\/sys\//i, // System info
+    /^\/dev\//i, // Devices
+];
+export function validatePath(inputPath) {
+    if (!inputPath || typeof inputPath !== 'string') {
+        throw new Error('Path must be a non-empty string');
+    }
+    if (inputPath.length > MAX_PATH_LENGTH) {
+        throw new Error(`Path exceeds maximum length of ${MAX_PATH_LENGTH}`);
+    }
+    if (inputPath.includes('\0')) {
+        throw new Error('Path must not contain null bytes');
+    }
+    // Check both forward-slash and backslash traversal
+    if (/\.\.[\\/]/.test(inputPath)) {
+        throw new Error('Path contains forbidden traversal pattern');
+    }
+    for (const pattern of FORBIDDEN_PATH_PATTERNS) {
+        if (pattern.test(inputPath)) {
+            throw new Error('Path contains forbidden pattern');
+        }
+    }
+}
+export function validateId(id) {
+    if (!id || typeof id !== 'string') {
+        throw new Error('Vector ID must be a non-empty string');
+    }
+    if (id.length > MAX_ID_LENGTH) {
+        throw new Error(`Vector ID exceeds maximum length of ${MAX_ID_LENGTH}`);
+    }
+    if (id.includes('\0')) {
+        throw new Error('Vector ID must not contain null bytes');
+    }
+}
+export function validateMetadata(metadata) {
+    if (!metadata)
+        return metadata;
+    const json = JSON.stringify(metadata);
+    if (json.length > MAX_METADATA_BYTES) {
+        throw new Error(`Metadata exceeds maximum size of ${MAX_METADATA_BYTES} bytes`);
+    }
+    // Strip prototype-pollution keys
+    if ('__proto__' in metadata || 'constructor' in metadata || 'prototype' in metadata) {
+        const clean = Object.create(null);
+        for (const key of Object.keys(metadata)) {
+            if (key !== '__proto__' && key !== 'constructor' && key !== 'prototype') {
+                clean[key] = metadata[key];
+            }
+        }
+        return clean;
+    }
+    return metadata;
+}
+export function validateDimension(dimension) {
+    if (!Number.isFinite(dimension) || dimension < 1 || dimension > MAX_VECTOR_DIMENSION) {
+        throw new Error(`Dimension must be between 1 and ${MAX_VECTOR_DIMENSION}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/backends/rvf/validation.js.map

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