@constructive-io/graphql-codegen 4.38.2 → 4.39.0

package/core/codegen/templates/orm-client.ts

@@ -15,12 +15,35 @@ import type {
 } from '@constructive-io/graphql-query/runtime';
 import { createFetch } from '@constructive-io/graphql-query/runtime';
 
+import type {
+  ConnectionState,
+  ConnectionStateListener,
+  RealtimeConfig,
+  SubscribeOptions,
+  SubscriptionEvent,
+  SubscriptionFieldMeta,
+  Unsubscribe,
+} from './realtime';
+import { RealtimeManager } from './realtime';
+
 export type {
   GraphQLAdapter,
   GraphQLError,
   QueryResult,
 } from '@constructive-io/graphql-query/runtime';
 
+export type {
+  ConnectionState,
+  ConnectionStateListener,
+  RealtimeConfig,
+  SubscribeOptions,
+  SubscriptionEvent,
+  SubscriptionFieldMeta,
+  SubscriptionOperation,
+  Unsubscribe,
+} from './realtime';
+export { RealtimeManager } from './realtime';
+
 /**
  * Default adapter that uses fetch for HTTP requests.
  *
@@ -117,6 +140,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;
 }
 
 /**
@@ -135,6 +164,7 @@ export class GraphQLRequestError extends Error {
 
 export class OrmClient {
   private adapter: GraphQLAdapter;
+  private realtimeManager?: RealtimeManager;
 
   constructor(config: OrmClientConfig) {
     if (config.adapter) {
@@ -150,6 +180,10 @@ export class OrmClient {
         'OrmClientConfig requires either an endpoint or a custom adapter',
       );
     }
+
+    if (config.realtime) {
+      this.realtimeManager = new RealtimeManager(config.realtime);
+    }
   }
 
   async execute<T>(
@@ -159,6 +193,34 @@ export class OrmClient {
     return this.adapter.execute<T>(document, variables);
   }
 
+  /**
+   * 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 {
+    if (!this.realtimeManager) {
+      throw new Error(
+        'Realtime not configured. Pass a `realtime` option to createClient() to enable subscriptions.',
+      );
+    }
+    return this.realtimeManager.subscribe<T>(
+      meta,
+      document,
+      variables,
+      options,
+    );
+  }
+
   /**
    * Set headers for requests.
    * Only works if the adapter supports headers.
@@ -176,4 +238,32 @@ export class OrmClient {
   getEndpoint(): string {
     return this.adapter.getEndpoint?.() ?? '';
   }
+
+  /** Get current WebSocket connection state */
+  getConnectionState(): ConnectionState {
+    return this.realtimeManager?.getConnectionState() ?? 'disconnected';
+  }
+
+  /** Register a listener for WebSocket connection state changes */
+  onConnectionStateChange(
+    listener: ConnectionStateListener,
+  ): Unsubscribe {
+    if (!this.realtimeManager) return () => {};
+    return this.realtimeManager.onConnectionStateChange(listener);
+  }
+
+  /** Number of active subscriptions */
+  getActiveSubscriptionCount(): number {
+    return this.realtimeManager?.getActiveSubscriptionCount() ?? 0;
+  }
+
+  /** Whether realtime is configured */
+  get isRealtimeEnabled(): boolean {
+    return this.realtimeManager !== undefined;
+  }
+
+  /** Dispose the realtime manager (close WebSocket) */
+  dispose(): void {
+    this.realtimeManager?.dispose();
+  }
 }

package/core/codegen/templates/orm-realtime.ts

@@ -0,0 +1,295 @@
+/**
+ * ORM Realtime - WebSocket subscription manager
+ *
+ * This is the RUNTIME code that gets copied to generated output.
+ * Provides the WebSocket connection manager and subscription types
+ * for realtime subscriptions integrated into the ORM client.
+ *
+ * NOTE: This file is read at codegen time and written to output.
+ * Any changes here will affect all generated ORM clients.
+ */
+
+// graphql-ws is loaded lazily so that importing this module does not
+// throw when the package is absent (e.g. CLI-only consumers).
+type WsClient = import('graphql-ws').Client;
+
+// ============================================================================
+// Types
+// ============================================================================
+
+/** 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.
+ */
+export interface RealtimeConfig {
+  /** WebSocket endpoint URL (e.g., 'wss://api.example.com/graphql') */
+  url: string;
+  /**
+   * Returns the current auth token. Called on connection init and
+   * on reconnection so the client always sends a fresh token.
+   */
+  getToken?: () => string | Promise<string>;
+  /**
+   * Additional connection parameters sent during WebSocket handshake.
+   * Merged with the authorization header from getToken().
+   */
+  connectionParams?: Record<string, unknown>;
+  /**
+   * Whether to connect lazily (on first subscribe) or eagerly.
+   * @default true
+   */
+  lazy?: boolean;
+  /**
+   * Maximum number of reconnection attempts before giving up.
+   * @default 5
+   */
+  retryAttempts?: number;
+  /**
+   * Delay between reconnection attempts in milliseconds,
+   * or a function for custom backoff.
+   * @default 1000
+   */
+  retryWait?: number | ((retryCount: number) => number | Promise<number>);
+  /** Called when the WebSocket connection is established */
+  onConnected?: () => void;
+  /** Called when the WebSocket connection is closed */
+  onDisconnected?: (reason?: unknown) => void;
+}
+
+// ============================================================================
+// RealtimeManager
+// ============================================================================
+
+/**
+ * Manages a single graphql-ws WebSocket connection and multiplexes
+ * subscriptions over it. Created lazily by OrmClient when `realtime`
+ * config is provided.
+ */
+export class RealtimeManager {
+  private wsClient: WsClient;
+  private connectionState: ConnectionState = 'disconnected';
+  private stateListeners: Set<ConnectionStateListener> = new Set();
+  private activeSubscriptions = 0;
+
+  constructor(config: RealtimeConfig) {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const { createClient: createWsClient } = require('graphql-ws') as typeof import('graphql-ws');
+
+    const retryWait = async (retryCount: number): Promise<void> => {
+      if (typeof config.retryWait === 'function') {
+        const result = config.retryWait(retryCount);
+        const ms = typeof result === 'number' ? result : await result;
+        await new Promise<void>((resolve) => setTimeout(resolve, ms));
+      } else {
+        const base =
+          typeof config.retryWait === 'number' ? config.retryWait : 1000;
+        await new Promise<void>((resolve) =>
+          setTimeout(resolve, base * Math.pow(2, retryCount)),
+        );
+      }
+    };
+
+    this.wsClient = createWsClient({
+      url: config.url,
+      lazy: config.lazy ?? true,
+      retryAttempts: config.retryAttempts ?? 5,
+      retryWait,
+      connectionParams: async () => {
+        const params: Record<string, unknown> = {
+          ...config.connectionParams,
+        };
+        if (config.getToken) {
+          const token = await config.getToken();
+          params['authorization'] = `Bearer ${token}`;
+        }
+        return params;
+      },
+      on: {
+        connecting: () => {
+          const newState =
+            this.connectionState === 'disconnected'
+              ? 'connecting'
+              : 'reconnecting';
+          this.setConnectionState(newState);
+        },
+        connected: () => {
+          this.setConnectionState('connected');
+          config.onConnected?.();
+        },
+        closed: (event) => {
+          this.setConnectionState('disconnected');
+          config.onDisconnected?.(event);
+        },
+      },
+    });
+  }
+
+  /**
+   * 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 {
+    this.activeSubscriptions++;
+    let disposed = false;
+
+    const cleanup = this.wsClient.subscribe<Record<string, unknown>>(
+      { 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] as
+            | { event?: string; [key: string]: unknown }
+            | undefined;
+
+          if (!payload) return;
+
+          const event: SubscriptionEvent<T> = {
+            operation:
+              (payload.event as SubscriptionOperation) ?? 'UPDATE',
+            data: (payload[meta.dataFieldName] as T) ?? null,
+            previousValues: payload.previousValues as
+              | Partial<T>
+              | undefined,
+            timestamp:
+              (payload.timestamp as string) ?? 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: ConnectionStateListener): Unsubscribe {
+    this.stateListeners.add(listener);
+    return () => {
+      this.stateListeners.delete(listener);
+    };
+  }
+
+  /** Get current connection state */
+  getConnectionState(): ConnectionState {
+    return this.connectionState;
+  }
+
+  /** Number of active subscriptions */
+  getActiveSubscriptionCount(): number {
+    return this.activeSubscriptions;
+  }
+
+  /** Dispose the manager and close the WebSocket connection */
+  dispose(): void {
+    this.wsClient.dispose();
+    this.stateListeners.clear();
+    this.activeSubscriptions = 0;
+    this.setConnectionState('disconnected');
+  }
+
+  private setConnectionState(state: ConnectionState): void {
+    if (this.connectionState === state) return;
+    this.connectionState = state;
+    for (const listener of this.stateListeners) {
+      listener(state);
+    }
+  }
+}

package/core/codegen/utils.d.ts

@@ -65,6 +65,21 @@ export declare function getUpdateMutationFileName(table: Table): string;
  * Generate file name for delete mutation hook
  */
 export declare function getDeleteMutationFileName(table: Table): string;
+/**
+ * Generate hook function name for subscription
+ * e.g., "useContactSubscription"
+ */
+export declare function getSubscriptionHookName(table: Table): string;
+/**
+ * Generate file name for subscription hook
+ * e.g., "useContactSubscription.ts"
+ */
+export declare function getSubscriptionFileName(table: Table): string;
+/**
+ * Generate the GraphQL subscription field name
+ * e.g., "onContactChanged"
+ */
+export declare function getSubscriptionFieldName(table: Table): string;
 /**
  * Get the GraphQL query name for fetching all rows
  * Uses inflection from introspection, falls back to convention

package/core/codegen/utils.js

@@ -12,6 +12,9 @@ exports.getSingleQueryFileName = getSingleQueryFileName;
 exports.getCreateMutationFileName = getCreateMutationFileName;
 exports.getUpdateMutationFileName = getUpdateMutationFileName;
 exports.getDeleteMutationFileName = getDeleteMutationFileName;
+exports.getSubscriptionHookName = getSubscriptionHookName;
+exports.getSubscriptionFileName = getSubscriptionFileName;
+exports.getSubscriptionFieldName = getSubscriptionFieldName;
 exports.getAllRowsQueryName = getAllRowsQueryName;
 exports.getSingleRowQueryName = getSingleRowQueryName;
 exports.getCreateMutationName = getCreateMutationName;
@@ -138,6 +141,29 @@ function getUpdateMutationFileName(table) {
 function getDeleteMutationFileName(table) {
     return `${getDeleteMutationHookName(table)}.ts`;
 }
+/**
+ * Generate hook function name for subscription
+ * e.g., "useContactSubscription"
+ */
+function getSubscriptionHookName(table) {
+    const { singularName } = getTableNames(table);
+    return `use${(0, inflekt_1.ucFirst)(singularName)}Subscription`;
+}
+/**
+ * Generate file name for subscription hook
+ * e.g., "useContactSubscription.ts"
+ */
+function getSubscriptionFileName(table) {
+    return `${getSubscriptionHookName(table)}.ts`;
+}
+/**
+ * Generate the GraphQL subscription field name
+ * e.g., "onContactChanged"
+ */
+function getSubscriptionFieldName(table) {
+    const { singularName } = getTableNames(table);
+    return `on${(0, inflekt_1.ucFirst)(singularName)}Changed`;
+}
 // ============================================================================
 // GraphQL operation names
 // ============================================================================

package/esm/core/codegen/barrel.d.ts

@@ -15,6 +15,8 @@ export declare function generateMutationsBarrel(tables: Table[]): string;
  */
 export interface MainBarrelOptions {
     hasMutations?: boolean;
+    /** Whether subscriptions/ directory was generated */
+    hasSubscriptions?: boolean;
     /** Whether query-keys.ts was generated */
     hasQueryKeys?: boolean;
     /** Whether mutation-keys.ts was generated */
@@ -44,6 +46,10 @@ export declare function generateRootBarrel(options?: RootBarrelOptions): string;
  *   export * as public_ from './public';
  */
 export declare function generateMultiTargetBarrel(targetNames: string[]): string;
+/**
+ * Generate the subscriptions/index.ts barrel file
+ */
+export declare function generateSubscriptionsBarrel(tables: Table[]): string;
 /**
  * Generate queries barrel including custom query operations
  */

package/esm/core/codegen/barrel.js

@@ -6,7 +6,7 @@
 import * as t from '@babel/types';
 import { addJSDocComment, generateCode } from './babel-ast';
 import { getOperationHookName } from './type-resolver';
-import { getCreateMutationHookName, getDeleteMutationHookName, getListQueryHookName, getSingleQueryHookName, getUpdateMutationHookName, hasValidPrimaryKey, } from './utils';
+import { getCreateMutationHookName, getDeleteMutationHookName, getListQueryHookName, getSingleQueryHookName, getSubscriptionHookName, getUpdateMutationHookName, hasValidPrimaryKey, } from './utils';
 /**
  * Helper to create export * from './module' statement
  */
@@ -69,7 +69,7 @@ export function generateMutationsBarrel(tables) {
 }
 export function generateMainBarrel(tables, options = {}) {
     const opts = options;
-    const { hasMutations = true, hasQueryKeys = false, hasMutationKeys = false, hasInvalidation = false, } = opts;
+    const { hasMutations = true, hasSubscriptions = false, hasQueryKeys = false, hasMutationKeys = false, hasInvalidation = false, } = opts;
     const tableNames = tables.map((tbl) => tbl.name).join(', ');
     const statements = [];
     // Client configuration (ORM wrapper with configure/getClient)
@@ -92,6 +92,10 @@ export function generateMainBarrel(tables, options = {}) {
     if (hasMutations) {
         statements.push(exportAllFrom('./mutations'));
     }
+    // Subscription hooks
+    if (hasSubscriptions) {
+        statements.push(exportAllFrom('./subscriptions'));
+    }
     // Add file header as leading comment on first statement
     if (statements.length > 0) {
         addJSDocComment(statements[0], [
@@ -201,6 +205,26 @@ export function generateMultiTargetBarrel(targetNames) {
     }
     return generateCode(statements);
 }
+/**
+ * Generate the subscriptions/index.ts barrel file
+ */
+export function generateSubscriptionsBarrel(tables) {
+    const statements = [];
+    for (const table of tables) {
+        const hookName = getSubscriptionHookName(table);
+        statements.push(exportAllFrom(`./${hookName}`));
+    }
+    // Connection state hook
+    statements.push(exportAllFrom('./useConnectionState'));
+    if (statements.length > 0) {
+        addJSDocComment(statements[0], [
+            'Subscription hooks barrel export',
+            '@generated by @constructive-io/graphql-codegen',
+            'DO NOT EDIT - changes will be overwritten',
+        ]);
+    }
+    return generateCode(statements);
+}
 // ============================================================================
 // Custom operation barrels (includes both table and custom hooks)
 // ============================================================================

package/esm/core/codegen/index.d.ts

@@ -36,6 +36,7 @@ export interface GenerateResult {
         tables: number;
         queryHooks: number;
         mutationHooks: number;
+        subscriptionHooks: number;
         customQueryHooks: number;
         customMutationHooks: number;
         totalFiles: number;
@@ -71,7 +72,7 @@ export declare function generateAllFiles(tables: Table[], config: GraphQLSDKConf
  * (they're expected to exist in the shared types directory).
  */
 export declare function generate(options: GenerateOptions): GenerateResult;
-export { generateCustomMutationsBarrel, generateCustomQueriesBarrel, generateMainBarrel, generateMutationsBarrel, generateQueriesBarrel, } from './barrel';
+export { generateCustomMutationsBarrel, generateCustomQueriesBarrel, generateMainBarrel, generateMutationsBarrel, generateQueriesBarrel, generateSubscriptionsBarrel, } from './barrel';
 export { generateClientFile } from './client';
 export { generateAllCustomMutationHooks, generateCustomMutationHook, } from './custom-mutations';
 export { generateAllCustomQueryHooks, generateCustomQueryHook, } from './custom-queries';
@@ -80,3 +81,4 @@ export { generateMutationKeysFile } from './mutation-keys';
 export { generateAllMutationHooks, generateCreateMutationHook, generateDeleteMutationHook, generateUpdateMutationHook, } from './mutations';
 export { generateAllQueryHooks, generateListQueryHook, generateSingleQueryHook, } from './queries';
 export { generateQueryKeysFile } from './query-keys';
+export { generateAllSubscriptionHooks, generateConnectionStateHook, generateSubscriptionHook, } from './subscriptions';

package/esm/core/codegen/index.js

@@ -1,5 +1,5 @@
 import { DEFAULT_QUERY_KEY_CONFIG } from '../../types/config';
-import { generateCustomMutationsBarrel, generateCustomQueriesBarrel, generateMainBarrel, generateMutationsBarrel, generateQueriesBarrel, } from './barrel';
+import { generateCustomMutationsBarrel, generateCustomQueriesBarrel, generateMainBarrel, generateMutationsBarrel, generateQueriesBarrel, generateSubscriptionsBarrel, } from './barrel';
 import { generateClientFile } from './client';
 import { generateAllCustomMutationHooks } from './custom-mutations';
 import { generateAllCustomQueryHooks } from './custom-queries';
@@ -8,6 +8,7 @@ import { generateMutationKeysFile } from './mutation-keys';
 import { generateAllMutationHooks } from './mutations';
 import { generateAllQueryHooks } from './queries';
 import { generateQueryKeysFile } from './query-keys';
+import { generateAllSubscriptionHooks, generateConnectionStateHook, } from './subscriptions';
 import { generateSelectionFile } from './selection';
 import { getTableNames } from './utils';
 // ============================================================================
@@ -168,12 +169,37 @@ export function generate(options) {
                 : generateMutationsBarrel(tables),
         });
     }
+    // 8b. Generate subscription hooks (subscriptions/*.ts)
+    // Only generate for tables with the @realtime smart tag
+    const realtimeTables = tables.filter((t) => t.smartTags?.['@realtime'] !== undefined);
+    const subscriptionHooks = generateAllSubscriptionHooks(realtimeTables);
+    for (const hook of subscriptionHooks) {
+        files.push({
+            path: `subscriptions/${hook.fileName}`,
+            content: hook.content,
+        });
+    }
+    // 8c. Generate connection state hook + barrel only if any table has @realtime
+    const hasSubscriptions = subscriptionHooks.length > 0;
+    if (hasSubscriptions) {
+        const connectionStateHook = generateConnectionStateHook();
+        files.push({
+            path: `subscriptions/${connectionStateHook.fileName}`,
+            content: connectionStateHook.content,
+        });
+        // 8d. Generate subscriptions/index.ts barrel
+        files.push({
+            path: 'subscriptions/index.ts',
+            content: generateSubscriptionsBarrel(realtimeTables),
+        });
+    }
     // 9. Generate main index.ts barrel
     // No longer includes types.ts or schema-types.ts - hooks import from ORM directly
     files.push({
         path: 'index.ts',
         content: generateMainBarrel(tables, {
             hasMutations,
+            hasSubscriptions,
             hasQueryKeys,
             hasMutationKeys,
             hasInvalidation,
@@ -185,6 +211,7 @@ export function generate(options) {
             tables: tables.length,
             queryHooks: queryHooks.length,
             mutationHooks: mutationHooks.length,
+            subscriptionHooks: subscriptionHooks.length,
             customQueryHooks: customQueryHooks.length,
             customMutationHooks: customMutationHooks.length,
             totalFiles: files.length,
@@ -194,7 +221,7 @@ export function generate(options) {
 // ============================================================================
 // Re-exports for convenience
 // ============================================================================
-export { generateCustomMutationsBarrel, generateCustomQueriesBarrel, generateMainBarrel, generateMutationsBarrel, generateQueriesBarrel, } from './barrel';
+export { generateCustomMutationsBarrel, generateCustomQueriesBarrel, generateMainBarrel, generateMutationsBarrel, generateQueriesBarrel, generateSubscriptionsBarrel, } from './barrel';
 export { generateClientFile } from './client';
 export { generateAllCustomMutationHooks, generateCustomMutationHook, } from './custom-mutations';
 export { generateAllCustomQueryHooks, generateCustomQueryHook, } from './custom-queries';
@@ -203,3 +230,4 @@ export { generateMutationKeysFile } from './mutation-keys';
 export { generateAllMutationHooks, generateCreateMutationHook, generateDeleteMutationHook, generateUpdateMutationHook, } from './mutations';
 export { generateAllQueryHooks, generateListQueryHook, generateSingleQueryHook, } from './queries';
 export { generateQueryKeysFile } from './query-keys';
+export { generateAllSubscriptionHooks, generateConnectionStateHook, generateSubscriptionHook, } from './subscriptions';

package/esm/core/codegen/orm/client-generator.d.ts

@@ -10,6 +10,12 @@ export interface GeneratedClientFile {
  * Reads from the templates directory for proper type checking.
  */
 export declare function generateOrmClientFile(): GeneratedClientFile;
+/**
+ * Generate the realtime.ts file (RealtimeManager + subscription types)
+ *
+ * Reads from the templates directory for proper type checking.
+ */
+export declare function generateRealtimeFile(): GeneratedClientFile;
 /**
  * Generate the query-builder.ts file (runtime query builder)
  *