@lancedb/lancedb 0.39.0-beta.0 → 0.39.0-beta.3

package/dist/connection.d.ts

@@ -1,9 +1,9 @@
 import { Data, SchemaLike, TableLike } from "./arrow";
-import { Table as ArrowTable } from "./arrow";
 import { EmbeddingFunctionConfig } from "./embedding/registry";
+import { Job } from "./job";
 import { MaterializedView, MaterializedViewSelect } from "./materialized_view";
 import { Connection as LanceDbConnection } from "./native";
-import type { CreateNamespaceResponse, DescribeNamespaceResponse, DropNamespaceResponse, Job, JobDescription, JobInfo, ListNamespacesResponse, ListTablesResponse } from "./native";
+import type { CreateNamespaceResponse, DescribeNamespaceResponse, DropNamespaceResponse, JobInfo, ListNamespacesResponse, ListTablesResponse } from "./native";
 export type { CreateNamespaceResponse, DescribeNamespaceResponse, DropNamespaceResponse, ListNamespacesResponse, ListTablesResponse, };
 import { Table } from "./table";
 export interface CreateTableOptions {
@@ -428,21 +428,17 @@ export declare abstract class Connection {
      */
     abstract renameTable(currentName: string, newName: string, options?: RenameTableOptions): Promise<void>;
     /**
-     * A {@link Job} handle for a server-side job by id.
+     * Open a server-side job by id, returning a handle with its record already
+     * populated. Rejects when the server has no such job, the way
+     * {@link Connection.openTable} does for a missing table.
      *
-     * The handle is constructed without a server round trip; an unknown id
-     * surfaces when the handle is used. Dropping the handle has no effect on
-     * the job itself.
+     * The returned {@link Job} answers for its own state, specification,
+     * result, failure and event history, so there is no separate
+     * connection-level call for any of them.
      */
-    abstract job(jobId: string): Job;
+    abstract openJob(jobId: string): Promise<Job>;
     /** List server-side jobs across the database's tables. */
     abstract listJobs(): Promise<JobInfo[]>;
-    /**
-     * Describe a single server-side job by id.
-     *
-     * Resolves to `null` when the server has no such job.
-     */
-    abstract getJob(jobId: string): Promise<JobDescription | null>;
     /**
      * Request cancellation of a server-side job by id.
      *
@@ -450,12 +446,6 @@ export declare abstract class Connection {
      * such job exists. Cancelling an already-terminal job is a no-op success.
      */
     abstract cancelJob(jobId: string): Promise<boolean>;
-    /**
-     * The lifecycle event history of a server-side job, as an Arrow table.
-     *
-     * Lists history across all jobs when `jobId` is omitted.
-     */
-    abstract jobHistory(jobId?: string): Promise<ArrowTable>;
 }
 /** @hideconstructor */
 export declare class LocalConnection extends Connection {
@@ -496,11 +486,9 @@ export declare class LocalConnection extends Connection {
     createNamespace(namespacePath: string[], options?: Partial<CreateNamespaceOptions>): Promise<CreateNamespaceResponse>;
     dropNamespace(namespacePath: string[], options?: Partial<DropNamespaceOptions>): Promise<DropNamespaceResponse>;
     renameTable(currentName: string, newName: string, options?: RenameTableOptions): Promise<void>;
-    job(jobId: string): Job;
+    openJob(jobId: string): Promise<Job>;
     listJobs(): Promise<JobInfo[]>;
-    getJob(jobId: string): Promise<JobDescription | null>;
     cancelJob(jobId: string): Promise<boolean>;
-    jobHistory(jobId?: string): Promise<ArrowTable>;
 }
 /**
  * Takes storage options and makes all the keys snake case.

package/dist/connection.js

@@ -4,10 +4,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocalConnection = exports.Connection = void 0;
 exports.cleanseStorageOptions = cleanseStorageOptions;
-const apache_arrow_1 = require("apache-arrow");
 const arrow_1 = require("./arrow");
 const arrow_2 = require("./arrow");
 const registry_1 = require("./embedding/registry");
+const job_1 = require("./job");
 const materialized_view_1 = require("./materialized_view");
 const sanitize_1 = require("./sanitize");
 const table_1 = require("./table");
@@ -198,7 +198,7 @@ class LocalConnection extends Connection {
         return this.inner.dropTable(name, namespacePath ?? []);
     }
     async dropTableAsync(name, namespacePath) {
-        return this.inner.dropTableAsync(name, namespacePath ?? []);
+        return new job_1.Job(await this.inner.dropTableAsync(name, namespacePath ?? []));
     }
     async dropAllTables(namespacePath) {
         return this.inner.dropAllTables(namespacePath ?? []);
@@ -218,25 +218,15 @@ class LocalConnection extends Connection {
     async renameTable(currentName, newName, options) {
         return this.inner.renameTable(currentName, newName, options?.namespacePath ?? [], options?.newNamespacePath);
     }
-    job(jobId) {
-        return this.inner.job(jobId);
+    async openJob(jobId) {
+        return new job_1.Job(await this.inner.openJob(jobId));
     }
     async listJobs() {
         return this.inner.listJobs();
     }
-    async getJob(jobId) {
-        return this.inner.getJob(jobId);
-    }
     async cancelJob(jobId) {
         return this.inner.cancelJob(jobId);
     }
-    async jobHistory(jobId) {
-        const buf = await this.inner.jobHistory(jobId);
-        if (buf.length === 0) {
-            return new arrow_2.Table();
-        }
-        return (0, apache_arrow_1.tableFromIPC)(buf);
-    }
 }
 exports.LocalConnection = LocalConnection;
 /**

package/dist/index.d.ts

@@ -9,7 +9,8 @@ export { instrumentLanceDbMetrics } from "./otel";
 export { AddColumnsSql, ConnectionOptions, ConnectNamespaceOptions, IndexStatistics, IndexConfig, ClientConfig, TimeoutConfig, RetryConfig, TlsConfig, OptimizeStats, CompactionStats, RemovalStats, TableStatistics, FragmentStatistics, FragmentSummaryStats, Tags, TagContents, BranchContents, MergeResult, AddResult, AddColumnsResult, RefreshColumnResult, RefreshMaterializedViewResult, AlterColumnsResult, UpdateFieldMetadataResult, DeleteResult, DropColumnsResult, UpdateResult, SplitCalculatedOptions, SplitRandomOptions, SplitHashOptions, SplitSequentialOptions, ShuffleOptions, OAuthConfig as NativeOAuthConfig, } from "./native.js";
 export { makeArrowTable, MakeArrowTableOptions, Data, VectorColumnOptions, } from "./arrow";
 export { Connection, CreateTableOptions, TableNamesOptions, ListTablesOptions, OpenTableOptions, ListNamespacesOptions, CreateNamespaceOptions, DropNamespaceOptions, ListNamespacesResponse, ListTablesResponse, CreateNamespaceResponse, DropNamespaceResponse, DescribeNamespaceResponse, RenameTableOptions, } from "./connection";
-export { Job, JobDescription, JobFailureInfo, JobInfo, Session, } from "./native.js";
+export { JobFailureInfo, JobInfo, Session } from "./native.js";
+export { Job, JobEventsOptions } from "./job";
 export { AutoQuery, ExecutableQuery, Query, QueryBase, VectorQuery, TakeQuery, AnalyzePlanDistributedMetrics, QueryExecutionOptions, ColumnOrdering, FullTextSearchOptions, RecordBatchIterator, FullTextQuery, MatchQuery, PhraseQuery, BoostQuery, MultiMatchQuery, BooleanQuery, FullTextQueryType, Operator, Occur, } from "./query";
 export { Index, IndexOptions, IvfPqOptions, IvfRqOptions, IvfFlatOptions, HnswPqOptions, HnswSqOptions, FtsOptions, BaseTokenizer, } from "./indices";
 export { Table, Branches, BranchColumnSummary, BranchColumnChange, BranchIndexSummary, BranchRowCountSummary, CherryPickError, BranchDiff, CherryPickPreview, CherryPickResult, AddDataOptions, UpdateOptions, OptimizeOptions, Version, WriteProgress, FtsToken, TokenizeTableOptions, LsmWriteSpec, LsmStats, BucketStats, GenerationStats, MemtableStats, ColumnAlteration, FieldMetadataUpdate, } from "./table";

package/dist/index.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: Copyright The LanceDB Authors
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.packBits = exports.rerankers = exports.Scannable = exports.PermutationBuilder = exports.permutationBuilder = exports.embedding = exports.MergeInsertBuilder = exports.OAuthFlowType = exports.OAuthHeaderProvider = exports.StaticHeaderProvider = exports.HeaderProvider = exports.Branches = exports.Table = exports.Index = exports.Occur = exports.Operator = exports.FullTextQueryType = exports.BooleanQuery = exports.MultiMatchQuery = exports.BoostQuery = exports.PhraseQuery = exports.MatchQuery = exports.RecordBatchIterator = exports.TakeQuery = exports.VectorQuery = exports.QueryBase = exports.Query = exports.AutoQuery = exports.Session = exports.Job = exports.Connection = exports.VectorColumnOptions = exports.MakeArrowTableOptions = exports.makeArrowTable = exports.BranchContents = exports.TagContents = exports.Tags = exports.instrumentLanceDbMetrics = exports.NativeJsHeaderProvider = exports.MaterializedView = void 0;
+exports.packBits = exports.rerankers = exports.Scannable = exports.PermutationBuilder = exports.permutationBuilder = exports.embedding = exports.MergeInsertBuilder = exports.OAuthFlowType = exports.OAuthHeaderProvider = exports.StaticHeaderProvider = exports.HeaderProvider = exports.Branches = exports.Table = exports.Index = exports.Occur = exports.Operator = exports.FullTextQueryType = exports.BooleanQuery = exports.MultiMatchQuery = exports.BoostQuery = exports.PhraseQuery = exports.MatchQuery = exports.RecordBatchIterator = exports.TakeQuery = exports.VectorQuery = exports.QueryBase = exports.Query = exports.AutoQuery = exports.Job = exports.Session = exports.Connection = exports.VectorColumnOptions = exports.MakeArrowTableOptions = exports.makeArrowTable = exports.BranchContents = exports.TagContents = exports.Tags = exports.instrumentLanceDbMetrics = exports.NativeJsHeaderProvider = exports.MaterializedView = void 0;
 exports.tokenize = tokenize;
 exports.connect = connect;
 exports.connectNamespace = connectNamespace;
@@ -29,8 +29,9 @@ Object.defineProperty(exports, "VectorColumnOptions", { enumerable: true, get: f
 var connection_2 = require("./connection");
 Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return connection_2.Connection; } });
 var native_js_4 = require("./native.js");
-Object.defineProperty(exports, "Job", { enumerable: true, get: function () { return native_js_4.Job; } });
 Object.defineProperty(exports, "Session", { enumerable: true, get: function () { return native_js_4.Session; } });
+var job_1 = require("./job");
+Object.defineProperty(exports, "Job", { enumerable: true, get: function () { return job_1.Job; } });
 var query_1 = require("./query");
 Object.defineProperty(exports, "AutoQuery", { enumerable: true, get: function () { return query_1.AutoQuery; } });
 Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return query_1.Query; } });

package/dist/job.d.ts

@@ -0,0 +1,93 @@
+import { Table as ArrowTable } from "apache-arrow";
+import { JobFailureInfo, Job as NativeJob } from "./native";
+/** Which of a job's events {@link Job.events} returns. */
+export interface JobEventsOptions {
+    /** Maximum event rows to return, up to the server maximum of 10,000. */
+    limit?: number;
+    /** SQL-like filter over the event columns. */
+    filter?: string;
+}
+/**
+ * A handle to an operation that may still be running.
+ *
+ * The operation may already be complete when the handle is created.
+ *
+ * The detail getters read what the handle last observed. Submitting an
+ * operation returns only a job id, so populating them eagerly would cost an
+ * extra round trip on every call:
+ *
+ * - {@link Job.refresh} and {@link Job.status} fetch the whole record.
+ * - {@link Job.wait} records the terminal state it establishes, but not the
+ *   rest of the record.
+ * - Everything is null until one of those runs.
+ *
+ * @hideconstructor
+ */
+export declare class Job {
+    private readonly inner;
+    constructor(inner: NativeJob);
+    /**
+     * Identifies the operation on the server that is running it.
+     *
+     * Operations that run in this process have no server id. The value is
+     * opaque: parsing it or storing it to resume the job later is not supported.
+     */
+    get id(): string | null;
+    /** The last observed lifecycle state, without contacting the backend. */
+    get state(): string | null;
+    /**
+     * The job's type, as the server names it. Null for an in-process job, which
+     * has no server-side record.
+     */
+    get jobType(): string | null;
+    /** When the job was created, in milliseconds since the epoch. */
+    get creationMs(): number | null;
+    /** The job-type-specific specification it was submitted with. */
+    get spec(): any | null;
+    /**
+     * The job-type-specific terminal result. Null until the job succeeds, so a
+     * job that never terminates reports its progress through {@link Job.events}
+     * instead.
+     */
+    get result(): any | null;
+    /** Why the job failed, when it failed and the server reports a reason. */
+    get failure(): JobFailureInfo | null;
+    /**
+     * The operation's current lifecycle state: "running", "finished", "failed",
+     * or "cancelled".
+     *
+     * A point snapshot; unlike {@link Job.wait} it does not block or reject on a
+     * terminal failure state. Also refreshes the getters above.
+     */
+    status(): Promise<string>;
+    /** Wait until the operation reaches a terminal state. */
+    wait(): Promise<void>;
+    /** Request cancellation. Cancelling a finished operation is a no-op. */
+    cancel(): Promise<void>;
+    /**
+     * Ask the backend for this job's current state, and for a server-side job
+     * its full record, then cache it for the getters above.
+     */
+    refresh(): Promise<void>;
+    /**
+     * This job's recorded lifecycle events.
+     *
+     * Where the getters above report a terminal result only once the job reaches
+     * one, events are written as the job runs and outlive the workers that
+     * produced them. A distributed job records a `claim`/`claim_complete` pair
+     * per unit of work, each carrying `rows_processed`, so a job that never
+     * finishes still accounts for what it did.
+     *
+     * The server caps results at 1000 rows by default and 10,000 at most, and
+     * truncates without saying so, so pass `limit` for a job that emits an event
+     * per fragment. `filter` is a SQL-like expression over the `state`,
+     * `updated_by`, `emitted_from`, `emitted_by`, and `claim_entity` columns.
+     */
+    events(options?: JobEventsOptions): Promise<ArrowTable>;
+    /**
+     * Every field the handle currently knows, one per line, with the JSON
+     * payloads indented -- a refresh job's spec and result are the point of
+     * printing it.
+     */
+    toString(): string;
+}

package/dist/job.js

@@ -0,0 +1,163 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright The LanceDB Authors
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Job = void 0;
+const apache_arrow_1 = require("apache-arrow");
+/**
+ * A handle to an operation that may still be running.
+ *
+ * The operation may already be complete when the handle is created.
+ *
+ * The detail getters read what the handle last observed. Submitting an
+ * operation returns only a job id, so populating them eagerly would cost an
+ * extra round trip on every call:
+ *
+ * - {@link Job.refresh} and {@link Job.status} fetch the whole record.
+ * - {@link Job.wait} records the terminal state it establishes, but not the
+ *   rest of the record.
+ * - Everything is null until one of those runs.
+ *
+ * @hideconstructor
+ */
+class Job {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    /**
+     * Identifies the operation on the server that is running it.
+     *
+     * Operations that run in this process have no server id. The value is
+     * opaque: parsing it or storing it to resume the job later is not supported.
+     */
+    get id() {
+        return this.inner.id ?? null;
+    }
+    /** The last observed lifecycle state, without contacting the backend. */
+    get state() {
+        return this.inner.state ?? null;
+    }
+    /**
+     * The job's type, as the server names it. Null for an in-process job, which
+     * has no server-side record.
+     */
+    get jobType() {
+        return this.inner.jobType ?? null;
+    }
+    /** When the job was created, in milliseconds since the epoch. */
+    get creationMs() {
+        return this.inner.creationMs ?? null;
+    }
+    /** The job-type-specific specification it was submitted with. */
+    // biome-ignore lint/suspicious/noExplicitAny: shape varies by job type
+    get spec() {
+        return parseJson(this.inner.specJson);
+    }
+    /**
+     * The job-type-specific terminal result. Null until the job succeeds, so a
+     * job that never terminates reports its progress through {@link Job.events}
+     * instead.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: shape varies by job type
+    get result() {
+        return parseJson(this.inner.resultJson);
+    }
+    /** Why the job failed, when it failed and the server reports a reason. */
+    get failure() {
+        return this.inner.failure ?? null;
+    }
+    /**
+     * The operation's current lifecycle state: "running", "finished", "failed",
+     * or "cancelled".
+     *
+     * A point snapshot; unlike {@link Job.wait} it does not block or reject on a
+     * terminal failure state. Also refreshes the getters above.
+     */
+    async status() {
+        return this.inner.status();
+    }
+    /** Wait until the operation reaches a terminal state. */
+    async wait() {
+        return this.inner.wait();
+    }
+    /** Request cancellation. Cancelling a finished operation is a no-op. */
+    async cancel() {
+        return this.inner.cancel();
+    }
+    /**
+     * Ask the backend for this job's current state, and for a server-side job
+     * its full record, then cache it for the getters above.
+     */
+    async refresh() {
+        return this.inner.refresh();
+    }
+    /**
+     * This job's recorded lifecycle events.
+     *
+     * Where the getters above report a terminal result only once the job reaches
+     * one, events are written as the job runs and outlive the workers that
+     * produced them. A distributed job records a `claim`/`claim_complete` pair
+     * per unit of work, each carrying `rows_processed`, so a job that never
+     * finishes still accounts for what it did.
+     *
+     * The server caps results at 1000 rows by default and 10,000 at most, and
+     * truncates without saying so, so pass `limit` for a job that emits an event
+     * per fragment. `filter` is a SQL-like expression over the `state`,
+     * `updated_by`, `emitted_from`, `emitted_by`, and `claim_entity` columns.
+     */
+    async events(options) {
+        const buf = await this.inner.events(options?.limit, options?.filter);
+        if (buf.length === 0) {
+            return new apache_arrow_1.Table();
+        }
+        return (0, apache_arrow_1.tableFromIPC)(buf);
+    }
+    /**
+     * Every field the handle currently knows, one per line, with the JSON
+     * payloads indented -- a refresh job's spec and result are the point of
+     * printing it.
+     */
+    toString() {
+        if (this.state === null) {
+            const known = this.id === null ? "" : `id=${JSON.stringify(this.id)}, `;
+            return `Job(${known}not refreshed)`;
+        }
+        const fields = [];
+        if (this.id !== null) {
+            fields.push(`id=${JSON.stringify(this.id)}`);
+        }
+        fields.push(`state=${JSON.stringify(this.state)}`);
+        if (this.jobType !== null) {
+            fields.push(`jobType=${JSON.stringify(this.jobType)}`);
+        }
+        if (this.creationMs !== null) {
+            fields.push(`creationMs=${this.creationMs}`);
+        }
+        for (const [name, value] of [
+            ["spec", this.spec],
+            ["result", this.result],
+        ]) {
+            if (value !== null) {
+                fields.push(`${name}=${indentJson(value)}`);
+            }
+        }
+        if (this.failure !== null) {
+            fields.push(`failure=${indentJson(this.failure)}`);
+        }
+        return `Job(${fields.map((field) => `\n${REPR_INDENT}${field},`).join("")}\n)`;
+    }
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        return this.toString();
+    }
+}
+exports.Job = Job;
+const REPR_INDENT = "    ";
+// biome-ignore lint/suspicious/noExplicitAny: shape varies by job type
+function indentJson(value) {
+    return JSON.stringify(value, null, 4).replace(/\n/g, `\n${REPR_INDENT}`);
+}
+// biome-ignore lint/suspicious/noExplicitAny: shape varies by job type
+function parseJson(raw) {
+    return raw === null || raw === undefined ? null : JSON.parse(raw);
+}

package/dist/native.d.ts

@@ -47,30 +47,21 @@ export declare class Connection {
   dropTableAsync(name: string, namespacePath?: Array<string> | undefined | null): Promise<Job>
   dropAllTables(namespacePath?: Array<string> | undefined | null): Promise<void>
   /**
-   * A `Job` handle for a server-side job by id.
+   * Open a server-side job by id, returning a handle with its record
+   * already populated. Rejects when the server has no such job.
    *
-   * The handle is constructed without a server round trip; an unknown id
-   * surfaces when the handle is used.
+   * The returned handle answers for its own state, specification, result,
+   * failure and event history, so there is no separate connection-level
+   * call for any of them.
    */
-  job(jobId: string): Job
+  openJob(jobId: string): Promise<Job>
   /** List server-side jobs across the database's tables. */
   listJobs(): Promise<Array<JobInfo>>
-  /**
-   * Describe a single server-side job by id. `null` when the server has
-   * no such job.
-   */
-  getJob(jobId: string): Promise<JobDescription | null>
   /**
    * Request cancellation of a server-side job by id. Returns true if the
    * server accepted the cancellation, false if no such job exists.
    */
   cancelJob(jobId: string): Promise<boolean>
-  /**
-   * The lifecycle event history of a server-side job (all jobs when
-   * `job_id` is null), as an Arrow IPC stream buffer. Empty when there is
-   * no history.
-   */
-  jobHistory(jobId?: string | undefined | null): Promise<Buffer>
   /** Describe a namespace and return its properties. */
   describeNamespace(namespacePath: Array<string>): Promise<DescribeNamespaceResponse>
   /** List child namespaces under the given namespace path */
@@ -120,6 +111,39 @@ export declare class Job {
   wait(): Promise<void>
   /** Request cancellation. Cancelling a finished operation is a no-op. */
   cancel(): Promise<void>
+  /**
+   * Ask the backend for this job's current state, and for a server-side job
+   * its full record, then cache it for the getters below.
+   *
+   * They are all null until this runs, because submitting an operation
+   * returns only a job id. {@link Job.status} fetches the whole record too;
+   * {@link Job.wait} records only the terminal state it establishes.
+   */
+  refresh(): Promise<void>
+  /** The last observed lifecycle state, without contacting the backend. */
+  get state(): string | null
+  /**
+   * The job's type, as the server names it. Null for an in-process job,
+   * which has no server-side record.
+   */
+  get jobType(): string | null
+  /** When the job was created, in milliseconds since the epoch. */
+  get creationMs(): number | null
+  /** The job-type-specific specification as a JSON string, when present. */
+  get specJson(): string | null
+  /**
+   * The job-type-specific terminal result as a JSON string. Null until the
+   * job succeeds, so a job that never terminates reports its progress
+   * through {@link Job.events} instead.
+   */
+  get resultJson(): string | null
+  /** Why the job failed, when it failed and the server reports a reason. */
+  get failure(): JobFailureInfo | null
+  /**
+   * This job's recorded lifecycle events, as an Arrow IPC stream buffer.
+   * The TypeScript wrapper turns it into an Arrow table.
+   */
+  events(limit?: number | undefined | null, filter?: string | undefined | null): Promise<Buffer>
 }
 
 export declare class JsFullTextQuery {
@@ -773,23 +797,6 @@ export interface IndexStatistics {
   numIndices?: number
 }
 
-/** A described job from `Connection.getJob`. */
-export interface JobDescription {
-  jobId: string
-  jobType: string
-  /** Lifecycle state: "running", "finished", "failed", or "cancelled". */
-  state: string
-  /** When the job was created, in milliseconds since the epoch. */
-  creationMs: number
-  /** The job-type-specific specification as a JSON string, when present. */
-  specJson?: string
-  /**
-   * Why the job failed, when the job is failed and the server reports a
-   * reason.
-   */
-  failure?: JobFailureInfo
-}
-
 /** The server's account of why a job failed. */
 export interface JobFailureInfo {
   phase?: string
@@ -800,7 +807,7 @@ export interface JobFailureInfo {
 /** A row from `Connection.listJobs`: one server-side job. */
 export interface JobInfo {
   /**
-   * The job id -- what `Connection.getJob` and `Connection.cancelJob`
+   * The job id -- what `Connection.openJob` and `Connection.cancelJob`
    * accept.
    */
   jobId: string

package/dist/native.js

@@ -76,8 +76,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-android-arm64');
                 const bindingPackageVersion = require('@lancedb/lancedb-android-arm64/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -95,8 +95,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-android-arm-eabi');
                 const bindingPackageVersion = require('@lancedb/lancedb-android-arm-eabi/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -120,8 +120,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-win32-x64-gnu');
                     const bindingPackageVersion = require('@lancedb/lancedb-win32-x64-gnu/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -139,8 +139,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-win32-x64-msvc');
                     const bindingPackageVersion = require('@lancedb/lancedb-win32-x64-msvc/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -159,8 +159,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-win32-ia32-msvc');
                 const bindingPackageVersion = require('@lancedb/lancedb-win32-ia32-msvc/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -178,8 +178,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-win32-arm64-msvc');
                 const bindingPackageVersion = require('@lancedb/lancedb-win32-arm64-msvc/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -201,8 +201,8 @@ function requireNative() {
         try {
             const binding = require('@lancedb/lancedb-darwin-universal');
             const bindingPackageVersion = require('@lancedb/lancedb-darwin-universal/package.json').version;
-            if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+            if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
             }
             return binding;
         }
@@ -219,8 +219,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-darwin-x64');
                 const bindingPackageVersion = require('@lancedb/lancedb-darwin-x64/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -238,8 +238,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-darwin-arm64');
                 const bindingPackageVersion = require('@lancedb/lancedb-darwin-arm64/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -262,8 +262,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-freebsd-x64');
                 const bindingPackageVersion = require('@lancedb/lancedb-freebsd-x64/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -281,8 +281,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-freebsd-arm64');
                 const bindingPackageVersion = require('@lancedb/lancedb-freebsd-arm64/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -306,8 +306,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-x64-musl');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-x64-musl/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -325,8 +325,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-x64-gnu');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-x64-gnu/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -346,8 +346,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-arm64-musl');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-arm64-musl/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -365,8 +365,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-arm64-gnu');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-arm64-gnu/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -386,8 +386,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-arm-musleabihf');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-arm-musleabihf/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -405,8 +405,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-arm-gnueabihf');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-arm-gnueabihf/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -426,8 +426,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-loong64-musl');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-loong64-musl/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -445,8 +445,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-loong64-gnu');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-loong64-gnu/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -466,8 +466,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-riscv64-musl');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-riscv64-musl/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -485,8 +485,8 @@ function requireNative() {
                 try {
                     const binding = require('@lancedb/lancedb-linux-riscv64-gnu');
                     const bindingPackageVersion = require('@lancedb/lancedb-linux-riscv64-gnu/package.json').version;
-                    if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                        throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                     }
                     return binding;
                 }
@@ -505,8 +505,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-linux-ppc64-gnu');
                 const bindingPackageVersion = require('@lancedb/lancedb-linux-ppc64-gnu/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -524,8 +524,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-linux-s390x-gnu');
                 const bindingPackageVersion = require('@lancedb/lancedb-linux-s390x-gnu/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -548,8 +548,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-openharmony-arm64');
                 const bindingPackageVersion = require('@lancedb/lancedb-openharmony-arm64/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -567,8 +567,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-openharmony-x64');
                 const bindingPackageVersion = require('@lancedb/lancedb-openharmony-x64/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }
@@ -586,8 +586,8 @@ function requireNative() {
             try {
                 const binding = require('@lancedb/lancedb-openharmony-arm');
                 const bindingPackageVersion = require('@lancedb/lancedb-openharmony-arm/package.json').version;
-                if (bindingPackageVersion !== '0.39.0-beta.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.39.0-beta.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+                    throw new Error(`Native binding package version mismatch, expected 0.39.0-beta.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }

package/dist/table.d.ts

@@ -1,7 +1,8 @@
 import { Table as ArrowTable, Data, DataType, Field, IntoVector, MultiVector, Schema } from "./arrow";
 import { IndexOptions } from "./indices";
+import { Job } from "./job";
 import { MergeInsertBuilder } from "./merge";
-import { AddColumnsResult, AddColumnsSql, AddResult, AlterColumnsResult, BranchContents, DeleteResult, DropColumnsResult, IndexConfig, IndexStatistics, Job, LsmStats, Branches as NativeBranches, OptimizeStats, RefreshColumnResult, RefreshMaterializedViewResult, TableStatistics, Tags, UpdateFieldMetadataResult, UpdateResult, Table as _NativeTable } from "./native";
+import { AddColumnsResult, AddColumnsSql, AddResult, AlterColumnsResult, BranchContents, DeleteResult, DropColumnsResult, IndexConfig, IndexStatistics, LsmStats, Branches as NativeBranches, OptimizeStats, RefreshColumnResult, RefreshMaterializedViewResult, TableStatistics, Tags, UpdateFieldMetadataResult, UpdateResult, Table as _NativeTable } from "./native";
 import { AutoQuery, FullTextQuery, Query, TakeQuery, VectorQuery } from "./query";
 import { IntoSql } from "./util";
 export { IndexConfig } from "./native";
@@ -785,6 +786,16 @@ export declare abstract class Table {
     abstract tokenize(query: string, options: TokenizeTableOptions): Promise<FtsToken[]>;
     /** Return the table as an arrow table */
     abstract toArrow(): Promise<ArrowTable>;
+    /**
+     * Create a {@link MergeInsertBuilder}, which combines new data with the
+     * existing table in a single transaction — inserting, updating and deleting
+     * rows depending on how they match.
+     *
+     * @param on - The column, or columns, to match source rows against target
+     * rows on. Typically a key or id column. Several columns match on the
+     * composite key: a source row updates a target row only when it agrees on
+     * every one of them.
+     */
     abstract mergeInsert(on: string | string[]): MergeInsertBuilder;
     /** List all the stats of a specified index
      *

package/dist/table.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Branches = exports.LocalTable = exports.Table = void 0;
 const arrow_1 = require("./arrow");
 const registry_1 = require("./embedding/registry");
+const job_1 = require("./job");
 const merge_1 = require("./merge");
 const query_1 = require("./query");
 const sanitize_1 = require("./sanitize");
@@ -143,7 +144,7 @@ class LocalTable extends Table {
     async createIndexAsync(column, options) {
         // biome-ignore lint/suspicious/noExplicitAny: skip
         const nativeIndex = options?.config?.inner;
-        return await this.inner.createIndexAsync(nativeIndex, column, options?.replace, options?.waitTimeoutSeconds, options?.name, options?.train);
+        return new job_1.Job(await this.inner.createIndexAsync(nativeIndex, column, options?.replace, options?.waitTimeoutSeconds, options?.name, options?.train));
     }
     async dropIndex(name) {
         await this.inner.dropIndex(name);
@@ -273,7 +274,7 @@ class LocalTable extends Table {
         return await this.inner.refreshColumn(column);
     }
     async refreshColumnAsync(column) {
-        return await this.inner.refreshColumnAsync(column);
+        return new job_1.Job(await this.inner.refreshColumnAsync(column));
     }
     async refreshMaterializedView(full, sourceVersion) {
         return await this.inner.refreshMaterializedView(full, sourceVersion);

package/package.json

@@ -11,7 +11,7 @@
     "ann"
   ],
   "private": false,
-  "version": "0.39.0-beta.0",
+  "version": "0.39.0-beta.3",
   "main": "dist/index.js",
   "exports": {
     ".": "./dist/index.js",
@@ -44,7 +44,7 @@
     "@biomejs/biome": "^1.7.3",
     "@jest/globals": "^29.7.0",
     "@napi-rs/cli": "3.7.0",
-    "@opentelemetry/sdk-metrics": "^1.30.0",
+    "@opentelemetry/sdk-metrics": "^2.10.0",
     "@types/axios": "^0.14.0",
     "@types/jest": "^29.1.2",
     "@types/node": "22.7.4",
@@ -56,7 +56,7 @@
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
     "shx": "^0.3.4",
-    "tmp": "^0.2.3",
+    "tmp": "^0.2.7",
     "ts-jest": "^29.1.2",
     "typedoc": "0.26.4",
     "typedoc-plugin-markdown": "4.2.1",
@@ -106,13 +106,13 @@
   "optionalDependencies": {
     "@huggingface/transformers": "3.0.2",
     "openai": "4.29.2",
-    "@lancedb/lancedb-darwin-arm64": "0.39.0-beta.0",
-    "@lancedb/lancedb-linux-x64-gnu": "0.39.0-beta.0",
-    "@lancedb/lancedb-linux-arm64-gnu": "0.39.0-beta.0",
-    "@lancedb/lancedb-linux-x64-musl": "0.39.0-beta.0",
-    "@lancedb/lancedb-linux-arm64-musl": "0.39.0-beta.0",
-    "@lancedb/lancedb-win32-x64-msvc": "0.39.0-beta.0",
-    "@lancedb/lancedb-win32-arm64-msvc": "0.39.0-beta.0"
+    "@lancedb/lancedb-darwin-arm64": "0.39.0-beta.3",
+    "@lancedb/lancedb-linux-x64-gnu": "0.39.0-beta.3",
+    "@lancedb/lancedb-linux-arm64-gnu": "0.39.0-beta.3",
+    "@lancedb/lancedb-linux-x64-musl": "0.39.0-beta.3",
+    "@lancedb/lancedb-linux-arm64-musl": "0.39.0-beta.3",
+    "@lancedb/lancedb-win32-x64-msvc": "0.39.0-beta.3",
+    "@lancedb/lancedb-win32-arm64-msvc": "0.39.0-beta.3"
   },
   "peerDependencies": {
     "@types/node": ">=22",

package/pnpm-workspace.yaml

@@ -16,3 +16,41 @@ allowBuilds:
   onnxruntime-node: true
   protobufjs: true
   sharp: true
+
+minimumReleaseAgeExclude:
+  - protobufjs@7.5.8
+  - tmp@0.2.6
+  - form-data@4.0.6
+  - tar@7.5.16
+  - markdown-it@14.1.2
+  - linkify-it@5.0.1
+  - js-yaml@3.15.0
+  - js-yaml@4.1.2
+  - protobufjs@7.6.1
+  - protobufjs@7.6.3
+  - '@babel/core@7.29.1'
+  - axios@1.18.0
+  - brace-expansion@2.1.2
+  - brace-expansion@1.1.16
+  - js-yaml@4.3.0
+  - tar@7.5.18
+  - tar@7.5.19
+  - tar@7.5.17
+  - protobufjs@7.6.5
+  - linkify-it@5.0.2
+  - sharp@0.35.0
+  - brace-expansion@1.1.17
+  - brace-expansion@2.1.3
+  - brace-expansion@2.1.4
+  - brace-expansion@1.1.18
+  - js-yaml@3.15.1
+  - js-yaml@4.3.1
+  - tar@7.5.21
+  - '@opentelemetry/core@2.8.0'
+
+# @huggingface/transformers pins sharp ^0.33.5 and no released version has moved
+# past ^0.34.5, all of which inherit the libvips CVEs in GHSA-f88m-g3jw-g9cj.
+# Force the patched line. sharp is only reached by transformers' image pipeline,
+# which LanceDB's text embedding function never uses.
+overrides:
+  sharp: ^0.35.4