@constructive-io/graphql-codegen 4.3.0 → 4.4.0

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

@@ -41,6 +41,8 @@ export interface GenerateMultiTargetCliOptions {
     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;
@@ -56,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;
@@ -49,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: {
@@ -136,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: {
@@ -175,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/utils-generator.d.ts

@@ -16,3 +16,12 @@ export declare function generateUtilsFile(): GeneratedFile;
  * 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

@@ -35,6 +35,7 @@ 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");
@@ -90,3 +91,17 @@ function generateNodeFetchFile() {
         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/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);
+});

package/core/generate.js

@@ -574,6 +574,7 @@ async function generateMulti(options) {
                 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/index.d.ts

@@ -41,6 +41,8 @@ export interface GenerateMultiTargetCliOptions {
     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;
@@ -56,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, generateNodeFetchFile } from './utils-generator';
+import { generateUtilsFile, generateNodeFetchFile, generateEntryPointFile } from './utils-generator';
 export function generateCli(options) {
     const { tables, customOperations, config } = options;
     const files = [];
@@ -43,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: {
@@ -130,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: {
@@ -148,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/utils-generator.d.ts

@@ -16,3 +16,12 @@ export declare function generateUtilsFile(): GeneratedFile;
  * 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

@@ -53,3 +53,17 @@ export function generateNodeFetchFile() {
         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/generate.js

@@ -532,6 +532,7 @@ export async function generateMulti(options) {
                 builtinNames: cliConfig.builtinNames,
                 targets: cliTargets,
                 nodeHttpAdapter: multiNodeHttpAdapter,
+                entryPoint: cliConfig.entryPoint,
             });
             const cliFilesToWrite = files.map((file) => ({
                 path: path.posix.join('cli', file.fileName),

package/esm/types/config.d.ts

@@ -169,6 +169,14 @@ export interface CliConfig {
      *           context -> 'context' (renamed to 'env' on collision)
      */
     builtinNames?: BuiltinNames;
+    /**
+     * Generate a runnable index.ts entry point for the CLI.
+     * When true, generates an index.ts that imports the command map,
+     * handles --version and --tty flags, and starts the inquirerer CLI.
+     * Useful for projects that want a ready-to-run CLI without a custom entry point.
+     * @default false
+     */
+    entryPoint?: boolean;
 }
 /**
  * Target configuration for graphql-codegen

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -100,5 +100,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "b758178b808ce0bf451e86c0bd7e92079155db7c"
+  "gitHead": "2ce4c3c62998a3c57eb04bfb67ce47bb9490f384"
 }

package/types/config.d.ts

@@ -169,6 +169,14 @@ export interface CliConfig {
      *           context -> 'context' (renamed to 'env' on collision)
      */
     builtinNames?: BuiltinNames;
+    /**
+     * Generate a runnable index.ts entry point for the CLI.
+     * When true, generates an index.ts that imports the command map,
+     * handles --version and --tty flags, and starts the inquirerer CLI.
+     * Useful for projects that want a ready-to-run CLI without a custom entry point.
+     * @default false
+     */
+    entryPoint?: boolean;
 }
 /**
  * Target configuration for graphql-codegen