@constructive-io/graphql-codegen 4.15.2 → 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

@@ -50,6 +50,7 @@ const fs = __importStar(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const graphql_1 = require("graphql");
 const core_1 = require("@pgpmjs/core");
+const pg_cache_1 = require("pg-cache");
 const pgsql_client_1 = require("pgsql-client");
 const pgsql_seed_1 = require("pgsql-seed");
 const config_1 = require("../types/config");
@@ -91,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.',
@@ -118,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();
@@ -131,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 {
@@ -538,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 {
@@ -557,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) {
@@ -681,6 +685,10 @@ async function generateMulti(options) {
     finally {
         for (const shared of sharedSources.values()) {
             const keepDb = Object.values(configs).some((c) => c.db?.keepDb);
+            // Release pg-cache pool for this ephemeral database before dropping
+            // deployPgpm() caches connections that must be closed first
+            pg_cache_1.pgCache.delete(shared.ephemeralDb.config.database);
+            await pg_cache_1.pgCache.waitForDisposals();
             shared.ephemeralDb.teardown({ keepDb });
         }
     }

package/core/introspect/source/pgpm-module.js

@@ -136,6 +136,10 @@ class PgpmModuleSchemaSource {
             return { introspection };
         }
         finally {
+            // Release pg-cache pool for this ephemeral database before dropping
+            // deployPgpm() and getPgPool() cache connections that must be closed first
+            pg_cache_1.pgCache.delete(dbConfig.database);
+            await pg_cache_1.pgCache.waitForDisposals();
             // Clean up the ephemeral database
             teardown({ keepDb });
             if (keepDb) {

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

@@ -8,6 +8,7 @@ import * as fs from 'node:fs';
 import path from 'node:path';
 import { buildClientSchema, printSchema } from 'graphql';
 import { PgpmPackage } from '@pgpmjs/core';
+import { pgCache } from 'pg-cache';
 import { createEphemeralDb } from 'pgsql-client';
 import { deployPgpm } from 'pgsql-seed';
 import { getConfigOptions } from '../types/config';
@@ -49,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.',
@@ -76,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();
@@ -89,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 {
@@ -496,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 {
@@ -515,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) {
@@ -639,6 +643,10 @@ export async function generateMulti(options) {
     finally {
         for (const shared of sharedSources.values()) {
             const keepDb = Object.values(configs).some((c) => c.db?.keepDb);
+            // Release pg-cache pool for this ephemeral database before dropping
+            // deployPgpm() caches connections that must be closed first
+            pgCache.delete(shared.ephemeralDb.config.database);
+            await pgCache.waitForDisposals();
             shared.ephemeralDb.teardown({ keepDb });
         }
     }

package/esm/core/introspect/source/pgpm-module.js

@@ -9,7 +9,7 @@
  */
 import { PgpmPackage } from '@pgpmjs/core';
 import { buildSchema, introspectionFromSchema } from 'graphql';
-import { getPgPool } from 'pg-cache';
+import { getPgPool, pgCache } from 'pg-cache';
 import { createEphemeralDb } from 'pgsql-client';
 import { deployPgpm } from 'pgsql-seed';
 import { buildSchemaSDL } from 'graphile-schema';
@@ -131,6 +131,10 @@ export class PgpmModuleSchemaSource {
             return { introspection };
         }
         finally {
+            // Release pg-cache pool for this ephemeral database before dropping
+            // deployPgpm() and getPgPool() cache connections that must be closed first
+            pgCache.delete(dbConfig.database);
+            await pgCache.waitForDisposals();
             // Clean up the ephemeral database
             teardown({ keepDb });
             if (keepDb) {

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.2",
+  "version": "4.15.4",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -56,15 +56,15 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.29.1",
     "@babel/types": "^7.29.0",
-    "@constructive-io/graphql-query": "^3.6.4",
+    "@constructive-io/graphql-query": "^3.6.5",
     "@constructive-io/graphql-types": "^3.3.4",
     "@inquirerer/utils": "^3.3.4",
-    "@pgpmjs/core": "^6.7.0",
+    "@pgpmjs/core": "^6.7.1",
     "ajv": "^8.18.0",
     "deepmerge": "^4.3.1",
     "find-and-require-package-json": "^0.9.1",
     "gql-ast": "^3.3.3",
-    "graphile-schema": "^1.6.4",
+    "graphile-schema": "^1.6.5",
     "graphql": "16.13.0",
     "inflekt": "^0.3.3",
     "inquirerer": "^4.7.0",
@@ -73,8 +73,8 @@
     "oxfmt": "^0.40.0",
     "pg-cache": "^3.3.4",
     "pg-env": "^1.7.3",
-    "pgsql-client": "^3.5.6",
-    "pgsql-seed": "^2.5.6",
+    "pgsql-client": "^3.5.7",
+    "pgsql-seed": "^2.5.7",
     "undici": "^7.24.3"
   },
   "peerDependencies": {
@@ -101,5 +101,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "9f3837555601b15e693ae0b750124fb0a8df3176"
+  "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';