@query-farm/vgi 0.36.1 → 0.36.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@query-farm/vgi",
-  "version": "0.36.1",
+  "version": "0.36.2",
   "description": "TypeScript framework for extending DuckDB with user-defined functions via the Vector Gateway Interface (VGI) over Arrow IPC.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Query Farm LLC (https://query.farm)",

package/src/client/client.ts

@@ -422,7 +422,8 @@ export class VgiClient {
       inputSession.close();
     }
 
-    // Phase 2: FINALIZE
+    // Phase 2: FINALIZE — skipped entirely for a function with no finalize stage.
+    if (opts.hasFinalize === false) return;
     const { session: finalizeSession } = await this._doInit(
       bindReq,
       bindResp,
@@ -502,6 +503,8 @@ export class VgiClient {
       inputSession.close();
     }
 
+    // FINALIZE — skipped entirely for a function with no finalize stage.
+    if (opts.hasFinalize === false) return;
     const { session: finalizeSession } = await this._doInit(
       bindReq,
       bindResp,

package/src/client/types.ts

@@ -139,4 +139,15 @@ export interface TableInOutFunctionOptions {
   joinKeys?: VgiBatch[];
   /** Invoked after bind, before init. Receives the bind response. */
   onBind?: BindResultCallback;
+  /**
+   * Whether the function declares a FINALIZE stage (`FunctionInfo.has_finalize`).
+   * Defaults to `true`, preserving the unconditional FINALIZE-phase `init()` every
+   * caller got before this option existed. Pass `false` for a function known to have
+   * no finalize — every blended row-transform function (`defineRowTransformFunction`,
+   * `FunctionInfo.input_from_args`) — to skip the FINALIZE `init()` entirely: the
+   * worker rejects an unexpected FINALIZE for a function that never advertised one.
+   * The DuckDB extension avoids it the same way (it registers no final callback).
+   * Mirrors vgi-python's `table_in_out_function(has_finalize=...)`.
+   */
+  hasFinalize?: boolean;
 }