@wiscale/velesdb-sdk 1.0.0 → 1.1.1

package/README.md

@@ -188,6 +188,41 @@ const results = await db.query(
 );
 ```
 
+### `db.multiQuerySearch(collection, vectors, options)` (v1.1.0+) ⭐ NEW
+
+Multi-query fusion search for RAG pipelines using Multiple Query Generation (MQG).
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `k` | `number` | `10` | Number of results |
+| `fusion` | `'rrf' \| 'average' \| 'maximum' \| 'weighted'` | `'rrf'` | Fusion strategy |
+| `fusionParams` | `object` | `{ k: 60 }` | Strategy-specific parameters |
+| `filter` | `object` | - | Filter expression |
+
+```typescript
+// RRF fusion (default) - best for most RAG use cases
+const results = await db.multiQuerySearch('docs', [emb1, emb2, emb3], {
+  k: 10,
+  fusion: 'rrf',
+  fusionParams: { k: 60 }
+});
+
+// Weighted fusion - like SearchXP scoring
+const results = await db.multiQuerySearch('docs', [emb1, emb2], {
+  k: 10,
+  fusion: 'weighted',
+  fusionParams: { avgWeight: 0.6, maxWeight: 0.3, hitWeight: 0.1 }
+});
+
+// Average/Maximum fusion
+const results = await db.multiQuerySearch('docs', vectors, {
+  k: 10,
+  fusion: 'average'  // or 'maximum'
+});
+```
+
+> **Note:** Multi-query fusion is only available with the REST backend.
+
 ### `db.isEmpty(collection)` (v0.8.11+)
 
 Check if a collection is empty.

package/dist/index.d.mts

@@ -19,10 +19,12 @@ interface VelesDBConfig {
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
 }
+/** Collection type */
+type CollectionType = 'vector' | 'metadata_only';
 /** Collection configuration */
 interface CollectionConfig {
-    /** Vector dimension (e.g., 768 for BERT, 1536 for GPT) */
-    dimension: number;
+    /** Vector dimension (e.g., 768 for BERT, 1536 for GPT). Required for vector collections. */
+    dimension?: number;
     /** Distance metric (default: 'cosine') */
     metric?: DistanceMetric;
     /** Storage mode for vector quantization (default: 'full')
@@ -31,6 +33,8 @@ interface CollectionConfig {
      * - 'binary': 1-bit binary quantization, 32x memory reduction (edge/IoT)
      */
     storageMode?: StorageMode;
+    /** Collection type: 'vector' (default) or 'metadata_only' */
+    collectionType?: CollectionType;
     /** Optional collection description */
     description?: string;
 }
@@ -67,6 +71,28 @@ interface SearchOptions {
     /** Include vectors in results (default: false) */
     includeVectors?: boolean;
 }
+/** Fusion strategy for multi-query search */
+type FusionStrategy = 'rrf' | 'average' | 'maximum' | 'weighted';
+/** Multi-query search options */
+interface MultiQuerySearchOptions {
+    /** Number of results to return (default: 10) */
+    k?: number;
+    /** Fusion strategy (default: 'rrf') */
+    fusion?: FusionStrategy;
+    /** Fusion parameters */
+    fusionParams?: {
+        /** RRF k parameter (default: 60) */
+        k?: number;
+        /** Weighted fusion: average weight (default: 0.6) */
+        avgWeight?: number;
+        /** Weighted fusion: max weight (default: 0.3) */
+        maxWeight?: number;
+        /** Weighted fusion: hit weight (default: 0.1) */
+        hitWeight?: number;
+    };
+    /** Filter expression (optional) */
+    filter?: Record<string, unknown>;
+}
 /** Search result */
 interface SearchResult {
     /** Document ID */
@@ -121,6 +147,8 @@ interface IVelesDBBackend {
     }): Promise<SearchResult[]>;
     /** Execute VelesQL query */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /** Multi-query fusion search */
+    multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     /** Check if collection is empty */
     isEmpty(collection: string): Promise<boolean>;
     /** Flush pending changes to disk */
@@ -195,6 +223,20 @@ declare class VelesDB {
      * @param config - Collection configuration
      */
     createCollection(name: string, config: CollectionConfig): Promise<void>;
+    /**
+     * Create a metadata-only collection (no vectors, just payload data)
+     *
+     * Useful for storing reference data that can be JOINed with vector collections.
+     *
+     * @param name - Collection name
+     *
+     * @example
+     * ```typescript
+     * await db.createMetadataCollection('products');
+     * await db.insertMetadata('products', { id: 'P001', name: 'Widget', price: 99 });
+     * ```
+     */
+    createMetadataCollection(name: string): Promise<void>;
     /**
      * Delete a collection
      *
@@ -300,6 +342,34 @@ declare class VelesDB {
      * @returns Query results
      */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /**
+     * Multi-query fusion search combining results from multiple query vectors
+     *
+     * Ideal for RAG pipelines using Multiple Query Generation (MQG).
+     *
+     * @param collection - Collection name
+     * @param vectors - Array of query vectors
+     * @param options - Search options (k, fusion strategy, fusionParams, filter)
+     * @returns Fused search results
+     *
+     * @example
+     * ```typescript
+     * // RRF fusion (default)
+     * const results = await db.multiQuerySearch('docs', [emb1, emb2, emb3], {
+     *   k: 10,
+     *   fusion: 'rrf',
+     *   fusionParams: { k: 60 }
+     * });
+     *
+     * // Weighted fusion
+     * const results = await db.multiQuerySearch('docs', [emb1, emb2], {
+     *   k: 10,
+     *   fusion: 'weighted',
+     *   fusionParams: { avgWeight: 0.6, maxWeight: 0.3, hitWeight: 0.1 }
+     * });
+     * ```
+     */
+    multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     /**
      * Check if a collection is empty
      *
@@ -366,6 +436,7 @@ declare class WasmBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(_queryString: string, _params?: Record<string, unknown>): Promise<SearchResult[]>;
+    multiQuerySearch(_collection: string, _vectors: Array<number[] | Float32Array>, _options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     isEmpty(collectionName: string): Promise<boolean>;
     flush(collectionName: string): Promise<void>;
     close(): Promise<void>;
@@ -417,9 +488,10 @@ declare class RestBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     isEmpty(collection: string): Promise<boolean>;
     flush(collection: string): Promise<void>;
     close(): Promise<void>;
 }
 
-export { type BackendType, type Collection, type CollectionConfig, ConnectionError, type DistanceMetric, type IVelesDBBackend, NotFoundError, RestBackend, type SearchOptions, type SearchResult, type StorageMode, ValidationError, type VectorDocument, VelesDB, type VelesDBConfig, VelesDBError, WasmBackend };
+export { type BackendType, type Collection, type CollectionConfig, type CollectionType, ConnectionError, type DistanceMetric, type FusionStrategy, type IVelesDBBackend, type MultiQuerySearchOptions, NotFoundError, RestBackend, type SearchOptions, type SearchResult, type StorageMode, ValidationError, type VectorDocument, VelesDB, type VelesDBConfig, VelesDBError, WasmBackend };

package/dist/index.d.ts

@@ -19,10 +19,12 @@ interface VelesDBConfig {
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
 }
+/** Collection type */
+type CollectionType = 'vector' | 'metadata_only';
 /** Collection configuration */
 interface CollectionConfig {
-    /** Vector dimension (e.g., 768 for BERT, 1536 for GPT) */
-    dimension: number;
+    /** Vector dimension (e.g., 768 for BERT, 1536 for GPT). Required for vector collections. */
+    dimension?: number;
     /** Distance metric (default: 'cosine') */
     metric?: DistanceMetric;
     /** Storage mode for vector quantization (default: 'full')
@@ -31,6 +33,8 @@ interface CollectionConfig {
      * - 'binary': 1-bit binary quantization, 32x memory reduction (edge/IoT)
      */
     storageMode?: StorageMode;
+    /** Collection type: 'vector' (default) or 'metadata_only' */
+    collectionType?: CollectionType;
     /** Optional collection description */
     description?: string;
 }
@@ -67,6 +71,28 @@ interface SearchOptions {
     /** Include vectors in results (default: false) */
     includeVectors?: boolean;
 }
+/** Fusion strategy for multi-query search */
+type FusionStrategy = 'rrf' | 'average' | 'maximum' | 'weighted';
+/** Multi-query search options */
+interface MultiQuerySearchOptions {
+    /** Number of results to return (default: 10) */
+    k?: number;
+    /** Fusion strategy (default: 'rrf') */
+    fusion?: FusionStrategy;
+    /** Fusion parameters */
+    fusionParams?: {
+        /** RRF k parameter (default: 60) */
+        k?: number;
+        /** Weighted fusion: average weight (default: 0.6) */
+        avgWeight?: number;
+        /** Weighted fusion: max weight (default: 0.3) */
+        maxWeight?: number;
+        /** Weighted fusion: hit weight (default: 0.1) */
+        hitWeight?: number;
+    };
+    /** Filter expression (optional) */
+    filter?: Record<string, unknown>;
+}
 /** Search result */
 interface SearchResult {
     /** Document ID */
@@ -121,6 +147,8 @@ interface IVelesDBBackend {
     }): Promise<SearchResult[]>;
     /** Execute VelesQL query */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /** Multi-query fusion search */
+    multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     /** Check if collection is empty */
     isEmpty(collection: string): Promise<boolean>;
     /** Flush pending changes to disk */
@@ -195,6 +223,20 @@ declare class VelesDB {
      * @param config - Collection configuration
      */
     createCollection(name: string, config: CollectionConfig): Promise<void>;
+    /**
+     * Create a metadata-only collection (no vectors, just payload data)
+     *
+     * Useful for storing reference data that can be JOINed with vector collections.
+     *
+     * @param name - Collection name
+     *
+     * @example
+     * ```typescript
+     * await db.createMetadataCollection('products');
+     * await db.insertMetadata('products', { id: 'P001', name: 'Widget', price: 99 });
+     * ```
+     */
+    createMetadataCollection(name: string): Promise<void>;
     /**
      * Delete a collection
      *
@@ -300,6 +342,34 @@ declare class VelesDB {
      * @returns Query results
      */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /**
+     * Multi-query fusion search combining results from multiple query vectors
+     *
+     * Ideal for RAG pipelines using Multiple Query Generation (MQG).
+     *
+     * @param collection - Collection name
+     * @param vectors - Array of query vectors
+     * @param options - Search options (k, fusion strategy, fusionParams, filter)
+     * @returns Fused search results
+     *
+     * @example
+     * ```typescript
+     * // RRF fusion (default)
+     * const results = await db.multiQuerySearch('docs', [emb1, emb2, emb3], {
+     *   k: 10,
+     *   fusion: 'rrf',
+     *   fusionParams: { k: 60 }
+     * });
+     *
+     * // Weighted fusion
+     * const results = await db.multiQuerySearch('docs', [emb1, emb2], {
+     *   k: 10,
+     *   fusion: 'weighted',
+     *   fusionParams: { avgWeight: 0.6, maxWeight: 0.3, hitWeight: 0.1 }
+     * });
+     * ```
+     */
+    multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     /**
      * Check if a collection is empty
      *
@@ -366,6 +436,7 @@ declare class WasmBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(_queryString: string, _params?: Record<string, unknown>): Promise<SearchResult[]>;
+    multiQuerySearch(_collection: string, _vectors: Array<number[] | Float32Array>, _options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     isEmpty(collectionName: string): Promise<boolean>;
     flush(collectionName: string): Promise<void>;
     close(): Promise<void>;
@@ -417,9 +488,10 @@ declare class RestBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
     isEmpty(collection: string): Promise<boolean>;
     flush(collection: string): Promise<void>;
     close(): Promise<void>;
 }
 
-export { type BackendType, type Collection, type CollectionConfig, ConnectionError, type DistanceMetric, type IVelesDBBackend, NotFoundError, RestBackend, type SearchOptions, type SearchResult, type StorageMode, ValidationError, type VectorDocument, VelesDB, type VelesDBConfig, VelesDBError, WasmBackend };
+export { type BackendType, type Collection, type CollectionConfig, type CollectionType, ConnectionError, type DistanceMetric, type FusionStrategy, type IVelesDBBackend, type MultiQuerySearchOptions, NotFoundError, RestBackend, type SearchOptions, type SearchResult, type StorageMode, ValidationError, type VectorDocument, VelesDB, type VelesDBConfig, VelesDBError, WasmBackend };

package/dist/index.js

@@ -129,7 +129,7 @@ var WasmBackend = class {
     }
     return {
       name,
-      dimension: collection.config.dimension,
+      dimension: collection.config.dimension ?? 0,
       metric: collection.config.metric ?? "cosine",
       count: collection.store.len,
       createdAt: collection.createdAt
@@ -141,7 +141,7 @@ var WasmBackend = class {
     for (const [name, data] of this.collections) {
       result.push({
         name,
-        dimension: data.config.dimension,
+        dimension: data.config.dimension ?? 0,
         metric: data.config.metric ?? "cosine",
         count: data.store.len,
         createdAt: data.createdAt
@@ -287,6 +287,12 @@ var WasmBackend = class {
       "NOT_SUPPORTED"
     );
   }
+  async multiQuerySearch(_collection, _vectors, _options) {
+    throw new VelesDBError(
+      "Multi-query fusion is not supported in WASM backend. Use REST backend for MQF search.",
+      "NOT_SUPPORTED"
+    );
+  }
   async isEmpty(collectionName) {
     this.ensureInitialized();
     const collection = this.collections.get(collectionName);
@@ -405,6 +411,8 @@ var RestBackend = class {
       name,
       dimension: config.dimension,
       metric: config.metric ?? "cosine",
+      storage_mode: config.storageMode ?? "full",
+      collection_type: config.collectionType ?? "vector",
       description: config.description
     });
     if (response.error) {
@@ -606,6 +614,30 @@ var RestBackend = class {
     }
     return response.data?.results ?? [];
   }
+  async multiQuerySearch(collection, vectors, options) {
+    this.ensureInitialized();
+    const formattedVectors = vectors.map(
+      (v) => v instanceof Float32Array ? Array.from(v) : v
+    );
+    const response = await this.request(
+      "POST",
+      `/collections/${encodeURIComponent(collection)}/search/multi`,
+      {
+        vectors: formattedVectors,
+        top_k: options?.k ?? 10,
+        fusion: options?.fusion ?? "rrf",
+        fusion_params: options?.fusionParams ?? { k: 60 },
+        filter: options?.filter
+      }
+    );
+    if (response.error) {
+      if (response.error.code === "NOT_FOUND") {
+        throw new NotFoundError(`Collection '${collection}'`);
+      }
+      throw new VelesDBError(response.error.message, response.error.code);
+    }
+    return response.data?.results ?? [];
+  }
   async isEmpty(collection) {
     this.ensureInitialized();
     const response = await this.request(
@@ -706,11 +738,32 @@ var VelesDB = class {
     if (!name || typeof name !== "string") {
       throw new ValidationError("Collection name must be a non-empty string");
     }
-    if (!config.dimension || config.dimension <= 0) {
-      throw new ValidationError("Dimension must be a positive integer");
+    const isMetadataOnly = config.collectionType === "metadata_only";
+    if (!isMetadataOnly && (!config.dimension || config.dimension <= 0)) {
+      throw new ValidationError("Dimension must be a positive integer for vector collections");
     }
     await this.backend.createCollection(name, config);
   }
+  /**
+   * Create a metadata-only collection (no vectors, just payload data)
+   * 
+   * Useful for storing reference data that can be JOINed with vector collections.
+   * 
+   * @param name - Collection name
+   * 
+   * @example
+   * ```typescript
+   * await db.createMetadataCollection('products');
+   * await db.insertMetadata('products', { id: 'P001', name: 'Widget', price: 99 });
+   * ```
+   */
+  async createMetadataCollection(name) {
+    this.ensureInitialized();
+    if (!name || typeof name !== "string") {
+      throw new ValidationError("Collection name must be a non-empty string");
+    }
+    await this.backend.createCollection(name, { collectionType: "metadata_only" });
+  }
   /**
    * Delete a collection
    * 
@@ -881,6 +934,45 @@ var VelesDB = class {
     }
     return this.backend.query(queryString, params);
   }
+  /**
+   * Multi-query fusion search combining results from multiple query vectors
+   * 
+   * Ideal for RAG pipelines using Multiple Query Generation (MQG).
+   * 
+   * @param collection - Collection name
+   * @param vectors - Array of query vectors
+   * @param options - Search options (k, fusion strategy, fusionParams, filter)
+   * @returns Fused search results
+   * 
+   * @example
+   * ```typescript
+   * // RRF fusion (default)
+   * const results = await db.multiQuerySearch('docs', [emb1, emb2, emb3], {
+   *   k: 10,
+   *   fusion: 'rrf',
+   *   fusionParams: { k: 60 }
+   * });
+   * 
+   * // Weighted fusion
+   * const results = await db.multiQuerySearch('docs', [emb1, emb2], {
+   *   k: 10,
+   *   fusion: 'weighted',
+   *   fusionParams: { avgWeight: 0.6, maxWeight: 0.3, hitWeight: 0.1 }
+   * });
+   * ```
+   */
+  async multiQuerySearch(collection, vectors, options) {
+    this.ensureInitialized();
+    if (!Array.isArray(vectors) || vectors.length === 0) {
+      throw new ValidationError("Vectors must be a non-empty array");
+    }
+    for (const v of vectors) {
+      if (!Array.isArray(v) && !(v instanceof Float32Array)) {
+        throw new ValidationError("Each vector must be an array or Float32Array");
+      }
+    }
+    return this.backend.multiQuerySearch(collection, vectors, options);
+  }
   /**
    * Check if a collection is empty
    * 

package/dist/index.mjs

@@ -87,7 +87,7 @@ var WasmBackend = class {
     }
     return {
       name,
-      dimension: collection.config.dimension,
+      dimension: collection.config.dimension ?? 0,
       metric: collection.config.metric ?? "cosine",
       count: collection.store.len,
       createdAt: collection.createdAt
@@ -99,7 +99,7 @@ var WasmBackend = class {
     for (const [name, data] of this.collections) {
       result.push({
         name,
-        dimension: data.config.dimension,
+        dimension: data.config.dimension ?? 0,
         metric: data.config.metric ?? "cosine",
         count: data.store.len,
         createdAt: data.createdAt
@@ -245,6 +245,12 @@ var WasmBackend = class {
       "NOT_SUPPORTED"
     );
   }
+  async multiQuerySearch(_collection, _vectors, _options) {
+    throw new VelesDBError(
+      "Multi-query fusion is not supported in WASM backend. Use REST backend for MQF search.",
+      "NOT_SUPPORTED"
+    );
+  }
   async isEmpty(collectionName) {
     this.ensureInitialized();
     const collection = this.collections.get(collectionName);
@@ -363,6 +369,8 @@ var RestBackend = class {
       name,
       dimension: config.dimension,
       metric: config.metric ?? "cosine",
+      storage_mode: config.storageMode ?? "full",
+      collection_type: config.collectionType ?? "vector",
       description: config.description
     });
     if (response.error) {
@@ -564,6 +572,30 @@ var RestBackend = class {
     }
     return response.data?.results ?? [];
   }
+  async multiQuerySearch(collection, vectors, options) {
+    this.ensureInitialized();
+    const formattedVectors = vectors.map(
+      (v) => v instanceof Float32Array ? Array.from(v) : v
+    );
+    const response = await this.request(
+      "POST",
+      `/collections/${encodeURIComponent(collection)}/search/multi`,
+      {
+        vectors: formattedVectors,
+        top_k: options?.k ?? 10,
+        fusion: options?.fusion ?? "rrf",
+        fusion_params: options?.fusionParams ?? { k: 60 },
+        filter: options?.filter
+      }
+    );
+    if (response.error) {
+      if (response.error.code === "NOT_FOUND") {
+        throw new NotFoundError(`Collection '${collection}'`);
+      }
+      throw new VelesDBError(response.error.message, response.error.code);
+    }
+    return response.data?.results ?? [];
+  }
   async isEmpty(collection) {
     this.ensureInitialized();
     const response = await this.request(
@@ -664,11 +696,32 @@ var VelesDB = class {
     if (!name || typeof name !== "string") {
       throw new ValidationError("Collection name must be a non-empty string");
     }
-    if (!config.dimension || config.dimension <= 0) {
-      throw new ValidationError("Dimension must be a positive integer");
+    const isMetadataOnly = config.collectionType === "metadata_only";
+    if (!isMetadataOnly && (!config.dimension || config.dimension <= 0)) {
+      throw new ValidationError("Dimension must be a positive integer for vector collections");
     }
     await this.backend.createCollection(name, config);
   }
+  /**
+   * Create a metadata-only collection (no vectors, just payload data)
+   * 
+   * Useful for storing reference data that can be JOINed with vector collections.
+   * 
+   * @param name - Collection name
+   * 
+   * @example
+   * ```typescript
+   * await db.createMetadataCollection('products');
+   * await db.insertMetadata('products', { id: 'P001', name: 'Widget', price: 99 });
+   * ```
+   */
+  async createMetadataCollection(name) {
+    this.ensureInitialized();
+    if (!name || typeof name !== "string") {
+      throw new ValidationError("Collection name must be a non-empty string");
+    }
+    await this.backend.createCollection(name, { collectionType: "metadata_only" });
+  }
   /**
    * Delete a collection
    * 
@@ -839,6 +892,45 @@ var VelesDB = class {
     }
     return this.backend.query(queryString, params);
   }
+  /**
+   * Multi-query fusion search combining results from multiple query vectors
+   * 
+   * Ideal for RAG pipelines using Multiple Query Generation (MQG).
+   * 
+   * @param collection - Collection name
+   * @param vectors - Array of query vectors
+   * @param options - Search options (k, fusion strategy, fusionParams, filter)
+   * @returns Fused search results
+   * 
+   * @example
+   * ```typescript
+   * // RRF fusion (default)
+   * const results = await db.multiQuerySearch('docs', [emb1, emb2, emb3], {
+   *   k: 10,
+   *   fusion: 'rrf',
+   *   fusionParams: { k: 60 }
+   * });
+   * 
+   * // Weighted fusion
+   * const results = await db.multiQuerySearch('docs', [emb1, emb2], {
+   *   k: 10,
+   *   fusion: 'weighted',
+   *   fusionParams: { avgWeight: 0.6, maxWeight: 0.3, hitWeight: 0.1 }
+   * });
+   * ```
+   */
+  async multiQuerySearch(collection, vectors, options) {
+    this.ensureInitialized();
+    if (!Array.isArray(vectors) || vectors.length === 0) {
+      throw new ValidationError("Vectors must be a non-empty array");
+    }
+    for (const v of vectors) {
+      if (!Array.isArray(v) && !(v instanceof Float32Array)) {
+        throw new ValidationError("Each vector must be an array or Float32Array");
+      }
+    }
+    return this.backend.multiQuerySearch(collection, vectors, options);
+  }
   /**
    * Check if a collection is empty
    * 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wiscale/velesdb-sdk",
-  "version": "1.0.0",
-  "description": "Official TypeScript SDK for VelesDB - Vector Search in Microseconds",
+  "version": "1.1.1",
+  "description": "VelesDB TypeScript SDK: The Local Vector Database for AI & RAG. Microsecond semantic search in Browser & Node.js.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -30,14 +30,17 @@
   },
   "keywords": [
     "velesdb",
-    "vector",
-    "database",
-    "similarity-search",
+    "vector-database",
     "embeddings",
-    "ai",
-    "machine-learning",
+    "rag",
+    "local-first",
+    "ai-memory",
+    "semantic-search",
+    "sqlite-alternative",
     "wasm",
-    "typescript"
+    "typescript",
+    "langchain",
+    "llm"
   ],
   "author": "Wiscale France",
   "license": "MIT",
@@ -63,7 +66,7 @@
     "vitest": "^4.0.16"
   },
   "dependencies": {
-    "@wiscale/velesdb-wasm": "^1.0.0"
+    "@wiscale/velesdb-wasm": "^1.1.0"
   },
   "engines": {
     "node": ">=18.0.0"