@qualithm/arrow-flight-client 0.1.0 → 0.1.2

package/dist/testing/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../src/testing/builders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAoB,uBAAuB,EAA2B,MAAM,cAAc,CAAA;AAEjG,OAAO,EAAmB,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAEpF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,gBAAgB,EAAE;QAC9B,UAAU,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;QAC7B,QAAQ,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;QAC3B,WAAW,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;KAC/B,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAiC;IACvE,MAAM,MAAM,GAAiB,EAAE,CAAA;IAE/B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAY;IAClD,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA8C,EAC9C,MAAc;IAEd,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAA;IAElE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,oDAAoD;IACpD,MAAM,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAA;IAC5C,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAE/B,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;IACD,MAAM,CAAC,MAAM,EAAE,CAAA;IAEf,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;IAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,+BAA+B;IAC/B,0FAA0F;IAC1F,oEAAoE;IACpE,OAAO;QACL,MAAM,CAAC,gBAAgB,EAAE;YACvB,UAAU,EAAE,QAAQ;YACpB,QAAQ,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;YAC3B,WAAW,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;SAC/B,CAAC;KACH,CAAA;AACH,CAAC"}

package/dist/testing/descriptors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * FlightDescriptor helper functions for tests.
+ *
+ * @packageDocumentation
+ */
+import type { FlightDescriptorInput } from "../client/types.js";
+/**
+ * Create a path-based FlightDescriptor input.
+ *
+ * Path descriptors identify a dataset by a hierarchical path (like "db/schema/table").
+ *
+ * @param path - Path segments
+ * @returns FlightDescriptorInput for path descriptor
+ *
+ * @example
+ * ```ts
+ * // Create descriptor for "test/integers"
+ * const descriptor = pathDescriptor("test", "integers")
+ *
+ * // Use with client
+ * const info = await client.getFlightInfo(descriptor)
+ * ```
+ */
+export declare function pathDescriptor(...path: string[]): FlightDescriptorInput;
+/**
+ * Create a command-based FlightDescriptor input.
+ *
+ * Command descriptors contain opaque bytes interpreted by the server.
+ *
+ * @param cmd - Command bytes or string (will be UTF-8 encoded)
+ * @returns FlightDescriptorInput for command descriptor
+ *
+ * @example
+ * ```ts
+ * // Create descriptor with SQL query command
+ * const descriptor = cmdDescriptor("SELECT * FROM users")
+ *
+ * // Create descriptor with binary command
+ * const descriptor = cmdDescriptor(new Uint8Array([0x01, 0x02]))
+ * ```
+ */
+export declare function cmdDescriptor(cmd: string | Uint8Array): FlightDescriptorInput;
+//# sourceMappingURL=descriptors.d.ts.map

package/dist/testing/descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../src/testing/descriptors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE/D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAEvE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,qBAAqB,CAG7E"}

package/dist/testing/descriptors.js

@@ -0,0 +1,47 @@
+/**
+ * FlightDescriptor helper functions for tests.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create a path-based FlightDescriptor input.
+ *
+ * Path descriptors identify a dataset by a hierarchical path (like "db/schema/table").
+ *
+ * @param path - Path segments
+ * @returns FlightDescriptorInput for path descriptor
+ *
+ * @example
+ * ```ts
+ * // Create descriptor for "test/integers"
+ * const descriptor = pathDescriptor("test", "integers")
+ *
+ * // Use with client
+ * const info = await client.getFlightInfo(descriptor)
+ * ```
+ */
+export function pathDescriptor(...path) {
+    return { type: "path", path };
+}
+/**
+ * Create a command-based FlightDescriptor input.
+ *
+ * Command descriptors contain opaque bytes interpreted by the server.
+ *
+ * @param cmd - Command bytes or string (will be UTF-8 encoded)
+ * @returns FlightDescriptorInput for command descriptor
+ *
+ * @example
+ * ```ts
+ * // Create descriptor with SQL query command
+ * const descriptor = cmdDescriptor("SELECT * FROM users")
+ *
+ * // Create descriptor with binary command
+ * const descriptor = cmdDescriptor(new Uint8Array([0x01, 0x02]))
+ * ```
+ */
+export function cmdDescriptor(cmd) {
+    const cmdBytes = typeof cmd === "string" ? new TextEncoder().encode(cmd) : cmd;
+    return { type: "cmd", cmd: cmdBytes };
+}
+//# sourceMappingURL=descriptors.js.map

package/dist/testing/descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.js","sourceRoot":"","sources":["../../src/testing/descriptors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAG,IAAc;IAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,GAAwB;IACpD,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAC9E,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAA;AACvC,CAAC"}

package/dist/testing/helpers.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Table and RecordBatch creation helpers for tests.
+ *
+ * @packageDocumentation
+ */
+import { type RecordBatch, type Table, tableFromArrays } from "apache-arrow";
+/**
+ * Input data for creating test tables.
+ * Keys are column names, values are typed arrays or regular arrays.
+ */
+export type TestTableData = Parameters<typeof tableFromArrays>[0];
+/**
+ * Create an Arrow Table from simple arrays.
+ *
+ * Automatically infers types from the input arrays:
+ * - Int32Array → Int32
+ * - Float64Array → Float64
+ * - string[] → Utf8
+ * - number[] → Float64
+ *
+ * @param data - Object mapping column names to arrays
+ * @returns Arrow Table
+ *
+ * @example
+ * ```ts
+ * const table = createTestTable({
+ *   id: new Int32Array([1, 2, 3]),
+ *   value: new Float64Array([1.1, 2.2, 3.3]),
+ *   name: ["alice", "bob", "charlie"]
+ * })
+ * ```
+ */
+export declare function createTestTable(data: TestTableData): Table;
+/**
+ * Create a single RecordBatch from simple arrays.
+ *
+ * @param data - Object mapping column names to arrays
+ * @returns Arrow RecordBatch
+ *
+ * @example
+ * ```ts
+ * const batch = createTestBatch({
+ *   id: new Int32Array([1, 2, 3]),
+ *   value: new Float64Array([1.1, 2.2, 3.3])
+ * })
+ * ```
+ */
+export declare function createTestBatch(data: TestTableData): RecordBatch;
+/**
+ * Create a Table with standard integer test data.
+ *
+ * @param count - Number of rows (default: 10)
+ * @returns Table with `id` (Int32) and `value` (Int32) columns
+ */
+export declare function createIntegerTable(count?: number): Table;
+/**
+ * Create a Table with standard float test data.
+ *
+ * @param count - Number of rows (default: 10)
+ * @returns Table with `id` (Int32) and `value` (Float64) columns
+ */
+export declare function createFloatTable(count?: number): Table;
+/**
+ * Create a Table with string test data.
+ *
+ * @param count - Number of rows (default: 10)
+ * @returns Table with `id` (Int32) and `name` (Utf8) columns
+ */
+export declare function createStringTable(count?: number): Table;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/testing/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/testing/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE5E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,KAAK,CAE1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,WAAW,CAIhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAK,GAAG,KAAK,CAUpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAK,GAAG,KAAK,CAUlD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAK,GAAG,KAAK,CAUnD"}

package/dist/testing/helpers.js

@@ -0,0 +1,95 @@
+/**
+ * Table and RecordBatch creation helpers for tests.
+ *
+ * @packageDocumentation
+ */
+import { tableFromArrays } from "apache-arrow";
+/**
+ * Create an Arrow Table from simple arrays.
+ *
+ * Automatically infers types from the input arrays:
+ * - Int32Array → Int32
+ * - Float64Array → Float64
+ * - string[] → Utf8
+ * - number[] → Float64
+ *
+ * @param data - Object mapping column names to arrays
+ * @returns Arrow Table
+ *
+ * @example
+ * ```ts
+ * const table = createTestTable({
+ *   id: new Int32Array([1, 2, 3]),
+ *   value: new Float64Array([1.1, 2.2, 3.3]),
+ *   name: ["alice", "bob", "charlie"]
+ * })
+ * ```
+ */
+export function createTestTable(data) {
+    return tableFromArrays(data);
+}
+/**
+ * Create a single RecordBatch from simple arrays.
+ *
+ * @param data - Object mapping column names to arrays
+ * @returns Arrow RecordBatch
+ *
+ * @example
+ * ```ts
+ * const batch = createTestBatch({
+ *   id: new Int32Array([1, 2, 3]),
+ *   value: new Float64Array([1.1, 2.2, 3.3])
+ * })
+ * ```
+ */
+export function createTestBatch(data) {
+    const table = createTestTable(data);
+    // Tables created from tableFromArrays have exactly one batch
+    return table.batches[0];
+}
+/**
+ * Create a Table with standard integer test data.
+ *
+ * @param count - Number of rows (default: 10)
+ * @returns Table with `id` (Int32) and `value` (Int32) columns
+ */
+export function createIntegerTable(count = 10) {
+    const ids = new Int32Array(count);
+    const values = new Int32Array(count);
+    for (let i = 0; i < count; i++) {
+        ids[i] = i + 1;
+        values[i] = (i + 1) * 10;
+    }
+    return createTestTable({ id: ids, value: values });
+}
+/**
+ * Create a Table with standard float test data.
+ *
+ * @param count - Number of rows (default: 10)
+ * @returns Table with `id` (Int32) and `value` (Float64) columns
+ */
+export function createFloatTable(count = 10) {
+    const ids = new Int32Array(count);
+    const values = new Float64Array(count);
+    for (let i = 0; i < count; i++) {
+        ids[i] = i + 1;
+        values[i] = (i + 1) * 1.1;
+    }
+    return createTestTable({ id: ids, value: values });
+}
+/**
+ * Create a Table with string test data.
+ *
+ * @param count - Number of rows (default: 10)
+ * @returns Table with `id` (Int32) and `name` (Utf8) columns
+ */
+export function createStringTable(count = 10) {
+    const ids = new Int32Array(count);
+    const names = [];
+    for (let i = 0; i < count; i++) {
+        ids[i] = i + 1;
+        names.push(`item-${String(i + 1)}`);
+    }
+    return createTestTable({ id: ids, name: names });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/testing/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/testing/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAgC,eAAe,EAAE,MAAM,cAAc,CAAA;AAQ5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACnC,6DAA6D;IAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAK,GAAG,EAAE;IAC3C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACd,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAA;IAC1B,CAAC;IAED,OAAO,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAK,GAAG,EAAE;IACzC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAA;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACd,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;IAC3B,CAAC;IAED,OAAO,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAK,GAAG,EAAE;IAC1C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IACjC,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AAClD,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Testing utilities for Arrow Flight Client.
+ *
+ * This subpath export (`@qualithm/arrow-flight-client/testing`) provides:
+ *
+ * - **Table helpers** — Create Arrow Tables and RecordBatches for tests
+ * - **FlightData builders** — Construct FlightData messages without protobuf boilerplate
+ * - **Mock streams** — Create async iterables for testing stream consumers
+ * - **Descriptor helpers** — Build FlightDescriptor inputs easily
+ *
+ * @example
+ * ```ts
+ * import {
+ *   // Table helpers
+ *   createTestTable, createTestBatch,
+ *   // FlightData builders
+ *   createEmptyFlightData, tableToFlightData,
+ *   // Mock streams
+ *   asyncIterable, emptyStream,
+ *   // Descriptor helpers
+ *   pathDescriptor, cmdDescriptor
+ * } from "@qualithm/arrow-flight-client/testing"
+ *
+ * // Create test data
+ * const table = createTestTable({ id: [1, 2, 3], value: [1.1, 2.2, 3.3] })
+ *
+ * // Build FlightData from table
+ * const flightData = await tableToFlightData(table)
+ *
+ * // Create mock streams
+ * const stream = asyncIterable(flightData)
+ *
+ * // Build descriptors
+ * const descriptor = pathDescriptor("test", "integers")
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createFloatTable, createIntegerTable, createStringTable, createTestBatch, createTestTable, type TestTableData } from "./helpers.js";
+export { batchesToFlightData, collectFlightData, createEmptyFlightData, tableToFlightData } from "./builders.js";
+export { asyncIterable, concatStreams, delayedIterable, emptyStream, errorAfter } from "./streams.js";
+export { cmdDescriptor, pathDescriptor } from "./descriptors.js";
+export { FlightDataSchema, FlightDescriptor_DescriptorType, FlightDescriptorSchema, FlightEndpointSchema, FlightInfoSchema, TicketSchema } from "../gen/arrow/flight/Flight_pb.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,KAAK,aAAa,EACnB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACX,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGhE,OAAO,EACL,gBAAgB,EAChB,+BAA+B,EAC/B,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACb,MAAM,kCAAkC,CAAA"}

package/dist/testing/index.js

@@ -0,0 +1,49 @@
+/**
+ * Testing utilities for Arrow Flight Client.
+ *
+ * This subpath export (`@qualithm/arrow-flight-client/testing`) provides:
+ *
+ * - **Table helpers** — Create Arrow Tables and RecordBatches for tests
+ * - **FlightData builders** — Construct FlightData messages without protobuf boilerplate
+ * - **Mock streams** — Create async iterables for testing stream consumers
+ * - **Descriptor helpers** — Build FlightDescriptor inputs easily
+ *
+ * @example
+ * ```ts
+ * import {
+ *   // Table helpers
+ *   createTestTable, createTestBatch,
+ *   // FlightData builders
+ *   createEmptyFlightData, tableToFlightData,
+ *   // Mock streams
+ *   asyncIterable, emptyStream,
+ *   // Descriptor helpers
+ *   pathDescriptor, cmdDescriptor
+ * } from "@qualithm/arrow-flight-client/testing"
+ *
+ * // Create test data
+ * const table = createTestTable({ id: [1, 2, 3], value: [1.1, 2.2, 3.3] })
+ *
+ * // Build FlightData from table
+ * const flightData = await tableToFlightData(table)
+ *
+ * // Create mock streams
+ * const stream = asyncIterable(flightData)
+ *
+ * // Build descriptors
+ * const descriptor = pathDescriptor("test", "integers")
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Table helpers
+export { createFloatTable, createIntegerTable, createStringTable, createTestBatch, createTestTable } from "./helpers.js";
+// FlightData builders
+export { batchesToFlightData, collectFlightData, createEmptyFlightData, tableToFlightData } from "./builders.js";
+// Mock streams
+export { asyncIterable, concatStreams, delayedIterable, emptyStream, errorAfter } from "./streams.js";
+// Descriptor helpers
+export { cmdDescriptor, pathDescriptor } from "./descriptors.js";
+// Re-export proto schemas for advanced test fixture construction
+export { FlightDataSchema, FlightDescriptor_DescriptorType, FlightDescriptorSchema, FlightEndpointSchema, FlightInfoSchema, TicketSchema } from "../gen/arrow/flight/Flight_pb.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,gBAAgB;AAChB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EAEhB,MAAM,cAAc,CAAA;AAErB,sBAAsB;AACtB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,eAAe,CAAA;AAEtB,eAAe;AACf,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACX,MAAM,cAAc,CAAA;AAErB,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEhE,iEAAiE;AACjE,OAAO,EACL,gBAAgB,EAChB,+BAA+B,EAC/B,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACb,MAAM,kCAAkC,CAAA"}

package/dist/testing/streams.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Mock stream utilities for testing stream consumers.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create an async iterable from an array of items.
+ *
+ * Useful for testing stream consumers with predetermined data.
+ *
+ * @param items - Array of items to yield
+ * @returns Async iterable that yields each item
+ *
+ * @example
+ * ```ts
+ * const flightData = [createEmptyFlightData()]
+ * const stream = asyncIterable(flightData)
+ *
+ * for await (const data of stream) {
+ *   console.log(data)
+ * }
+ * ```
+ */
+export declare function asyncIterable<T>(items: T[]): AsyncGenerator<T>;
+/**
+ * Create an empty async iterable.
+ *
+ * Useful for testing edge cases with empty streams.
+ *
+ * @returns Empty async iterable
+ *
+ * @example
+ * ```ts
+ * const stream = emptyStream()
+ * const result = await collectFlightData(stream)
+ * expect(result).toEqual([])
+ * ```
+ */
+export declare function emptyStream<T>(): AsyncIterable<T>;
+/**
+ * Concatenate multiple async iterables into one.
+ *
+ * @param streams - Async iterables to concatenate
+ * @returns Combined async iterable
+ *
+ * @example
+ * ```ts
+ * const stream1 = asyncIterable([data1])
+ * const stream2 = asyncIterable([data2, data3])
+ * const combined = concatStreams(stream1, stream2)
+ *
+ * // Yields data1, data2, data3 in order
+ * ```
+ */
+export declare function concatStreams<T>(...streams: AsyncIterable<T>[]): AsyncIterable<T>;
+/**
+ * Create an async iterable that yields items with delays.
+ *
+ * Useful for testing timeout handling and streaming behavior.
+ *
+ * @param items - Array of items to yield
+ * @param delayMs - Delay between items in milliseconds
+ * @returns Async iterable with delays
+ *
+ * @example
+ * ```ts
+ * const stream = delayedIterable([data1, data2], 100)
+ * // Yields data1, waits 100ms, yields data2
+ * ```
+ */
+export declare function delayedIterable<T>(items: T[], delayMs: number): AsyncIterable<T>;
+/**
+ * Create an async iterable that throws an error after yielding some items.
+ *
+ * Useful for testing error handling in stream consumers.
+ *
+ * @param items - Items to yield before throwing
+ * @param error - Error to throw
+ * @returns Async iterable that throws
+ *
+ * @example
+ * ```ts
+ * const stream = errorAfter([data1], new Error("connection lost"))
+ * // Yields data1, then throws Error
+ * ```
+ */
+export declare function errorAfter<T>(items: T[], error: Error): AsyncGenerator<T>;
+//# sourceMappingURL=streams.d.ts.map

package/dist/testing/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/testing/streams.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAIrE;AAED;;;;;;;;;;;;;GAaG;AAEH,wBAAuB,WAAW,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAExD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAMxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAuB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAOvF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAuB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,CAKhF"}

package/dist/testing/streams.js

@@ -0,0 +1,112 @@
+/**
+ * Mock stream utilities for testing stream consumers.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Create an async iterable from an array of items.
+ *
+ * Useful for testing stream consumers with predetermined data.
+ *
+ * @param items - Array of items to yield
+ * @returns Async iterable that yields each item
+ *
+ * @example
+ * ```ts
+ * const flightData = [createEmptyFlightData()]
+ * const stream = asyncIterable(flightData)
+ *
+ * for await (const data of stream) {
+ *   console.log(data)
+ * }
+ * ```
+ */
+export async function* asyncIterable(items) {
+    for (const item of items) {
+        yield await Promise.resolve(item);
+    }
+}
+/**
+ * Create an empty async iterable.
+ *
+ * Useful for testing edge cases with empty streams.
+ *
+ * @returns Empty async iterable
+ *
+ * @example
+ * ```ts
+ * const stream = emptyStream()
+ * const result = await collectFlightData(stream)
+ * expect(result).toEqual([])
+ * ```
+ */
+export async function* emptyStream() {
+    // Yields nothing
+}
+/**
+ * Concatenate multiple async iterables into one.
+ *
+ * @param streams - Async iterables to concatenate
+ * @returns Combined async iterable
+ *
+ * @example
+ * ```ts
+ * const stream1 = asyncIterable([data1])
+ * const stream2 = asyncIterable([data2, data3])
+ * const combined = concatStreams(stream1, stream2)
+ *
+ * // Yields data1, data2, data3 in order
+ * ```
+ */
+export async function* concatStreams(...streams) {
+    for (const stream of streams) {
+        for await (const item of stream) {
+            yield item;
+        }
+    }
+}
+/**
+ * Create an async iterable that yields items with delays.
+ *
+ * Useful for testing timeout handling and streaming behavior.
+ *
+ * @param items - Array of items to yield
+ * @param delayMs - Delay between items in milliseconds
+ * @returns Async iterable with delays
+ *
+ * @example
+ * ```ts
+ * const stream = delayedIterable([data1, data2], 100)
+ * // Yields data1, waits 100ms, yields data2
+ * ```
+ */
+export async function* delayedIterable(items, delayMs) {
+    for (let i = 0; i < items.length; i++) {
+        if (i > 0) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+        yield items[i];
+    }
+}
+/**
+ * Create an async iterable that throws an error after yielding some items.
+ *
+ * Useful for testing error handling in stream consumers.
+ *
+ * @param items - Items to yield before throwing
+ * @param error - Error to throw
+ * @returns Async iterable that throws
+ *
+ * @example
+ * ```ts
+ * const stream = errorAfter([data1], new Error("connection lost"))
+ * // Yields data1, then throws Error
+ * ```
+ */
+export async function* errorAfter(items, error) {
+    for (const item of items) {
+        yield await Promise.resolve(item);
+    }
+    throw error;
+}
+//# sourceMappingURL=streams.js.map

package/dist/testing/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../../src/testing/streams.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAAI,KAAU;IAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW;IAChC,iBAAiB;AACnB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAAI,GAAG,OAA2B;IACpE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,CAAA;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,eAAe,CAAI,KAAU,EAAE,OAAe;IACnE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAC9D,CAAC;QACD,MAAM,KAAK,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAAI,KAAU,EAAE,KAAY;IAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,MAAM,KAAK,CAAA;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qualithm/arrow-flight-client",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Unified Arrow Flight and Flight SQL client for JavaScript and TypeScript runtimes.",
   "private": false,
   "type": "module",
@@ -12,6 +12,7 @@
     "apache-arrow",
     "typescript"
   ],
+  "sideEffects": false,
   "license": "Apache-2.0",
   "author": "Qualithm",
   "repository": {
@@ -28,9 +29,17 @@
   "exports": {
     ".": {
       "bun": "./dist/index.js",
+      "deno": "./dist/index.js",
       "node": "./dist/index.js",
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./testing": {
+      "bun": "./dist/testing/index.js",
+      "deno": "./dist/testing/index.js",
+      "node": "./dist/testing/index.js",
+      "import": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
     }
   },
   "files": [
@@ -46,7 +55,7 @@
     "bench:ipc": "bun run bench/ipc.ts",
     "bench": "bun run bench/index.ts",
     "build:watch": "tsc -p tsconfig.build.json --watch",
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && cp -r src/gen dist/gen",
     "clean": "rm -rf dist",
     "dev": "bun --watch run src/index.ts",
     "docs": "typedoc",
@@ -73,12 +82,12 @@
     "apache-arrow": "^21.1.0"
   },
   "devDependencies": {
-    "@bufbuild/buf": "^1.66.0",
+    "@bufbuild/buf": "^1.66.1",
     "@bufbuild/protoc-gen-es": "^2.11.0",
     "@eslint/js": "10.0.1",
     "@types/bun": "1.3.10",
-    "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "10.0.2",
+    "@vitest/coverage-v8": "^4.1.0",
+    "eslint": "10.0.3",
     "eslint-plugin-simple-import-sort": "12.1.1",
     "eslint-plugin-unused-imports": "4.4.1",
     "globals": "17.4.0",
@@ -86,10 +95,11 @@
     "prettier": "3.8.1",
     "typedoc": "0.28.17",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.56.1",
-    "vitest": "^4.0.18"
+    "typescript-eslint": "8.57.0",
+    "vitest": "^4.1.0"
   },
   "overrides": {
+    "flatted": "3.4.2",
     "minimatch": "10.2.3",
     "undici": "6.23.0"
   }