@constructive-io/react 0.23.15 → 0.23.17

package/esm/config/hooks/queries/usePlatformConfigDefinitionsQuery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Registry of valid config keys — declares which config entries the platform recognizes
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { ListSelectionConfig } from '../selection';
+import type { PlatformConfigDefinitionSelect, PlatformConfigDefinitionWithRelations, PlatformConfigDefinitionFilter, PlatformConfigDefinitionOrderBy } from '../../orm/input-types';
+import type { InferSelectResult, ConnectionResult, HookStrictSelect } from '../../orm/select-types';
+export type { PlatformConfigDefinitionSelect, PlatformConfigDefinitionWithRelations, PlatformConfigDefinitionFilter, PlatformConfigDefinitionOrderBy, } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const platformConfigDefinitionsQueryKey: (variables?: object) => readonly ["platformconfigdefinition", "list", object];
+/**
+ * Registry of valid config keys — declares which config entries the platform recognizes
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = usePlatformConfigDefinitionsQuery({
+ *   selection: {
+ *     fields: { id: true, name: true },
+ *     where: { name: { equalTo: "example" } },
+ *     orderBy: ['CREATED_AT_DESC'],
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function usePlatformConfigDefinitionsQuery<S extends PlatformConfigDefinitionSelect, TData = {
+    platformConfigDefinitions: ConnectionResult<InferSelectResult<PlatformConfigDefinitionWithRelations, S>>;
+}>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PlatformConfigDefinitionFilter, PlatformConfigDefinitionOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PlatformConfigDefinitionSelect>;
+} & Omit<UseQueryOptions<{
+    platformConfigDefinitions: ConnectionResult<InferSelectResult<PlatformConfigDefinitionWithRelations, S>>;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Registry of valid config keys — declares which config entries the platform recognizes
+ *
+ * @example
+ * ```ts
+ * const data = await fetchPlatformConfigDefinitionsQuery({
+ *   selection: {
+ *     fields: { id: true },
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function fetchPlatformConfigDefinitionsQuery<S extends PlatformConfigDefinitionSelect>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PlatformConfigDefinitionFilter, PlatformConfigDefinitionOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PlatformConfigDefinitionSelect>;
+}): Promise<{
+    platformConfigDefinitions: ConnectionResult<InferSelectResult<PlatformConfigDefinitionWithRelations, S>>;
+}>;
+/**
+ * Registry of valid config keys — declares which config entries the platform recognizes
+ *
+ * @example
+ * ```ts
+ * await prefetchPlatformConfigDefinitionsQuery(queryClient, { selection: { fields: { id: true }, first: 10 } });
+ * ```
+ */
+export declare function prefetchPlatformConfigDefinitionsQuery<S extends PlatformConfigDefinitionSelect>(queryClient: QueryClient, params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PlatformConfigDefinitionFilter, PlatformConfigDefinitionOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PlatformConfigDefinitionSelect>;
+}): Promise<void>;

package/esm/config/hooks/queries/usePlatformConfigDefinitionsQuery.js

@@ -0,0 +1,32 @@
+/**
+ * Registry of valid config keys — declares which config entries the platform recognizes
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildListSelectionArgs } from '../selection';
+import { platformConfigDefinitionKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const platformConfigDefinitionsQueryKey = platformConfigDefinitionKeys.list;
+export function usePlatformConfigDefinitionsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: platformConfigDefinitionKeys.list(args),
+        queryFn: () => getClient().platformConfigDefinition.findMany(args).unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchPlatformConfigDefinitionsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    return getClient().platformConfigDefinition.findMany(args).unwrap();
+}
+export async function prefetchPlatformConfigDefinitionsQuery(queryClient, params) {
+    const args = buildListSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: platformConfigDefinitionKeys.list(args),
+        queryFn: () => getClient().platformConfigDefinition.findMany(args).unwrap(),
+    });
+}

package/esm/config/hooks/queries/usePlatformConfigQuery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { PlatformConfigSelect, PlatformConfigWithRelations } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { PlatformConfigSelect, PlatformConfigWithRelations } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const platformConfigQueryKey: (id: string | number) => readonly ["platformconfig", "detail", string | number];
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = usePlatformConfigQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true, name: true } },
+ * });
+ * ```
+ */
+export declare function usePlatformConfigQuery<S extends PlatformConfigSelect, TData = {
+    platformConfig: InferSelectResult<PlatformConfigWithRelations, S> | null;
+}>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PlatformConfigSelect>;
+} & Omit<UseQueryOptions<{
+    platformConfig: InferSelectResult<PlatformConfigWithRelations, S> | null;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ *
+ * @example
+ * ```ts
+ * const data = await fetchPlatformConfigQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true } },
+ * });
+ * ```
+ */
+export declare function fetchPlatformConfigQuery<S extends PlatformConfigSelect>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PlatformConfigSelect>;
+}): Promise<{
+    platformConfig: InferSelectResult<PlatformConfigWithRelations, S> | null;
+}>;
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ *
+ * @example
+ * ```ts
+ * await prefetchPlatformConfigQuery(queryClient, { id: 'some-id', selection: { fields: { id: true } } });
+ * ```
+ */
+export declare function prefetchPlatformConfigQuery<S extends PlatformConfigSelect>(queryClient: QueryClient, params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PlatformConfigSelect>;
+}): Promise<void>;

package/esm/config/hooks/queries/usePlatformConfigQuery.js

@@ -0,0 +1,47 @@
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { platformConfigKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const platformConfigQueryKey = platformConfigKeys.detail;
+export function usePlatformConfigQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: platformConfigKeys.detail(params.id),
+        queryFn: () => getClient()
+            .platformConfig.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchPlatformConfigQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    return getClient()
+        .platformConfig.findOne({
+        id: params.id,
+        select: args.select,
+    })
+        .unwrap();
+}
+export async function prefetchPlatformConfigQuery(queryClient, params) {
+    const args = buildSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: platformConfigKeys.detail(params.id),
+        queryFn: () => getClient()
+            .platformConfig.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+    });
+}

package/esm/config/hooks/queries/usePlatformConfigsQuery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { ListSelectionConfig } from '../selection';
+import type { PlatformConfigSelect, PlatformConfigWithRelations, PlatformConfigFilter, PlatformConfigOrderBy } from '../../orm/input-types';
+import type { InferSelectResult, ConnectionResult, HookStrictSelect } from '../../orm/select-types';
+export type { PlatformConfigSelect, PlatformConfigWithRelations, PlatformConfigFilter, PlatformConfigOrderBy, } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const platformConfigsQueryKey: (variables?: object) => readonly ["platformconfig", "list", object];
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = usePlatformConfigsQuery({
+ *   selection: {
+ *     fields: { id: true, name: true },
+ *     where: { name: { equalTo: "example" } },
+ *     orderBy: ['CREATED_AT_DESC'],
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function usePlatformConfigsQuery<S extends PlatformConfigSelect, TData = {
+    platformConfigs: ConnectionResult<InferSelectResult<PlatformConfigWithRelations, S>>;
+}>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PlatformConfigFilter, PlatformConfigOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PlatformConfigSelect>;
+} & Omit<UseQueryOptions<{
+    platformConfigs: ConnectionResult<InferSelectResult<PlatformConfigWithRelations, S>>;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ *
+ * @example
+ * ```ts
+ * const data = await fetchPlatformConfigsQuery({
+ *   selection: {
+ *     fields: { id: true },
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function fetchPlatformConfigsQuery<S extends PlatformConfigSelect>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PlatformConfigFilter, PlatformConfigOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PlatformConfigSelect>;
+}): Promise<{
+    platformConfigs: ConnectionResult<InferSelectResult<PlatformConfigWithRelations, S>>;
+}>;
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ *
+ * @example
+ * ```ts
+ * await prefetchPlatformConfigsQuery(queryClient, { selection: { fields: { id: true }, first: 10 } });
+ * ```
+ */
+export declare function prefetchPlatformConfigsQuery<S extends PlatformConfigSelect>(queryClient: QueryClient, params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PlatformConfigFilter, PlatformConfigOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PlatformConfigSelect>;
+}): Promise<void>;

package/esm/config/hooks/queries/usePlatformConfigsQuery.js

@@ -0,0 +1,32 @@
+/**
+ * App-level plaintext key-value config store (like a k8s ConfigMap); admin-only, fully CRUD-exposed
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildListSelectionArgs } from '../selection';
+import { platformConfigKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const platformConfigsQueryKey = platformConfigKeys.list;
+export function usePlatformConfigsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: platformConfigKeys.list(args),
+        queryFn: () => getClient().platformConfig.findMany(args).unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchPlatformConfigsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    return getClient().platformConfig.findMany(args).unwrap();
+}
+export async function prefetchPlatformConfigsQuery(queryClient, params) {
+    const args = buildListSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: platformConfigKeys.list(args),
+        queryFn: () => getClient().platformConfig.findMany(args).unwrap(),
+    });
+}

package/esm/config/hooks/query-keys.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Centralized query key factory
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+export declare const platformConfigDefinitionKeys: {
+    /** All platformConfigDefinition queries */ readonly all: readonly ["platformconfigdefinition"];
+    /** List query keys */ readonly lists: () => readonly ["platformconfigdefinition", "list"];
+    /** List query key with variables */ readonly list: (variables?: object) => readonly ["platformconfigdefinition", "list", object];
+    /** Detail query keys */ readonly details: () => readonly ["platformconfigdefinition", "detail"];
+    /** Detail query key for specific item */ readonly detail: (id: string | number) => readonly ["platformconfigdefinition", "detail", string | number];
+};
+export declare const platformConfigKeys: {
+    /** All platformConfig queries */ readonly all: readonly ["platformconfig"];
+    /** List query keys */ readonly lists: () => readonly ["platformconfig", "list"];
+    /** List query key with variables */ readonly list: (variables?: object) => readonly ["platformconfig", "list", object];
+    /** Detail query keys */ readonly details: () => readonly ["platformconfig", "detail"];
+    /** Detail query key for specific item */ readonly detail: (id: string | number) => readonly ["platformconfig", "detail", string | number];
+};
+/**
+
+// ============================================================================
+// Unified Query Key Store
+// ============================================================================
+
+ * Unified query key store
+ *
+ * Use this for type-safe query key access across your application.
+ *
+ * @example
+ * ```ts
+ * // Invalidate all user queries
+ * queryClient.invalidateQueries({ queryKey: queryKeys.user.all });
+ *
+ * // Invalidate user list queries
+ * queryClient.invalidateQueries({ queryKey: queryKeys.user.lists() });
+ *
+ * // Invalidate specific user
+ * queryClient.invalidateQueries({ queryKey: queryKeys.user.detail(userId) });
+ * ```
+ */
+export declare const queryKeys: {
+    readonly platformConfigDefinition: {
+        /** All platformConfigDefinition queries */ readonly all: readonly ["platformconfigdefinition"];
+        /** List query keys */ readonly lists: () => readonly ["platformconfigdefinition", "list"];
+        /** List query key with variables */ readonly list: (variables?: object) => readonly ["platformconfigdefinition", "list", object];
+        /** Detail query keys */ readonly details: () => readonly ["platformconfigdefinition", "detail"];
+        /** Detail query key for specific item */ readonly detail: (id: string | number) => readonly ["platformconfigdefinition", "detail", string | number];
+    };
+    readonly platformConfig: {
+        /** All platformConfig queries */ readonly all: readonly ["platformconfig"];
+        /** List query keys */ readonly lists: () => readonly ["platformconfig", "list"];
+        /** List query key with variables */ readonly list: (variables?: object) => readonly ["platformconfig", "list", object];
+        /** Detail query keys */ readonly details: () => readonly ["platformconfig", "detail"];
+        /** Detail query key for specific item */ readonly detail: (id: string | number) => readonly ["platformconfig", "detail", string | number];
+    };
+};
+/** Type representing all available query key scopes */
+export type QueryKeyScope = keyof typeof queryKeys;

package/esm/config/hooks/query-keys.js

@@ -0,0 +1,58 @@
+/**
+ * Centralized query key factory
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+// ============================================================================
+// This file provides a centralized, type-safe query key factory following
+// the lukemorales query-key-factory pattern for React Query.
+//
+// Benefits:
+// - Single source of truth for all query keys
+// - Type-safe key access with autocomplete
+// - Hierarchical invalidation (invalidate all 'user.*' queries)
+// - Scoped keys for parent-child relationships
+// ============================================================================
+// ============================================================================
+// Entity Query Keys
+// ============================================================================
+export const platformConfigDefinitionKeys = {
+    /** All platformConfigDefinition queries */ all: ['platformconfigdefinition'],
+    /** List query keys */ lists: () => [...platformConfigDefinitionKeys.all, 'list'],
+    /** List query key with variables */ list: (variables) => [...platformConfigDefinitionKeys.lists(), variables],
+    /** Detail query keys */ details: () => [...platformConfigDefinitionKeys.all, 'detail'],
+    /** Detail query key for specific item */ detail: (id) => [...platformConfigDefinitionKeys.details(), id],
+};
+export const platformConfigKeys = {
+    /** All platformConfig queries */ all: ['platformconfig'],
+    /** List query keys */ lists: () => [...platformConfigKeys.all, 'list'],
+    /** List query key with variables */ list: (variables) => [...platformConfigKeys.lists(), variables],
+    /** Detail query keys */ details: () => [...platformConfigKeys.all, 'detail'],
+    /** Detail query key for specific item */ detail: (id) => [...platformConfigKeys.details(), id],
+};
+/**
+
+// ============================================================================
+// Unified Query Key Store
+// ============================================================================
+
+ * Unified query key store
+ *
+ * Use this for type-safe query key access across your application.
+ *
+ * @example
+ * ```ts
+ * // Invalidate all user queries
+ * queryClient.invalidateQueries({ queryKey: queryKeys.user.all });
+ *
+ * // Invalidate user list queries
+ * queryClient.invalidateQueries({ queryKey: queryKeys.user.lists() });
+ *
+ * // Invalidate specific user
+ * queryClient.invalidateQueries({ queryKey: queryKeys.user.detail(userId) });
+ * ```
+ */
+export const queryKeys = {
+    platformConfigDefinition: platformConfigDefinitionKeys,
+    platformConfig: platformConfigKeys,
+};

package/esm/config/hooks/selection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Selection helpers for React Query hooks
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+export interface SelectionConfig<TFields> {
+    fields: TFields;
+}
+export interface ListSelectionConfig<TFields, TWhere, TOrderBy> extends SelectionConfig<TFields> {
+    where?: TWhere;
+    orderBy?: TOrderBy[];
+    first?: number;
+    last?: number;
+    after?: string;
+    before?: string;
+    offset?: number;
+}
+export declare function buildSelectionArgs<TFields>(selection: SelectionConfig<TFields>): {
+    select: TFields;
+};
+export declare function buildListSelectionArgs<TFields, TWhere, TOrderBy>(selection: ListSelectionConfig<TFields, TWhere, TOrderBy>): {
+    select: TFields;
+    where?: TWhere;
+    orderBy?: TOrderBy[];
+    first?: number;
+    last?: number;
+    after?: string;
+    before?: string;
+    offset?: number;
+};

package/esm/config/hooks/selection.js

@@ -0,0 +1,22 @@
+function ensureSelectionFields(selection) {
+    if (!selection || typeof selection !== 'object' || !('fields' in selection)) {
+        throw new Error('Invalid hook params: `selection.fields` is required. Example: { selection: { fields: { id: true } } }');
+    }
+}
+export function buildSelectionArgs(selection) {
+    ensureSelectionFields(selection);
+    return { select: selection.fields };
+}
+export function buildListSelectionArgs(selection) {
+    ensureSelectionFields(selection);
+    return {
+        select: selection.fields,
+        where: selection.where,
+        orderBy: selection.orderBy,
+        first: selection.first,
+        last: selection.last,
+        after: selection.after,
+        before: selection.before,
+        offset: selection.offset,
+    };
+}

package/esm/config/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * GraphQL SDK - auto-generated, do not edit
+ * @generated by @constructive-io/graphql-codegen
+ */
+export * from './types';
+export * from './hooks';
+export * from './orm';

package/esm/config/index.js

@@ -0,0 +1,7 @@
+/**
+ * GraphQL SDK - auto-generated, do not edit
+ * @generated by @constructive-io/graphql-codegen
+ */
+export * from './types';
+export * from './hooks';
+export * from './orm';

package/esm/config/orm/client.d.ts

@@ -0,0 +1,97 @@
+/**
+ * ORM Client - Runtime GraphQL executor
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io/graphql-query/runtime';
+import type { ConnectionState, ConnectionStateListener, RealtimeConfig, SubscriptionEvent, SubscriptionFieldMeta, Unsubscribe } from './realtime';
+export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
+export type { ConnectionState, ConnectionStateListener, RealtimeConfig, SubscribeOptions, SubscriptionEvent, SubscriptionFieldMeta, SubscriptionOperation, Unsubscribe, WsClient, } from './realtime';
+export { RealtimeManager } from './realtime';
+/**
+ * Default adapter that uses fetch for HTTP requests.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
+ */
+export declare class FetchAdapter implements GraphQLAdapter {
+    private endpoint;
+    private headers;
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
+    execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
+    setHeaders(headers: Record<string, string>): void;
+    getEndpoint(): string;
+}
+/**
+ * Configuration for creating an ORM client.
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
+ * or provide a custom adapter for alternative execution strategies.
+ */
+export interface OrmClientConfig {
+    /** GraphQL endpoint URL (required if adapter not provided) */
+    endpoint?: string;
+    /** Default headers for HTTP requests (only used with endpoint) */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
+    adapter?: GraphQLAdapter;
+    /**
+     * Optional realtime (WebSocket) configuration.
+     * When provided, enables subscription methods on models.
+     * The WebSocket connection is created lazily on first subscribe().
+     */
+    realtime?: RealtimeConfig;
+}
+/**
+ * Error thrown when GraphQL request fails
+ */
+export declare class GraphQLRequestError extends Error {
+    readonly errors: GraphQLError[];
+    readonly data: unknown;
+    constructor(errors: GraphQLError[], data?: unknown);
+}
+export declare class OrmClient {
+    private adapter;
+    private realtimeManager?;
+    constructor(config: OrmClientConfig);
+    execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
+    /**
+     * Subscribe to a GraphQL subscription operation.
+     * Used by generated model subscribe() methods.
+     * @throws Error if realtime is not configured
+     */
+    subscribe<T>(meta: SubscriptionFieldMeta, document: string, variables: Record<string, unknown>, options: {
+        onEvent: (event: SubscriptionEvent<T>) => void;
+        onError?: (error: Error) => void;
+        onComplete?: () => void;
+    }): Unsubscribe;
+    /**
+     * Set headers for requests.
+     * Only works if the adapter supports headers.
+     */
+    setHeaders(headers: Record<string, string>): void;
+    /**
+     * Get the endpoint URL.
+     * Returns empty string if the adapter doesn't have an endpoint.
+     */
+    getEndpoint(): string;
+    /** Get current WebSocket connection state */
+    getConnectionState(): ConnectionState;
+    /** Register a listener for WebSocket connection state changes */
+    onConnectionStateChange(listener: ConnectionStateListener): Unsubscribe;
+    /** Number of active subscriptions */
+    getActiveSubscriptionCount(): number;
+    /** Whether realtime is configured */
+    get isRealtimeEnabled(): boolean;
+    /** Dispose the realtime manager (close WebSocket) */
+    dispose(): void;
+}