@query-farm/vgi 0.23.0 → 0.24.0

package/dist/catalog/descriptors.d.ts

@@ -163,4 +163,22 @@ export interface CatalogDescriptor {
      * advertises a null `source_url`.
      */
     sourceUrl?: string;
+    /**
+     * Functions this catalog asks the client to *additionally* publish into its
+     * global (DuckDB `system.main`) function namespace, on top of the normal
+     * schema-qualified registration. Surfaced as IPC-serialized `FunctionInfo`
+     * records on `catalog_attach.global_functions`.
+     *
+     * Every entry must also be declared in exactly one of this catalog's
+     * schemas — the `FunctionInfo.schema_name` it carries is the bind-dispatch
+     * key, not a sentinel. Mirrors vgi-python's `Catalog.global_functions`.
+     */
+    globalFunctions?: VgiFunction[];
+    /**
+     * Prefix applied client-side to every `globalFunctions` entry's name when it
+     * is published globally (e.g. prefix `vgi_example` + `global_scalar` →
+     * `vgi_example_global_scalar`). The advertised `FunctionInfo.name` stays
+     * unprefixed. Surfaced as `catalog_attach.global_function_prefix`.
+     */
+    globalFunctionPrefix?: string;
 }

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

@@ -22,6 +22,26 @@ export declare class ReadOnlyCatalogInterface extends CatalogInterface {
     } | null;
     schemaContentsViews(attachOpaqueData: AttachOpaqueData, name: string, transactionOpaqueData?: TransactionOpaqueData): ViewInfo[];
     schemaContentsFunctions(attachOpaqueData: AttachOpaqueData, name: string, type: string, transactionOpaqueData?: TransactionOpaqueData): FunctionInfo[];
+    /**
+     * Build the wire `FunctionInfo` for one declared function.
+     *
+     * `schemaName` is the schema the function actually lives in — it is the
+     * bind-dispatch key, so a function advertised through more than one route
+     * (schema contents *and* `global_functions`) must carry the same value in
+     * both. Shared by `schemaContentsFunctions` and `_globalFunctionInfos`.
+     */
+    private _functionToInfo;
+    /**
+     * Build `FunctionInfo` records for `CatalogDescriptor.globalFunctions`.
+     *
+     * Each entry's `schema_name` is the schema it actually lives in — the
+     * globally visible name is derived client-side from
+     * `global_function_prefix`, so `name` stays unprefixed here. An entry not
+     * declared in any schema is a descriptor bug, so it throws rather than
+     * advertising a function no bind can resolve. Mirrors vgi-python's
+     * `_global_function_infos`.
+     */
+    private _globalFunctionInfos;
     schemaContentsMacros(attachOpaqueData: AttachOpaqueData, name: string, type: string, transactionOpaqueData?: TransactionOpaqueData): MacroInfo[];
     schemaContentsIndexes(attachOpaqueData: AttachOpaqueData, name: string, transactionOpaqueData?: TransactionOpaqueData): IndexInfo[];
     indexGet(attachOpaqueData: AttachOpaqueData, schemaName: string, name: string, transactionOpaqueData?: TransactionOpaqueData): IndexInfo | null;

package/dist/client-entry.js

@@ -2465,6 +2465,8 @@ var CatalogAttachResultSchema = schema2([
   field2("comment", utf82(), true),
   field2("tags", map2(field2("key", utf82(), false), field2("value", utf82(), true), false), false),
   field2("supports_column_statistics", bool2(), false),
+  field2("global_functions", list2(field2("item", binary2(), true)), false),
+  field2("global_function_prefix", utf82(), false),
   field2("resolved_data_version", utf82(), true),
   field2("resolved_implementation_version", utf82(), true)
 ]);
@@ -3373,6 +3375,8 @@ class VgiClient {
       comment: inner.comment ?? null,
       tags: deserializeTags(inner.tags),
       supports_column_statistics: inner.supports_column_statistics ?? false,
+      global_functions: inner.global_functions ? (Array.isArray(inner.global_functions) ? inner.global_functions : [...inner.global_functions]).map(toUint8Array) : [],
+      global_function_prefix: inner.global_function_prefix ?? "",
       resolved_data_version: inner.resolved_data_version ?? null,
       resolved_implementation_version: inner.resolved_implementation_version ?? null
     };
@@ -3923,4 +3927,4 @@ export {
   ArgumentValidationError
 };
 
-//# debugId=FCC2DEE998E0D9AC64756E2164756E21
+//# debugId=34D58DEB536066C064756E2164756E21