@lancedb/lancedb 0.22.3-beta.4 → 0.22.3

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { Connection } from "./connection";
 import { ConnectionOptions, Session } from "./native.js";
 import { HeaderProvider } from "./header";
 export { JsHeaderProvider as NativeJsHeaderProvider } from "./native.js";
-export { AddColumnsSql, ConnectionOptions, IndexStatistics, IndexConfig, ClientConfig, TimeoutConfig, RetryConfig, TlsConfig, OptimizeStats, CompactionStats, RemovalStats, TableStatistics, FragmentStatistics, FragmentSummaryStats, Tags, TagContents, MergeResult, AddResult, AddColumnsResult, AlterColumnsResult, DeleteResult, DropColumnsResult, UpdateResult, SplitRandomOptions, SplitHashOptions, SplitSequentialOptions, ShuffleOptions, } from "./native.js";
+export { AddColumnsSql, ConnectionOptions, IndexStatistics, IndexConfig, ClientConfig, TimeoutConfig, RetryConfig, TlsConfig, OptimizeStats, CompactionStats, RemovalStats, TableStatistics, FragmentStatistics, FragmentSummaryStats, Tags, TagContents, MergeResult, AddResult, AddColumnsResult, AlterColumnsResult, DeleteResult, DropColumnsResult, UpdateResult, SplitCalculatedOptions, SplitRandomOptions, SplitHashOptions, SplitSequentialOptions, ShuffleOptions, } from "./native.js";
 export { makeArrowTable, MakeArrowTableOptions, Data, VectorColumnOptions, } from "./arrow";
 export { Connection, CreateTableOptions, TableNamesOptions, OpenTableOptions, } from "./connection";
 export { Session } from "./native.js";

package/dist/native.d.ts

@@ -8,16 +8,23 @@ export interface SplitRandomOptions {
   counts?: Array<number>
   fixed?: number
   seed?: number
+  splitNames?: Array<string>
 }
 export interface SplitHashOptions {
   columns: Array<string>
   splitWeights: Array<number>
   discardWeight?: number
+  splitNames?: Array<string>
 }
 export interface SplitSequentialOptions {
   ratios?: Array<number>
   counts?: Array<number>
   fixed?: number
+  splitNames?: Array<string>
+}
+export interface SplitCalculatedOptions {
+  calculation: string
+  splitNames?: Array<string>
 }
 export interface ShuffleOptions {
   seed?: number
@@ -402,6 +409,7 @@ export class NativeMergeInsertBuilder {
   execute(buf: Buffer): Promise<MergeResult>
 }
 export class PermutationBuilder {
+  persist(connection: Connection, tableName: string): PermutationBuilder
   /** Configure random splits */
   splitRandom(options: SplitRandomOptions): PermutationBuilder
   /** Configure hash-based splits */
@@ -409,7 +417,7 @@ export class PermutationBuilder {
   /** Configure sequential splits */
   splitSequential(options: SplitSequentialOptions): PermutationBuilder
   /** Configure calculated splits */
-  splitCalculated(calculation: string): PermutationBuilder
+  splitCalculated(options: SplitCalculatedOptions): PermutationBuilder
   /** Configure shuffling */
   shuffle(options: ShuffleOptions): PermutationBuilder
   /** Configure filtering */

package/dist/permutation.d.ts

@@ -1,4 +1,5 @@
-import { PermutationBuilder as NativePermutationBuilder, ShuffleOptions, SplitHashOptions, SplitRandomOptions, SplitSequentialOptions } from "./native.js";
+import { Connection } from "./connection.js";
+import { PermutationBuilder as NativePermutationBuilder, ShuffleOptions, SplitCalculatedOptions, SplitHashOptions, SplitRandomOptions, SplitSequentialOptions } from "./native.js";
 import { Table } from "./table";
 /**
  * A PermutationBuilder for creating data permutations with splits, shuffling, and filtering.
@@ -13,6 +14,18 @@ export declare class PermutationBuilder {
      * @hidden
      */
     constructor(inner: NativePermutationBuilder);
+    /**
+     * Configure the permutation to be persisted.
+     *
+     * @param connection - The connection to persist the permutation to
+     * @param tableName - The name of the table to create
+     * @returns A new PermutationBuilder instance
+     * @example
+     * ```ts
+     * builder.persist(connection, "permutation_table");
+     * ```
+     */
+    persist(connection: Connection, tableName: string): PermutationBuilder;
     /**
      * Configure random splits for the permutation.
      *
@@ -67,14 +80,14 @@ export declare class PermutationBuilder {
     /**
      * Configure calculated splits for the permutation.
      *
-     * @param calculation - SQL expression for calculating splits
+     * @param options - Configuration for calculated splitting
      * @returns A new PermutationBuilder instance
      * @example
      * ```ts
      * builder.splitCalculated("user_id % 3");
      * ```
      */
-    splitCalculated(calculation: string): PermutationBuilder;
+    splitCalculated(options: SplitCalculatedOptions): PermutationBuilder;
     /**
      * Configure shuffling for the permutation.
      *

package/dist/permutation.js

@@ -21,6 +21,22 @@ class PermutationBuilder {
     constructor(inner) {
         this.inner = inner;
     }
+    /**
+     * Configure the permutation to be persisted.
+     *
+     * @param connection - The connection to persist the permutation to
+     * @param tableName - The name of the table to create
+     * @returns A new PermutationBuilder instance
+     * @example
+     * ```ts
+     * builder.persist(connection, "permutation_table");
+     * ```
+     */
+    persist(connection, tableName) {
+        const localConnection = connection;
+        const newInner = this.inner.persist(localConnection.inner, tableName);
+        return new PermutationBuilder(newInner);
+    }
     /**
      * Configure random splits for the permutation.
      *
@@ -84,15 +100,15 @@ class PermutationBuilder {
     /**
      * Configure calculated splits for the permutation.
      *
-     * @param calculation - SQL expression for calculating splits
+     * @param options - Configuration for calculated splitting
      * @returns A new PermutationBuilder instance
      * @example
      * ```ts
      * builder.splitCalculated("user_id % 3");
      * ```
      */
-    splitCalculated(calculation) {
-        const newInner = this.inner.splitCalculated(calculation);
+    splitCalculated(options) {
+        const newInner = this.inner.splitCalculated(options);
         return new PermutationBuilder(newInner);
     }
     /**

package/package.json

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