@constructive-io/graphql-codegen 4.0.1 → 4.1.0

package/esm/types/config.d.ts

@@ -112,6 +112,64 @@ export interface DbConfig {
      */
     keepDb?: boolean;
 }
+/**
+ * Documentation generation options
+ * Controls which doc formats are generated alongside code for each generator target.
+ * Applied at the top level and affects all enabled generators (ORM, React Query, CLI).
+ */
+export interface DocsConfig {
+    /**
+     * Generate README.md — human-readable overview with setup, commands, examples
+     * @default true
+     */
+    readme?: boolean;
+    /**
+     * Generate AGENTS.md — structured markdown optimized for LLM consumption
+     * Includes: tool definitions, exact signatures, input/output schemas,
+     * workflow recipes, error handling, and machine-parseable sections
+     * @default true
+     */
+    agents?: boolean;
+    /**
+     * Generate mcp.json — MCP (Model Context Protocol) tool definitions
+     * Each CLI command becomes a tool with typed inputSchema (JSON Schema)
+     * Ready to plug into any MCP-compatible agent
+     * @default false
+     */
+    mcp?: boolean;
+    /**
+     * Generate skills/ directory — per-command .md skill files
+     * Each command gets its own skill file with description, usage, and examples
+     * Compatible with Devin and similar agent skill systems
+     * @default false
+     */
+    skills?: boolean;
+}
+/**
+ * Infrastructure command name overrides for collision handling.
+ * When a target name collides with a default infra command name,
+ * the infra command is auto-renamed. These allow user overrides.
+ */
+export interface BuiltinNames {
+    auth?: string;
+    context?: string;
+}
+/**
+ * CLI generation configuration
+ */
+export interface CliConfig {
+    /**
+     * Tool name for appstash config storage (e.g., 'myapp' stores at ~/.myapp/)
+     * @default derived from output directory name
+     */
+    toolName?: string;
+    /**
+     * Override infra command names (for collision handling)
+     * Defaults: auth -> 'auth' (renamed to 'credentials' on collision),
+     *           context -> 'context' (renamed to 'env' on collision)
+     */
+    builtinNames?: BuiltinNames;
+}
 /**
  * Target configuration for graphql-codegen
  * Represents a single schema source and output destination.
@@ -130,6 +188,12 @@ export interface GraphQLSDKConfigTarget {
      * Path to GraphQL schema file (.graphql) for file-based generation
      */
     schemaFile?: string;
+    /**
+     * Path to a directory of .graphql schema files for multi-target generation.
+     * Each *.graphql file becomes its own target, named by the filename (without extension).
+     * e.g. schemas/app.graphql + schemas/admin.graphql → targets "app" and "admin"
+     */
+    schemaDir?: string;
     /**
      * Database configuration for direct database introspection or PGPM module
      * Use db.schemas or db.apiNames to specify which schemas to introspect
@@ -221,6 +285,20 @@ export interface GraphQLSDKConfigTarget {
      * @default false
      */
     reactQuery?: boolean;
+    /**
+     * CLI generation configuration
+     * When enabled, generates inquirerer-based CLI commands to {output}/cli
+     * Requires appstash for config storage and inquirerer for prompts
+     */
+    cli?: CliConfig | boolean;
+    /**
+     * Documentation generation options
+     * Controls which doc formats are generated alongside code for each generator target.
+     * Applied globally to all enabled generators (ORM, React Query, CLI).
+     * Set to `true` to enable all formats, or configure individually.
+     * @default { readme: true, agents: true, mcp: false, skills: false }
+     */
+    docs?: DocsConfig | boolean;
     /**
      * Query key generation configuration
      * Controls how query keys are structured for cache management

package/generators/index.d.ts

@@ -1,8 +1,5 @@
 /**
  * Query and mutation generator exports
- *
- * @deprecated Legacy v4 generators — use v5 ORM codegen pipeline instead.
- * These are retained for backward compatibility with existing v4 consumers.
  */
 export { convertToSelectionOptions, getAvailableRelations, isRelationalField, validateFieldSelection, } from './field-selector';
 export { buildCount, buildFindOne, buildSelect, cleanTableToMetaObject, createASTQueryBuilder, generateIntrospectionSchema, toCamelCasePlural, toOrderByTypeName, } from './select';

package/generators/index.js

@@ -1,9 +1,6 @@
 "use strict";
 /**
  * Query and mutation generator exports
- *
- * @deprecated Legacy v4 generators — use v5 ORM codegen pipeline instead.
- * These are retained for backward compatibility with existing v4 consumers.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildPostGraphileUpdate = exports.buildPostGraphileDelete = exports.buildPostGraphileCreate = exports.toOrderByTypeName = exports.toCamelCasePlural = exports.generateIntrospectionSchema = exports.createASTQueryBuilder = exports.cleanTableToMetaObject = exports.buildSelect = exports.buildFindOne = exports.buildCount = exports.validateFieldSelection = exports.isRelationalField = exports.getAvailableRelations = exports.convertToSelectionOptions = void 0;

package/index.d.ts

@@ -10,10 +10,11 @@ export * from './core';
 export * from './generators';
 export * from './client';
 export { defineConfig } from './types/config';
-export type { GenerateOptions, GenerateResult } from './core/generate';
-export { generate } from './core/generate';
+export type { GenerateOptions, GenerateResult, GenerateMultiOptions, GenerateMultiResult } from './core/generate';
+export { generate, generateMulti, expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget } from './core/generate';
 export { findConfigFile, loadConfigFile } from './core/config';
+export { runCodegenHandler } from './cli/handler';
 export type { CodegenAnswers } from './cli/shared';
 export { buildDbConfig, buildGenerateOptions, camelizeArgv, codegenQuestions, filterDefined, flattenDbFields, hasResolvedCodegenSource, hyphenateKeys, normalizeCodegenListOptions, printResult, seedArgvFromConfig, splitCommas, } from './cli/shared';
 export type { BuildSchemaFromDatabaseOptions, BuildSchemaFromDatabaseResult, } from './core/database';
-export { buildSchemaFromDatabase, buildSchemaSDLFromDatabase, } from './core/database';
+export { buildSchemaFromDatabase } from './core/database';

package/index.js

@@ -21,7 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildSchemaSDLFromDatabase = exports.buildSchemaFromDatabase = exports.splitCommas = exports.seedArgvFromConfig = exports.printResult = exports.normalizeCodegenListOptions = exports.hyphenateKeys = exports.hasResolvedCodegenSource = exports.flattenDbFields = exports.filterDefined = exports.codegenQuestions = exports.camelizeArgv = exports.buildGenerateOptions = exports.buildDbConfig = exports.loadConfigFile = exports.findConfigFile = exports.generate = exports.defineConfig = void 0;
+exports.buildSchemaFromDatabase = exports.splitCommas = exports.seedArgvFromConfig = exports.printResult = exports.normalizeCodegenListOptions = exports.hyphenateKeys = exports.hasResolvedCodegenSource = exports.flattenDbFields = exports.filterDefined = exports.codegenQuestions = exports.camelizeArgv = exports.buildGenerateOptions = exports.buildDbConfig = exports.runCodegenHandler = exports.loadConfigFile = exports.findConfigFile = exports.expandSchemaDirToMultiTarget = exports.expandApiNamesToMultiTarget = exports.generateMulti = exports.generate = exports.defineConfig = void 0;
 // Core types
 __exportStar(require("./types"), exports);
 // Core query building
@@ -35,10 +35,16 @@ var config_1 = require("./types/config");
 Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return config_1.defineConfig; } });
 var generate_1 = require("./core/generate");
 Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generate_1.generate; } });
+Object.defineProperty(exports, "generateMulti", { enumerable: true, get: function () { return generate_1.generateMulti; } });
+Object.defineProperty(exports, "expandApiNamesToMultiTarget", { enumerable: true, get: function () { return generate_1.expandApiNamesToMultiTarget; } });
+Object.defineProperty(exports, "expandSchemaDirToMultiTarget", { enumerable: true, get: function () { return generate_1.expandSchemaDirToMultiTarget; } });
 // Config utilities
 var config_2 = require("./core/config");
 Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return config_2.findConfigFile; } });
 Object.defineProperty(exports, "loadConfigFile", { enumerable: true, get: function () { return config_2.loadConfigFile; } });
+// CLI shared utilities (for packages/cli to import)
+var handler_1 = require("./cli/handler");
+Object.defineProperty(exports, "runCodegenHandler", { enumerable: true, get: function () { return handler_1.runCodegenHandler; } });
 var shared_1 = require("./cli/shared");
 Object.defineProperty(exports, "buildDbConfig", { enumerable: true, get: function () { return shared_1.buildDbConfig; } });
 Object.defineProperty(exports, "buildGenerateOptions", { enumerable: true, get: function () { return shared_1.buildGenerateOptions; } });
@@ -54,4 +60,3 @@ Object.defineProperty(exports, "seedArgvFromConfig", { enumerable: true, get: fu
 Object.defineProperty(exports, "splitCommas", { enumerable: true, get: function () { return shared_1.splitCommas; } });
 var database_1 = require("./core/database");
 Object.defineProperty(exports, "buildSchemaFromDatabase", { enumerable: true, get: function () { return database_1.buildSchemaFromDatabase; } });
-Object.defineProperty(exports, "buildSchemaSDLFromDatabase", { enumerable: true, get: function () { return database_1.buildSchemaSDLFromDatabase; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.0.1",
+  "version": "4.1.0",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -42,7 +42,7 @@
     "lint": "eslint . --fix",
     "fmt": "oxfmt --write .",
     "fmt:check": "oxfmt --check .",
-    "test": "jest --passWithNoTests",
+    "test": "jest",
     "test:watch": "jest --watch",
     "example:codegen:sdk": "tsx src/cli/index.ts --config examples/multi-target.config.ts --react-query",
     "example:codegen:orm": "tsx src/cli/index.ts --config examples/multi-target.config.ts --orm",
@@ -56,23 +56,24 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.28.6",
     "@babel/types": "^7.28.6",
-    "@constructive-io/graphql-server": "^4.0.1",
     "@constructive-io/graphql-types": "^3.0.0",
     "@inquirerer/utils": "^3.2.3",
-    "@pgpmjs/core": "^6.0.0",
+    "@pgpmjs/core": "^6.1.0",
     "ajv": "^8.17.1",
     "deepmerge": "^4.3.1",
     "find-and-require-package-json": "^0.9.0",
     "gql-ast": "^3.0.0",
+    "graphile-schema": "^1.1.0",
     "graphql": "^16.9.0",
     "inflekt": "^0.3.1",
     "inquirerer": "^4.4.0",
     "jiti": "^2.6.1",
+    "komoji": "^0.8.0",
     "oxfmt": "^0.26.0",
     "pg-cache": "^3.0.0",
     "pg-env": "^1.4.0",
-    "pgsql-client": "^3.0.0",
-    "pgsql-seed": "^2.0.0",
+    "pgsql-client": "^3.1.0",
+    "pgsql-seed": "^2.1.0",
     "undici": "^7.19.0"
   },
   "peerDependencies": {
@@ -99,5 +100,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "c05d6bd3dfa36690aefe21079042666dfae801a1"
+  "gitHead": "6dac0247c675de94b41038ac1e5095dc5df0c753"
 }

package/types/config.d.ts

@@ -112,6 +112,64 @@ export interface DbConfig {
      */
     keepDb?: boolean;
 }
+/**
+ * Documentation generation options
+ * Controls which doc formats are generated alongside code for each generator target.
+ * Applied at the top level and affects all enabled generators (ORM, React Query, CLI).
+ */
+export interface DocsConfig {
+    /**
+     * Generate README.md — human-readable overview with setup, commands, examples
+     * @default true
+     */
+    readme?: boolean;
+    /**
+     * Generate AGENTS.md — structured markdown optimized for LLM consumption
+     * Includes: tool definitions, exact signatures, input/output schemas,
+     * workflow recipes, error handling, and machine-parseable sections
+     * @default true
+     */
+    agents?: boolean;
+    /**
+     * Generate mcp.json — MCP (Model Context Protocol) tool definitions
+     * Each CLI command becomes a tool with typed inputSchema (JSON Schema)
+     * Ready to plug into any MCP-compatible agent
+     * @default false
+     */
+    mcp?: boolean;
+    /**
+     * Generate skills/ directory — per-command .md skill files
+     * Each command gets its own skill file with description, usage, and examples
+     * Compatible with Devin and similar agent skill systems
+     * @default false
+     */
+    skills?: boolean;
+}
+/**
+ * Infrastructure command name overrides for collision handling.
+ * When a target name collides with a default infra command name,
+ * the infra command is auto-renamed. These allow user overrides.
+ */
+export interface BuiltinNames {
+    auth?: string;
+    context?: string;
+}
+/**
+ * CLI generation configuration
+ */
+export interface CliConfig {
+    /**
+     * Tool name for appstash config storage (e.g., 'myapp' stores at ~/.myapp/)
+     * @default derived from output directory name
+     */
+    toolName?: string;
+    /**
+     * Override infra command names (for collision handling)
+     * Defaults: auth -> 'auth' (renamed to 'credentials' on collision),
+     *           context -> 'context' (renamed to 'env' on collision)
+     */
+    builtinNames?: BuiltinNames;
+}
 /**
  * Target configuration for graphql-codegen
  * Represents a single schema source and output destination.
@@ -130,6 +188,12 @@ export interface GraphQLSDKConfigTarget {
      * Path to GraphQL schema file (.graphql) for file-based generation
      */
     schemaFile?: string;
+    /**
+     * Path to a directory of .graphql schema files for multi-target generation.
+     * Each *.graphql file becomes its own target, named by the filename (without extension).
+     * e.g. schemas/app.graphql + schemas/admin.graphql → targets "app" and "admin"
+     */
+    schemaDir?: string;
     /**
      * Database configuration for direct database introspection or PGPM module
      * Use db.schemas or db.apiNames to specify which schemas to introspect
@@ -221,6 +285,20 @@ export interface GraphQLSDKConfigTarget {
      * @default false
      */
     reactQuery?: boolean;
+    /**
+     * CLI generation configuration
+     * When enabled, generates inquirerer-based CLI commands to {output}/cli
+     * Requires appstash for config storage and inquirerer for prompts
+     */
+    cli?: CliConfig | boolean;
+    /**
+     * Documentation generation options
+     * Controls which doc formats are generated alongside code for each generator target.
+     * Applied globally to all enabled generators (ORM, React Query, CLI).
+     * Set to `true` to enable all formats, or configure individually.
+     * @default { readme: true, agents: true, mcp: false, skills: false }
+     */
+    docs?: DocsConfig | boolean;
     /**
      * Query key generation configuration
      * Controls how query keys are structured for cache management