@lancedb/lancedb 0.40.0-beta.1 → 0.40.0-beta.10

package/dist/connection.d.ts

@@ -4,6 +4,7 @@ import { Job } from "./job";
 import { MaterializedView, MaterializedViewSelect } from "./materialized_view";
 import { Connection as LanceDbConnection } from "./native";
 import type { CreateNamespaceResponse, DescribeNamespaceResponse, DropNamespaceResponse, JobInfo, ListNamespacesResponse, ListTablesResponse } from "./native";
+import { ViewDescription } from "./view";
 export type { CreateNamespaceResponse, DescribeNamespaceResponse, DropNamespaceResponse, ListNamespacesResponse, ListTablesResponse, };
 import { Table } from "./table";
 export interface CreateTableOptions {
@@ -298,6 +299,43 @@ export declare abstract class Connection {
      * Rejects a table that exists but is not a materialized view.
      */
     abstract dropMaterializedViewAsync(name: string, namespacePath?: string[]): Promise<Job>;
+    /**
+     * Create a view: a named query the database plans on every read.
+     *
+     * The query is planned once, at creation, so one that cannot be planned is
+     * rejected now rather than at the first read. A view holds no rows, and its
+     * readers see its sources as they are at read time.
+     *
+     * There is no replace: a name already taken is an error, and changing a
+     * view is a drop followed by a create.
+     */
+    abstract createView(name: string, query: string, namespacePath?: string[]): Promise<ViewDescription>;
+    /**
+     * What this database records about the view named `name`: its defining
+     * query and the schema that query resolved to.
+     */
+    abstract describeView(name: string, namespacePath?: string[]): Promise<ViewDescription>;
+    /**
+     * Drop the view named `name` and wait for its definition to be deleted.
+     *
+     * The tables it reads are untouched: a view holds no rows of its own. Use
+     * {@link dropViewAsync} to retain the cleanup job instead of waiting on it.
+     */
+    abstract dropView(name: string, namespacePath?: string[]): Promise<void>;
+    /**
+     * Start dropping the view named `name` and return the job deleting its
+     * definition, without waiting for completion.
+     *
+     * The name is free before this resolves. When nothing was bound to it, the
+     * returned job is already finished and has no id.
+     */
+    abstract dropViewAsync(name: string, namespacePath?: string[]): Promise<Job>;
+    /**
+     * The names of the views in one namespace.
+     *
+     * Names only; a definition comes from {@link describeView}.
+     */
+    abstract listViews(namespacePath?: string[]): Promise<string[]>;
     abstract openTable(name: string, namespacePath?: string[], options?: Partial<OpenTableOptions>): Promise<Table>;
     /**
      * Creates a new Table and initialize it with new data.
@@ -483,6 +521,11 @@ export declare class LocalConnection extends Connection {
     listMaterializedViews(): Promise<string[]>;
     dropMaterializedView(name: string, namespacePath?: string[]): Promise<void>;
     dropMaterializedViewAsync(name: string, namespacePath?: string[]): Promise<Job>;
+    createView(name: string, query: string, namespacePath?: string[]): Promise<ViewDescription>;
+    describeView(name: string, namespacePath?: string[]): Promise<ViewDescription>;
+    dropView(name: string, namespacePath?: string[]): Promise<void>;
+    dropViewAsync(name: string, namespacePath?: string[]): Promise<Job>;
+    listViews(namespacePath?: string[]): Promise<string[]>;
     listTables(namespacePathOrOptions?: string[] | Partial<ListTablesOptions>, options?: Partial<ListTablesOptions>): Promise<ListTablesResponse>;
     openTable(name: string, namespacePath?: string[], options?: Partial<OpenTableOptions>): Promise<Table>;
     cloneTable(targetTableName: string, sourceUri: string, options?: {

package/dist/connection.js

@@ -9,6 +9,7 @@ const arrow_2 = require("./arrow");
 const registry_1 = require("./embedding/registry");
 const job_1 = require("./job");
 const materialized_view_1 = require("./materialized_view");
+const view_1 = require("./view");
 const sanitize_1 = require("./sanitize");
 const table_1 = require("./table");
 /**
@@ -87,6 +88,21 @@ class LocalConnection extends Connection {
     async dropMaterializedViewAsync(name, namespacePath) {
         return new job_1.Job(await this.inner.dropMaterializedViewAsync(name, namespacePath ?? []));
     }
+    async createView(name, query, namespacePath) {
+        return (0, view_1.viewDescriptionFromNative)(await this.inner.createView(name, query, namespacePath ?? []));
+    }
+    async describeView(name, namespacePath) {
+        return (0, view_1.viewDescriptionFromNative)(await this.inner.describeView(name, namespacePath ?? []));
+    }
+    async dropView(name, namespacePath) {
+        return this.inner.dropView(name, namespacePath ?? []);
+    }
+    async dropViewAsync(name, namespacePath) {
+        return new job_1.Job(await this.inner.dropViewAsync(name, namespacePath ?? []));
+    }
+    async listViews(namespacePath) {
+        return this.inner.listViews(namespacePath ?? []);
+    }
     async listTables(namespacePathOrOptions, options) {
         // Detect if first argument is namespacePath array or options object
         const namespacePath = Array.isArray(namespacePathOrOptions)

package/dist/index.d.ts

@@ -4,9 +4,10 @@ import { HeaderProvider } from "./header";
 import type { BaseTokenizer } from "./indices";
 import type { FtsToken } from "./table";
 export { MaterializedView, MaterializedViewDefinition, MaterializedViewSelect, } from "./materialized_view";
+export { ViewDescription } from "./view";
 export { JsHeaderProvider as NativeJsHeaderProvider } from "./native.js";
 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 { AddColumnsSql, ConnectionOptions, ConnectNamespaceOptions, IndexStatistics, IndexConfig, ClientConfig, TimeoutConfig, RetryConfig, TlsConfig, OptimizeStats, CompactionStats, RemovalStats, TableStatistics, FragmentStatistics, FragmentSummaryStats, Tags, TagContents, BranchContents, MergeResult, AddResult, AddColumnsResult, RefreshColumnResult, FunctionErrors, FunctionErrorsOptions, FunctionErrorRecord, FunctionErrorFragment, RefreshMaterializedViewResult, AlterColumnsResult, UpdateFieldMetadataResult, DeleteResult, DropColumnsResult, UpdateResult, SplitCalculatedOptions, SplitRandomOptions, SplitHashOptions, SplitSequentialOptions, ShuffleOptions, OAuthConfig as NativeOAuthConfig, } from "./native.js";
 export { makeArrowTable, makeJsonField, MakeArrowTableOptions, Data, VectorColumnOptions, } from "./arrow";
 export { blob, isBlobField, BlobFile } from "./blob";
 export type { BlobOptions } from "./blob";

package/dist/materialized_view.d.ts

@@ -2,20 +2,20 @@ import { RefreshMaterializedViewResult } from "./native";
 import { Table } from "./table";
 /** Schema metadata key holding a materialized view's definition. */
 export declare const DEFINITION_META_KEY = "mv.definition";
-/** The query that defines a materialized view. */
+/**
+ * The newest stored layout this version reads: `{"format": N, "query": "<SQL>"}`,
+ * format 2 being a query with `GROUP BY`.
+ */
+export declare const DEFINITION_FORMAT = 2;
+/**
+ * The query that defines a materialized view, as stored:
+ * `SELECT columns FROM [ns.]table [, function(args) AS alias | , UNNEST(column) AS alias]
+ * [WHERE predicate] [GROUP BY expr, ...] [LIMIT n]`. A Function in `FROM`
+ * position yields one row per element it returns.
+ */
 export interface MaterializedViewDefinition {
-    /** Name of the source table, in the same database as the view. */
-    sourceTable: string;
-    /** `[output column, SQL expression]` pairs, in view schema order. */
-    projections: [string, string][];
-    /** SQL predicate selecting the source rows the view holds. */
-    filter?: string;
-    /** Cap on the number of rows the view holds. */
-    limit?: number;
-    /** Source columns the projections and filter read. */
-    inputs: string[];
-    /** Namespace holding the source table; empty is the root namespace. */
-    sourceNamespace: string[];
+    /** The defining query, in the canonical spelling the server stores. */
+    query: string;
 }
 /**
  * The view's columns: column names, `[alias, SQL expression]` pairs, or a

package/dist/materialized_view.js

@@ -2,13 +2,18 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: Copyright The LanceDB Authors
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MaterializedView = exports.DEFINITION_META_KEY = void 0;
+exports.MaterializedView = exports.DEFINITION_FORMAT = exports.DEFINITION_META_KEY = void 0;
 exports.validateNonNegativeInteger = validateNonNegativeInteger;
 exports.normalizeSelect = normalizeSelect;
 exports.definitionFromMetadata = definitionFromMetadata;
 exports.definitionFromJson = definitionFromJson;
 /** Schema metadata key holding a materialized view's definition. */
 exports.DEFINITION_META_KEY = "mv.definition";
+/**
+ * The newest stored layout this version reads: `{"format": N, "query": "<SQL>"}`,
+ * format 2 being a query with `GROUP BY`.
+ */
+exports.DEFINITION_FORMAT = 2;
 /**
  * @internal Reject a numeric option N-API would otherwise silently coerce:
  * `Infinity` reaches Rust as 0, `1.5` as 1.
@@ -49,12 +54,18 @@ function definitionFromMetadata(metadata, name) {
 function definitionFromJson(raw, name) {
     // biome-ignore lint/suspicious/noExplicitAny: raw JSON
     const value = JSON.parse(raw);
-    // "namespaced_select" keeps older readers from resolving the source at root.
-    if (value.kind !== undefined &&
-        value.kind !== "select" &&
-        value.kind !== "namespaced_select") {
-        throw new Error(`materialized view '${name}' is defined by '${value.kind}', which this ` +
-            "version of lancedb cannot refresh");
+    if (value.format !== undefined) {
+        // A newer writer's layout is reported, never guessed at.
+        if (!Number.isInteger(value.format) || value.format > exports.DEFINITION_FORMAT) {
+            throw new Error(`materialized view '${name}' is stored in format ${value.format}, ` +
+                "which this version of lancedb cannot refresh");
+        }
+        return { query: value.query };
+    }
+    // The structured layout written before the format number.
+    if (value.kind !== "select" && value.kind !== "namespaced_select") {
+        throw new Error(`materialized view '${name}' is stored in format kind '${value.kind}', ` +
+            "which this version of lancedb cannot refresh");
     }
     const limit = value.limit ?? undefined;
     // JSON.parse rounds integers past 2^53; every exact u64 parses to a safe
@@ -63,18 +74,36 @@ function definitionFromJson(raw, name) {
     if (limit !== undefined && !Number.isSafeInteger(limit)) {
         throw new Error(`materialized view '${name}' has a stored limit too large to represent exactly`);
     }
-    return {
-        sourceTable: value.source_table,
-        // biome-ignore lint/suspicious/noExplicitAny: raw JSON
-        projections: (value.projections ?? []).map((p) => [
-            p.output,
-            p.expression,
-        ]),
-        filter: value.filter ?? undefined,
-        limit,
-        inputs: value.inputs ?? [],
-        sourceNamespace: value.source_namespace ?? [],
-    };
+    return { query: legacyQuery(value, limit) };
+}
+function legacyIdent(name) {
+    return /^[a-z_][a-z0-9_]*$/.test(name)
+        ? name
+        : `\`${name.replace(/`/g, "``")}\``;
+}
+/** Render the pre-format structured layout as the query it described. */
+// biome-ignore lint/suspicious/noExplicitAny: raw JSON
+function legacyQuery(value, limit) {
+    // biome-ignore lint/suspicious/noExplicitAny: raw JSON
+    const projections = value.projections ?? [];
+    const columns = projections.length === 0
+        ? "*"
+        : projections
+            .map((p) => p.expression === p.output || p.expression === `\`${p.output}\``
+            ? p.expression
+            : `${p.expression} AS ${legacyIdent(p.output)}`)
+            .join(", ");
+    const table = [...(value.source_namespace ?? []), value.source_table]
+        .map(legacyIdent)
+        .join(".");
+    let query = `SELECT ${columns} FROM ${table}`;
+    if (value.filter !== undefined && value.filter !== null) {
+        query += ` WHERE ${value.filter}`;
+    }
+    if (limit !== undefined) {
+        query += ` LIMIT ${limit}`;
+    }
+    return query;
 }
 /**
  * A handle on a materialized view: its table plus its definition.

package/dist/native.d.ts

@@ -56,6 +56,19 @@ export declare class Connection {
   listMaterializedViews(): Promise<Array<string>>
   /** Drop a materialized view. */
   dropMaterializedView(name: string, namespacePath?: Array<string> | undefined | null): Promise<void>
+  /** Create a view: a named query planned on every read. */
+  createView(name: string, query: string, namespacePath?: Array<string> | undefined | null): Promise<ViewDescription>
+  /** What the database records about one view. */
+  describeView(name: string, namespacePath?: Array<string> | undefined | null): Promise<ViewDescription>
+  /**
+   * Drop a view and wait for its definition to be deleted. The tables it
+   * reads are untouched.
+   */
+  dropView(name: string, namespacePath?: Array<string> | undefined | null): Promise<void>
+  /** Start dropping a view and return the job deleting its definition. */
+  dropViewAsync(name: string, namespacePath?: Array<string> | undefined | null): Promise<Job>
+  /** The names of the views in one namespace. */
+  listViews(namespacePath?: Array<string> | undefined | null): Promise<Array<string>>
   /** Start dropping a materialized view and return its cleanup job. */
   dropMaterializedViewAsync(name: string, namespacePath?: Array<string> | undefined | null): Promise<Job>
   openTable(name: string, namespacePath?: Array<string> | undefined | null, storageOptions?: Record<string, string> | undefined | null, indexCacheSize?: number | undefined | null): Promise<Table>
@@ -381,6 +394,7 @@ export declare class Table {
   addComputedColumns(columns: Array<AddColumnsSql>): Promise<AddColumnsResult>
   refreshColumn(column: string): Promise<RefreshColumnResult>
   refreshColumnAsync(column: string): Promise<Job>
+  functionErrors(options?: FunctionErrorsOptions | undefined | null): Promise<FunctionErrors>
   refreshMaterializedView(full?: boolean | undefined | null, sourceVersion?: number | undefined | null): Promise<RefreshMaterializedViewResult>
   materializedViewDefinition(): Promise<string>
   addColumnsWithSchema(schemaBuf: Buffer): Promise<AddColumnsResult>
@@ -546,6 +560,11 @@ export interface ClientConfig {
   retryConfig?: RetryConfig
   timeoutConfig?: TimeoutConfig
   extraHeaders?: Record<string, string>
+  /**
+   * The delimiter joining a namespace path and a name into one object
+   * identifier. `"$"` is the only supported value, and leaving this unset is
+   * how to get it; anything else is rejected when the connection is created.
+   */
   idDelimiter?: string
   tlsConfig?: TlsConfig
   /**
@@ -773,6 +792,55 @@ export interface FtsToken {
   position: number
 }
 
+/**
+ * A fragment whose per-row error detail was capped: `rowsSkipped` rows
+ * failed, of which only `rowsRecorded` have a record of their own.
+ */
+export interface FunctionErrorFragment {
+  jobId: string
+  fragmentId: number
+  rowsSkipped: number
+  rowsRecorded: number
+}
+
+/** One row a Function refresh skipped, as the server recorded it. */
+export interface FunctionErrorRecord {
+  jobId: string
+  fragmentId: number
+  /**
+   * The row's offset within the fragment; absent when the fragment's
+   * detail was capped.
+   */
+  rowOffset?: number
+  column: string
+  function: string
+  functionVersion: string
+  tableVersion: number
+  errorType: string
+  errorMessage: string
+  createdAtMillis: number
+}
+
+/** A table's per-row Function errors. */
+export interface FunctionErrors {
+  /** The recorded rows, newest job first. */
+  records: Array<FunctionErrorRecord>
+  /** Fragments whose detail was capped. */
+  fragments: Array<FunctionErrorFragment>
+  /** Whether the listing stopped at its limit. */
+  truncated: boolean
+}
+
+/** Which per-row Function errors to list; every filter is optional. */
+export interface FunctionErrorsOptions {
+  /** Only errors recorded by this job. */
+  jobId?: string
+  /** Only errors on this column. */
+  column?: string
+  /** At most this many records (server default 10000, cap 100000). */
+  limit?: number
+}
+
 /** One flushed L0 generation. */
 export interface GenerationStats {
   /** The generation number. Increases as memtables are sealed into L0. */
@@ -1339,6 +1407,20 @@ export interface Version {
   metadata: Record<string, string>
 }
 
+/** What a database records about one view. */
+export interface ViewDescription {
+  name: string
+  namespacePath: Array<string>
+  query: string
+  defaultDatabase: string
+  defaultNamespacePath: Array<string>
+  /**
+   * The view's schema as an empty Arrow IPC file, the way a table reports
+   * its own.
+   */
+  schema: Buffer
+}
+
 /**
  * Progress snapshot for a write operation, delivered to the JS callback
  * passed to `Table.add`.

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

package/dist/schema.js

@@ -35,6 +35,7 @@ class SchemaInferrer {
             : new apache_arrow_1.Schema(matchingFields(this.providedSchema.fields, this.fields));
     }
     observe(path, value, row) {
+        assertSupportedValue(value, path.join("."), row);
         const current = this.fields.get(path);
         if (current === undefined) {
             this.addField(path, value, row);
@@ -293,15 +294,43 @@ function* recordPathsAndValues(record, path = []) {
     }
 }
 function isRecord(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        !Array.isArray(value) &&
-        !(value instanceof RegExp) &&
-        !(value instanceof Date) &&
-        !(value instanceof Set) &&
-        !(value instanceof Map) &&
-        !(value instanceof Buffer) &&
-        !ArrayBuffer.isView(value));
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return ((prototype === Object.prototype || prototype === null) &&
+        Object.keys(value).length > 0);
+}
+function isUnsupportedObject(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value) ||
+        isRecord(value)) {
+        return false;
+    }
+    // Preserve the object types already passed through to Arrow. Other objects
+    // must not disappear while walking struct fields.
+    return !(value instanceof RegExp ||
+        value instanceof Date ||
+        value instanceof Set ||
+        value instanceof Map ||
+        Buffer.isBuffer(value) ||
+        ArrayBuffer.isView(value));
+}
+function assertSupportedValue(value, field, row) {
+    if (Array.isArray(value)) {
+        for (const [index, item] of value.entries()) {
+            assertSupportedValue(item, `${field}[${index}]`, row);
+        }
+    }
+    else if (isRecord(value)) {
+        for (const [name, child] of Object.entries(value)) {
+            assertSupportedValue(child, `${field}.${name}`, row);
+        }
+    }
+    else if (isUnsupportedObject(value)) {
+        throw new Error(`Unsupported object value for field ${field} at row ${row}.`);
+    }
 }
 function fieldAtPath(schema, path) {
     let fields = schema.fields;

package/dist/table.d.ts

@@ -3,7 +3,7 @@ import { BlobFile } from "./blob";
 import { IndexOptions } from "./indices";
 import { Job } from "./job";
 import { MergeInsertBuilder } from "./merge";
-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 { AddColumnsResult, AddColumnsSql, AddResult, AlterColumnsResult, BranchContents, DeleteResult, DropColumnsResult, FunctionErrors, FunctionErrorsOptions, 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";
@@ -517,6 +517,24 @@ export declare abstract class Table {
      * ```
      */
     abstract refreshColumnAsync(column: string): Promise<Job>;
+    /**
+     * The per-row errors Function refreshes recorded on this table.
+     *
+     * A refresh running under a skip policy records each row it skipped with
+     * the input that failed and the error. This lists those records, newest
+     * job first, plus a summary for any fragment whose per-row detail was
+     * capped. LanceDB Cloud and Enterprise only; reading errors needs read
+     * access to the table, since a message carries the value that failed.
+     * @param {FunctionErrorsOptions} options Optional filters: `jobId`,
+     * `column`, and `limit` (server default 10000, cap 100000).
+     * @returns {Promise<FunctionErrors>} The records, the capped fragments,
+     * and whether the listing stopped at its limit.
+     * @example
+     * ```ts
+     * const { records, truncated } = await table.functionErrors({ column: "embedding" });
+     * ```
+     */
+    abstract functionErrors(options?: FunctionErrorsOptions): Promise<FunctionErrors>;
     /**
      * Recompute this table's contents from its materialized-view definition.
      *
@@ -896,6 +914,7 @@ export declare class LocalTable extends Table {
     }): Promise<AddColumnsResult>;
     refreshColumn(column: string): Promise<RefreshColumnResult>;
     refreshColumnAsync(column: string): Promise<Job>;
+    functionErrors(options?: FunctionErrorsOptions): Promise<FunctionErrors>;
     refreshMaterializedView(full?: boolean, sourceVersion?: number): Promise<RefreshMaterializedViewResult>;
     materializedViewDefinition(): Promise<string>;
     alterColumns(columnAlterations: ColumnAlteration[]): Promise<AlterColumnsResult>;

package/dist/table.js

@@ -7,6 +7,7 @@ const arrow_1 = require("./arrow");
 const blob_1 = require("./blob");
 const registry_1 = require("./embedding/registry");
 const job_1 = require("./job");
+const materialized_view_1 = require("./materialized_view");
 const merge_1 = require("./merge");
 const query_1 = require("./query");
 const sanitize_1 = require("./sanitize");
@@ -275,6 +276,10 @@ class LocalTable extends Table {
     async refreshColumnAsync(column) {
         return new job_1.Job(await this.inner.refreshColumnAsync(column));
     }
+    async functionErrors(options) {
+        (0, materialized_view_1.validateNonNegativeInteger)(options?.limit, "limit");
+        return await this.inner.functionErrors(options);
+    }
     async refreshMaterializedView(full, sourceVersion) {
         return await this.inner.refreshMaterializedView(full, sourceVersion);
     }

package/dist/view.d.ts

@@ -0,0 +1,32 @@
+import { Schema } from "apache-arrow";
+import { ViewDescription as NativeViewDescription } from "./native";
+/**
+ * What a database records about one view.
+ *
+ * A view holds no rows: it stores the statement that defines it and the
+ * schema that statement resolved to, so a reader sees its sources as they
+ * are at read time.
+ */
+export interface ViewDescription {
+    /** The view's name within its namespace. */
+    name: string;
+    /** The namespace holding the view; empty is the root namespace. */
+    namespacePath: string[];
+    /** The defining query, as the database stores it. */
+    query: string;
+    /** The database that unqualified table names in {@link query} resolve against. */
+    defaultDatabase: string;
+    /**
+     * The namespace path those unqualified names resolve against; empty is the
+     * root namespace.
+     *
+     * Recorded with the view because it outlives the session that declared it:
+     * a reader resolving the query against its own default namespace could read
+     * a different table than the view was defined over.
+     */
+    defaultNamespacePath: string[];
+    /** The schema the defining query resolved to when the view was created. */
+    schema: Schema;
+}
+/** Decode the schema the binding hands over as an Arrow IPC file. */
+export declare function viewDescriptionFromNative(view: NativeViewDescription): ViewDescription;

package/dist/view.js

@@ -0,0 +1,17 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright The LanceDB Authors
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewDescriptionFromNative = viewDescriptionFromNative;
+const apache_arrow_1 = require("apache-arrow");
+/** Decode the schema the binding hands over as an Arrow IPC file. */
+function viewDescriptionFromNative(view) {
+    return {
+        name: view.name,
+        namespacePath: view.namespacePath,
+        query: view.query,
+        defaultDatabase: view.defaultDatabase,
+        defaultNamespacePath: view.defaultNamespacePath,
+        schema: (0, apache_arrow_1.tableFromIPC)(view.schema).schema,
+    };
+}

package/package.json

@@ -11,7 +11,7 @@
     "ann"
   ],
   "private": false,
-  "version": "0.40.0-beta.1",
+  "version": "0.40.0-beta.10",
   "main": "dist/index.js",
   "exports": {
     ".": "./dist/index.js",
@@ -106,13 +106,13 @@
   "optionalDependencies": {
     "@huggingface/transformers": "3.0.2",
     "openai": "4.29.2",
-    "@lancedb/lancedb-darwin-arm64": "0.40.0-beta.1",
-    "@lancedb/lancedb-linux-x64-gnu": "0.40.0-beta.1",
-    "@lancedb/lancedb-linux-arm64-gnu": "0.40.0-beta.1",
-    "@lancedb/lancedb-linux-x64-musl": "0.40.0-beta.1",
-    "@lancedb/lancedb-linux-arm64-musl": "0.40.0-beta.1",
-    "@lancedb/lancedb-win32-x64-msvc": "0.40.0-beta.1",
-    "@lancedb/lancedb-win32-arm64-msvc": "0.40.0-beta.1"
+    "@lancedb/lancedb-darwin-arm64": "0.40.0-beta.10",
+    "@lancedb/lancedb-linux-x64-gnu": "0.40.0-beta.10",
+    "@lancedb/lancedb-linux-arm64-gnu": "0.40.0-beta.10",
+    "@lancedb/lancedb-linux-x64-musl": "0.40.0-beta.10",
+    "@lancedb/lancedb-linux-arm64-musl": "0.40.0-beta.10",
+    "@lancedb/lancedb-win32-x64-msvc": "0.40.0-beta.10",
+    "@lancedb/lancedb-win32-arm64-msvc": "0.40.0-beta.10"
   },
   "peerDependencies": {
     "@types/node": ">=22",