@query-farm/vgi-rpc 0.6.4 → 0.7.1

package/dist/types.d.ts

@@ -1,16 +1,156 @@
-import { RecordBatch, type Schema } from "@query-farm/apache-arrow";
+import { type VgiBatch, type VgiSchema } from "./arrow/index.js";
 import { AuthContext } from "./auth.js";
+/**
+ * Whether an RPC method is request/response or streaming. Mirrors Python's
+ * `MethodType` and is carried in the `__describe__` payload.
+ */
 export declare enum MethodType {
+    /** Single request batch in, single result batch out. */
     UNARY = "unary",
+    /** Streamed batches — either a producer or an exchange stream. */
     STREAM = "stream"
 }
+/**
+ * Coarse identifier of the transport binding a {@link VgiRpcServer} or
+ * HTTP handler.  Workers (RPC implementations) read this via
+ * {@link CallContext.kind} or the {@link ServeStartHook} lifecycle hook
+ * to tailor startup behaviour (skip HTTP-only caching, enable
+ * transport-specific metrics, etc.).
+ *
+ * Values are wire/log-friendly strings to match Python's `TransportKind`
+ * StrEnum byte-for-byte across language boundaries.
+ *
+ * - `PIPE` — Stdio worker (the standalone {@link VgiRpcServer} loop).
+ * - `HTTP` — Fetch-style HTTP handler (`createHttpHandler`).
+ * - `UNIX` — AF_UNIX socket handler (the launcher path).
+ */
+export declare enum TransportKind {
+    /** Stdio worker — the standalone {@link VgiRpcServer} loop. */
+    PIPE = "pipe",
+    /** Fetch-style HTTP handler (`createHttpHandler`). */
+    HTTP = "http",
+    /** AF_UNIX socket handler (the launcher path). */
+    UNIX = "unix"
+}
+/**
+ * Optional lifecycle hook fired once per process before the first
+ * dispatched request.
+ *
+ * For the stdio server, fires inside `VgiRpcServer.run()` before the
+ * first read.  For HTTP, fires lazily on the first request handled
+ * (fork-safe for pre-fork servers).
+ *
+ * If the hook raises, the server logs the exception and propagates it,
+ * leaving the bind state unset so the next attempt re-fires the hook
+ * rather than silently skipping it.
+ */
+export type ServeStartHook = (kind: TransportKind) => void | Promise<void>;
 /** Logging interface available to handlers. */
 export interface LogContext {
+    /** Emit a client-directed log message (sent as a zero-row log batch on the
+     *  wire). `level` is a severity label such as `"info"`, `"warning"`, or
+     *  `"error"`; `extra` carries optional structured string key/value pairs. */
     clientLog(level: string, message: string, extra?: Record<string, string>): void;
 }
+/**
+ * Attributes for a Set-Cookie directive queued via {@link CallContext.setCookie}.
+ * All fields are optional; omitted attributes are not serialized onto the header.
+ */
+export interface CookieAttrs {
+    expires?: Date;
+    maxAge?: number;
+    domain?: string;
+    path?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    sameSite?: "Strict" | "Lax" | "None";
+    partitioned?: boolean;
+}
+/**
+ * A queued cookie mutation for the HTTP response. Internal — callers
+ * interact through {@link CallContext.setCookie} / {@link CallContext.deleteCookie}.
+ */
+export interface CookieSpec extends CookieAttrs {
+    name: string;
+    value: string;
+    delete: boolean;
+}
+/** Per-request sticky-session sink. Internal — populated by the HTTP handler
+ *  when sticky sessions are enabled, read/mutated by {@link CallContext}'s
+ *  `openSession` / `closeSession` / `session` getters. */
+export interface StickyContext {
+    readonly acceptOpens: boolean;
+    state: unknown | null;
+    sessionId: string | null;
+    mintToken: string | null;
+    closed: boolean;
+    action: "none" | "resume" | "open" | "close";
+    _open(state: unknown, ttl: number | undefined): void;
+    _close(): void;
+}
 /** Extended context with authentication info, available to handlers. */
 export interface CallContext extends LogContext {
+    /** Authenticated principal for this call; {@link AuthContext.anonymous} when
+     *  the request was not authenticated. */
     readonly auth: AuthContext;
+    /** Coarse identifier of the bound transport, or `undefined` until the
+     *  server begins serving (the value is committed by the lifecycle hook
+     *  on the very first request). */
+    readonly kind?: TransportKind;
+    /**
+     * Wire body bytes the framework will accept this iteration before
+     * triggering a continuation token (producer streams) or strict-fail
+     * with an EXCEPTION batch (unary / stream-exchange).  Snapshot at
+     * collector construction; not live.  `undefined` when no cap is
+     * configured or the transport doesn't expose one (stdio).
+     */
+    readonly remainingResponseBytes?: number;
+    /**
+     * External-channel bytes left this iteration.  Always a hard cap —
+     * externalised uploads have no escape valve like producer
+     * continuation tokens.  Undefined when no cap is configured or
+     * externalisation is disabled.
+     */
+    readonly remainingExternalizedResponseBytes?: number;
+    /** True iff the server has an externalisation backend wired up. */
+    readonly externalizationEnabled?: boolean;
+    /**
+     * Incoming request cookies.  Empty for non-HTTP transports.
+     */
+    readonly cookies: ReadonlyMap<string, string>;
+    /**
+     * Queue a Set-Cookie header on the HTTP response.  Only valid inside a
+     * unary RPC method served over HTTP; throws otherwise.
+     */
+    setCookie(name: string, value: string, attrs?: CookieAttrs): void;
+    /**
+     * Queue an unset-cookie directive on the HTTP response.  Only valid
+     * inside a unary RPC method served over HTTP; throws otherwise.
+     */
+    deleteCookie(name: string, opts?: {
+        path?: string;
+        domain?: string;
+    }): void;
+    /**
+     * Live sticky-session state object, or `null` when no session is bound to
+     * this request. HTTP-only — other transports always return `null`.
+     */
+    readonly session: unknown | null;
+    /**
+     * Opaque 24-char-hex session ID, or `null` when no session is bound.
+     * Survives {@link closeSession} so post-close access-log records still
+     * carry the id.
+     */
+    readonly sessionId: string | null;
+    /**
+     * Register a sticky session holding *state* for subsequent requests on
+     * this transport. HTTP-only — throws on other transports, on calls
+     * without the `VGI-Session-Accept: true` opt-in header, or when a
+     * session is already bound to this request.
+     */
+    openSession(state: unknown, ttl?: number): void;
+    /** Invalidate the sticky session bound to this request. Idempotent. */
+    closeSession(): void;
 }
 /** Handler for unary (request-response) RPC methods. */
 export type UnaryHandler = (params: Record<string, any>, ctx: LogContext) => Promise<Record<string, any>> | Record<string, any>;
@@ -21,25 +161,57 @@ export type ProducerFn<S = any> = (state: S, out: OutputCollector) => Promise<vo
 /** Initialization function for exchange streams. Returns the initial state object. */
 export type ExchangeInit<S = any> = (params: Record<string, any>) => Promise<S> | S;
 /** Called once per input batch. Must emit exactly one output batch per call. */
-export type ExchangeFn<S = any> = (state: S, input: RecordBatch, out: OutputCollector) => Promise<void> | void;
+export type ExchangeFn<S = any> = (state: S, input: VgiBatch, out: OutputCollector) => Promise<void> | void;
 /** Produces a header batch sent before the first output batch in a stream. */
 export type HeaderInit = (params: Record<string, any>, state: any, ctx: LogContext) => Record<string, any>;
+/**
+ * Optional handler invoked when the client signals cancellation by writing an
+ * input batch carrying the ``vgi_rpc.cancel`` metadata key. The server runs
+ * this hook once, before breaking out of the streaming loop, giving state
+ * objects a chance to release resources. Errors are logged and swallowed.
+ */
+export type OnCancelFn<S = any> = (state: S) => Promise<void> | void;
+/**
+ * In-memory definition of one registered RPC method, produced by the
+ * {@link Protocol} builder and consumed by the dispatch layer. Which optional
+ * fields are populated depends on the method {@link type}: `handler` for unary
+ * methods, `producerInit`/`producerFn` for producer streams, and
+ * `exchangeInit`/`exchangeFn` for exchange streams.
+ */
 export interface MethodDefinition {
+    /** Method name as registered on the protocol. */
     name: string;
+    /** Whether the method is unary or streaming. */
     type: MethodType;
-    paramsSchema: Schema;
-    resultSchema: Schema;
-    outputSchema?: Schema;
-    inputSchema?: Schema;
+    /** Schema of the request parameters batch. */
+    paramsSchema: VgiSchema;
+    /** Schema of the unary result batch (unused for streams). */
+    resultSchema: VgiSchema;
+    /** Schema of streamed output batches (producer and exchange streams). */
+    outputSchema?: VgiSchema;
+    /** Schema of streamed input batches (exchange streams only). */
+    inputSchema?: VgiSchema;
+    /** Implementation for unary methods. */
     handler?: UnaryHandler;
+    /** Builds the initial state object for a producer stream. */
     producerInit?: ProducerInit;
+    /** Produces output batches for a producer stream. */
     producerFn?: ProducerFn;
+    /** Builds the initial state object for an exchange stream. */
     exchangeInit?: ExchangeInit;
+    /** Handles each input batch of an exchange stream. */
     exchangeFn?: ExchangeFn;
-    headerSchema?: Schema;
+    /** Schema of the optional per-stream header batch. */
+    headerSchema?: VgiSchema;
+    /** Builds the optional header batch emitted before the first output batch. */
     headerInit?: HeaderInit;
+    /** Optional hook run when the client cancels a stream. */
+    onCancel?: OnCancelFn;
+    /** Human-readable method documentation, surfaced via introspection. */
     doc?: string;
+    /** Default values applied to omitted request parameters. */
     defaults?: Record<string, any>;
+    /** Human-readable parameter type names, surfaced via introspection. */
     paramTypes?: Record<string, string>;
 }
 /** Metadata passed to dispatch hooks before and after RPC method execution. */
@@ -52,14 +224,50 @@ export interface DispatchInfo {
     serverId: string;
     /** Client-supplied request identifier, or null. */
     requestId: string | null;
+    /** Coarse transport identifier — `pipe` for stdio, `http` for fetch
+     *  handlers, `unix` for AF_UNIX. */
+    kind?: TransportKind;
+    /** Logical service / protocol name. */
+    protocol?: string;
+    /** SHA-256 hex of the canonical __describe__ payload (always required in access log). */
+    protocolHash?: string;
+    /** Operator-supplied protocol-contract version label (optional). */
+    protocolVersion?: string;
+    /** Authenticated principal, empty string when anonymous. */
+    principal?: string;
+    /** Authentication domain, empty string when anonymous. */
+    authDomain?: string;
+    /** True when the call was authenticated. */
+    authenticated?: boolean;
+    /** HTTP transport: remote IP:port. */
+    remoteAddr?: string;
+    /** Self-contained Arrow IPC stream of the request batch (unary + stream init only). */
+    requestData?: Uint8Array;
+    /** Stream lifecycle identifier (32-char lowercase hex); empty on unary. */
+    streamId?: string;
+    /** True when a stream was cancelled by the client. */
+    cancelled?: boolean;
+    /** Sticky session ID (24-char hex). Present only when the request was bound
+     *  to a sticky session or the method opened/closed one. */
+    sessionId?: string;
+    /** Sticky-session lifecycle action observed during dispatch — one of
+     *  `"none"` / `"resume"` / `"open"` / `"close"`. Omitted when sticky is
+     *  disabled or the request never touched the sticky middleware. */
+    sessionAction?: "none" | "resume" | "open" | "close";
 }
 /** Per-call I/O counters, matching Python's CallStatistics. */
 export interface CallStatistics {
+    /** Number of input batches read from the client. */
     inputBatches: number;
+    /** Number of output batches written to the client. */
     outputBatches: number;
+    /** Total rows across all input batches. */
     inputRows: number;
+    /** Total rows across all output batches. */
     outputRows: number;
+    /** Total serialized bytes of all input batches. */
     inputBytes: number;
+    /** Total serialized bytes of all output batches. */
     outputBytes: number;
 }
 /** Opaque token returned by onDispatchStart, passed back to onDispatchEnd. */
@@ -69,11 +277,15 @@ export type HookToken = unknown;
  * Implementations must be safe for concurrent use (HTTP transport is concurrent).
  */
 export interface DispatchHook {
+    /** Invoked before the method runs. The returned {@link HookToken} is opaque
+     *  to the framework and passed back to {@link onDispatchEnd}. */
     onDispatchStart(info: DispatchInfo): HookToken;
+    /** Invoked after the method completes or throws. `stats` carries the per-call
+     *  I/O counters; `error` is set only when the dispatch failed. */
     onDispatchEnd(token: HookToken, info: DispatchInfo, stats: CallStatistics, error?: Error): void;
 }
 export interface EmittedBatch {
-    batch: RecordBatch;
+    batch: VgiBatch;
     metadata?: Map<string, string>;
 }
 /**
@@ -88,13 +300,59 @@ export declare class OutputCollector implements CallContext {
     private _outputSchema;
     private _serverId;
     private _requestId;
+    private _cookieSinkEnabled;
+    private _responseCookies;
+    private _stickyContext;
+    /** Authenticated principal for this call; {@link AuthContext.anonymous} when
+     *  the request was not authenticated. */
     readonly auth: AuthContext;
-    constructor(outputSchema: Schema, producerMode?: boolean, serverId?: string, requestId?: string | null, authContext?: AuthContext);
-    get outputSchema(): Schema;
+    readonly cookies: ReadonlyMap<string, string>;
+    readonly kind?: TransportKind;
+    readonly remainingResponseBytes?: number;
+    readonly remainingExternalizedResponseBytes?: number;
+    readonly externalizationEnabled?: boolean;
+    constructor(outputSchema: VgiSchema, producerMode?: boolean, serverId?: string, requestId?: string | null, authContext?: AuthContext, cookies?: ReadonlyMap<string, string>, kind?: TransportKind, 
+    /** Snapshot budget fields exposed to worker code via {@link CallContext}.
+     *  Optional — non-HTTP transports omit them and existing call sites
+     *  remain source-compatible. */
+    budgets?: {
+        remainingResponseBytes?: number;
+        remainingExternalizedResponseBytes?: number;
+        externalizationEnabled?: boolean;
+    });
+    /**
+     * Mark this collector as able to accept Set-Cookie directives.  Called
+     * by the unary HTTP dispatcher only; streaming and non-HTTP paths leave
+     * the sink disabled so setCookie/deleteCookie throw.
+     * @internal
+     */
+    enableCookieSink(): void;
+    /**
+     * Return and clear all queued cookie mutations.
+     * @internal
+     */
+    drainResponseCookies(): CookieSpec[];
+    setCookie(name: string, value: string, attrs?: CookieAttrs): void;
+    deleteCookie(name: string, opts?: {
+        path?: string;
+        domain?: string;
+    }): void;
+    /** Attach the sticky-session sink the HTTP handler built for this request.
+     *  @internal */
+    attachStickyContext(ctx: StickyContext): void;
+    get session(): unknown | null;
+    get sessionId(): string | null;
+    openSession(state: unknown, ttl?: number): void;
+    closeSession(): void;
+    /** Schema of the data batches this collector emits. */
+    get outputSchema(): VgiSchema;
+    /** True once {@link finish} has been called (producer streams only). */
     get finished(): boolean;
+    /** Batches emitted so far this call — the single data batch plus any log
+     *  batches, in emission order. Consumed by the dispatch layer. */
     get batches(): EmittedBatch[];
-    /** Emit a pre-built RecordBatch as the data batch for this call. */
-    emit(batch: RecordBatch, metadata?: Map<string, string>): void;
+    /** Emit a pre-built batch as the data batch for this call. */
+    emit(batch: VgiBatch, metadata?: Map<string, string>): void;
     /** Emit a data batch from column arrays keyed by field name. Int64 Number values are coerced to BigInt. */
     emit(columns: Record<string, any[]>): void;
     /** Single-row convenience. Wraps each value in `[value]` then calls `emit()`. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6B,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC;;;GAGG;AACH,oBAAY,UAAU;IACpB,wDAAwD;IACxD,KAAK,UAAU;IACf,kEAAkE;IAClE,MAAM,WAAW;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,oBAAY,aAAa;IACvB,+DAA+D;IAC/D,IAAI,SAAS;IACb,sDAAsD;IACtD,IAAI,SAAS;IACb,kDAAkD;IAClD,IAAI,SAAS;CACd;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB;;iFAE6E;IAC7E,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACjF;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;0DAE0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACrD,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C;6CACyC;IACzC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B;;sCAEkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,kCAAkC,CAAC,EAAE,MAAM,CAAC;IACrD,mEAAmE;IACnE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAClE;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE5E;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD,uEAAuE;IACvE,YAAY,IAAI,IAAI,CAAC;CACtB;AAuBD,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,UAAU,KACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAExD,sFAAsF;AACtF,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACpF,0FAA0F;AAC1F,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3F,sFAAsF;AACtF,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACpF,gFAAgF;AAChF,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE5G,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE3G;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,8CAA8C;IAC9C,YAAY,EAAE,SAAS,CAAC;IACxB,6DAA6D;IAC7D,YAAY,EAAE,SAAS,CAAC;IACxB,yEAAyE;IACzE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,gEAAgE;IAChE,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,wCAAwC;IACxC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,qDAAqD;IACrD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sDAAsD;IACtD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;wCACoC;IACpC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;+DAC2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;uEAEmE;IACnE,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACtD;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;qEACiE;IACjE,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/C;sEACkE;IAClE,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACjG;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,cAAc,CAA8B;IACpD;6CACyC;IACzC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,kCAAkC,CAAC,EAAE,MAAM,CAAC;IACrD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;gBAGxC,YAAY,EAAE,SAAS,EACvB,YAAY,UAAO,EACnB,QAAQ,SAAK,EACb,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,WAAW,CAAC,EAAE,WAAW,EACzB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,IAAI,CAAC,EAAE,aAAa;IACpB;;oCAEgC;IAChC,OAAO,CAAC,EAAE;QACR,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,kCAAkC,CAAC,EAAE,MAAM,CAAC;QAC5C,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC;IAcH;;;;;OAKG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;;OAGG;IACH,oBAAoB,IAAI,UAAU,EAAE;IAMpC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAUjE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAW3E;oBACgB;IAChB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAI7C,IAAI,OAAO,IAAI,OAAO,GAAG,IAAI,CAE5B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAmB/C,YAAY,IAAI,IAAI;IASpB,uDAAuD;IACvD,IAAI,YAAY,IAAI,SAAS,CAE5B;IAED,wEAAwE;IACxE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;sEACkE;IAClE,IAAI,OAAO,IAAI,YAAY,EAAE,CAE5B;IAED,8DAA8D;IAC9D,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAC3D,2GAA2G;IAC3G,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;IAsB1C,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQ1C,2FAA2F;IAC3F,MAAM,IAAI,IAAI;IASd,iDAAiD;IACjD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAIhF"}

package/dist/util/gzip.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Decompress gzip-encoded data, optionally bounded by `maxOutputSize`.
+ *
+ * The gzip footer's ISIZE field is mod 2^32 so it can't be trusted for a
+ * pre-check — we bound output incrementally during streaming decode.
+ */
+export declare function gzipDecompress(data: Uint8Array, maxOutputSize?: number): Promise<Uint8Array<ArrayBuffer>>;
+/** Compress data with gzip. `level` is accepted for API parity with zstd but ignored — the Web API doesn't expose a level. */
+export declare function gzipCompress(data: Uint8Array, _level?: number): Promise<Uint8Array<ArrayBuffer>>;
+//# sourceMappingURL=gzip.d.ts.map

package/dist/util/gzip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gzip.d.ts","sourceRoot":"","sources":["../../src/util/gzip.ts"],"names":[],"mappings":"AAiDA;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAE/G;AAED,8HAA8H;AAC9H,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAEtG"}

package/dist/util/schema.d.ts

@@ -1,20 +1,8 @@
-import { type Schema } from "@query-farm/apache-arrow";
+import { type VgiSchema } from "../arrow/index.js";
 /**
  * Serialize a Schema to the Arrow IPC Schema message format.
  * This produces bytes compatible with Python's `pa.ipc.read_schema()`.
- *
- * We serialize by writing an empty-batch IPC stream and extracting
- * the bytes, which includes the schema message. Python's read_schema()
- * uses `pa.ipc.read_schema(pa.py_buffer(bytes))` which expects
- * the schema flatbuffer message bytes directly — but the Python side
- * actually uses `schema.serialize()` which produces Schema message bytes.
- *
- * In arrow-js, we can get the equivalent by using Message.from(schema)
- * and encoding it, or by serializing a zero-batch stream.
- *
- * The Python `schema.serialize()` produces the Schema flatbuffer message bytes,
- * and `pa.ipc.read_schema()` expects an IPC stream containing a schema message.
- * The actual format is: continuation marker (0xFFFFFFFF) + length + flatbuffer bytes.
+ * Equivalent to writing an empty-batch IPC stream — schema message + EOS marker.
  */
-export declare function serializeSchema(schema: Schema): Uint8Array;
+export declare function serializeSchema(schema: VgiSchema): Uint8Array;
 //# sourceMappingURL=schema.d.ts.map

package/dist/util/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/util/schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAQ1D"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/util/schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAE7D"}

package/dist/util/web-crypto.d.ts

@@ -0,0 +1,22 @@
+/** Cryptographically-strong random bytes. */
+export declare function randomBytes(length: number): Uint8Array;
+/**
+ * Constant-time byte-array comparison. Returns false fast on length mismatch
+ * (the length itself is not a secret), and otherwise XOR-accumulates without
+ * an early return so the comparison takes the same wall time regardless of
+ * which byte differs.
+ */
+export declare function constantTimeEqual(a: Uint8Array, b: Uint8Array): boolean;
+/** HMAC-SHA256 over `data` with `key`. Returns a 32-byte tag. */
+export declare function hmacSha256(key: Uint8Array, data: Uint8Array): Promise<Uint8Array>;
+/**
+ * Verify an HMAC-SHA256 tag in constant time. Equivalent to
+ * `constantTimeEqual(await hmacSha256(key, data), tag)`, but routes through
+ * `crypto.subtle.verify` which is also constant-time on conforming runtimes.
+ */
+export declare function hmacSha256Verify(key: Uint8Array, data: Uint8Array, tag: Uint8Array): Promise<boolean>;
+/** SHA-256 of `data` as raw bytes. */
+export declare function sha256(data: Uint8Array): Promise<Uint8Array>;
+/** SHA-256 of `data` as lower-case hex. */
+export declare function sha256Hex(data: Uint8Array): Promise<string>;
+//# sourceMappingURL=web-crypto.d.ts.map

package/dist/util/web-crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-crypto.d.ts","sourceRoot":"","sources":["../../src/util/web-crypto.ts"],"names":[],"mappings":"AAWA,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAItD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAKvE;AAuCD,iEAAiE;AACjE,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAIvF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3G;AAED,sCAAsC;AACtC,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAGlE;AAED,2CAA2C;AAC3C,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjE"}

package/dist/util/zstd.d.ts

@@ -1,5 +1,28 @@
+/** Return true when the current runtime can produce zstd-compressed output.
+ *
+ *  Bun has `Bun.zstdCompressSync`; Node ≥22.15 / Deno ≥2.6.9 expose it via
+ *  `node:zlib`. Other runtimes (workerd, older Node) have no encoder. The
+ *  fzstd fallback is decompress-only so it doesn't count.
+ */
+export declare function isZstdCompressAvailable(): boolean;
 /** Compress data with zstd at the given level (1-22). */
-export declare function zstdCompress(data: Uint8Array, level: number): Uint8Array<ArrayBuffer>;
-/** Decompress zstd-compressed data. */
-export declare function zstdDecompress(data: Uint8Array): Uint8Array<ArrayBuffer>;
+export declare function zstdCompress(data: Uint8Array, level: number): Promise<Uint8Array<ArrayBuffer>>;
+/**
+ * Decompress zstd-compressed data, optionally bounding the output size.
+ *
+ * Zstd frames carry the decompressed size in the header and decompressors
+ * trust it eagerly: a ~3 KB compressed body claiming 100 MB output would
+ * allocate 100 MB. When `maxOutputSize` is supplied, this helper:
+ *
+ * 1. Reads `Frame_Content_Size` from the frame header. If declared and
+ *    above the cap, refuses *before* allocation with a clear error.
+ * 2. Decompresses, then asserts the actual output size is also under the
+ *    cap (covers frames whose size is not in the header — a streaming
+ *    cap would be tighter, but neither Bun.zstdDecompressSync nor
+ *    node:zlib's sync API exposes one, so we use the post-check).
+ *
+ * Mirrors the Python server-side fix in `_decompress_body` and the
+ * client-side fix in `external_fetch.fetch_url`.
+ */
+export declare function zstdDecompress(data: Uint8Array, maxOutputSize?: number): Promise<Uint8Array<ArrayBuffer>>;
 //# sourceMappingURL=zstd.d.ts.map

package/dist/util/zstd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zstd.d.ts","sourceRoot":"","sources":["../../src/util/zstd.ts"],"names":[],"mappings":"AAcA,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAerF;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,CASxE"}
+{"version":3,"file":"zstd.d.ts","sourceRoot":"","sources":["../../src/util/zstd.ts"],"names":[],"mappings":"AA+BA;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAIjD;AAED,yDAAyD;AACzD,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAoBpG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAsC/G"}

package/dist/wire/opaque.d.ts

@@ -0,0 +1,11 @@
+import { type VgiDataType } from "../arrow/index.js";
+/**
+ * Arrow types whose `.get(0)` / `vectorFromArray` round-trips are unreliable
+ * in arrow-js. For these we extract and re-emit the underlying `Data` object
+ * directly (passthrough), like we already do for Map_.
+ *
+ * Covers Date/Time/Timestamp/Duration/Decimal/LargeUtf8/LargeBinary/
+ * FixedSizeBinary/Dictionary.
+ */
+export declare function isOpaquePassthroughType(type: VgiDataType): boolean;
+//# sourceMappingURL=opaque.d.ts.map

package/dist/wire/opaque.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opaque.d.ts","sourceRoot":"","sources":["../../src/wire/opaque.ts"],"names":[],"mappings":"AAGA,OAAO,EAUL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAYlE"}

package/dist/wire/reader.d.ts

@@ -1,7 +1,7 @@
-import { type RecordBatch, type Schema } from "@query-farm/apache-arrow";
+import type { VgiBatch, VgiSchema } from "../arrow/index.js";
 export interface StreamMessage {
-    schema: Schema;
-    batches: RecordBatch[];
+    schema: VgiSchema;
+    batches: VgiBatch[];
 }
 /**
  * Reads sequential IPC streams from a byte source (e.g., process.stdin).
@@ -25,7 +25,7 @@ export declare class IpcStreamReader {
      * Use readNextBatch() to read batches one at a time.
      * Returns null on EOF.
      */
-    openNextStream(): Promise<Schema | null>;
+    openNextStream(): Promise<VgiSchema | null>;
     /**
      * Read the next batch from the currently open IPC stream.
      * Returns null when the stream ends (EOS).
@@ -34,7 +34,7 @@ export declare class IpcStreamReader {
      * reading from the underlying byte source. This prevents the Arrow-JS
      * reader from consuming bytes that belong to the next IPC stream.
      */
-    readNextBatch(): Promise<RecordBatch | null>;
+    readNextBatch(): Promise<VgiBatch | null>;
     cancel(): Promise<void>;
 }
 //# sourceMappingURL=reader.d.ts.map

package/dist/wire/reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/wire/reader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAqB,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,+EAA+E;IAC/E,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;WAIM,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IASxG;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2BjD;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY9C;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAiB5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/wire/reader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,+EAA+E;IAC/E,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;WAIM,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IASxG;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2BjD;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAYjD;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAiBzC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}

package/dist/wire/request.d.ts

@@ -1,9 +1,9 @@
-import { type RecordBatch, type Schema } from "@query-farm/apache-arrow";
+import { type VgiBatch, type VgiSchema } from "../arrow/index.js";
 export interface ParsedRequest {
     methodName: string;
     requestVersion: string;
     requestId: string | null;
-    schema: Schema;
+    schema: VgiSchema;
     params: Record<string, any>;
     rawMetadata: Map<string, string>;
 }
@@ -11,5 +11,13 @@ export interface ParsedRequest {
  * Parse a request from a RecordBatch with metadata.
  * Extracts method name, version, and params from the batch.
  */
-export declare function parseRequest(schema: Schema, batch: RecordBatch): ParsedRequest;
+export declare function parseRequest(schema: VgiSchema, batch: VgiBatch): ParsedRequest;
+/**
+ * Fill in `defaults` for any params that arrived as null/undefined.
+ * The slim DESCRIBE_VERSION 4 wire format no longer carries defaults to the
+ * client, so default substitution must happen server-side: the client sends
+ * a null in any column it didn't supply, and dispatch swaps in the registered
+ * default before invoking the handler.
+ */
+export declare function applyDefaults(params: Record<string, any>, defaults: Record<string, any> | undefined): Record<string, any>;
 //# sourceMappingURL=request.d.ts.map

package/dist/wire/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/wire/request.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAInF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,aAAa,CAkE9E"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/wire/request.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKlF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,aAAa,CAwG9E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GACxC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAQrB"}

package/dist/wire/response.d.ts

@@ -1,25 +1,25 @@
-import { RecordBatch, type Schema } from "@query-farm/apache-arrow";
+import { type VgiBatch, type VgiSchema } from "../arrow/index.js";
 /**
  * Coerce values for Int64 schema fields from Number to BigInt.
  * Handles both single values and arrays. Returns a new record with coerced values.
  */
-export declare function coerceInt64(schema: Schema, values: Record<string, any>): Record<string, any>;
+export declare function coerceInt64(schema: VgiSchema, values: Record<string, any>): Record<string, any>;
 /**
  * Build a 1-row result batch with optional metadata.
  * For unary methods, `values` maps field names to single values.
  */
-export declare function buildResultBatch(schema: Schema, values: Record<string, any>, serverId: string, requestId: string | null): RecordBatch;
+export declare function buildResultBatch(schema: VgiSchema, values: Record<string, any>, serverId: string, requestId: string | null): VgiBatch;
 /**
  * Build a 0-row error batch with EXCEPTION metadata matching Python's Message.from_exception().
  */
-export declare function buildErrorBatch(schema: Schema, error: Error, serverId: string, requestId: string | null): RecordBatch;
+export declare function buildErrorBatch(schema: VgiSchema, error: Error, serverId: string, requestId: string | null): VgiBatch;
 /**
  * Build a 0-row log batch.
  */
-export declare function buildLogBatch(schema: Schema, level: string, message: string, extra?: Record<string, any>, serverId?: string, requestId?: string | null): RecordBatch;
+export declare function buildLogBatch(schema: VgiSchema, level: string, message: string, extra?: Record<string, any>, serverId?: string, requestId?: string | null): VgiBatch;
 /**
  * Build a 0-row batch from a schema with metadata.
  * Used for error/log batches.
  */
-export declare function buildEmptyBatch(schema: Schema, metadata?: Map<string, string>): RecordBatch;
+export declare function buildEmptyBatch(schema: VgiSchema, metadata?: Map<string, string>): VgiBatch;
 //# sourceMappingURL=response.d.ts.map

package/dist/wire/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/wire/response.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,WAAW,EACX,KAAK,MAAM,EAGZ,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAc5F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,WAAW,CAwCb;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAiBrH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,WAAW,CAeb;AA6BD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAY3F"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/wire/response.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAU3B;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAc/F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,QAAQ,CAqBV;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAmCrH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,QAAQ,CAeV;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAE3F"}