@query-farm/vgi 0.37.0 → 0.38.0

package/dist/codec/asd.d.ts

@@ -18,6 +18,14 @@ import { type VgiSchema } from "../arrow/index.js";
  * Matches Python's `ArrowSerializableDataclass.serialize_to_bytes()`.
  */
 export declare function encodeASD(schema: VgiSchema, obj: Record<string, any>): Uint8Array;
+/** Compare two strings by Unicode code point (= UTF-8 byte order). */
+export declare function compareCodePoints(a: string, b: string): number;
+/**
+ * `obj` with every map-typed field (at any depth) as a key-sorted pair list.
+ * Returns `obj` itself when the schema has no map column. Never mutates `obj`
+ * (catalog items may be frozen and shared).
+ */
+export declare function sortMapsForSchema(schema: VgiSchema, obj: Record<string, any>): Record<string, any>;
 /**
  * Decode a single-row Arrow IPC stream into a typed object using `schema`.
  * Matches Python's `ArrowSerializableDataclass.deserialize_from_bytes()`.

package/dist/generated/vgi-client.d.ts

@@ -357,10 +357,29 @@ export interface CatalogAttachResult {
     global_function_prefix: string;
     resolved_data_version?: string | null;
     resolved_implementation_version?: string | null;
+    supports_catalog_contents: boolean;
 }
 export interface CatalogsResponse {
     items: CatalogInfo[];
 }
+export interface SchemaContents {
+    path: string[];
+    schema: Uint8Array;
+    tables: Uint8Array[];
+    views: Uint8Array[];
+    scalar_functions: Uint8Array[];
+    aggregate_functions: Uint8Array[];
+    table_functions: Uint8Array[];
+    scalar_macros: Uint8Array[];
+    table_macros: Uint8Array[];
+    indexes: Uint8Array[];
+}
+export interface CatalogContentsResponse {
+    catalog_version: number;
+    etag?: string | null;
+    not_modified: boolean;
+    schemas: SchemaContents[];
+}
 export interface CopyFromFormatsResponse {
     items: Uint8Array[];
 }

package/dist/generated/vgi-protocol-schemas.d.ts

@@ -12,6 +12,7 @@ export declare const ScanBranchSchema: import("../index.core.js").VgiSchema;
 export declare const ScanSplitSchema: import("../index.core.js").VgiSchema;
 export declare const AttachCatalogInfoSchema: import("../index.core.js").VgiSchema;
 export declare const ForeignKeyInfoSchema: import("../index.core.js").VgiSchema;
+export declare const SchemaContentsSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateBindRequestSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateCombineRequestSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateDestructorRequestSchema: import("../index.core.js").VgiSchema;
@@ -57,6 +58,7 @@ export declare const AggregateWindowInitResultSchema: import("../index.core.js")
 export declare const BindResultSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogAttachResultSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogCatalogsResultSchema: import("../index.core.js").VgiSchema;
+export declare const CatalogContentsResultSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogCopyFromFormatsResultSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogIndexGetResultSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogMacroGetResultSchema: import("../index.core.js").VgiSchema;
@@ -92,6 +94,7 @@ export declare const AggregateWindowInitParamsSchema: import("../index.core.js")
 export declare const BindParamsSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogAttachParamsSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogCatalogsParamsSchema: import("../index.core.js").VgiSchema;
+export declare const CatalogContentsParamsSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogCopyFromFormatsParamsSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogCreateParamsSchema: import("../index.core.js").VgiSchema;
 export declare const CatalogDetachParamsSchema: import("../index.core.js").VgiSchema;

package/dist/generated/vgi-protocol-types.d.ts

@@ -0,0 +1,26 @@
+import type { CatalogAttachResult, CatalogContentsResponse, SchemaContents } from "./vgi-client.js";
+export type { CatalogAttachResult, CatalogContentsResponse, SchemaContents };
+/** Fields of `CatalogAttachResult` that have a protocol default. */
+export type CatalogAttachResultDefaultedField = "attach_opaque_data_required" | "default_schema" | "settings" | "secret_types" | "attach_catalogs" | "comment" | "tags" | "supports_column_statistics" | "global_functions" | "global_function_prefix" | "supports_catalog_contents";
+/** `CatalogAttachResult` with every field that has a protocol default optional. */
+export type CatalogAttachResultInit = Omit<CatalogAttachResult, CatalogAttachResultDefaultedField> & Partial<Pick<CatalogAttachResult, CatalogAttachResultDefaultedField>>;
+/** Build a complete `CatalogAttachResult`, filling the protocol defaults, in wire order. */
+export declare function buildCatalogAttachResult(init: CatalogAttachResultInit): CatalogAttachResult;
+export declare const encodeCatalogAttachResult: (v: CatalogAttachResult) => Uint8Array;
+export declare const decodeCatalogAttachResult: (b: Uint8Array) => CatalogAttachResult;
+/** Fields of `SchemaContents` that have a protocol default. */
+export type SchemaContentsDefaultedField = "tables" | "views" | "scalar_functions" | "aggregate_functions" | "table_functions" | "scalar_macros" | "table_macros" | "indexes";
+/** `SchemaContents` with every field that has a protocol default optional. */
+export type SchemaContentsInit = Omit<SchemaContents, SchemaContentsDefaultedField> & Partial<Pick<SchemaContents, SchemaContentsDefaultedField>>;
+/** Build a complete `SchemaContents`, filling the protocol defaults, in wire order. */
+export declare function buildSchemaContents(init: SchemaContentsInit): SchemaContents;
+export declare const encodeSchemaContents: (v: SchemaContents) => Uint8Array;
+export declare const decodeSchemaContents: (b: Uint8Array) => SchemaContents;
+/** Fields of `CatalogContentsResponse` that have a protocol default. */
+export type CatalogContentsResponseDefaultedField = "etag" | "not_modified" | "schemas";
+/** `CatalogContentsResponse` with every field that has a protocol default optional. */
+export type CatalogContentsResponseInit = Omit<CatalogContentsResponse, CatalogContentsResponseDefaultedField> & Partial<Pick<CatalogContentsResponse, CatalogContentsResponseDefaultedField>>;
+/** Build a complete `CatalogContentsResponse`, filling the protocol defaults, in wire order. */
+export declare function buildCatalogContentsResponse(init: CatalogContentsResponseInit): CatalogContentsResponse;
+export declare const encodeCatalogContentsResponse: (v: CatalogContentsResponse) => Uint8Array;
+export declare const decodeCatalogContentsResponse: (b: Uint8Array) => CatalogContentsResponse;

package/dist/http/fetch.d.ts

@@ -1,7 +1,8 @@
 import { type AuthenticateFn, type PeerAuthenticationPolicy, type PeerIdentityProvider, type PeerResolutionOptions } from "@query-farm/vgi-rpc";
 import { type ProtocolConfig } from "../protocol/dispatch.js";
 import { type LandingInfo } from "./landing.js";
-export interface VgiFetchOptions {
+import { type HostingOptions } from "../rpc-server.js";
+export interface VgiFetchOptions extends HostingOptions {
     /** Wire-protocol config (registry + catalogInterface). */
     protocol: ProtocolConfig;
     /** HMAC key for state-token signing. Pass a stable, secret 32-byte key

package/dist/index.core.d.ts

@@ -7,9 +7,9 @@ export { defineTableBufferingFunction, type TableBufferingConfig, type TableBuff
 export { defineCopyFromFunction, type CopyFromFunctionConfig, type CopyFromOption, type CopyFromReadParams, } from "./functions/copy-from.js";
 export { defineCopyToFunction, type CopyToFunctionConfig, type CopyToOption, type CopyToWriteParams, type CopyToCloseParams, } from "./functions/copy-to.js";
 export type { VgiFunction, FunctionMeta, StreamHandlers, FunctionExample, HandlerState } from "./functions/types.js";
-export { CatalogInterface, type CatalogAttachResult, type SchemaInfo, encodeSchemaInfo, decodeSchemaInfo, type TableInfo, encodeTableInfo, decodeTableInfo, type ViewInfo, encodeViewInfo, decodeViewInfo, type CatalogInfo, encodeCatalogInfo, decodeCatalogInfo, type FunctionInfo, encodeFunctionInfo, decodeFunctionInfo, type FunctionInfoOptions, type MacroInfo, encodeMacroInfo, decodeMacroInfo, type MacroType, type CopyFromFormatInfo, encodeCopyFromFormatInfo, type AttachOpaqueData, type TransactionOpaqueData, buildScanBranchesResult, encodeFormatOptions, type ScanBranchInput } from "./catalog/interface.js";
+export { CatalogInterface, type CatalogAttachResult, type CatalogAttachResultInit, buildCatalogAttachResult, type SchemaContentsInfo, type CatalogContentsResult, type SchemaInfo, encodeSchemaInfo, decodeSchemaInfo, type TableInfo, encodeTableInfo, decodeTableInfo, type ViewInfo, encodeViewInfo, decodeViewInfo, type CatalogInfo, encodeCatalogInfo, decodeCatalogInfo, type FunctionInfo, encodeFunctionInfo, decodeFunctionInfo, type FunctionInfoOptions, type MacroInfo, encodeMacroInfo, decodeMacroInfo, type MacroType, type CopyFromFormatInfo, encodeCopyFromFormatInfo, type AttachOpaqueData, type TransactionOpaqueData, buildScanBranchesResult, encodeFormatOptions, type ScanBranchInput } from "./catalog/interface.js";
 export type { CatalogDescriptor, SchemaDescriptor, TableDescriptor, ViewDescriptor, MacroDescriptor, SettingDescriptor, SecretTypeDescriptor, ForeignKeyDef, DefaultValue } from "./catalog/descriptors.js";
-export { ReadOnlyCatalogInterface } from "./catalog/read-only.js";
+export { ReadOnlyCatalogInterface, READ_ONLY_ITEM_ATTACH_ID } from "./catalog/read-only.js";
 export { CompositeCatalogInterface } from "./catalog/composite.js";
 export { FunctionRegistry } from "./functions/registry.js";
 export { FunctionType, FunctionStability, NullHandling, ArgumentMonotonicity, OrderPreservation, OrderDependence, DistinctDependence, TableInOutPhase, DEFAULT_MAX_WORKERS, } from "./types.js";
@@ -43,4 +43,7 @@ export type { VgiClientOptions, TableFunctionOptions, ScalarFunctionOptions, Tab
 export { str, bytes, int, int32, float, float32, bool, toSchema, OutputCollector, AuthContext } from "@query-farm/vgi-rpc";
 export { subprocessConnect, httpConnect, tcpConnect } from "@query-farm/vgi-rpc";
 export type { RpcClient, StreamSession, LogMessage } from "@query-farm/vgi-rpc";
+export { buildRpcServer, INTROSPECT_PRINCIPALS_ENV, type BuildRpcServerOptions, type HostingOptions, type ServerTransport, } from "./rpc-server.js";
+export { AuthUnavailableError, GrantRefusedError, IdentityUnavailableError, StatusError, } from "@query-farm/vgi-rpc";
+export type { GrantMinter, IssuedGrant, TokenIdentity, TokenResolver } from "@query-farm/vgi-rpc";
 export { normalizeSchemaPath, schemaPathDisplay, schemaPathKey, schemaPathsEqual, type SchemaPath } from "./schema-path.js";