@constructive-io/graphql-codegen 4.15.3 → 4.15.4

package/cli/handler.js

@@ -6,7 +6,13 @@ const generate_1 = require("../core/generate");
 const shared_1 = require("./shared");
 async function runCodegenHandler(argv, prompter) {
     const args = (0, shared_1.camelizeArgv)(argv);
-    const schemaOnly = Boolean(args.schemaOnly);
+    const schemaConfig = args.schemaEnabled
+        ? {
+            enabled: true,
+            ...(args.schemaOutput ? { output: String(args.schemaOutput) } : {}),
+            ...(args.schemaFilename ? { filename: String(args.schemaFilename) } : {}),
+        }
+        : undefined;
     const hasSourceFlags = Boolean(args.endpoint || args.schemaFile || args.schemaDir || args.schemas || args.apiNames);
     const configPath = args.config ||
         (!hasSourceFlags ? (0, config_1.findConfigFile)() : undefined);
@@ -36,7 +42,7 @@ async function runCodegenHandler(argv, prompter) {
             const { results, hasError } = await (0, generate_1.generateMulti)({
                 configs: selectedTargets,
                 cliOverrides: cliOptions,
-                schemaOnly,
+                schema: schemaConfig,
             });
             for (const { name, result } of results) {
                 console.log(`\n[${name}]`);
@@ -59,7 +65,7 @@ async function runCodegenHandler(argv, prompter) {
     if (expanded) {
         const { results, hasError } = await (0, generate_1.generateMulti)({
             configs: expanded,
-            schemaOnly,
+            schema: schemaConfig,
         });
         for (const { name, result } of results) {
             console.log(`\n[${name}]`);
@@ -69,6 +75,9 @@ async function runCodegenHandler(argv, prompter) {
             process.exit(1);
         return;
     }
-    const result = await (0, generate_1.generate)({ ...options, schemaOnly });
+    const result = await (0, generate_1.generate)({
+        ...options,
+        ...(schemaConfig ? { schema: schemaConfig } : {}),
+    });
     (0, shared_1.printResult)(result);
 }

package/cli/index.js

@@ -37,9 +37,11 @@ Generator Options:
   -v, --verbose                 Show detailed output
 
 Schema Export:
-  --schema-only                 Export GraphQL SDL instead of running full codegen.
+  --schema-enabled              Export GraphQL SDL instead of running full codegen.
                                 Works with any source (endpoint, file, database, PGPM).
                                 With multiple apiNames, writes one .graphql per API.
+  --schema-output <dir>         Output directory for the exported schema file
+  --schema-filename <name>      Filename for the exported schema (default: schema.graphql)
 
   -h, --help                    Show this help message
   --version                     Show version number
@@ -71,12 +73,14 @@ exports.options = {
             a: 'authorization',
             v: 'verbose',
         },
-        boolean: ['schema-only'],
+        boolean: ['schema-enabled'],
         string: [
             'config',
             'endpoint',
             'schema-file',
             'schema-dir',
+            'schema-output',
+            'schema-filename',
             'output',
             'target',
             'authorization',

package/core/generate.d.ts

@@ -1,13 +1,10 @@
-import type { CliConfig, GraphQLSDKConfigTarget } from '../types/config';
+import type { CliConfig, GraphQLSDKConfigTarget, SchemaConfig } from '../types/config';
 import type { CleanOperation, CleanTable, TypeRegistry } from '../types/schema';
 export interface GenerateOptions extends GraphQLSDKConfigTarget {
     authorization?: string;
     verbose?: boolean;
     dryRun?: boolean;
     skipCustomOperations?: boolean;
-    schemaOnly?: boolean;
-    schemaOnlyOutput?: string;
-    schemaOnlyFilename?: string;
 }
 export interface GenerateResult {
     success: boolean;
@@ -47,7 +44,7 @@ export interface GenerateMultiOptions {
     cliOverrides?: Partial<GraphQLSDKConfigTarget>;
     verbose?: boolean;
     dryRun?: boolean;
-    schemaOnly?: boolean;
+    schema?: SchemaConfig;
     unifiedCli?: CliConfig | boolean;
 }
 export interface GenerateMultiResult {

package/core/generate.js

@@ -92,7 +92,8 @@ async function generate(options = {}, internalOptions) {
     // Auto-enable nodeHttpAdapter when CLI is enabled, unless explicitly set to false
     const useNodeHttpAdapter = options.nodeHttpAdapter === true ||
         (runCli && options.nodeHttpAdapter !== false);
-    if (!options.schemaOnly && !runReactQuery && !runOrm && !runCli) {
+    const schemaEnabled = !!options.schema?.enabled;
+    if (!schemaEnabled && !runReactQuery && !runOrm && !runCli) {
         return {
             success: false,
             message: 'No generators enabled. Use reactQuery: true, orm: true, or cli: true in your config.',
@@ -119,7 +120,7 @@ async function generate(options = {}, internalOptions) {
         authorization: options.authorization || config.headers?.Authorization,
         headers: config.headers,
     });
-    if (options.schemaOnly) {
+    if (schemaEnabled && !runReactQuery && !runOrm && !runCli) {
         try {
             console.log(`Fetching schema from ${source.describe()}...`);
             const { introspection } = await source.fetch();
@@ -132,9 +133,9 @@ async function generate(options = {}, internalOptions) {
                     output: outputRoot,
                 };
             }
-            const outDir = node_path_1.default.resolve(options.schemaOnlyOutput || outputRoot || '.');
+            const outDir = node_path_1.default.resolve(options.schema?.output || outputRoot || '.');
             await fs.promises.mkdir(outDir, { recursive: true });
-            const filename = options.schemaOnlyFilename || 'schema.graphql';
+            const filename = options.schema?.filename || 'schema.graphql';
             const filePath = node_path_1.default.join(outDir, filename);
             await fs.promises.writeFile(filePath, sdl, 'utf-8');
             return {
@@ -539,12 +540,13 @@ function applySharedPgpmDb(config, sharedSources) {
     };
 }
 async function generateMulti(options) {
-    const { configs, cliOverrides, verbose, dryRun, schemaOnly, unifiedCli } = options;
+    const { configs, cliOverrides, verbose, dryRun, schema, unifiedCli } = options;
     const names = Object.keys(configs);
     const results = [];
     let hasError = false;
+    const schemaEnabled = !!schema?.enabled;
     const targetInfos = [];
-    const useUnifiedCli = !schemaOnly && !!unifiedCli && names.length > 1;
+    const useUnifiedCli = !schemaEnabled && !!unifiedCli && names.length > 1;
     const cliTargets = [];
     const sharedSources = await prepareSharedPgpmSources(configs, cliOverrides);
     try {
@@ -558,8 +560,9 @@ async function generateMulti(options) {
                 ...targetConfig,
                 verbose,
                 dryRun,
-                schemaOnly,
-                schemaOnlyFilename: schemaOnly ? `${name}.graphql` : undefined,
+                schema: schemaEnabled
+                    ? { ...schema, filename: schema?.filename ?? `${name}.graphql` }
+                    : targetConfig.schema,
             }, useUnifiedCli ? { skipCli: true, targetName: name } : { targetName: name });
             results.push({ name, result });
             if (!result.success) {

package/esm/cli/handler.js

@@ -3,7 +3,13 @@ import { expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget, generate, ge
 import { buildDbConfig, buildGenerateOptions, camelizeArgv, codegenQuestions, hasResolvedCodegenSource, normalizeCodegenListOptions, printResult, seedArgvFromConfig, } from './shared';
 export async function runCodegenHandler(argv, prompter) {
     const args = camelizeArgv(argv);
-    const schemaOnly = Boolean(args.schemaOnly);
+    const schemaConfig = args.schemaEnabled
+        ? {
+            enabled: true,
+            ...(args.schemaOutput ? { output: String(args.schemaOutput) } : {}),
+            ...(args.schemaFilename ? { filename: String(args.schemaFilename) } : {}),
+        }
+        : undefined;
     const hasSourceFlags = Boolean(args.endpoint || args.schemaFile || args.schemaDir || args.schemas || args.apiNames);
     const configPath = args.config ||
         (!hasSourceFlags ? findConfigFile() : undefined);
@@ -33,7 +39,7 @@ export async function runCodegenHandler(argv, prompter) {
             const { results, hasError } = await generateMulti({
                 configs: selectedTargets,
                 cliOverrides: cliOptions,
-                schemaOnly,
+                schema: schemaConfig,
             });
             for (const { name, result } of results) {
                 console.log(`\n[${name}]`);
@@ -56,7 +62,7 @@ export async function runCodegenHandler(argv, prompter) {
     if (expanded) {
         const { results, hasError } = await generateMulti({
             configs: expanded,
-            schemaOnly,
+            schema: schemaConfig,
         });
         for (const { name, result } of results) {
             console.log(`\n[${name}]`);
@@ -66,6 +72,9 @@ export async function runCodegenHandler(argv, prompter) {
             process.exit(1);
         return;
     }
-    const result = await generate({ ...options, schemaOnly });
+    const result = await generate({
+        ...options,
+        ...(schemaConfig ? { schema: schemaConfig } : {}),
+    });
     printResult(result);
 }

package/esm/cli/index.js

@@ -34,9 +34,11 @@ Generator Options:
   -v, --verbose                 Show detailed output
 
 Schema Export:
-  --schema-only                 Export GraphQL SDL instead of running full codegen.
+  --schema-enabled              Export GraphQL SDL instead of running full codegen.
                                 Works with any source (endpoint, file, database, PGPM).
                                 With multiple apiNames, writes one .graphql per API.
+  --schema-output <dir>         Output directory for the exported schema file
+  --schema-filename <name>      Filename for the exported schema (default: schema.graphql)
 
   -h, --help                    Show this help message
   --version                     Show version number
@@ -67,12 +69,14 @@ export const options = {
             a: 'authorization',
             v: 'verbose',
         },
-        boolean: ['schema-only'],
+        boolean: ['schema-enabled'],
         string: [
             'config',
             'endpoint',
             'schema-file',
             'schema-dir',
+            'schema-output',
+            'schema-filename',
             'output',
             'target',
             'authorization',

package/esm/core/generate.d.ts

@@ -1,13 +1,10 @@
-import type { CliConfig, GraphQLSDKConfigTarget } from '../types/config';
+import type { CliConfig, GraphQLSDKConfigTarget, SchemaConfig } from '../types/config';
 import type { CleanOperation, CleanTable, TypeRegistry } from '../types/schema';
 export interface GenerateOptions extends GraphQLSDKConfigTarget {
     authorization?: string;
     verbose?: boolean;
     dryRun?: boolean;
     skipCustomOperations?: boolean;
-    schemaOnly?: boolean;
-    schemaOnlyOutput?: string;
-    schemaOnlyFilename?: string;
 }
 export interface GenerateResult {
     success: boolean;
@@ -47,7 +44,7 @@ export interface GenerateMultiOptions {
     cliOverrides?: Partial<GraphQLSDKConfigTarget>;
     verbose?: boolean;
     dryRun?: boolean;
-    schemaOnly?: boolean;
+    schema?: SchemaConfig;
     unifiedCli?: CliConfig | boolean;
 }
 export interface GenerateMultiResult {

package/esm/core/generate.js

@@ -50,7 +50,8 @@ export async function generate(options = {}, internalOptions) {
     // Auto-enable nodeHttpAdapter when CLI is enabled, unless explicitly set to false
     const useNodeHttpAdapter = options.nodeHttpAdapter === true ||
         (runCli && options.nodeHttpAdapter !== false);
-    if (!options.schemaOnly && !runReactQuery && !runOrm && !runCli) {
+    const schemaEnabled = !!options.schema?.enabled;
+    if (!schemaEnabled && !runReactQuery && !runOrm && !runCli) {
         return {
             success: false,
             message: 'No generators enabled. Use reactQuery: true, orm: true, or cli: true in your config.',
@@ -77,7 +78,7 @@ export async function generate(options = {}, internalOptions) {
         authorization: options.authorization || config.headers?.Authorization,
         headers: config.headers,
     });
-    if (options.schemaOnly) {
+    if (schemaEnabled && !runReactQuery && !runOrm && !runCli) {
         try {
             console.log(`Fetching schema from ${source.describe()}...`);
             const { introspection } = await source.fetch();
@@ -90,9 +91,9 @@ export async function generate(options = {}, internalOptions) {
                     output: outputRoot,
                 };
             }
-            const outDir = path.resolve(options.schemaOnlyOutput || outputRoot || '.');
+            const outDir = path.resolve(options.schema?.output || outputRoot || '.');
             await fs.promises.mkdir(outDir, { recursive: true });
-            const filename = options.schemaOnlyFilename || 'schema.graphql';
+            const filename = options.schema?.filename || 'schema.graphql';
             const filePath = path.join(outDir, filename);
             await fs.promises.writeFile(filePath, sdl, 'utf-8');
             return {
@@ -497,12 +498,13 @@ function applySharedPgpmDb(config, sharedSources) {
     };
 }
 export async function generateMulti(options) {
-    const { configs, cliOverrides, verbose, dryRun, schemaOnly, unifiedCli } = options;
+    const { configs, cliOverrides, verbose, dryRun, schema, unifiedCli } = options;
     const names = Object.keys(configs);
     const results = [];
     let hasError = false;
+    const schemaEnabled = !!schema?.enabled;
     const targetInfos = [];
-    const useUnifiedCli = !schemaOnly && !!unifiedCli && names.length > 1;
+    const useUnifiedCli = !schemaEnabled && !!unifiedCli && names.length > 1;
     const cliTargets = [];
     const sharedSources = await prepareSharedPgpmSources(configs, cliOverrides);
     try {
@@ -516,8 +518,9 @@ export async function generateMulti(options) {
                 ...targetConfig,
                 verbose,
                 dryRun,
-                schemaOnly,
-                schemaOnlyFilename: schemaOnly ? `${name}.graphql` : undefined,
+                schema: schemaEnabled
+                    ? { ...schema, filename: schema?.filename ?? `${name}.graphql` }
+                    : targetConfig.schema,
             }, useUnifiedCli ? { skipCli: true, targetName: name } : { targetName: name });
             results.push({ name, result });
             if (!result.success) {

package/esm/types/config.d.ts

@@ -145,6 +145,29 @@ export interface DocsConfig {
      */
     skills?: boolean;
 }
+/**
+ * Schema export configuration
+ * Controls SDL schema export behavior.
+ */
+export interface SchemaConfig {
+    /**
+     * Enable schema SDL export
+     * When true, fetches the schema and writes it as a .graphql SDL file.
+     * If no generators are enabled (orm, reactQuery, cli), only the schema is exported.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Output directory for the exported schema file
+     * @default same as the target's output directory
+     */
+    output?: string;
+    /**
+     * Filename for the exported schema file
+     * @default 'schema.graphql'
+     */
+    filename?: string;
+}
 /**
  * Infrastructure command name overrides for collision handling.
  * When a target name collides with a default infra command name,
@@ -340,6 +363,12 @@ export interface GraphQLSDKConfigTarget {
      * @default { readme: true, agents: true, mcp: false }
      */
     docs?: DocsConfig | boolean;
+    /**
+     * Schema export configuration
+     * When enabled, exports the GraphQL SDL to a file.
+     * If no generators are also enabled, this acts as a schema-only export.
+     */
+    schema?: SchemaConfig;
     /**
      * Custom path for generated skill files.
      * When set, skills are written to this directory.

package/esm/types/index.d.ts

@@ -5,5 +5,5 @@ export type { CleanBelongsToRelation, CleanField, CleanFieldType, CleanHasManyRe
 export type { ConnectionResult, FieldFilter, Filter, FilterOperator, OrderByItem, PageInfo, QueryOptions, RelationalFilter, } from './query';
 export type { CreateInput, DeleteInput, MutationOptions, MutationResult, UpdateInput, } from './mutation';
 export type { FieldSelection, FieldSelectionPreset, SelectionOptions, SimpleFieldSelection, } from './selection';
-export type { GraphQLSDKConfig, GraphQLSDKConfigTarget } from './config';
+export type { GraphQLSDKConfig, GraphQLSDKConfigTarget, SchemaConfig } from './config';
 export { DEFAULT_CONFIG, defineConfig, getConfigOptions, mergeConfig, } from './config';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.15.3",
+  "version": "4.15.4",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -101,5 +101,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "c18ef8e002d958001fe69fff3758d1f89613eb2b"
+  "gitHead": "8edfd4913d37603659afa968489dc84d6bab769d"
 }

package/types/config.d.ts

@@ -145,6 +145,29 @@ export interface DocsConfig {
      */
     skills?: boolean;
 }
+/**
+ * Schema export configuration
+ * Controls SDL schema export behavior.
+ */
+export interface SchemaConfig {
+    /**
+     * Enable schema SDL export
+     * When true, fetches the schema and writes it as a .graphql SDL file.
+     * If no generators are enabled (orm, reactQuery, cli), only the schema is exported.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Output directory for the exported schema file
+     * @default same as the target's output directory
+     */
+    output?: string;
+    /**
+     * Filename for the exported schema file
+     * @default 'schema.graphql'
+     */
+    filename?: string;
+}
 /**
  * Infrastructure command name overrides for collision handling.
  * When a target name collides with a default infra command name,
@@ -340,6 +363,12 @@ export interface GraphQLSDKConfigTarget {
      * @default { readme: true, agents: true, mcp: false }
      */
     docs?: DocsConfig | boolean;
+    /**
+     * Schema export configuration
+     * When enabled, exports the GraphQL SDL to a file.
+     * If no generators are also enabled, this acts as a schema-only export.
+     */
+    schema?: SchemaConfig;
     /**
      * Custom path for generated skill files.
      * When set, skills are written to this directory.

package/types/index.d.ts

@@ -5,5 +5,5 @@ export type { CleanBelongsToRelation, CleanField, CleanFieldType, CleanHasManyRe
 export type { ConnectionResult, FieldFilter, Filter, FilterOperator, OrderByItem, PageInfo, QueryOptions, RelationalFilter, } from './query';
 export type { CreateInput, DeleteInput, MutationOptions, MutationResult, UpdateInput, } from './mutation';
 export type { FieldSelection, FieldSelectionPreset, SelectionOptions, SimpleFieldSelection, } from './selection';
-export type { GraphQLSDKConfig, GraphQLSDKConfigTarget } from './config';
+export type { GraphQLSDKConfig, GraphQLSDKConfigTarget, SchemaConfig } from './config';
 export { DEFAULT_CONFIG, defineConfig, getConfigOptions, mergeConfig, } from './config';