@query-farm/vgi 0.30.0 → 0.32.0

package/README.md

@@ -41,7 +41,7 @@ npm install @query-farm/vgi
 Requires **Node.js ≥ 22.15** or **Bun**.
 
 > **Peer dependencies (since 0.3.0).** `@query-farm/apache-arrow` (`^21.1.1`) and
-> `@query-farm/vgi-rpc` (`^0.7.5`) are **peerDependencies** — install them directly
+> `@query-farm/vgi-rpc` (`^0.24.0`) are **peerDependencies** — install them directly
 > alongside `@query-farm/vgi`:
 >
 > ```bash

package/dist/catalog/item-encoding.d.ts

@@ -0,0 +1,17 @@
+import { type FunctionInfo } from "../generated/vgi-client.js";
+/**
+ * Deep-freeze a catalog item (plain objects and arrays, recursively) so it can
+ * be shared between requests and its encoding memoized.
+ *
+ * Binary fields (`Uint8Array` and other ArrayBuffer views) are left as they are
+ * -- a typed array with elements cannot be frozen -- and must be treated as
+ * read-only by convention, like the rest of a shared item.
+ */
+export declare function freezeCatalogItem<T extends object>(item: T): Readonly<T>;
+/**
+ * Arrow-encode a FunctionInfo, once per frozen instance.
+ *
+ * The bytes returned for a frozen item are shared between calls; callers copy
+ * them into a response and never write to them.
+ */
+export declare function encodeFunctionInfoOnce(info: FunctionInfo): Uint8Array;

package/dist/catalog/read-only.d.ts

@@ -7,6 +7,17 @@ export declare class ReadOnlyCatalogInterface extends CatalogInterface {
     private _registry;
     private _attachments;
     private _version;
+    /**
+     * Function listings by schema and listing type, built on first request. A
+     * listing depends only on the registered functions' static metadata, so it
+     * is built once and every request returns the same frozen FunctionInfo
+     * instances -- which the listing handler then encodes once each (see
+     * item-encoding.ts). The descriptor is treated as immutable after the first
+     * listing, as the rest of this class already does.
+     */
+    private _functionListings;
+    /** One frozen FunctionInfo per (declaring schema, function), shared by listings and `global_functions`. */
+    private _functionInfos;
     constructor(descriptor: CatalogDescriptor, registry: FunctionRegistry);
     /**
      * Which schema declares `fn`, by object identity, or null if no schema does.
@@ -50,6 +61,11 @@ export declare class ReadOnlyCatalogInterface extends CatalogInterface {
     } | null;
     schemaContentsViews(attachOpaqueData: AttachOpaqueData, path: string[], transactionOpaqueData?: TransactionOpaqueData): ViewInfo[];
     schemaContentsFunctions(attachOpaqueData: AttachOpaqueData, path: string[], type: string, transactionOpaqueData?: TransactionOpaqueData): FunctionInfo[];
+    /**
+     * The frozen FunctionInfo for `f` as declared in `schema`, built on first use.
+     * Shared between requests, so it must not (and, frozen, cannot) be mutated.
+     */
+    private _sharedFunctionInfo;
     /**
      * Build the wire `FunctionInfo` for one declared function.
      *

package/dist/client-entry.js

@@ -3409,6 +3409,24 @@ function wrapRpcWithErrorEnrichment(rpc) {
         throw e;
       }
     },
+    async callRaw(method, input) {
+      try {
+        return await rpc.callRaw(method, input);
+      } catch (e) {
+        if (e instanceof RpcError)
+          throw VgiClientError.fromRpcError(e);
+        throw e;
+      }
+    },
+    async streamRaw(method, input, options) {
+      try {
+        return await rpc.streamRaw(method, input, options);
+      } catch (e) {
+        if (e instanceof RpcError)
+          throw VgiClientError.fromRpcError(e);
+        throw e;
+      }
+    },
     describe: () => rpc.describe(),
     close: () => rpc.close()
   };
@@ -4344,4 +4362,4 @@ export {
   typeSignature
 };
 
-//# debugId=8F5FB740A8A1AC8864756E2164756E21
+//# debugId=883855CB7A9BD5B664756E2164756E21