@lancedb/lancedb 0.19.0-beta.7 → 0.19.0-beta.9

package/dist/indices.d.ts

@@ -573,4 +573,5 @@ export interface IndexOptions {
      * The default is true
      */
     replace?: boolean;
+    waitTimeoutSeconds?: number;
 }

package/dist/native.d.ts

@@ -349,8 +349,10 @@ export class Table {
   add(buf: Buffer, mode: string): Promise<void>
   countRows(filter?: string | undefined | null): Promise<number>
   delete(predicate: string): Promise<void>
-  createIndex(index: Index | undefined | null, column: string, replace?: boolean | undefined | null): Promise<void>
+  createIndex(index: Index | undefined | null, column: string, replace?: boolean | undefined | null, waitTimeoutS?: number | undefined | null): Promise<void>
   dropIndex(indexName: string): Promise<void>
+  prewarmIndex(indexName: string): Promise<void>
+  waitForIndex(indexNames: Array<string>, timeoutS: number): Promise<void>
   update(onlyIf: string | undefined | null, columns: Array<[string, string]>): Promise<bigint>
   query(): Query
   vectorSearch(vector: Float32Array): VectorQuery

package/dist/table.d.ts

@@ -187,6 +187,25 @@ export declare abstract class Table {
      * Use {@link Table.listIndices} to find the names of the indices.
      */
     abstract dropIndex(name: string): Promise<void>;
+    /**
+     * Prewarm an index in the table.
+     *
+     * @param name The name of the index.
+     *
+     * This will load the index into memory.  This may reduce the cold-start time for
+     * future queries.  If the index does not fit in the cache then this call may be
+     * wasteful.
+     */
+    abstract prewarmIndex(name: string): Promise<void>;
+    /**
+     * Waits for asynchronous indexing to complete on the table.
+     *
+     * @param indexNames The name of the indices to wait for
+     * @param timeoutSeconds The number of seconds to wait before timing out
+     *
+     * This will raise an error if the indices are not created and fully indexed within the timeout.
+     */
+    abstract waitForIndex(indexNames: string[], timeoutSeconds: number): Promise<void>;
     /**
      * Create a {@link Query} Builder.
      *
@@ -401,6 +420,8 @@ export declare class LocalTable extends Table {
     delete(predicate: string): Promise<void>;
     createIndex(column: string, options?: Partial<IndexOptions>): Promise<void>;
     dropIndex(name: string): Promise<void>;
+    prewarmIndex(name: string): Promise<void>;
+    waitForIndex(indexNames: string[], timeoutSeconds: number): Promise<void>;
     query(): Query;
     search(query: string | IntoVector | FullTextQuery, queryType?: string, ftsColumns?: string | string[]): VectorQuery | Query;
     vectorSearch(vector: IntoVector): VectorQuery;

package/dist/table.js

@@ -123,11 +123,17 @@ class LocalTable extends Table {
         // Bit of a hack to get around the fact that TS has no package-scope.
         // biome-ignore lint/suspicious/noExplicitAny: skip
         const nativeIndex = options?.config?.inner;
-        await this.inner.createIndex(nativeIndex, column, options?.replace);
+        await this.inner.createIndex(nativeIndex, column, options?.replace, options?.waitTimeoutSeconds);
     }
     async dropIndex(name) {
         await this.inner.dropIndex(name);
     }
+    async prewarmIndex(name) {
+        await this.inner.prewarmIndex(name);
+    }
+    async waitForIndex(indexNames, timeoutSeconds) {
+        await this.inner.waitForIndex(indexNames, timeoutSeconds);
+    }
     query() {
         return new query_1.Query(this.inner);
     }

package/package.json

@@ -11,7 +11,7 @@
     "ann"
   ],
   "private": false,
-  "version": "0.19.0-beta.7",
+  "version": "0.19.0-beta.9",
   "main": "dist/index.js",
   "exports": {
     ".": "./dist/index.js",
@@ -100,14 +100,14 @@
     "reflect-metadata": "^0.2.2"
   },
   "optionalDependencies": {
-    "@lancedb/lancedb-darwin-x64": "0.19.0-beta.7",
-    "@lancedb/lancedb-darwin-arm64": "0.19.0-beta.7",
-    "@lancedb/lancedb-linux-x64-gnu": "0.19.0-beta.7",
-    "@lancedb/lancedb-linux-arm64-gnu": "0.19.0-beta.7",
-    "@lancedb/lancedb-linux-x64-musl": "0.19.0-beta.7",
-    "@lancedb/lancedb-linux-arm64-musl": "0.19.0-beta.7",
-    "@lancedb/lancedb-win32-x64-msvc": "0.19.0-beta.7",
-    "@lancedb/lancedb-win32-arm64-msvc": "0.19.0-beta.7"
+    "@lancedb/lancedb-darwin-x64": "0.19.0-beta.9",
+    "@lancedb/lancedb-darwin-arm64": "0.19.0-beta.9",
+    "@lancedb/lancedb-linux-x64-gnu": "0.19.0-beta.9",
+    "@lancedb/lancedb-linux-arm64-gnu": "0.19.0-beta.9",
+    "@lancedb/lancedb-linux-x64-musl": "0.19.0-beta.9",
+    "@lancedb/lancedb-linux-arm64-musl": "0.19.0-beta.9",
+    "@lancedb/lancedb-win32-x64-msvc": "0.19.0-beta.9",
+    "@lancedb/lancedb-win32-arm64-msvc": "0.19.0-beta.9"
   },
   "peerDependencies": {
     "apache-arrow": ">=15.0.0 <=18.1.0"