@constructive-io/graphql-codegen 4.2.0 → 4.3.0

package/core/codegen/cli/custom-command-generator.js

@@ -101,9 +101,19 @@ function buildDefaultSelectString(returnType, isMutation) {
     }
     return '';
 }
-function buildOrmCustomCall(opKind, opName, argsExpr, selectExpr) {
-    const callArgs = [argsExpr];
-    if (selectExpr) {
+function buildOrmCustomCall(opKind, opName, argsExpr, selectExpr, hasArgs = true) {
+    const callArgs = [];
+    if (hasArgs) {
+        // Operation has arguments: pass args as first param, select as second
+        callArgs.push(argsExpr);
+        if (selectExpr) {
+            callArgs.push(t.objectExpression([
+                t.objectProperty(t.identifier('select'), selectExpr),
+            ]));
+        }
+    }
+    else if (selectExpr) {
+        // No arguments: pass { select } as the only param (ORM signature)
         callArgs.push(t.objectExpression([
             t.objectProperty(t.identifier('select'), selectExpr),
         ]));
@@ -197,8 +207,9 @@ function generateCustomCommand(op, options) {
         ]));
         selectExpr = t.identifier('selectFields');
     }
+    const hasArgs = op.args.length > 0;
     bodyStatements.push(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCustomCall(opKind, op.name, argsExpr, selectExpr))),
+        t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCustomCall(opKind, op.name, argsExpr, selectExpr, hasArgs))),
     ]));
     if (options?.saveToken) {
         bodyStatements.push(t.ifStatement(t.logicalExpression('&&', t.memberExpression(t.identifier('argv'), t.identifier('saveToken')), t.identifier('result')), t.blockStatement([

package/core/codegen/cli/executor-generator.d.ts

@@ -7,5 +7,9 @@ export interface MultiTargetExecutorInput {
     endpoint: string;
     ormImportPath: string;
 }
-export declare function generateExecutorFile(toolName: string): GeneratedFile;
-export declare function generateMultiTargetExecutorFile(toolName: string, targets: MultiTargetExecutorInput[]): GeneratedFile;
+export interface ExecutorOptions {
+    /** Enable NodeHttpAdapter for *.localhost subdomain routing */
+    nodeHttpAdapter?: boolean;
+}
+export declare function generateExecutorFile(toolName: string, options?: ExecutorOptions): GeneratedFile;
+export declare function generateMultiTargetExecutorFile(toolName: string, targets: MultiTargetExecutorInput[], options?: ExecutorOptions): GeneratedFile;

package/core/codegen/cli/executor-generator.js

@@ -44,8 +44,12 @@ function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false
     decl.importKind = typeOnly ? 'type' : 'value';
     return decl;
 }
-function generateExecutorFile(toolName) {
+function generateExecutorFile(toolName, options) {
     const statements = [];
+    // Import NodeHttpAdapter for *.localhost subdomain routing
+    if (options?.nodeHttpAdapter) {
+        statements.push(createImportDeclaration('./node-fetch', ['NodeHttpAdapter']));
+    }
     statements.push(createImportDeclaration('appstash', ['createConfigStore']));
     statements.push(createImportDeclaration('../orm', ['createClient']));
     statements.push(t.variableDeclaration('const', [
@@ -98,12 +102,26 @@ function generateExecutorFile(toolName) {
                 ]))),
             ])),
         ])),
-        t.returnStatement(t.callExpression(t.identifier('createClient'), [
-            t.objectExpression([
-                t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('ctx'), t.identifier('endpoint'))),
-                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+        // Build createClient config — use NodeHttpAdapter for *.localhost endpoints
+        ...(options?.nodeHttpAdapter
+            ? [
+                t.returnStatement(t.callExpression(t.identifier('createClient'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('adapter'), t.newExpression(t.identifier('NodeHttpAdapter'), [
+                            t.memberExpression(t.identifier('ctx'), t.identifier('endpoint')),
+                            t.identifier('headers'),
+                        ])),
+                    ]),
+                ])),
+            ]
+            : [
+                t.returnStatement(t.callExpression(t.identifier('createClient'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('ctx'), t.identifier('endpoint'))),
+                        t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+                    ]),
+                ])),
             ]),
-        ])),
     ]);
     const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [contextNameParam], getClientBody);
     statements.push(t.exportNamedDeclaration(getClientFunc));
@@ -114,8 +132,12 @@ function generateExecutorFile(toolName) {
         content: header + '\n' + code,
     };
 }
-function generateMultiTargetExecutorFile(toolName, targets) {
+function generateMultiTargetExecutorFile(toolName, targets, options) {
     const statements = [];
+    // Import NodeHttpAdapter for *.localhost subdomain routing
+    if (options?.nodeHttpAdapter) {
+        statements.push(createImportDeclaration('./node-fetch', ['NodeHttpAdapter']));
+    }
     statements.push(createImportDeclaration('appstash', ['createConfigStore']));
     for (const target of targets) {
         const aliasName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}Client`;
@@ -199,12 +221,26 @@ function generateMultiTargetExecutorFile(toolName, targets) {
         ]), t.blockStatement([
             t.expressionStatement(t.assignmentExpression('=', t.identifier('endpoint'), t.logicalExpression('||', t.memberExpression(t.identifier('defaultEndpoints'), t.identifier('targetName'), true), t.stringLiteral('')))),
         ])),
-        t.returnStatement(t.callExpression(t.identifier('createFn'), [
-            t.objectExpression([
-                t.objectProperty(t.identifier('endpoint'), t.identifier('endpoint')),
-                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+        // Build createClient config — use NodeHttpAdapter for *.localhost endpoints
+        ...(options?.nodeHttpAdapter
+            ? [
+                t.returnStatement(t.callExpression(t.identifier('createFn'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('adapter'), t.newExpression(t.identifier('NodeHttpAdapter'), [
+                            t.identifier('endpoint'),
+                            t.identifier('headers'),
+                        ])),
+                    ]),
+                ])),
+            ]
+            : [
+                t.returnStatement(t.callExpression(t.identifier('createFn'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('endpoint'), t.identifier('endpoint')),
+                        t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+                    ]),
+                ])),
             ]),
-        ])),
     ]);
     const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [targetNameParam, contextNameParam], getClientBody);
     statements.push(t.exportNamedDeclaration(getClientFunc));

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

@@ -1,5 +1,5 @@
 import type { BuiltinNames, GraphQLSDKConfigTarget } from '../../../types/config';
-import type { CleanOperation, CleanTable } from '../../../types/schema';
+import type { CleanOperation, CleanTable, TypeRegistry } from '../../../types/schema';
 import type { GeneratedFile } from './executor-generator';
 export interface GenerateCliOptions {
     tables: CleanTable[];
@@ -8,6 +8,8 @@ export interface GenerateCliOptions {
         mutations: CleanOperation[];
     };
     config: GraphQLSDKConfigTarget;
+    /** TypeRegistry from introspection, used to check field defaults */
+    typeRegistry?: TypeRegistry;
 }
 export interface GenerateCliResult {
     files: GeneratedFile[];
@@ -30,11 +32,15 @@ export interface MultiTargetCliTarget {
         mutations: CleanOperation[];
     };
     isAuthTarget?: boolean;
+    /** TypeRegistry from introspection, used to check field defaults */
+    typeRegistry?: TypeRegistry;
 }
 export interface GenerateMultiTargetCliOptions {
     toolName: string;
     builtinNames?: BuiltinNames;
     targets: MultiTargetCliTarget[];
+    /** Enable NodeHttpAdapter for *.localhost subdomain routing */
+    nodeHttpAdapter?: boolean;
 }
 export declare function resolveBuiltinNames(targetNames: string[], userOverrides?: BuiltinNames): {
     auth: string;

package/core/codegen/cli/index.js

@@ -17,16 +17,26 @@ function generateCli(options) {
     const toolName = typeof cliConfig === 'object' && cliConfig.toolName
         ? cliConfig.toolName
         : 'app';
-    const executorFile = (0, executor_generator_1.generateExecutorFile)(toolName);
+    // Use top-level nodeHttpAdapter from config (auto-enabled for CLI by generate.ts)
+    const useNodeHttpAdapter = !!config.nodeHttpAdapter;
+    const executorFile = (0, executor_generator_1.generateExecutorFile)(toolName, {
+        nodeHttpAdapter: useNodeHttpAdapter,
+    });
     files.push(executorFile);
     const utilsFile = (0, utils_generator_1.generateUtilsFile)();
     files.push(utilsFile);
+    // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
+    if (useNodeHttpAdapter) {
+        files.push((0, utils_generator_1.generateNodeFetchFile)());
+    }
     const contextFile = (0, infra_generator_1.generateContextCommand)(toolName);
     files.push(contextFile);
     const authFile = (0, infra_generator_1.generateAuthCommand)(toolName);
     files.push(authFile);
     for (const table of tables) {
-        const tableFile = (0, table_command_generator_1.generateTableCommand)(table);
+        const tableFile = (0, table_command_generator_1.generateTableCommand)(table, {
+            typeRegistry: options.typeRegistry,
+        });
         files.push(tableFile);
     }
     const allCustomOps = [
@@ -71,10 +81,16 @@ function generateMultiTargetCli(options) {
         endpoint: t.endpoint,
         ormImportPath: t.ormImportPath,
     }));
-    const executorFile = (0, executor_generator_1.generateMultiTargetExecutorFile)(toolName, executorInputs);
+    const executorFile = (0, executor_generator_1.generateMultiTargetExecutorFile)(toolName, executorInputs, {
+        nodeHttpAdapter: !!options.nodeHttpAdapter,
+    });
     files.push(executorFile);
     const utilsFile = (0, utils_generator_1.generateUtilsFile)();
     files.push(utilsFile);
+    // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
+    if (options.nodeHttpAdapter) {
+        files.push((0, utils_generator_1.generateNodeFetchFile)());
+    }
     const contextFile = (0, infra_generator_1.generateMultiTargetContextCommand)(toolName, builtinNames.context, targets.map((t) => ({ name: t.name, endpoint: t.endpoint })));
     files.push(contextFile);
     const authFile = (0, infra_generator_1.generateAuthCommandWithName)(toolName, builtinNames.auth);
@@ -92,6 +108,7 @@ function generateMultiTargetCli(options) {
             const tableFile = (0, table_command_generator_1.generateTableCommand)(table, {
                 targetName: target.name,
                 executorImportPath: '../../executor',
+                typeRegistry: target.typeRegistry,
             });
             files.push(tableFile);
         }

package/core/codegen/cli/table-command-generator.d.ts

@@ -1,7 +1,9 @@
-import type { CleanTable } from '../../../types/schema';
+import type { CleanTable, TypeRegistry } from '../../../types/schema';
 import type { GeneratedFile } from './executor-generator';
 export interface TableCommandOptions {
     targetName?: string;
     executorImportPath?: string;
+    /** TypeRegistry from introspection, used to check field defaults */
+    typeRegistry?: TypeRegistry;
 }
 export declare function generateTableCommand(table: CleanTable, options?: TableCommandOptions): GeneratedFile;

package/core/codegen/cli/table-command-generator.js

@@ -38,6 +38,7 @@ const t = __importStar(require("@babel/types"));
 const komoji_1 = require("komoji");
 const babel_ast_1 = require("../babel-ast");
 const utils_1 = require("../utils");
+const utils_2 = require("../utils");
 function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false) {
     const specifiers = namedImports.map((name) => t.importSpecifier(t.identifier(name), t.identifier(name)));
     const decl = t.importDeclaration(specifiers, t.stringLiteral(moduleSpecifier));
@@ -183,7 +184,46 @@ function buildGetHandler(table, targetName) {
         t.tryStatement(t.blockStatement(tryBody), buildErrorCatch('Record not found.')),
     ]), false, true);
 }
-function buildMutationHandler(table, operation, targetName) {
+/**
+ * Get the set of field names that have defaults in the create input type.
+ * Looks up the CreateXInput -> inner input type (e.g. DatabaseInput) in the
+ * TypeRegistry and checks each field's defaultValue from introspection.
+ */
+function getFieldsWithDefaults(table, typeRegistry) {
+    const fieldsWithDefaults = new Set();
+    if (!typeRegistry)
+        return fieldsWithDefaults;
+    // Look up the CreateXInput type (e.g. CreateDatabaseInput)
+    const createInputTypeName = (0, utils_2.getCreateInputTypeName)(table);
+    const createInputType = typeRegistry.get(createInputTypeName);
+    if (!createInputType?.inputFields)
+        return fieldsWithDefaults;
+    // The CreateXInput has an inner field (e.g. "database" of type DatabaseInput)
+    // Find the inner input type that contains the actual field definitions
+    for (const inputField of createInputType.inputFields) {
+        // The inner field's type name is the actual input type (e.g. DatabaseInput)
+        const innerTypeName = inputField.type.name
+            || inputField.type.ofType?.name
+            || inputField.type.ofType?.ofType?.name;
+        if (!innerTypeName)
+            continue;
+        const innerType = typeRegistry.get(innerTypeName);
+        if (!innerType?.inputFields)
+            continue;
+        // Check each field in the inner input type for defaultValue
+        for (const field of innerType.inputFields) {
+            if (field.defaultValue !== undefined) {
+                fieldsWithDefaults.add(field.name);
+            }
+            // Also check if the field is NOT wrapped in NON_NULL (nullable = has default or is optional)
+            if (field.type.kind !== 'NON_NULL') {
+                fieldsWithDefaults.add(field.name);
+            }
+        }
+    }
+    return fieldsWithDefaults;
+}
+function buildMutationHandler(table, operation, targetName, typeRegistry) {
     const { singularName } = (0, utils_1.getTableNames)(table);
     const pkFields = (0, utils_1.getPrimaryKeyInfo)(table);
     const pk = pkFields[0];
@@ -191,6 +231,8 @@ function buildMutationHandler(table, operation, targetName) {
         f.name !== 'nodeId' &&
         f.name !== 'createdAt' &&
         f.name !== 'updatedAt');
+    // Get fields that have defaults from introspection (for create operations)
+    const fieldsWithDefaults = getFieldsWithDefaults(table, typeRegistry);
     const questions = [];
     if (operation === 'update' || operation === 'delete') {
         questions.push(t.objectExpression([
@@ -202,11 +244,14 @@ function buildMutationHandler(table, operation, targetName) {
     }
     if (operation !== 'delete') {
         for (const field of editableFields) {
+            // For create: field is required only if it has no default value
+            // For update: all fields are optional (user only updates what they want)
+            const isRequired = operation === 'create' && !fieldsWithDefaults.has(field.name);
             questions.push(t.objectExpression([
                 t.objectProperty(t.identifier('type'), t.stringLiteral('text')),
                 t.objectProperty(t.identifier('name'), t.stringLiteral(field.name)),
                 t.objectProperty(t.identifier('message'), t.stringLiteral(field.name)),
-                t.objectProperty(t.identifier('required'), t.booleanLiteral(operation === 'create')),
+                t.objectProperty(t.identifier('required'), t.booleanLiteral(isRequired)),
             ]));
         }
     }
@@ -365,9 +410,9 @@ function generateTableCommand(table, options) {
     const tn = options?.targetName;
     statements.push(buildListHandler(table, tn));
     statements.push(buildGetHandler(table, tn));
-    statements.push(buildMutationHandler(table, 'create', tn));
-    statements.push(buildMutationHandler(table, 'update', tn));
-    statements.push(buildMutationHandler(table, 'delete', tn));
+    statements.push(buildMutationHandler(table, 'create', tn, options?.typeRegistry));
+    statements.push(buildMutationHandler(table, 'update', tn, options?.typeRegistry));
+    statements.push(buildMutationHandler(table, 'delete', tn, options?.typeRegistry));
     const header = (0, utils_1.getGeneratedFileHeader)(`CLI commands for ${table.name}`);
     const code = (0, babel_ast_1.generateCode)(statements);
     return {

package/core/codegen/cli/utils-generator.d.ts

@@ -8,3 +8,11 @@ import type { GeneratedFile } from './executor-generator';
  * and mutation input parsing.
  */
 export declare function generateUtilsFile(): GeneratedFile;
+/**
+ * Generate a node-fetch.ts file with NodeHttpAdapter for CLI.
+ *
+ * Provides a GraphQLAdapter implementation using node:http/node:https
+ * instead of the Fetch API. This cleanly handles *.localhost subdomain
+ * routing (DNS resolution + Host header) without any global patching.
+ */
+export declare function generateNodeFetchFile(): GeneratedFile;

package/core/codegen/cli/utils-generator.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateUtilsFile = generateUtilsFile;
+exports.generateNodeFetchFile = generateNodeFetchFile;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const utils_1 = require("../utils");
@@ -76,3 +77,16 @@ function generateUtilsFile() {
         content: readTemplateFile('cli-utils.ts', 'CLI utility functions for type coercion and input handling'),
     };
 }
+/**
+ * Generate a node-fetch.ts file with NodeHttpAdapter for CLI.
+ *
+ * Provides a GraphQLAdapter implementation using node:http/node:https
+ * instead of the Fetch API. This cleanly handles *.localhost subdomain
+ * routing (DNS resolution + Host header) without any global patching.
+ */
+function generateNodeFetchFile() {
+    return {
+        fileName: 'node-fetch.ts',
+        content: readTemplateFile('node-fetch.ts', 'Node HTTP adapter for localhost subdomain routing'),
+    };
+}

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

@@ -25,4 +25,6 @@ export declare function generateSelectTypesFile(): GeneratedClientFile;
 /**
  * Generate the main index.ts with createClient factory
  */
-export declare function generateCreateClientFile(tables: CleanTable[], hasCustomQueries: boolean, hasCustomMutations: boolean): GeneratedClientFile;
+export declare function generateCreateClientFile(tables: CleanTable[], hasCustomQueries: boolean, hasCustomMutations: boolean, options?: {
+    nodeHttpAdapter?: boolean;
+}): GeneratedClientFile;

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

@@ -114,7 +114,7 @@ function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false
 /**
  * Generate the main index.ts with createClient factory
  */
-function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations) {
+function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations, options) {
     const statements = [];
     // Add imports
     // Import OrmClient (value) and OrmClientConfig (type) separately
@@ -156,6 +156,12 @@ function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations)
     statements.push(t.exportAllDeclaration(t.stringLiteral('./select-types')));
     // 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(t.exportNamedDeclaration(null, [

package/core/codegen/orm/index.js

@@ -91,7 +91,7 @@ function generateOrm(options) {
     const typesBarrel = (0, barrel_1.generateTypesBarrel)(useSharedTypes);
     files.push({ path: typesBarrel.fileName, content: typesBarrel.content });
     // 7. Generate main index.ts with createClient
-    const indexFile = (0, client_generator_1.generateCreateClientFile)(tables, hasCustomQueries, hasCustomMutations);
+    const indexFile = (0, client_generator_1.generateCreateClientFile)(tables, hasCustomQueries, hasCustomMutations, { nodeHttpAdapter: !!options.config.nodeHttpAdapter });
     files.push({ path: indexFile.fileName, content: indexFile.content });
     return {
         files,

package/core/codegen/templates/node-fetch.ts

@@ -0,0 +1,162 @@
+/**
+ * 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:
+ *
+ * 1. DNS: Node.js cannot resolve *.localhost subdomains (ENOTFOUND).
+ *    Browsers handle this automatically, but Node requires manual resolution.
+ *
+ * 2. Host header: The Fetch API treats "Host" as a forbidden request header
+ *    and silently drops it. The Constructive GraphQL server uses Host-header
+ *    subdomain routing (enableServicesApi), so this header must be preserved.
+ *
+ * By using node:http.request directly, both issues are bypassed cleanly
+ * without any global patching.
+ *
+ * NOTE: This file is read at codegen time and written to output.
+ * Any changes here will affect all generated CLI node adapters.
+ */
+
+import http from 'node:http';
+import https from 'node:https';
+
+import type {
+  GraphQLAdapter,
+  GraphQLError,
+  QueryResult,
+} from '@constructive-io/graphql-types';
+
+interface HttpResponse {
+  statusCode: number;
+  statusMessage: string;
+  data: string;
+}
+
+/**
+ * Check if a hostname is a localhost subdomain that needs special handling.
+ * Returns true for *.localhost (e.g. auth.localhost) but not bare "localhost".
+ */
+function isLocalhostSubdomain(hostname: string): boolean {
+  return hostname.endsWith('.localhost') && hostname !== 'localhost';
+}
+
+/**
+ * Make an HTTP/HTTPS request using native Node modules.
+ */
+function makeRequest(
+  url: URL,
+  options: http.RequestOptions,
+  body: string,
+): Promise<HttpResponse> {
+  return new Promise((resolve, reject) => {
+    const protocol = url.protocol === 'https:' ? https : http;
+
+    const req = protocol.request(url, options, (res) => {
+      let data = '';
+      res.setEncoding('utf8');
+      res.on('data', (chunk: string) => {
+        data += chunk;
+      });
+      res.on('end', () => {
+        resolve({
+          statusCode: res.statusCode || 0,
+          statusMessage: res.statusMessage || '',
+          data,
+        });
+      });
+    });
+
+    req.on('error', reject);
+    req.write(body);
+    req.end();
+  });
+}
+
+/**
+ * GraphQL adapter that uses node:http/node:https for requests.
+ *
+ * Handles *.localhost subdomains by rewriting the hostname to "localhost"
+ * and injecting the original Host header for server-side subdomain routing.
+ */
+export class NodeHttpAdapter implements GraphQLAdapter {
+  private headers: Record<string, string>;
+  private url: URL;
+
+  constructor(
+    private endpoint: string,
+    headers?: Record<string, string>,
+  ) {
+    this.headers = headers ?? {};
+    this.url = new URL(endpoint);
+  }
+
+  async execute<T>(
+    document: string,
+    variables?: Record<string, unknown>,
+  ): Promise<QueryResult<T>> {
+    const requestUrl = new URL(this.url.href);
+    const requestHeaders: Record<string, string> = {
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+      ...this.headers,
+    };
+
+    // For *.localhost subdomains, rewrite hostname and inject Host header
+    if (isLocalhostSubdomain(requestUrl.hostname)) {
+      requestHeaders['Host'] = requestUrl.host;
+      requestUrl.hostname = 'localhost';
+    }
+
+    const body = JSON.stringify({
+      query: document,
+      variables: variables ?? {},
+    });
+
+    const requestOptions: http.RequestOptions = {
+      method: 'POST',
+      headers: requestHeaders,
+    };
+
+    const response = await makeRequest(requestUrl, requestOptions, body);
+
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+      return {
+        ok: false,
+        data: null,
+        errors: [
+          {
+            message: `HTTP ${response.statusCode}: ${response.statusMessage}`,
+          },
+        ],
+      };
+    }
+
+    const json = JSON.parse(response.data) as {
+      data?: T;
+      errors?: GraphQLError[];
+    };
+
+    if (json.errors && json.errors.length > 0) {
+      return {
+        ok: false,
+        data: null,
+        errors: json.errors,
+      };
+    }
+
+    return {
+      ok: true,
+      data: json.data as T,
+      errors: undefined,
+    };
+  }
+
+  setHeaders(headers: Record<string, string>): void {
+    this.headers = { ...this.headers, ...headers };
+  }
+
+  getEndpoint(): string {
+    return this.endpoint;
+  }
+}

package/core/generate.js

@@ -76,6 +76,9 @@ async function generate(options = {}, internalOptions) {
     const runReactQuery = config.reactQuery ?? false;
     const runCli = internalOptions?.skipCli ? false : !!config.cli;
     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,
@@ -209,13 +212,22 @@ async function generate(options = {}, internalOptions) {
                 mutations: customOperations.mutations,
                 typeRegistry: customOperations.typeRegistry,
             },
-            config,
+            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
             sharedTypesPath: bothEnabled ? '..' : undefined,
         });
         filesToWrite.push(...files.map((file) => ({
             ...file,
             path: node_path_1.default.posix.join('orm', file.path),
         })));
+        // Generate NodeHttpAdapter in ORM output when enabled
+        if (useNodeHttpAdapter) {
+            const { generateNodeFetchFile } = await Promise.resolve().then(() => __importStar(require('./codegen/cli/utils-generator')));
+            const nodeFetchFile = generateNodeFetchFile();
+            filesToWrite.push({
+                path: node_path_1.default.posix.join('orm', nodeFetchFile.fileName),
+                content: nodeFetchFile.content,
+            });
+        }
     }
     // Generate CLI commands
     if (runCli) {
@@ -226,7 +238,7 @@ async function generate(options = {}, internalOptions) {
                 queries: customOperations.queries,
                 mutations: customOperations.mutations,
             },
-            config,
+            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
         });
         filesToWrite.push(...files.map((file) => ({
             path: node_path_1.default.posix.join('cli', file.fileName),
@@ -552,10 +564,16 @@ async function generateMulti(options) {
         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 } = (0, cli_1.generateMultiTargetCli)({
                 toolName,
                 builtinNames: cliConfig.builtinNames,
                 targets: cliTargets,
+                nodeHttpAdapter: multiNodeHttpAdapter,
             });
             const cliFilesToWrite = files.map((file) => ({
                 path: node_path_1.default.posix.join('cli', file.fileName),

package/esm/core/codegen/cli/custom-command-generator.js

@@ -65,9 +65,19 @@ function buildDefaultSelectString(returnType, isMutation) {
     }
     return '';
 }
-function buildOrmCustomCall(opKind, opName, argsExpr, selectExpr) {
-    const callArgs = [argsExpr];
-    if (selectExpr) {
+function buildOrmCustomCall(opKind, opName, argsExpr, selectExpr, hasArgs = true) {
+    const callArgs = [];
+    if (hasArgs) {
+        // Operation has arguments: pass args as first param, select as second
+        callArgs.push(argsExpr);
+        if (selectExpr) {
+            callArgs.push(t.objectExpression([
+                t.objectProperty(t.identifier('select'), selectExpr),
+            ]));
+        }
+    }
+    else if (selectExpr) {
+        // No arguments: pass { select } as the only param (ORM signature)
         callArgs.push(t.objectExpression([
             t.objectProperty(t.identifier('select'), selectExpr),
         ]));
@@ -161,8 +171,9 @@ export function generateCustomCommand(op, options) {
         ]));
         selectExpr = t.identifier('selectFields');
     }
+    const hasArgs = op.args.length > 0;
     bodyStatements.push(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCustomCall(opKind, op.name, argsExpr, selectExpr))),
+        t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCustomCall(opKind, op.name, argsExpr, selectExpr, hasArgs))),
     ]));
     if (options?.saveToken) {
         bodyStatements.push(t.ifStatement(t.logicalExpression('&&', t.memberExpression(t.identifier('argv'), t.identifier('saveToken')), t.identifier('result')), t.blockStatement([

package/esm/core/codegen/cli/executor-generator.d.ts

@@ -7,5 +7,9 @@ export interface MultiTargetExecutorInput {
     endpoint: string;
     ormImportPath: string;
 }
-export declare function generateExecutorFile(toolName: string): GeneratedFile;
-export declare function generateMultiTargetExecutorFile(toolName: string, targets: MultiTargetExecutorInput[]): GeneratedFile;
+export interface ExecutorOptions {
+    /** Enable NodeHttpAdapter for *.localhost subdomain routing */
+    nodeHttpAdapter?: boolean;
+}
+export declare function generateExecutorFile(toolName: string, options?: ExecutorOptions): GeneratedFile;
+export declare function generateMultiTargetExecutorFile(toolName: string, targets: MultiTargetExecutorInput[], options?: ExecutorOptions): GeneratedFile;

package/esm/core/codegen/cli/executor-generator.js

@@ -7,8 +7,12 @@ function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false
     decl.importKind = typeOnly ? 'type' : 'value';
     return decl;
 }
-export function generateExecutorFile(toolName) {
+export function generateExecutorFile(toolName, options) {
     const statements = [];
+    // Import NodeHttpAdapter for *.localhost subdomain routing
+    if (options?.nodeHttpAdapter) {
+        statements.push(createImportDeclaration('./node-fetch', ['NodeHttpAdapter']));
+    }
     statements.push(createImportDeclaration('appstash', ['createConfigStore']));
     statements.push(createImportDeclaration('../orm', ['createClient']));
     statements.push(t.variableDeclaration('const', [
@@ -61,12 +65,26 @@ export function generateExecutorFile(toolName) {
                 ]))),
             ])),
         ])),
-        t.returnStatement(t.callExpression(t.identifier('createClient'), [
-            t.objectExpression([
-                t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('ctx'), t.identifier('endpoint'))),
-                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+        // Build createClient config — use NodeHttpAdapter for *.localhost endpoints
+        ...(options?.nodeHttpAdapter
+            ? [
+                t.returnStatement(t.callExpression(t.identifier('createClient'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('adapter'), t.newExpression(t.identifier('NodeHttpAdapter'), [
+                            t.memberExpression(t.identifier('ctx'), t.identifier('endpoint')),
+                            t.identifier('headers'),
+                        ])),
+                    ]),
+                ])),
+            ]
+            : [
+                t.returnStatement(t.callExpression(t.identifier('createClient'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('ctx'), t.identifier('endpoint'))),
+                        t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+                    ]),
+                ])),
             ]),
-        ])),
     ]);
     const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [contextNameParam], getClientBody);
     statements.push(t.exportNamedDeclaration(getClientFunc));
@@ -77,8 +95,12 @@ export function generateExecutorFile(toolName) {
         content: header + '\n' + code,
     };
 }
-export function generateMultiTargetExecutorFile(toolName, targets) {
+export function generateMultiTargetExecutorFile(toolName, targets, options) {
     const statements = [];
+    // Import NodeHttpAdapter for *.localhost subdomain routing
+    if (options?.nodeHttpAdapter) {
+        statements.push(createImportDeclaration('./node-fetch', ['NodeHttpAdapter']));
+    }
     statements.push(createImportDeclaration('appstash', ['createConfigStore']));
     for (const target of targets) {
         const aliasName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}Client`;
@@ -162,12 +184,26 @@ export function generateMultiTargetExecutorFile(toolName, targets) {
         ]), t.blockStatement([
             t.expressionStatement(t.assignmentExpression('=', t.identifier('endpoint'), t.logicalExpression('||', t.memberExpression(t.identifier('defaultEndpoints'), t.identifier('targetName'), true), t.stringLiteral('')))),
         ])),
-        t.returnStatement(t.callExpression(t.identifier('createFn'), [
-            t.objectExpression([
-                t.objectProperty(t.identifier('endpoint'), t.identifier('endpoint')),
-                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+        // Build createClient config — use NodeHttpAdapter for *.localhost endpoints
+        ...(options?.nodeHttpAdapter
+            ? [
+                t.returnStatement(t.callExpression(t.identifier('createFn'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('adapter'), t.newExpression(t.identifier('NodeHttpAdapter'), [
+                            t.identifier('endpoint'),
+                            t.identifier('headers'),
+                        ])),
+                    ]),
+                ])),
+            ]
+            : [
+                t.returnStatement(t.callExpression(t.identifier('createFn'), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('endpoint'), t.identifier('endpoint')),
+                        t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+                    ]),
+                ])),
             ]),
-        ])),
     ]);
     const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [targetNameParam, contextNameParam], getClientBody);
     statements.push(t.exportNamedDeclaration(getClientFunc));

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

@@ -1,5 +1,5 @@
 import type { BuiltinNames, GraphQLSDKConfigTarget } from '../../../types/config';
-import type { CleanOperation, CleanTable } from '../../../types/schema';
+import type { CleanOperation, CleanTable, TypeRegistry } from '../../../types/schema';
 import type { GeneratedFile } from './executor-generator';
 export interface GenerateCliOptions {
     tables: CleanTable[];
@@ -8,6 +8,8 @@ export interface GenerateCliOptions {
         mutations: CleanOperation[];
     };
     config: GraphQLSDKConfigTarget;
+    /** TypeRegistry from introspection, used to check field defaults */
+    typeRegistry?: TypeRegistry;
 }
 export interface GenerateCliResult {
     files: GeneratedFile[];
@@ -30,11 +32,15 @@ export interface MultiTargetCliTarget {
         mutations: CleanOperation[];
     };
     isAuthTarget?: boolean;
+    /** TypeRegistry from introspection, used to check field defaults */
+    typeRegistry?: TypeRegistry;
 }
 export interface GenerateMultiTargetCliOptions {
     toolName: string;
     builtinNames?: BuiltinNames;
     targets: MultiTargetCliTarget[];
+    /** Enable NodeHttpAdapter for *.localhost subdomain routing */
+    nodeHttpAdapter?: boolean;
 }
 export declare function resolveBuiltinNames(targetNames: string[], userOverrides?: BuiltinNames): {
     auth: string;

package/esm/core/codegen/cli/index.js

@@ -3,7 +3,7 @@ import { generateCustomCommand } from './custom-command-generator';
 import { generateExecutorFile, generateMultiTargetExecutorFile } from './executor-generator';
 import { generateAuthCommand, generateAuthCommandWithName, generateContextCommand, generateMultiTargetContextCommand, } from './infra-generator';
 import { generateTableCommand } from './table-command-generator';
-import { generateUtilsFile } from './utils-generator';
+import { generateUtilsFile, generateNodeFetchFile } from './utils-generator';
 export function generateCli(options) {
     const { tables, customOperations, config } = options;
     const files = [];
@@ -11,16 +11,26 @@ export function generateCli(options) {
     const toolName = typeof cliConfig === 'object' && cliConfig.toolName
         ? cliConfig.toolName
         : 'app';
-    const executorFile = generateExecutorFile(toolName);
+    // Use top-level nodeHttpAdapter from config (auto-enabled for CLI by generate.ts)
+    const useNodeHttpAdapter = !!config.nodeHttpAdapter;
+    const executorFile = generateExecutorFile(toolName, {
+        nodeHttpAdapter: useNodeHttpAdapter,
+    });
     files.push(executorFile);
     const utilsFile = generateUtilsFile();
     files.push(utilsFile);
+    // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
+    if (useNodeHttpAdapter) {
+        files.push(generateNodeFetchFile());
+    }
     const contextFile = generateContextCommand(toolName);
     files.push(contextFile);
     const authFile = generateAuthCommand(toolName);
     files.push(authFile);
     for (const table of tables) {
-        const tableFile = generateTableCommand(table);
+        const tableFile = generateTableCommand(table, {
+            typeRegistry: options.typeRegistry,
+        });
         files.push(tableFile);
     }
     const allCustomOps = [
@@ -65,10 +75,16 @@ export function generateMultiTargetCli(options) {
         endpoint: t.endpoint,
         ormImportPath: t.ormImportPath,
     }));
-    const executorFile = generateMultiTargetExecutorFile(toolName, executorInputs);
+    const executorFile = generateMultiTargetExecutorFile(toolName, executorInputs, {
+        nodeHttpAdapter: !!options.nodeHttpAdapter,
+    });
     files.push(executorFile);
     const utilsFile = generateUtilsFile();
     files.push(utilsFile);
+    // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
+    if (options.nodeHttpAdapter) {
+        files.push(generateNodeFetchFile());
+    }
     const contextFile = generateMultiTargetContextCommand(toolName, builtinNames.context, targets.map((t) => ({ name: t.name, endpoint: t.endpoint })));
     files.push(contextFile);
     const authFile = generateAuthCommandWithName(toolName, builtinNames.auth);
@@ -86,6 +102,7 @@ export function generateMultiTargetCli(options) {
             const tableFile = generateTableCommand(table, {
                 targetName: target.name,
                 executorImportPath: '../../executor',
+                typeRegistry: target.typeRegistry,
             });
             files.push(tableFile);
         }

package/esm/core/codegen/cli/table-command-generator.d.ts

@@ -1,7 +1,9 @@
-import type { CleanTable } from '../../../types/schema';
+import type { CleanTable, TypeRegistry } from '../../../types/schema';
 import type { GeneratedFile } from './executor-generator';
 export interface TableCommandOptions {
     targetName?: string;
     executorImportPath?: string;
+    /** TypeRegistry from introspection, used to check field defaults */
+    typeRegistry?: TypeRegistry;
 }
 export declare function generateTableCommand(table: CleanTable, options?: TableCommandOptions): GeneratedFile;

package/esm/core/codegen/cli/table-command-generator.js

@@ -2,6 +2,7 @@ import * as t from '@babel/types';
 import { toKebabCase } from 'komoji';
 import { generateCode } from '../babel-ast';
 import { getGeneratedFileHeader, getPrimaryKeyInfo, getScalarFields, getTableNames, ucFirst, } from '../utils';
+import { getCreateInputTypeName } from '../utils';
 function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false) {
     const specifiers = namedImports.map((name) => t.importSpecifier(t.identifier(name), t.identifier(name)));
     const decl = t.importDeclaration(specifiers, t.stringLiteral(moduleSpecifier));
@@ -147,7 +148,46 @@ function buildGetHandler(table, targetName) {
         t.tryStatement(t.blockStatement(tryBody), buildErrorCatch('Record not found.')),
     ]), false, true);
 }
-function buildMutationHandler(table, operation, targetName) {
+/**
+ * Get the set of field names that have defaults in the create input type.
+ * Looks up the CreateXInput -> inner input type (e.g. DatabaseInput) in the
+ * TypeRegistry and checks each field's defaultValue from introspection.
+ */
+function getFieldsWithDefaults(table, typeRegistry) {
+    const fieldsWithDefaults = new Set();
+    if (!typeRegistry)
+        return fieldsWithDefaults;
+    // Look up the CreateXInput type (e.g. CreateDatabaseInput)
+    const createInputTypeName = getCreateInputTypeName(table);
+    const createInputType = typeRegistry.get(createInputTypeName);
+    if (!createInputType?.inputFields)
+        return fieldsWithDefaults;
+    // The CreateXInput has an inner field (e.g. "database" of type DatabaseInput)
+    // Find the inner input type that contains the actual field definitions
+    for (const inputField of createInputType.inputFields) {
+        // The inner field's type name is the actual input type (e.g. DatabaseInput)
+        const innerTypeName = inputField.type.name
+            || inputField.type.ofType?.name
+            || inputField.type.ofType?.ofType?.name;
+        if (!innerTypeName)
+            continue;
+        const innerType = typeRegistry.get(innerTypeName);
+        if (!innerType?.inputFields)
+            continue;
+        // Check each field in the inner input type for defaultValue
+        for (const field of innerType.inputFields) {
+            if (field.defaultValue !== undefined) {
+                fieldsWithDefaults.add(field.name);
+            }
+            // Also check if the field is NOT wrapped in NON_NULL (nullable = has default or is optional)
+            if (field.type.kind !== 'NON_NULL') {
+                fieldsWithDefaults.add(field.name);
+            }
+        }
+    }
+    return fieldsWithDefaults;
+}
+function buildMutationHandler(table, operation, targetName, typeRegistry) {
     const { singularName } = getTableNames(table);
     const pkFields = getPrimaryKeyInfo(table);
     const pk = pkFields[0];
@@ -155,6 +195,8 @@ function buildMutationHandler(table, operation, targetName) {
         f.name !== 'nodeId' &&
         f.name !== 'createdAt' &&
         f.name !== 'updatedAt');
+    // Get fields that have defaults from introspection (for create operations)
+    const fieldsWithDefaults = getFieldsWithDefaults(table, typeRegistry);
     const questions = [];
     if (operation === 'update' || operation === 'delete') {
         questions.push(t.objectExpression([
@@ -166,11 +208,14 @@ function buildMutationHandler(table, operation, targetName) {
     }
     if (operation !== 'delete') {
         for (const field of editableFields) {
+            // For create: field is required only if it has no default value
+            // For update: all fields are optional (user only updates what they want)
+            const isRequired = operation === 'create' && !fieldsWithDefaults.has(field.name);
             questions.push(t.objectExpression([
                 t.objectProperty(t.identifier('type'), t.stringLiteral('text')),
                 t.objectProperty(t.identifier('name'), t.stringLiteral(field.name)),
                 t.objectProperty(t.identifier('message'), t.stringLiteral(field.name)),
-                t.objectProperty(t.identifier('required'), t.booleanLiteral(operation === 'create')),
+                t.objectProperty(t.identifier('required'), t.booleanLiteral(isRequired)),
             ]));
         }
     }
@@ -329,9 +374,9 @@ export function generateTableCommand(table, options) {
     const tn = options?.targetName;
     statements.push(buildListHandler(table, tn));
     statements.push(buildGetHandler(table, tn));
-    statements.push(buildMutationHandler(table, 'create', tn));
-    statements.push(buildMutationHandler(table, 'update', tn));
-    statements.push(buildMutationHandler(table, 'delete', tn));
+    statements.push(buildMutationHandler(table, 'create', tn, options?.typeRegistry));
+    statements.push(buildMutationHandler(table, 'update', tn, options?.typeRegistry));
+    statements.push(buildMutationHandler(table, 'delete', tn, options?.typeRegistry));
     const header = getGeneratedFileHeader(`CLI commands for ${table.name}`);
     const code = generateCode(statements);
     return {

package/esm/core/codegen/cli/utils-generator.d.ts

@@ -8,3 +8,11 @@ import type { GeneratedFile } from './executor-generator';
  * and mutation input parsing.
  */
 export declare function generateUtilsFile(): GeneratedFile;
+/**
+ * Generate a node-fetch.ts file with NodeHttpAdapter for CLI.
+ *
+ * Provides a GraphQLAdapter implementation using node:http/node:https
+ * instead of the Fetch API. This cleanly handles *.localhost subdomain
+ * routing (DNS resolution + Host header) without any global patching.
+ */
+export declare function generateNodeFetchFile(): GeneratedFile;

package/esm/core/codegen/cli/utils-generator.js

@@ -40,3 +40,16 @@ export function generateUtilsFile() {
         content: readTemplateFile('cli-utils.ts', 'CLI utility functions for type coercion and input handling'),
     };
 }
+/**
+ * Generate a node-fetch.ts file with NodeHttpAdapter for CLI.
+ *
+ * Provides a GraphQLAdapter implementation using node:http/node:https
+ * instead of the Fetch API. This cleanly handles *.localhost subdomain
+ * routing (DNS resolution + Host header) without any global patching.
+ */
+export function generateNodeFetchFile() {
+    return {
+        fileName: 'node-fetch.ts',
+        content: readTemplateFile('node-fetch.ts', 'Node HTTP adapter for localhost subdomain routing'),
+    };
+}

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

@@ -25,4 +25,6 @@ export declare function generateSelectTypesFile(): GeneratedClientFile;
 /**
  * Generate the main index.ts with createClient factory
  */
-export declare function generateCreateClientFile(tables: CleanTable[], hasCustomQueries: boolean, hasCustomMutations: boolean): GeneratedClientFile;
+export declare function generateCreateClientFile(tables: CleanTable[], hasCustomQueries: boolean, hasCustomMutations: boolean, options?: {
+    nodeHttpAdapter?: boolean;
+}): GeneratedClientFile;

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

@@ -75,7 +75,7 @@ function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false
 /**
  * Generate the main index.ts with createClient factory
  */
-export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations) {
+export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations, options) {
     const statements = [];
     // Add imports
     // Import OrmClient (value) and OrmClientConfig (type) separately
@@ -117,6 +117,12 @@ export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMuta
     statements.push(t.exportAllDeclaration(t.stringLiteral('./select-types')));
     // 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(t.exportNamedDeclaration(null, [

package/esm/core/codegen/orm/index.js

@@ -87,7 +87,7 @@ export function generateOrm(options) {
     const typesBarrel = generateTypesBarrel(useSharedTypes);
     files.push({ path: typesBarrel.fileName, content: typesBarrel.content });
     // 7. Generate main index.ts with createClient
-    const indexFile = generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations);
+    const indexFile = generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations, { nodeHttpAdapter: !!options.config.nodeHttpAdapter });
     files.push({ path: indexFile.fileName, content: indexFile.content });
     return {
         files,

package/esm/core/generate.js

@@ -34,6 +34,9 @@ export async function generate(options = {}, internalOptions) {
     const runReactQuery = config.reactQuery ?? false;
     const runCli = internalOptions?.skipCli ? false : !!config.cli;
     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,
@@ -167,13 +170,22 @@ export async function generate(options = {}, internalOptions) {
                 mutations: customOperations.mutations,
                 typeRegistry: customOperations.typeRegistry,
             },
-            config,
+            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
             sharedTypesPath: bothEnabled ? '..' : undefined,
         });
         filesToWrite.push(...files.map((file) => ({
             ...file,
             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
     if (runCli) {
@@ -184,7 +196,7 @@ export async function generate(options = {}, internalOptions) {
                 queries: customOperations.queries,
                 mutations: customOperations.mutations,
             },
-            config,
+            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
         });
         filesToWrite.push(...files.map((file) => ({
             path: path.posix.join('cli', file.fileName),
@@ -510,10 +522,16 @@ export async function generateMulti(options) {
         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) => ({
                 path: path.posix.join('cli', file.fileName),

package/esm/types/config.d.ts

@@ -278,6 +278,24 @@ export interface GraphQLSDKConfigTarget {
      * @default false
      */
     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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -56,24 +56,24 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.28.6",
     "@babel/types": "^7.28.6",
-    "@constructive-io/graphql-types": "^3.0.0",
+    "@constructive-io/graphql-types": "^3.1.0",
     "@inquirerer/utils": "^3.2.3",
-    "@pgpmjs/core": "^6.1.0",
+    "@pgpmjs/core": "^6.2.0",
     "ajv": "^8.17.1",
     "deepmerge": "^4.3.1",
     "find-and-require-package-json": "^0.9.0",
-    "gql-ast": "^3.0.0",
-    "graphile-schema": "^1.1.1",
+    "gql-ast": "^3.1.0",
+    "graphile-schema": "^1.2.0",
     "graphql": "^16.9.0",
     "inflekt": "^0.3.1",
     "inquirerer": "^4.4.0",
     "jiti": "^2.6.1",
     "komoji": "^0.8.0",
     "oxfmt": "^0.26.0",
-    "pg-cache": "^3.0.0",
-    "pg-env": "^1.4.0",
-    "pgsql-client": "^3.1.0",
-    "pgsql-seed": "^2.1.0",
+    "pg-cache": "^3.1.0",
+    "pg-env": "^1.5.0",
+    "pgsql-client": "^3.2.0",
+    "pgsql-seed": "^2.2.0",
     "undici": "^7.19.0"
   },
   "peerDependencies": {
@@ -100,5 +100,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "b4e199d40e7495f25bafb6e8d318e731bd19b32c"
+  "gitHead": "b758178b808ce0bf451e86c0bd7e92079155db7c"
 }

package/types/config.d.ts

@@ -278,6 +278,24 @@ export interface GraphQLSDKConfigTarget {
      * @default false
      */
     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