@constructive-io/graphql-codegen 4.2.0 → 4.4.0

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,17 @@ 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,
+                entryPoint: cliConfig.entryPoint,
             });
             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,17 @@ 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;
+    /** Generate a runnable index.ts entry point */
+    entryPoint?: boolean;
 }
 export declare function resolveBuiltinNames(targetNames: string[], userOverrides?: BuiltinNames): {
     auth: string;
@@ -50,5 +58,5 @@ export { generateReadme, generateAgentsDocs, getCliMcpTools, generateSkills, gen
 export type { MultiTargetDocsInput } from './docs-generator';
 export { resolveDocsConfig } from '../docs-utils';
 export type { GeneratedDocFile, McpTool } from '../docs-utils';
-export { generateUtilsFile } from './utils-generator';
+export { generateUtilsFile, generateEntryPointFile } from './utils-generator';
 export type { GeneratedFile, MultiTargetExecutorInput } from './executor-generator';

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, generateEntryPointFile } 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 = [
@@ -33,6 +43,11 @@ export function generateCli(options) {
     }
     const commandMapFile = generateCommandMap(tables, allCustomOps, toolName);
     files.push(commandMapFile);
+    // Generate entry point if configured
+    const generateEntryPoint = typeof cliConfig === 'object' && !!cliConfig.entryPoint;
+    if (generateEntryPoint) {
+        files.push(generateEntryPointFile());
+    }
     return {
         files,
         stats: {
@@ -65,10 +80,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 +107,7 @@ export function generateMultiTargetCli(options) {
             const tableFile = generateTableCommand(table, {
                 targetName: target.name,
                 executorImportPath: '../../executor',
+                typeRegistry: target.typeRegistry,
             });
             files.push(tableFile);
         }
@@ -113,6 +135,10 @@ export function generateMultiTargetCli(options) {
         targets: commandMapTargets,
     });
     files.push(commandMapFile);
+    // Generate entry point if configured
+    if (options.entryPoint) {
+        files.push(generateEntryPointFile());
+    }
     return {
         files,
         stats: {
@@ -131,4 +157,4 @@ export { generateCommandMap, generateMultiTargetCommandMap } from './command-map
 export { generateContextCommand, generateAuthCommand, generateMultiTargetContextCommand, generateAuthCommandWithName, } from './infra-generator';
 export { generateReadme, generateAgentsDocs, getCliMcpTools, generateSkills, generateMultiTargetReadme, generateMultiTargetAgentsDocs, getMultiTargetCliMcpTools, generateMultiTargetSkills, } from './docs-generator';
 export { resolveDocsConfig } from '../docs-utils';
-export { generateUtilsFile } from './utils-generator';
+export { generateUtilsFile, generateEntryPointFile } from './utils-generator';

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,20 @@ 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;
+/**
+ * Generate an index.ts entry point file for the CLI.
+ *
+ * Creates a runnable entry point that imports the command map,
+ * handles --version and --tty flags, and starts the CLI.
+ * This is off by default (cliEntryPoint: false) since many projects
+ * provide their own entry point with custom configuration.
+ */
+export declare function generateEntryPointFile(): GeneratedFile;

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

@@ -40,3 +40,30 @@ 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'),
+    };
+}
+/**
+ * Generate an index.ts entry point file for the CLI.
+ *
+ * Creates a runnable entry point that imports the command map,
+ * handles --version and --tty flags, and starts the CLI.
+ * This is off by default (cliEntryPoint: false) since many projects
+ * provide their own entry point with custom configuration.
+ */
+export function generateEntryPointFile() {
+    return {
+        fileName: 'index.ts',
+        content: readTemplateFile('cli-entry.ts', 'CLI entry point'),
+    };
+}

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;