@omendb/omendb 0.0.10 → 0.0.12

package/index.d.ts

@@ -31,10 +31,54 @@ export declare class VectorDatabase {
    * @returns Number of vectors deleted
    */
   delete(ids: Array<string>): number
+  /**
+   * Delete vectors matching a metadata filter.
+   *
+   * Evaluates the filter against all vectors and deletes those that match.
+   * Uses the same MongoDB-style filter syntax as search().
+   *
+   * @param filter - MongoDB-style metadata filter
+   * @returns Number of vectors deleted
+   *
+   * @example
+   * ```javascript
+   * // Delete by equality
+   * db.deleteWhere({ status: "archived" });
+   *
+   * // Delete with comparison
+   * db.deleteWhere({ score: { $lt: 0.5 } });
+   *
+   * // Complex filter
+   * db.deleteWhere({ $and: [{ type: "draft" }, { age: { $gt: 30 } }] });
+   * ```
+   */
+  deleteWhere(filter: Record<string, unknown>): number
+  /**
+   * Count vectors, optionally filtered by metadata.
+   *
+   * Without a filter, returns total count (same as db.length).
+   * With a filter, returns count of vectors matching the filter.
+   *
+   * @param filter - Optional MongoDB-style metadata filter
+   * @returns Number of vectors (matching filter if provided)
+   *
+   * @example
+   * ```javascript
+   * // Total count
+   * const total = db.count();
+   *
+   * // Filtered count
+   * const active = db.count({ status: "active" });
+   *
+   * // With comparison operators
+   * const highScore = db.count({ score: { $gte: 0.8 } });
+   * ```
+   */
+  count(filter?: Record<string, unknown> | undefined): number
   /** Update a vector's data and/or metadata. */
   update(id: string, vector: Array<number> | Float32Array, metadata?: Record<string, unknown> | undefined): void
   /** Get number of vectors in database. */
-  get count(): number
+  get length(): number
   /** Get current ef_search value. */
   get efSearch(): number
   /** Set ef_search value. */
@@ -95,6 +139,36 @@ export declare class VectorDatabase {
   flush(): void
   /** Merge another database into this one. */
   mergeFrom(other: VectorDatabase): number
+  /**
+   * List all vector IDs (without loading vector data).
+   *
+   * Efficient way to get all IDs for iteration, export, or debugging.
+   * @returns Array of all vector IDs in the database
+   */
+  ids(): Array<string>
+  /**
+   * Get all items as array of {id, vector, metadata}.
+   *
+   * Returns all vectors with their IDs and metadata.
+   * For large datasets, consider using ids() and get() in batches.
+   */
+  items(): Array<GetResult>
+  /**
+   * Check if an ID exists in the database.
+   *
+   * @param id - Vector ID to check
+   * @returns true if ID exists and is not deleted
+   */
+  exists(id: string): boolean
+  /**
+   * Get multiple vectors by ID.
+   *
+   * Batch version of get(). More efficient than calling get() in a loop.
+   *
+   * @param ids - Array of vector IDs to retrieve
+   * @returns Array of results in same order as input, null for missing IDs
+   */
+  getMany(ids: Array<string>): Array<GetResult | undefined | null>
 }
 
 export interface GetResult {
@@ -151,6 +225,7 @@ export declare function open(path: string, options?: OpenOptions | undefined | n
  * - quantization: null (RaBitQ bit width: 2, 4, or 8 for compression)
  * - rescore: true when quantization enabled (rerank candidates with exact distance)
  * - oversample: 3.0 (fetch k*oversample candidates when rescoring)
+ * - metric: "l2" (distance metric: "l2", "euclidean", "cosine", "dot", "ip")
  */
 export interface OpenOptions {
   /** Vector dimensions (default: 128, auto-detected on first insert) */
@@ -176,6 +251,8 @@ export interface OpenOptions {
    * Fetches k*oversample candidates then reranks to return top k
    */
   oversample?: number
+  /** Distance metric: "l2"/"euclidean" (default), "cosine", "dot"/"ip" */
+  metric?: string
 }
 
 export interface SearchResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omendb/omendb",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "Fast embedded vector database with HNSW indexing",
   "main": "index.js",
   "types": "index.d.ts",
@@ -49,9 +49,9 @@
     "omendb.node"
   ],
   "optionalDependencies": {
-    "@omendb/omendb-darwin-x64": "0.0.10",
-    "@omendb/omendb-darwin-arm64": "0.0.10",
-    "@omendb/omendb-linux-x64-gnu": "0.0.10",
-    "@omendb/omendb-linux-arm64-gnu": "0.0.10"
+    "@omendb/omendb-darwin-x64": "0.0.12",
+    "@omendb/omendb-darwin-arm64": "0.0.12",
+    "@omendb/omendb-linux-x64-gnu": "0.0.12",
+    "@omendb/omendb-linux-arm64-gnu": "0.0.12"
   }
 }