@lancedb/lancedb 0.41.0-beta.15 → 0.41.0-beta.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CONTRIBUTING.md CHANGED
@@ -50,6 +50,19 @@ pnpm install
50
50
  pnpm build
51
51
  ```
52
52
 
53
+ Local SQL computed columns and materialized-view creation/refresh are experimental
54
+ and disabled in published packages. To opt in when building from this directory:
55
+
56
+ ```shell
57
+ pnpm build:debug --features experimental-functions
58
+ pnpm tsc
59
+ pnpm test --runInBand table.test.ts materialized_view.test.ts
60
+ ```
61
+
62
+ Rebuild without `--features experimental-functions` to test the default package.
63
+ The tests detect the compiled feature; remote operations, metadata protections,
64
+ and ordinary eager `addColumns` transforms remain available in both builds.
65
+
53
66
  Lint:
54
67
 
55
68
  ```shell
package/dist/catalog.d.ts CHANGED
@@ -42,9 +42,14 @@ export declare class Catalog {
42
42
  }): Promise<Connection>;
43
43
  /** Connect to an existing database by its logical name. */
44
44
  connectDatabase(name: string): Promise<Connection>;
45
- /** Drop an empty database. The server rejects nonempty databases. */
45
+ /**
46
+ * Drop a database. A nonempty database is an error unless `cascade` is set,
47
+ * which drops everything in it first; the name stays taken until the server
48
+ * finishes cleaning up their storage.
49
+ */
46
50
  dropDatabase(name: string, options?: {
47
51
  ignoreMissing?: boolean;
52
+ cascade?: boolean;
48
53
  }): Promise<void>;
49
54
  /**
50
55
  * Iterate lazily over all database names using `for await...of`.
package/dist/catalog.js CHANGED
@@ -60,9 +60,13 @@ class Catalog {
60
60
  async connectDatabase(name) {
61
61
  return new connection_1.LocalConnection(await this.inner.connectDatabase(name));
62
62
  }
63
- /** Drop an empty database. The server rejects nonempty databases. */
63
+ /**
64
+ * Drop a database. A nonempty database is an error unless `cascade` is set,
65
+ * which drops everything in it first; the name stays taken until the server
66
+ * finishes cleaning up their storage.
67
+ */
64
68
  async dropDatabase(name, options = {}) {
65
- await this.inner.dropDatabase(name, options.ignoreMissing);
69
+ await this.inner.dropDatabase(name, options.ignoreMissing, options.cascade);
66
70
  }
67
71
  /**
68
72
  * Iterate lazily over all database names using `for await...of`.
@@ -213,6 +213,10 @@ export declare abstract class Connection {
213
213
  /**
214
214
  * Define a materialized view named `name` over the table `source`.
215
215
  *
216
+ * Local creation and refresh require a source build with the
217
+ * `experimental-functions` Cargo feature, disabled in published packages.
218
+ * Remote Cloud/Enterprise operations do not require this feature.
219
+ *
216
220
  * The view is populated before creation returns. Set `withNoData` to create
217
221
  * only its definition and empty backing table. The view is a normal table:
218
222
  * it can be queried, indexed and searched, and it appears in `tableNames`.
@@ -240,15 +244,16 @@ export declare abstract class Connection {
240
244
  /**
241
245
  * Drop the materialized view named `name`.
242
246
  *
243
- * The view may become unavailable before physical cleanup finishes. Use
244
- * {@link dropMaterializedViewAsync} to retain and wait for the cleanup job.
247
+ * Remote drops wait for the SQL command to remove the catalog binding.
248
+ * Physical cleanup continues in the background.
245
249
  *
246
250
  * Rejects a table that exists but is not a materialized view.
247
251
  */
248
252
  abstract dropMaterializedView(name: string, namespacePath?: string[]): Promise<void>;
249
253
  /**
250
- * Start dropping the materialized view named `name` and return its cleanup
251
- * job without waiting for completion.
254
+ * Start dropping the materialized view named `name` and return its job.
255
+ * Remote jobs have type `query` and use the SQL query ID as `id`. Waiting
256
+ * confirms catalog removal; physical cleanup continues in the background.
252
257
  *
253
258
  * Rejects a table that exists but is not a materialized view.
254
259
  */
@@ -56,12 +56,16 @@ export declare class MaterializedView {
56
56
  definition(): Promise<MaterializedViewDefinition>;
57
57
  /**
58
58
  * Recompute the view from its source.
59
+ * Local refresh requires a source build with `experimental-functions`.
59
60
  *
60
- * Every refresh rebuilds the complete view. For local views,
61
- * `sourceVersion` refreshes to that source version instead of the latest;
62
- * remote SQL refreshes do not support source-version pinning.
61
+ * `full: true` forces a remote rebuild; otherwise the server chooses the
62
+ * refresh mode. Local views always rebuild, and `sourceVersion` selects a
63
+ * source version instead of the latest. Remote SQL refreshes do not support
64
+ * source-version pinning. Their results leave `mode`, `rowsWritten`, and
65
+ * `sourceVersion` absent because the SQL job adapter does not expose these metrics.
63
66
  */
64
67
  refresh(options?: {
68
+ full?: boolean;
65
69
  sourceVersion?: number;
66
70
  }): Promise<RefreshMaterializedViewResult>;
67
71
  }
@@ -131,14 +131,17 @@ class MaterializedView {
131
131
  }
132
132
  /**
133
133
  * Recompute the view from its source.
134
+ * Local refresh requires a source build with `experimental-functions`.
134
135
  *
135
- * Every refresh rebuilds the complete view. For local views,
136
- * `sourceVersion` refreshes to that source version instead of the latest;
137
- * remote SQL refreshes do not support source-version pinning.
136
+ * `full: true` forces a remote rebuild; otherwise the server chooses the
137
+ * refresh mode. Local views always rebuild, and `sourceVersion` selects a
138
+ * source version instead of the latest. Remote SQL refreshes do not support
139
+ * source-version pinning. Their results leave `mode`, `rowsWritten`, and
140
+ * `sourceVersion` absent because the SQL job adapter does not expose these metrics.
138
141
  */
139
142
  async refresh(options) {
140
143
  validateNonNegativeInteger(options?.sourceVersion, "sourceVersion");
141
- return await this.inner.refreshMaterializedView(options?.sourceVersion);
144
+ return await this.inner.refreshMaterializedView(options?.sourceVersion, options?.full);
142
145
  }
143
146
  }
144
147
  exports.MaterializedView = MaterializedView;
package/dist/native.d.ts CHANGED
@@ -31,7 +31,7 @@ export declare class Catalog {
31
31
  get uri(): string
32
32
  createDatabase(name: string, existOk?: boolean | undefined | null): Promise<Connection>
33
33
  connectDatabase(name: string): Promise<Connection>
34
- dropDatabase(name: string, ignoreMissing?: boolean | undefined | null): Promise<void>
34
+ dropDatabase(name: string, ignoreMissing?: boolean | undefined | null, cascade?: boolean | undefined | null): Promise<void>
35
35
  listDatabases(pageToken?: string | undefined | null, pageLimit?: number | undefined | null): DatabaseNames
36
36
  }
37
37
 
@@ -434,7 +434,7 @@ export declare class Table {
434
434
  refreshColumn(column: string): Promise<RefreshColumnResult>
435
435
  refreshColumnAsync(column: string): Promise<Job>
436
436
  functionErrors(options?: FunctionErrorsOptions | undefined | null): Promise<FunctionErrors>
437
- refreshMaterializedView(sourceVersion?: number | undefined | null): Promise<RefreshMaterializedViewResult>
437
+ refreshMaterializedView(sourceVersion?: number | undefined | null, full?: boolean | undefined | null): Promise<RefreshMaterializedViewResult>
438
438
  materializedViewDefinition(): Promise<string>
439
439
  addColumnsWithSchema(schemaBuf: Buffer): Promise<AddColumnsResult>
440
440
  alterColumns(alterations: Array<ColumnAlteration>): Promise<AlterColumnsResult>
@@ -756,6 +756,9 @@ export interface DropNamespaceResponse {
756
756
  transactionId?: Array<string>
757
757
  }
758
758
 
759
+ /** Whether this native binding was built with local experimental Functions. */
760
+ export declare function experimentalFunctionsEnabled(): boolean
761
+
759
762
  /**
760
763
  * A per-field metadata update, addressed by dot-path. Merges into the field's
761
764
  * existing metadata by default; a `null` value deletes a key, and `replace`
@@ -1104,10 +1107,12 @@ export interface RefreshColumnResult {
1104
1107
  }
1105
1108
 
1106
1109
  export interface RefreshMaterializedViewResult {
1107
- /** How the view was brought up to date: "rebuild". */
1108
- mode: string
1109
- rowsWritten: number
1110
- sourceVersion: number
1110
+ /** How the view was brought up to date: "rebuild", or absent for remote SQL refreshes. */
1111
+ mode?: string
1112
+ /** Rows written by this refresh, or absent for remote SQL refreshes. */
1113
+ rowsWritten?: number
1114
+ /** Source version refreshed to, or absent for remote SQL refreshes. */
1115
+ sourceVersion?: number
1111
1116
  version: number
1112
1117
  }
1113
1118
 
@@ -1391,6 +1396,10 @@ export interface TimeoutConfig {
1391
1396
  * The timeout for reading data from the server in seconds. Default is 300
1392
1397
  * seconds (5 minutes). This can also be set via the environment variable
1393
1398
  * `LANCE_CLIENT_READ_TIMEOUT`, as an integer number of seconds.
1399
+ *
1400
+ * This also applies while waiting for response headers during an upload.
1401
+ * A large or slowly produced request body (for example, when creating a
1402
+ * table) may need a longer timeout even if data is still being uploaded.
1394
1403
  */
1395
1404
  readTimeout?: number
1396
1405
  /**
package/dist/native.js CHANGED
@@ -76,8 +76,8 @@ function requireNative() {
76
76
  try {
77
77
  const binding = require('@lancedb/lancedb-android-arm64');
78
78
  const bindingPackageVersion = require('@lancedb/lancedb-android-arm64/package.json').version;
79
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
80
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
79
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
80
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
81
81
  }
82
82
  return binding;
83
83
  }
@@ -95,8 +95,8 @@ function requireNative() {
95
95
  try {
96
96
  const binding = require('@lancedb/lancedb-android-arm-eabi');
97
97
  const bindingPackageVersion = require('@lancedb/lancedb-android-arm-eabi/package.json').version;
98
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
99
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
98
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
99
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
100
100
  }
101
101
  return binding;
102
102
  }
@@ -120,8 +120,8 @@ function requireNative() {
120
120
  try {
121
121
  const binding = require('@lancedb/lancedb-win32-x64-gnu');
122
122
  const bindingPackageVersion = require('@lancedb/lancedb-win32-x64-gnu/package.json').version;
123
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
124
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
123
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
124
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
125
125
  }
126
126
  return binding;
127
127
  }
@@ -139,8 +139,8 @@ function requireNative() {
139
139
  try {
140
140
  const binding = require('@lancedb/lancedb-win32-x64-msvc');
141
141
  const bindingPackageVersion = require('@lancedb/lancedb-win32-x64-msvc/package.json').version;
142
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
143
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
142
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
143
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
144
144
  }
145
145
  return binding;
146
146
  }
@@ -159,8 +159,8 @@ function requireNative() {
159
159
  try {
160
160
  const binding = require('@lancedb/lancedb-win32-ia32-msvc');
161
161
  const bindingPackageVersion = require('@lancedb/lancedb-win32-ia32-msvc/package.json').version;
162
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
163
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
162
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
163
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
164
164
  }
165
165
  return binding;
166
166
  }
@@ -178,8 +178,8 @@ function requireNative() {
178
178
  try {
179
179
  const binding = require('@lancedb/lancedb-win32-arm64-msvc');
180
180
  const bindingPackageVersion = require('@lancedb/lancedb-win32-arm64-msvc/package.json').version;
181
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
182
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
181
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
182
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
183
183
  }
184
184
  return binding;
185
185
  }
@@ -201,8 +201,8 @@ function requireNative() {
201
201
  try {
202
202
  const binding = require('@lancedb/lancedb-darwin-universal');
203
203
  const bindingPackageVersion = require('@lancedb/lancedb-darwin-universal/package.json').version;
204
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
205
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
204
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
205
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
206
206
  }
207
207
  return binding;
208
208
  }
@@ -219,8 +219,8 @@ function requireNative() {
219
219
  try {
220
220
  const binding = require('@lancedb/lancedb-darwin-x64');
221
221
  const bindingPackageVersion = require('@lancedb/lancedb-darwin-x64/package.json').version;
222
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
223
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
222
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
223
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
224
224
  }
225
225
  return binding;
226
226
  }
@@ -238,8 +238,8 @@ function requireNative() {
238
238
  try {
239
239
  const binding = require('@lancedb/lancedb-darwin-arm64');
240
240
  const bindingPackageVersion = require('@lancedb/lancedb-darwin-arm64/package.json').version;
241
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
242
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
241
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
242
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
243
243
  }
244
244
  return binding;
245
245
  }
@@ -262,8 +262,8 @@ function requireNative() {
262
262
  try {
263
263
  const binding = require('@lancedb/lancedb-freebsd-x64');
264
264
  const bindingPackageVersion = require('@lancedb/lancedb-freebsd-x64/package.json').version;
265
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
266
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
265
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
266
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
267
267
  }
268
268
  return binding;
269
269
  }
@@ -281,8 +281,8 @@ function requireNative() {
281
281
  try {
282
282
  const binding = require('@lancedb/lancedb-freebsd-arm64');
283
283
  const bindingPackageVersion = require('@lancedb/lancedb-freebsd-arm64/package.json').version;
284
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
285
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
284
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
285
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
286
286
  }
287
287
  return binding;
288
288
  }
@@ -306,8 +306,8 @@ function requireNative() {
306
306
  try {
307
307
  const binding = require('@lancedb/lancedb-linux-x64-musl');
308
308
  const bindingPackageVersion = require('@lancedb/lancedb-linux-x64-musl/package.json').version;
309
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
310
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
309
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
310
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
311
311
  }
312
312
  return binding;
313
313
  }
@@ -325,8 +325,8 @@ function requireNative() {
325
325
  try {
326
326
  const binding = require('@lancedb/lancedb-linux-x64-gnu');
327
327
  const bindingPackageVersion = require('@lancedb/lancedb-linux-x64-gnu/package.json').version;
328
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
329
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
328
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
329
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
330
330
  }
331
331
  return binding;
332
332
  }
@@ -346,8 +346,8 @@ function requireNative() {
346
346
  try {
347
347
  const binding = require('@lancedb/lancedb-linux-arm64-musl');
348
348
  const bindingPackageVersion = require('@lancedb/lancedb-linux-arm64-musl/package.json').version;
349
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
350
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
349
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
350
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
351
351
  }
352
352
  return binding;
353
353
  }
@@ -365,8 +365,8 @@ function requireNative() {
365
365
  try {
366
366
  const binding = require('@lancedb/lancedb-linux-arm64-gnu');
367
367
  const bindingPackageVersion = require('@lancedb/lancedb-linux-arm64-gnu/package.json').version;
368
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
369
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
368
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
369
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
370
370
  }
371
371
  return binding;
372
372
  }
@@ -386,8 +386,8 @@ function requireNative() {
386
386
  try {
387
387
  const binding = require('@lancedb/lancedb-linux-arm-musleabihf');
388
388
  const bindingPackageVersion = require('@lancedb/lancedb-linux-arm-musleabihf/package.json').version;
389
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
390
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
389
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
390
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
391
391
  }
392
392
  return binding;
393
393
  }
@@ -405,8 +405,8 @@ function requireNative() {
405
405
  try {
406
406
  const binding = require('@lancedb/lancedb-linux-arm-gnueabihf');
407
407
  const bindingPackageVersion = require('@lancedb/lancedb-linux-arm-gnueabihf/package.json').version;
408
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
409
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
408
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
409
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
410
410
  }
411
411
  return binding;
412
412
  }
@@ -426,8 +426,8 @@ function requireNative() {
426
426
  try {
427
427
  const binding = require('@lancedb/lancedb-linux-loong64-musl');
428
428
  const bindingPackageVersion = require('@lancedb/lancedb-linux-loong64-musl/package.json').version;
429
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
430
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
429
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
430
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
431
431
  }
432
432
  return binding;
433
433
  }
@@ -445,8 +445,8 @@ function requireNative() {
445
445
  try {
446
446
  const binding = require('@lancedb/lancedb-linux-loong64-gnu');
447
447
  const bindingPackageVersion = require('@lancedb/lancedb-linux-loong64-gnu/package.json').version;
448
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
449
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
448
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
449
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
450
450
  }
451
451
  return binding;
452
452
  }
@@ -466,8 +466,8 @@ function requireNative() {
466
466
  try {
467
467
  const binding = require('@lancedb/lancedb-linux-riscv64-musl');
468
468
  const bindingPackageVersion = require('@lancedb/lancedb-linux-riscv64-musl/package.json').version;
469
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
470
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
469
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
470
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
471
471
  }
472
472
  return binding;
473
473
  }
@@ -485,8 +485,8 @@ function requireNative() {
485
485
  try {
486
486
  const binding = require('@lancedb/lancedb-linux-riscv64-gnu');
487
487
  const bindingPackageVersion = require('@lancedb/lancedb-linux-riscv64-gnu/package.json').version;
488
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
489
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
488
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
489
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
490
490
  }
491
491
  return binding;
492
492
  }
@@ -505,8 +505,8 @@ function requireNative() {
505
505
  try {
506
506
  const binding = require('@lancedb/lancedb-linux-ppc64-gnu');
507
507
  const bindingPackageVersion = require('@lancedb/lancedb-linux-ppc64-gnu/package.json').version;
508
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
509
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
508
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
509
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
510
510
  }
511
511
  return binding;
512
512
  }
@@ -524,8 +524,8 @@ function requireNative() {
524
524
  try {
525
525
  const binding = require('@lancedb/lancedb-linux-s390x-gnu');
526
526
  const bindingPackageVersion = require('@lancedb/lancedb-linux-s390x-gnu/package.json').version;
527
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
528
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
527
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
528
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
529
529
  }
530
530
  return binding;
531
531
  }
@@ -548,8 +548,8 @@ function requireNative() {
548
548
  try {
549
549
  const binding = require('@lancedb/lancedb-openharmony-arm64');
550
550
  const bindingPackageVersion = require('@lancedb/lancedb-openharmony-arm64/package.json').version;
551
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
552
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
551
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
552
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
553
553
  }
554
554
  return binding;
555
555
  }
@@ -567,8 +567,8 @@ function requireNative() {
567
567
  try {
568
568
  const binding = require('@lancedb/lancedb-openharmony-x64');
569
569
  const bindingPackageVersion = require('@lancedb/lancedb-openharmony-x64/package.json').version;
570
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
571
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
570
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
571
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
572
572
  }
573
573
  return binding;
574
574
  }
@@ -586,8 +586,8 @@ function requireNative() {
586
586
  try {
587
587
  const binding = require('@lancedb/lancedb-openharmony-arm');
588
588
  const bindingPackageVersion = require('@lancedb/lancedb-openharmony-arm/package.json').version;
589
- if (bindingPackageVersion !== '0.41.0-beta.15' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
590
- throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
589
+ if (bindingPackageVersion !== '0.41.0-beta.17' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
590
+ throw new Error(`Native binding package version mismatch, expected 0.41.0-beta.17 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
591
591
  }
592
592
  return binding;
593
593
  }
@@ -687,6 +687,7 @@ module.exports.TagContents = nativeBinding.TagContents;
687
687
  module.exports.Tags = nativeBinding.Tags;
688
688
  module.exports.TakeQuery = nativeBinding.TakeQuery;
689
689
  module.exports.VectorQuery = nativeBinding.VectorQuery;
690
+ module.exports.experimentalFunctionsEnabled = nativeBinding.experimentalFunctionsEnabled;
690
691
  module.exports.lancedbMetricsCatalog = nativeBinding.lancedbMetricsCatalog;
691
692
  module.exports.permutationBuilder = nativeBinding.permutationBuilder;
692
693
  module.exports.registerLancedbMetricsRecorder = nativeBinding.registerLancedbMetricsRecorder;
package/dist/table.d.ts CHANGED
@@ -477,6 +477,10 @@ export declare abstract class Table {
477
477
  /**
478
478
  * Add new columns with defined values.
479
479
  *
480
+ * Local computed-column declaration and refresh require a source build with
481
+ * the `experimental-functions` Cargo feature. Published packages disable it;
482
+ * remote Cloud/Enterprise operations remain available.
483
+ *
480
484
  * The `{ computed }` form stores the expression rather than evaluating it
481
485
  * now: the column is committed with no values, and rows get them from
482
486
  * {@link Table#refreshColumn}. Declaring one therefore costs the same on a
@@ -509,6 +513,7 @@ export declare abstract class Table {
509
513
  }): Promise<AddColumnsResult>;
510
514
  /**
511
515
  * Fill the rows of a computed column that hold no value yet.
516
+ * Local refresh requires a source build with `experimental-functions`.
512
517
  *
513
518
  * Rows appended since the last refresh are filled by the next one, and
514
519
  * rows whose inputs changed since they were computed are recomputed;
@@ -522,6 +527,8 @@ export declare abstract class Table {
522
527
  /**
523
528
  * Like {@link Table#refreshColumn}, but returns a handle to the refresh
524
529
  * job instead of blocking until it completes.
530
+ * Local refresh requires a source build with `experimental-functions`.
531
+ * Remote Cloud/Enterprise jobs do not require this feature.
525
532
  *
526
533
  * The job may already be complete when returned; callers must not assume
527
534
  * the column is filled until {@link Job.wait} resolves. Invalid input --
@@ -562,7 +569,7 @@ export declare abstract class Table {
562
569
  * it: rejects tables that carry no view definition.
563
570
  * @ignore
564
571
  */
565
- abstract refreshMaterializedView(sourceVersion?: number): Promise<RefreshMaterializedViewResult>;
572
+ abstract refreshMaterializedView(sourceVersion?: number, full?: boolean): Promise<RefreshMaterializedViewResult>;
566
573
  /** @ignore */
567
574
  abstract materializedViewDefinition(): Promise<string>;
568
575
  /**
@@ -582,8 +589,6 @@ export declare abstract class Table {
582
589
  * - `lancedb:description`: for a human-readable description of a field.
583
590
  * - `lancedb:tag:<name>`: for a user-defined key-value tag, where the suffix
584
591
  * names the tag category; e.g. `lancedb:tag:model: "clip"`.
585
- * - `lancedb:logical-column`: for a column grouping; e.g. `feature_v1` and
586
- * `feature_v2` might be in the same logical column.
587
592
  * - `lancedb:status`: for status options (`production`, `candidate`,
588
593
  * `deprecated`, `archived`) to designate the current life cycle state of
589
594
  * this column.
@@ -938,7 +943,7 @@ export declare class LocalTable extends Table {
938
943
  refreshColumn(column: string): Promise<RefreshColumnResult>;
939
944
  refreshColumnAsync(column: string): Promise<Job>;
940
945
  functionErrors(options?: FunctionErrorsOptions): Promise<FunctionErrors>;
941
- refreshMaterializedView(sourceVersion?: number): Promise<RefreshMaterializedViewResult>;
946
+ refreshMaterializedView(sourceVersion?: number, full?: boolean): Promise<RefreshMaterializedViewResult>;
942
947
  materializedViewDefinition(): Promise<string>;
943
948
  alterColumns(columnAlterations: ColumnAlteration[]): Promise<AlterColumnsResult>;
944
949
  updateFieldMetadata(updates: FieldMetadataUpdate[]): Promise<UpdateFieldMetadataResult>;
package/dist/table.js CHANGED
@@ -286,8 +286,8 @@ class LocalTable extends Table {
286
286
  (0, materialized_view_1.validateNonNegativeInteger)(options?.limit, "limit");
287
287
  return await this.inner.functionErrors(options);
288
288
  }
289
- async refreshMaterializedView(sourceVersion) {
290
- return await this.inner.refreshMaterializedView(sourceVersion);
289
+ async refreshMaterializedView(sourceVersion, full) {
290
+ return await this.inner.refreshMaterializedView(sourceVersion, full);
291
291
  }
292
292
  async materializedViewDefinition() {
293
293
  return await this.inner.materializedViewDefinition();
package/package.json CHANGED
@@ -11,7 +11,7 @@
11
11
  "ann"
12
12
  ],
13
13
  "private": false,
14
- "version": "0.41.0-beta.15",
14
+ "version": "0.41.0-beta.17",
15
15
  "main": "dist/index.js",
16
16
  "exports": {
17
17
  ".": "./dist/index.js",
@@ -111,13 +111,13 @@
111
111
  "optionalDependencies": {
112
112
  "@huggingface/transformers": "3.0.2",
113
113
  "openai": "4.29.2",
114
- "@lancedb/lancedb-darwin-arm64": "0.41.0-beta.15",
115
- "@lancedb/lancedb-linux-x64-gnu": "0.41.0-beta.15",
116
- "@lancedb/lancedb-linux-arm64-gnu": "0.41.0-beta.15",
117
- "@lancedb/lancedb-linux-x64-musl": "0.41.0-beta.15",
118
- "@lancedb/lancedb-linux-arm64-musl": "0.41.0-beta.15",
119
- "@lancedb/lancedb-win32-x64-msvc": "0.41.0-beta.15",
120
- "@lancedb/lancedb-win32-arm64-msvc": "0.41.0-beta.15"
114
+ "@lancedb/lancedb-darwin-arm64": "0.41.0-beta.17",
115
+ "@lancedb/lancedb-linux-x64-gnu": "0.41.0-beta.17",
116
+ "@lancedb/lancedb-linux-arm64-gnu": "0.41.0-beta.17",
117
+ "@lancedb/lancedb-linux-x64-musl": "0.41.0-beta.17",
118
+ "@lancedb/lancedb-linux-arm64-musl": "0.41.0-beta.17",
119
+ "@lancedb/lancedb-win32-x64-msvc": "0.41.0-beta.17",
120
+ "@lancedb/lancedb-win32-arm64-msvc": "0.41.0-beta.17"
121
121
  },
122
122
  "peerDependencies": {
123
123
  "@types/node": ">=22",