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

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/dist/arrow.js CHANGED
@@ -1070,7 +1070,9 @@ async function fromBufferToRecordBatch(data) {
1070
1070
  * Create a buffer containing a single record batch
1071
1071
  */
1072
1072
  async function fromRecordBatchToBuffer(batch) {
1073
- const writer = new apache_arrow_1.RecordBatchFileWriter().writeAll([batch]);
1073
+ // Arrow writers require data types from their own library instance.
1074
+ const table = (0, sanitize_1.sanitizeTable)({ schema: batch.schema, batches: [batch] });
1075
+ const writer = new apache_arrow_1.RecordBatchFileWriter().writeAll(table);
1074
1076
  return Buffer.from(await writer.toUint8Array());
1075
1077
  }
1076
1078
  /**
package/dist/index.d.ts CHANGED
@@ -7,7 +7,7 @@ export { MaterializedView, MaterializedViewDefinition, MaterializedViewSelect, }
7
7
  export { ViewDescription } from "./view";
8
8
  export { JsHeaderProvider as NativeJsHeaderProvider } from "./native.js";
9
9
  export { instrumentLanceDbMetrics } from "./otel";
10
- 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";
10
+ export { AddColumnsSql, ConnectionOptions, ConnectNamespaceOptions, IndexStatistics, IndexConfig, ClientConfig, TimeoutConfig, RetryConfig, TlsConfig, OptimizeStats, CompactionStats, RemovalStats, TableStatistics, FragmentStatistics, FragmentSummaryStats, Tags, TagContents, BranchContents, MergeResult, AddResult, AddColumnsResult, RefreshColumnOptions, RefreshColumnResult, FunctionErrors, FunctionErrorsOptions, FunctionErrorRecord, FunctionErrorFragment, RefreshMaterializedViewResult, AlterColumnsResult, UpdateFieldMetadataResult, DeleteResult, DropColumnsResult, UpdateResult, SplitCalculatedOptions, SplitRandomOptions, SplitHashOptions, SplitSequentialOptions, ShuffleOptions, OAuthConfig as NativeOAuthConfig, } from "./native.js";
11
11
  export { makeArrowTable, makeJsonField, MakeArrowTableOptions, Data, VectorColumnOptions, } from "./arrow";
12
12
  export { blob, isBlobField, BlobFile } from "./blob";
13
13
  export type { BlobData, BlobInput, BlobOptions, BlobRange, BlobReadOptions, BlobUri, } from "./blob";
@@ -17,7 +17,7 @@ export { Job, JobEventsOptions, } from "./job";
17
17
  export type { JobProgress, JobProgressCallback } from "./job";
18
18
  export { AutoQuery, ExecutableQuery, Query, QueryBase, VectorQuery, TakeQuery, AnalyzePlanDistributedMetrics, BlobMode, QueryExecutionOptions, ColumnOrdering, FullTextSearchOptions, RecordBatchIterator, FullTextQuery, MatchQuery, PhraseQuery, BoostQuery, MultiMatchQuery, BooleanQuery, FullTextQueryType, Operator, Occur, } from "./query";
19
19
  export { Index, IndexOptions, IvfPqOptions, IvfRqOptions, IvfFlatOptions, HnswPqOptions, HnswSqOptions, FtsOptions, BaseTokenizer, } from "./indices";
20
- export { Table, Branches, BranchColumnSummary, BranchColumnChange, BranchIndexSummary, BranchRowCountSummary, CherryPickError, BranchDiff, CherryPickPreview, CherryPickResult, AddDataOptions, UpdateOptions, OptimizeOptions, Version, WriteProgress, FtsToken, TokenizeTableOptions, RTEWriteSpec, RTEStats, TableShardStats, SsTableStats, MemtableStats, ColumnAlteration, FieldMetadataUpdate, } from "./table";
20
+ export { Table, Branches, BranchColumnSummary, BranchColumnChange, BranchIndexSummary, BranchRowCountSummary, CherryPickError, BranchDiff, CherryPickPreview, CherryPickResult, AddDataOptions, UpdateOptions, OptimizeOptions, CompactionOptions, Version, WriteProgress, FtsToken, TokenizeTableOptions, RTEWriteSpec, RTEStats, TableShardStats, SsTableStats, MemtableStats, ColumnAlteration, FieldMetadataUpdate, } from "./table";
21
21
  export { HeaderProvider, StaticHeaderProvider, OAuthHeaderProvider, TokenResponse, } from "./header";
22
22
  export { ClientAuthMethod, OAuthConfig, OAuthFlowType, OAuthSession, SessionLogout, SessionStatus, TokenCacheOptions, } from "./oauth";
23
23
  export { MergeInsertBuilder, WriteExecutionOptions } from "./merge";
package/dist/native.d.ts CHANGED
@@ -463,8 +463,8 @@ export declare class Table {
463
463
  vectorSearch(vector: Float32Array): VectorQuery
464
464
  addColumns(transforms: Array<AddColumnsSql>): Promise<AddColumnsResult>
465
465
  addComputedColumns(columns: Array<AddColumnsSql>): Promise<AddColumnsResult>
466
- refreshColumn(column: string): Promise<RefreshColumnResult>
467
- refreshColumnAsync(column: string): Promise<Job>
466
+ refreshColumn(column: string, options?: RefreshColumnOptions | undefined | null): Promise<RefreshColumnResult>
467
+ refreshColumnAsync(column: string, options?: RefreshColumnOptions | undefined | null): Promise<Job>
468
468
  functionErrors(options?: FunctionErrorsOptions | undefined | null): Promise<FunctionErrors>
469
469
  refreshMaterializedView(sourceVersion?: number | undefined | null, full?: boolean | undefined | null): Promise<RefreshMaterializedViewResult>
470
470
  materializedViewDefinition(): Promise<string>
@@ -492,7 +492,7 @@ export declare class Table {
492
492
  branches(): Promise<Branches>
493
493
  /** The branch this handle is scoped to, or `null` for the main branch. */
494
494
  currentBranch(): string | null
495
- optimize(beforeTimestampMs?: number | undefined | null, deleteUnverified?: boolean | undefined | null): Promise<OptimizeStats>
495
+ optimize(beforeTimestampMs?: number | undefined | null, deleteUnverified?: boolean | undefined | null, compactionOptions?: CompactionOptions | undefined | null): Promise<OptimizeStats>
496
496
  listIndices(): Promise<Array<IndexConfig>>
497
497
  tokenize(query: string, column?: string | undefined | null, indexName?: string | undefined | null): Promise<Array<FtsToken>>
498
498
  indexStats(indexName: string): Promise<IndexStatistics | null>
@@ -672,6 +672,14 @@ export interface ColumnOrdering {
672
672
  columnName: string
673
673
  }
674
674
 
675
+ /** Per-invocation file-compaction settings. All numbers must be safe integers. */
676
+ export interface CompactionOptions {
677
+ targetRowsPerFragment?: number
678
+ maxSourceRows?: number
679
+ ioBufferSize?: number
680
+ batchSize?: number
681
+ }
682
+
675
683
  /** Statistics about a compaction operation. */
676
684
  export interface CompactionStats {
677
685
  /** The number of fragments removed */
@@ -877,6 +885,8 @@ export interface FunctionErrorRecord {
877
885
  tableVersion: number
878
886
  errorType: string
879
887
  errorMessage: string
888
+ /** User-code traceback, possibly truncated by the server. */
889
+ traceback?: string
880
890
  createdAtMillis: number
881
891
  }
882
892
 
@@ -991,6 +1001,8 @@ export interface IndexStatistics {
991
1001
  export interface JobFailureInfo {
992
1002
  phase?: string
993
1003
  message?: string
1004
+ /** User-code traceback, possibly truncated by the server. */
1005
+ traceback?: string
994
1006
  retryable?: boolean
995
1007
  }
996
1008
 
@@ -1158,6 +1170,45 @@ export interface OptimizeStats {
1158
1170
  /** Create a permutation builder for the given table */
1159
1171
  export declare function permutationBuilder(table: Table): PermutationBuilder
1160
1172
 
1173
+ /**
1174
+ * Options for `Table.refreshColumn` and `Table.refreshColumnAsync`. Every
1175
+ * option is LanceDB Enterprise only; a LanceDB Embedded refresh ignores
1176
+ * `batchSize`, `gpuClass` and `gpuCount` and rejects the rest.
1177
+ */
1178
+ export interface RefreshColumnOptions {
1179
+ /** Only refresh the rows matching this SQL filter. */
1180
+ where?: string
1181
+ /** Maximum rows per Function call; must be greater than zero. */
1182
+ batchSize?: number
1183
+ /** GPU class for Function workers. */
1184
+ gpuClass?: string
1185
+ /** Positive aggregate GPU budget for Function workers. */
1186
+ gpuCount?: number
1187
+ /**
1188
+ * `"fail"` (default) stops on a row error; `"skip"` writes null and
1189
+ * records the error, subject to the failure limits.
1190
+ */
1191
+ errorPolicy?: string
1192
+ /**
1193
+ * Under a skip policy, fail the job once more than this share of rows
1194
+ * (0 to 1) has failed.
1195
+ */
1196
+ maxFailedFraction?: number
1197
+ /**
1198
+ * Under a skip policy, fail the job once more than this many rows have
1199
+ * failed.
1200
+ */
1201
+ maxFailedRows?: number
1202
+ /** Deadline for one Function call, in seconds. */
1203
+ rowTimeoutSeconds?: number
1204
+ /** Deadline for Function initialization, in seconds. */
1205
+ initTimeoutSeconds?: number
1206
+ /** Worker count for an expression column; Function columns reject it. */
1207
+ numWorkers?: number
1208
+ /** Cap on executor processes per Function worker. */
1209
+ maxExecutorProcessesPerWorker?: number
1210
+ }
1211
+
1161
1212
  export interface RefreshColumnResult {
1162
1213
  rowsFilled: number
1163
1214
  version: number
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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
79
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
98
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
123
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
142
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
162
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
181
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
204
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
222
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
241
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
265
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
284
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
309
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
328
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
349
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
368
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
389
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
408
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
429
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
448
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
469
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
488
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
508
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
527
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
551
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
570
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 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.42.0-beta.1' && 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.42.0-beta.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
589
+ if (bindingPackageVersion !== '0.42.0-beta.10' && 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.42.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`);
591
591
  }
592
592
  return binding;
593
593
  }
package/dist/query.d.ts CHANGED
@@ -32,6 +32,9 @@ export interface QueryExecutionOptions {
32
32
  maxBatchLength?: number;
33
33
  /**
34
34
  * Timeout for query execution in milliseconds
35
+ *
36
+ * The timeout also covers reading the results, so consuming them slowly can
37
+ * exceed it.
35
38
  */
36
39
  timeoutMs?: number;
37
40
  /**
@@ -365,6 +368,11 @@ export declare class VectorQuery extends StandardQueryBase<NativeVectorQuery> {
365
368
  /**
366
369
  * Set the initial IVF search effort to a finite value in [0, 1].
367
370
  *
371
+ * Efforts 0.1 and 0.25 target empirical mean partition-routing recall of
372
+ * 80% and 90% for L2, cosine and dot through k=100000. The probe budget
373
+ * adapts to the metric and k. Hamming and larger k remain uncalibrated;
374
+ * 100000 is not an API limit. Remote queries also require server support.
375
+ *
368
376
  * The default, null, uses Auto (internally 0.5). Zero starts at the caller
369
377
  * minimum; one searches all partitions within the caller maximum. Later
370
378
  * probing may continue when too few candidates are found.
package/dist/query.js CHANGED
@@ -599,6 +599,11 @@ class VectorQuery extends StandardQueryBase {
599
599
  /**
600
600
  * Set the initial IVF search effort to a finite value in [0, 1].
601
601
  *
602
+ * Efforts 0.1 and 0.25 target empirical mean partition-routing recall of
603
+ * 80% and 90% for L2, cosine and dot through k=100000. The probe budget
604
+ * adapts to the metric and k. Hamming and larger k remain uncalibrated;
605
+ * 100000 is not an API limit. Remote queries also require server support.
606
+ *
602
607
  * The default, null, uses Auto (internally 0.5). Zero starts at the caller
603
608
  * minimum; one searches all partitions within the caller maximum. Later
604
609
  * probing may continue when too few candidates are found.
package/dist/table.d.ts CHANGED
@@ -3,7 +3,7 @@ import { BlobFile, BlobReadOptions } from "./blob";
3
3
  import { IndexOptions } from "./indices";
4
4
  import { Job } from "./job";
5
5
  import { MergeInsertBuilder } from "./merge";
6
- import { AddColumnsResult, AddColumnsSql, AddResult, AlterColumnsResult, BranchContents, DeleteResult, DropColumnsResult, FunctionErrors, FunctionErrorsOptions, IndexConfig, IndexStatistics, Branches as NativeBranches, OptimizeStats, RTEStats, RefreshColumnResult, RefreshMaterializedViewResult, TableStatistics, Tags, UpdateFieldMetadataResult, UpdateResult, Table as _NativeTable } from "./native";
6
+ import { AddColumnsResult, AddColumnsSql, AddResult, AlterColumnsResult, BranchContents, DeleteResult, DropColumnsResult, FunctionErrors, FunctionErrorsOptions, IndexConfig, IndexStatistics, Branches as NativeBranches, OptimizeStats, RTEStats, RefreshColumnOptions, RefreshColumnResult, RefreshMaterializedViewResult, TableStatistics, Tags, UpdateFieldMetadataResult, UpdateResult, Table as _NativeTable } from "./native";
7
7
  import { AutoQuery, FullTextQuery, Query, TakeQuery, VectorQuery } from "./query";
8
8
  import { IntoSql } from "./util";
9
9
  export { IndexConfig } from "./native";
@@ -89,7 +89,30 @@ export interface UpdateOptions {
89
89
  */
90
90
  where: string;
91
91
  }
92
+ /** Per-invocation compaction settings. Values must be safe integers. */
93
+ export interface CompactionOptions {
94
+ /** Positive target rows per output fragment; also affects candidate selection. */
95
+ targetRowsPerFragment?: number;
96
+ /** Positive live-source-row budget across whole tasks; an oversized first task can produce no work. */
97
+ maxSourceRows?: number;
98
+ /** Scanner I/O read-ahead budget in bytes; zero disables byte-based I/O backpressure. */
99
+ ioBufferSize?: number;
100
+ /** Positive scanner batch size in rows. */
101
+ batchSize?: number;
102
+ }
92
103
  export interface OptimizeOptions {
104
+ /**
105
+ * Compaction settings for this invocation. Omitted remote values inherit table
106
+ * tuning, then deployment/built-in defaults.
107
+ * Remote tables require a server supporting these SQL options; settings do
108
+ * not change table policy. This is not a runtime or total-memory limit.
109
+ * @example
110
+ * await tbl.optimize({ compactionOptions: {
111
+ * targetRowsPerFragment: 1000, maxSourceRows: 5000,
112
+ * ioBufferSize: 64 * 1024 * 1024, batchSize: 128,
113
+ * } });
114
+ */
115
+ compactionOptions?: CompactionOptions;
93
116
  /**
94
117
  * If set then all versions older than the given date
95
118
  * be removed. The current version will never be removed.
@@ -548,10 +571,12 @@ export declare abstract class Table {
548
571
  * everything else is left as it is. LanceDB Embedded only: in LanceDB
549
572
  * Enterprise a refresh runs as a server job, through {@link Table#refreshColumnAsync}.
550
573
  * @param {string} column The name of the computed column to fill.
574
+ * @param {RefreshColumnOptions} options Refresh options, all LanceDB
575
+ * Enterprise only; see {@link Table#refreshColumnAsync}.
551
576
  * @returns {Promise<RefreshColumnResult>} A promise that resolves to the
552
577
  * number of rows filled and the new version number of the table.
553
578
  */
554
- abstract refreshColumn(column: string): Promise<RefreshColumnResult>;
579
+ abstract refreshColumn(column: string, options?: RefreshColumnOptions): Promise<RefreshColumnResult>;
555
580
  /**
556
581
  * Like {@link Table#refreshColumn}, but returns a handle to the refresh
557
582
  * job instead of blocking until it completes.
@@ -565,14 +590,27 @@ export declare abstract class Table {
565
590
  * than failing the job. In LanceDB Embedded the job runs in-process; in
566
591
  * LanceDB Enterprise it is the server's backfill job.
567
592
  * @param {string} column The name of the computed column to fill.
593
+ * @param {RefreshColumnOptions} options Refresh options, mirroring the SQL
594
+ * `REFRESH COLUMN ... WHERE ... WITH (...)` form: `where` narrows the rows,
595
+ * `errorPolicy`, `maxFailedFraction`, `maxFailedRows`, `rowTimeoutSeconds`
596
+ * and `initTimeoutSeconds` govern failing rows, and `batchSize`,
597
+ * `gpuClass`, `gpuCount`, `numWorkers` and `maxExecutorProcessesPerWorker`
598
+ * size the workers. All are LanceDB Enterprise only; a LanceDB Embedded
599
+ * refresh rejects every option other than `batchSize`, `gpuClass` and
600
+ * `gpuCount`.
568
601
  * @example
569
602
  * ```ts
570
- * const job = await table.refreshColumnAsync("doubled");
603
+ * const job = await table.refreshColumnAsync("embedding", {
604
+ * where: "published_at > '2026-01-01'",
605
+ * errorPolicy: "skip",
606
+ * maxFailedFraction: 0.01,
607
+ * rowTimeoutSeconds: 30,
608
+ * });
571
609
  * await job.wait();
572
610
  * console.log(await job.status()); // "finished"
573
611
  * ```
574
612
  */
575
- abstract refreshColumnAsync(column: string): Promise<Job>;
613
+ abstract refreshColumnAsync(column: string, options?: RefreshColumnOptions): Promise<Job>;
576
614
  /**
577
615
  * The per-row errors Function refreshes recorded on this table.
578
616
  *
@@ -871,6 +909,15 @@ export declare abstract class Table {
871
909
  * optimize should be run frequently. A good rule of thumb is to run optimize if
872
910
  * you have added or modified 100,000 or more records or run more than 20 data
873
911
  * modification operations.
912
+ *
913
+ * On a LanceDB Enterprise (remote) table, only compaction is currently
914
+ * supported. Pruning old versions and index optimization are silently
915
+ * skipped there instead of being attempted, so this call resolves
916
+ * successfully, with zeroed pruning statistics, once the compaction job
917
+ * has been submitted; it does not wait for that job to finish.
918
+ * `compactionOptions` can tune the four per-job settings documented in
919
+ * {@link CompactionOptions}. Older-server errors are propagated without
920
+ * retrying with the settings removed.
874
921
  */
875
922
  abstract optimize(options?: Partial<OptimizeOptions>): Promise<OptimizeStats>;
876
923
  /**
@@ -982,8 +1029,8 @@ export declare class LocalTable extends Table {
982
1029
  addColumns(newColumnTransforms: AddColumnsSql[] | Field | Field[] | Schema | {
983
1030
  computed: AddColumnsSql[];
984
1031
  }): Promise<AddColumnsResult>;
985
- refreshColumn(column: string): Promise<RefreshColumnResult>;
986
- refreshColumnAsync(column: string): Promise<Job>;
1032
+ refreshColumn(column: string, options?: RefreshColumnOptions): Promise<RefreshColumnResult>;
1033
+ refreshColumnAsync(column: string, options?: RefreshColumnOptions): Promise<Job>;
987
1034
  functionErrors(options?: FunctionErrorsOptions): Promise<FunctionErrors>;
988
1035
  refreshMaterializedView(sourceVersion?: number, full?: boolean): Promise<RefreshMaterializedViewResult>;
989
1036
  materializedViewDefinition(): Promise<string>;
package/dist/table.js CHANGED
@@ -276,11 +276,11 @@ class LocalTable extends Table {
276
276
  }
277
277
  throw new Error("Invalid input type for addColumns");
278
278
  }
279
- async refreshColumn(column) {
280
- return await this.inner.refreshColumn(column);
279
+ async refreshColumn(column, options) {
280
+ return await this.inner.refreshColumn(column, options);
281
281
  }
282
- async refreshColumnAsync(column) {
283
- return new job_1.Job(await this.inner.refreshColumnAsync(column));
282
+ async refreshColumnAsync(column, options) {
283
+ return new job_1.Job(await this.inner.refreshColumnAsync(column, options));
284
284
  }
285
285
  async functionErrors(options) {
286
286
  (0, materialized_view_1.validateNonNegativeInteger)(options?.limit, "limit");
@@ -385,7 +385,20 @@ class LocalTable extends Table {
385
385
  return this.inner.currentBranch() ?? null;
386
386
  }
387
387
  async optimize(options) {
388
- return await this.inner.optimize(options?.cleanupOlderThan?.getTime(), options?.deleteUnverified);
388
+ // JavaScript callers can supply extra keys that TypeScript would reject.
389
+ // Refuse them before the native binding can silently discard a work limit.
390
+ const supported = new Set([
391
+ "targetRowsPerFragment",
392
+ "maxSourceRows",
393
+ "ioBufferSize",
394
+ "batchSize",
395
+ ]);
396
+ for (const key of Object.keys(options?.compactionOptions ?? {})) {
397
+ if (!supported.has(key)) {
398
+ throw new Error(`Unsupported compaction option: ${key}`);
399
+ }
400
+ }
401
+ return await this.inner.optimize(options?.cleanupOlderThan?.getTime(), options?.deleteUnverified, options?.compactionOptions);
389
402
  }
390
403
  async listIndices() {
391
404
  return await this.inner.listIndices();
package/package.json CHANGED
@@ -11,7 +11,7 @@
11
11
  "ann"
12
12
  ],
13
13
  "private": false,
14
- "version": "0.42.0-beta.1",
14
+ "version": "0.42.0-beta.10",
15
15
  "main": "dist/index.js",
16
16
  "exports": {
17
17
  ".": "./dist/index.js",
@@ -109,15 +109,15 @@
109
109
  "reflect-metadata": "^0.2.2"
110
110
  },
111
111
  "optionalDependencies": {
112
- "@huggingface/transformers": "3.0.2",
112
+ "@huggingface/transformers": "4.3.2",
113
113
  "openai": "4.29.2",
114
- "@lancedb/lancedb-darwin-arm64": "0.42.0-beta.1",
115
- "@lancedb/lancedb-linux-x64-gnu": "0.42.0-beta.1",
116
- "@lancedb/lancedb-linux-arm64-gnu": "0.42.0-beta.1",
117
- "@lancedb/lancedb-linux-x64-musl": "0.42.0-beta.1",
118
- "@lancedb/lancedb-linux-arm64-musl": "0.42.0-beta.1",
119
- "@lancedb/lancedb-win32-x64-msvc": "0.42.0-beta.1",
120
- "@lancedb/lancedb-win32-arm64-msvc": "0.42.0-beta.1"
114
+ "@lancedb/lancedb-darwin-arm64": "0.42.0-beta.10",
115
+ "@lancedb/lancedb-linux-x64-gnu": "0.42.0-beta.10",
116
+ "@lancedb/lancedb-linux-arm64-gnu": "0.42.0-beta.10",
117
+ "@lancedb/lancedb-linux-x64-musl": "0.42.0-beta.10",
118
+ "@lancedb/lancedb-linux-arm64-musl": "0.42.0-beta.10",
119
+ "@lancedb/lancedb-win32-x64-msvc": "0.42.0-beta.10",
120
+ "@lancedb/lancedb-win32-arm64-msvc": "0.42.0-beta.10"
121
121
  },
122
122
  "peerDependencies": {
123
123
  "@types/node": ">=22",
@@ -47,10 +47,3 @@ minimumReleaseAgeExclude:
47
47
  - js-yaml@4.3.1
48
48
  - tar@7.5.21
49
49
  - '@opentelemetry/core@2.8.0'
50
-
51
- # @huggingface/transformers pins sharp ^0.33.5 and no released version has moved
52
- # past ^0.34.5, all of which inherit the libvips CVEs in GHSA-f88m-g3jw-g9cj.
53
- # Force the patched line. sharp is only reached by transformers' image pipeline,
54
- # which LanceDB's text embedding function never uses.
55
- overrides:
56
- sharp: ^0.35.4