npm - @qualithm/arrow-flight-sql-js - Versions diffs - 0.3.0 → 0.4.1 - Mend

@qualithm/arrow-flight-sql-js 0.3.0 → 0.4.1

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.

Files changed (19) hide show

package/README.md CHANGED Viewed

@@ -17,18 +17,6 @@ servers. It handles the complete protocol stack:
 - **Arrow IPC Streaming** – Native Arrow record batch handling
 - **Authentication** – Bearer tokens, basic auth, and custom handlers
-## Design Goals
-Arrow Flight SQL JS is modeled on the canonical implementations:
-| Reference                 | What We Adopt                                        |
-| ------------------------- | ---------------------------------------------------- |
-| **Java** (reference impl) | Comprehensive API surface, error handling patterns   |
-| **C++**                   | Streaming-first patterns, performance considerations |
-| **Go**                    | Connection pooling, context/cancellation model       |
-We aim for **API parity** with the official clients where JavaScript idioms allow.
 ## Installation
 ```bash
@@ -121,85 +109,69 @@ await pool.withConnection(async (client) => {
 await pool.close()
 ```
-## Real-Time Subscriptions
+## Streaming Best Practices
-Subscribe to live data updates using the `DoExchange` bidirectional streaming protocol:
+Arrow Flight SQL is streaming-first by design. For large result sets, use streaming to minimize
+memory usage:
 ```typescript
-import { FlightSqlClient, SubscriptionMode } from "@qualithm/arrow-flight-sql-js"
+// ✅ GOOD: Stream results for memory efficiency
+const result = await client.query("SELECT * FROM large_table")
+let totalRows = 0
-const client = new FlightSqlClient({
-  host: "localhost",
-  port: 31337,
-  tls: true,
-  auth: { type: "bearer", token: "your-bearer-token" }
-})
+for await (const batch of result.stream()) {
+  // Process one batch at a time - memory-efficient
+  totalRows += batch.numRows
+  await processRecordBatch(batch) // Your processing logic
+}
+console.log(`Processed ${totalRows} rows`)
-await client.connect()
+// ❌ AVOID: collect() loads entire result into memory
+// const table = await result.collect()  // May cause OOM for large results!
-// Subscribe to real-time updates
-const subscription = client.subscribe("SELECT * FROM events WHERE status = 'pending'", {
-  mode: SubscriptionMode.ChangesOnly, // Full | ChangesOnly | Tail
-  heartbeatMs: 30_000 // Server heartbeat interval
-})
+// ✅ GOOD: Process with backpressure-aware async iteration
+async function processWithBackpressure(result: QueryResult) {
+  const stream = result.stream()
-// Consume batches as they arrive
-for await (const batch of subscription) {
-  console.log(`Received ${batch.numRows} rows`)
+  for await (const batch of stream) {
+    // Async work in the loop naturally creates backpressure
+    // The stream won't fetch the next batch until this completes
+    await uploadToS3(batch)
+  }
 }
-// Or with cancellation
-const controller = new AbortController()
-const cancelableSubscription = client.subscribe(query, {
-  signal: controller.signal,
-  autoReconnect: true,
-  maxReconnectAttempts: 10
-})
+// ✅ GOOD: Early termination with break
+async function findFirst(result: QueryResult, predicate: (row: any) => boolean) {
+  for await (const batch of result.stream()) {
+    for (let i = 0; i < batch.numRows; i++) {
+      const row = batch.get(i)
+      if (predicate(row)) {
+        return row // Stream automatically cleaned up
+      }
+    }
+  }
+  return null
+}
-// Later: cancel the subscription
-controller.abort()
+// ✅ GOOD: Use LIMIT at the SQL level when possible
+const limitedResult = await client.query("SELECT * FROM large_table LIMIT 1000")
+const table = await limitedResult.collect() // Safe with LIMIT
-// Or manually unsubscribe
-await cancelableSubscription.unsubscribe()
+// ✅ GOOD: Monitor memory with batch sizes
+for await (const batch of result.stream()) {
+  console.log(`Batch: ${batch.numRows} rows, ~${batch.byteLength} bytes`)
+}
 ```
-### Subscription Options
-| Option                 | Default       | Description                                        |
-| ---------------------- | ------------- | -------------------------------------------------- |
-| `mode`                 | `ChangesOnly` | Subscription mode (Full, ChangesOnly, Tail)        |
-| `heartbeatMs`          | `30000`       | Server heartbeat interval in milliseconds          |
-| `signal`               | -             | AbortSignal for cancellation                       |
-| `autoReconnect`        | `true`        | Auto-reconnect on connection loss                  |
-| `maxReconnectAttempts` | `10`          | Maximum reconnection attempts                      |
-| `reconnectDelayMs`     | `1000`        | Initial reconnect delay                            |
-| `maxReconnectDelayMs`  | `30000`       | Maximum reconnect delay (with exponential backoff) |
-### Low-Level DoExchange
+### When to Use `collect()` vs `stream()`
-For custom bidirectional protocols:
-```typescript
-const exchange = client.doExchange({
-  type: DescriptorType.CMD,
-  cmd: new TextEncoder().encode("CUSTOM_COMMAND")
-})
-// Send data to server
-await exchange.send({
-  dataHeader: new Uint8Array(),
-  dataBody: new Uint8Array(),
-  appMetadata: new TextEncoder().encode(JSON.stringify({ action: "subscribe" }))
-})
-// Receive data from server
-for await (const data of exchange) {
-  console.log("Received:", data)
-}
-// Half-close (signal end of client stream)
-await exchange.end()
-```
+| Scenario                       | Recommendation                                         |
+| ------------------------------ | ------------------------------------------------------ |
+| Small result sets (<100K rows) | `collect()` is fine                                    |
+| Large/unknown result size      | Use `stream()` with batch processing                   |
+| Need aggregations              | Stream and aggregate incrementally                     |
+| Export to file                 | Stream and write chunks                                |
+| Memory-constrained environment | Always `stream()`, never `collect()` unbounded results |
 ## Observability & Metrics
@@ -380,6 +352,26 @@ for (const pk of primaryKeys) {
 // Get foreign key relationships
 const exportedKeys = await client.getExportedKeys("users") // Keys referencing this table
 const importedKeys = await client.getImportedKeys("orders") // Keys this table references
+// Get cross-reference between two tables
+const refs = await client.getCrossReference({
+  pkTable: "users",
+  fkTable: "orders",
+  pkDbSchema: "public",
+  fkDbSchema: "public"
+})
+// Get server SQL info and capabilities
+const sqlInfo = await client.getSqlInfo()
+for (const info of sqlInfo) {
+  console.log(`Info ${info.infoName}: ${info.value}`)
+}
+// Get supported data types
+const typeInfo = await client.getXdbcTypeInfo()
+for (const t of typeInfo) {
+  console.log(`${t.typeName}: SQL type ${t.dataType}`)
+}
 ```
 ## Prepared Statements
@@ -406,89 +398,29 @@ try {
 }
 ```
-## API Reference
-### FlightSqlClient
-The main client for interacting with Flight SQL servers.
-#### Constructor Options
+## Real-Time Subscriptions
-| Option             | Type                     | Default | Description                     |
-| ------------------ | ------------------------ | ------- | ------------------------------- |
-| `host`             | `string`                 | —       | Server hostname                 |
-| `port`             | `number`                 | —       | Server port                     |
-| `tls`              | `boolean`                | `true`  | Enable TLS                      |
-| `auth`             | `AuthConfig`             | —       | Authentication configuration    |
-| `credentials`      | `ChannelCredentials`     | —       | Custom gRPC channel credentials |
-| `metadata`         | `Record<string, string>` | —       | Custom metadata headers         |
-| `connectTimeoutMs` | `number`                 | `30000` | Connection timeout in ms        |
-| `requestTimeoutMs` | `number`                 | `60000` | Request timeout in ms           |
+> **Note:** Requires server support. Not all Flight SQL servers implement `DoExchange`.
-##### AuthConfig
+Subscribe to live data updates:
 ```typescript
-type AuthConfig =
-  | { type: "bearer"; token: string }
-  | { type: "basic"; username: string; password: string }
-  | { type: "none" }
-```
-#### Methods
-##### Query Execution
-- `query(query: string, options?): Promise<QueryResult>` – Execute SQL, returns result with
-  `stream()` and `collect()` methods
-- `execute(query: string, options?): Promise<FlightInfo>` – _(deprecated)_ Execute SQL, return
-  flight info
-- `executeUpdate(query: string): Promise<bigint>` – Execute DML, return affected rows
-- `prepare(query: string): Promise<PreparedStatement>` – Create prepared statement
-##### Catalog Introspection
-- `getCatalogs(): Promise<string[]>` – List available catalogs
-- `getSchemas(catalog?, schemaPattern?): Promise<Schema[]>` – List schemas
-- `getTables(options?): Promise<Table[]>` – List tables with filters
-- `getTableTypes(): Promise<string[]>` – List table type names
-- `getPrimaryKeys(table, catalog?, schema?): Promise<PrimaryKey[]>` – Get primary keys
-- `getExportedKeys(table, catalog?, schema?): Promise<ForeignKey[]>` – Get exported foreign keys
-- `getImportedKeys(table, catalog?, schema?): Promise<ForeignKey[]>` – Get imported foreign keys
-##### Low-Level Flight Operations
-- `getFlightInfo(descriptor): Promise<FlightInfo>` – Get flight metadata
-- `doGet(ticket): AsyncIterable<RecordBatch>` – Fetch data by ticket
-- `doPut(descriptor, stream): Promise<void>` – Upload Arrow data
-- `doAction(type, body?): AsyncIterable<Result>` – Execute custom action
-##### Connection Management
-- `connect(): Promise<void>` – Establish connection and authenticate
-- `close(): void` – Close connection and release resources
-- `isConnected(): boolean` – Check connection status
+const subscription = client.subscribe("SELECT * FROM events", {
+  mode: SubscriptionMode.ChangesOnly,
+  heartbeatMs: 30_000
+})
-## Architecture
+for await (const batch of subscription) {
+  console.log(`Received ${batch.numRows} rows`)
+}
+// Cancel with AbortController
+controller.abort()
+// Or manually
+await subscription.unsubscribe()
 ```
-┌─────────────────────────────────────────────────────────┐
-│                    FlightSqlClient                      │
-├─────────────────────────────────────────────────────────┤
-│  Query Builder  │  Prepared Statements  │  Catalog API  │
-├─────────────────────────────────────────────────────────┤
-│                   Flight SQL Protocol                   │
-│         (GetFlightInfo, DoGet, DoPut, DoAction)         │
-├─────────────────────────────────────────────────────────┤
-│                  Protocol Buffers Layer                 │
-│            (FlightDescriptor, FlightInfo, etc.)         │
-├─────────────────────────────────────────────────────────┤
-│                    gRPC Transport                       │
-│              (HTTP/2 + TLS + Auth Headers)              │
-├─────────────────────────────────────────────────────────┤
-│                   Connection Pool                       │
-│        (Health checks, reconnection, backoff)           │
-└─────────────────────────────────────────────────────────┘
-```
+See the [API documentation](https://qualithm.github.io/arrow-flight-sql-js/) for full options.
 ## Compatibility
@@ -536,68 +468,6 @@ const result = await client.query("SELECT * FROM my_table")
 - Bidirectional streaming (`DoExchange`, `Handshake`) is not supported
 - Use bearer token auth via `setAuthToken()` instead of `Handshake`
-**Envoy gRPC-Web Proxy Example:**
-```yaml
-# envoy.yaml
-static_resources:
-  listeners:
-    - address:
-        socket_address:
-          address: 0.0.0.0
-          port_value: 8080
-      filter_chains:
-        - filters:
-            - name: envoy.filters.network.http_connection_manager
-              typed_config:
-                "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
-                codec_type: AUTO
-                stat_prefix: ingress_http
-                route_config:
-                  name: local_route
-                  virtual_hosts:
-                    - name: backend
-                      domains: ["*"]
-                      routes:
-                        - match: { prefix: "/" }
-                          route:
-                            cluster: flight_sql_backend
-                      cors:
-                        allow_origin_string_match:
-                          - prefix: "*"
-                        allow_methods: "GET, PUT, DELETE, POST, OPTIONS"
-                        allow_headers: "content-type,x-grpc-web,x-user-agent"
-                        expose_headers: "grpc-status,grpc-message"
-                http_filters:
-                  - name: envoy.filters.http.grpc_web
-                  - name: envoy.filters.http.cors
-                  - name: envoy.filters.http.router
-  clusters:
-    - name: flight_sql_backend
-      connect_timeout: 0.25s
-      type: LOGICAL_DNS
-      http2_protocol_options: {}
-      lb_policy: ROUND_ROBIN
-      load_assignment:
-        cluster_name: flight_sql_backend
-        endpoints:
-          - lb_endpoints:
-              - endpoint:
-                  address:
-                    socket_address:
-                      address: your-flight-sql-server
-                      port_value: 50051
-```
-### Flight SQL Servers
-Tested against:
-- Apache Arrow Flight SQL reference server
-- DuckDB Flight SQL extension
-- DataFusion Ballista
-- Custom lakehouse implementations
 ## Development
 ```bash
@@ -621,23 +491,8 @@ bun run format:fix
 bun run docs
 ```
-## Flight SQL Protocol Reference
-This client implements the
-[Arrow Flight SQL specification](https://arrow.apache.org/docs/format/FlightSql.html):
-- **Flight SQL 13.0** – Current target version
-- Full protobuf message support
-- All standard actions (CreatePreparedStatement, ClosePreparedStatement, etc.)
-- Catalog introspection commands
-- Transaction support (where server supports it)
+Implements [Arrow Flight SQL 13.0](https://arrow.apache.org/docs/format/FlightSql.html).
 ## License
 MIT
-## Related Projects
-- [Apache Arrow](https://arrow.apache.org/) – The Arrow columnar format
-- [Arrow Flight](https://arrow.apache.org/docs/format/Flight.html) – High-performance data transport
-- [Arrow Flight SQL](https://arrow.apache.org/docs/format/FlightSql.html) – SQL over Flight

package/dist/client.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@
  * Modeled after the official Arrow Flight SQL clients (Java, C++, Go).
  */
 import { type RecordBatch, type Schema, type Table } from "apache-arrow";
-import { type Action, type ActionResult, type ActionType, type CatalogInfo, type ExecuteOptions, type FlightData, type FlightDescriptor, type FlightInfo, type FlightSqlClientOptions, type ForeignKeyInfo, type PrimaryKeyInfo, type SchemaInfo, type SchemaResult, type SubscribeOptions, type TableInfo, type TableType, type Ticket } from "./types.js";
+import { type Action, type ActionResult, type ActionType, type CatalogInfo, type ExecuteOptions, type FlightData, type FlightDescriptor, type FlightInfo, type FlightSqlClientOptions, type ForeignKeyInfo, type PrimaryKeyInfo, type SchemaInfo, type SchemaResult, type SqlInfo, type SubscribeOptions, type TableInfo, type TableType, type Ticket, type XdbcTypeInfo } from "./types.js";
 /**
  * Flight SQL client for executing queries and managing data with Arrow Flight SQL servers.
  *
@@ -223,6 +223,73 @@ export declare class FlightSqlClient {
      * ```
      */
     getImportedKeys(table: string, catalog?: string, schema?: string): Promise<ForeignKeyInfo[]>;
+    /**
+     * Get SQL server information and capabilities.
+     *
+     * @param infoCodes - Optional array of specific info codes to retrieve.
+     *                    If omitted, all available info is retrieved.
+     * @returns Array of SQL info name-value pairs
+     *
+     * @example
+     * ```typescript
+     * // Get all server information
+     * const allInfo = await client.getSqlInfo()
+     *
+     * // Get specific info (server name and version)
+     * const info = await client.getSqlInfo([0, 1])
+     * for (const item of info) {
+     *   console.log(`${item.infoName}: ${item.value}`)
+     * }
+     * ```
+     */
+    getSqlInfo(infoCodes?: number[]): Promise<SqlInfo[]>;
+    /**
+     * Parse a SQL info row from the dense union value format.
+     */
+    private parseSqlInfoRow;
+    /**
+     * Get XDBC type information supported by the server.
+     *
+     * @param dataType - Optional specific data type code to retrieve info for.
+     *                   If omitted, all types are retrieved.
+     * @returns Array of XDBC type info objects
+     *
+     * @example
+     * ```typescript
+     * // Get all supported types
+     * const types = await client.getXdbcTypeInfo()
+     * for (const t of types) {
+     *   console.log(`${t.typeName}: SQL type ${t.dataType}`)
+     * }
+     * ```
+     */
+    getXdbcTypeInfo(dataType?: number): Promise<XdbcTypeInfo[]>;
+    /**
+     * Get the foreign key relationships between two tables.
+     *
+     * This returns foreign keys in the foreign key table that reference
+     * the primary key of the primary key table.
+     *
+     * @param options - Options specifying the primary key and foreign key tables
+     * @returns Array of foreign key information
+     *
+     * @example
+     * ```typescript
+     * // Find foreign keys from "orders" table that reference "users" table
+     * const refs = await client.getCrossReference({
+     *   pkTable: "users",
+     *   fkTable: "orders"
+     * })
+     * ```
+     */
+    getCrossReference(options: {
+        pkTable: string;
+        fkTable: string;
+        pkCatalog?: string;
+        pkDbSchema?: string;
+        fkCatalog?: string;
+        fkDbSchema?: string;
+    }): Promise<ForeignKeyInfo[]>;
     /**
      * Helper to fetch catalog results and map rows to typed objects
      */

package/dist/client.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAqB,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAA;~~AAuB3F~~,OAAO,EACL,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,UAAU,EAEf,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EAEnB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAIrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,MAAM,~~EACZ~~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"}
1	+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js CHANGED Viewed

@@ -7,7 +7,7 @@
 import { RecordBatchReader } from "apache-arrow";
 import { collectToTable, parseFlightData, tryParseSchema } from "./arrow.js";
 import { AuthenticationError, ConnectionError, FlightSqlError } from "./errors.js";
-import { encodeActionClosePreparedStatementRequest, encodeActionCreatePreparedStatementRequest, encodeCommandGetCatalogs, encodeCommandGetDbSchemas, encodeCommandGetExportedKeys, encodeCommandGetImportedKeys, encodeCommandGetPrimaryKeys, encodeCommandGetTables, encodeCommandGetTableTypes, encodeCommandPreparedStatementQuery, encodeCommandStatementQuery, encodeCommandStatementUpdate, getBytesField, parseProtoFields, unwrapAny } from "./proto.js";
+import { encodeActionClosePreparedStatementRequest, encodeActionCreatePreparedStatementRequest, encodeCommandGetCatalogs, encodeCommandGetCrossReference, encodeCommandGetDbSchemas, encodeCommandGetExportedKeys, encodeCommandGetImportedKeys, encodeCommandGetPrimaryKeys, encodeCommandGetSqlInfo, encodeCommandGetTables, encodeCommandGetTableTypes, encodeCommandGetXdbcTypeInfo, encodeCommandPreparedStatementQuery, encodeCommandStatementQuery, encodeCommandStatementUpdate, getBytesField, parseProtoFields, unwrapAny } from "./proto.js";
 import { getTransportForRuntime } from "./transport-grpc-js.js";
 import { SubscriptionMessageType, SubscriptionMode } from "./types.js";
 // Default configuration values
@@ -452,6 +452,117 @@ export class FlightSqlClient {
         const flightInfo = await this.getFlightInfo(descriptor);
         return this.fetchForeignKeyResults(flightInfo);
     }
+    /**
+     * Get SQL server information and capabilities.
+     *
+     * @param infoCodes - Optional array of specific info codes to retrieve.
+     *                    If omitted, all available info is retrieved.
+     * @returns Array of SQL info name-value pairs
+     *
+     * @example
+     * ```typescript
+     * // Get all server information
+     * const allInfo = await client.getSqlInfo()
+     *
+     * // Get specific info (server name and version)
+     * const info = await client.getSqlInfo([0, 1])
+     * for (const item of info) {
+     *   console.log(`${item.infoName}: ${item.value}`)
+     * }
+     * ```
+     */
+    async getSqlInfo(infoCodes) {
+        this.ensureConnected();
+        const command = encodeCommandGetSqlInfo(infoCodes);
+        const descriptor = {
+            type: 2, // CMD
+            cmd: command
+        };
+        const flightInfo = await this.getFlightInfo(descriptor);
+        return this.fetchCatalogResults(flightInfo, (row) => this.parseSqlInfoRow(row));
+    }
+    /**
+     * Parse a SQL info row from the dense union value format.
+     */
+    parseSqlInfoRow(row) {
+        const infoName = row.info_name;
+        const value = row.value;
+        return { infoName, value };
+    }
+    /**
+     * Get XDBC type information supported by the server.
+     *
+     * @param dataType - Optional specific data type code to retrieve info for.
+     *                   If omitted, all types are retrieved.
+     * @returns Array of XDBC type info objects
+     *
+     * @example
+     * ```typescript
+     * // Get all supported types
+     * const types = await client.getXdbcTypeInfo()
+     * for (const t of types) {
+     *   console.log(`${t.typeName}: SQL type ${t.dataType}`)
+     * }
+     * ```
+     */
+    async getXdbcTypeInfo(dataType) {
+        this.ensureConnected();
+        const command = encodeCommandGetXdbcTypeInfo(dataType);
+        const descriptor = {
+            type: 2, // CMD
+            cmd: command
+        };
+        const flightInfo = await this.getFlightInfo(descriptor);
+        return this.fetchCatalogResults(flightInfo, (row) => ({
+            typeName: row.type_name,
+            dataType: row.data_type,
+            columnSize: row.column_size,
+            literalPrefix: row.literal_prefix,
+            literalSuffix: row.literal_suffix,
+            createParams: row.create_params,
+            nullable: row.nullable,
+            caseSensitive: row.case_sensitive,
+            searchable: row.searchable,
+            unsignedAttribute: row.unsigned_attribute,
+            fixedPrecScale: row.fixed_prec_scale,
+            autoIncrement: row.auto_increment,
+            localTypeName: row.local_type_name,
+            minimumScale: row.minimum_scale,
+            maximumScale: row.maximum_scale,
+            sqlDataType: row.sql_data_type,
+            datetimeSubcode: row.datetime_subcode,
+            numPrecRadix: row.num_prec_radix,
+            intervalPrecision: row.interval_precision
+        }));
+    }
+    /**
+     * Get the foreign key relationships between two tables.
+     *
+     * This returns foreign keys in the foreign key table that reference
+     * the primary key of the primary key table.
+     *
+     * @param options - Options specifying the primary key and foreign key tables
+     * @returns Array of foreign key information
+     *
+     * @example
+     * ```typescript
+     * // Find foreign keys from "orders" table that reference "users" table
+     * const refs = await client.getCrossReference({
+     *   pkTable: "users",
+     *   fkTable: "orders"
+     * })
+     * ```
+     */
+    async getCrossReference(options) {
+        this.ensureConnected();
+        const command = encodeCommandGetCrossReference(options);
+        const descriptor = {
+            type: 2, // CMD
+            cmd: command
+        };
+        const flightInfo = await this.getFlightInfo(descriptor);
+        return this.fetchForeignKeyResults(flightInfo);
+    }
     /**
      * Helper to fetch catalog results and map rows to typed objects
      */