@constructive-io/graphql-codegen 4.2.0 → 4.4.0

package/esm/core/codegen/orm/client-generator.js

@@ -75,7 +75,7 @@ function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false
 /**
  * Generate the main index.ts with createClient factory
  */
-export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations) {
+export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations, options) {
     const statements = [];
     // Add imports
     // Import OrmClient (value) and OrmClientConfig (type) separately
@@ -117,6 +117,12 @@ export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMuta
     statements.push(t.exportAllDeclaration(t.stringLiteral('./select-types')));
     // Re-export all models
     statements.push(t.exportAllDeclaration(t.stringLiteral('./models')));
+    // Re-export NodeHttpAdapter when enabled (for use in any Node.js application)
+    if (options?.nodeHttpAdapter) {
+        statements.push(t.exportNamedDeclaration(null, [
+            t.exportSpecifier(t.identifier('NodeHttpAdapter'), t.identifier('NodeHttpAdapter')),
+        ], t.stringLiteral('./node-fetch')));
+    }
     // Re-export custom operations
     if (hasCustomQueries) {
         statements.push(t.exportNamedDeclaration(null, [

package/esm/core/codegen/orm/index.js

@@ -87,7 +87,7 @@ export function generateOrm(options) {
     const typesBarrel = generateTypesBarrel(useSharedTypes);
     files.push({ path: typesBarrel.fileName, content: typesBarrel.content });
     // 7. Generate main index.ts with createClient
-    const indexFile = generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations);
+    const indexFile = generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations, { nodeHttpAdapter: !!options.config.nodeHttpAdapter });
     files.push({ path: indexFile.fileName, content: indexFile.content });
     return {
         files,

package/esm/core/generate.js

@@ -34,6 +34,9 @@ export async function generate(options = {}, internalOptions) {
     const runReactQuery = config.reactQuery ?? false;
     const runCli = internalOptions?.skipCli ? false : !!config.cli;
     const runOrm = runReactQuery || !!config.cli || (options.orm !== undefined ? !!options.orm : false);
+    // 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) {
         return {
             success: false,
@@ -167,13 +170,22 @@ export async function generate(options = {}, internalOptions) {
                 mutations: customOperations.mutations,
                 typeRegistry: customOperations.typeRegistry,
             },
-            config,
+            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
             sharedTypesPath: bothEnabled ? '..' : undefined,
         });
         filesToWrite.push(...files.map((file) => ({
             ...file,
             path: path.posix.join('orm', file.path),
         })));
+        // Generate NodeHttpAdapter in ORM output when enabled
+        if (useNodeHttpAdapter) {
+            const { generateNodeFetchFile } = await import('./codegen/cli/utils-generator');
+            const nodeFetchFile = generateNodeFetchFile();
+            filesToWrite.push({
+                path: path.posix.join('orm', nodeFetchFile.fileName),
+                content: nodeFetchFile.content,
+            });
+        }
     }
     // Generate CLI commands
     if (runCli) {
@@ -184,7 +196,7 @@ export async function generate(options = {}, internalOptions) {
                 queries: customOperations.queries,
                 mutations: customOperations.mutations,
             },
-            config,
+            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
         });
         filesToWrite.push(...files.map((file) => ({
             path: path.posix.join('cli', file.fileName),
@@ -510,10 +522,17 @@ export async function generateMulti(options) {
         if (useUnifiedCli && cliTargets.length > 0 && !dryRun) {
             const cliConfig = typeof unifiedCli === 'object' ? unifiedCli : {};
             const toolName = cliConfig.toolName ?? 'app';
+            // Auto-enable nodeHttpAdapter for unified CLI unless explicitly disabled
+            // Check first target config for explicit nodeHttpAdapter setting
+            const firstTargetConfig = configs[names[0]];
+            const multiNodeHttpAdapter = firstTargetConfig?.nodeHttpAdapter === true ||
+                (firstTargetConfig?.nodeHttpAdapter !== false);
             const { files } = generateMultiTargetCli({
                 toolName,
                 builtinNames: cliConfig.builtinNames,
                 targets: cliTargets,
+                nodeHttpAdapter: multiNodeHttpAdapter,
+                entryPoint: cliConfig.entryPoint,
             });
             const cliFilesToWrite = files.map((file) => ({
                 path: path.posix.join('cli', file.fileName),

package/esm/types/config.d.ts

@@ -169,6 +169,14 @@ export interface CliConfig {
      *           context -> 'context' (renamed to 'env' on collision)
      */
     builtinNames?: BuiltinNames;
+    /**
+     * Generate a runnable index.ts entry point for the CLI.
+     * When true, generates an index.ts that imports the command map,
+     * handles --version and --tty flags, and starts the inquirerer CLI.
+     * Useful for projects that want a ready-to-run CLI without a custom entry point.
+     * @default false
+     */
+    entryPoint?: boolean;
 }
 /**
  * Target configuration for graphql-codegen
@@ -278,6 +286,24 @@ export interface GraphQLSDKConfigTarget {
      * @default false
      */
     orm?: boolean;
+    /**
+     * Enable NodeHttpAdapter generation for Node.js applications.
+     * When true, generates a node-fetch.ts with NodeHttpAdapter (implements GraphQLAdapter)
+     * using node:http/node:https for requests, enabling local development
+     * with subdomain-based routing (e.g. auth.localhost:3000).
+     * No global patching — the adapter is passed to createClient via the adapter option.
+     *
+     * When CLI generation is enabled (`cli: true`), this is auto-enabled unless
+     * explicitly set to `false`.
+     *
+     * Can also be used standalone with the ORM client for any Node.js application:
+     * ```ts
+     * import { NodeHttpAdapter } from './orm/node-fetch';
+     * const db = createClient({ adapter: new NodeHttpAdapter(endpoint, headers) });
+     * ```
+     * @default false
+     */
+    nodeHttpAdapter?: boolean;
     /**
      * Whether to generate React Query hooks
      * When enabled, generates React Query hooks to {output}/hooks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.2.0",
+  "version": "4.4.0",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -56,24 +56,24 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.28.6",
     "@babel/types": "^7.28.6",
-    "@constructive-io/graphql-types": "^3.0.0",
+    "@constructive-io/graphql-types": "^3.1.0",
     "@inquirerer/utils": "^3.2.3",
-    "@pgpmjs/core": "^6.1.0",
+    "@pgpmjs/core": "^6.2.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.1",
+    "gql-ast": "^3.1.0",
+    "graphile-schema": "^1.2.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.1.0",
-    "pgsql-seed": "^2.1.0",
+    "pg-cache": "^3.1.0",
+    "pg-env": "^1.5.0",
+    "pgsql-client": "^3.2.0",
+    "pgsql-seed": "^2.2.0",
     "undici": "^7.19.0"
   },
   "peerDependencies": {
@@ -100,5 +100,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "b4e199d40e7495f25bafb6e8d318e731bd19b32c"
+  "gitHead": "2ce4c3c62998a3c57eb04bfb67ce47bb9490f384"
 }

package/types/config.d.ts

@@ -169,6 +169,14 @@ export interface CliConfig {
      *           context -> 'context' (renamed to 'env' on collision)
      */
     builtinNames?: BuiltinNames;
+    /**
+     * Generate a runnable index.ts entry point for the CLI.
+     * When true, generates an index.ts that imports the command map,
+     * handles --version and --tty flags, and starts the inquirerer CLI.
+     * Useful for projects that want a ready-to-run CLI without a custom entry point.
+     * @default false
+     */
+    entryPoint?: boolean;
 }
 /**
  * Target configuration for graphql-codegen
@@ -278,6 +286,24 @@ export interface GraphQLSDKConfigTarget {
      * @default false
      */
     orm?: boolean;
+    /**
+     * Enable NodeHttpAdapter generation for Node.js applications.
+     * When true, generates a node-fetch.ts with NodeHttpAdapter (implements GraphQLAdapter)
+     * using node:http/node:https for requests, enabling local development
+     * with subdomain-based routing (e.g. auth.localhost:3000).
+     * No global patching — the adapter is passed to createClient via the adapter option.
+     *
+     * When CLI generation is enabled (`cli: true`), this is auto-enabled unless
+     * explicitly set to `false`.
+     *
+     * Can also be used standalone with the ORM client for any Node.js application:
+     * ```ts
+     * import { NodeHttpAdapter } from './orm/node-fetch';
+     * const db = createClient({ adapter: new NodeHttpAdapter(endpoint, headers) });
+     * ```
+     * @default false
+     */
+    nodeHttpAdapter?: boolean;
     /**
      * Whether to generate React Query hooks
      * When enabled, generates React Query hooks to {output}/hooks