@query-farm/vgi 0.41.0 → 0.42.0

package/dist/protocol/dispatch.d.ts

@@ -39,4 +39,17 @@ export interface ProtocolConfig {
  * protocol is registered under rather than a second copy of the literal.
  */
 export declare const VGI_PROTOCOL_NAME = "vgi.v2";
+/**
+ * The `vgi.v2` protocol hash `vgi_rpc.Reflection.v1` must report for this
+ * worker: the reference's (vgi-python 0.43.0, 72 methods). Every SDK hosts
+ * every `vgi.v2` method with the reference's schemas, so the hash is one value
+ * across the ports; a method this SDK does not implement is still registered
+ * (handlers/unimplemented.ts). The hash covers method names, types and the
+ * params/result/header schemas only (WIRE_PROTOCOL.md §14).
+ *
+ * It changes only with vgi.v2's protocol version (currently 2.1.0). Asserted
+ * by src/protocol/__tests__/vgi-v2-hash.test.ts; if that test fails, the
+ * surface drifted from the reference -- fix the schemas, do not bump this.
+ */
+export declare const VGI_V2_PROTOCOL_HASH = "774cb80090d71ea76d09aa311b9cda4ca4c33c3bf72c43242eb6dc87b6f79ce5";
 export declare function buildVgiProtocol(config: ProtocolConfig): Protocol;

package/dist/protocol/handlers/unimplemented.d.ts

@@ -0,0 +1,17 @@
+import { type Protocol } from "@query-farm/vgi-rpc";
+import type { VgiSchema } from "../../arrow/index.js";
+/** One unimplemented method: its wire name and the reference's schemas. */
+interface UnimplementedMethod {
+    readonly name: string;
+    readonly params: VgiSchema;
+    readonly result: VgiSchema;
+}
+/**
+ * The vgi.v2 methods (of the reference's 72) this SDK does not implement.
+ * Exported so a test can assert each one refuses with UNIMPLEMENTED.
+ */
+export declare const UNIMPLEMENTED_METHODS: readonly UnimplementedMethod[];
+/** The message every unimplemented method answers with. */
+export declare function unimplementedMessage(method: string): string;
+export declare function registerUnimplementedMethods(protocol: Protocol): void;
+export {};

package/dist/serve-entry.js

@@ -7371,6 +7371,38 @@ function registerCatalogMethods(protocol, catalog, _catalogName, signingKey) {
   registerCatalogIndexMethods(protocol, getCatalog, signingKey);
 }
 
+// src/protocol/handlers/unimplemented.ts
+import { MethodNotImplementedError } from "@query-farm/vgi-rpc";
+var UNIMPLEMENTED_METHODS = [
+  { name: "aggregate_streaming_open", params: REQUEST_PARAMS_SCHEMA, result: RESULT_BINARY_SCHEMA },
+  { name: "aggregate_streaming_chunk", params: REQUEST_PARAMS_SCHEMA, result: RESULT_BINARY_SCHEMA },
+  { name: "aggregate_streaming_close", params: REQUEST_PARAMS_SCHEMA, result: RESULT_BINARY_SCHEMA },
+  { name: "aggregate_window_init", params: REQUEST_PARAMS_SCHEMA, result: RESULT_BINARY_SCHEMA },
+  { name: "aggregate_window", params: REQUEST_PARAMS_SCHEMA, result: RESULT_BINARY_SCHEMA },
+  { name: "aggregate_window_batch", params: REQUEST_PARAMS_SCHEMA, result: RESULT_BINARY_SCHEMA },
+  { name: "aggregate_window_destructor", params: REQUEST_PARAMS_SCHEMA, result: RESULT_BINARY_SCHEMA },
+  { name: "catalog_index_create", params: CatalogIndexCreateParamsSchema, result: emptyResultSchema },
+  { name: "catalog_index_drop", params: CatalogIndexDropParamsSchema, result: emptyResultSchema },
+  { name: "catalog_table_column_comment_set", params: CatalogTableColumnCommentSetParamsSchema, result: emptyResultSchema },
+  { name: "catalog_table_insert_function_get", params: CatalogTableInsertFunctionGetParamsSchema, result: RESULT_BINARY_SCHEMA },
+  { name: "catalog_table_update_function_get", params: CatalogTableUpdateFunctionGetParamsSchema, result: RESULT_BINARY_SCHEMA },
+  { name: "catalog_table_delete_function_get", params: CatalogTableDeleteFunctionGetParamsSchema, result: RESULT_BINARY_SCHEMA }
+];
+function unimplementedMessage(method) {
+  return `${method} is not implemented by this worker`;
+}
+function registerUnimplementedMethods(protocol) {
+  for (const m of UNIMPLEMENTED_METHODS) {
+    protocol.unary(m.name, {
+      params: m.params,
+      result: m.result,
+      handler: async () => {
+        throw new MethodNotImplementedError(unimplementedMessage(m.name));
+      }
+    });
+  }
+}
+
 // src/protocol/dispatch.ts
 var VGI_PROTOCOL_NAME = "vgi.v2";
 function buildVgiProtocol(config) {
@@ -7383,6 +7415,7 @@ function buildVgiProtocol(config) {
   registerAggregateMethods(protocol, config.registry);
   registerTableBufferingMethods(protocol, config.registry, config.signingKey);
   registerCatalogMethods(protocol, config.catalogInterface, config.catalogName, config.signingKey);
+  registerUnimplementedMethods(protocol);
   return protocol;
 }
 
@@ -7826,4 +7859,4 @@ export {
   serveVgiWorker
 };
 
-//# debugId=9AD0D580690218C964756E2164756E21
+//# debugId=6B882607A7F5F68164756E2164756E21