@constructive-io/graphql-codegen 4.46.0 → 4.47.0

package/README.md

@@ -937,6 +937,10 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 * [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
 * [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
 
+### 📚 Documentation & Skills
+
+* [constructive-skills](https://github.com/constructive-io/constructive-skills): **📖 Platform documentation and AI agent skills** — feature catalog, blueprint reference, SDK guides (i18n, billing, limits, events, uploads, security, entities, search, AI), and deployment guides.
+
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/core/generate.d.ts

@@ -46,6 +46,8 @@ export interface GenerateMultiOptions {
     dryRun?: boolean;
     schema?: SchemaConfig;
     unifiedCli?: CliConfig | boolean;
+    /** Remove subdirectories in the output root that don't match any current target name. */
+    cleanStaleTargets?: boolean;
 }
 export interface GenerateMultiResult {
     results: Array<{
@@ -54,4 +56,10 @@ export interface GenerateMultiResult {
     }>;
     hasError: boolean;
 }
+/**
+ * Remove subdirectories in `outputRoot` that are not in `currentTargetNames`.
+ * Useful for cleaning up stale target output before a fresh multi-target generate.
+ * Returns the list of directory names that were removed.
+ */
+export declare function removeStaleTargetDirs(outputRoot: string, currentTargetNames: string[], verbose?: boolean): string[];
 export declare function generateMulti(options: GenerateMultiOptions): Promise<GenerateMultiResult>;

package/core/generate.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generate = generate;
 exports.expandApiNamesToMultiTarget = expandApiNamesToMultiTarget;
 exports.expandSchemaDirToMultiTarget = expandSchemaDirToMultiTarget;
+exports.removeStaleTargetDirs = removeStaleTargetDirs;
 exports.generateMulti = generateMulti;
 /**
  * Main generate function - orchestrates the entire codegen pipeline
@@ -509,8 +510,30 @@ function applySharedPgpmDb(config, sharedSources) {
         db: sharedDbConfig,
     };
 }
+/**
+ * Remove subdirectories in `outputRoot` that are not in `currentTargetNames`.
+ * Useful for cleaning up stale target output before a fresh multi-target generate.
+ * Returns the list of directory names that were removed.
+ */
+function removeStaleTargetDirs(outputRoot, currentTargetNames, verbose) {
+    const removed = [];
+    if (!fs.existsSync(outputRoot))
+        return removed;
+    const currentTargets = new Set(currentTargetNames);
+    const entries = fs.readdirSync(outputRoot, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && !currentTargets.has(entry.name)) {
+            fs.rmSync(node_path_1.default.join(outputRoot, entry.name), { recursive: true, force: true });
+            removed.push(entry.name);
+            if (verbose) {
+                console.log(`Removed stale target directory: ${entry.name}`);
+            }
+        }
+    }
+    return removed;
+}
 async function generateMulti(options) {
-    const { configs, cliOverrides, verbose, dryRun, schema, unifiedCli } = options;
+    const { configs, cliOverrides, verbose, dryRun, schema, unifiedCli, cleanStaleTargets } = options;
     const names = Object.keys(configs);
     const results = [];
     let hasError = false;
@@ -518,6 +541,12 @@ async function generateMulti(options) {
     const targetInfos = [];
     const useUnifiedCli = !schemaEnabled && !!unifiedCli && names.length > 1;
     const cliTargets = [];
+    // Remove stale target directories before generating
+    if (cleanStaleTargets && names.length > 0 && !dryRun) {
+        const firstOutput = (0, config_1.getConfigOptions)(configs[names[0]]).output;
+        const outputRoot = node_path_1.default.dirname(firstOutput);
+        removeStaleTargetDirs(outputRoot, names, verbose);
+    }
     const sharedSources = await prepareSharedPgpmSources(configs, cliOverrides);
     try {
         for (const name of names) {

package/esm/core/generate.d.ts

@@ -46,6 +46,8 @@ export interface GenerateMultiOptions {
     dryRun?: boolean;
     schema?: SchemaConfig;
     unifiedCli?: CliConfig | boolean;
+    /** Remove subdirectories in the output root that don't match any current target name. */
+    cleanStaleTargets?: boolean;
 }
 export interface GenerateMultiResult {
     results: Array<{
@@ -54,4 +56,10 @@ export interface GenerateMultiResult {
     }>;
     hasError: boolean;
 }
+/**
+ * Remove subdirectories in `outputRoot` that are not in `currentTargetNames`.
+ * Useful for cleaning up stale target output before a fresh multi-target generate.
+ * Returns the list of directory names that were removed.
+ */
+export declare function removeStaleTargetDirs(outputRoot: string, currentTargetNames: string[], verbose?: boolean): string[];
 export declare function generateMulti(options: GenerateMultiOptions): Promise<GenerateMultiResult>;

package/esm/core/generate.js

@@ -467,8 +467,30 @@ function applySharedPgpmDb(config, sharedSources) {
         db: sharedDbConfig,
     };
 }
+/**
+ * Remove subdirectories in `outputRoot` that are not in `currentTargetNames`.
+ * Useful for cleaning up stale target output before a fresh multi-target generate.
+ * Returns the list of directory names that were removed.
+ */
+export function removeStaleTargetDirs(outputRoot, currentTargetNames, verbose) {
+    const removed = [];
+    if (!fs.existsSync(outputRoot))
+        return removed;
+    const currentTargets = new Set(currentTargetNames);
+    const entries = fs.readdirSync(outputRoot, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && !currentTargets.has(entry.name)) {
+            fs.rmSync(path.join(outputRoot, entry.name), { recursive: true, force: true });
+            removed.push(entry.name);
+            if (verbose) {
+                console.log(`Removed stale target directory: ${entry.name}`);
+            }
+        }
+    }
+    return removed;
+}
 export async function generateMulti(options) {
-    const { configs, cliOverrides, verbose, dryRun, schema, unifiedCli } = options;
+    const { configs, cliOverrides, verbose, dryRun, schema, unifiedCli, cleanStaleTargets } = options;
     const names = Object.keys(configs);
     const results = [];
     let hasError = false;
@@ -476,6 +498,12 @@ export async function generateMulti(options) {
     const targetInfos = [];
     const useUnifiedCli = !schemaEnabled && !!unifiedCli && names.length > 1;
     const cliTargets = [];
+    // Remove stale target directories before generating
+    if (cleanStaleTargets && names.length > 0 && !dryRun) {
+        const firstOutput = getConfigOptions(configs[names[0]]).output;
+        const outputRoot = path.dirname(firstOutput);
+        removeStaleTargetDirs(outputRoot, names, verbose);
+    }
     const sharedSources = await prepareSharedPgpmSources(configs, cliOverrides);
     try {
         for (const name of names) {

package/esm/index.d.ts

@@ -11,7 +11,7 @@ export * from './generators';
 export * from './client';
 export { defineConfig } from './types/config';
 export type { GenerateOptions, GenerateResult, GenerateMultiOptions, GenerateMultiResult } from './core/generate';
-export { generate, generateMulti, expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget } from './core/generate';
+export { generate, generateMulti, expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget, removeStaleTargetDirs } from './core/generate';
 export { findConfigFile, loadConfigFile } from './core/config';
 export { runCodegenHandler } from './cli/handler';
 export type { CodegenAnswers } from './cli/shared';

package/esm/index.js

@@ -15,7 +15,7 @@ export * from './generators';
 export * from './client';
 // Config definition helper
 export { defineConfig } from './types/config';
-export { generate, generateMulti, expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget } from './core/generate';
+export { generate, generateMulti, expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget, removeStaleTargetDirs } from './core/generate';
 // Config utilities
 export { findConfigFile, loadConfigFile } from './core/config';
 // CLI shared utilities (for packages/cli to import)

package/index.d.ts

@@ -11,7 +11,7 @@ export * from './generators';
 export * from './client';
 export { defineConfig } from './types/config';
 export type { GenerateOptions, GenerateResult, GenerateMultiOptions, GenerateMultiResult } from './core/generate';
-export { generate, generateMulti, expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget } from './core/generate';
+export { generate, generateMulti, expandApiNamesToMultiTarget, expandSchemaDirToMultiTarget, removeStaleTargetDirs } from './core/generate';
 export { findConfigFile, loadConfigFile } from './core/config';
 export { runCodegenHandler } from './cli/handler';
 export type { CodegenAnswers } from './cli/shared';

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.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;
+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.removeStaleTargetDirs = exports.expandSchemaDirToMultiTarget = exports.expandApiNamesToMultiTarget = exports.generateMulti = exports.generate = exports.defineConfig = void 0;
 // Core types
 __exportStar(require("./types"), exports);
 // Core query building
@@ -38,6 +38,7 @@ Object.defineProperty(exports, "generate", { enumerable: true, get: function ()
 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; } });
+Object.defineProperty(exports, "removeStaleTargetDirs", { enumerable: true, get: function () { return generate_1.removeStaleTargetDirs; } });
 // Config utilities
 var config_2 = require("./core/config");
 Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return config_2.findConfigFile; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.46.0",
+  "version": "4.47.0",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -56,7 +56,7 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.29.1",
     "@babel/types": "^7.29.0",
-    "@constructive-io/graphql-query": "^3.27.0",
+    "@constructive-io/graphql-query": "^3.27.1",
     "@constructive-io/graphql-types": "^3.12.0",
     "@inquirerer/utils": "^3.3.7",
     "@pgpmjs/core": "^6.21.0",
@@ -64,7 +64,7 @@
     "deepmerge": "^4.3.1",
     "find-and-require-package-json": "^0.9.1",
     "gql-ast": "^3.11.0",
-    "graphile-schema": "^1.22.0",
+    "graphile-schema": "^1.22.1",
     "graphql": "16.13.0",
     "inflekt": "^0.7.1",
     "inquirerer": "^4.8.1",
@@ -100,5 +100,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "0503916f414a3b8a6f6cbe46e03a59988b2f3cb5"
+  "gitHead": "6e5e79cbc24e2861963aeb1f6daff6d55279f081"
 }