@constructive-io/graphql-codegen 4.2.0 → 4.4.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,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/core/codegen/cli/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateUtilsFile = exports.resolveDocsConfig = exports.generateMultiTargetSkills = exports.getMultiTargetCliMcpTools = exports.generateMultiTargetAgentsDocs = exports.generateMultiTargetReadme = exports.generateSkills = exports.getCliMcpTools = exports.generateAgentsDocs = exports.generateReadme = exports.generateAuthCommandWithName = exports.generateMultiTargetContextCommand = exports.generateAuthCommand = exports.generateContextCommand = exports.generateMultiTargetCommandMap = exports.generateCommandMap = exports.generateCustomCommand = exports.generateTableCommand = exports.generateMultiTargetExecutorFile = exports.generateExecutorFile = void 0;
+exports.generateEntryPointFile = exports.generateUtilsFile = exports.resolveDocsConfig = exports.generateMultiTargetSkills = exports.getMultiTargetCliMcpTools = exports.generateMultiTargetAgentsDocs = exports.generateMultiTargetReadme = exports.generateSkills = exports.getCliMcpTools = exports.generateAgentsDocs = exports.generateReadme = exports.generateAuthCommandWithName = exports.generateMultiTargetContextCommand = exports.generateAuthCommand = exports.generateContextCommand = exports.generateMultiTargetCommandMap = exports.generateCommandMap = exports.generateCustomCommand = exports.generateTableCommand = exports.generateMultiTargetExecutorFile = exports.generateExecutorFile = void 0;
 exports.generateCli = generateCli;
 exports.resolveBuiltinNames = resolveBuiltinNames;
 exports.generateMultiTargetCli = generateMultiTargetCli;
@@ -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 = [
@@ -39,6 +49,11 @@ function generateCli(options) {
     }
     const commandMapFile = (0, command_map_generator_1.generateCommandMap)(tables, allCustomOps, toolName);
     files.push(commandMapFile);
+    // Generate entry point if configured
+    const generateEntryPoint = typeof cliConfig === 'object' && !!cliConfig.entryPoint;
+    if (generateEntryPoint) {
+        files.push((0, utils_generator_1.generateEntryPointFile)());
+    }
     return {
         files,
         stats: {
@@ -71,10 +86,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 +113,7 @@ function generateMultiTargetCli(options) {
             const tableFile = (0, table_command_generator_1.generateTableCommand)(table, {
                 targetName: target.name,
                 executorImportPath: '../../executor',
+                typeRegistry: target.typeRegistry,
             });
             files.push(tableFile);
         }
@@ -119,6 +141,10 @@ function generateMultiTargetCli(options) {
         targets: commandMapTargets,
     });
     files.push(commandMapFile);
+    // Generate entry point if configured
+    if (options.entryPoint) {
+        files.push((0, utils_generator_1.generateEntryPointFile)());
+    }
     return {
         files,
         stats: {
@@ -158,3 +184,4 @@ var docs_utils_1 = require("../docs-utils");
 Object.defineProperty(exports, "resolveDocsConfig", { enumerable: true, get: function () { return docs_utils_1.resolveDocsConfig; } });
 var utils_generator_2 = require("./utils-generator");
 Object.defineProperty(exports, "generateUtilsFile", { enumerable: true, get: function () { return utils_generator_2.generateUtilsFile; } });
+Object.defineProperty(exports, "generateEntryPointFile", { enumerable: true, get: function () { return utils_generator_2.generateEntryPointFile; } });

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,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/core/codegen/cli/utils-generator.js

@@ -34,6 +34,8 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateUtilsFile = generateUtilsFile;
+exports.generateNodeFetchFile = generateNodeFetchFile;
+exports.generateEntryPointFile = generateEntryPointFile;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const utils_1 = require("../utils");
@@ -76,3 +78,30 @@ 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'),
+    };
+}
+/**
+ * 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.
+ */
+function generateEntryPointFile() {
+    return {
+        fileName: 'index.ts',
+        content: readTemplateFile('cli-entry.ts', 'CLI entry point'),
+    };
+}

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/cli-entry.ts

@@ -0,0 +1,33 @@
+/**
+ * CLI entry point for running the generated CLI application.
+ *
+ * Creates an inquirerer CLI instance with the generated command map,
+ * handles --version and --tty flags, and runs the CLI.
+ *
+ * NOTE: This file is read at codegen time and written to output.
+ * Any changes here will affect all generated CLI entry points.
+ */
+
+import { CLI, CLIOptions, getPackageJson } from 'inquirerer';
+import { commands } from './commands';
+
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  const pkg = getPackageJson(__dirname);
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+// Check for --tty false to enable non-interactive mode (noTty)
+const ttyIdx = process.argv.indexOf('--tty');
+const noTty = ttyIdx !== -1 && process.argv[ttyIdx + 1] === 'false';
+
+const options: Partial<CLIOptions> = {
+  noTty,
+  minimistOpts: { alias: { v: 'version', h: 'help' } },
+};
+
+const app = new CLI(commands, options);
+app.run().catch((e) => {
+  console.error('Unexpected error:', e);
+  process.exit(1);
+});