@constructive-io/graphql-codegen 2.20.1 → 2.21.0

package/esm/cli/codegen/queries.d.ts

@@ -11,15 +11,19 @@ export interface GeneratedQueryFile {
     fileName: string;
     content: string;
 }
+export interface QueryGeneratorOptions {
+    /** Whether to generate React Query hooks (default: true for backwards compatibility) */
+    reactQueryEnabled?: boolean;
+}
 /**
  * Generate list query hook file content using AST
  */
-export declare function generateListQueryHook(table: CleanTable): GeneratedQueryFile;
+export declare function generateListQueryHook(table: CleanTable, options?: QueryGeneratorOptions): GeneratedQueryFile;
 /**
  * Generate single item query hook file content using AST
  */
-export declare function generateSingleQueryHook(table: CleanTable): GeneratedQueryFile;
+export declare function generateSingleQueryHook(table: CleanTable, options?: QueryGeneratorOptions): GeneratedQueryFile;
 /**
  * Generate all query hook files for all tables
  */
-export declare function generateAllQueryHooks(tables: CleanTable[]): GeneratedQueryFile[];
+export declare function generateAllQueryHooks(tables: CleanTable[], options?: QueryGeneratorOptions): GeneratedQueryFile[];

package/esm/cli/codegen/queries.js

@@ -7,7 +7,8 @@ import { getTableNames, getListQueryHookName, getSingleQueryHookName, getListQue
 /**
  * Generate list query hook file content using AST
  */
-export function generateListQueryHook(table) {
+export function generateListQueryHook(table, options = {}) {
+    const { reactQueryEnabled = true } = options;
     const project = createProject();
     const { typeName, pluralName } = getTableNames(table);
     const hookName = getListQueryHookName(table);
@@ -20,7 +21,10 @@ export function generateListQueryHook(table) {
     const queryDocument = printGraphQL(queryAST);
     const sourceFile = createSourceFile(project, getListQueryFileName(table));
     // Add file header as leading comment
-    sourceFile.insertText(0, createFileHeader(`List query hook for ${typeName}`) + '\n\n');
+    const headerText = reactQueryEnabled
+        ? `List query hook for ${typeName}`
+        : `List query functions for ${typeName}`;
+    sourceFile.insertText(0, createFileHeader(headerText) + '\n\n');
     // Collect all filter types used by this table's fields
     const filterTypesUsed = new Set();
     for (const field of scalarFields) {
@@ -29,23 +33,24 @@ export function generateListQueryHook(table) {
             filterTypesUsed.add(filterType);
         }
     }
-    // Add imports
-    sourceFile.addImportDeclarations([
-        createImport({
+    // Add imports - conditionally include React Query imports
+    const imports = [];
+    if (reactQueryEnabled) {
+        imports.push(createImport({
             moduleSpecifier: '@tanstack/react-query',
             namedImports: ['useQuery'],
             typeOnlyNamedImports: ['UseQueryOptions', 'QueryClient'],
-        }),
-        createImport({
-            moduleSpecifier: '../client',
-            namedImports: ['execute'],
-            typeOnlyNamedImports: ['ExecuteOptions'],
-        }),
-        createImport({
-            moduleSpecifier: '../types',
-            typeOnlyNamedImports: [typeName, ...Array.from(filterTypesUsed)],
-        }),
-    ]);
+        }));
+    }
+    imports.push(createImport({
+        moduleSpecifier: '../client',
+        namedImports: ['execute'],
+        typeOnlyNamedImports: ['ExecuteOptions'],
+    }), createImport({
+        moduleSpecifier: '../types',
+        typeOnlyNamedImports: [typeName, ...Array.from(filterTypesUsed)],
+    }));
+    sourceFile.addImportDeclarations(imports);
     // Re-export entity type
     sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
     // Add section comment
@@ -109,27 +114,28 @@ export function generateListQueryHook(table) {
     // Query key factory
     sourceFile.addVariableStatement(createConst(`${queryName}QueryKey`, `(variables?: ${ucFirst(pluralName)}QueryVariables) =>
   ['${typeName.toLowerCase()}', 'list', variables] as const`));
-    // Add section comment
-    sourceFile.addStatements('\n// ============================================================================');
-    sourceFile.addStatements('// Hook');
-    sourceFile.addStatements('// ============================================================================\n');
-    // Hook function
-    sourceFile.addFunction({
-        name: hookName,
-        isExported: true,
-        parameters: [
-            {
-                name: 'variables',
-                type: `${ucFirst(pluralName)}QueryVariables`,
-                hasQuestionToken: true,
-            },
-            {
-                name: 'options',
-                type: `Omit<UseQueryOptions<${ucFirst(pluralName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
-                hasQuestionToken: true,
-            },
-        ],
-        statements: `return useQuery({
+    // Add React Query hook section (only if enabled)
+    if (reactQueryEnabled) {
+        sourceFile.addStatements('\n// ============================================================================');
+        sourceFile.addStatements('// Hook');
+        sourceFile.addStatements('// ============================================================================\n');
+        // Hook function
+        sourceFile.addFunction({
+            name: hookName,
+            isExported: true,
+            parameters: [
+                {
+                    name: 'variables',
+                    type: `${ucFirst(pluralName)}QueryVariables`,
+                    hasQuestionToken: true,
+                },
+                {
+                    name: 'options',
+                    type: `Omit<UseQueryOptions<${ucFirst(pluralName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
+                    hasQuestionToken: true,
+                },
+            ],
+            statements: `return useQuery({
     queryKey: ${queryName}QueryKey(variables),
     queryFn: () => execute<${ucFirst(pluralName)}QueryResult, ${ucFirst(pluralName)}QueryVariables>(
       ${queryName}QueryDocument,
@@ -137,9 +143,9 @@ export function generateListQueryHook(table) {
     ),
     ...options,
   });`,
-        docs: [
-            {
-                description: `Query hook for fetching ${typeName} list
+            docs: [
+                {
+                    description: `Query hook for fetching ${typeName} list
 
 @example
 \`\`\`tsx
@@ -149,9 +155,10 @@ const { data, isLoading } = ${hookName}({
   orderBy: ['CREATED_AT_DESC'],
 });
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     // Add section comment for standalone functions
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Standalone Functions (non-React)');
@@ -197,29 +204,30 @@ const data = await queryClient.fetchQuery({
             },
         ],
     });
-    // Prefetch function (for SSR/QueryClient)
-    sourceFile.addFunction({
-        name: `prefetch${ucFirst(pluralName)}Query`,
-        isExported: true,
-        isAsync: true,
-        parameters: [
-            {
-                name: 'queryClient',
-                type: 'QueryClient',
-            },
-            {
-                name: 'variables',
-                type: `${ucFirst(pluralName)}QueryVariables`,
-                hasQuestionToken: true,
-            },
-            {
-                name: 'options',
-                type: 'ExecuteOptions',
-                hasQuestionToken: true,
-            },
-        ],
-        returnType: 'Promise<void>',
-        statements: `await queryClient.prefetchQuery({
+    // Prefetch function (for SSR/QueryClient) - only if React Query is enabled
+    if (reactQueryEnabled) {
+        sourceFile.addFunction({
+            name: `prefetch${ucFirst(pluralName)}Query`,
+            isExported: true,
+            isAsync: true,
+            parameters: [
+                {
+                    name: 'queryClient',
+                    type: 'QueryClient',
+                },
+                {
+                    name: 'variables',
+                    type: `${ucFirst(pluralName)}QueryVariables`,
+                    hasQuestionToken: true,
+                },
+                {
+                    name: 'options',
+                    type: 'ExecuteOptions',
+                    hasQuestionToken: true,
+                },
+            ],
+            returnType: 'Promise<void>',
+            statements: `await queryClient.prefetchQuery({
     queryKey: ${queryName}QueryKey(variables),
     queryFn: () => execute<${ucFirst(pluralName)}QueryResult, ${ucFirst(pluralName)}QueryVariables>(
       ${queryName}QueryDocument,
@@ -227,17 +235,18 @@ const data = await queryClient.fetchQuery({
       options
     ),
   });`,
-        docs: [
-            {
-                description: `Prefetch ${typeName} list for SSR or cache warming
+            docs: [
+                {
+                    description: `Prefetch ${typeName} list for SSR or cache warming
 
 @example
 \`\`\`ts
 await prefetch${ucFirst(pluralName)}Query(queryClient, { first: 10 });
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     return {
         fileName: getListQueryFileName(table),
         content: getFormattedOutput(sourceFile),
@@ -249,7 +258,8 @@ await prefetch${ucFirst(pluralName)}Query(queryClient, { first: 10 });
 /**
  * Generate single item query hook file content using AST
  */
-export function generateSingleQueryHook(table) {
+export function generateSingleQueryHook(table, options = {}) {
+    const { reactQueryEnabled = true } = options;
     const project = createProject();
     const { typeName, singularName } = getTableNames(table);
     const hookName = getSingleQueryHookName(table);
@@ -259,24 +269,28 @@ export function generateSingleQueryHook(table) {
     const queryDocument = printGraphQL(queryAST);
     const sourceFile = createSourceFile(project, getSingleQueryFileName(table));
     // Add file header
-    sourceFile.insertText(0, createFileHeader(`Single item query hook for ${typeName}`) + '\n\n');
-    // Add imports
-    sourceFile.addImportDeclarations([
-        createImport({
+    const headerText = reactQueryEnabled
+        ? `Single item query hook for ${typeName}`
+        : `Single item query functions for ${typeName}`;
+    sourceFile.insertText(0, createFileHeader(headerText) + '\n\n');
+    // Add imports - conditionally include React Query imports
+    const imports = [];
+    if (reactQueryEnabled) {
+        imports.push(createImport({
             moduleSpecifier: '@tanstack/react-query',
             namedImports: ['useQuery'],
             typeOnlyNamedImports: ['UseQueryOptions', 'QueryClient'],
-        }),
-        createImport({
-            moduleSpecifier: '../client',
-            namedImports: ['execute'],
-            typeOnlyNamedImports: ['ExecuteOptions'],
-        }),
-        createImport({
-            moduleSpecifier: '../types',
-            typeOnlyNamedImports: [typeName],
-        }),
-    ]);
+        }));
+    }
+    imports.push(createImport({
+        moduleSpecifier: '../client',
+        namedImports: ['execute'],
+        typeOnlyNamedImports: ['ExecuteOptions'],
+    }), createImport({
+        moduleSpecifier: '../types',
+        typeOnlyNamedImports: [typeName],
+    }));
+    sourceFile.addImportDeclarations(imports);
     // Re-export entity type
     sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
     // Add section comment
@@ -304,23 +318,24 @@ export function generateSingleQueryHook(table) {
     // Query key factory
     sourceFile.addVariableStatement(createConst(`${queryName}QueryKey`, `(id: string) =>
   ['${typeName.toLowerCase()}', 'detail', id] as const`));
-    // Add section comment
-    sourceFile.addStatements('\n// ============================================================================');
-    sourceFile.addStatements('// Hook');
-    sourceFile.addStatements('// ============================================================================\n');
-    // Hook function
-    sourceFile.addFunction({
-        name: hookName,
-        isExported: true,
-        parameters: [
-            { name: 'id', type: 'string' },
-            {
-                name: 'options',
-                type: `Omit<UseQueryOptions<${ucFirst(singularName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
-                hasQuestionToken: true,
-            },
-        ],
-        statements: `return useQuery({
+    // Add React Query hook section (only if enabled)
+    if (reactQueryEnabled) {
+        sourceFile.addStatements('\n// ============================================================================');
+        sourceFile.addStatements('// Hook');
+        sourceFile.addStatements('// ============================================================================\n');
+        // Hook function
+        sourceFile.addFunction({
+            name: hookName,
+            isExported: true,
+            parameters: [
+                { name: 'id', type: 'string' },
+                {
+                    name: 'options',
+                    type: `Omit<UseQueryOptions<${ucFirst(singularName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
+                    hasQuestionToken: true,
+                },
+            ],
+            statements: `return useQuery({
     queryKey: ${queryName}QueryKey(id),
     queryFn: () => execute<${ucFirst(singularName)}QueryResult, ${ucFirst(singularName)}QueryVariables>(
       ${queryName}QueryDocument,
@@ -329,9 +344,9 @@ export function generateSingleQueryHook(table) {
     enabled: !!id && (options?.enabled !== false),
     ...options,
   });`,
-        docs: [
-            {
-                description: `Query hook for fetching a single ${typeName} by ID
+            docs: [
+                {
+                    description: `Query hook for fetching a single ${typeName} by ID
 
 @example
 \`\`\`tsx
@@ -341,9 +356,10 @@ if (data?.${queryName}) {
   console.log(data.${queryName}.id);
 }
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     // Add section comment for standalone functions
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Standalone Functions (non-React)');
@@ -378,22 +394,23 @@ const data = await fetch${ucFirst(singularName)}Query('uuid-here');
             },
         ],
     });
-    // Prefetch function (for SSR/QueryClient)
-    sourceFile.addFunction({
-        name: `prefetch${ucFirst(singularName)}Query`,
-        isExported: true,
-        isAsync: true,
-        parameters: [
-            { name: 'queryClient', type: 'QueryClient' },
-            { name: 'id', type: 'string' },
-            {
-                name: 'options',
-                type: 'ExecuteOptions',
-                hasQuestionToken: true,
-            },
-        ],
-        returnType: 'Promise<void>',
-        statements: `await queryClient.prefetchQuery({
+    // Prefetch function (for SSR/QueryClient) - only if React Query is enabled
+    if (reactQueryEnabled) {
+        sourceFile.addFunction({
+            name: `prefetch${ucFirst(singularName)}Query`,
+            isExported: true,
+            isAsync: true,
+            parameters: [
+                { name: 'queryClient', type: 'QueryClient' },
+                { name: 'id', type: 'string' },
+                {
+                    name: 'options',
+                    type: 'ExecuteOptions',
+                    hasQuestionToken: true,
+                },
+            ],
+            returnType: 'Promise<void>',
+            statements: `await queryClient.prefetchQuery({
     queryKey: ${queryName}QueryKey(id),
     queryFn: () => execute<${ucFirst(singularName)}QueryResult, ${ucFirst(singularName)}QueryVariables>(
       ${queryName}QueryDocument,
@@ -401,17 +418,18 @@ const data = await fetch${ucFirst(singularName)}Query('uuid-here');
       options
     ),
   });`,
-        docs: [
-            {
-                description: `Prefetch a single ${typeName} for SSR or cache warming
+            docs: [
+                {
+                    description: `Prefetch a single ${typeName} for SSR or cache warming
 
 @example
 \`\`\`ts
 await prefetch${ucFirst(singularName)}Query(queryClient, 'uuid-here');
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     return {
         fileName: getSingleQueryFileName(table),
         content: getFormattedOutput(sourceFile),
@@ -423,11 +441,11 @@ await prefetch${ucFirst(singularName)}Query(queryClient, 'uuid-here');
 /**
  * Generate all query hook files for all tables
  */
-export function generateAllQueryHooks(tables) {
+export function generateAllQueryHooks(tables, options = {}) {
     const files = [];
     for (const table of tables) {
-        files.push(generateListQueryHook(table));
-        files.push(generateSingleQueryHook(table));
+        files.push(generateListQueryHook(table, options));
+        files.push(generateSingleQueryHook(table, options));
     }
     return files;
 }

package/esm/types/config.d.ts

@@ -95,6 +95,18 @@ export interface GraphQLSDKConfig {
          */
         useSharedTypes?: boolean;
     };
+    /**
+     * React Query integration options
+     * Controls whether React Query hooks are generated
+     */
+    reactQuery?: {
+        /**
+         * Whether to generate React Query hooks (useQuery, useMutation)
+         * When false, only standalone fetch functions are generated (no React dependency)
+         * @default false
+         */
+        enabled?: boolean;
+    };
     /**
      * Watch mode configuration (dev-only feature)
      * When enabled via CLI --watch flag, the CLI will poll the endpoint for schema changes
@@ -142,7 +154,7 @@ export interface ResolvedWatchConfig {
 /**
  * Resolved configuration with defaults applied
  */
-export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers' | 'tables' | 'queries' | 'mutations' | 'hooks' | 'postgraphile' | 'codegen' | 'orm' | 'watch'>> {
+export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers' | 'tables' | 'queries' | 'mutations' | 'hooks' | 'postgraphile' | 'codegen' | 'orm' | 'reactQuery' | 'watch'>> {
     headers: Record<string, string>;
     tables: {
         include: string[];
@@ -172,6 +184,9 @@ export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers
         output: string;
         useSharedTypes: boolean;
     } | null;
+    reactQuery: {
+        enabled: boolean;
+    };
     watch: ResolvedWatchConfig;
 }
 /**

package/esm/types/config.js

@@ -42,6 +42,9 @@ export const DEFAULT_CONFIG = {
         skipQueryField: true,
     },
     orm: null, // ORM generation disabled by default
+    reactQuery: {
+        enabled: false, // React Query hooks disabled by default
+    },
     watch: DEFAULT_WATCH_CONFIG,
 };
 /**
@@ -96,6 +99,9 @@ export function resolveConfig(config) {
                 useSharedTypes: config.orm.useSharedTypes ?? DEFAULT_ORM_CONFIG.useSharedTypes,
             }
             : null,
+        reactQuery: {
+            enabled: config.reactQuery?.enabled ?? DEFAULT_CONFIG.reactQuery.enabled,
+        },
         watch: {
             pollInterval: config.watch?.pollInterval ?? DEFAULT_WATCH_CONFIG.pollInterval,
             debounce: config.watch?.debounce ?? DEFAULT_WATCH_CONFIG.debounce,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.20.1",
+  "version": "2.21.0",
   "description": "CLI-based GraphQL SDK generator for PostGraphile endpoints with React Query hooks",
   "keywords": [
     "graphql",
@@ -78,5 +78,5 @@
     "ts-jest": "^29.2.5",
     "typescript": "^5.9.3"
   },
-  "gitHead": "fc89c642ea6c3e1cd69e47a4151cec1d802520b8"
+  "gitHead": "a8a6f2cf22eb610f385bfba63d5e6e40e0a47e50"
 }

package/types/config.d.ts

@@ -95,6 +95,18 @@ export interface GraphQLSDKConfig {
          */
         useSharedTypes?: boolean;
     };
+    /**
+     * React Query integration options
+     * Controls whether React Query hooks are generated
+     */
+    reactQuery?: {
+        /**
+         * Whether to generate React Query hooks (useQuery, useMutation)
+         * When false, only standalone fetch functions are generated (no React dependency)
+         * @default false
+         */
+        enabled?: boolean;
+    };
     /**
      * Watch mode configuration (dev-only feature)
      * When enabled via CLI --watch flag, the CLI will poll the endpoint for schema changes
@@ -142,7 +154,7 @@ export interface ResolvedWatchConfig {
 /**
  * Resolved configuration with defaults applied
  */
-export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers' | 'tables' | 'queries' | 'mutations' | 'hooks' | 'postgraphile' | 'codegen' | 'orm' | 'watch'>> {
+export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers' | 'tables' | 'queries' | 'mutations' | 'hooks' | 'postgraphile' | 'codegen' | 'orm' | 'reactQuery' | 'watch'>> {
     headers: Record<string, string>;
     tables: {
         include: string[];
@@ -172,6 +184,9 @@ export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers
         output: string;
         useSharedTypes: boolean;
     } | null;
+    reactQuery: {
+        enabled: boolean;
+    };
     watch: ResolvedWatchConfig;
 }
 /**

package/types/config.js

@@ -47,6 +47,9 @@ exports.DEFAULT_CONFIG = {
         skipQueryField: true,
     },
     orm: null, // ORM generation disabled by default
+    reactQuery: {
+        enabled: false, // React Query hooks disabled by default
+    },
     watch: exports.DEFAULT_WATCH_CONFIG,
 };
 /**
@@ -101,6 +104,9 @@ function resolveConfig(config) {
                 useSharedTypes: config.orm.useSharedTypes ?? exports.DEFAULT_ORM_CONFIG.useSharedTypes,
             }
             : null,
+        reactQuery: {
+            enabled: config.reactQuery?.enabled ?? exports.DEFAULT_CONFIG.reactQuery.enabled,
+        },
         watch: {
             pollInterval: config.watch?.pollInterval ?? exports.DEFAULT_WATCH_CONFIG.pollInterval,
             debounce: config.watch?.debounce ?? exports.DEFAULT_WATCH_CONFIG.debounce,