@constructive-io/graphql-codegen 4.19.0 → 4.20.0

package/core/codegen/barrel.d.ts

@@ -34,6 +34,16 @@ export interface RootBarrelOptions {
  * Re-exports from subdirectories based on which generators are enabled.
  */
 export declare function generateRootBarrel(options?: RootBarrelOptions): string;
+/**
+ * Generate a root index.ts for multi-target output that re-exports each
+ * target as a namespace.
+ *
+ * Example output:
+ *   export * as admin from './admin';
+ *   export * as auth from './auth';
+ *   export * as public_ from './public';
+ */
+export declare function generateMultiTargetBarrel(targetNames: string[]): string;
 /**
  * Generate queries barrel including custom query operations
  */

package/core/codegen/barrel.js

@@ -37,6 +37,7 @@ exports.generateQueriesBarrel = generateQueriesBarrel;
 exports.generateMutationsBarrel = generateMutationsBarrel;
 exports.generateMainBarrel = generateMainBarrel;
 exports.generateRootBarrel = generateRootBarrel;
+exports.generateMultiTargetBarrel = generateMultiTargetBarrel;
 exports.generateCustomQueriesBarrel = generateCustomQueriesBarrel;
 exports.generateCustomMutationsBarrel = generateCustomMutationsBarrel;
 /**
@@ -200,6 +201,49 @@ function generateRootBarrel(options = {}) {
     return (0, babel_ast_1.generateCode)(statements);
 }
 // ============================================================================
+// Multi-target root barrel (re-exports each target as a namespace)
+// ============================================================================
+/** JS reserved words that need an alias when used as export names */
+const JS_RESERVED = new Set([
+    'abstract', 'arguments', 'await', 'boolean', 'break', 'byte', 'case', 'catch',
+    'char', 'class', 'const', 'continue', 'debugger', 'default', 'delete', 'do',
+    'double', 'else', 'enum', 'eval', 'export', 'extends', 'false', 'final',
+    'finally', 'float', 'for', 'function', 'goto', 'if', 'implements', 'import',
+    'in', 'instanceof', 'int', 'interface', 'let', 'long', 'native', 'new',
+    'null', 'package', 'private', 'protected', 'public', 'return', 'short',
+    'static', 'super', 'switch', 'synchronized', 'this', 'throw', 'throws',
+    'transient', 'true', 'try', 'typeof', 'var', 'void', 'volatile', 'while',
+    'with', 'yield',
+]);
+/**
+ * Generate a root index.ts for multi-target output that re-exports each
+ * target as a namespace.
+ *
+ * Example output:
+ *   export * as admin from './admin';
+ *   export * as auth from './auth';
+ *   export * as public_ from './public';
+ */
+function generateMultiTargetBarrel(targetNames) {
+    const statements = [];
+    for (const name of targetNames) {
+        const alias = JS_RESERVED.has(name) ? `${name}_` : name;
+        const exportDecl = t.exportNamedDeclaration(null, [t.exportNamespaceSpecifier(t.identifier(alias))], t.stringLiteral(`./${name}`));
+        statements.push(exportDecl);
+    }
+    if (statements.length > 0) {
+        (0, babel_ast_1.addJSDocComment)(statements[0], [
+            '@constructive-io/sdk',
+            '',
+            'Auto-generated GraphQL types and ORM client.',
+            'Run `pnpm run generate` to populate this package from the schema files.',
+            '',
+            '@generated by @constructive-io/graphql-codegen',
+        ]);
+    }
+    return (0, babel_ast_1.generateCode)(statements);
+}
+// ============================================================================
 // Custom operation barrels (includes both table and custom hooks)
 // ============================================================================
 /**

package/core/generate.js

@@ -675,11 +675,23 @@ async function generateMulti(options) {
                 await writeFiles(cliSkillsToWrite, skillsOutputDir, [], { pruneStaleFiles: false });
             }
         }
-        // Generate root-root README if multi-target
+        // Generate root-root README and barrel if multi-target
         if (names.length > 1 && targetInfos.length > 0 && !dryRun) {
-            const rootReadme = (0, target_docs_generator_1.generateRootRootReadme)(targetInfos);
             const { writeGeneratedFiles: writeFiles } = await Promise.resolve().then(() => __importStar(require('./output')));
+            const rootReadme = (0, target_docs_generator_1.generateRootRootReadme)(targetInfos);
             await writeFiles([{ path: rootReadme.fileName, content: rootReadme.content }], '.', [], { pruneStaleFiles: false });
+            // Write a root barrel (index.ts) that re-exports each target as a
+            // namespace so the package has a single entry-point.  Derive the
+            // common output root from the first target's output path.
+            const successfulNames = results
+                .filter((r) => r.result.success)
+                .map((r) => r.name);
+            if (successfulNames.length > 0) {
+                const firstOutput = (0, config_1.getConfigOptions)(configs[successfulNames[0]]).output;
+                const outputRoot = node_path_1.default.dirname(firstOutput);
+                const barrelContent = (0, barrel_1.generateMultiTargetBarrel)(successfulNames);
+                await writeFiles([{ path: 'index.ts', content: barrelContent }], outputRoot, [], { pruneStaleFiles: false });
+            }
         }
     }
     finally {

package/esm/core/codegen/barrel.d.ts

@@ -34,6 +34,16 @@ export interface RootBarrelOptions {
  * Re-exports from subdirectories based on which generators are enabled.
  */
 export declare function generateRootBarrel(options?: RootBarrelOptions): string;
+/**
+ * Generate a root index.ts for multi-target output that re-exports each
+ * target as a namespace.
+ *
+ * Example output:
+ *   export * as admin from './admin';
+ *   export * as auth from './auth';
+ *   export * as public_ from './public';
+ */
+export declare function generateMultiTargetBarrel(targetNames: string[]): string;
 /**
  * Generate queries barrel including custom query operations
  */

package/esm/core/codegen/barrel.js

@@ -159,6 +159,49 @@ export function generateRootBarrel(options = {}) {
     return generateCode(statements);
 }
 // ============================================================================
+// Multi-target root barrel (re-exports each target as a namespace)
+// ============================================================================
+/** JS reserved words that need an alias when used as export names */
+const JS_RESERVED = new Set([
+    'abstract', 'arguments', 'await', 'boolean', 'break', 'byte', 'case', 'catch',
+    'char', 'class', 'const', 'continue', 'debugger', 'default', 'delete', 'do',
+    'double', 'else', 'enum', 'eval', 'export', 'extends', 'false', 'final',
+    'finally', 'float', 'for', 'function', 'goto', 'if', 'implements', 'import',
+    'in', 'instanceof', 'int', 'interface', 'let', 'long', 'native', 'new',
+    'null', 'package', 'private', 'protected', 'public', 'return', 'short',
+    'static', 'super', 'switch', 'synchronized', 'this', 'throw', 'throws',
+    'transient', 'true', 'try', 'typeof', 'var', 'void', 'volatile', 'while',
+    'with', 'yield',
+]);
+/**
+ * Generate a root index.ts for multi-target output that re-exports each
+ * target as a namespace.
+ *
+ * Example output:
+ *   export * as admin from './admin';
+ *   export * as auth from './auth';
+ *   export * as public_ from './public';
+ */
+export function generateMultiTargetBarrel(targetNames) {
+    const statements = [];
+    for (const name of targetNames) {
+        const alias = JS_RESERVED.has(name) ? `${name}_` : name;
+        const exportDecl = t.exportNamedDeclaration(null, [t.exportNamespaceSpecifier(t.identifier(alias))], t.stringLiteral(`./${name}`));
+        statements.push(exportDecl);
+    }
+    if (statements.length > 0) {
+        addJSDocComment(statements[0], [
+            '@constructive-io/sdk',
+            '',
+            'Auto-generated GraphQL types and ORM client.',
+            'Run `pnpm run generate` to populate this package from the schema files.',
+            '',
+            '@generated by @constructive-io/graphql-codegen',
+        ]);
+    }
+    return generateCode(statements);
+}
+// ============================================================================
 // Custom operation barrels (includes both table and custom hooks)
 // ============================================================================
 /**

package/esm/core/generate.js

@@ -13,7 +13,7 @@ import { createEphemeralDb } from 'pgsql-client';
 import { deployPgpm } from 'pgsql-seed';
 import { getConfigOptions } from '../types/config';
 import { generate as generateReactQueryFiles } from './codegen';
-import { generateRootBarrel } from './codegen/barrel';
+import { generateRootBarrel, generateMultiTargetBarrel } from './codegen/barrel';
 import { generateCli as generateCliFiles, generateMultiTargetCli } from './codegen/cli';
 import { generateReadme as generateCliReadme, generateAgentsDocs as generateCliAgentsDocs, getCliMcpTools, generateSkills as generateCliSkills, generateMultiTargetReadme, generateMultiTargetAgentsDocs, getMultiTargetCliMcpTools, generateMultiTargetSkills, } from './codegen/cli/docs-generator';
 import { resolveDocsConfig } from './codegen/docs-utils';
@@ -633,11 +633,23 @@ export async function generateMulti(options) {
                 await writeFiles(cliSkillsToWrite, skillsOutputDir, [], { pruneStaleFiles: false });
             }
         }
-        // Generate root-root README if multi-target
+        // Generate root-root README and barrel if multi-target
         if (names.length > 1 && targetInfos.length > 0 && !dryRun) {
-            const rootReadme = generateRootRootReadme(targetInfos);
             const { writeGeneratedFiles: writeFiles } = await import('./output');
+            const rootReadme = generateRootRootReadme(targetInfos);
             await writeFiles([{ path: rootReadme.fileName, content: rootReadme.content }], '.', [], { pruneStaleFiles: false });
+            // Write a root barrel (index.ts) that re-exports each target as a
+            // namespace so the package has a single entry-point.  Derive the
+            // common output root from the first target's output path.
+            const successfulNames = results
+                .filter((r) => r.result.success)
+                .map((r) => r.name);
+            if (successfulNames.length > 0) {
+                const firstOutput = getConfigOptions(configs[successfulNames[0]]).output;
+                const outputRoot = path.dirname(firstOutput);
+                const barrelContent = generateMultiTargetBarrel(successfulNames);
+                await writeFiles([{ path: 'index.ts', content: barrelContent }], outputRoot, [], { pruneStaleFiles: false });
+            }
         }
     }
     finally {

package/esm/types/config.d.ts

@@ -138,8 +138,8 @@ export interface DocsConfig {
      */
     mcp?: boolean;
     /**
-     * Generate skills/ directory — per-entity SKILL.md files with YAML frontmatter.
-     * Skills are written to the workspace root skills/ directory (not nested in output).
+     * Generate .agents/skills/ directory — per-entity SKILL.md files with YAML frontmatter.
+     * Skills are written to {workspaceRoot}/.agents/skills/ (not nested in output).
      * Uses composable naming: orm-{target}-{entity}, hooks-{target}-{entity}, cli-{target}-{entity}.
      * @default false
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.19.0",
+  "version": "4.20.0",
   "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.8.0",
+    "@constructive-io/graphql-query": "^3.8.1",
     "@constructive-io/graphql-types": "^3.3.4",
     "@inquirerer/utils": "^3.3.4",
-    "@pgpmjs/core": "^6.8.0",
+    "@pgpmjs/core": "^6.8.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.8.0",
+    "graphile-schema": "^1.8.1",
     "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.8",
-    "pgsql-seed": "^2.5.8",
+    "pgsql-client": "^3.5.9",
+    "pgsql-seed": "^2.5.9",
     "undici": "^7.24.3"
   },
   "peerDependencies": {
@@ -101,5 +101,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "3ca5054c7471ffa8deaea5a369edf46a4f0a5313"
+  "gitHead": "9bd7e1bb2eb2e66ac18dce50cc29b84ef667649e"
 }

package/types/config.d.ts

@@ -138,8 +138,8 @@ export interface DocsConfig {
      */
     mcp?: boolean;
     /**
-     * Generate skills/ directory — per-entity SKILL.md files with YAML frontmatter.
-     * Skills are written to the workspace root skills/ directory (not nested in output).
+     * Generate .agents/skills/ directory — per-entity SKILL.md files with YAML frontmatter.
+     * Skills are written to {workspaceRoot}/.agents/skills/ (not nested in output).
      * Uses composable naming: orm-{target}-{entity}, hooks-{target}-{entity}, cli-{target}-{entity}.
      * @default false
      */