@query-farm/vgi-rpc 0.2.3 → 0.3.1

package/README.md

@@ -1,19 +1,15 @@
-<p align="center">
-  <a href="https://vgi-rpc.query.farm">
-    <img src="https://vgi-rpc.query.farm/logo-hero.png" alt="VGI — The Vector Gateway Interface" width="200">
-  </a>
-</p>
+[![VGI — The Vector Gateway Interface](https://vgi-rpc.query.farm/logo-hero.png)](https://vgi-rpc.query.farm)
 
 # vgi-rpc
 
 TypeScript server library for the [vgi-rpc](https://vgi-rpc.query.farm) framework. Implements RPC servers that communicate over stdin/stdout using [Apache Arrow](https://arrow.apache.org/) IPC serialization.
 
-Define RPC methods with Arrow-typed schemas, serve them over stdin/stdout, and interact with them using the Python `vgi-rpc` CLI or any vgi-rpc client. Unlike JSON-over-HTTP, structured data stays in Arrow columnar format for efficient transfer.
+Define RPC methods with Arrow-typed schemas, serve them over stdin/stdout, and interact with them using the Python `vgi-rpc` CLI or any `vgi-rpc` client. Unlike JSON-over-HTTP, structured data stays in Arrow columnar format for efficient transfer.
 
 **Key features:**
 
 - **Three method types** — unary (request-response), producer (server-streaming), and exchange (bidirectional-streaming)
-- **Apache Arrow IPC wire format** — efficient columnar serialization compatible with the Python vgi-rpc framework
+- **Apache Arrow IPC wire format** — efficient columnar serialization compatible with the Python `vgi-rpc` framework
 - **Schema shorthand** — declare schemas with `{ name: str, count: int }` instead of manual `Schema`/`Field` construction
 - **Fluent protocol builder** — chain `.unary()`, `.producer()`, `.exchange()` calls to define your service
 - **Type-safe streaming state** — generic `<S>` parameter threads state types through init and produce/exchange functions
@@ -24,10 +20,32 @@ Define RPC methods with Arrow-typed schemas, serve them over stdin/stdout, and i
 ## Installation
 
 ```bash
+# Bun
 bun add @query-farm/vgi-rpc
+
+# npm
+npm install @query-farm/vgi-rpc
+
+# Deno
+deno add npm:@query-farm/vgi-rpc
+```
+
+## Runtime Compatibility
+
+`vgi-rpc` works with [Bun](https://bun.sh/), [Node.js](https://nodejs.org/) 22+, and [Deno](https://deno.land/) 2+. The HTTP handler and HTTP client are fully runtime-agnostic. The subprocess transport (`subprocessConnect`) requires Bun.
+
+### Browser Usage
+
+The HTTP client works in browsers. Use `httpConnect` to call a `vgi-rpc` server from any browser application:
+
+```typescript
+import { httpConnect } from "@query-farm/vgi-rpc";
+
+const client = httpConnect("https://api.example.com");
+const result = await client.call("add", { a: 2, b: 3 });
 ```
 
-Requires [Bun](https://bun.sh/) runtime.
+You will need a bundler (Vite, esbuild, webpack, etc.) that can resolve the `@query-farm/apache-arrow` dependency. Server-only exports (`VgiRpcServer`, `createHttpHandler`, `subprocessConnect`, `pipeConnect`) are not available in browsers.
 
 ## Quick Start
 
@@ -196,7 +214,7 @@ protocol.unary("echo", {
 });
 
 // Equivalent verbose form
-import { Schema, Field, Utf8, Int64, Float64 } from "apache-arrow";
+import { Schema, Field, Utf8, Int64, Float64 } from "@query-farm/apache-arrow";
 
 protocol.unary("echo", {
   params: new Schema([
@@ -221,7 +239,7 @@ protocol.unary("echo", {
 | `float32` | Float32 | `Annotated[float, ArrowType(pa.float32())]` |
 | `bool` | Bool | `bool` |
 
-For complex types (List, Map, Dictionary, nullable fields), use the full `Schema`/`Field` constructors from `apache-arrow`.
+For complex types (List, Map, Dictionary, nullable fields), use the full `Schema`/`Field` constructors from `@query-farm/apache-arrow`.
 
 ## Emitting Output
 
@@ -301,7 +319,7 @@ vgi-rpc --cmd "bun run examples/streaming.ts" call scale factor=2.0
 
 ## Wire Protocol Compatibility
 
-This library implements the same wire protocol as the Python [vgi-rpc](https://github.com/Query-farm/vgi-rpc-python) framework:
+This library implements the same wire protocol as the Python [`vgi-rpc`](https://github.com/Query-farm/vgi-rpc-python) framework:
 
 - Multiple sequential Arrow IPC streams on stdin/stdout
 - Request batches carry method name and version in batch metadata

package/dist/client/introspect.d.ts

@@ -1,4 +1,4 @@
-import { RecordBatch, type Schema } from "apache-arrow";
+import { RecordBatch, type Schema } from "@query-farm/apache-arrow";
 import type { LogMessage } from "./types.js";
 export interface MethodInfo {
     name: string;

package/dist/client/introspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/client/introspect.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAS3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AASD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAoE7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/client/introspect.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AASvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AASD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAoE7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}

package/dist/client/ipc.d.ts

@@ -1,4 +1,4 @@
-import { RecordBatch, Schema, DataType } from "apache-arrow";
+import { RecordBatch, Schema, DataType } from "@query-farm/apache-arrow";
 import { IpcStreamReader } from "../wire/reader.js";
 import type { LogMessage } from "./types.js";
 /** Infer an Arrow DataType from a JS value. */

package/dist/client/ipc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../src/client/ipc.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EAEX,MAAM,EACN,QAAQ,EAST,MAAM,cAAc,CAAC;AAWtB,OAAO,EAAE,eAAe,EAAsB,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,QAAQ,CAOnD;AAyCD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,GACb,UAAU,CAgCZ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CASrD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAChC,OAAO,CAqCT;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAoB1E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,eAAe,CAAC,CAQ1B"}
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../src/client/ipc.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EAEX,MAAM,EACN,QAAQ,EAST,MAAM,0BAA0B,CAAC;AAWlC,OAAO,EAAE,eAAe,EAAsB,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,QAAQ,CAOnD;AAyCD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,GACb,UAAU,CAgCZ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CASrD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAChC,OAAO,CAqCT;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAoB1E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,eAAe,CAAC,CAQ1B"}

package/dist/client/pipe.d.ts

@@ -1,4 +1,4 @@
-import { Schema } from "apache-arrow";
+import { Schema } from "@query-farm/apache-arrow";
 import { IpcStreamReader } from "../wire/reader.js";
 import type { LogMessage, PipeConnectOptions, SubprocessConnectOptions, StreamSession } from "./types.js";
 import type { RpcClient } from "./connect.js";

package/dist/client/pipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../src/client/pipe.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,MAAM,EAKP,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYpD,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C,UAAU,YAAY;IACpB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,GAAG,IAAI,IAAI,CAAC;CACb;AAED,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AA6C3C,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAC,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAA6B;gBAEzC,IAAI,EAAE;QAChB,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;QACnC,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,IAAI,CAAC;QACxB,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;KAC7C;IAUD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED;;;;OAIG;YACW,gBAAgB;IAiB9B;;;;;OAKG;YACW,mBAAmB;IASjC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAmG5E;;OAEG;YACW,QAAQ;IAiBtB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAqD7E,KAAK,IAAI,IAAI;CAoCd;AAMD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACpC,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,SAAS,CAkOX;AAMD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,SAAS,CAuCX"}
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../src/client/pipe.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,MAAM,EAKP,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYpD,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C,UAAU,YAAY;IACpB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,GAAG,IAAI,IAAI,CAAC;CACb;AAED,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AA6C3C,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAC,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAA6B;gBAEzC,IAAI,EAAE;QAChB,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;QACnC,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,IAAI,CAAC;QACxB,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;KAC7C;IAUD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED;;;;OAIG;YACW,gBAAgB;IAiB9B;;;;;OAKG;YACW,mBAAmB;IASjC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAmG5E;;OAEG;YACW,QAAQ;IAiBtB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAqD7E,KAAK,IAAI,IAAI;CAoCd;AAMD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACpC,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,SAAS,CAkOX;AAMD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,SAAS,CAuCX"}

package/dist/client/stream.d.ts

@@ -1,4 +1,4 @@
-import { RecordBatch, Schema } from "apache-arrow";
+import { RecordBatch, Schema } from "@query-farm/apache-arrow";
 import type { LogMessage, StreamSession } from "./types.js";
 type CompressFn = (data: Uint8Array, level: number) => Uint8Array;
 type DecompressFn = (data: Uint8Array) => Uint8Array;

package/dist/client/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/client/stream.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,MAAM,EAKP,MAAM,cAAc,CAAC;AAUtB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;AAClE,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;AAErD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,CAA4B;IAC3C,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,aAAa,CAAC,CAAe;gBAEzB,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;QAClC,cAAc,EAAE,WAAW,EAAE,CAAC;QAC9B,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;QACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IAgBD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,YAAY;YAON,aAAa;IAQ3B;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YA+D9D,WAAW;IA0CzB,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAyC/D,iBAAiB;IA2B/B,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/client/stream.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,MAAM,EAKP,MAAM,0BAA0B,CAAC;AAUlC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;AAClE,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;AAErD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,CAA4B;IAC3C,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,aAAa,CAAC,CAAe;gBAEzB,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;QAClC,cAAc,EAAE,WAAW,EAAE,CAAC;QAC9B,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;QACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IAgBD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,YAAY;YAON,aAAa;IAQ3B;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YA+D9D,WAAW;IA0CzB,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAyC/D,iBAAiB;IA2B/B,KAAK,IAAI,IAAI;CAGd"}

package/dist/dispatch/describe.d.ts

@@ -1,4 +1,4 @@
-import { Schema, RecordBatch } from "apache-arrow";
+import { Schema, RecordBatch } from "@query-farm/apache-arrow";
 import type { MethodDefinition } from "../types.js";
 /**
  * The schema for the __describe__ response, matching Python's _DESCRIBE_SCHEMA.

package/dist/dispatch/describe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/dispatch/describe.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,MAAM,EAEN,WAAW,EAOZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAWpD;;GAEG;AACH,eAAO,MAAM,eAAe,aAW1B,CAAC;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0GvD"}
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/dispatch/describe.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,MAAM,EAEN,WAAW,EAOZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAWpD;;GAEG;AACH,eAAO,MAAM,eAAe,aAW1B,CAAC;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0GvD"}

package/dist/dispatch/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/dispatch/stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,IAAI,CAAC,CAoHf"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/dispatch/stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,IAAI,CAAC,CAmHf"}

package/dist/http/common.d.ts

@@ -1,4 +1,4 @@
-import { RecordBatch, Schema } from "apache-arrow";
+import { RecordBatch, Schema } from "@query-farm/apache-arrow";
 export declare const ARROW_CONTENT_TYPE = "application/vnd.apache.arrow.stream";
 export declare class HttpRpcError extends Error {
     readonly statusCode: number;

package/dist/http/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/http/common.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,WAAW,EACX,MAAM,EAGP,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,kBAAkB,wCAAwC,CAAC;AAExE,qBAAa,YAAa,SAAQ,KAAK;aAGnB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AA8BD,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EAAE,GACrB,UAAU,CAQZ;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,SAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,QAAQ,CAI9F;AAED,yDAAyD;AACzD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC,CAYjD"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/http/common.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,WAAW,EACX,MAAM,EAGP,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,kBAAkB,wCAAwC,CAAC;AAExE,qBAAa,YAAa,SAAQ,KAAK;aAGnB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AA8BD,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EAAE,GACrB,UAAU,CAQZ;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,SAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,QAAQ,CAI9F;AAED,yDAAyD;AACzD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC,CAYjD"}

package/dist/http/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/http/dispatch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAkBpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,QAAQ,EAAE,MAAM,GACf,QAAQ,CAIV;AAED,qCAAqC;AACrC,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,QAAQ,CAAC,CAuBnB;AAED,kEAAkE;AAClE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,QAAQ,CAAC,CAuGnB;AAED,yFAAyF;AACzF,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,QAAQ,CAAC,CA2EnB"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/http/dispatch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAkBpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUlD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,QAAQ,EAAE,MAAM,GACf,QAAQ,CAIV;AAED,qCAAqC;AACrC,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,QAAQ,CAAC,CAuBnB;AAED,kEAAkE;AAClE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,QAAQ,CAAC,CAyGnB;AAED,yFAAyF;AACzF,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,QAAQ,CAAC,CAqHnB"}

package/dist/http/index.d.ts

@@ -1,4 +1,6 @@
 export { createHttpHandler } from "./handler.js";
 export type { HttpHandlerOptions, StateSerializer } from "./types.js";
+export { jsonStateSerializer } from "./types.js";
 export { ARROW_CONTENT_TYPE } from "./common.js";
+export { unpackStateToken, type UnpackedToken } from "./token.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { Protocol } from "./protocol.js";
 export { MethodType, OutputCollector, type LogContext, type MethodDefinition, type UnaryHandler, type HeaderInit, type ProducerInit, type ProducerFn, type ExchangeInit, type ExchangeFn, } from "./types.js";
 export { type SchemaLike, toSchema, inferParamTypes, str, bytes, int, int32, float, float32, bool, } from "./schema.js";
 export { RpcError, VersionError } from "./errors.js";
-export { createHttpHandler, ARROW_CONTENT_TYPE, type HttpHandlerOptions, type StateSerializer, } from "./http/index.js";
+export { createHttpHandler, ARROW_CONTENT_TYPE, type HttpHandlerOptions, type StateSerializer, jsonStateSerializer, unpackStateToken, type UnpackedToken, } from "./http/index.js";
 export { RPC_METHOD_KEY, REQUEST_VERSION_KEY, REQUEST_VERSION, LOG_LEVEL_KEY, LOG_MESSAGE_KEY, LOG_EXTRA_KEY, SERVER_ID_KEY, REQUEST_ID_KEY, PROTOCOL_NAME_KEY, DESCRIBE_VERSION_KEY, DESCRIBE_VERSION, DESCRIBE_METHOD_NAME, STATE_KEY, } from "./constants.js";
 export * from "./client/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,EACV,eAAe,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,UAAU,EACf,QAAQ,EACR,eAAe,EACf,GAAG,EACH,KAAK,EACL,GAAG,EACH,KAAK,EACL,KAAK,EACL,OAAO,EACP,IAAI,GACL,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,EACV,eAAe,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,UAAU,EACf,QAAQ,EACR,eAAe,EACf,GAAG,EACH,KAAK,EACL,GAAG,EACH,KAAK,EACL,KAAK,EACL,OAAO,EACP,IAAI,GACL,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -51,10 +51,10 @@ var init_zstd = __esm(() => {
 });
 
 // src/server.ts
-import { Schema as Schema4 } from "apache-arrow";
+import { Schema as Schema4 } from "@query-farm/apache-arrow";
 
 // src/wire/reader.ts
-import { RecordBatchReader } from "apache-arrow";
+import { RecordBatchReader } from "@query-farm/apache-arrow";
 
 class IpcStreamReader {
   reader;
@@ -127,7 +127,7 @@ class IpcStreamReader {
 // src/wire/writer.ts
 import {
   RecordBatchStreamWriter
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 import { writeSync } from "node:fs";
 var STDOUT_FD = 1;
 function writeAll(fd, data) {
@@ -201,7 +201,7 @@ class IncrementalStream {
 }
 
 // src/wire/request.ts
-import { DataType } from "apache-arrow";
+import { DataType } from "@query-farm/apache-arrow";
 
 // src/constants.ts
 var RPC_METHOD_KEY = "vgi_rpc.method";
@@ -290,7 +290,7 @@ import {
   makeData,
   Struct,
   vectorFromArray
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 function coerceInt64(schema, values) {
   const result = { ...values };
   for (const field of schema.fields) {
@@ -406,10 +406,10 @@ import {
   vectorFromArray as vectorFromArray2,
   makeData as makeData2,
   Struct as Struct2
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 
 // src/util/schema.ts
-import { RecordBatchStreamWriter as RecordBatchStreamWriter2 } from "apache-arrow";
+import { RecordBatchStreamWriter as RecordBatchStreamWriter2 } from "@query-farm/apache-arrow";
 function serializeSchema(schema) {
   const writer = new RecordBatchStreamWriter2;
   writer.reset(undefined, schema);
@@ -508,7 +508,7 @@ function buildDescribeBatch(protocolName, methods, serverId) {
 }
 
 // src/types.ts
-import { RecordBatch as RecordBatch3, recordBatchFromArrays } from "apache-arrow";
+import { RecordBatch as RecordBatch3, recordBatchFromArrays } from "@query-farm/apache-arrow";
 var MethodType;
 ((MethodType2) => {
   MethodType2["UNARY"] = "unary";
@@ -587,10 +587,10 @@ async function dispatchUnary(method, params, writer, serverId, requestId) {
 }
 
 // src/dispatch/stream.ts
-import { Schema as Schema3 } from "apache-arrow";
+import { Schema as Schema3 } from "@query-farm/apache-arrow";
 var EMPTY_SCHEMA = new Schema3([]);
 async function dispatchStream(method, params, writer, reader, serverId, requestId) {
-  const isProducer = !method.inputSchema || method.inputSchema.fields.length === 0;
+  const isProducer = !!method.producerFn;
   let state;
   try {
     if (isProducer) {
@@ -753,7 +753,7 @@ class VgiRpcServer {
   }
 }
 // src/protocol.ts
-import { Schema as Schema6 } from "apache-arrow";
+import { Schema as Schema6 } from "@query-farm/apache-arrow";
 
 // src/schema.ts
 import {
@@ -768,7 +768,7 @@ import {
   Float64,
   Float32,
   Bool as Bool2
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 var str = new Utf82;
 var bytes = new Binary2;
 var int = new Int64;
@@ -887,7 +887,7 @@ class Protocol {
   }
 }
 // src/http/handler.ts
-import { Schema as Schema9 } from "apache-arrow";
+import { Schema as Schema9 } from "@query-farm/apache-arrow";
 import { randomBytes } from "node:crypto";
 
 // src/http/types.ts
@@ -907,7 +907,7 @@ import {
   RecordBatch as RecordBatch4,
   Struct as Struct3,
   makeData as makeData3
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 var ARROW_CONTENT_TYPE = "application/vnd.apache.arrow.stream";
 
 class HttpRpcError extends Error {
@@ -961,7 +961,7 @@ async function readRequestFromBody(body) {
 }
 
 // src/http/dispatch.ts
-import { Schema as Schema8, RecordBatch as RecordBatch5 } from "apache-arrow";
+import { Schema as Schema8, RecordBatch as RecordBatch5, RecordBatchReader as RecordBatchReader3 } from "@query-farm/apache-arrow";
 
 // src/http/token.ts
 import { createHmac, timingSafeEqual } from "node:crypto";
@@ -1042,6 +1042,11 @@ function unpackStateToken(tokenBase64, signingKey, tokenTtl) {
 }
 
 // src/http/dispatch.ts
+async function deserializeSchema(bytes2) {
+  const reader = await RecordBatchReader3.from(bytes2);
+  await reader.open();
+  return reader.schema;
+}
 var EMPTY_SCHEMA4 = new Schema8([]);
 function httpDispatchDescribe(protocolName, methods, serverId) {
   const { batch } = buildDescribeBatch(protocolName, methods, serverId);
@@ -1067,7 +1072,7 @@ async function httpDispatchUnary(method, body, ctx) {
   }
 }
 async function httpDispatchStreamInit(method, body, ctx) {
-  const isProducer = !method.inputSchema || method.inputSchema.fields.length === 0;
+  const isProducer = !!method.producerFn;
   const outputSchema = method.outputSchema;
   const inputSchema = method.inputSchema ?? EMPTY_SCHEMA4;
   const { schema: reqSchema, batch: reqBatch } = await readRequestFromBody(body);
@@ -1126,7 +1131,7 @@ async function httpDispatchStreamInit(method, body, ctx) {
   }
 }
 async function httpDispatchStreamExchange(method, body, ctx) {
-  const isProducer = !method.inputSchema || method.inputSchema.fields.length === 0;
+  const isProducer = !!method.producerFn;
   const { batch: reqBatch } = await readRequestFromBody(body);
   const tokenBase64 = reqBatch.metadata?.get(STATE_KEY);
   if (!tokenBase64) {
@@ -1138,33 +1143,70 @@ async function httpDispatchStreamExchange(method, body, ctx) {
   } catch (error) {
     throw new HttpRpcError(`Invalid state token: ${error.message}`, 400);
   }
-  const state = ctx.stateSerializer.deserialize(unpacked.stateBytes);
-  const outputSchema = state?.__outputSchema ?? method.outputSchema;
-  const inputSchema = method.inputSchema ?? EMPTY_SCHEMA4;
+  let state;
+  try {
+    state = ctx.stateSerializer.deserialize(unpacked.stateBytes);
+  } catch (error) {
+    console.error(`[httpDispatchStreamExchange] state deserialize error:`, error.message);
+    throw new HttpRpcError(`State deserialization failed: ${error.message}`, 500);
+  }
+  let outputSchema;
+  if (unpacked.schemaBytes.length > 0) {
+    outputSchema = await deserializeSchema(unpacked.schemaBytes);
+  } else {
+    outputSchema = state?.__outputSchema ?? method.outputSchema;
+  }
+  let inputSchema;
+  if (unpacked.inputSchemaBytes.length > 0) {
+    inputSchema = await deserializeSchema(unpacked.inputSchemaBytes);
+  } else {
+    inputSchema = method.inputSchema ?? EMPTY_SCHEMA4;
+  }
   const effectiveProducer = state?.__isProducer ?? isProducer;
+  if (process.env.VGI_DISPATCH_DEBUG)
+    console.error(`[httpDispatchStreamExchange] method=${method.name} effectiveProducer=${effectiveProducer} stateKeys=${Object.keys(state || {})}`);
   if (effectiveProducer) {
     return produceStreamResponse(method, state, outputSchema, inputSchema, ctx, null, null);
   } else {
-    const out = new OutputCollector(outputSchema, false, ctx.serverId, null);
+    const out = new OutputCollector(outputSchema, effectiveProducer, ctx.serverId, null);
     try {
-      await method.exchangeFn(state, reqBatch, out);
+      if (method.exchangeFn) {
+        await method.exchangeFn(state, reqBatch, out);
+      } else {
+        await method.producerFn(state, out);
+      }
     } catch (error) {
+      if (process.env.VGI_DISPATCH_DEBUG)
+        console.error(`[httpDispatchStreamExchange] exchange handler error:`, error.message, error.stack?.split(`
+`).slice(0, 5).join(`
+`));
       const errBatch = buildErrorBatch(outputSchema, error, ctx.serverId, null);
       return arrowResponse(serializeIpcStream(outputSchema, [errBatch]), 500);
     }
-    const stateBytes = ctx.stateSerializer.serialize(state);
-    const schemaBytes = serializeSchema(outputSchema);
-    const inputSchemaBytes = serializeSchema(inputSchema);
-    const token = packStateToken(stateBytes, schemaBytes, inputSchemaBytes, ctx.signingKey);
     const batches = [];
-    for (const emitted of out.batches) {
-      const batch = emitted.batch;
-      if (batch.numRows > 0) {
-        const mergedMeta = new Map(batch.metadata ?? []);
-        mergedMeta.set(STATE_KEY, token);
-        batches.push(new RecordBatch5(batch.schema, batch.data, mergedMeta));
-      } else {
-        batches.push(batch);
+    if (out.finished) {
+      for (const emitted of out.batches) {
+        batches.push(emitted.batch);
+      }
+    } else {
+      const stateBytes = ctx.stateSerializer.serialize(state);
+      const schemaBytes = serializeSchema(outputSchema);
+      const inputSchemaBytes = serializeSchema(inputSchema);
+      const token = packStateToken(stateBytes, schemaBytes, inputSchemaBytes, ctx.signingKey);
+      for (const emitted of out.batches) {
+        const batch = emitted.batch;
+        if (batch.numRows > 0) {
+          const mergedMeta = new Map(batch.metadata ?? []);
+          mergedMeta.set(STATE_KEY, token);
+          batches.push(new RecordBatch5(batch.schema, batch.data, mergedMeta));
+        } else {
+          batches.push(batch);
+        }
+      }
+      if (!batches.some((b) => b.metadata?.get(STATE_KEY))) {
+        const tokenMeta = new Map;
+        tokenMeta.set(STATE_KEY, token);
+        batches.push(buildEmptyBatch(outputSchema, tokenMeta));
       }
     }
     return arrowResponse(serializeIpcStream(outputSchema, batches));
@@ -1177,8 +1219,17 @@ async function produceStreamResponse(method, state, outputSchema, inputSchema, c
   while (true) {
     const out = new OutputCollector(outputSchema, true, ctx.serverId, requestId);
     try {
-      await method.producerFn(state, out);
+      if (method.producerFn) {
+        await method.producerFn(state, out);
+      } else {
+        const tickBatch = buildEmptyBatch(inputSchema);
+        await method.exchangeFn(state, tickBatch, out);
+      }
     } catch (error) {
+      if (process.env.VGI_DISPATCH_DEBUG)
+        console.error(`[produceStreamResponse] error:`, error.message, error.stack?.split(`
+`).slice(0, 3).join(`
+`));
       allBatches.push(buildErrorBatch(outputSchema, error, ctx.serverId, requestId));
       break;
     }
@@ -1369,7 +1420,7 @@ function createHttpHandler(protocol, options) {
 // src/client/ipc.ts
 import {
   RecordBatch as RecordBatch6,
-  RecordBatchReader as RecordBatchReader3,
+  RecordBatchReader as RecordBatchReader4,
   DataType as DataType4,
   Float64 as Float642,
   Int64 as Int642,
@@ -1379,7 +1430,7 @@ import {
   vectorFromArray as vectorFromArray3,
   makeData as makeData4,
   Struct as Struct4
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 function inferArrowType(value) {
   if (typeof value === "string")
     return new Utf83;
@@ -1452,7 +1503,7 @@ function buildRequestIpc(schema, params, method) {
   return serializeIpcStream(schema, [batch]);
 }
 async function readResponseBatches(body) {
-  const reader = await RecordBatchReader3.from(body);
+  const reader = await RecordBatchReader4.from(body);
   await reader.open();
   const schema = reader.schema;
   if (!schema) {
@@ -1525,10 +1576,10 @@ async function readSequentialStreams(body) {
 }
 
 // src/client/introspect.ts
-import { RecordBatchReader as RecordBatchReader4 } from "apache-arrow";
-import { Schema as ArrowSchema } from "apache-arrow";
-async function deserializeSchema(bytes2) {
-  const reader = await RecordBatchReader4.from(bytes2);
+import { RecordBatchReader as RecordBatchReader5 } from "@query-farm/apache-arrow";
+import { Schema as ArrowSchema } from "@query-farm/apache-arrow";
+async function deserializeSchema2(bytes2) {
+  const reader = await RecordBatchReader5.from(bytes2);
   await reader.open();
   return reader.schema;
 }
@@ -1558,8 +1609,8 @@ async function parseDescribeResponse(batches, onLog) {
     const paramDefaultsJson = dataBatch.getChildAt(7)?.get(i);
     const hasHeader = dataBatch.getChildAt(8).get(i);
     const headerIpc = dataBatch.getChildAt(9)?.get(i);
-    const paramsSchema = await deserializeSchema(paramsIpc);
-    const resultSchema = await deserializeSchema(resultIpc);
+    const paramsSchema = await deserializeSchema2(paramsIpc);
+    const resultSchema = await deserializeSchema2(resultIpc);
     let paramTypes;
     if (paramTypesJson) {
       try {
@@ -1585,7 +1636,7 @@ async function parseDescribeResponse(batches, onLog) {
       info.outputSchema = resultSchema;
     }
     if (hasHeader && headerIpc) {
-      info.headerSchema = await deserializeSchema(headerIpc);
+      info.headerSchema = await deserializeSchema2(headerIpc);
     }
     methods.push(info);
   }
@@ -1613,7 +1664,7 @@ import {
   makeData as makeData5,
   Struct as Struct5,
   vectorFromArray as vectorFromArray4
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 class HttpStreamSession {
   _baseUrl;
   _prefix;
@@ -2030,7 +2081,7 @@ import {
   Struct as Struct6,
   makeData as makeData6,
   vectorFromArray as vectorFromArray5
-} from "apache-arrow";
+} from "@query-farm/apache-arrow";
 class PipeIncrementalWriter {
   writer;
   writeFn;
@@ -2455,11 +2506,13 @@ function subprocessConnect(cmd, options) {
   return client;
 }
 export {
+  unpackStateToken,
   toSchema,
   subprocessConnect,
   str,
   pipeConnect,
   parseDescribeResponse,
+  jsonStateSerializer,
   int32,
   int,
   inferParamTypes,
@@ -2494,4 +2547,4 @@ export {
   ARROW_CONTENT_TYPE
 };
 
-//# debugId=914A07BF446ED9ED64756E2164756E21
+//# debugId=90D671AA0075054164756E2164756E21