@query-farm/vgi-rpc 0.6.3 → 0.7.0

package/dist/access-log.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Cross-language conformance access-log hook.
+ *
+ * Emits one JSON record per RPC dispatch to a {@link Sink} (typically a file
+ * descriptor opened in append mode).  The record shape conforms to the
+ * vgi-rpc access-log specification (`docs/access-log-spec.md` and
+ * `vgi_rpc/access_log.schema.json` in the Python reference repo).
+ *
+ * Use {@link AccessLogHook} to align this implementation with `vgi-rpc-test
+ * --access-log` so worker behaviour is checked across language ports by the
+ * same tool that gates the conformance suite.
+ */
+import type { CallStatistics, DispatchHook, DispatchInfo, HookToken } from "./types.js";
+/** Where the hook writes formatted JSON lines. */
+export interface AccessLogSink {
+    write(line: string): void;
+}
+/** A sink backed by a file descriptor; uses synchronous writes for ordering. */
+export declare class FdSink implements AccessLogSink {
+    private readonly fd;
+    private readonly _writeSync;
+    constructor(fd: number);
+    write(line: string): void;
+}
+/**
+ * Options for {@link AccessLogHook}.
+ *
+ * `level` matches Python's logger-level gating in `_emit_access_log`:
+ * at "INFO" the heavy `request_data` field (a base64 of the full
+ * request batch — typically 8+ KiB per init RPC) is replaced with a
+ * `truncated: true` marker plus `original_request_bytes`, so the
+ * access-log schema's "unary requires request_data unless truncated"
+ * invariant still holds. Bump to "DEBUG" to capture full payloads for
+ * replay/audit.
+ */
+export interface AccessLogOptions {
+    /** Server version string (optional). */
+    serverVersion?: string;
+    /** Verbosity for heavy fields. Default: "INFO". */
+    level?: "INFO" | "DEBUG";
+}
+export declare class AccessLogHook implements DispatchHook {
+    private readonly sink;
+    private readonly serverVersion;
+    private readonly level;
+    constructor(sink: AccessLogSink, options?: AccessLogOptions | string);
+    onDispatchStart(_info: DispatchInfo): HookToken;
+    onDispatchEnd(token: HookToken, info: DispatchInfo, stats: CallStatistics, error?: Error): void;
+}
+//# sourceMappingURL=access-log.d.ts.map

package/dist/access-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-log.d.ts","sourceRoot":"","sources":["../src/access-log.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExF,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAgBD,gFAAgF;AAChF,qBAAa,MAAO,YAAW,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAD/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAClB,EAAE,EAAE,MAAM;IACvC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAS1B;AA2BD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,qBAAa,aAAc,YAAW,YAAY;IAK9C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAGtB,IAAI,EAAE,aAAa,EACpC,OAAO,GAAE,gBAAgB,GAAG,MAAW;IAazC,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS;IAK/C,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;CA2EhG"}

package/dist/arrow/impl-arrowjs/index.d.ts

@@ -0,0 +1,96 @@
+import type { IncrementalEncoder, VgiBackendInfo, VgiBatch, VgiColumnData, VgiDataType, VgiField, VgiSchema } from "../types.js";
+export declare const backend: VgiBackendInfo;
+export declare const nullType: () => VgiDataType;
+export declare const bool: () => VgiDataType;
+export declare const int8: () => VgiDataType;
+export declare const int16: () => VgiDataType;
+export declare const int32: () => VgiDataType;
+export declare const int64: () => VgiDataType;
+export declare const uint8: () => VgiDataType;
+export declare const uint16: () => VgiDataType;
+export declare const uint32: () => VgiDataType;
+export declare const uint64: () => VgiDataType;
+export declare const float32: () => VgiDataType;
+export declare const float64: () => VgiDataType;
+export declare const utf8: () => VgiDataType;
+export declare const binary: () => VgiDataType;
+/** Microsecond Timestamp with optional timezone. */
+export declare const timestampMicro: (timezone?: string | null) => VgiDataType;
+/** Date32 with day resolution. */
+export declare const dateDay: () => VgiDataType;
+/** Time64 with microsecond resolution. */
+export declare const timeMicro: () => VgiDataType;
+/** Duration with microsecond resolution. */
+export declare const durationMicro: () => VgiDataType;
+/** Decimal128 by default; pass bitWidth=256 for Decimal256. */
+export declare const decimal: (precision: number, scale: number, bitWidth?: 128 | 256) => VgiDataType;
+/** FixedSizeBinary with the given byte width. */
+export declare const fixedSizeBinary: (byteWidth: number) => VgiDataType;
+/** LargeUtf8 — 64-bit-offset UTF-8 string. */
+export declare const largeUtf8: () => VgiDataType;
+/** LargeBinary — 64-bit-offset binary blob. */
+export declare const largeBinary: () => VgiDataType;
+/** List of `child` items. The child field carries name + nullability + type. */
+export declare const list: (child: VgiField) => VgiDataType;
+/** Struct of `fields`. */
+export declare const struct: (fields: readonly VgiField[]) => VgiDataType;
+/** Map (key → value) carried as a List<Struct<key,value>>. arrow-js's Map_
+ *  constructor takes a child Field whose type is a Struct of [key, value]. */
+export declare const map: (keyField: VgiField, valueField: VgiField, keysSorted?: boolean) => VgiDataType;
+/** Dictionary-encoded type. `indices` must be an integer type.
+ *
+ *  `id` is left undefined by default so arrow-js's internal `getId()`
+ *  counter assigns a fresh unique id per Dictionary instance. Passing
+ *  `-1` (or any concrete number) here would short-circuit that counter
+ *  and produce id collisions when multiple Dictionary types are used. */
+export declare const dictionary: (indices: VgiDataType, values: VgiDataType, id?: number, ordered?: boolean) => VgiDataType;
+export declare function field(name: string, type: VgiDataType, nullable?: boolean, metadata?: Map<string, string>): VgiField;
+export declare function schema(fields: readonly VgiField[], metadata?: Map<string, string>): VgiSchema;
+export declare function serializeSchema(s: VgiSchema): Uint8Array;
+export declare function deserializeSchema(bytes: Uint8Array): VgiSchema;
+export declare function serializeBatch(batch: VgiBatch): Uint8Array;
+/**
+ * Incremental IPC encoder over arrow-js's `RecordBatchStreamWriter`. Each
+ * call drains the writer's internal sink queue and returns the new bytes,
+ * so the caller can flush them synchronously between lockstep turns.
+ *
+ * `_writeRecordBatch` is called directly (rather than the public `write`)
+ * to bypass arrow-js's schema comparison, which would auto-close the
+ * writer and silently drop a batch whose schema differs only in
+ * nullability — our output schema is fixed at open time and all batches
+ * are structurally compatible.
+ */
+export declare function createIncrementalEncoder(s: VgiSchema): IncrementalEncoder;
+export declare function deserializeBatch(bytes: Uint8Array): VgiBatch;
+export declare function columnFromArray(values: any[], type: VgiDataType): VgiColumnData;
+/** Build a 1-row batch from {colName: value} dict (Int64 numbers auto-coerced). */
+export declare function singleRowBatch(s: VgiSchema, values: Record<string, any>): VgiBatch;
+/** Build an N-row batch from columnar arrays. */
+export declare function batchFromColumns(s: VgiSchema, columns: Record<string, any[]>): VgiBatch;
+/** Build a batch from pre-built column-data handles + schema. */
+export declare function batchFromColumnData(s: VgiSchema, numRows: number, columnData: VgiColumnData[], metadata?: Map<string, string>): VgiBatch;
+/** Empty-Data builder used when assembling batches with pre-built children. */
+export declare function emptyColumnData(type: VgiDataType): VgiColumnData;
+/**
+ * 0-row batch with optional batch-level metadata (used for log/error/empty
+ * tombstone batches by the wire layer).
+ */
+export declare function emptyBatchWithMetadata(s: VgiSchema, metadata?: Map<string, string>): VgiBatch;
+/** 1-row result batch: vectorFromArray each value, support raw Data
+ *  passthrough (for Map/opaque types whose .get(0) is unreliable). */
+export declare function singleRowBatchWithMetadata(s: VgiSchema, values: Record<string, any>, metadata?: Map<string, string>): VgiBatch;
+/** Tag a value as a raw Data passthrough. arrow-js: returns true if the
+ *  value is an arrow-js Data instance. flechette: always false (the
+ *  flechette backend doesn't surface this opaque-type quirk). */
+export declare function isOpaqueData(val: unknown): boolean;
+/** Re-emit a batch with a different metadata map (same schema + data). */
+export declare function withBatchMetadata(batch: VgiBatch, metadata: Map<string, string>): VgiBatch;
+/**
+ * Serialize a sequence of batches into a single multi-batch IPC stream.
+ * arrow-js's `RecordBatchStreamWriter` writes schema + N batches + EOS
+ * incrementally — exactly what consumers expect for a producer/exchange
+ * response that emits more than one batch.
+ */
+export declare function serializeBatches(schema: VgiSchema, batches: VgiBatch[]): Uint8Array;
+export declare function conformBatchToSchema(batch: VgiBatch, schema: VgiSchema): VgiBatch;
+//# sourceMappingURL=index.d.ts.map

package/dist/arrow/impl-arrowjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/arrow/impl-arrowjs/index.ts"],"names":[],"mappings":"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"}

package/dist/arrow/impl-flechette/index.d.ts

@@ -0,0 +1,102 @@
+import type { IncrementalEncoder, VgiBackendInfo, VgiBatch, VgiColumnData, VgiDataType, VgiField, VgiSchema } from "../types.js";
+export declare const backend: VgiBackendInfo;
+export declare const nullType: () => VgiDataType;
+export declare const bool: () => VgiDataType;
+export declare const int8: () => VgiDataType;
+export declare const int16: () => VgiDataType;
+export declare const int32: () => VgiDataType;
+export declare const int64: () => VgiDataType;
+export declare const uint8: () => VgiDataType;
+export declare const uint16: () => VgiDataType;
+export declare const uint32: () => VgiDataType;
+export declare const uint64: () => VgiDataType;
+export declare const float32: () => VgiDataType;
+export declare const float64: () => VgiDataType;
+export declare const utf8: () => VgiDataType;
+export declare const binary: () => VgiDataType;
+/** Microsecond Timestamp with optional timezone. */
+export declare const timestampMicro: (timezone?: string | null) => VgiDataType;
+/** Date32 with day resolution. */
+export declare const dateDay: () => VgiDataType;
+/** Time64 with microsecond resolution. */
+export declare const timeMicro: () => VgiDataType;
+/** Duration with microsecond resolution. */
+export declare const durationMicro: () => VgiDataType;
+/** Decimal128 by default; pass bitWidth=256 for Decimal256. */
+export declare const decimal: (precision: number, scale: number, bitWidth?: 128 | 256) => VgiDataType;
+/** FixedSizeBinary with the given byte width. */
+export declare const fixedSizeBinary: (byteWidth: number) => VgiDataType;
+/** LargeUtf8 — 64-bit-offset UTF-8 string. */
+export declare const largeUtf8: () => VgiDataType;
+/** LargeBinary — 64-bit-offset binary blob. */
+export declare const largeBinary: () => VgiDataType;
+/** List of `child` items. */
+export declare const list: (child: VgiField) => VgiDataType;
+/** Struct of `fields`. */
+export declare const struct: (fields: readonly VgiField[]) => VgiDataType;
+/** Map (key → value). flechette's `map(keyField, valueField, keysSorted)`
+ *  builds the entries Struct internally — same shape as arrow-js's Map_
+ *  but a less verbose API. */
+export declare const map: (keyField: VgiField, valueField: VgiField, keysSorted?: boolean) => VgiDataType;
+/** Dictionary-encoded type. `indices` must be an integer type. */
+export declare const dictionary: (indices: VgiDataType, values: VgiDataType, id?: number, ordered?: boolean) => VgiDataType;
+export declare function field(name: string, type: VgiDataType, nullable?: boolean, metadata?: Map<string, string>): VgiField;
+export declare function schema(fields: readonly VgiField[], metadata?: Map<string, string>): VgiSchema;
+export declare function serializeSchema(s: VgiSchema): Uint8Array;
+export declare function deserializeSchema(bytes: Uint8Array): VgiSchema;
+export declare function serializeBatch(batch: VgiBatch): Uint8Array;
+export declare function deserializeBatch(bytes: Uint8Array): VgiBatch;
+export declare function columnFromArray(values: any[], type: VgiDataType): VgiColumnData;
+export declare function singleRowBatch(s: VgiSchema, values: Record<string, any>): VgiBatch;
+export declare function batchFromColumns(s: VgiSchema, columns: Record<string, any[]>): VgiBatch;
+export declare function batchFromColumnData(s: VgiSchema, _numRows: number, columnData: VgiColumnData[], _metadata?: Map<string, string>): VgiBatch;
+export declare function emptyColumnData(type: VgiDataType): VgiColumnData;
+/**
+ * 0-row batch carrying per-record-batch (NOT schema) custom metadata.
+ *
+ * The vgi-rpc wire protocol puts per-call metadata (`vgi_rpc.log_level`,
+ * `vgi_rpc.server_id`, `vgi_rpc.request_id`, etc.) on the RecordBatch
+ * message — not on the Schema message. We stash it on the Table via
+ * `_vgiRecordMetadata`; our patched `tablesToIPC` picks it up and emits
+ * it as the Message FlatBuffer's `custom_metadata` field.
+ */
+export declare function emptyBatchWithMetadata(s: VgiSchema, metadata?: Map<string, string>): VgiBatch;
+/** 1-row result batch with optional per-record-batch metadata. */
+export declare function singleRowBatchWithMetadata(s: VgiSchema, values: Record<string, any>, metadata?: Map<string, string>): VgiBatch;
+/** flechette has no Data passthrough concept (no opaque-type quirk). */
+export declare function isOpaqueData(_val: unknown): boolean;
+/** Re-emit a batch with a different per-record-batch metadata map (same
+ *  schema + data). Shallow-clones the Table so the caller's reference is
+ *  not mutated. */
+export declare function withBatchMetadata(batch: VgiBatch, metadata: Map<string, string>): VgiBatch;
+/**
+ * Serialize a sequence of batches into a single multi-batch IPC stream.
+ * Uses our flechette fork's `tablesToIPC` (added in
+ * github:Query-farm/flechette#fix/timestamp-bigint-encode) to do the
+ * concat-then-encode atomically — naive concatenation of multiple
+ * `tableToIPC` outputs produces multiple EOS markers, dropping batches
+ * past the first.
+ */
+export declare function serializeBatches(_schema: VgiSchema, batches: VgiBatch[]): Uint8Array;
+/**
+ * Rebuild a batch's columns to match a target schema's field types.
+ *
+ * flechette's IPC reader produces specific types upfront (no Int_/Float_
+ * generic-type quirk that arrow-js exhibits), but a cast-compatible client
+ * can still send e.g. int64 where the method declares float64. Mirror the
+ * arrow-js backend: materialize+rebuild numeric columns whose type differs
+ * from the expected field type. Non-numeric mismatches (and matching types)
+ * keep their existing column. Field-name / field-count mismatches surface as
+ * TypeErrors so the dispatch layer can convert them to RpcError.
+ */
+export declare function conformBatchToSchema(batch: VgiBatch, schema: VgiSchema): VgiBatch;
+/**
+ * Not supported on flechette: the lockstep stdio exchange protocol needs an
+ * incremental IPC writer (emit each batch's framing bytes before reading
+ * the next input), and flechette only exposes a one-shot table encoder.
+ * The flechette backend is selected for workerd / browser / worker, which
+ * are HTTP-only (no stdio), so this factory is never reached there. The
+ * stdio server requires the arrow-js backend.
+ */
+export declare function createIncrementalEncoder(_s: VgiSchema): IncrementalEncoder;
+//# sourceMappingURL=index.d.ts.map

package/dist/arrow/impl-flechette/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/arrow/impl-flechette/index.ts"],"names":[],"mappings":"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"}

package/dist/arrow/impl-flechette/message-meta.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Walk an Arrow IPC stream and return the first RecordBatch message's
+ * (numRows, metadata) — the bits flechette drops on the floor.
+ *
+ * Returns null if the stream contains no RecordBatch.
+ */
+export declare function readFirstRecordBatchMeta(stream: Uint8Array): {
+    numRows: number;
+    metadata: Map<string, string>;
+} | null;
+//# sourceMappingURL=message-meta.d.ts.map

package/dist/arrow/impl-flechette/message-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-meta.d.ts","sourceRoot":"","sources":["../../../src/arrow/impl-flechette/message-meta.ts"],"names":[],"mappings":"AA0IA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,GACjB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CA2B3D"}

package/dist/arrow/index.d.ts

@@ -0,0 +1,4 @@
+export { backend, batchFromColumnData, batchFromColumns, binary, bool, columnFromArray, conformBatchToSchema, createIncrementalEncoder, dateDay, decimal, deserializeBatch, deserializeSchema, dictionary, durationMicro, emptyBatchWithMetadata, emptyColumnData, field, fixedSizeBinary, float32, float64, int8, int16, int32, int64, isOpaqueData, largeBinary, largeUtf8, list, map, nullType, schema, serializeBatch, serializeBatches, serializeSchema, singleRowBatch, singleRowBatchWithMetadata, struct, timeMicro, timestampMicro, uint8, uint16, uint32, uint64, utf8, withBatchMetadata, } from "#vgi-rpc-arrow";
+export { isBatch, isBinary, isBool, isDate, isDecimal, isDictionary, isDuration, isFixedSizeBinary, isFloat, isInt, isLargeBinary, isLargeUtf8, isList, isMap, isNull, isStruct, isTime, isTimestamp, isUtf8, TypeId, } from "./predicates.js";
+export type { IncrementalEncoder, VgiBackendInfo, VgiBatch, VgiColumn, VgiColumnData, VgiDataType, VgiField, VgiSchema, VgiTypeId, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/arrow/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,EACN,IAAI,EAEJ,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,OAAO,EACP,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,KAAK,EACL,eAAe,EACf,OAAO,EACP,OAAO,EACP,IAAI,EACJ,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,IAAI,EACJ,GAAG,EAEH,QAAQ,EACR,MAAM,EACN,cAAc,EACd,gBAAgB,EAEhB,eAAe,EACf,cAAc,EACd,0BAA0B,EAC1B,MAAM,EACN,SAAS,EACT,cAAc,EACd,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,EACN,IAAI,EACJ,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,MAAM,EACN,SAAS,EACT,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,KAAK,EACL,aAAa,EACb,WAAW,EACX,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,WAAW,EACX,MAAM,EACN,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,SAAS,EACT,aAAa,EACb,WAAW,EACX,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/arrow/predicates.d.ts

@@ -0,0 +1,44 @@
+import type { VgiDataType } from "./types.js";
+export declare const TypeId: {
+    readonly Null: 1;
+    readonly Int: 2;
+    readonly Float: 3;
+    readonly Binary: 4;
+    readonly Utf8: 5;
+    readonly Bool: 6;
+    readonly Decimal: 7;
+    readonly Date: 8;
+    readonly Time: 9;
+    readonly Timestamp: 10;
+    readonly Interval: 11;
+    readonly List: 12;
+    readonly Struct: 13;
+    readonly Union: 14;
+    readonly FixedSizeBinary: 15;
+    readonly FixedSizeList: 16;
+    readonly Map: 17;
+    readonly Duration: 18;
+    readonly LargeBinary: 19;
+    readonly LargeUtf8: 20;
+    readonly Dictionary: -1;
+};
+export declare const isNull: (t: VgiDataType) => boolean;
+export declare const isInt: (t: VgiDataType) => boolean;
+export declare const isFloat: (t: VgiDataType) => boolean;
+export declare const isBinary: (t: VgiDataType) => boolean;
+export declare const isUtf8: (t: VgiDataType) => boolean;
+export declare const isLargeUtf8: (t: VgiDataType) => boolean;
+export declare const isLargeBinary: (t: VgiDataType) => boolean;
+export declare const isBool: (t: VgiDataType) => boolean;
+export declare const isDecimal: (t: VgiDataType) => boolean;
+export declare const isDate: (t: VgiDataType) => boolean;
+export declare const isTime: (t: VgiDataType) => boolean;
+export declare const isTimestamp: (t: VgiDataType) => boolean;
+export declare const isDuration: (t: VgiDataType) => boolean;
+export declare const isList: (t: VgiDataType) => boolean;
+export declare const isStruct: (t: VgiDataType) => boolean;
+export declare const isMap: (t: VgiDataType) => boolean;
+export declare const isFixedSizeBinary: (t: VgiDataType) => boolean;
+export declare const isDictionary: (t: VgiDataType) => boolean;
+export declare function isBatch(x: unknown): x is import("./types.js").VgiBatch;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/arrow/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../src/arrow/predicates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;CAsBT,CAAC;AAEX,eAAO,MAAM,MAAM,GAAI,GAAG,WAAW,KAAG,OAAmC,CAAC;AAC5E,eAAO,MAAM,KAAK,GAAI,GAAG,WAAW,KAAG,OAAkC,CAAC;AAC1E,eAAO,MAAM,OAAO,GAAI,GAAG,WAAW,KAAG,OAAoC,CAAC;AAC9E,eAAO,MAAM,QAAQ,GAAI,GAAG,WAAW,KAAG,OAAwE,CAAC;AACnH,eAAO,MAAM,MAAM,GAAI,GAAG,WAAW,KAAG,OAAoE,CAAC;AAC7G,eAAO,MAAM,WAAW,GAAI,GAAG,WAAW,KAAG,OAAwC,CAAC;AACtF,eAAO,MAAM,aAAa,GAAI,GAAG,WAAW,KAAG,OAA0C,CAAC;AAC1F,eAAO,MAAM,MAAM,GAAI,GAAG,WAAW,KAAG,OAAmC,CAAC;AAC5E,eAAO,MAAM,SAAS,GAAI,GAAG,WAAW,KAAG,OAAsC,CAAC;AAClF,eAAO,MAAM,MAAM,GAAI,GAAG,WAAW,KAAG,OAAmC,CAAC;AAC5E,eAAO,MAAM,MAAM,GAAI,GAAG,WAAW,KAAG,OAAmC,CAAC;AAC5E,eAAO,MAAM,WAAW,GAAI,GAAG,WAAW,KAAG,OAAwC,CAAC;AACtF,eAAO,MAAM,UAAU,GAAI,GAAG,WAAW,KAAG,OAAuC,CAAC;AACpF,eAAO,MAAM,MAAM,GAAI,GAAG,WAAW,KAAG,OAAmC,CAAC;AAC5E,eAAO,MAAM,QAAQ,GAAI,GAAG,WAAW,KAAG,OAAqC,CAAC;AAChF,eAAO,MAAM,KAAK,GAAI,GAAG,WAAW,KAAG,OAAkC,CAAC;AAC1E,eAAO,MAAM,iBAAiB,GAAI,GAAG,WAAW,KAAG,OAA8C,CAAC;AAClG,eAAO,MAAM,YAAY,GAAI,GAAG,WAAW,KAAG,OAAyC,CAAC;AAExF,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,YAAY,EAAE,QAAQ,CAOtE"}

package/dist/arrow/types.d.ts

@@ -0,0 +1,62 @@
+export type VgiTypeId = number;
+export interface VgiDataType {
+    readonly typeId: VgiTypeId;
+}
+export interface VgiField {
+    readonly name: string;
+    readonly type: VgiDataType;
+    readonly nullable: boolean;
+    readonly metadata: Map<string, string>;
+}
+export interface VgiSchema {
+    readonly fields: readonly VgiField[];
+    readonly metadata: Map<string, string>;
+}
+export interface VgiColumn {
+    readonly type: VgiDataType;
+    readonly length: number;
+    get(index: number): unknown;
+    [Symbol.iterator](): Iterator<unknown>;
+}
+export interface VgiBatch {
+    readonly schema: VgiSchema;
+    readonly numRows: number;
+    readonly metadata?: Map<string, string> | null;
+    getChild(name: string): VgiColumn | null;
+    getChildAt(index: number): VgiColumn | null;
+}
+export interface VgiBackendInfo {
+    readonly name: "arrow-js" | "flechette";
+    /**
+     * Whether this backend's `.get(0)` round-trip is unreliable for opaque
+     * column types (Map/Date/Time/Timestamp/Duration/Decimal/LargeUtf8/
+     * LargeBinary/FixedSizeBinary/Dictionary), requiring the request parser to
+     * pass the raw column data straight through instead of materializing a
+     * value. True for arrow-js; false for flechette (which extracts cleanly).
+     */
+    readonly opaquePassthrough: boolean;
+}
+export type VgiColumnData = unknown;
+/**
+ * Incremental IPC stream encoder for the lockstep stdio transport.
+ *
+ * The stdio exchange protocol is lockstep — the client reads each response
+ * batch (and its framing bytes) before sending the next input — so we
+ * cannot buffer-then-emit at close. Each call returns the wire bytes to
+ * flush immediately. Only the stdio server uses this; HTTP serializes
+ * whole responses via {@link serializeBatches}.
+ *
+ * The arrow-js backend implements this over `RecordBatchStreamWriter`.
+ * The flechette backend has no incremental-writer surface and its
+ * factory throws — keeping arrow-js out of the flechette (workerd/
+ * browser) bundle, which is HTTP-only anyway.
+ */
+export interface IncrementalEncoder {
+    /** Bytes for the schema preamble (continuation + schema message). */
+    start(): Uint8Array;
+    /** Bytes for one record batch message. */
+    writeBatch(batch: VgiBatch): Uint8Array;
+    /** Bytes for the end-of-stream marker. */
+    finish(): Uint8Array;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/arrow/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,KAAK,IAAI,UAAU,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;IACxC,0CAA0C;IAC1C,MAAM,IAAI,UAAU,CAAC;CACtB"}

package/dist/client/capabilities.d.ts

@@ -0,0 +1,25 @@
+/**
+ * HTTP server capability discovery.
+ *
+ * Mirrors Python's `http_capabilities()`: probes `OPTIONS {prefix}/health`
+ * and reads three response headers:
+ *   - `VGI-Max-Request-Bytes`  — server-enforced inline request cap
+ *   - `VGI-Upload-URL-Support` — "true" when the server vends upload URLs
+ *   - `VGI-Max-Upload-Bytes`   — cap on out-of-band upload size
+ *
+ * Honours `Cache-Control: max-age=N` for refresh scheduling.
+ */
+export interface HttpServerCapabilities {
+    /** Server's advertised max inline request body size (bytes). */
+    maxRequestBytes: number | null;
+    /** Whether the server vends upload URLs via `__upload_url__/init`. */
+    uploadUrlSupport: boolean;
+    /** Cap on the size of an externalized upload (bytes). */
+    maxUploadBytes: number | null;
+    /** Monotonic-time-ish epoch (ms) at which this snapshot should be re-probed. */
+    cacheExpiresAt: number | null;
+}
+export declare function parseCapabilitiesFromHeaders(headers: Headers): HttpServerCapabilities;
+export declare function discoverHttpCapabilities(baseUrl: string, prefix: string, authorization?: string): Promise<HttpServerCapabilities>;
+export declare function isCapabilitySnapshotFresh(snapshot: HttpServerCapabilities | null): boolean;
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/client/capabilities.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sEAAsE;IACtE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gFAAgF;IAChF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAaD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CAyBrF;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,sBAAsB,CAAC,CASjC;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,OAAO,CAI1F"}

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

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/client/connect.ts"],"names":[],"mappings":"AAQA,OAAO,EAAmC,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAS3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKpE,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7E,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAsSpF"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/client/connect.ts"],"names":[],"mappings":"AAaA,OAAO,EAAmC,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAS3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMpE,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7E,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CA6WpF"}

package/dist/client/introspect.d.ts

@@ -14,6 +14,10 @@ export interface MethodInfo {
 }
 export interface ServiceDescription {
     protocolName: string;
+    /** Application protocol surface version surfaced by the server's
+     *  __describe__ response. Empty string when the server did not declare
+     *  a `protocolVersion`. */
+    protocolVersion: string;
     methods: MethodInfo[];
 }
 /**
@@ -27,5 +31,8 @@ export declare function parseDescribeResponse(batches: RecordBatch[], onLog?: (m
 export declare function httpIntrospect(baseUrl: string, options?: {
     prefix?: string;
     authorization?: string;
+    compressionLevel?: number;
+    compressFn?: (data: Uint8Array, level: number) => Promise<Uint8Array>;
+    decompressFn?: (data: Uint8Array) => Promise<Uint8Array>;
 }): Promise<ServiceDescription>;
 //# sourceMappingURL=introspect.d.ts.map

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,EAAyB,KAAK,WAAW,EAAqB,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAKnH,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,CAwE7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,kBAAkB,CAAC,CAuB7B"}
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/client/introspect.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAMhG,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;;+BAE2B;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAoBD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAyD7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1D,GACA,OAAO,CAAC,kBAAkB,CAAC,CAsC7B"}

package/dist/client/ipc.d.ts

@@ -1,12 +1,18 @@
-import { DataType, RecordBatch, type Schema } from "@query-farm/apache-arrow";
+import { DataType, type RecordBatch, type Schema } 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. */
 export declare function inferArrowType(value: any): DataType;
 /**
  * Build a 1-row Arrow IPC request batch with method metadata.
+ *
+ * When `options.protocolVersion` is non-empty, the value is emitted as
+ * `vgi_rpc.protocol_version` so servers that declare a Protocol-level
+ * version validate the request at the dispatch boundary.
  */
-export declare function buildRequestIpc(schema: Schema, params: Record<string, any>, method: string): Uint8Array;
+export declare function buildRequestIpc(schema: Schema, params: Record<string, any>, method: string, options?: {
+    protocolVersion?: string;
+}): Uint8Array;
 /**
  * Read schema + all batches from an IPC stream body.
  */

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,EAGL,QAAQ,EAIR,WAAW,EAEX,KAAK,MAAM,EAIZ,MAAM,0BAA0B,CAAC;AAWlC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,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,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAgCvG;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAS/G;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAqCjG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAiB1E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAQtF"}
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../src/client/ipc.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,QAAQ,EAGR,KAAK,WAAW,EAEhB,KAAK,MAAM,EAEZ,MAAM,0BAA0B,CAAC;AAalC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,QAAQ,CAOnD;AAyCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,UAAU,CAkCZ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAS/G;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAqCjG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAiB1E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAQtF"}

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,EAKL,MAAM,EAGP,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,KAAK,sBAAsB,EAAoD,MAAM,gBAAgB,CAAC;AAE/G,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAM1G,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;IACrD,OAAO,CAAC,eAAe,CAAC,CAAyB;gBAErC,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;QAC5C,cAAc,CAAC,EAAE,sBAAsB,CAAC;KACzC;IAWD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED;;;;OAIG;YACW,gBAAgB;IAqB9B;;;;;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;IAsG5E;;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,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAwC9F"}
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../src/client/pipe.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,MAAM,EAGP,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,KAAK,sBAAsB,EAAoD,MAAM,gBAAgB,CAAC;AAE/G,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAM1G,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;IACrD,OAAO,CAAC,eAAe,CAAC,CAAyB;gBAErC,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;QAC5C,cAAc,CAAC,EAAE,sBAAsB,CAAC;KACzC;IAWD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED;;;;OAIG;YACW,gBAAgB;IAqB9B;;;;;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;IAsG5E;;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,CAqOX;AAMD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAwC9F"}

package/dist/client/stream.d.ts

@@ -1,8 +1,14 @@
 import { RecordBatch, Schema } from "@query-farm/apache-arrow";
 import { type ExternalLocationConfig } from "../external.js";
 import type { LogMessage, StreamSession } from "./types.js";
-type CompressFn = (data: Uint8Array, level: number) => Uint8Array;
-type DecompressFn = (data: Uint8Array) => Uint8Array;
+type CompressFn = (data: Uint8Array, level: number) => Promise<Uint8Array>;
+type DecompressFn = (data: Uint8Array) => Promise<Uint8Array>;
+/**
+ * Posts an Arrow IPC request body to *url*, transparently handling
+ * client-vended request externalization. Provided by the parent connection
+ * so a single capability cache can drive both unary and stream call paths.
+ */
+export type PostFn = (url: string, body: Uint8Array) => Promise<Response>;
 export declare class HttpStreamSession implements StreamSession {
     private _baseUrl;
     private _prefix;
@@ -19,6 +25,7 @@ export declare class HttpStreamSession implements StreamSession {
     private _decompressFn?;
     private _authorization?;
     private _externalConfig?;
+    private _postFn?;
     constructor(opts: {
         baseUrl: string;
         prefix: string;
@@ -35,7 +42,9 @@ export declare class HttpStreamSession implements StreamSession {
         decompressFn?: DecompressFn;
         authorization?: string;
         externalConfig?: ExternalLocationConfig;
+        postFn?: PostFn;
     });
+    private _post;
     get header(): Record<string, any> | null;
     private _buildHeaders;
     private _prepareBody;

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,EAAmB,WAAW,EAAE,MAAM,EAA2B,MAAM,0BAA0B,CAAC;AAGzG,OAAO,EAAE,KAAK,sBAAsB,EAAoD,MAAM,gBAAgB,CAAC;AAG/G,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;IACrC,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,eAAe,CAAC,CAAyB;gBAErC,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;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,sBAAsB,CAAC;KACzC;IAkBD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED,OAAO,CAAC,aAAa;IAcrB,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;YA0D9D,WAAW;IAuCzB,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAkD/D,iBAAiB;IA2B/B,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/client/stream.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,WAAW,EAAE,MAAM,EAA2B,MAAM,0BAA0B,CAAC;AAGzG,OAAO,EAAE,KAAK,sBAAsB,EAAoD,MAAM,gBAAgB,CAAC;AAG/G,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAC3E,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE1E,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;IACrC,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,eAAe,CAAC,CAAyB;IACjD,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,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;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,sBAAsB,CAAC;QACxC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;YAmBa,KAAK;IASnB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAEvC;IAED,OAAO,CAAC,aAAa;YAgBP,YAAY;YAOZ,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;YA0D9D,WAAW;IAmCzB,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAoD/D,iBAAiB;IAuB/B,KAAK,IAAI,IAAI;CAGd"}

package/dist/client/uploadUrl.d.ts

@@ -0,0 +1,25 @@
+export interface UploadUrlPair {
+    uploadUrl: string;
+    downloadUrl: string;
+    expiresAt: Date;
+}
+/**
+ * POST `__upload_url__/init` and return the requested number of pre-signed
+ * URL pairs. Server must have an `uploadUrlProvider` configured; otherwise
+ * the route returns 404 and we surface that as `RpcError("NotSupported")`.
+ */
+export declare function requestUploadUrls(baseUrl: string, prefix: string, count: number, authorization?: string): Promise<UploadUrlPair[]>;
+export interface ExternalizeOptions {
+    baseUrl: string;
+    prefix: string;
+    authorization?: string;
+    /** Optional per-URL validator; throw to reject. */
+    urlValidator?: ((url: string) => void) | null;
+}
+/**
+ * Upload *body* via a server-vended URL and return the pointer-batch body
+ * that should be sent in place of the original. Throws if the server does
+ * not advertise upload-URL support or the upload fails.
+ */
+export declare function externalizeRequestBody(body: Uint8Array, opts: ExternalizeOptions): Promise<Uint8Array>;
+//# sourceMappingURL=uploadUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uploadUrl.d.ts","sourceRoot":"","sources":["../../src/client/uploadUrl.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAkD1B;AA4CD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/C;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmB5G"}