@lancedb/lancedb 0.27.2-beta.1 → 0.28.0-beta.0

package/dist/arrow.d.ts

@@ -35,10 +35,18 @@ export type TableLike = ArrowTable | {
     schema: SchemaLike;
     batches: RecordBatchLike[];
 };
-export type IntoVector = Float32Array | Float64Array | number[] | Promise<Float32Array | Float64Array | number[]>;
+export type IntoVector = Float32Array | Float64Array | Uint8Array | number[] | Promise<Float32Array | Float64Array | Uint8Array | number[]>;
 export type MultiVector = IntoVector[];
 export declare function isMultiVector(value: unknown): value is MultiVector;
 export declare function isIntoVector(value: unknown): value is IntoVector;
+/**
+ * Extract the underlying byte buffer and data type from a typed array
+ * for passing to the Rust NAPI layer without precision loss.
+ */
+export declare function extractVectorBuffer(vector: Float32Array | Float64Array | Uint8Array): {
+    data: Uint8Array;
+    dtype: string;
+} | null;
 export declare function isArrowTable(value: object): value is TableLike;
 export declare function isNull(value: unknown): value is Null;
 export declare function isInt(value: unknown): value is Int;

package/dist/arrow.js

@@ -19,6 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MakeArrowTableOptions = exports.VectorColumnOptions = void 0;
 exports.isMultiVector = isMultiVector;
 exports.isIntoVector = isIntoVector;
+exports.extractVectorBuffer = extractVectorBuffer;
 exports.isArrowTable = isArrowTable;
 exports.isNull = isNull;
 exports.isInt = isInt;
@@ -67,11 +68,37 @@ __exportStar(require("apache-arrow"), exports);
 function isMultiVector(value) {
     return Array.isArray(value) && isIntoVector(value[0]);
 }
+const float16ArrayCtor = globalThis
+    .Float16Array;
 function isIntoVector(value) {
     return (value instanceof Float32Array ||
         value instanceof Float64Array ||
+        value instanceof Uint8Array ||
+        (float16ArrayCtor !== undefined && value instanceof float16ArrayCtor) ||
         (Array.isArray(value) && !Array.isArray(value[0])));
 }
+/**
+ * Extract the underlying byte buffer and data type from a typed array
+ * for passing to the Rust NAPI layer without precision loss.
+ */
+function extractVectorBuffer(vector) {
+    if (float16ArrayCtor !== undefined && vector instanceof float16ArrayCtor) {
+        return {
+            data: new Uint8Array(vector.buffer, vector.byteOffset, vector.byteLength),
+            dtype: "float16",
+        };
+    }
+    if (vector instanceof Float64Array) {
+        return {
+            data: new Uint8Array(vector.buffer, vector.byteOffset, vector.byteLength),
+            dtype: "float64",
+        };
+    }
+    if (vector instanceof Uint8Array && !(vector instanceof Float32Array)) {
+        return { data: vector, dtype: "uint8" };
+    }
+    return null;
+}
 function isArrowTable(value) {
     if (value instanceof apache_arrow_1.Table)
         return true;

package/dist/connection.d.ts

@@ -136,31 +136,31 @@ export declare abstract class Connection {
      * List all the table names in this database.
      *
      * Tables will be returned in lexicographical order.
-     * @param {string[]} namespace - The namespace to list tables from (defaults to root namespace)
+     * @param {string[]} namespacePath - The namespace path to list tables from (defaults to root namespace)
      * @param {Partial<TableNamesOptions>} options - options to control the
      * paging / start point
      *
      */
-    abstract tableNames(namespace?: string[], options?: Partial<TableNamesOptions>): Promise<string[]>;
+    abstract tableNames(namespacePath?: string[], options?: Partial<TableNamesOptions>): Promise<string[]>;
     /**
      * Open a table in the database.
      * @param {string} name - The name of the table
-     * @param {string[]} namespace - The namespace of the table (defaults to root namespace)
+     * @param {string[]} namespacePath - The namespace path of the table (defaults to root namespace)
      * @param {Partial<OpenTableOptions>} options - Additional options
      */
-    abstract openTable(name: string, namespace?: string[], options?: Partial<OpenTableOptions>): Promise<Table>;
+    abstract openTable(name: string, namespacePath?: string[], options?: Partial<OpenTableOptions>): Promise<Table>;
     /**
      * Creates a new Table and initialize it with new data.
      * @param {object} options - The options object.
      * @param {string} options.name - The name of the table.
      * @param {Data} options.data - Non-empty Array of Records to be inserted into the table
-     * @param {string[]} namespace - The namespace to create the table in (defaults to root namespace)
+     * @param {string[]} namespacePath - The namespace path to create the table in (defaults to root namespace)
      *
      */
     abstract createTable(options: {
         name: string;
         data: Data;
-    } & Partial<CreateTableOptions>, namespace?: string[]): Promise<Table>;
+    } & Partial<CreateTableOptions>, namespacePath?: string[]): Promise<Table>;
     /**
      * Creates a new Table and initialize it with new data.
      * @param {string} name - The name of the table.
@@ -174,10 +174,10 @@ export declare abstract class Connection {
      * @param {string} name - The name of the table.
      * @param {Record<string, unknown>[] | TableLike} data - Non-empty Array of Records
      * to be inserted into the table
-     * @param {string[]} namespace - The namespace to create the table in (defaults to root namespace)
+     * @param {string[]} namespacePath - The namespace path to create the table in (defaults to root namespace)
      * @param {Partial<CreateTableOptions>} options - Additional options
      */
-    abstract createTable(name: string, data: Record<string, unknown>[] | TableLike, namespace?: string[], options?: Partial<CreateTableOptions>): Promise<Table>;
+    abstract createTable(name: string, data: Record<string, unknown>[] | TableLike, namespacePath?: string[], options?: Partial<CreateTableOptions>): Promise<Table>;
     /**
      * Creates a new empty Table
      * @param {string} name - The name of the table.
@@ -189,21 +189,21 @@ export declare abstract class Connection {
      * Creates a new empty Table
      * @param {string} name - The name of the table.
      * @param {Schema} schema - The schema of the table
-     * @param {string[]} namespace - The namespace to create the table in (defaults to root namespace)
+     * @param {string[]} namespacePath - The namespace path to create the table in (defaults to root namespace)
      * @param {Partial<CreateTableOptions>} options - Additional options
      */
-    abstract createEmptyTable(name: string, schema: import("./arrow").SchemaLike, namespace?: string[], options?: Partial<CreateTableOptions>): Promise<Table>;
+    abstract createEmptyTable(name: string, schema: import("./arrow").SchemaLike, namespacePath?: string[], options?: Partial<CreateTableOptions>): Promise<Table>;
     /**
      * Drop an existing table.
      * @param {string} name The name of the table to drop.
-     * @param {string[]} namespace The namespace of the table (defaults to root namespace).
+     * @param {string[]} namespacePath The namespace path of the table (defaults to root namespace).
      */
-    abstract dropTable(name: string, namespace?: string[]): Promise<void>;
+    abstract dropTable(name: string, namespacePath?: string[]): Promise<void>;
     /**
      * Drop all tables in the database.
-     * @param {string[]} namespace The namespace to drop tables from (defaults to root namespace).
+     * @param {string[]} namespacePath The namespace path to drop tables from (defaults to root namespace).
      */
-    abstract dropAllTables(namespace?: string[]): Promise<void>;
+    abstract dropAllTables(namespacePath?: string[]): Promise<void>;
     /**
      * Clone a table from a source table.
      *
@@ -215,13 +215,13 @@ export declare abstract class Connection {
      * @param {string} targetTableName - The name of the target table to create.
      * @param {string} sourceUri - The URI of the source table to clone from.
      * @param {object} options - Clone options.
-     * @param {string[]} options.targetNamespace - The namespace for the target table (defaults to root namespace).
+     * @param {string[]} options.targetNamespacePath - The namespace path for the target table (defaults to root namespace).
      * @param {number} options.sourceVersion - The version of the source table to clone.
      * @param {string} options.sourceTag - The tag of the source table to clone.
      * @param {boolean} options.isShallow - Whether to perform a shallow clone (defaults to true).
      */
     abstract cloneTable(targetTableName: string, sourceUri: string, options?: {
-        targetNamespace?: string[];
+        targetNamespacePath?: string[];
         sourceVersion?: number;
         sourceTag?: string;
         isShallow?: boolean;
@@ -235,10 +235,10 @@ export declare class LocalConnection extends Connection {
     isOpen(): boolean;
     close(): void;
     display(): string;
-    tableNames(namespaceOrOptions?: string[] | Partial<TableNamesOptions>, options?: Partial<TableNamesOptions>): Promise<string[]>;
-    openTable(name: string, namespace?: string[], options?: Partial<OpenTableOptions>): Promise<Table>;
+    tableNames(namespacePathOrOptions?: string[] | Partial<TableNamesOptions>, options?: Partial<TableNamesOptions>): Promise<string[]>;
+    openTable(name: string, namespacePath?: string[], options?: Partial<OpenTableOptions>): Promise<Table>;
     cloneTable(targetTableName: string, sourceUri: string, options?: {
-        targetNamespace?: string[];
+        targetNamespacePath?: string[];
         sourceVersion?: number;
         sourceTag?: string;
         isShallow?: boolean;
@@ -247,11 +247,11 @@ export declare class LocalConnection extends Connection {
     createTable(nameOrOptions: string | ({
         name: string;
         data: Data;
-    } & Partial<CreateTableOptions>), dataOrNamespace?: Record<string, unknown>[] | TableLike | string[], namespaceOrOptions?: string[] | Partial<CreateTableOptions>, options?: Partial<CreateTableOptions>): Promise<Table>;
+    } & Partial<CreateTableOptions>), dataOrNamespacePath?: Record<string, unknown>[] | TableLike | string[], namespacePathOrOptions?: string[] | Partial<CreateTableOptions>, options?: Partial<CreateTableOptions>): Promise<Table>;
     private _createTableImpl;
-    createEmptyTable(name: string, schema: import("./arrow").SchemaLike, namespaceOrOptions?: string[] | Partial<CreateTableOptions>, options?: Partial<CreateTableOptions>): Promise<Table>;
-    dropTable(name: string, namespace?: string[]): Promise<void>;
-    dropAllTables(namespace?: string[]): Promise<void>;
+    createEmptyTable(name: string, schema: import("./arrow").SchemaLike, namespacePathOrOptions?: string[] | Partial<CreateTableOptions>, options?: Partial<CreateTableOptions>): Promise<Table>;
+    dropTable(name: string, namespacePath?: string[]): Promise<void>;
+    dropAllTables(namespacePath?: string[]): Promise<void>;
 }
 /**
  * Takes storage options and makes all the keys snake case.

package/dist/connection.js

@@ -51,28 +51,28 @@ class LocalConnection extends Connection {
     display() {
         return this.inner.display();
     }
-    async tableNames(namespaceOrOptions, options) {
-        // Detect if first argument is namespace array or options object
-        let namespace;
+    async tableNames(namespacePathOrOptions, options) {
+        // Detect if first argument is namespacePath array or options object
+        let namespacePath;
         let tableNamesOptions;
-        if (Array.isArray(namespaceOrOptions)) {
-            // First argument is namespace array
-            namespace = namespaceOrOptions;
+        if (Array.isArray(namespacePathOrOptions)) {
+            // First argument is namespacePath array
+            namespacePath = namespacePathOrOptions;
             tableNamesOptions = options;
         }
         else {
             // First argument is options object (backwards compatibility)
-            namespace = undefined;
-            tableNamesOptions = namespaceOrOptions;
+            namespacePath = undefined;
+            tableNamesOptions = namespacePathOrOptions;
         }
-        return this.inner.tableNames(namespace ?? [], tableNamesOptions?.startAfter, tableNamesOptions?.limit);
+        return this.inner.tableNames(namespacePath ?? [], tableNamesOptions?.startAfter, tableNamesOptions?.limit);
     }
-    async openTable(name, namespace, options) {
-        const innerTable = await this.inner.openTable(name, namespace ?? [], cleanseStorageOptions(options?.storageOptions), options?.indexCacheSize);
+    async openTable(name, namespacePath, options) {
+        const innerTable = await this.inner.openTable(name, namespacePath ?? [], cleanseStorageOptions(options?.storageOptions), options?.indexCacheSize);
         return new table_1.LocalTable(innerTable);
     }
     async cloneTable(targetTableName, sourceUri, options) {
-        const innerTable = await this.inner.cloneTable(targetTableName, sourceUri, options?.targetNamespace ?? [], options?.sourceVersion ?? null, options?.sourceTag ?? null, options?.isShallow ?? true);
+        const innerTable = await this.inner.cloneTable(targetTableName, sourceUri, options?.targetNamespacePath ?? [], options?.sourceVersion ?? null, options?.sourceTag ?? null, options?.isShallow ?? true);
         return new table_1.LocalTable(innerTable);
     }
     getStorageOptions(options) {
@@ -92,53 +92,53 @@ class LocalConnection extends Connection {
         }
         return cleanseStorageOptions(options?.storageOptions);
     }
-    async createTable(nameOrOptions, dataOrNamespace, namespaceOrOptions, options) {
+    async createTable(nameOrOptions, dataOrNamespacePath, namespacePathOrOptions, options) {
         if (typeof nameOrOptions !== "string" && "name" in nameOrOptions) {
-            // First overload: createTable(options, namespace?)
+            // First overload: createTable(options, namespacePath?)
             const { name, data, ...createOptions } = nameOrOptions;
-            const namespace = dataOrNamespace;
-            return this._createTableImpl(name, data, namespace, createOptions);
+            const namespacePath = dataOrNamespacePath;
+            return this._createTableImpl(name, data, namespacePath, createOptions);
         }
-        // Second overload: createTable(name, data, namespace?, options?)
+        // Second overload: createTable(name, data, namespacePath?, options?)
         const name = nameOrOptions;
-        const data = dataOrNamespace;
-        // Detect if third argument is namespace array or options object
-        let namespace;
+        const data = dataOrNamespacePath;
+        // Detect if third argument is namespacePath array or options object
+        let namespacePath;
         let createOptions;
-        if (Array.isArray(namespaceOrOptions)) {
-            // Third argument is namespace array
-            namespace = namespaceOrOptions;
+        if (Array.isArray(namespacePathOrOptions)) {
+            // Third argument is namespacePath array
+            namespacePath = namespacePathOrOptions;
             createOptions = options;
         }
         else {
             // Third argument is options object (backwards compatibility)
-            namespace = undefined;
-            createOptions = namespaceOrOptions;
+            namespacePath = undefined;
+            createOptions = namespacePathOrOptions;
         }
-        return this._createTableImpl(name, data, namespace, createOptions);
+        return this._createTableImpl(name, data, namespacePath, createOptions);
     }
-    async _createTableImpl(name, data, namespace, options) {
+    async _createTableImpl(name, data, namespacePath, options) {
         if (data === undefined) {
             throw new Error("data is required");
         }
         const { buf, mode } = await parseTableData(data, options);
         const storageOptions = this.getStorageOptions(options);
-        const innerTable = await this.inner.createTable(name, buf, mode, namespace ?? [], storageOptions);
+        const innerTable = await this.inner.createTable(name, buf, mode, namespacePath ?? [], storageOptions);
         return new table_1.LocalTable(innerTable);
     }
-    async createEmptyTable(name, schema, namespaceOrOptions, options) {
-        // Detect if third argument is namespace array or options object
-        let namespace;
+    async createEmptyTable(name, schema, namespacePathOrOptions, options) {
+        // Detect if third argument is namespacePath array or options object
+        let namespacePath;
         let createOptions;
-        if (Array.isArray(namespaceOrOptions)) {
-            // Third argument is namespace array
-            namespace = namespaceOrOptions;
+        if (Array.isArray(namespacePathOrOptions)) {
+            // Third argument is namespacePath array
+            namespacePath = namespacePathOrOptions;
             createOptions = options;
         }
         else {
             // Third argument is options object (backwards compatibility)
-            namespace = undefined;
-            createOptions = namespaceOrOptions;
+            namespacePath = undefined;
+            createOptions = namespacePathOrOptions;
         }
         let mode = createOptions?.mode ?? "create";
         const existOk = createOptions?.existOk ?? false;
@@ -154,14 +154,14 @@ class LocalConnection extends Connection {
         const storageOptions = this.getStorageOptions(createOptions);
         const table = (0, arrow_2.makeEmptyTable)(schema, metadata);
         const buf = await (0, arrow_2.fromTableToBuffer)(table);
-        const innerTable = await this.inner.createEmptyTable(name, buf, mode, namespace ?? [], storageOptions);
+        const innerTable = await this.inner.createEmptyTable(name, buf, mode, namespacePath ?? [], storageOptions);
         return new table_1.LocalTable(innerTable);
     }
-    async dropTable(name, namespace) {
-        return this.inner.dropTable(name, namespace ?? []);
+    async dropTable(name, namespacePath) {
+        return this.inner.dropTable(name, namespacePath ?? []);
     }
-    async dropAllTables(namespace) {
-        return this.inner.dropAllTables(namespace ?? []);
+    async dropAllTables(namespacePath) {
+        return this.inner.dropAllTables(namespacePath ?? []);
     }
 }
 exports.LocalConnection = LocalConnection;

package/dist/native.d.ts

@@ -7,7 +7,7 @@ export declare class Connection {
   isOpen(): boolean
   close(): void
   /** List all tables in the dataset. */
-  tableNames(namespace: Array<string>, startAfter?: string | undefined | null, limit?: number | undefined | null): Promise<Array<string>>
+  tableNames(namespacePath?: Array<string> | undefined | null, startAfter?: string | undefined | null, limit?: number | undefined | null): Promise<Array<string>>
   /**
    * Create table from a Apache Arrow IPC (file) buffer.
    *
@@ -15,13 +15,13 @@ export declare class Connection {
    * - name: The name of the table.
    * - buf: The buffer containing the IPC file.
    */
-  createTable(name: string, buf: Buffer, mode: string, namespace: Array<string>, storageOptions?: Record<string, string> | undefined | null): Promise<Table>
-  createEmptyTable(name: string, schemaBuf: Buffer, mode: string, namespace: Array<string>, storageOptions?: Record<string, string> | undefined | null): Promise<Table>
-  openTable(name: string, namespace: Array<string>, storageOptions?: Record<string, string> | undefined | null, indexCacheSize?: number | undefined | null): Promise<Table>
-  cloneTable(targetTableName: string, sourceUri: string, targetNamespace: Array<string>, sourceVersion: number | undefined | null, sourceTag: string | undefined | null, isShallow: boolean): Promise<Table>
+  createTable(name: string, buf: Buffer, mode: string, namespacePath?: Array<string> | undefined | null, storageOptions?: Record<string, string> | undefined | null): Promise<Table>
+  createEmptyTable(name: string, schemaBuf: Buffer, mode: string, namespacePath?: Array<string> | undefined | null, storageOptions?: Record<string, string> | undefined | null): Promise<Table>
+  openTable(name: string, namespacePath?: Array<string> | undefined | null, storageOptions?: Record<string, string> | undefined | null, indexCacheSize?: number | undefined | null): Promise<Table>
+  cloneTable(targetTableName: string, sourceUri: string, targetNamespacePath: Array<string> | undefined | null, sourceVersion: number | undefined | null, sourceTag: string | undefined | null, isShallow: boolean): Promise<Table>
   /** Drop table with the name. Or raise an error if the table does not exist. */
-  dropTable(name: string, namespace: Array<string>): Promise<void>
-  dropAllTables(namespace: Array<string>): Promise<void>
+  dropTable(name: string, namespacePath?: Array<string> | undefined | null): Promise<void>
+  dropAllTables(namespacePath?: Array<string> | undefined | null): Promise<void>
 }
 
 export declare class Index {
@@ -91,6 +91,7 @@ export declare class Query {
   limit(limit: number): void
   offset(offset: number): void
   nearestTo(vector: Float32Array): VectorQuery
+  nearestToRaw(data: Uint8Array, dtype: string): VectorQuery
   fastSearch(): void
   withRowId(): void
   outputSchema(): Promise<Buffer>
@@ -213,6 +214,7 @@ export declare class TakeQuery {
 export declare class VectorQuery {
   column(column: string): void
   addQueryVector(vector: Float32Array): void
+  addQueryVectorRaw(data: Uint8Array, dtype: string): void
   distanceType(distanceType: string): void
   postfilter(): void
   refineFactor(refineFactor: number): void

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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+            if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                    if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 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.27.2-beta.1' && 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.27.2-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
+                if (bindingPackageVersion !== '0.28.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.28.0-beta.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
                 }
                 return binding;
             }

package/dist/query.js

@@ -556,10 +556,8 @@ class VectorQuery extends StandardQueryBase {
             const res = (async () => {
                 try {
                     const v = await vector;
-                    const arr = Float32Array.from(v);
-                    //
                     // biome-ignore lint/suspicious/noExplicitAny: we need to get the `inner`, but js has no package scoping
-                    const value = this.addQueryVector(arr);
+                    const value = this.addQueryVector(v);
                     const inner = value.inner;
                     return inner;
                 }
@@ -571,7 +569,13 @@ class VectorQuery extends StandardQueryBase {
         }
         else {
             super.doCall((inner) => {
-                inner.addQueryVector(Float32Array.from(vector));
+                const raw = Array.isArray(vector) ? null : (0, arrow_1.extractVectorBuffer)(vector);
+                if (raw) {
+                    inner.addQueryVectorRaw(raw.data, raw.dtype);
+                }
+                else {
+                    inner.addQueryVector(Float32Array.from(vector));
+                }
             });
             return this;
         }
@@ -650,15 +654,19 @@ class Query extends StandardQueryBase {
      * a default `limit` of 10 will be used.  @see {@link Query#limit}
      */
     nearestTo(vector) {
+        const callNearestTo = (inner, resolved) => {
+            const raw = Array.isArray(resolved)
+                ? null
+                : (0, arrow_1.extractVectorBuffer)(resolved);
+            if (raw) {
+                return inner.nearestToRaw(raw.data, raw.dtype);
+            }
+            return inner.nearestTo(Float32Array.from(resolved));
+        };
         if (this.inner instanceof Promise) {
             const nativeQuery = this.inner.then(async (inner) => {
-                if (vector instanceof Promise) {
-                    const arr = await vector.then((v) => Float32Array.from(v));
-                    return inner.nearestTo(arr);
-                }
-                else {
-                    return inner.nearestTo(Float32Array.from(vector));
-                }
+                const resolved = vector instanceof Promise ? await vector : vector;
+                return callNearestTo(inner, resolved);
             });
             return new VectorQuery(nativeQuery);
         }
@@ -666,10 +674,8 @@ class Query extends StandardQueryBase {
             const res = (async () => {
                 try {
                     const v = await vector;
-                    const arr = Float32Array.from(v);
-                    //
                     // biome-ignore lint/suspicious/noExplicitAny: we need to get the `inner`, but js has no package scoping
-                    const value = this.nearestTo(arr);
+                    const value = this.nearestTo(v);
                     const inner = value.inner;
                     return inner;
                 }
@@ -680,7 +686,7 @@ class Query extends StandardQueryBase {
             return new VectorQuery(res);
         }
         else {
-            const vectorQuery = this.inner.nearestTo(Float32Array.from(vector));
+            const vectorQuery = callNearestTo(this.inner, vector);
             return new VectorQuery(vectorQuery);
         }
     }

package/package.json

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