@query-farm/vgi 0.30.0 → 0.31.0

package/dist/protocol/dispatch.d.ts

@@ -20,4 +20,30 @@ export interface ProtocolConfig {
      */
     signingKey?: Uint8Array;
 }
+/**
+ * Wire name of the VGI protocol: the `vgi_rpc.protocol` routing key and the
+ * `{protocol}` HTTP path segment.
+ *
+ * The name carries the major version, so an incompatible major is a
+ * *different* protocol and therefore a 404 — an answer every proxy, WAF and
+ * load balancer understands without an Arrow parser, and one that lets
+ * `vgi.v2` and a future `vgi.v3` be served side by side while clients migrate.
+ * That matters for this consumer specifically: the DuckDB extension ships to
+ * users and cannot be flag-dayed.
+ *
+ * Declared rather than derived. Until the transports made the routing key
+ * required, each implementation's wire name defaulted to whatever its local
+ * type was called, which left the six ports disagreeing four ways — Python
+ * `VgiProtocol`, Java and C# `VgiService`, Go the framework default `Service`,
+ * this port `vgi` — so no client could address them all. The canonical name is
+ * decided in vgi-python and emitted by the DuckDB extension; this is that same
+ * string, not an independent choice.
+ *
+ * Since `@query-farm/vgi-rpc` 0.24.0 the name is also bound into the AEAD
+ * associated data of every state and call token (`TokenScope.protocol`), so a
+ * caller that opens a token minted by this protocol has to name it. Exported
+ * so the HTTP entry points build that scope from the same constant the
+ * protocol is registered under rather than a second copy of the literal.
+ */
+export declare const VGI_PROTOCOL_NAME = "vgi.v2";
 export declare function buildVgiProtocol(config: ProtocolConfig): Protocol;

package/dist/serve-entry.js

@@ -6342,8 +6342,9 @@ function registerCatalogMethods(protocol, catalog, _catalogName, signingKey) {
 }
 
 // src/protocol/dispatch.ts
+var VGI_PROTOCOL_NAME = "vgi.v2";
 function buildVgiProtocol(config) {
-  const protocol = new Protocol("vgi", { protocolVersion: "2.0.0" });
+  const protocol = new Protocol(VGI_PROTOCOL_NAME, { protocolVersion: "2.0.0" });
   registerFunctionMethods(protocol, {
     registry: config.registry,
     recoverExchangeState: config.recoverExchangeState,
@@ -6498,7 +6499,10 @@ function createVgiFetch(opts) {
     ...opts.protocol,
     recoverExchangeState: async (opaqueData) => {
       const tokenString = new TextDecoder().decode(opaqueData);
-      const unpacked = await unpackStateToken(tokenString, opts.signingKey, tokenTtl, undefined);
+      const unpacked = await unpackStateToken(tokenString, opts.signingKey, tokenTtl, {
+        protocol: VGI_PROTOCOL_NAME,
+        principal: undefined
+      });
       return arrowStateSerializer.deserialize(unpacked.stateBytes);
     }
   });
@@ -6652,4 +6656,4 @@ export {
   serveVgiWorker
 };
 
-//# debugId=DAEEFC0FEEC3B53164756E2164756E21
+//# debugId=D209EDA2709578AC64756E2164756E21