@constructive-io/graphql-codegen 4.38.2 → 4.39.1

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

@@ -15,12 +15,36 @@ 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,
+  WsClient,
+} from './realtime';
+export { RealtimeManager } from './realtime';
+
 /**
  * Default adapter that uses fetch for HTTP requests.
  *
@@ -117,6 +141,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 +165,7 @@ export class GraphQLRequestError extends Error {
 
 export class OrmClient {
   private adapter: GraphQLAdapter;
+  private realtimeManager?: RealtimeManager;
 
   constructor(config: OrmClientConfig) {
     if (config.adapter) {
@@ -150,6 +181,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 +194,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 +239,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,267 @@
+/**
+ * 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.
+ */
+
+// 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.
+
+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;
+}
+
+// ============================================================================
+// 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.
+ *
+ * @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;
+}
+
+// ============================================================================
+// RealtimeManager
+// ============================================================================
+
+/**
+ * Manages a graphql-ws WebSocket client and multiplexes
+ * subscriptions over it. Created 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) {
+    this.wsClient = config.client;
+  }
+
+  /**
+   * 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)
  *

package/esm/core/codegen/orm/client-generator.js

@@ -44,6 +44,17 @@ export function generateOrmClientFile() {
         content: readTemplateFile('orm-client.ts', 'ORM Client - Runtime GraphQL executor'),
     };
 }
+/**
+ * Generate the realtime.ts file (RealtimeManager + subscription types)
+ *
+ * Reads from the templates directory for proper type checking.
+ */
+export function generateRealtimeFile() {
+    return {
+        fileName: 'realtime.ts',
+        content: readTemplateFile('orm-realtime.ts', 'Realtime Manager - WebSocket subscription support'),
+    };
+}
 /**
  * Generate the query-builder.ts file (runtime query builder)
  *