@query-farm/vgi-rpc 0.1.0

package/dist/client/pipe.d.ts

@@ -0,0 +1,63 @@
+import { Schema } from "apache-arrow";
+import { IpcStreamReader } from "../wire/reader.js";
+import type { LogMessage, PipeConnectOptions, SubprocessConnectOptions, StreamSession } from "./types.js";
+import type { RpcClient } from "./connect.js";
+interface PipeWritable {
+    write(data: Uint8Array): void;
+    flush?(): void;
+    end(): void;
+}
+type WriteFn = (bytes: Uint8Array) => void;
+export declare class PipeStreamSession implements StreamSession {
+    private _reader;
+    private _writeFn;
+    private _onLog?;
+    private _header;
+    private _inputWriter;
+    private _inputSchema;
+    private _outputStreamOpened;
+    private _closed;
+    private _outputSchema;
+    private _releaseBusy;
+    private _setDrainPromise;
+    constructor(opts: {
+        reader: IpcStreamReader;
+        writeFn: WriteFn;
+        onLog?: (msg: LogMessage) => void;
+        header: Record<string, any> | null;
+        outputSchema: Schema;
+        releaseBusy: () => void;
+        setDrainPromise: (p: Promise<void>) => void;
+    });
+    get header(): Record<string, any> | null;
+    /**
+     * Read output batches from the server until a data batch is found.
+     * Dispatches log/error batches along the way.
+     * Returns null when server closes output stream (EOS).
+     */
+    private _readOutputBatch;
+    /**
+     * Ensure the server's output stream is opened for reading.
+     * Must be called AFTER sending the first input batch, because
+     * the server's output schema may not be flushed until it processes
+     * the first input and writes the first output batch.
+     */
+    private _ensureOutputStream;
+    /**
+     * Send an exchange request and return the data rows.
+     */
+    exchange(input: Record<string, any>[]): Promise<Record<string, any>[]>;
+    /**
+     * Clean up after an error: close input, drain output, release busy.
+     */
+    private _cleanup;
+    /**
+     * Iterate over producer stream batches (lockstep).
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<Record<string, any>[]>;
+    close(): void;
+}
+export declare function pipeConnect(readable: ReadableStream<Uint8Array>, writable: PipeWritable, options?: PipeConnectOptions): RpcClient;
+export declare function subprocessConnect(cmd: string[], options?: SubprocessConnectOptions): RpcClient;
+export {};
+//# sourceMappingURL=pipe.d.ts.map

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

@@ -0,0 +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"}

package/dist/client/stream.d.ts

@@ -0,0 +1,52 @@
+import { RecordBatch, Schema } from "apache-arrow";
+import type { LogMessage, StreamSession } from "./types.js";
+type CompressFn = (data: Uint8Array, level: number) => Uint8Array;
+type DecompressFn = (data: Uint8Array) => Uint8Array;
+export declare class HttpStreamSession implements StreamSession {
+    private _baseUrl;
+    private _prefix;
+    private _method;
+    private _stateToken;
+    private _outputSchema;
+    private _inputSchema?;
+    private _onLog?;
+    private _pendingBatches;
+    private _finished;
+    private _header;
+    private _compressionLevel?;
+    private _compressFn?;
+    private _decompressFn?;
+    constructor(opts: {
+        baseUrl: string;
+        prefix: string;
+        method: string;
+        stateToken: string | null;
+        outputSchema: Schema;
+        inputSchema?: Schema;
+        onLog?: (msg: LogMessage) => void;
+        pendingBatches: RecordBatch[];
+        finished: boolean;
+        header: Record<string, any> | null;
+        compressionLevel?: number;
+        compressFn?: CompressFn;
+        decompressFn?: DecompressFn;
+    });
+    get header(): Record<string, any> | null;
+    private _buildHeaders;
+    private _prepareBody;
+    private _readResponse;
+    /**
+     * Send an exchange request and return the data rows.
+     */
+    exchange(input: Record<string, any>[]): Promise<Record<string, any>[]>;
+    private _doExchange;
+    private _buildEmptyBatch;
+    /**
+     * Iterate over producer stream batches.
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<Record<string, any>[]>;
+    private _sendContinuation;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +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"}

package/dist/client/types.d.ts

@@ -0,0 +1,25 @@
+export interface HttpConnectOptions {
+    prefix?: string;
+    onLog?: (msg: LogMessage) => void;
+    compressionLevel?: number;
+}
+export interface LogMessage {
+    level: string;
+    message: string;
+    extra?: Record<string, any>;
+}
+export interface StreamSession {
+    readonly header: Record<string, any> | null;
+    exchange(input: Record<string, any>[]): Promise<Record<string, any>[]>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<Record<string, any>[]>;
+    close(): void;
+}
+export interface PipeConnectOptions {
+    onLog?: (msg: LogMessage) => void;
+}
+export interface SubprocessConnectOptions extends PipeConnectOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    stderr?: "inherit" | "pipe" | "ignore";
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACvE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CACxC"}

package/dist/constants.d.ts

@@ -0,0 +1,15 @@
+/** Well-known metadata keys matching Python's metadata.py */
+export declare const RPC_METHOD_KEY = "vgi_rpc.method";
+export declare const LOG_LEVEL_KEY = "vgi_rpc.log_level";
+export declare const LOG_MESSAGE_KEY = "vgi_rpc.log_message";
+export declare const LOG_EXTRA_KEY = "vgi_rpc.log_extra";
+export declare const REQUEST_VERSION_KEY = "vgi_rpc.request_version";
+export declare const REQUEST_VERSION = "1";
+export declare const SERVER_ID_KEY = "vgi_rpc.server_id";
+export declare const REQUEST_ID_KEY = "vgi_rpc.request_id";
+export declare const PROTOCOL_NAME_KEY = "vgi_rpc.protocol_name";
+export declare const DESCRIBE_VERSION_KEY = "vgi_rpc.describe_version";
+export declare const DESCRIBE_VERSION = "2";
+export declare const DESCRIBE_METHOD_NAME = "__describe__";
+export declare const STATE_KEY = "vgi_rpc.stream_state#b64";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAE7D,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,mBAAmB,4BAA4B,CAAC;AAC7D,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AACzD,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAC/D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD,eAAO,MAAM,SAAS,6BAA6B,CAAC"}

package/dist/dispatch/describe.d.ts

@@ -0,0 +1,14 @@
+import { Schema, RecordBatch } from "apache-arrow";
+import type { MethodDefinition } from "../types.js";
+/**
+ * The schema for the __describe__ response, matching Python's _DESCRIBE_SCHEMA.
+ */
+export declare const DESCRIBE_SCHEMA: Schema<any>;
+/**
+ * Build the __describe__ response batch and metadata.
+ */
+export declare function buildDescribeBatch(protocolName: string, methods: Map<string, MethodDefinition>, serverId: string): {
+    batch: RecordBatch;
+    metadata: Map<string, string>;
+};
+//# sourceMappingURL=describe.d.ts.map

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

@@ -0,0 +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"}

package/dist/dispatch/stream.d.ts

@@ -0,0 +1,20 @@
+import type { MethodDefinition } from "../types.js";
+import type { IpcStreamWriter } from "../wire/writer.js";
+import type { IpcStreamReader } from "../wire/reader.js";
+/**
+ * Dispatch a stream RPC call (producer or exchange).
+ *
+ * Producer streams (empty input schema):
+ * - Client sends tick batches (empty schema, 0 rows)
+ * - Server reads each tick, calls produce(state, out)
+ * - Server writes output batch(es) for each tick
+ * - When produce() calls out.finish(), server closes output stream
+ *
+ * Exchange streams (real input schema):
+ * - Client sends data batches
+ * - Server reads each batch, calls exchange(state, input, out)
+ * - Server writes output batch(es) for each input
+ * - Stream ends when client closes input (EOS)
+ */
+export declare function dispatchStream(method: MethodDefinition, params: Record<string, any>, writer: IpcStreamWriter, reader: IpcStreamReader, serverId: string, requestId: string | null): Promise<void>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +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"}

package/dist/dispatch/unary.d.ts

@@ -0,0 +1,9 @@
+import type { MethodDefinition } from "../types.js";
+import type { IpcStreamWriter } from "../wire/writer.js";
+/**
+ * Dispatch a unary RPC call.
+ * Calls the handler with parsed params, writes result or error batch.
+ * Supports client-directed logging via ctx.clientLog().
+ */
+export declare function dispatchUnary(method: MethodDefinition, params: Record<string, any>, writer: IpcStreamWriter, serverId: string, requestId: string | null): Promise<void>;
+//# sourceMappingURL=unary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unary.d.ts","sourceRoot":"","sources":["../../src/dispatch/unary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/** Error thrown when the server encounters an RPC protocol error. */
+export declare class RpcError extends Error {
+    readonly errorType: string;
+    readonly errorMessage: string;
+    readonly remoteTraceback: string;
+    constructor(errorType: string, errorMessage: string, remoteTraceback: string);
+}
+/** Error thrown when the client sends an unsupported request version. */
+export declare class VersionError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,qBAAa,QAAS,SAAQ,KAAK;aAEf,SAAS,EAAE,MAAM;aACjB,YAAY,EAAE,MAAM;aACpB,eAAe,EAAE,MAAM;gBAFvB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM;CAK1C;AAED,yEAAyE;AACzE,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/http/common.d.ts

@@ -0,0 +1,16 @@
+import { RecordBatch, Schema } from "apache-arrow";
+export declare const ARROW_CONTENT_TYPE = "application/vnd.apache.arrow.stream";
+export declare class HttpRpcError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+/** Serialize a schema + batches into a complete IPC stream as Uint8Array. */
+export declare function serializeIpcStream(schema: Schema, batches: RecordBatch[]): Uint8Array;
+/** Create a Response with Arrow IPC content type. Casts Uint8Array for TS lib compat. */
+export declare function arrowResponse(body: Uint8Array, status?: number, extraHeaders?: Headers): Response;
+/** Read schema + first batch from an IPC stream body. */
+export declare function readRequestFromBody(body: Uint8Array): Promise<{
+    schema: Schema;
+    batch: RecordBatch;
+}>;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +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"}

package/dist/http/dispatch.d.ts

@@ -0,0 +1,18 @@
+import type { MethodDefinition } from "../types.js";
+import type { StateSerializer } from "./types.js";
+export interface DispatchContext {
+    signingKey: Uint8Array;
+    tokenTtl: number;
+    serverId: string;
+    maxStreamResponseBytes?: number;
+    stateSerializer: StateSerializer;
+}
+/** Dispatch a __describe__ request. */
+export declare function httpDispatchDescribe(protocolName: string, methods: Map<string, MethodDefinition>, serverId: string): Response;
+/** Dispatch a unary HTTP request. */
+export declare function httpDispatchUnary(method: MethodDefinition, body: Uint8Array, ctx: DispatchContext): Promise<Response>;
+/** Dispatch a stream init HTTP request (producer or exchange). */
+export declare function httpDispatchStreamInit(method: MethodDefinition, body: Uint8Array, ctx: DispatchContext): Promise<Response>;
+/** Dispatch a stream exchange HTTP request (producer continuation or exchange round). */
+export declare function httpDispatchStreamExchange(method: MethodDefinition, body: Uint8Array, ctx: DispatchContext): Promise<Response>;
+//# sourceMappingURL=dispatch.d.ts.map

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

@@ -0,0 +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"}

package/dist/http/handler.d.ts

@@ -0,0 +1,16 @@
+import type { Protocol } from "../protocol.js";
+import { type HttpHandlerOptions } from "./types.js";
+/**
+ * Create a fetch-compatible HTTP handler for a vgi-rpc Protocol.
+ *
+ * Compatible with Bun.serve(), Deno.serve(), Cloudflare Workers, and any
+ * Web API runtime that uses the standard Request/Response types.
+ *
+ * @example
+ * ```typescript
+ * const handler = createHttpHandler(protocol);
+ * Bun.serve({ port: 8080, fetch: handler });
+ * ```
+ */
+export declare function createHttpHandler(protocol: Protocol, options?: HttpHandlerOptions): (request: Request) => Response | Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/http/handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAiB1E;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6MpD"}

package/dist/http/index.d.ts

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

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

@@ -0,0 +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"}

package/dist/http/token.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pack a state token matching the Python v2 wire format.
+ *
+ * Layout:
+ *   [1B version=2]
+ *   [8B created_at uint64 LE (seconds since epoch)]
+ *   [4B state_len uint32 LE] [state_len bytes]
+ *   [4B schema_len uint32 LE] [schema_len bytes]
+ *   [4B input_schema_len uint32 LE] [input_schema_len bytes]
+ *   [32B HMAC-SHA256(signing_key, all above bytes)]
+ */
+export declare function packStateToken(stateBytes: Uint8Array, schemaBytes: Uint8Array, inputSchemaBytes: Uint8Array, signingKey: Uint8Array, createdAt?: number): string;
+export interface UnpackedToken {
+    stateBytes: Uint8Array;
+    schemaBytes: Uint8Array;
+    inputSchemaBytes: Uint8Array;
+    createdAt: number;
+}
+/**
+ * Unpack and verify a state token.
+ * Throws on tampered, expired, or malformed tokens.
+ */
+export declare function unpackStateToken(tokenBase64: string, signingKey: Uint8Array, tokenTtl: number): UnpackedToken;
+//# sourceMappingURL=token.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/http/token.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,UAAU,EACvB,gBAAgB,EAAE,UAAU,EAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAuCR;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,UAAU,CAAC;IACxB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,aAAa,CAiEf"}

package/dist/http/types.d.ts

@@ -0,0 +1,30 @@
+/** Configuration options for createHttpHandler(). */
+export interface HttpHandlerOptions {
+    /** URL path prefix for all endpoints. Default: "/vgi" */
+    prefix?: string;
+    /** HMAC-SHA256 signing key for state tokens. Random 32 bytes if omitted. */
+    signingKey?: Uint8Array;
+    /** State token time-to-live in seconds. Default: 3600 (1 hour). 0 disables TTL checks. */
+    tokenTtl?: number;
+    /** CORS allowed origins. If set, CORS headers are added to all responses. */
+    corsOrigins?: string;
+    /** Maximum request body size in bytes. Advertised via VGI-Max-Request-Bytes header. */
+    maxRequestBytes?: number;
+    /** Maximum bytes before a producer stream emits a continuation token. */
+    maxStreamResponseBytes?: number;
+    /** Server ID included in response metadata. Random if omitted. */
+    serverId?: string;
+    /** Custom state serializer for stream state objects. Default: JSON with BigInt support. */
+    stateSerializer?: StateSerializer;
+    /** zstd compression level for responses (1-22). If set, responses are
+     *  compressed when the client sends Accept-Encoding: zstd. */
+    compressionLevel?: number;
+}
+/** Serializer for stream state objects stored in state tokens. */
+export interface StateSerializer {
+    serialize(state: any): Uint8Array;
+    deserialize(bytes: Uint8Array): any;
+}
+/** Default state serializer using JSON (with BigInt support). */
+export declare const jsonStateSerializer: StateSerializer;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAGA,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;kEAC8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,UAAU,CAAC;IAClC,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC;CACrC;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,EAAE,eAejC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { VgiRpcServer } from "./server.js";
+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 { 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

@@ -0,0 +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"}