@constructive-io/graphql-codegen 2.20.0 → 2.21.0

package/README.md

@@ -1,4 +1,16 @@
-# @constructive-io/graphql-sdk
+# @constructive-io/graphql-codegen
+
+<p align="center" width="100%">
+  <img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
+</p>
+
+<p align="center" width="100%">
+  <a href="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml">
+    <img height="20" src="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml/badge.svg" />
+  </a>
+   <a href="https://github.com/constructive-io/constructive/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
+   <a href="https://www.npmjs.com/package/@constructive-io/graphql-codegen"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/constructive?filename=graphql%2Fcodegen%2Fpackage.json"/></a>
+</p>
 
 CLI-based GraphQL SDK generator for PostGraphile endpoints. Generate type-safe React Query hooks or a Prisma-like ORM client from your GraphQL schema.
 
@@ -39,7 +51,7 @@ CLI-based GraphQL SDK generator for PostGraphile endpoints. Generate type-safe R
 ## Installation
 
 ```bash
-pnpm add @constructive-io/graphql-sdk
+pnpm add @constructive-io/graphql-codegen
 ```
 
 ## Quick Start
@@ -53,7 +65,7 @@ npx graphql-sdk init
 Creates a `graphql-sdk.config.ts` file:
 
 ```typescript
-import { defineConfig } from '@constructive-io/graphql-sdk';
+import { defineConfig } from '@constructive-io/graphql-codegen';
 
 export default defineConfig({
   endpoint: 'https://api.example.com/graphql',

package/__tests__/codegen/react-query-optional.test.d.ts

@@ -0,0 +1 @@
+export {};

package/__tests__/codegen/react-query-optional.test.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Tests for React Query optional flag in code generators
+ *
+ * Verifies that when reactQueryEnabled is false:
+ * - Query generators skip React Query imports and hooks
+ * - Mutation generators return null (since they require React Query)
+ * - Standalone fetch functions are still generated for queries
+ */
+const queries_1 = require("../../cli/codegen/queries");
+const mutations_1 = require("../../cli/codegen/mutations");
+const custom_queries_1 = require("../../cli/codegen/custom-queries");
+const custom_mutations_1 = require("../../cli/codegen/custom-mutations");
+// ============================================================================
+// Test Fixtures
+// ============================================================================
+const fieldTypes = {
+    uuid: { gqlType: 'UUID', isArray: false },
+    string: { gqlType: 'String', isArray: false },
+    int: { gqlType: 'Int', isArray: false },
+    datetime: { gqlType: 'Datetime', isArray: false },
+};
+const emptyRelations = {
+    belongsTo: [],
+    hasOne: [],
+    hasMany: [],
+    manyToMany: [],
+};
+function createTable(partial) {
+    return {
+        name: partial.name,
+        fields: partial.fields ?? [],
+        relations: partial.relations ?? emptyRelations,
+        query: partial.query,
+        inflection: partial.inflection,
+        constraints: partial.constraints,
+    };
+}
+const userTable = createTable({
+    name: 'User',
+    fields: [
+        { name: 'id', type: fieldTypes.uuid },
+        { name: 'email', type: fieldTypes.string },
+        { name: 'name', type: fieldTypes.string },
+        { name: 'createdAt', type: fieldTypes.datetime },
+    ],
+    query: {
+        all: 'users',
+        one: 'user',
+        create: 'createUser',
+        update: 'updateUser',
+        delete: 'deleteUser',
+    },
+});
+function createTypeRef(kind, name, ofType) {
+    return { kind, name, ofType };
+}
+const sampleQueryOperation = {
+    name: 'currentUser',
+    kind: 'query',
+    args: [],
+    returnType: createTypeRef('OBJECT', 'User'),
+    description: 'Get the current authenticated user',
+};
+const sampleMutationOperation = {
+    name: 'login',
+    kind: 'mutation',
+    args: [
+        { name: 'email', type: createTypeRef('NON_NULL', null, createTypeRef('SCALAR', 'String')) },
+        { name: 'password', type: createTypeRef('NON_NULL', null, createTypeRef('SCALAR', 'String')) },
+    ],
+    returnType: createTypeRef('OBJECT', 'LoginPayload'),
+    description: 'Authenticate user',
+};
+const emptyTypeRegistry = new Map();
+// ============================================================================
+// Tests - Query Generators with reactQueryEnabled: false
+// ============================================================================
+describe('Query generators with reactQueryEnabled: false', () => {
+    describe('generateListQueryHook', () => {
+        it('should not include React Query imports when disabled', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).not.toContain('@tanstack/react-query');
+            expect(result.content).not.toContain('useQuery');
+            expect(result.content).not.toContain('UseQueryOptions');
+        });
+        it('should not include useXxxQuery hook when disabled', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).not.toContain('export function useUsersQuery');
+        });
+        it('should not include prefetch function when disabled', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).not.toContain('export async function prefetchUsersQuery');
+        });
+        it('should still include standalone fetch function when disabled', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).toContain('export async function fetchUsersQuery');
+        });
+        it('should still include GraphQL document when disabled', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).toContain('usersQueryDocument');
+        });
+        it('should still include query key factory when disabled', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).toContain('usersQueryKey');
+        });
+        it('should update file header when disabled', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).toContain('List query functions for User');
+        });
+    });
+    describe('generateSingleQueryHook', () => {
+        it('should not include React Query imports when disabled', () => {
+            const result = (0, queries_1.generateSingleQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).not.toContain('@tanstack/react-query');
+            expect(result.content).not.toContain('useQuery');
+        });
+        it('should not include useXxxQuery hook when disabled', () => {
+            const result = (0, queries_1.generateSingleQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).not.toContain('export function useUserQuery');
+        });
+        it('should still include standalone fetch function when disabled', () => {
+            const result = (0, queries_1.generateSingleQueryHook)(userTable, { reactQueryEnabled: false });
+            expect(result.content).toContain('export async function fetchUserQuery');
+        });
+    });
+    describe('generateAllQueryHooks', () => {
+        it('should generate files without React Query when disabled', () => {
+            const results = (0, queries_1.generateAllQueryHooks)([userTable], { reactQueryEnabled: false });
+            expect(results.length).toBe(2); // list + single
+            for (const result of results) {
+                expect(result.content).not.toContain('@tanstack/react-query');
+                expect(result.content).not.toContain('useQuery');
+            }
+        });
+    });
+});
+// ============================================================================
+// Tests - Query Generators with reactQueryEnabled: true (default)
+// ============================================================================
+describe('Query generators with reactQueryEnabled: true (default)', () => {
+    describe('generateListQueryHook', () => {
+        it('should include React Query imports by default', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable);
+            expect(result.content).toContain('@tanstack/react-query');
+            expect(result.content).toContain('useQuery');
+        });
+        it('should include useXxxQuery hook by default', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable);
+            expect(result.content).toContain('export function useUsersQuery');
+        });
+        it('should include prefetch function by default', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable);
+            expect(result.content).toContain('export async function prefetchUsersQuery');
+        });
+        it('should include standalone fetch function by default', () => {
+            const result = (0, queries_1.generateListQueryHook)(userTable);
+            expect(result.content).toContain('export async function fetchUsersQuery');
+        });
+    });
+});
+// ============================================================================
+// Tests - Mutation Generators with reactQueryEnabled: false
+// ============================================================================
+describe('Mutation generators with reactQueryEnabled: false', () => {
+    describe('generateCreateMutationHook', () => {
+        it('should return null when disabled', () => {
+            const result = (0, mutations_1.generateCreateMutationHook)(userTable, { reactQueryEnabled: false });
+            expect(result).toBeNull();
+        });
+    });
+    describe('generateUpdateMutationHook', () => {
+        it('should return null when disabled', () => {
+            const result = (0, mutations_1.generateUpdateMutationHook)(userTable, { reactQueryEnabled: false });
+            expect(result).toBeNull();
+        });
+    });
+    describe('generateDeleteMutationHook', () => {
+        it('should return null when disabled', () => {
+            const result = (0, mutations_1.generateDeleteMutationHook)(userTable, { reactQueryEnabled: false });
+            expect(result).toBeNull();
+        });
+    });
+    describe('generateAllMutationHooks', () => {
+        it('should return empty array when disabled', () => {
+            const results = (0, mutations_1.generateAllMutationHooks)([userTable], { reactQueryEnabled: false });
+            expect(results).toEqual([]);
+        });
+    });
+});
+// ============================================================================
+// Tests - Mutation Generators with reactQueryEnabled: true (default)
+// ============================================================================
+describe('Mutation generators with reactQueryEnabled: true (default)', () => {
+    describe('generateCreateMutationHook', () => {
+        it('should return mutation file by default', () => {
+            const result = (0, mutations_1.generateCreateMutationHook)(userTable);
+            expect(result).not.toBeNull();
+            expect(result.content).toContain('useMutation');
+        });
+    });
+    describe('generateAllMutationHooks', () => {
+        it('should return mutation files by default', () => {
+            const results = (0, mutations_1.generateAllMutationHooks)([userTable]);
+            expect(results.length).toBeGreaterThan(0);
+        });
+    });
+});
+// ============================================================================
+// Tests - Custom Query Generators with reactQueryEnabled: false
+// ============================================================================
+describe('Custom query generators with reactQueryEnabled: false', () => {
+    describe('generateCustomQueryHook', () => {
+        it('should not include React Query imports when disabled', () => {
+            const result = (0, custom_queries_1.generateCustomQueryHook)({
+                operation: sampleQueryOperation,
+                typeRegistry: emptyTypeRegistry,
+                reactQueryEnabled: false,
+            });
+            expect(result.content).not.toContain('@tanstack/react-query');
+            expect(result.content).not.toContain('useQuery');
+        });
+        it('should not include useXxxQuery hook when disabled', () => {
+            const result = (0, custom_queries_1.generateCustomQueryHook)({
+                operation: sampleQueryOperation,
+                typeRegistry: emptyTypeRegistry,
+                reactQueryEnabled: false,
+            });
+            expect(result.content).not.toContain('export function useCurrentUserQuery');
+        });
+        it('should still include standalone fetch function when disabled', () => {
+            const result = (0, custom_queries_1.generateCustomQueryHook)({
+                operation: sampleQueryOperation,
+                typeRegistry: emptyTypeRegistry,
+                reactQueryEnabled: false,
+            });
+            expect(result.content).toContain('export async function fetchCurrentUserQuery');
+        });
+    });
+    describe('generateAllCustomQueryHooks', () => {
+        it('should generate files without React Query when disabled', () => {
+            const results = (0, custom_queries_1.generateAllCustomQueryHooks)({
+                operations: [sampleQueryOperation],
+                typeRegistry: emptyTypeRegistry,
+                reactQueryEnabled: false,
+            });
+            expect(results.length).toBe(1);
+            expect(results[0].content).not.toContain('@tanstack/react-query');
+        });
+    });
+});
+// ============================================================================
+// Tests - Custom Mutation Generators with reactQueryEnabled: false
+// ============================================================================
+describe('Custom mutation generators with reactQueryEnabled: false', () => {
+    describe('generateCustomMutationHook', () => {
+        it('should return null when disabled', () => {
+            const result = (0, custom_mutations_1.generateCustomMutationHook)({
+                operation: sampleMutationOperation,
+                typeRegistry: emptyTypeRegistry,
+                reactQueryEnabled: false,
+            });
+            expect(result).toBeNull();
+        });
+    });
+    describe('generateAllCustomMutationHooks', () => {
+        it('should return empty array when disabled', () => {
+            const results = (0, custom_mutations_1.generateAllCustomMutationHooks)({
+                operations: [sampleMutationOperation],
+                typeRegistry: emptyTypeRegistry,
+                reactQueryEnabled: false,
+            });
+            expect(results).toEqual([]);
+        });
+    });
+});
+// ============================================================================
+// Tests - Custom Mutation Generators with reactQueryEnabled: true (default)
+// ============================================================================
+describe('Custom mutation generators with reactQueryEnabled: true (default)', () => {
+    describe('generateCustomMutationHook', () => {
+        it('should return mutation file by default', () => {
+            const result = (0, custom_mutations_1.generateCustomMutationHook)({
+                operation: sampleMutationOperation,
+                typeRegistry: emptyTypeRegistry,
+            });
+            expect(result).not.toBeNull();
+            expect(result.content).toContain('useMutation');
+        });
+    });
+});

package/cli/codegen/custom-mutations.d.ts

@@ -21,18 +21,24 @@ export interface GenerateCustomMutationHookOptions {
     typeRegistry: TypeRegistry;
     maxDepth?: number;
     skipQueryField?: boolean;
+    /** Whether to generate React Query hooks (default: true for backwards compatibility) */
+    reactQueryEnabled?: boolean;
 }
 /**
  * Generate a custom mutation hook file
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
-export declare function generateCustomMutationHook(options: GenerateCustomMutationHookOptions): GeneratedCustomMutationFile;
+export declare function generateCustomMutationHook(options: GenerateCustomMutationHookOptions): GeneratedCustomMutationFile | null;
 export interface GenerateAllCustomMutationHooksOptions {
     operations: CleanOperation[];
     typeRegistry: TypeRegistry;
     maxDepth?: number;
     skipQueryField?: boolean;
+    /** Whether to generate React Query hooks (default: true for backwards compatibility) */
+    reactQueryEnabled?: boolean;
 }
 /**
  * Generate all custom mutation hook files
+ * When reactQueryEnabled is false, returns empty array since mutations require React Query
  */
 export declare function generateAllCustomMutationHooks(options: GenerateAllCustomMutationHooksOptions): GeneratedCustomMutationFile[];

package/cli/codegen/custom-mutations.js

@@ -7,9 +7,14 @@ const schema_gql_ast_1 = require("./schema-gql-ast");
 const type_resolver_1 = require("./type-resolver");
 /**
  * Generate a custom mutation hook file
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
 function generateCustomMutationHook(options) {
-    const { operation } = options;
+    const { operation, reactQueryEnabled = true } = options;
+    // Mutations require React Query - skip generation when disabled
+    if (!reactQueryEnabled) {
+        return null;
+    }
     try {
         return generateCustomMutationHookInternal(options);
     }
@@ -135,9 +140,10 @@ function generateHookBody(operation, documentConstName, variablesTypeName, resul
 }
 /**
  * Generate all custom mutation hook files
+ * When reactQueryEnabled is false, returns empty array since mutations require React Query
  */
 function generateAllCustomMutationHooks(options) {
-    const { operations, typeRegistry, maxDepth = 2, skipQueryField = true } = options;
+    const { operations, typeRegistry, maxDepth = 2, skipQueryField = true, reactQueryEnabled = true } = options;
     return operations
         .filter((op) => op.kind === 'mutation')
         .map((operation) => generateCustomMutationHook({
@@ -145,5 +151,7 @@ function generateAllCustomMutationHooks(options) {
         typeRegistry,
         maxDepth,
         skipQueryField,
-    }));
+        reactQueryEnabled,
+    }))
+        .filter((result) => result !== null);
 }

package/cli/codegen/custom-queries.d.ts

@@ -21,6 +21,8 @@ export interface GenerateCustomQueryHookOptions {
     typeRegistry: TypeRegistry;
     maxDepth?: number;
     skipQueryField?: boolean;
+    /** Whether to generate React Query hooks (default: true for backwards compatibility) */
+    reactQueryEnabled?: boolean;
 }
 /**
  * Generate a custom query hook file
@@ -31,6 +33,8 @@ export interface GenerateAllCustomQueryHooksOptions {
     typeRegistry: TypeRegistry;
     maxDepth?: number;
     skipQueryField?: boolean;
+    /** Whether to generate React Query hooks (default: true for backwards compatibility) */
+    reactQueryEnabled?: boolean;
 }
 /**
  * Generate all custom query hook files

package/cli/codegen/custom-queries.js

@@ -10,7 +10,7 @@ const utils_1 = require("./utils");
  * Generate a custom query hook file
  */
 function generateCustomQueryHook(options) {
-    const { operation, typeRegistry, maxDepth = 2, skipQueryField = true } = options;
+    const { operation, typeRegistry, maxDepth = 2, skipQueryField = true, reactQueryEnabled = true } = options;
     const project = (0, ts_ast_1.createProject)();
     const hookName = (0, type_resolver_1.getOperationHookName)(operation.name, 'query');
     const fileName = (0, type_resolver_1.getOperationFileName)(operation.name, 'query');
@@ -27,20 +27,25 @@ function generateCustomQueryHook(options) {
     });
     const sourceFile = (0, ts_ast_1.createSourceFile)(project, fileName);
     // Add file header
-    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(`Custom query hook for ${operation.name}`) + '\n\n');
-    // Add imports
-    sourceFile.addImportDeclarations([
-        (0, ts_ast_1.createImport)({
+    const headerText = reactQueryEnabled
+        ? `Custom query hook for ${operation.name}`
+        : `Custom query functions for ${operation.name}`;
+    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(headerText) + '\n\n');
+    // Add imports - conditionally include React Query imports
+    const imports = [];
+    if (reactQueryEnabled) {
+        imports.push((0, ts_ast_1.createImport)({
             moduleSpecifier: '@tanstack/react-query',
             namedImports: ['useQuery'],
             typeOnlyNamedImports: ['UseQueryOptions', 'QueryClient'],
-        }),
-        (0, ts_ast_1.createImport)({
-            moduleSpecifier: '../client',
-            namedImports: ['execute'],
-            typeOnlyNamedImports: ['ExecuteOptions'],
-        }),
-    ]);
+        }));
+    }
+    imports.push((0, ts_ast_1.createImport)({
+        moduleSpecifier: '../client',
+        namedImports: ['execute'],
+        typeOnlyNamedImports: ['ExecuteOptions'],
+    }));
+    sourceFile.addImportDeclarations(imports);
     // Add query document constant
     sourceFile.addVariableStatement((0, ts_ast_1.createConst)(documentConstName, '`\n' + queryDocument + '`', {
         docs: ['GraphQL query document'],
@@ -66,17 +71,19 @@ function generateCustomQueryHook(options) {
             docs: ['Query key factory for caching'],
         }));
     }
-    // Generate hook function
-    const hookParams = generateHookParameters(operation, variablesTypeName, resultTypeName);
-    const hookBody = generateHookBody(operation, documentConstName, queryKeyName, variablesTypeName, resultTypeName);
-    const hookDoc = generateHookDoc(operation, hookName);
-    sourceFile.addFunction({
-        name: hookName,
-        isExported: true,
-        parameters: hookParams,
-        statements: hookBody,
-        docs: [{ description: hookDoc }],
-    });
+    // Generate hook function (only if React Query is enabled)
+    if (reactQueryEnabled) {
+        const hookParams = generateHookParameters(operation, variablesTypeName, resultTypeName);
+        const hookBody = generateHookBody(operation, documentConstName, queryKeyName, variablesTypeName, resultTypeName);
+        const hookDoc = generateHookDoc(operation, hookName);
+        sourceFile.addFunction({
+            name: hookName,
+            isExported: true,
+            parameters: hookParams,
+            statements: hookBody,
+            docs: [{ description: hookDoc }],
+        });
+    }
     // Add standalone functions section
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Standalone Functions (non-React)');
@@ -95,20 +102,22 @@ function generateCustomQueryHook(options) {
         statements: fetchBody,
         docs: [{ description: fetchDoc }],
     });
-    // Generate prefetch function
-    const prefetchFnName = `prefetch${(0, utils_1.ucFirst)(operation.name)}Query`;
-    const prefetchParams = generatePrefetchParameters(operation, variablesTypeName);
-    const prefetchBody = generatePrefetchBody(operation, documentConstName, queryKeyName, variablesTypeName, resultTypeName);
-    const prefetchDoc = generatePrefetchDoc(operation, prefetchFnName);
-    sourceFile.addFunction({
-        name: prefetchFnName,
-        isExported: true,
-        isAsync: true,
-        parameters: prefetchParams,
-        returnType: 'Promise<void>',
-        statements: prefetchBody,
-        docs: [{ description: prefetchDoc }],
-    });
+    // Generate prefetch function (only if React Query is enabled)
+    if (reactQueryEnabled) {
+        const prefetchFnName = `prefetch${(0, utils_1.ucFirst)(operation.name)}Query`;
+        const prefetchParams = generatePrefetchParameters(operation, variablesTypeName);
+        const prefetchBody = generatePrefetchBody(operation, documentConstName, queryKeyName, variablesTypeName, resultTypeName);
+        const prefetchDoc = generatePrefetchDoc(operation, prefetchFnName);
+        sourceFile.addFunction({
+            name: prefetchFnName,
+            isExported: true,
+            isAsync: true,
+            parameters: prefetchParams,
+            returnType: 'Promise<void>',
+            statements: prefetchBody,
+            docs: [{ description: prefetchDoc }],
+        });
+    }
     return {
         fileName,
         content: (0, ts_ast_1.getFormattedOutput)(sourceFile),
@@ -346,7 +355,7 @@ await ${fnName}(queryClient);
  * Generate all custom query hook files
  */
 function generateAllCustomQueryHooks(options) {
-    const { operations, typeRegistry, maxDepth = 2, skipQueryField = true } = options;
+    const { operations, typeRegistry, maxDepth = 2, skipQueryField = true, reactQueryEnabled = true } = options;
     return operations
         .filter((op) => op.kind === 'query')
         .map((operation) => generateCustomQueryHook({
@@ -354,5 +363,6 @@ function generateAllCustomQueryHooks(options) {
         typeRegistry,
         maxDepth,
         skipQueryField,
+        reactQueryEnabled,
     }));
 }

package/cli/codegen/index.js

@@ -28,6 +28,7 @@ function generate(options) {
     // Extract codegen options
     const maxDepth = config.codegen.maxFieldDepth;
     const skipQueryField = config.codegen.skipQueryField;
+    const reactQueryEnabled = config.reactQuery.enabled;
     // 1. Generate client.ts
     files.push({
         path: 'client.ts',
@@ -39,7 +40,7 @@ function generate(options) {
         content: (0, types_1.generateTypesFile)(tables),
     });
     // 3. Generate table-based query hooks (queries/*.ts)
-    const queryHooks = (0, queries_1.generateAllQueryHooks)(tables);
+    const queryHooks = (0, queries_1.generateAllQueryHooks)(tables, { reactQueryEnabled });
     for (const hook of queryHooks) {
         files.push({
             path: `queries/${hook.fileName}`,
@@ -54,6 +55,7 @@ function generate(options) {
             typeRegistry: customOperations.typeRegistry,
             maxDepth,
             skipQueryField,
+            reactQueryEnabled,
         });
         for (const hook of customQueryHooks) {
             files.push({
@@ -70,7 +72,7 @@ function generate(options) {
             : (0, barrel_1.generateQueriesBarrel)(tables),
     });
     // 6. Generate table-based mutation hooks (mutations/*.ts)
-    const mutationHooks = (0, mutations_1.generateAllMutationHooks)(tables);
+    const mutationHooks = (0, mutations_1.generateAllMutationHooks)(tables, { reactQueryEnabled });
     for (const hook of mutationHooks) {
         files.push({
             path: `mutations/${hook.fileName}`,
@@ -85,6 +87,7 @@ function generate(options) {
             typeRegistry: customOperations.typeRegistry,
             maxDepth,
             skipQueryField,
+            reactQueryEnabled,
         });
         for (const hook of customMutationHooks) {
             files.push({

package/cli/codegen/mutations.d.ts

@@ -12,19 +12,27 @@ export interface GeneratedMutationFile {
     fileName: string;
     content: string;
 }
+export interface MutationGeneratorOptions {
+    /** Whether to generate React Query hooks (default: true for backwards compatibility) */
+    reactQueryEnabled?: boolean;
+}
 /**
  * Generate create mutation hook file content using AST
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
-export declare function generateCreateMutationHook(table: CleanTable): GeneratedMutationFile;
+export declare function generateCreateMutationHook(table: CleanTable, options?: MutationGeneratorOptions): GeneratedMutationFile | null;
 /**
  * Generate update mutation hook file content using AST
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
-export declare function generateUpdateMutationHook(table: CleanTable): GeneratedMutationFile | null;
+export declare function generateUpdateMutationHook(table: CleanTable, options?: MutationGeneratorOptions): GeneratedMutationFile | null;
 /**
  * Generate delete mutation hook file content using AST
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
-export declare function generateDeleteMutationHook(table: CleanTable): GeneratedMutationFile | null;
+export declare function generateDeleteMutationHook(table: CleanTable, options?: MutationGeneratorOptions): GeneratedMutationFile | null;
 /**
  * Generate all mutation hook files for all tables
+ * When reactQueryEnabled is false, returns empty array since mutations require React Query
  */
-export declare function generateAllMutationHooks(tables: CleanTable[]): GeneratedMutationFile[];
+export declare function generateAllMutationHooks(tables: CleanTable[], options?: MutationGeneratorOptions): GeneratedMutationFile[];