@constructive-io/graphql-codegen 3.0.4 → 3.1.1

package/README.md

@@ -183,6 +183,8 @@ interface GraphQLSDKConfigTarget {
   // Generator flags
   reactQuery?: boolean;                 // Generate React Query hooks (output: {output}/hooks)
   orm?: boolean;                        // Generate ORM client (output: {output}/orm)
+  browserCompatible?: boolean;          // Generate browser-compatible code (default: true)
+                                        // Set to false for Node.js with localhost DNS fix
 
   // Table filtering (for CRUD operations from _meta)
   tables?: {
@@ -683,6 +685,8 @@ Generator Options:
   -t, --target <name>              Target name in config file
   -o, --output <dir>               Output directory
   -a, --authorization <token>      Authorization header value
+  --browser-compatible             Generate browser-compatible code (default: true)
+                                   Set to false for Node.js with localhost DNS fix
   --skip-custom-operations         Only generate table CRUD operations
   --dry-run                        Preview without writing files
   --keep-db                        Keep ephemeral database after generation (pgpm modes)

package/cli/index.js

@@ -33,6 +33,8 @@ Generator Options:
   -o, --output <dir>            Output directory
   -t, --target <name>           Target name (for multi-target configs)
   -a, --authorization <token>   Authorization header value
+  --browser-compatible          Generate browser-compatible code (default: true)
+                                Set to false for Node.js with localhost DNS fix
   --dry-run                     Preview without writing files
   -v, --verbose                 Show detailed output
 
@@ -105,6 +107,7 @@ const commands = async (argv, prompter, _options) => {
         authorization: answers.authorization,
         reactQuery: answers.reactQuery,
         orm: answers.orm,
+        browserCompatible: answers.browserCompatible,
         dryRun: answers.dryRun,
         verbose: answers.verbose,
     });
@@ -126,7 +129,7 @@ exports.options = {
             v: 'verbose',
         },
         boolean: [
-            'help', 'version', 'verbose', 'dry-run', 'react-query', 'orm', 'keep-db',
+            'help', 'version', 'verbose', 'dry-run', 'react-query', 'orm', 'keep-db', 'browser-compatible',
         ],
         string: [
             'config', 'endpoint', 'schema-file', 'output', 'target', 'authorization',

package/cli/shared.d.ts

@@ -21,6 +21,7 @@ export interface CodegenAnswers {
     apiNames?: string[];
     reactQuery?: boolean;
     orm?: boolean;
+    browserCompatible?: boolean;
     authorization?: string;
     dryRun?: boolean;
     verbose?: boolean;

package/cli/shared.js

@@ -65,6 +65,14 @@ exports.codegenQuestions = [
         default: false,
         useDefault: true,
     },
+    {
+        name: 'browserCompatible',
+        message: 'Generate browser-compatible code?',
+        type: 'confirm',
+        required: false,
+        default: true,
+        useDefault: true,
+    },
     {
         name: 'authorization',
         message: 'Authorization header value',

package/core/codegen/client.d.ts

@@ -1,4 +1,14 @@
+export interface GenerateClientFileOptions {
+    /**
+     * Generate browser-compatible code using native fetch
+     * When true (default), uses native W3C fetch API
+     * When false, uses undici fetch with dispatcher support for localhost DNS resolution
+     * @default true
+     */
+    browserCompatible?: boolean;
+}
 /**
  * Generate client.ts content
+ * @param options - Generation options
  */
-export declare function generateClientFile(): string;
+export declare function generateClientFile(options?: GenerateClientFileOptions): string;

package/core/codegen/client.js

@@ -1,264 +1,79 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateClientFile = generateClientFile;
 /**
  * Client generator - generates client.ts with configure() and execute()
- */
-const utils_1 = require("./utils");
-/**
- * Generate client.ts content
- */
-function generateClientFile() {
-    return `${(0, utils_1.getGeneratedFileHeader)('GraphQL client configuration and execution')}
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-export interface GraphQLClientConfig {
-  /** GraphQL endpoint URL */
-  endpoint: string;
-  /** Default headers to include in all requests */
-  headers?: Record<string, string>;
-}
-
-let globalConfig: GraphQLClientConfig | null = null;
-
-/**
- * Configure the GraphQL client
- *
- * @example
- * \`\`\`ts
- * import { configure } from './generated';
- *
- * configure({
- *   endpoint: 'https://api.example.com/graphql',
- *   headers: {
- *     Authorization: 'Bearer <token>',
- *   },
- * });
- * \`\`\`
- */
-export function configure(config: GraphQLClientConfig): void {
-  globalConfig = config;
-}
-
-/**
- * Get the current configuration
- * @throws Error if not configured
- */
-export function getConfig(): GraphQLClientConfig {
-  if (!globalConfig) {
-    throw new Error(
-      'GraphQL client not configured. Call configure() before making requests.'
-    );
-  }
-  return globalConfig;
-}
-
-/**
- * Set a single header value
- * Useful for updating Authorization after login
  *
- * @example
- * \`\`\`ts
- * setHeader('Authorization', 'Bearer <new-token>');
- * \`\`\`
+ * Reads from template files in the templates/ directory for proper type checking.
  */
-export function setHeader(key: string, value: string): void {
-  const config = getConfig();
-  globalConfig = {
-    ...config,
-    headers: { ...config.headers, [key]: value },
-  };
-}
-
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const utils_1 = require("./utils");
 /**
- * Merge multiple headers into the current configuration
- *
- * @example
- * \`\`\`ts
- * setHeaders({ Authorization: 'Bearer <token>', 'X-Custom': 'value' });
- * \`\`\`
+ * Find a template file path.
+ * Templates are at ./templates/ relative to this file in both src/ and dist/.
  */
-export function setHeaders(headers: Record<string, string>): void {
-  const config = getConfig();
-  globalConfig = {
-    ...config,
-    headers: { ...config.headers, ...headers },
-  };
-}
-
-// ============================================================================
-// Error handling
-// ============================================================================
-
-export interface GraphQLError {
-  message: string;
-  locations?: Array<{ line: number; column: number }>;
-  path?: Array<string | number>;
-  extensions?: Record<string, unknown>;
-}
-
-export class GraphQLClientError extends Error {
-  constructor(
-    message: string,
-    public errors: GraphQLError[],
-    public response?: Response
-  ) {
-    super(message);
-    this.name = 'GraphQLClientError';
-  }
+function findTemplateFile(templateName) {
+    const templatePath = path.join(__dirname, 'templates', templateName);
+    if (fs.existsSync(templatePath)) {
+        return templatePath;
+    }
+    throw new Error(`Could not find template file: ${templateName}. ` +
+        `Searched in: ${templatePath}`);
 }
-
-// ============================================================================
-// Execution
-// ============================================================================
-
-export interface ExecuteOptions {
-  /** Override headers for this request */
-  headers?: Record<string, string>;
-  /** AbortSignal for request cancellation */
-  signal?: AbortSignal;
-}
-
 /**
- * Execute a GraphQL operation
- *
- * @example
- * \`\`\`ts
- * const result = await execute<CarsQueryResult, CarsQueryVariables>(
- *   carsQueryDocument,
- *   { first: 10 }
- * );
- * \`\`\`
+ * Read a template file and replace the header with generated file header
  */
-export async function execute<TData = unknown, TVariables = Record<string, unknown>>(
-  document: string,
-  variables?: TVariables,
-  options?: ExecuteOptions
-): Promise<TData> {
-  const config = getConfig();
-
-  const response = await fetch(config.endpoint, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      ...config.headers,
-      ...options?.headers,
-    },
-    body: JSON.stringify({
-      query: document,
-      variables,
-    }),
-    signal: options?.signal,
-  });
-
-  const json = await response.json();
-
-  if (json.errors && json.errors.length > 0) {
-    throw new GraphQLClientError(
-      json.errors[0].message || 'GraphQL request failed',
-      json.errors,
-      response
-    );
-  }
-
-  return json.data as TData;
+function readTemplateFile(templateName, description) {
+    const templatePath = findTemplateFile(templateName);
+    let content = fs.readFileSync(templatePath, 'utf-8');
+    // Replace the source file header comment with the generated file header
+    // Match the header pattern used in template files
+    const headerPattern = /\/\*\*[\s\S]*?\* NOTE: This file is read at codegen time and written to output\.[\s\S]*?\*\/\n*/;
+    content = content.replace(headerPattern, (0, utils_1.getGeneratedFileHeader)(description) + '\n');
+    return content;
 }
-
 /**
- * Execute a GraphQL operation with full response (data + errors)
- * Useful when you want to handle partial data with errors
- */
-export async function executeWithErrors<TData = unknown, TVariables = Record<string, unknown>>(
-  document: string,
-  variables?: TVariables,
-  options?: ExecuteOptions
-): Promise<{ data: TData | null; errors: GraphQLError[] | null }> {
-  const config = getConfig();
-
-  const response = await fetch(config.endpoint, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      ...config.headers,
-      ...options?.headers,
-    },
-    body: JSON.stringify({
-      query: document,
-      variables,
-    }),
-    signal: options?.signal,
-  });
-
-  const json = await response.json();
-
-  return {
-    data: json.data ?? null,
-    errors: json.errors ?? null,
-  };
-}
-
-// ============================================================================
-// QueryClient Factory
-// ============================================================================
-
-/**
- * Default QueryClient configuration optimized for GraphQL
- *
- * These defaults provide a good balance between freshness and performance:
- * - staleTime: 1 minute - data considered fresh, won't refetch
- * - gcTime: 5 minutes - unused data kept in cache
- * - refetchOnWindowFocus: false - don't refetch when tab becomes active
- * - retry: 1 - retry failed requests once
- */
-export const defaultQueryClientOptions = {
-  defaultOptions: {
-    queries: {
-      staleTime: 1000 * 60, // 1 minute
-      gcTime: 1000 * 60 * 5, // 5 minutes
-      refetchOnWindowFocus: false,
-      retry: 1,
-    },
-  },
-};
-
-/**
- * QueryClient options type for createQueryClient
+ * Generate client.ts content
+ * @param options - Generation options
  */
-export interface CreateQueryClientOptions {
-  defaultOptions?: {
-    queries?: {
-      staleTime?: number;
-      gcTime?: number;
-      refetchOnWindowFocus?: boolean;
-      retry?: number | boolean;
-      retryDelay?: number | ((attemptIndex: number) => number);
-    };
-    mutations?: {
-      retry?: number | boolean;
-      retryDelay?: number | ((attemptIndex: number) => number);
-    };
-  };
-}
-
-// Note: createQueryClient is available when using with @tanstack/react-query
-// Import QueryClient from '@tanstack/react-query' and use these options:
-//
-// import { QueryClient } from '@tanstack/react-query';
-// const queryClient = new QueryClient(defaultQueryClientOptions);
-//
-// Or merge with your own options:
-// const queryClient = new QueryClient({
-//   ...defaultQueryClientOptions,
-//   defaultOptions: {
-//     ...defaultQueryClientOptions.defaultOptions,
-//     queries: {
-//       ...defaultQueryClientOptions.defaultOptions.queries,
-//       staleTime: 30000, // Override specific options
-//     },
-//   },
-// });
-`;
+function generateClientFile(options = {}) {
+    const { browserCompatible = true } = options;
+    const templateName = browserCompatible
+        ? 'client.browser.ts'
+        : 'client.node.ts';
+    return readTemplateFile(templateName, 'GraphQL client configuration and execution');
 }

package/core/codegen/index.js

@@ -45,7 +45,9 @@ function generate(options) {
     // 1. Generate client.ts
     files.push({
         path: 'client.ts',
-        content: (0, client_1.generateClientFile)(),
+        content: (0, client_1.generateClientFile)({
+            browserCompatible: config.browserCompatible ?? true,
+        }),
     });
     // Collect table type names for import path resolution
     const tableTypeNames = new Set(tables.map((t) => (0, utils_1.getTableNames)(t).typeName));

package/core/codegen/orm/client-generator.d.ts

@@ -11,17 +11,20 @@ export interface GeneratedClientFile {
 /**
  * Generate the main client.ts file (OrmClient class)
  * This is the runtime client that handles GraphQL execution
+ *
+ * Reads from the templates directory for proper type checking.
  */
 export declare function generateOrmClientFile(): GeneratedClientFile;
 /**
  * Generate the query-builder.ts file (runtime query builder)
  *
- * Reads from the actual TypeScript file in the source directory,
- * which enables proper type checking and testability.
+ * Reads from the templates directory for proper type checking and testability.
  */
 export declare function generateQueryBuilderFile(): GeneratedClientFile;
 /**
  * Generate the select-types.ts file
+ *
+ * Reads from the templates directory for proper type checking.
  */
 export declare function generateSelectTypesFile(): GeneratedClientFile;
 /**