@omendb/omendb 0.0.28 → 0.0.29

package/index.d.ts

@@ -24,6 +24,9 @@ export declare class VectorDatabase {
    *
    * @param items - Array of {id, vector, metadata?, text?} or {id, vectors, metadata?}
    * @returns Number of vectors inserted/updated
+   *
+   * @note Batch inserts (multiple items) skip the WAL for performance. Data is not
+   * durable until flush() is called.
    */
   set(items: Array<SetItem>): Promise<number>
   /** Get a vector by ID. */
@@ -124,6 +127,8 @@ export declare class VectorDatabase {
   isEmpty(): boolean
   /** Get database statistics. */
   stats(): StatsResult
+  /** Get comprehensive database diagnostics. */
+  info(): InfoResult
   /** Get current ef_search value. */
   get efSearch(): number
   /** Set ef_search value. */
@@ -253,9 +258,11 @@ export declare class VectorDatabase {
   /**
    * Search for k nearest neighbors.
    *
-   * @param query - Query vector (number[] or Float32Array)
+   * @param query - Query vector(s): number[] or Float32Array for single-vector stores;
+   *                number[][] or Float32Array[] for multi-vector stores
    * @param k - Number of results to return
-   * @param options - Optional search options: {filter?, ef?, maxDistance?}
+   * @param options - Optional search options. Single-vector: {filter?, ef?, maxDistance?}.
+   *                  Multi-vector: {rerank?, rerankFactor?}
    * @returns Array of {id, distance, score, metadata}
    *
    * @example
@@ -266,9 +273,12 @@ export declare class VectorDatabase {
    * // With options
    * db.search([1, 0, 0, 0], 10, { filter: { category: "A" }, ef: 200 });
    * db.search([1, 0, 0, 0], 10, { maxDistance: 0.5 });
+   *
+   * // Multi-vector search
+   * db.search([[0.1, 0.2], [0.3, 0.4]], 5, { rerank: true, rerankFactor: 8 });
    * ```
    */
-  search(query: Array<number> | Float32Array | string, k: number, options?: { filter?: Record<string, unknown>; ef?: number; maxDistance?: number } | undefined): Promise<Array<SearchResult>>
+  search(query: Array<number> | Float32Array | string | Array<Array<number>> | Array<Float32Array>, k: number, options?: { filter?: Record<string, unknown>; ef?: number; maxDistance?: number; rerank?: boolean; rerankFactor?: number } | undefined): Promise<Array<SearchResult>>
   /**
    * Search multi-vector store with query tokens.
    *
@@ -373,6 +383,25 @@ export interface HybridSearchResult {
   semanticScore?: number
 }
 
+export interface InfoResult {
+  vectorCount: number
+  deletedCount: number
+  dimensions: number
+  metric: string
+  frozenSegmentCount: number
+  mutableSegmentVectors: number
+  vectorBytes: number
+  graphBytes: number
+  totalMemoryBytes: number
+  walEntries: number
+  isPersistent: boolean
+  hnswM: number
+  hnswEfConstruction: number
+  hnswEfSearch: number
+  quantization: boolean
+  segmentCapacity: number
+}
+
 /**
  * Open or create a vector database.
  *

package/index.js

@@ -314,8 +314,12 @@ class VectorDatabase {
 		return this._native.optimize();
 	}
 
-	mergeFrom(other) {
-		return this._native.mergeFrom(other._native);
+	mergeFrom(other, keyPrefix) {
+		return this._native.mergeFrom(other._native, keyPrefix);
+	}
+
+	info() {
+		return this._native.info();
 	}
 
 	ids() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omendb/omendb",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "description": "Fast embedded vector database with HNSW + ACORN-1 filtered search",
   "main": "index.js",
   "types": "index.d.ts",
@@ -50,10 +50,10 @@
     "omendb.node"
   ],
   "optionalDependencies": {
-    "@omendb/omendb-darwin-x64": "0.0.28",
-    "@omendb/omendb-darwin-arm64": "0.0.28",
-    "@omendb/omendb-linux-x64-gnu": "0.0.28",
-    "@omendb/omendb-linux-arm64-gnu": "0.0.28",
-    "@omendb/omendb-win32-x64-msvc": "0.0.28"
+    "@omendb/omendb-darwin-x64": "0.0.29",
+    "@omendb/omendb-darwin-arm64": "0.0.29",
+    "@omendb/omendb-linux-x64-gnu": "0.0.29",
+    "@omendb/omendb-linux-arm64-gnu": "0.0.29",
+    "@omendb/omendb-win32-x64-msvc": "0.0.29"
   }
 }