@taladb/node 0.8.2 → 0.8.4

package/index.d.ts

@@ -16,6 +16,36 @@ export declare class TalaDbNode {
    * every collection returned by `collection()`.
    */
   static open(path: string, configJson?: string | undefined | null): TalaDbNode
+  /**
+   * Compact the underlying storage file, reclaiming space freed by deletes
+   * and updates. Call during idle periods after large bulk deletes or
+   * tombstone compaction. Returns the number of bytes reclaimed (may be 0).
+   */
+  compact(): void
+  /**
+   * Close the database, releasing the file handle and its lock.
+   *
+   * Subsequent calls on this object return an error. Collections obtained
+   * before `close()` keep the underlying storage alive until they are
+   * garbage-collected — drop them too to fully release the file.
+   */
+  close(): void
+  /**
+   * List user collection names (excludes reserved `_`-prefixed collections
+   * such as the sync cursor store). Backs "sync all collections".
+   */
+  listCollectionNames(): Array<string>
+  /**
+   * Export changes to `collections` after `sinceMs` (exclusive) as a JSON
+   * changeset string, for the bidirectional sync orchestration. `sinceMs`
+   * is a millisecond epoch timestamp (the persisted sync cursor).
+   */
+  exportChanges(sinceMs: number, collections: Array<string>): string
+  /**
+   * Merge a JSON changeset string (from a remote peer) into the local
+   * database via Last-Write-Wins. Returns the number of documents changed.
+   */
+  importChanges(changesetJson: string): number
   /**
    * Get a collection by name. If an HTTP sync hook is configured it is
    * automatically attached to the returned collection.
@@ -31,6 +61,12 @@ export declare class CollectionNode {
   find(filter: JsonValue): Array<JsonValue>
   /** Find a single document or return null. */
   findOne(filter: JsonValue): JsonValue | null
+  /**
+   * Run a MongoDB-style aggregation pipeline. `pipeline` is a JSON array of
+   * stage objects (`$match`, `$group`, `$sort`, `$skip`, `$limit`,
+   * `$project`). Returns the resulting documents.
+   */
+  aggregate(pipeline: JsonValue): Array<JsonValue>
   /** Update the first matching document. */
   updateOne(filter: JsonValue, update: JsonValue): boolean
   /** Update all matching documents. */
@@ -69,4 +105,36 @@ export declare class CollectionNode {
    * Returns an array of `{ document: {...}, score: number }` objects.
    */
   findNearest(field: string, query: Array<number>, topK: number, filter?: JsonValue | undefined | null): Array<JsonValue>
+  /**
+   * Zero-copy Float32Array fast path. Avoids the f64→f32 conversion loop
+   * used by `findNearest(number[])`, which matters for large embeddings
+   * (768/1024/1536 dims) called on the hot path.
+   */
+  findNearestF32(field: string, query: Float32Array, topK: number, filter?: JsonValue | undefined | null): Array<JsonValue>
+  /**
+   * Async variant of `findNearest` — runs on the libuv thread pool so large
+   * scans or unfiltered HNSW queries don't block the JS thread. Accepts a
+   * `Float32Array` for zero-copy embedding transfer.
+   */
+  findNearestAsync(field: string, query: Float32Array, topK: number, filter?: JsonValue | undefined | null): Promise<Array<any>>
+  /**
+   * Async variant of `find` — runs on the libuv thread pool so large
+   * collection scans don't block the JS thread.
+   */
+  findAsync(filter: JsonValue): Promise<Array<any>>
+  /**
+   * Async variant of `insert` — the write (and any HTTP sync hook retries)
+   * runs on the libuv thread pool instead of blocking the JS thread.
+   */
+  insertAsync(doc: JsonValue): Promise<string>
+  /** Async variant of `insertMany`. */
+  insertManyAsync(docs: Array<JsonValue>): Promise<Array<string>>
+  /** Async variant of `updateOne`. */
+  updateOneAsync(filter: JsonValue, update: JsonValue): Promise<boolean>
+  /** Async variant of `updateMany`. */
+  updateManyAsync(filter: JsonValue, update: JsonValue): Promise<number>
+  /** Async variant of `deleteOne`. */
+  deleteOneAsync(filter: JsonValue): Promise<boolean>
+  /** Async variant of `deleteMany`. */
+  deleteManyAsync(filter: JsonValue): Promise<number>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/node",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "TalaDB Node.js native module — document queries and vector search via napi-rs",
   "main": "index.js",
   "types": "index.d.ts",
@@ -25,7 +25,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/thinkgrid-labs/taladb.git",
-    "directory": "packages/taladb-node"
+    "directory": "packages/bindings/node"
   },
   "homepage": "https://thinkgrid-labs.github.io/taladb/guide/node",
   "bugs": {