@constructive-io/graphql-codegen 2.27.2 → 2.27.3

package/cli/index.d.ts

@@ -1,4 +1,8 @@
+#!/usr/bin/env node
 /**
  * CLI entry point for graphql-codegen
  */
-export {};
+import { CLIOptions, Inquirerer } from 'inquirerer';
+import { ParsedArgs } from 'minimist';
+export declare const commands: (argv: Partial<ParsedArgs>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<ParsedArgs>>;
+export declare const options: Partial<CLIOptions>;

package/cli/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 "use strict";
 /**
  * CLI entry point for graphql-codegen
@@ -36,12 +37,104 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
+exports.options = exports.commands = void 0;
+const find_and_require_package_json_1 = require("find-and-require-package-json");
+const utils_1 = require("@inquirerer/utils");
+const inquirerer_1 = require("inquirerer");
 const init_1 = require("./commands/init");
 const generate_1 = require("./commands/generate");
 const generate_orm_1 = require("./commands/generate-orm");
 const watch_1 = require("./watch");
 const config_1 = require("../types/config");
+const usageText = `
+graphql-codegen - CLI for generating GraphQL SDK from PostGraphile endpoints or schema files
+
+Usage:
+  graphql-codegen <command> [options]
+
+Commands:
+  init           Initialize a new graphql-codegen configuration file
+  generate       Generate SDK from GraphQL endpoint or schema file
+  generate-orm   Generate Prisma-like ORM client from GraphQL endpoint or schema file
+  introspect     Introspect a GraphQL endpoint or schema file and print table info
+
+Options:
+  --help, -h     Show this help message
+  --version, -v  Show version number
+
+Run 'graphql-codegen <command> --help' for more information on a command.
+`;
+const initUsageText = `
+graphql-codegen init - Initialize a new graphql-codegen configuration file
+
+Usage:
+  graphql-codegen init [options]
+
+Options:
+  --directory, -d <dir>   Target directory for the config file (default: .)
+  --force, -f             Force overwrite existing config
+  --endpoint, -e <url>    GraphQL endpoint URL to pre-populate
+  --output, -o <dir>      Output directory to pre-populate (default: ./generated)
+  --help, -h              Show this help message
+`;
+const generateUsageText = `
+graphql-codegen generate - Generate SDK from GraphQL endpoint or schema file
+
+Usage:
+  graphql-codegen generate [options]
+
+Options:
+  --config, -c <path>         Path to config file
+  --target, -t <name>         Target name in config file
+  --endpoint, -e <url>        GraphQL endpoint URL (overrides config)
+  --schema, -s <path>         Path to GraphQL schema file (.graphql)
+  --output, -o <dir>          Output directory (overrides config)
+  --authorization, -a <header> Authorization header value
+  --verbose, -v               Verbose output
+  --dry-run                   Dry run - show what would be generated without writing files
+  --watch, -w                 Watch mode - poll endpoint for schema changes (in-memory)
+  --poll-interval <ms>        Polling interval in milliseconds (default: 3000)
+  --debounce <ms>             Debounce delay before regenerating (default: 800)
+  --touch <file>              File to touch on schema change
+  --no-clear                  Do not clear terminal on regeneration
+  --help, -h                  Show this help message
+`;
+const generateOrmUsageText = `
+graphql-codegen generate-orm - Generate Prisma-like ORM client from GraphQL endpoint or schema file
+
+Usage:
+  graphql-codegen generate-orm [options]
+
+Options:
+  --config, -c <path>         Path to config file
+  --target, -t <name>         Target name in config file
+  --endpoint, -e <url>        GraphQL endpoint URL (overrides config)
+  --schema, -s <path>         Path to GraphQL schema file (.graphql)
+  --output, -o <dir>          Output directory (overrides config)
+  --authorization, -a <header> Authorization header value
+  --verbose, -v               Verbose output
+  --dry-run                   Dry run - show what would be generated without writing files
+  --skip-custom-operations    Skip custom operations (only generate table CRUD)
+  --watch, -w                 Watch mode - poll endpoint for schema changes (in-memory)
+  --poll-interval <ms>        Polling interval in milliseconds (default: 3000)
+  --debounce <ms>             Debounce delay before regenerating (default: 800)
+  --touch <file>              File to touch on schema change
+  --no-clear                  Do not clear terminal on regeneration
+  --help, -h                  Show this help message
+`;
+const introspectUsageText = `
+graphql-codegen introspect - Introspect a GraphQL endpoint or schema file and print table info
+
+Usage:
+  graphql-codegen introspect [options]
+
+Options:
+  --endpoint, -e <url>        GraphQL endpoint URL
+  --schema, -s <path>         Path to GraphQL schema file (.graphql)
+  --authorization, -a <header> Authorization header value
+  --json                      Output as JSON
+  --help, -h                  Show this help message
+`;
 /**
  * Format duration in a human-readable way
  * - Under 1 second: show milliseconds (e.g., "123ms")
@@ -53,12 +146,10 @@ function formatDuration(ms) {
     }
     return `${(ms / 1000).toFixed(2)}s`;
 }
-const program = new commander_1.Command();
 /**
  * Load configuration for watch mode, merging CLI options with config file
  */
 async function loadWatchConfig(options) {
-    // Find config file
     let configPath = options.config;
     if (!configPath) {
         configPath = (0, init_1.findConfigFile)() ?? undefined;
@@ -122,25 +213,20 @@ async function loadWatchConfig(options) {
     }
     return (0, config_1.resolveConfig)(mergedTarget);
 }
-program
-    .name('graphql-codegen')
-    .description('CLI for generating GraphQL SDK from PostGraphile endpoints or schema files')
-    .version('2.17.48');
-// Init command
-program
-    .command('init')
-    .description('Initialize a new graphql-codegen configuration file')
-    .option('-d, --directory <dir>', 'Target directory for the config file', '.')
-    .option('-f, --force', 'Force overwrite existing config', false)
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL to pre-populate')
-    .option('-o, --output <dir>', 'Output directory to pre-populate', './generated')
-    .action(async (options) => {
+/**
+ * Init command handler
+ */
+async function handleInit(argv) {
+    if (argv.help || argv.h) {
+        console.log(initUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
     const result = await (0, init_1.initCommand)({
-        directory: options.directory,
-        force: options.force,
-        endpoint: options.endpoint,
-        output: options.output,
+        directory: argv.directory || argv.d || '.',
+        force: !!(argv.force || argv.f),
+        endpoint: argv.endpoint || argv.e,
+        output: argv.output || argv.o || './generated',
     });
     const duration = formatDuration(performance.now() - startTime);
     if (result.success) {
@@ -150,62 +236,75 @@ program
         console.error('x', result.message, `(${duration})`);
         process.exit(1);
     }
-});
-// Generate command
-program
-    .command('generate')
-    .description('Generate SDK from GraphQL endpoint or schema file')
-    .option('-c, --config <path>', 'Path to config file')
-    .option('-t, --target <name>', 'Target name in config file')
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL (overrides config)')
-    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
-    .option('-o, --output <dir>', 'Output directory (overrides config)')
-    .option('-a, --authorization <header>', 'Authorization header value')
-    .option('-v, --verbose', 'Verbose output', false)
-    .option('--dry-run', 'Dry run - show what would be generated without writing files', false)
-    .option('-w, --watch', 'Watch mode - poll endpoint for schema changes (in-memory)', false)
-    .option('--poll-interval <ms>', 'Polling interval in milliseconds (default: 3000)', parseInt)
-    .option('--debounce <ms>', 'Debounce delay before regenerating (default: 800)', parseInt)
-    .option('--touch <file>', 'File to touch on schema change')
-    .option('--no-clear', 'Do not clear terminal on regeneration')
-    .action(async (options) => {
+}
+/**
+ * Generate command handler
+ */
+async function handleGenerate(argv) {
+    if (argv.help || argv.h) {
+        console.log(generateUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
-    // Validate source options
-    if (options.endpoint && options.schema) {
+    const config = argv.config || argv.c;
+    const target = argv.target || argv.t;
+    const endpoint = argv.endpoint || argv.e;
+    const schema = argv.schema || argv.s;
+    const output = argv.output || argv.o;
+    const authorization = argv.authorization || argv.a;
+    const verbose = !!(argv.verbose || argv.v);
+    const dryRun = !!(argv['dry-run'] || argv.dryRun);
+    const watch = !!(argv.watch || argv.w);
+    const pollInterval = argv['poll-interval'] !== undefined
+        ? parseInt(argv['poll-interval'], 10)
+        : undefined;
+    const debounce = argv.debounce !== undefined
+        ? parseInt(argv.debounce, 10)
+        : undefined;
+    const touch = argv.touch;
+    const clear = argv.clear !== false;
+    if (endpoint && schema) {
         console.error('x Cannot use both --endpoint and --schema. Choose one source.');
         process.exit(1);
     }
-    // Watch mode (only for endpoint)
-    if (options.watch) {
-        if (options.schema) {
+    if (watch) {
+        if (schema) {
             console.error('x Watch mode is only supported with --endpoint, not --schema.');
             process.exit(1);
         }
-        const config = await loadWatchConfig(options);
-        if (!config) {
+        const watchConfig = await loadWatchConfig({
+            config,
+            target,
+            endpoint,
+            output,
+            pollInterval,
+            debounce,
+            touch,
+            clear,
+        });
+        if (!watchConfig) {
             process.exit(1);
         }
         await (0, watch_1.startWatch)({
-            config,
+            config: watchConfig,
             generatorType: 'generate',
-            verbose: options.verbose,
-            authorization: options.authorization,
-            configPath: options.config,
-            target: options.target,
-            outputDir: options.output,
+            verbose,
+            authorization,
+            configPath: config,
+            target,
+            outputDir: output,
         });
         return;
     }
-    // Normal one-shot generation
     const result = await (0, generate_1.generateCommand)({
-        config: options.config,
-        target: options.target,
-        endpoint: options.endpoint,
-        schema: options.schema,
-        output: options.output,
-        authorization: options.authorization,
-        verbose: options.verbose,
-        dryRun: options.dryRun,
+        config,
+        target,
+        endpoint,
+        schema,
+        output,
+        authorization,
+        verbose,
+        dryRun,
     });
     const duration = formatDuration(performance.now() - startTime);
     const targetResults = result.targets ?? [];
@@ -213,19 +312,19 @@ program
         (targetResults.length > 1 || targetResults[0]?.name !== 'default');
     if (hasNamedTargets) {
         console.log(result.success ? '[ok]' : 'x', result.message);
-        targetResults.forEach((target) => {
-            const status = target.success ? '[ok]' : 'x';
-            console.log(`\n${status} ${target.message}`);
-            if (target.tables && target.tables.length > 0) {
+        targetResults.forEach((t) => {
+            const status = t.success ? '[ok]' : 'x';
+            console.log(`\n${status} ${t.message}`);
+            if (t.tables && t.tables.length > 0) {
                 console.log('  Tables:');
-                target.tables.forEach((table) => console.log(`    - ${table}`));
+                t.tables.forEach((table) => console.log(`    - ${table}`));
             }
-            if (target.filesWritten && target.filesWritten.length > 0) {
+            if (t.filesWritten && t.filesWritten.length > 0) {
                 console.log('  Files written:');
-                target.filesWritten.forEach((file) => console.log(`    - ${file}`));
+                t.filesWritten.forEach((file) => console.log(`    - ${file}`));
             }
-            if (!target.success && target.errors) {
-                target.errors.forEach((error) => console.error(`  - ${error}`));
+            if (!t.success && t.errors) {
+                t.errors.forEach((error) => console.error(`  - ${error}`));
             }
         });
         if (!result.success) {
@@ -251,65 +350,78 @@ program
         }
         process.exit(1);
     }
-});
-// Generate ORM command
-program
-    .command('generate-orm')
-    .description('Generate Prisma-like ORM client from GraphQL endpoint or schema file')
-    .option('-c, --config <path>', 'Path to config file')
-    .option('-t, --target <name>', 'Target name in config file')
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL (overrides config)')
-    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
-    .option('-o, --output <dir>', 'Output directory (overrides config)')
-    .option('-a, --authorization <header>', 'Authorization header value')
-    .option('-v, --verbose', 'Verbose output', false)
-    .option('--dry-run', 'Dry run - show what would be generated without writing files', false)
-    .option('--skip-custom-operations', 'Skip custom operations (only generate table CRUD)', false)
-    .option('-w, --watch', 'Watch mode - poll endpoint for schema changes (in-memory)', false)
-    .option('--poll-interval <ms>', 'Polling interval in milliseconds (default: 3000)', parseInt)
-    .option('--debounce <ms>', 'Debounce delay before regenerating (default: 800)', parseInt)
-    .option('--touch <file>', 'File to touch on schema change')
-    .option('--no-clear', 'Do not clear terminal on regeneration')
-    .action(async (options) => {
+}
+/**
+ * Generate ORM command handler
+ */
+async function handleGenerateOrm(argv) {
+    if (argv.help || argv.h) {
+        console.log(generateOrmUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
-    // Validate source options
-    if (options.endpoint && options.schema) {
+    const config = argv.config || argv.c;
+    const target = argv.target || argv.t;
+    const endpoint = argv.endpoint || argv.e;
+    const schema = argv.schema || argv.s;
+    const output = argv.output || argv.o;
+    const authorization = argv.authorization || argv.a;
+    const verbose = !!(argv.verbose || argv.v);
+    const dryRun = !!(argv['dry-run'] || argv.dryRun);
+    const skipCustomOperations = !!(argv['skip-custom-operations'] || argv.skipCustomOperations);
+    const watch = !!(argv.watch || argv.w);
+    const pollInterval = argv['poll-interval'] !== undefined
+        ? parseInt(argv['poll-interval'], 10)
+        : undefined;
+    const debounce = argv.debounce !== undefined
+        ? parseInt(argv.debounce, 10)
+        : undefined;
+    const touch = argv.touch;
+    const clear = argv.clear !== false;
+    if (endpoint && schema) {
         console.error('x Cannot use both --endpoint and --schema. Choose one source.');
         process.exit(1);
     }
-    // Watch mode (only for endpoint)
-    if (options.watch) {
-        if (options.schema) {
+    if (watch) {
+        if (schema) {
             console.error('x Watch mode is only supported with --endpoint, not --schema.');
             process.exit(1);
         }
-        const config = await loadWatchConfig(options);
-        if (!config) {
+        const watchConfig = await loadWatchConfig({
+            config,
+            target,
+            endpoint,
+            output,
+            pollInterval,
+            debounce,
+            touch,
+            clear,
+        });
+        if (!watchConfig) {
             process.exit(1);
         }
         await (0, watch_1.startWatch)({
-            config,
+            config: watchConfig,
             generatorType: 'generate-orm',
-            verbose: options.verbose,
-            authorization: options.authorization,
-            configPath: options.config,
-            target: options.target,
-            outputDir: options.output,
-            skipCustomOperations: options.skipCustomOperations,
+            verbose,
+            authorization,
+            configPath: config,
+            target,
+            outputDir: output,
+            skipCustomOperations,
         });
         return;
     }
-    // Normal one-shot generation
     const result = await (0, generate_orm_1.generateOrmCommand)({
-        config: options.config,
-        target: options.target,
-        endpoint: options.endpoint,
-        schema: options.schema,
-        output: options.output,
-        authorization: options.authorization,
-        verbose: options.verbose,
-        dryRun: options.dryRun,
-        skipCustomOperations: options.skipCustomOperations,
+        config,
+        target,
+        endpoint,
+        schema,
+        output,
+        authorization,
+        verbose,
+        dryRun,
+        skipCustomOperations,
     });
     const duration = formatDuration(performance.now() - startTime);
     const targetResults = result.targets ?? [];
@@ -317,27 +429,27 @@ program
         (targetResults.length > 1 || targetResults[0]?.name !== 'default');
     if (hasNamedTargets) {
         console.log(result.success ? '[ok]' : 'x', result.message);
-        targetResults.forEach((target) => {
-            const status = target.success ? '[ok]' : 'x';
-            console.log(`\n${status} ${target.message}`);
-            if (target.tables && target.tables.length > 0) {
+        targetResults.forEach((t) => {
+            const status = t.success ? '[ok]' : 'x';
+            console.log(`\n${status} ${t.message}`);
+            if (t.tables && t.tables.length > 0) {
                 console.log('  Tables:');
-                target.tables.forEach((table) => console.log(`    - ${table}`));
+                t.tables.forEach((table) => console.log(`    - ${table}`));
             }
-            if (target.customQueries && target.customQueries.length > 0) {
+            if (t.customQueries && t.customQueries.length > 0) {
                 console.log('  Custom Queries:');
-                target.customQueries.forEach((query) => console.log(`    - ${query}`));
+                t.customQueries.forEach((query) => console.log(`    - ${query}`));
             }
-            if (target.customMutations && target.customMutations.length > 0) {
+            if (t.customMutations && t.customMutations.length > 0) {
                 console.log('  Custom Mutations:');
-                target.customMutations.forEach((mutation) => console.log(`    - ${mutation}`));
+                t.customMutations.forEach((mutation) => console.log(`    - ${mutation}`));
             }
-            if (target.filesWritten && target.filesWritten.length > 0) {
+            if (t.filesWritten && t.filesWritten.length > 0) {
                 console.log('  Files written:');
-                target.filesWritten.forEach((file) => console.log(`    - ${file}`));
+                t.filesWritten.forEach((file) => console.log(`    - ${file}`));
             }
-            if (!target.success && target.errors) {
-                target.errors.forEach((error) => console.error(`  - ${error}`));
+            if (!t.success && t.errors) {
+                t.errors.forEach((error) => console.error(`  - ${error}`));
             }
         });
         if (!result.success) {
@@ -371,23 +483,25 @@ program
         }
         process.exit(1);
     }
-});
-// Introspect command (for debugging) - uses the new inference system
-program
-    .command('introspect')
-    .description('Introspect a GraphQL endpoint or schema file and print table info')
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL')
-    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
-    .option('-a, --authorization <header>', 'Authorization header value')
-    .option('--json', 'Output as JSON', false)
-    .action(async (options) => {
+}
+/**
+ * Introspect command handler
+ */
+async function handleIntrospect(argv) {
+    if (argv.help || argv.h) {
+        console.log(introspectUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
-    // Validate source options
-    if (!options.endpoint && !options.schema) {
+    const endpoint = argv.endpoint || argv.e;
+    const schema = argv.schema || argv.s;
+    const authorization = argv.authorization || argv.a;
+    const json = !!argv.json;
+    if (!endpoint && !schema) {
         console.error('x Either --endpoint or --schema must be provided.');
         process.exit(1);
     }
-    if (options.endpoint && options.schema) {
+    if (endpoint && schema) {
         console.error('x Cannot use both --endpoint and --schema. Choose one source.');
         process.exit(1);
     }
@@ -395,15 +509,15 @@ program
     const { inferTablesFromIntrospection } = await Promise.resolve().then(() => __importStar(require('./introspect/infer-tables')));
     try {
         const source = createSchemaSource({
-            endpoint: options.endpoint,
-            schema: options.schema,
-            authorization: options.authorization,
+            endpoint,
+            schema,
+            authorization,
         });
         console.log('Fetching schema from', source.describe(), '...');
         const { introspection } = await source.fetch();
         const tables = inferTablesFromIntrospection(introspection);
         const duration = formatDuration(performance.now() - startTime);
-        if (options.json) {
+        if (json) {
             console.log(JSON.stringify(tables, null, 2));
         }
         else {
@@ -423,5 +537,90 @@ program
         console.error('x Failed to introspect schema:', err instanceof Error ? err.message : err, `(${duration})`);
         process.exit(1);
     }
-});
-program.parse();
+}
+const createCommandMap = () => {
+    return {
+        init: handleInit,
+        generate: handleGenerate,
+        'generate-orm': handleGenerateOrm,
+        introspect: handleIntrospect,
+    };
+};
+const commands = async (argv, prompter, _options) => {
+    if (argv.version || argv.v) {
+        const pkg = (0, find_and_require_package_json_1.findAndRequirePackageJson)(__dirname);
+        console.log(pkg.version);
+        process.exit(0);
+    }
+    const { first: command, newArgv } = (0, utils_1.extractFirst)(argv);
+    if ((argv.help || argv.h) && !command) {
+        console.log(usageText);
+        process.exit(0);
+    }
+    if (command === 'help') {
+        console.log(usageText);
+        process.exit(0);
+    }
+    const commandMap = createCommandMap();
+    if (!command) {
+        const answer = await prompter.prompt(argv, [
+            {
+                type: 'autocomplete',
+                name: 'command',
+                message: 'What do you want to do?',
+                options: Object.keys(commandMap),
+            },
+        ]);
+        const selectedCommand = answer.command;
+        const commandFn = commandMap[selectedCommand];
+        if (commandFn) {
+            await commandFn(newArgv);
+        }
+        prompter.close();
+        return argv;
+    }
+    const commandFn = commandMap[command];
+    if (!commandFn) {
+        console.log(usageText);
+        await (0, utils_1.cliExitWithError)(`Unknown command: ${command}`);
+    }
+    await commandFn(newArgv);
+    prompter.close();
+    return argv;
+};
+exports.commands = commands;
+exports.options = {
+    minimistOpts: {
+        alias: {
+            v: 'version',
+            h: 'help',
+            c: 'config',
+            t: 'target',
+            e: 'endpoint',
+            s: 'schema',
+            o: 'output',
+            a: 'authorization',
+            d: 'directory',
+            f: 'force',
+            w: 'watch',
+        },
+        boolean: ['help', 'version', 'force', 'verbose', 'dry-run', 'watch', 'json', 'skip-custom-operations', 'clear'],
+        string: ['config', 'target', 'endpoint', 'schema', 'output', 'authorization', 'directory', 'touch', 'poll-interval', 'debounce'],
+        default: {
+            clear: true,
+        },
+    },
+};
+if (require.main === module) {
+    if (process.argv.includes('--version') || process.argv.includes('-v')) {
+        const pkg = (0, find_and_require_package_json_1.findAndRequirePackageJson)(__dirname);
+        console.log(pkg.version);
+        process.exit(0);
+    }
+    const app = new inquirerer_1.CLI(exports.commands, exports.options);
+    app.run().then(() => {
+    }).catch((error) => {
+        console.error('Unexpected error:', error);
+        process.exit(1);
+    });
+}

package/esm/cli/index.d.ts

@@ -1,4 +1,8 @@
+#!/usr/bin/env node
 /**
  * CLI entry point for graphql-codegen
  */
-export {};
+import { CLIOptions, Inquirerer } from 'inquirerer';
+import { ParsedArgs } from 'minimist';
+export declare const commands: (argv: Partial<ParsedArgs>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<ParsedArgs>>;
+export declare const options: Partial<CLIOptions>;

package/esm/cli/index.js

@@ -1,12 +1,104 @@
+#!/usr/bin/env node
 /**
  * CLI entry point for graphql-codegen
  */
-import { Command } from 'commander';
+import { findAndRequirePackageJson } from 'find-and-require-package-json';
+import { cliExitWithError, extractFirst } from '@inquirerer/utils';
+import { CLI } from 'inquirerer';
 import { initCommand, findConfigFile, loadConfigFile } from './commands/init';
 import { generateCommand } from './commands/generate';
 import { generateOrmCommand } from './commands/generate-orm';
 import { startWatch } from './watch';
 import { isMultiConfig, mergeConfig, resolveConfig, } from '../types/config';
+const usageText = `
+graphql-codegen - CLI for generating GraphQL SDK from PostGraphile endpoints or schema files
+
+Usage:
+  graphql-codegen <command> [options]
+
+Commands:
+  init           Initialize a new graphql-codegen configuration file
+  generate       Generate SDK from GraphQL endpoint or schema file
+  generate-orm   Generate Prisma-like ORM client from GraphQL endpoint or schema file
+  introspect     Introspect a GraphQL endpoint or schema file and print table info
+
+Options:
+  --help, -h     Show this help message
+  --version, -v  Show version number
+
+Run 'graphql-codegen <command> --help' for more information on a command.
+`;
+const initUsageText = `
+graphql-codegen init - Initialize a new graphql-codegen configuration file
+
+Usage:
+  graphql-codegen init [options]
+
+Options:
+  --directory, -d <dir>   Target directory for the config file (default: .)
+  --force, -f             Force overwrite existing config
+  --endpoint, -e <url>    GraphQL endpoint URL to pre-populate
+  --output, -o <dir>      Output directory to pre-populate (default: ./generated)
+  --help, -h              Show this help message
+`;
+const generateUsageText = `
+graphql-codegen generate - Generate SDK from GraphQL endpoint or schema file
+
+Usage:
+  graphql-codegen generate [options]
+
+Options:
+  --config, -c <path>         Path to config file
+  --target, -t <name>         Target name in config file
+  --endpoint, -e <url>        GraphQL endpoint URL (overrides config)
+  --schema, -s <path>         Path to GraphQL schema file (.graphql)
+  --output, -o <dir>          Output directory (overrides config)
+  --authorization, -a <header> Authorization header value
+  --verbose, -v               Verbose output
+  --dry-run                   Dry run - show what would be generated without writing files
+  --watch, -w                 Watch mode - poll endpoint for schema changes (in-memory)
+  --poll-interval <ms>        Polling interval in milliseconds (default: 3000)
+  --debounce <ms>             Debounce delay before regenerating (default: 800)
+  --touch <file>              File to touch on schema change
+  --no-clear                  Do not clear terminal on regeneration
+  --help, -h                  Show this help message
+`;
+const generateOrmUsageText = `
+graphql-codegen generate-orm - Generate Prisma-like ORM client from GraphQL endpoint or schema file
+
+Usage:
+  graphql-codegen generate-orm [options]
+
+Options:
+  --config, -c <path>         Path to config file
+  --target, -t <name>         Target name in config file
+  --endpoint, -e <url>        GraphQL endpoint URL (overrides config)
+  --schema, -s <path>         Path to GraphQL schema file (.graphql)
+  --output, -o <dir>          Output directory (overrides config)
+  --authorization, -a <header> Authorization header value
+  --verbose, -v               Verbose output
+  --dry-run                   Dry run - show what would be generated without writing files
+  --skip-custom-operations    Skip custom operations (only generate table CRUD)
+  --watch, -w                 Watch mode - poll endpoint for schema changes (in-memory)
+  --poll-interval <ms>        Polling interval in milliseconds (default: 3000)
+  --debounce <ms>             Debounce delay before regenerating (default: 800)
+  --touch <file>              File to touch on schema change
+  --no-clear                  Do not clear terminal on regeneration
+  --help, -h                  Show this help message
+`;
+const introspectUsageText = `
+graphql-codegen introspect - Introspect a GraphQL endpoint or schema file and print table info
+
+Usage:
+  graphql-codegen introspect [options]
+
+Options:
+  --endpoint, -e <url>        GraphQL endpoint URL
+  --schema, -s <path>         Path to GraphQL schema file (.graphql)
+  --authorization, -a <header> Authorization header value
+  --json                      Output as JSON
+  --help, -h                  Show this help message
+`;
 /**
  * Format duration in a human-readable way
  * - Under 1 second: show milliseconds (e.g., "123ms")
@@ -18,12 +110,10 @@ function formatDuration(ms) {
     }
     return `${(ms / 1000).toFixed(2)}s`;
 }
-const program = new Command();
 /**
  * Load configuration for watch mode, merging CLI options with config file
  */
 async function loadWatchConfig(options) {
-    // Find config file
     let configPath = options.config;
     if (!configPath) {
         configPath = findConfigFile() ?? undefined;
@@ -87,25 +177,20 @@ async function loadWatchConfig(options) {
     }
     return resolveConfig(mergedTarget);
 }
-program
-    .name('graphql-codegen')
-    .description('CLI for generating GraphQL SDK from PostGraphile endpoints or schema files')
-    .version('2.17.48');
-// Init command
-program
-    .command('init')
-    .description('Initialize a new graphql-codegen configuration file')
-    .option('-d, --directory <dir>', 'Target directory for the config file', '.')
-    .option('-f, --force', 'Force overwrite existing config', false)
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL to pre-populate')
-    .option('-o, --output <dir>', 'Output directory to pre-populate', './generated')
-    .action(async (options) => {
+/**
+ * Init command handler
+ */
+async function handleInit(argv) {
+    if (argv.help || argv.h) {
+        console.log(initUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
     const result = await initCommand({
-        directory: options.directory,
-        force: options.force,
-        endpoint: options.endpoint,
-        output: options.output,
+        directory: argv.directory || argv.d || '.',
+        force: !!(argv.force || argv.f),
+        endpoint: argv.endpoint || argv.e,
+        output: argv.output || argv.o || './generated',
     });
     const duration = formatDuration(performance.now() - startTime);
     if (result.success) {
@@ -115,62 +200,75 @@ program
         console.error('x', result.message, `(${duration})`);
         process.exit(1);
     }
-});
-// Generate command
-program
-    .command('generate')
-    .description('Generate SDK from GraphQL endpoint or schema file')
-    .option('-c, --config <path>', 'Path to config file')
-    .option('-t, --target <name>', 'Target name in config file')
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL (overrides config)')
-    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
-    .option('-o, --output <dir>', 'Output directory (overrides config)')
-    .option('-a, --authorization <header>', 'Authorization header value')
-    .option('-v, --verbose', 'Verbose output', false)
-    .option('--dry-run', 'Dry run - show what would be generated without writing files', false)
-    .option('-w, --watch', 'Watch mode - poll endpoint for schema changes (in-memory)', false)
-    .option('--poll-interval <ms>', 'Polling interval in milliseconds (default: 3000)', parseInt)
-    .option('--debounce <ms>', 'Debounce delay before regenerating (default: 800)', parseInt)
-    .option('--touch <file>', 'File to touch on schema change')
-    .option('--no-clear', 'Do not clear terminal on regeneration')
-    .action(async (options) => {
+}
+/**
+ * Generate command handler
+ */
+async function handleGenerate(argv) {
+    if (argv.help || argv.h) {
+        console.log(generateUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
-    // Validate source options
-    if (options.endpoint && options.schema) {
+    const config = argv.config || argv.c;
+    const target = argv.target || argv.t;
+    const endpoint = argv.endpoint || argv.e;
+    const schema = argv.schema || argv.s;
+    const output = argv.output || argv.o;
+    const authorization = argv.authorization || argv.a;
+    const verbose = !!(argv.verbose || argv.v);
+    const dryRun = !!(argv['dry-run'] || argv.dryRun);
+    const watch = !!(argv.watch || argv.w);
+    const pollInterval = argv['poll-interval'] !== undefined
+        ? parseInt(argv['poll-interval'], 10)
+        : undefined;
+    const debounce = argv.debounce !== undefined
+        ? parseInt(argv.debounce, 10)
+        : undefined;
+    const touch = argv.touch;
+    const clear = argv.clear !== false;
+    if (endpoint && schema) {
         console.error('x Cannot use both --endpoint and --schema. Choose one source.');
         process.exit(1);
     }
-    // Watch mode (only for endpoint)
-    if (options.watch) {
-        if (options.schema) {
+    if (watch) {
+        if (schema) {
             console.error('x Watch mode is only supported with --endpoint, not --schema.');
             process.exit(1);
         }
-        const config = await loadWatchConfig(options);
-        if (!config) {
+        const watchConfig = await loadWatchConfig({
+            config,
+            target,
+            endpoint,
+            output,
+            pollInterval,
+            debounce,
+            touch,
+            clear,
+        });
+        if (!watchConfig) {
             process.exit(1);
         }
         await startWatch({
-            config,
+            config: watchConfig,
             generatorType: 'generate',
-            verbose: options.verbose,
-            authorization: options.authorization,
-            configPath: options.config,
-            target: options.target,
-            outputDir: options.output,
+            verbose,
+            authorization,
+            configPath: config,
+            target,
+            outputDir: output,
         });
         return;
     }
-    // Normal one-shot generation
     const result = await generateCommand({
-        config: options.config,
-        target: options.target,
-        endpoint: options.endpoint,
-        schema: options.schema,
-        output: options.output,
-        authorization: options.authorization,
-        verbose: options.verbose,
-        dryRun: options.dryRun,
+        config,
+        target,
+        endpoint,
+        schema,
+        output,
+        authorization,
+        verbose,
+        dryRun,
     });
     const duration = formatDuration(performance.now() - startTime);
     const targetResults = result.targets ?? [];
@@ -178,19 +276,19 @@ program
         (targetResults.length > 1 || targetResults[0]?.name !== 'default');
     if (hasNamedTargets) {
         console.log(result.success ? '[ok]' : 'x', result.message);
-        targetResults.forEach((target) => {
-            const status = target.success ? '[ok]' : 'x';
-            console.log(`\n${status} ${target.message}`);
-            if (target.tables && target.tables.length > 0) {
+        targetResults.forEach((t) => {
+            const status = t.success ? '[ok]' : 'x';
+            console.log(`\n${status} ${t.message}`);
+            if (t.tables && t.tables.length > 0) {
                 console.log('  Tables:');
-                target.tables.forEach((table) => console.log(`    - ${table}`));
+                t.tables.forEach((table) => console.log(`    - ${table}`));
             }
-            if (target.filesWritten && target.filesWritten.length > 0) {
+            if (t.filesWritten && t.filesWritten.length > 0) {
                 console.log('  Files written:');
-                target.filesWritten.forEach((file) => console.log(`    - ${file}`));
+                t.filesWritten.forEach((file) => console.log(`    - ${file}`));
             }
-            if (!target.success && target.errors) {
-                target.errors.forEach((error) => console.error(`  - ${error}`));
+            if (!t.success && t.errors) {
+                t.errors.forEach((error) => console.error(`  - ${error}`));
             }
         });
         if (!result.success) {
@@ -216,65 +314,78 @@ program
         }
         process.exit(1);
     }
-});
-// Generate ORM command
-program
-    .command('generate-orm')
-    .description('Generate Prisma-like ORM client from GraphQL endpoint or schema file')
-    .option('-c, --config <path>', 'Path to config file')
-    .option('-t, --target <name>', 'Target name in config file')
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL (overrides config)')
-    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
-    .option('-o, --output <dir>', 'Output directory (overrides config)')
-    .option('-a, --authorization <header>', 'Authorization header value')
-    .option('-v, --verbose', 'Verbose output', false)
-    .option('--dry-run', 'Dry run - show what would be generated without writing files', false)
-    .option('--skip-custom-operations', 'Skip custom operations (only generate table CRUD)', false)
-    .option('-w, --watch', 'Watch mode - poll endpoint for schema changes (in-memory)', false)
-    .option('--poll-interval <ms>', 'Polling interval in milliseconds (default: 3000)', parseInt)
-    .option('--debounce <ms>', 'Debounce delay before regenerating (default: 800)', parseInt)
-    .option('--touch <file>', 'File to touch on schema change')
-    .option('--no-clear', 'Do not clear terminal on regeneration')
-    .action(async (options) => {
+}
+/**
+ * Generate ORM command handler
+ */
+async function handleGenerateOrm(argv) {
+    if (argv.help || argv.h) {
+        console.log(generateOrmUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
-    // Validate source options
-    if (options.endpoint && options.schema) {
+    const config = argv.config || argv.c;
+    const target = argv.target || argv.t;
+    const endpoint = argv.endpoint || argv.e;
+    const schema = argv.schema || argv.s;
+    const output = argv.output || argv.o;
+    const authorization = argv.authorization || argv.a;
+    const verbose = !!(argv.verbose || argv.v);
+    const dryRun = !!(argv['dry-run'] || argv.dryRun);
+    const skipCustomOperations = !!(argv['skip-custom-operations'] || argv.skipCustomOperations);
+    const watch = !!(argv.watch || argv.w);
+    const pollInterval = argv['poll-interval'] !== undefined
+        ? parseInt(argv['poll-interval'], 10)
+        : undefined;
+    const debounce = argv.debounce !== undefined
+        ? parseInt(argv.debounce, 10)
+        : undefined;
+    const touch = argv.touch;
+    const clear = argv.clear !== false;
+    if (endpoint && schema) {
         console.error('x Cannot use both --endpoint and --schema. Choose one source.');
         process.exit(1);
     }
-    // Watch mode (only for endpoint)
-    if (options.watch) {
-        if (options.schema) {
+    if (watch) {
+        if (schema) {
             console.error('x Watch mode is only supported with --endpoint, not --schema.');
             process.exit(1);
         }
-        const config = await loadWatchConfig(options);
-        if (!config) {
+        const watchConfig = await loadWatchConfig({
+            config,
+            target,
+            endpoint,
+            output,
+            pollInterval,
+            debounce,
+            touch,
+            clear,
+        });
+        if (!watchConfig) {
             process.exit(1);
         }
         await startWatch({
-            config,
+            config: watchConfig,
             generatorType: 'generate-orm',
-            verbose: options.verbose,
-            authorization: options.authorization,
-            configPath: options.config,
-            target: options.target,
-            outputDir: options.output,
-            skipCustomOperations: options.skipCustomOperations,
+            verbose,
+            authorization,
+            configPath: config,
+            target,
+            outputDir: output,
+            skipCustomOperations,
         });
         return;
     }
-    // Normal one-shot generation
     const result = await generateOrmCommand({
-        config: options.config,
-        target: options.target,
-        endpoint: options.endpoint,
-        schema: options.schema,
-        output: options.output,
-        authorization: options.authorization,
-        verbose: options.verbose,
-        dryRun: options.dryRun,
-        skipCustomOperations: options.skipCustomOperations,
+        config,
+        target,
+        endpoint,
+        schema,
+        output,
+        authorization,
+        verbose,
+        dryRun,
+        skipCustomOperations,
     });
     const duration = formatDuration(performance.now() - startTime);
     const targetResults = result.targets ?? [];
@@ -282,27 +393,27 @@ program
         (targetResults.length > 1 || targetResults[0]?.name !== 'default');
     if (hasNamedTargets) {
         console.log(result.success ? '[ok]' : 'x', result.message);
-        targetResults.forEach((target) => {
-            const status = target.success ? '[ok]' : 'x';
-            console.log(`\n${status} ${target.message}`);
-            if (target.tables && target.tables.length > 0) {
+        targetResults.forEach((t) => {
+            const status = t.success ? '[ok]' : 'x';
+            console.log(`\n${status} ${t.message}`);
+            if (t.tables && t.tables.length > 0) {
                 console.log('  Tables:');
-                target.tables.forEach((table) => console.log(`    - ${table}`));
+                t.tables.forEach((table) => console.log(`    - ${table}`));
             }
-            if (target.customQueries && target.customQueries.length > 0) {
+            if (t.customQueries && t.customQueries.length > 0) {
                 console.log('  Custom Queries:');
-                target.customQueries.forEach((query) => console.log(`    - ${query}`));
+                t.customQueries.forEach((query) => console.log(`    - ${query}`));
             }
-            if (target.customMutations && target.customMutations.length > 0) {
+            if (t.customMutations && t.customMutations.length > 0) {
                 console.log('  Custom Mutations:');
-                target.customMutations.forEach((mutation) => console.log(`    - ${mutation}`));
+                t.customMutations.forEach((mutation) => console.log(`    - ${mutation}`));
             }
-            if (target.filesWritten && target.filesWritten.length > 0) {
+            if (t.filesWritten && t.filesWritten.length > 0) {
                 console.log('  Files written:');
-                target.filesWritten.forEach((file) => console.log(`    - ${file}`));
+                t.filesWritten.forEach((file) => console.log(`    - ${file}`));
             }
-            if (!target.success && target.errors) {
-                target.errors.forEach((error) => console.error(`  - ${error}`));
+            if (!t.success && t.errors) {
+                t.errors.forEach((error) => console.error(`  - ${error}`));
             }
         });
         if (!result.success) {
@@ -336,23 +447,25 @@ program
         }
         process.exit(1);
     }
-});
-// Introspect command (for debugging) - uses the new inference system
-program
-    .command('introspect')
-    .description('Introspect a GraphQL endpoint or schema file and print table info')
-    .option('-e, --endpoint <url>', 'GraphQL endpoint URL')
-    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
-    .option('-a, --authorization <header>', 'Authorization header value')
-    .option('--json', 'Output as JSON', false)
-    .action(async (options) => {
+}
+/**
+ * Introspect command handler
+ */
+async function handleIntrospect(argv) {
+    if (argv.help || argv.h) {
+        console.log(introspectUsageText);
+        process.exit(0);
+    }
     const startTime = performance.now();
-    // Validate source options
-    if (!options.endpoint && !options.schema) {
+    const endpoint = argv.endpoint || argv.e;
+    const schema = argv.schema || argv.s;
+    const authorization = argv.authorization || argv.a;
+    const json = !!argv.json;
+    if (!endpoint && !schema) {
         console.error('x Either --endpoint or --schema must be provided.');
         process.exit(1);
     }
-    if (options.endpoint && options.schema) {
+    if (endpoint && schema) {
         console.error('x Cannot use both --endpoint and --schema. Choose one source.');
         process.exit(1);
     }
@@ -360,15 +473,15 @@ program
     const { inferTablesFromIntrospection } = await import('./introspect/infer-tables');
     try {
         const source = createSchemaSource({
-            endpoint: options.endpoint,
-            schema: options.schema,
-            authorization: options.authorization,
+            endpoint,
+            schema,
+            authorization,
         });
         console.log('Fetching schema from', source.describe(), '...');
         const { introspection } = await source.fetch();
         const tables = inferTablesFromIntrospection(introspection);
         const duration = formatDuration(performance.now() - startTime);
-        if (options.json) {
+        if (json) {
             console.log(JSON.stringify(tables, null, 2));
         }
         else {
@@ -388,5 +501,89 @@ program
         console.error('x Failed to introspect schema:', err instanceof Error ? err.message : err, `(${duration})`);
         process.exit(1);
     }
-});
-program.parse();
+}
+const createCommandMap = () => {
+    return {
+        init: handleInit,
+        generate: handleGenerate,
+        'generate-orm': handleGenerateOrm,
+        introspect: handleIntrospect,
+    };
+};
+export const commands = async (argv, prompter, _options) => {
+    if (argv.version || argv.v) {
+        const pkg = findAndRequirePackageJson(__dirname);
+        console.log(pkg.version);
+        process.exit(0);
+    }
+    const { first: command, newArgv } = extractFirst(argv);
+    if ((argv.help || argv.h) && !command) {
+        console.log(usageText);
+        process.exit(0);
+    }
+    if (command === 'help') {
+        console.log(usageText);
+        process.exit(0);
+    }
+    const commandMap = createCommandMap();
+    if (!command) {
+        const answer = await prompter.prompt(argv, [
+            {
+                type: 'autocomplete',
+                name: 'command',
+                message: 'What do you want to do?',
+                options: Object.keys(commandMap),
+            },
+        ]);
+        const selectedCommand = answer.command;
+        const commandFn = commandMap[selectedCommand];
+        if (commandFn) {
+            await commandFn(newArgv);
+        }
+        prompter.close();
+        return argv;
+    }
+    const commandFn = commandMap[command];
+    if (!commandFn) {
+        console.log(usageText);
+        await cliExitWithError(`Unknown command: ${command}`);
+    }
+    await commandFn(newArgv);
+    prompter.close();
+    return argv;
+};
+export const options = {
+    minimistOpts: {
+        alias: {
+            v: 'version',
+            h: 'help',
+            c: 'config',
+            t: 'target',
+            e: 'endpoint',
+            s: 'schema',
+            o: 'output',
+            a: 'authorization',
+            d: 'directory',
+            f: 'force',
+            w: 'watch',
+        },
+        boolean: ['help', 'version', 'force', 'verbose', 'dry-run', 'watch', 'json', 'skip-custom-operations', 'clear'],
+        string: ['config', 'target', 'endpoint', 'schema', 'output', 'authorization', 'directory', 'touch', 'poll-interval', 'debounce'],
+        default: {
+            clear: true,
+        },
+    },
+};
+if (require.main === module) {
+    if (process.argv.includes('--version') || process.argv.includes('-v')) {
+        const pkg = findAndRequirePackageJson(__dirname);
+        console.log(pkg.version);
+        process.exit(0);
+    }
+    const app = new CLI(commands, options);
+    app.run().then(() => {
+    }).catch((error) => {
+        console.error('Unexpected error:', error);
+        process.exit(1);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.27.2",
+  "version": "2.27.3",
   "description": "CLI-based GraphQL SDK generator for PostGraphile endpoints with React Query hooks",
   "keywords": [
     "graphql",
@@ -54,12 +54,15 @@
   "dependencies": {
     "@babel/generator": "^7.28.6",
     "@babel/types": "^7.28.6",
+    "@inquirerer/utils": "^3.1.3",
     "ajv": "^8.17.1",
-    "commander": "^12.1.0",
+    "find-and-require-package-json": "^0.8.6",
     "gql-ast": "^2.6.0",
     "graphql": "15.10.1",
     "inflekt": "^0.2.0",
+    "inquirerer": "^4.3.1",
     "jiti": "^2.6.1",
+    "minimist": "^1.2.8",
     "oxfmt": "^0.13.0"
   },
   "peerDependencies": {
@@ -78,6 +81,7 @@
     "@tanstack/react-query": "^5.90.16",
     "@types/babel__generator": "^7.27.0",
     "@types/jest": "^29.5.14",
+    "@types/minimist": "^1.2.5",
     "@types/node": "^20.19.27",
     "@types/react": "^19.2.7",
     "jest": "^29.7.0",
@@ -86,5 +90,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "3ffd5718e86ea5fa9ca6e0930aeb510cf392f343"
+  "gitHead": "5ec5f1eb56490ffcf38fbc9949abc6905832083c"
 }