refactor(codegen): elevate nodeHttpAdapter to top-level generation option

- Move nodeHttpAdapter from CliConfig to GraphQLSDKConfigTarget
- Auto-enable nodeHttpAdapter when CLI generation is enabled (unless explicitly false)
- Generate node-fetch.ts in ORM output when nodeHttpAdapter is enabled
- Export NodeHttpAdapter from ORM index.ts for standalone Node.js usage
- Pass nodeHttpAdapter to multi-target CLI generator
- Update template comment to reflect general Node.js usage (not CLI-specific)

This allows any Node.js application (ORM, CLI, or custom) to use NodeHttpAdapter
for localhost subdomain routing without needing CLI generation enabled.

Author: unknown

graphql/codegen/src/core/codegen/cli/index.ts

@@ -45,8 +45,8 @@ export function generateCli(options: GenerateCliOptions): GenerateCliResult {
       ? cliConfig.toolName
       : 'app';
 
-  const useNodeHttpAdapter =
-    typeof cliConfig === 'object' && !!cliConfig.nodeHttpAdapter;
+  // Use top-level nodeHttpAdapter from config (auto-enabled for CLI by generate.ts)
+  const useNodeHttpAdapter = !!config.nodeHttpAdapter;
 
   const executorFile = generateExecutorFile(toolName, {
     nodeHttpAdapter: useNodeHttpAdapter,

graphql/codegen/src/core/codegen/orm/client-generator.ts

@@ -122,6 +122,7 @@ export function generateCreateClientFile(
   tables: CleanTable[],
   hasCustomQueries: boolean,
   hasCustomMutations: boolean,
+  options?: { nodeHttpAdapter?: boolean },
 ): GeneratedClientFile {
   const statements: t.Statement[] = [];
 
@@ -215,6 +216,22 @@ export function generateCreateClientFile(
   // Re-export all models
   statements.push(t.exportAllDeclaration(t.stringLiteral('./models')));
 
+  // Re-export NodeHttpAdapter when enabled (for use in any Node.js application)
+  if (options?.nodeHttpAdapter) {
+    statements.push(
+      t.exportNamedDeclaration(
+        null,
+        [
+          t.exportSpecifier(
+            t.identifier('NodeHttpAdapter'),
+            t.identifier('NodeHttpAdapter'),
+          ),
+        ],
+        t.stringLiteral('./node-fetch'),
+      ),
+    );
+  }
+
   // Re-export custom operations
   if (hasCustomQueries) {
     statements.push(

graphql/codegen/src/core/codegen/orm/index.ts

@@ -170,6 +170,7 @@ export function generateOrm(options: GenerateOrmOptions): GenerateOrmResult {
     tables,
     hasCustomQueries,
     hasCustomMutations,
+    { nodeHttpAdapter: !!options.config.nodeHttpAdapter },
   );
   files.push({ path: indexFile.fileName, content: indexFile.content });
 

graphql/codegen/src/core/codegen/templates/node-fetch.ts

@@ -1,5 +1,5 @@
 /**
- * Node HTTP Adapter for CLI
+ * Node HTTP Adapter for Node.js applications
  *
  * Implements the GraphQLAdapter interface using node:http / node:https
  * instead of the Fetch API. This solves two Node.js limitations:

graphql/codegen/src/core/generate.ts

@@ -109,6 +109,11 @@ export async function generate(
   const runOrm =
     runReactQuery || !!config.cli || (options.orm !== undefined ? !!options.orm : false);
 
+  // Auto-enable nodeHttpAdapter when CLI is enabled, unless explicitly set to false
+  const useNodeHttpAdapter =
+    options.nodeHttpAdapter === true ||
+    (runCli && options.nodeHttpAdapter !== false);
+
   if (!options.schemaOnly && !runReactQuery && !runOrm && !runCli) {
     return {
       success: false,
@@ -256,7 +261,7 @@ export async function generate(
         mutations: customOperations.mutations,
         typeRegistry: customOperations.typeRegistry,
       },
-      config,
+      config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
       sharedTypesPath: bothEnabled ? '..' : undefined,
     });
     filesToWrite.push(
@@ -265,6 +270,16 @@ export async function generate(
         path: path.posix.join('orm', file.path),
       })),
     );
+
+    // Generate NodeHttpAdapter in ORM output when enabled
+    if (useNodeHttpAdapter) {
+      const { generateNodeFetchFile } = await import('./codegen/cli/utils-generator');
+      const nodeFetchFile = generateNodeFetchFile();
+      filesToWrite.push({
+        path: path.posix.join('orm', nodeFetchFile.fileName),
+        content: nodeFetchFile.content,
+      });
+    }
   }
 
   // Generate CLI commands
@@ -276,7 +291,7 @@ export async function generate(
         queries: customOperations.queries,
         mutations: customOperations.mutations,
       },
-      config,
+      config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
     });
     filesToWrite.push(
       ...files.map((file) => ({
@@ -669,10 +684,18 @@ export async function generateMulti(
   if (useUnifiedCli && cliTargets.length > 0 && !dryRun) {
     const cliConfig = typeof unifiedCli === 'object' ? unifiedCli : {};
     const toolName = cliConfig.toolName ?? 'app';
+    // Auto-enable nodeHttpAdapter for unified CLI unless explicitly disabled
+    // Check first target config for explicit nodeHttpAdapter setting
+    const firstTargetConfig = configs[names[0]];
+    const multiNodeHttpAdapter =
+      firstTargetConfig?.nodeHttpAdapter === true ||
+      (firstTargetConfig?.nodeHttpAdapter !== false);
+
     const { files } = generateMultiTargetCli({
       toolName,
       builtinNames: cliConfig.builtinNames,
       targets: cliTargets,
+      nodeHttpAdapter: multiNodeHttpAdapter,
     });
 
     const cliFilesToWrite = files.map((file) => ({

graphql/codegen/src/types/config.ts

@@ -199,16 +199,6 @@ export interface CliConfig {
    *           context -> 'context' (renamed to 'env' on collision)
    */
   builtinNames?: BuiltinNames;
-
-  /**
-   * Enable NodeHttpAdapter for *.localhost subdomain routing.
-   * When true, generates a node-fetch.ts with NodeHttpAdapter (implements GraphQLAdapter)
-   * using node:http/node:https for requests, enabling local development
-   * with subdomain-based routing (e.g. auth.localhost:3000).
-   * No global patching — the adapter is passed to createClient via the adapter option.
-   * @default false
-   */
-  nodeHttpAdapter?: boolean;
 }
 
 /**
@@ -333,6 +323,25 @@ export interface GraphQLSDKConfigTarget {
    */
   orm?: boolean;
 
+  /**
+   * Enable NodeHttpAdapter generation for Node.js applications.
+   * When true, generates a node-fetch.ts with NodeHttpAdapter (implements GraphQLAdapter)
+   * using node:http/node:https for requests, enabling local development
+   * with subdomain-based routing (e.g. auth.localhost:3000).
+   * No global patching — the adapter is passed to createClient via the adapter option.
+   *
+   * When CLI generation is enabled (`cli: true`), this is auto-enabled unless
+   * explicitly set to `false`.
+   *
+   * Can also be used standalone with the ORM client for any Node.js application:
+   * ```ts
+   * import { NodeHttpAdapter } from './orm/node-fetch';
+   * const db = createClient({ adapter: new NodeHttpAdapter(endpoint, headers) });
+   * ```
+   * @default false
+   */
+  nodeHttpAdapter?: boolean;
+
   /**
    * Whether to generate React Query hooks
    * When enabled, generates React Query hooks to {output}/hooks