@constructive-io/react 0.18.6 → 0.18.8

package/objects/orm/client.d.ts

@@ -4,7 +4,10 @@
  * 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.
  *
@@ -41,6 +44,12 @@ export interface OrmClientConfig {
     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
@@ -52,8 +61,19 @@ export declare class GraphQLRequestError extends Error {
 }
 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.
@@ -64,4 +84,14 @@ export declare class OrmClient {
      * 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;
 }

package/objects/orm/client.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrmClient = exports.GraphQLRequestError = exports.FetchAdapter = void 0;
+exports.OrmClient = exports.GraphQLRequestError = exports.FetchAdapter = exports.RealtimeManager = void 0;
 const runtime_1 = require("@constructive-io/graphql-query/runtime");
+const realtime_1 = require("./realtime");
+var realtime_2 = require("./realtime");
+Object.defineProperty(exports, "RealtimeManager", { enumerable: true, get: function () { return realtime_2.RealtimeManager; } });
 /**
  * Default adapter that uses fetch for HTTP requests.
  *
@@ -78,6 +81,7 @@ class GraphQLRequestError extends Error {
 exports.GraphQLRequestError = GraphQLRequestError;
 class OrmClient {
     adapter;
+    realtimeManager;
     constructor(config) {
         if (config.adapter) {
             this.adapter = config.adapter;
@@ -88,10 +92,24 @@ class OrmClient {
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');
         }
+        if (config.realtime) {
+            this.realtimeManager = new realtime_1.RealtimeManager(config.realtime);
+        }
     }
     async execute(document, variables) {
         return this.adapter.execute(document, variables);
     }
+    /**
+     * Subscribe to a GraphQL subscription operation.
+     * Used by generated model subscribe() methods.
+     * @throws Error if realtime is not configured
+     */
+    subscribe(meta, document, variables, options) {
+        if (!this.realtimeManager) {
+            throw new Error('Realtime not configured. Pass a `realtime` option to createClient() to enable subscriptions.');
+        }
+        return this.realtimeManager.subscribe(meta, document, variables, options);
+    }
     /**
      * Set headers for requests.
      * Only works if the adapter supports headers.
@@ -108,5 +126,27 @@ class OrmClient {
     getEndpoint() {
         return this.adapter.getEndpoint?.() ?? '';
     }
+    /** Get current WebSocket connection state */
+    getConnectionState() {
+        return this.realtimeManager?.getConnectionState() ?? 'disconnected';
+    }
+    /** Register a listener for WebSocket connection state changes */
+    onConnectionStateChange(listener) {
+        if (!this.realtimeManager)
+            return () => { };
+        return this.realtimeManager.onConnectionStateChange(listener);
+    }
+    /** Number of active subscriptions */
+    getActiveSubscriptionCount() {
+        return this.realtimeManager?.getActiveSubscriptionCount() ?? 0;
+    }
+    /** Whether realtime is configured */
+    get isRealtimeEnabled() {
+        return this.realtimeManager !== undefined;
+    }
+    /** Dispose the realtime manager (close WebSocket) */
+    dispose() {
+        this.realtimeManager?.dispose();
+    }
 }
 exports.OrmClient = OrmClient;

package/objects/orm/realtime.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Realtime Manager - WebSocket subscription support
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+interface WsGraphQLError {
+    readonly message: string;
+    readonly [key: string]: unknown;
+}
+interface WsExecutionResult<TData = Record<string, unknown>> {
+    data?: TData | null;
+    errors?: readonly WsGraphQLError[];
+    extensions?: Record<string, unknown>;
+}
+interface WsSink<T> {
+    next(value: T): void;
+    error(error: unknown): void;
+    complete(): void;
+}
+/**
+ * Minimal interface matching the graphql-ws Client.
+ * Consumers pass a concrete instance via RealtimeConfig.client.
+ */
+export interface WsClient {
+    subscribe<TData = Record<string, unknown>>(payload: {
+        query: string;
+        variables?: Record<string, unknown>;
+    }, sink: WsSink<WsExecutionResult<TData>>): () => void;
+    dispose(): void;
+}
+/** The DML operation that triggered the subscription event */
+export type SubscriptionOperation = 'INSERT' | 'UPDATE' | 'DELETE';
+/** Connection state of the WebSocket */
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/** Listener for connection state changes */
+export type ConnectionStateListener = (state: ConnectionState) => void;
+/** Function returned by subscribe() to cancel the subscription */
+export type Unsubscribe = () => void;
+/**
+ * A realtime subscription event delivered to the client.
+ *
+ * @typeParam T - The row type of the subscribed table
+ */
+export interface SubscriptionEvent<T> {
+    /** The DML operation that triggered this event */
+    operation: SubscriptionOperation;
+    /** The current row data (null for DELETE if row is no longer visible) */
+    data: T | null;
+    /** Previous field values (populated on UPDATE when available) */
+    previousValues?: Partial<T>;
+    /** Server-side timestamp of when the change occurred */
+    timestamp: string;
+}
+/**
+ * Options for creating a subscription.
+ *
+ * @typeParam T - The row type of the subscribed table
+ * @typeParam TFilter - The filter type for the table
+ */
+export interface SubscribeOptions<T, TFilter = Record<string, unknown>> {
+    /** Server-side filter to limit which events are delivered */
+    filter?: TFilter;
+    /** Called when a subscription event is received */
+    onEvent: (event: SubscriptionEvent<T>) => void;
+    /** Called when the subscription encounters an error */
+    onError?: (error: Error) => void;
+    /** Called when the subscription completes (server-initiated close) */
+    onComplete?: () => void;
+}
+/**
+ * Metadata about a subscription field, used internally to map
+ * table names to GraphQL subscription field names and types.
+ */
+export interface SubscriptionFieldMeta {
+    /** The GraphQL subscription field name (e.g., 'onContactChanged') */
+    fieldName: string;
+    /** The table name in the source schema (e.g., 'contact') */
+    tableName: string;
+    /** The data field name inside the subscription payload (e.g., 'contact') */
+    dataFieldName: string;
+}
+/**
+ * Configuration for the realtime (WebSocket) connection.
+ * Pass this as the `realtime` option in OrmClientConfig.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from 'graphql-ws';
+ *
+ * const client = createOrmClient({
+ *   endpoint: 'https://api.example.com/graphql',
+ *   realtime: {
+ *     client: createClient({ url: 'wss://api.example.com/graphql' }),
+ *   },
+ * });
+ * ```
+ */
+export interface RealtimeConfig {
+    /**
+     * A graphql-ws Client instance (or any object satisfying WsClient).
+     * The consumer creates this themselves, giving full control over
+     * connection options, auth, and transport.
+     *
+     * @example
+     * ```ts
+     * import { createClient } from 'graphql-ws';
+     * const wsClient = createClient({ url: 'wss://...' });
+     * ```
+     */
+    client: WsClient;
+}
+/**
+ * Manages a graphql-ws WebSocket client and multiplexes
+ * subscriptions over it. Created by OrmClient when `realtime`
+ * config is provided.
+ */
+export declare class RealtimeManager {
+    private wsClient;
+    private connectionState;
+    private stateListeners;
+    private activeSubscriptions;
+    constructor(config: RealtimeConfig);
+    /**
+     * Subscribe to a GraphQL subscription operation.
+     * Models call this with typed metadata and documents.
+     */
+    subscribe<T>(meta: SubscriptionFieldMeta, document: string, variables: Record<string, unknown>, options: {
+        onEvent: (event: SubscriptionEvent<T>) => void;
+        onError?: (error: Error) => void;
+        onComplete?: () => void;
+    }): Unsubscribe;
+    /** Register a listener for connection state changes */
+    onConnectionStateChange(listener: ConnectionStateListener): Unsubscribe;
+    /** Get current connection state */
+    getConnectionState(): ConnectionState;
+    /** Number of active subscriptions */
+    getActiveSubscriptionCount(): number;
+    /** Dispose the manager and close the WebSocket connection */
+    dispose(): void;
+    private setConnectionState;
+}
+export {};

package/objects/orm/realtime.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Realtime Manager - WebSocket subscription support
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+// Minimal type shims so this module compiles without graphql-ws
+// installed.  Consumers supply a WsClient via RealtimeConfig;
+// the SDK itself never imports or requires graphql-ws.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeManager = void 0;
+// ============================================================================
+// RealtimeManager
+// ============================================================================
+/**
+ * Manages a graphql-ws WebSocket client and multiplexes
+ * subscriptions over it. Created by OrmClient when `realtime`
+ * config is provided.
+ */
+class RealtimeManager {
+    wsClient;
+    connectionState = 'disconnected';
+    stateListeners = new Set();
+    activeSubscriptions = 0;
+    constructor(config) {
+        this.wsClient = config.client;
+    }
+    /**
+     * Subscribe to a GraphQL subscription operation.
+     * Models call this with typed metadata and documents.
+     */
+    subscribe(meta, document, variables, options) {
+        this.activeSubscriptions++;
+        let disposed = false;
+        const cleanup = this.wsClient.subscribe({ query: document, variables }, {
+            next: (result) => {
+                if (disposed)
+                    return;
+                if (result.errors) {
+                    options.onError?.(new Error(result.errors.map((e) => e.message).join('; ')));
+                    return;
+                }
+                const payload = result.data?.[meta.fieldName];
+                if (!payload)
+                    return;
+                const event = {
+                    operation: payload.event ?? 'UPDATE',
+                    data: payload[meta.dataFieldName] ?? null,
+                    previousValues: payload.previousValues,
+                    timestamp: payload.timestamp ?? new Date().toISOString(),
+                };
+                options.onEvent(event);
+            },
+            error: (err) => {
+                if (disposed)
+                    return;
+                options.onError?.(err instanceof Error ? err : new Error(String(err)));
+            },
+            complete: () => {
+                if (disposed)
+                    return;
+                options.onComplete?.();
+            },
+        });
+        return () => {
+            if (disposed)
+                return;
+            disposed = true;
+            this.activeSubscriptions--;
+            cleanup();
+        };
+    }
+    /** Register a listener for connection state changes */
+    onConnectionStateChange(listener) {
+        this.stateListeners.add(listener);
+        return () => {
+            this.stateListeners.delete(listener);
+        };
+    }
+    /** Get current connection state */
+    getConnectionState() {
+        return this.connectionState;
+    }
+    /** Number of active subscriptions */
+    getActiveSubscriptionCount() {
+        return this.activeSubscriptions;
+    }
+    /** Dispose the manager and close the WebSocket connection */
+    dispose() {
+        this.wsClient.dispose();
+        this.stateListeners.clear();
+        this.activeSubscriptions = 0;
+        this.setConnectionState('disconnected');
+    }
+    setConnectionState(state) {
+        if (this.connectionState === state)
+            return;
+        this.connectionState = state;
+        for (const listener of this.stateListeners) {
+            listener(state);
+        }
+    }
+}
+exports.RealtimeManager = RealtimeManager;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/react",
-  "version": "0.18.6",
+  "version": "0.18.8",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive React - Auto-generated React Query hooks and ORM client",
   "main": "index.js",
@@ -52,7 +52,7 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@constructive-io/graphql-codegen": "^4.39.0",
+    "@constructive-io/graphql-codegen": "^4.39.1",
     "@types/node": "^22.19.11",
     "@types/react": "^19.2.14",
     "makage": "^0.3.0",
@@ -60,5 +60,5 @@
     "tsx": "^4.19.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "90016935b53d6fb84e0b83879377f0c2eb9abce6"
+  "gitHead": "4a575e3e29827e96979cb6aac2c88eb7a07f7fd0"
 }

package/public/hooks/mutation-keys.d.ts

@@ -918,7 +918,8 @@ export declare const customMutationKeys: {
     /** Mutation key for provisionSpatialRelation */ readonly provisionSpatialRelation: (identifier?: string) => readonly ["mutation", "provisionSpatialRelation", string] | readonly ["mutation", "provisionSpatialRelation"];
     /** Mutation key for bootstrapUser */ readonly bootstrapUser: (identifier?: string) => readonly ["mutation", "bootstrapUser", string] | readonly ["mutation", "bootstrapUser"];
     /** Mutation key for setFieldOrder */ readonly setFieldOrder: (identifier?: string) => readonly ["mutation", "setFieldOrder", string] | readonly ["mutation", "setFieldOrder"];
-    /** Mutation key for appendSmartTags */ readonly appendSmartTags: (identifier?: string) => readonly ["mutation", "appendSmartTags", string] | readonly ["mutation", "appendSmartTags"];
+    /** Mutation key for appendFieldSmartTags */ readonly appendFieldSmartTags: (identifier?: string) => readonly ["mutation", "appendFieldSmartTags", string] | readonly ["mutation", "appendFieldSmartTags"];
+    /** Mutation key for appendTableSmartTags */ readonly appendTableSmartTags: (identifier?: string) => readonly ["mutation", "appendTableSmartTags", string] | readonly ["mutation", "appendTableSmartTags"];
     /** Mutation key for provisionUniqueConstraint */ readonly provisionUniqueConstraint: (identifier?: string) => readonly ["mutation", "provisionUniqueConstraint", string] | readonly ["mutation", "provisionUniqueConstraint"];
     /** Mutation key for provisionFullTextSearch */ readonly provisionFullTextSearch: (identifier?: string) => readonly ["mutation", "provisionFullTextSearch", string] | readonly ["mutation", "provisionFullTextSearch"];
     /** Mutation key for provisionIndex */ readonly provisionIndex: (identifier?: string) => readonly ["mutation", "provisionIndex", string] | readonly ["mutation", "provisionIndex"];
@@ -1880,7 +1881,8 @@ export declare const mutationKeys: {
         /** Mutation key for provisionSpatialRelation */ readonly provisionSpatialRelation: (identifier?: string) => readonly ["mutation", "provisionSpatialRelation", string] | readonly ["mutation", "provisionSpatialRelation"];
         /** Mutation key for bootstrapUser */ readonly bootstrapUser: (identifier?: string) => readonly ["mutation", "bootstrapUser", string] | readonly ["mutation", "bootstrapUser"];
         /** Mutation key for setFieldOrder */ readonly setFieldOrder: (identifier?: string) => readonly ["mutation", "setFieldOrder", string] | readonly ["mutation", "setFieldOrder"];
-        /** Mutation key for appendSmartTags */ readonly appendSmartTags: (identifier?: string) => readonly ["mutation", "appendSmartTags", string] | readonly ["mutation", "appendSmartTags"];
+        /** Mutation key for appendFieldSmartTags */ readonly appendFieldSmartTags: (identifier?: string) => readonly ["mutation", "appendFieldSmartTags", string] | readonly ["mutation", "appendFieldSmartTags"];
+        /** Mutation key for appendTableSmartTags */ readonly appendTableSmartTags: (identifier?: string) => readonly ["mutation", "appendTableSmartTags", string] | readonly ["mutation", "appendTableSmartTags"];
         /** Mutation key for provisionUniqueConstraint */ readonly provisionUniqueConstraint: (identifier?: string) => readonly ["mutation", "provisionUniqueConstraint", string] | readonly ["mutation", "provisionUniqueConstraint"];
         /** Mutation key for provisionFullTextSearch */ readonly provisionFullTextSearch: (identifier?: string) => readonly ["mutation", "provisionFullTextSearch", string] | readonly ["mutation", "provisionFullTextSearch"];
         /** Mutation key for provisionIndex */ readonly provisionIndex: (identifier?: string) => readonly ["mutation", "provisionIndex", string] | readonly ["mutation", "provisionIndex"];

package/public/hooks/mutation-keys.js

@@ -1029,9 +1029,12 @@ exports.customMutationKeys = {
     /** Mutation key for setFieldOrder */ setFieldOrder: (identifier) => identifier
         ? ['mutation', 'setFieldOrder', identifier]
         : ['mutation', 'setFieldOrder'],
-    /** Mutation key for appendSmartTags */ appendSmartTags: (identifier) => identifier
-        ? ['mutation', 'appendSmartTags', identifier]
-        : ['mutation', 'appendSmartTags'],
+    /** Mutation key for appendFieldSmartTags */ appendFieldSmartTags: (identifier) => identifier
+        ? ['mutation', 'appendFieldSmartTags', identifier]
+        : ['mutation', 'appendFieldSmartTags'],
+    /** Mutation key for appendTableSmartTags */ appendTableSmartTags: (identifier) => identifier
+        ? ['mutation', 'appendTableSmartTags', identifier]
+        : ['mutation', 'appendTableSmartTags'],
     /** Mutation key for provisionUniqueConstraint */ provisionUniqueConstraint: (identifier) => identifier
         ? ['mutation', 'provisionUniqueConstraint', identifier]
         : ['mutation', 'provisionUniqueConstraint'],

package/public/hooks/mutations/index.d.ts

@@ -453,7 +453,8 @@ export * from './useCopyTemplateToBlueprintMutation';
 export * from './useProvisionSpatialRelationMutation';
 export * from './useBootstrapUserMutation';
 export * from './useSetFieldOrderMutation';
-export * from './useAppendSmartTagsMutation';
+export * from './useAppendFieldSmartTagsMutation';
+export * from './useAppendTableSmartTagsMutation';
 export * from './useProvisionUniqueConstraintMutation';
 export * from './useProvisionFullTextSearchMutation';
 export * from './useProvisionIndexMutation';

package/public/hooks/mutations/index.js

@@ -469,7 +469,8 @@ __exportStar(require("./useCopyTemplateToBlueprintMutation"), exports);
 __exportStar(require("./useProvisionSpatialRelationMutation"), exports);
 __exportStar(require("./useBootstrapUserMutation"), exports);
 __exportStar(require("./useSetFieldOrderMutation"), exports);
-__exportStar(require("./useAppendSmartTagsMutation"), exports);
+__exportStar(require("./useAppendFieldSmartTagsMutation"), exports);
+__exportStar(require("./useAppendTableSmartTagsMutation"), exports);
 __exportStar(require("./useProvisionUniqueConstraintMutation"), exports);
 __exportStar(require("./useProvisionFullTextSearchMutation"), exports);
 __exportStar(require("./useProvisionIndexMutation"), exports);

package/public/hooks/mutations/useAppendFieldSmartTagsMutation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Custom mutation hook for appendFieldSmartTags
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import type { AppendFieldSmartTagsVariables } from '../../orm/mutation';
+import type { AppendFieldSmartTagsPayloadSelect, AppendFieldSmartTagsPayload } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { AppendFieldSmartTagsVariables } from '../../orm/mutation';
+export type { AppendFieldSmartTagsPayloadSelect } from '../../orm/input-types';
+export declare function useAppendFieldSmartTagsMutation<S extends AppendFieldSmartTagsPayloadSelect>(params: {
+    selection: {
+        fields: S & AppendFieldSmartTagsPayloadSelect;
+    } & HookStrictSelect<NoInfer<S>, AppendFieldSmartTagsPayloadSelect>;
+} & Omit<UseMutationOptions<{
+    appendFieldSmartTags: InferSelectResult<AppendFieldSmartTagsPayload, S> | null;
+}, Error, AppendFieldSmartTagsVariables>, 'mutationFn'>): UseMutationResult<{
+    appendFieldSmartTags: InferSelectResult<AppendFieldSmartTagsPayload, S> | null;
+}, Error, AppendFieldSmartTagsVariables>;

package/public/hooks/mutations/{useAppendSmartTagsMutation.js → useAppendFieldSmartTagsMutation.js}

@@ -1,23 +1,23 @@
 "use strict";
 /**
- * Custom mutation hook for appendSmartTags
+ * Custom mutation hook for appendFieldSmartTags
  * @generated by @constructive-io/graphql-codegen
  * DO NOT EDIT - changes will be overwritten
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useAppendSmartTagsMutation = useAppendSmartTagsMutation;
+exports.useAppendFieldSmartTagsMutation = useAppendFieldSmartTagsMutation;
 const react_query_1 = require("@tanstack/react-query");
 const client_1 = require("../client");
 const selection_1 = require("../selection");
 const mutation_keys_1 = require("../mutation-keys");
-function useAppendSmartTagsMutation(params) {
+function useAppendFieldSmartTagsMutation(params) {
     const args = (0, selection_1.buildSelectionArgs)(params.selection);
     const { selection: _selection, ...mutationOptions } = params ?? {};
     void _selection;
     return (0, react_query_1.useMutation)({
-        mutationKey: mutation_keys_1.customMutationKeys.appendSmartTags(),
+        mutationKey: mutation_keys_1.customMutationKeys.appendFieldSmartTags(),
         mutationFn: (variables) => (0, client_1.getClient)()
-            .mutation.appendSmartTags(variables, {
+            .mutation.appendFieldSmartTags(variables, {
             select: args.select,
         })
             .unwrap(),

package/public/hooks/mutations/useAppendTableSmartTagsMutation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Custom mutation hook for appendTableSmartTags
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import type { AppendTableSmartTagsVariables } from '../../orm/mutation';
+import type { AppendTableSmartTagsPayloadSelect, AppendTableSmartTagsPayload } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { AppendTableSmartTagsVariables } from '../../orm/mutation';
+export type { AppendTableSmartTagsPayloadSelect } from '../../orm/input-types';
+export declare function useAppendTableSmartTagsMutation<S extends AppendTableSmartTagsPayloadSelect>(params: {
+    selection: {
+        fields: S & AppendTableSmartTagsPayloadSelect;
+    } & HookStrictSelect<NoInfer<S>, AppendTableSmartTagsPayloadSelect>;
+} & Omit<UseMutationOptions<{
+    appendTableSmartTags: InferSelectResult<AppendTableSmartTagsPayload, S> | null;
+}, Error, AppendTableSmartTagsVariables>, 'mutationFn'>): UseMutationResult<{
+    appendTableSmartTags: InferSelectResult<AppendTableSmartTagsPayload, S> | null;
+}, Error, AppendTableSmartTagsVariables>;

package/public/hooks/mutations/useAppendTableSmartTagsMutation.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Custom mutation hook for appendTableSmartTags
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAppendTableSmartTagsMutation = useAppendTableSmartTagsMutation;
+const react_query_1 = require("@tanstack/react-query");
+const client_1 = require("../client");
+const selection_1 = require("../selection");
+const mutation_keys_1 = require("../mutation-keys");
+function useAppendTableSmartTagsMutation(params) {
+    const args = (0, selection_1.buildSelectionArgs)(params.selection);
+    const { selection: _selection, ...mutationOptions } = params ?? {};
+    void _selection;
+    return (0, react_query_1.useMutation)({
+        mutationKey: mutation_keys_1.customMutationKeys.appendTableSmartTags(),
+        mutationFn: (variables) => (0, client_1.getClient)()
+            .mutation.appendTableSmartTags(variables, {
+            select: args.select,
+        })
+            .unwrap(),
+        ...mutationOptions,
+    });
+}

package/public/orm/client.d.ts

@@ -4,7 +4,10 @@
  * 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.
  *
@@ -41,6 +44,12 @@ export interface OrmClientConfig {
     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
@@ -52,8 +61,19 @@ export declare class GraphQLRequestError extends Error {
 }
 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.
@@ -64,4 +84,14 @@ export declare class OrmClient {
      * 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;
 }