@constructive-io/graphql-codegen 2.20.1 → 2.22.0

package/esm/cli/codegen/mutations.js

@@ -1,26 +1,61 @@
 import { createProject, createSourceFile, getFormattedOutput, createFileHeader, createImport, createInterface, createConst, } from './ts-ast';
 import { buildCreateMutationAST, buildUpdateMutationAST, buildDeleteMutationAST, printGraphQL, } from './gql-ast';
-import { getTableNames, getCreateMutationHookName, getUpdateMutationHookName, getDeleteMutationHookName, getCreateMutationFileName, getUpdateMutationFileName, getDeleteMutationFileName, getCreateMutationName, getUpdateMutationName, getDeleteMutationName, getScalarFields, fieldTypeToTs, ucFirst, lcFirst, } from './utils';
+import { getTableNames, getCreateMutationHookName, getUpdateMutationHookName, getDeleteMutationHookName, getCreateMutationFileName, getUpdateMutationFileName, getDeleteMutationFileName, getCreateMutationName, getUpdateMutationName, getDeleteMutationName, getScalarFields, getPrimaryKeyInfo, fieldTypeToTs, ucFirst, lcFirst, } from './utils';
+/**
+ * Check if a field is auto-generated and should be excluded from create inputs
+ * Uses primary key from constraints and common timestamp patterns
+ */
+function isAutoGeneratedField(fieldName, pkFieldNames) {
+    const name = fieldName.toLowerCase();
+    // Exclude primary key fields (from constraints)
+    if (pkFieldNames.has(fieldName))
+        return true;
+    // Exclude common timestamp patterns (case-insensitive)
+    // These are typically auto-set by database triggers or defaults
+    const timestampPatterns = [
+        'createdat', 'created_at', 'createddate', 'created_date',
+        'updatedat', 'updated_at', 'updateddate', 'updated_date',
+        'deletedat', 'deleted_at', // soft delete timestamps
+    ];
+    return timestampPatterns.includes(name);
+}
 // ============================================================================
 // Create mutation hook generator
 // ============================================================================
 /**
  * Generate create mutation hook file content using AST
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
-export function generateCreateMutationHook(table) {
+export function generateCreateMutationHook(table, options = {}) {
+    const { reactQueryEnabled = true, enumsFromSchemaTypes = [] } = options;
+    // Mutations require React Query - skip generation when disabled
+    if (!reactQueryEnabled) {
+        return null;
+    }
+    const enumSet = new Set(enumsFromSchemaTypes);
     const project = createProject();
     const { typeName, singularName } = getTableNames(table);
     const hookName = getCreateMutationHookName(table);
     const mutationName = getCreateMutationName(table);
     const scalarFields = getScalarFields(table);
+    // Get primary key field names dynamically from table constraints
+    const pkFieldNames = new Set(getPrimaryKeyInfo(table).map(pk => pk.name));
+    // Collect which enums are used by this table's fields
+    const usedEnums = new Set();
+    for (const field of scalarFields) {
+        const cleanType = field.type.gqlType.replace(/!/g, '');
+        if (enumSet.has(cleanType)) {
+            usedEnums.add(cleanType);
+        }
+    }
     // Generate GraphQL document via AST
     const mutationAST = buildCreateMutationAST({ table });
     const mutationDocument = printGraphQL(mutationAST);
     const sourceFile = createSourceFile(project, getCreateMutationFileName(table));
     // Add file header
     sourceFile.insertText(0, createFileHeader(`Create mutation hook for ${typeName}`) + '\n\n');
-    // Add imports
-    sourceFile.addImportDeclarations([
+    // Build import declarations
+    const imports = [
         createImport({
             moduleSpecifier: '@tanstack/react-query',
             namedImports: ['useMutation', 'useQueryClient'],
@@ -34,7 +69,16 @@ export function generateCreateMutationHook(table) {
             moduleSpecifier: '../types',
             typeOnlyNamedImports: [typeName],
         }),
-    ]);
+    ];
+    // Add import for enum types from schema-types if any are used
+    if (usedEnums.size > 0) {
+        imports.push(createImport({
+            moduleSpecifier: '../schema-types',
+            typeOnlyNamedImports: Array.from(usedEnums).sort(),
+        }));
+    }
+    // Add imports
+    sourceFile.addImportDeclarations(imports);
     // Re-export entity type
     sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
     // Add section comment
@@ -48,11 +92,9 @@ export function generateCreateMutationHook(table) {
     sourceFile.addStatements('// Types');
     sourceFile.addStatements('// ============================================================================\n');
     // Generate CreateInput type - exclude auto-generated fields
+    // Note: Not exported to avoid conflicts with schema-types
     const inputFields = scalarFields
-        .filter((f) => {
-        const name = f.name.toLowerCase();
-        return !['id', 'createdat', 'updatedat', 'created_at', 'updated_at'].includes(name);
-    })
+        .filter((f) => !isAutoGeneratedField(f.name, pkFieldNames))
         .map((f) => ({
         name: f.name,
         type: `${fieldTypeToTs(f.type)} | null`,
@@ -60,6 +102,7 @@ export function generateCreateMutationHook(table) {
     }));
     sourceFile.addInterface(createInterface(`${typeName}CreateInput`, inputFields, {
         docs: [`Input type for creating a ${typeName}`],
+        isExported: false,
     }));
     // Variables interface
     sourceFile.addInterface(createInterface(`${ucFirst(mutationName)}MutationVariables`, [
@@ -137,25 +180,44 @@ mutate({
 // ============================================================================
 /**
  * Generate update mutation hook file content using AST
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
-export function generateUpdateMutationHook(table) {
+export function generateUpdateMutationHook(table, options = {}) {
+    const { reactQueryEnabled = true, enumsFromSchemaTypes = [] } = options;
+    // Mutations require React Query - skip generation when disabled
+    if (!reactQueryEnabled) {
+        return null;
+    }
     // Check if update mutation exists
     if (table.query?.update === null) {
         return null;
     }
+    const enumSet = new Set(enumsFromSchemaTypes);
     const project = createProject();
     const { typeName, singularName } = getTableNames(table);
     const hookName = getUpdateMutationHookName(table);
     const mutationName = getUpdateMutationName(table);
     const scalarFields = getScalarFields(table);
+    // Get primary key info dynamically from table constraints
+    const pkFields = getPrimaryKeyInfo(table);
+    const pkField = pkFields[0]; // Use first PK field
+    const pkFieldNames = new Set(pkFields.map(pk => pk.name));
+    // Collect which enums are used by this table's fields
+    const usedEnums = new Set();
+    for (const field of scalarFields) {
+        const cleanType = field.type.gqlType.replace(/!/g, '');
+        if (enumSet.has(cleanType)) {
+            usedEnums.add(cleanType);
+        }
+    }
     // Generate GraphQL document via AST
     const mutationAST = buildUpdateMutationAST({ table });
     const mutationDocument = printGraphQL(mutationAST);
     const sourceFile = createSourceFile(project, getUpdateMutationFileName(table));
     // Add file header
     sourceFile.insertText(0, createFileHeader(`Update mutation hook for ${typeName}`) + '\n\n');
-    // Add imports
-    sourceFile.addImportDeclarations([
+    // Build import declarations
+    const imports = [
         createImport({
             moduleSpecifier: '@tanstack/react-query',
             namedImports: ['useMutation', 'useQueryClient'],
@@ -169,7 +231,16 @@ export function generateUpdateMutationHook(table) {
             moduleSpecifier: '../types',
             typeOnlyNamedImports: [typeName],
         }),
-    ]);
+    ];
+    // Add import for enum types from schema-types if any are used
+    if (usedEnums.size > 0) {
+        imports.push(createImport({
+            moduleSpecifier: '../schema-types',
+            typeOnlyNamedImports: Array.from(usedEnums).sort(),
+        }));
+    }
+    // Add imports
+    sourceFile.addImportDeclarations(imports);
     // Re-export entity type
     sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
     // Add section comment
@@ -182,9 +253,10 @@ export function generateUpdateMutationHook(table) {
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Types');
     sourceFile.addStatements('// ============================================================================\n');
-    // Generate Patch type - all fields optional
+    // Generate Patch type - all fields optional, exclude primary key
+    // Note: Not exported to avoid conflicts with schema-types
     const patchFields = scalarFields
-        .filter((f) => f.name.toLowerCase() !== 'id')
+        .filter((f) => !pkFieldNames.has(f.name))
         .map((f) => ({
         name: f.name,
         type: `${fieldTypeToTs(f.type)} | null`,
@@ -192,13 +264,14 @@ export function generateUpdateMutationHook(table) {
     }));
     sourceFile.addInterface(createInterface(`${typeName}Patch`, patchFields, {
         docs: [`Patch type for updating a ${typeName} - all fields optional`],
+        isExported: false,
     }));
-    // Variables interface
+    // Variables interface - use dynamic PK field name and type
     sourceFile.addInterface(createInterface(`${ucFirst(mutationName)}MutationVariables`, [
         {
             name: 'input',
             type: `{
-    id: string;
+    ${pkField.name}: ${pkField.tsType};
     patch: ${typeName}Patch;
   }`,
         },
@@ -237,7 +310,7 @@ export function generateUpdateMutationHook(table) {
       ),
     onSuccess: (_, variables) => {
       // Invalidate specific item and list queries
-      queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'detail', variables.input.id] });
+      queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'detail', variables.input.${pkField.name}] });
       queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'list'] });
     },
     ...options,
@@ -252,7 +325,7 @@ const { mutate, isPending } = ${hookName}();
 
 mutate({
   input: {
-    id: 'uuid-here',
+    ${pkField.name}: ${pkField.tsType === 'string' ? "'value-here'" : '123'},
     patch: {
       // ... fields to update
     },
@@ -272,8 +345,14 @@ mutate({
 // ============================================================================
 /**
  * Generate delete mutation hook file content using AST
+ * When reactQueryEnabled is false, returns null since mutations require React Query
  */
-export function generateDeleteMutationHook(table) {
+export function generateDeleteMutationHook(table, options = {}) {
+    const { reactQueryEnabled = true } = options;
+    // Mutations require React Query - skip generation when disabled
+    if (!reactQueryEnabled) {
+        return null;
+    }
     // Check if delete mutation exists
     if (table.query?.delete === null) {
         return null;
@@ -282,6 +361,9 @@ export function generateDeleteMutationHook(table) {
     const { typeName } = getTableNames(table);
     const hookName = getDeleteMutationHookName(table);
     const mutationName = getDeleteMutationName(table);
+    // Get primary key info dynamically from table constraints
+    const pkFields = getPrimaryKeyInfo(table);
+    const pkField = pkFields[0]; // Use first PK field
     // Generate GraphQL document via AST
     const mutationAST = buildDeleteMutationAST({ table });
     const mutationDocument = printGraphQL(mutationAST);
@@ -310,12 +392,12 @@ export function generateDeleteMutationHook(table) {
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Types');
     sourceFile.addStatements('// ============================================================================\n');
-    // Variables interface
+    // Variables interface - use dynamic PK field name and type
     sourceFile.addInterface(createInterface(`${ucFirst(mutationName)}MutationVariables`, [
         {
             name: 'input',
             type: `{
-    id: string;
+    ${pkField.name}: ${pkField.tsType};
   }`,
         },
     ]));
@@ -325,7 +407,7 @@ export function generateDeleteMutationHook(table) {
             name: mutationName,
             type: `{
     clientMutationId: string | null;
-    deletedId: string | null;
+    deleted${ucFirst(pkField.name)}: ${pkField.tsType} | null;
   }`,
         },
     ]));
@@ -354,7 +436,7 @@ export function generateDeleteMutationHook(table) {
       ),
     onSuccess: (_, variables) => {
       // Remove from cache and invalidate list
-      queryClient.removeQueries({ queryKey: ['${typeName.toLowerCase()}', 'detail', variables.input.id] });
+      queryClient.removeQueries({ queryKey: ['${typeName.toLowerCase()}', 'detail', variables.input.${pkField.name}] });
       queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'list'] });
     },
     ...options,
@@ -369,7 +451,7 @@ const { mutate, isPending } = ${hookName}();
 
 mutate({
   input: {
-    id: 'uuid-to-delete',
+    ${pkField.name}: ${pkField.tsType === 'string' ? "'value-to-delete'" : '123'},
   },
 });
 \`\`\``,
@@ -386,16 +468,20 @@ mutate({
 // ============================================================================
 /**
  * Generate all mutation hook files for all tables
+ * When reactQueryEnabled is false, returns empty array since mutations require React Query
  */
-export function generateAllMutationHooks(tables) {
+export function generateAllMutationHooks(tables, options = {}) {
     const files = [];
     for (const table of tables) {
-        files.push(generateCreateMutationHook(table));
-        const updateHook = generateUpdateMutationHook(table);
+        const createHook = generateCreateMutationHook(table, options);
+        if (createHook) {
+            files.push(createHook);
+        }
+        const updateHook = generateUpdateMutationHook(table, options);
         if (updateHook) {
             files.push(updateHook);
         }
-        const deleteHook = generateDeleteMutationHook(table);
+        const deleteHook = generateDeleteMutationHook(table, options);
         if (deleteHook) {
             files.push(deleteHook);
         }

package/esm/cli/codegen/orm/barrel.js

@@ -12,9 +12,11 @@ export function generateModelsBarrel(tables) {
     for (const table of tables) {
         const { typeName } = getTableNames(table);
         const modelName = `${typeName}Model`;
-        const fileName = lcFirst(typeName);
+        // Use same naming logic as model-generator to avoid "index.ts" clash with barrel file
+        const baseFileName = lcFirst(typeName);
+        const moduleFileName = baseFileName === 'index' ? `${baseFileName}Model` : baseFileName;
         sourceFile.addExportDeclaration({
-            moduleSpecifier: `./${fileName}`,
+            moduleSpecifier: `./${moduleFileName}`,
             namedExports: [modelName],
         });
     }

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

@@ -40,6 +40,23 @@ export function generateOrm(options) {
         ];
         const usedInputTypes = collectInputTypeNames(allOps);
         const usedPayloadTypes = collectPayloadTypeNames(allOps);
+        // Also include payload types for table CRUD mutations (they reference Edge types)
+        if (typeRegistry) {
+            for (const table of tables) {
+                const typeName = table.name;
+                // Add standard CRUD payload types
+                const crudPayloadTypes = [
+                    `Create${typeName}Payload`,
+                    `Update${typeName}Payload`,
+                    `Delete${typeName}Payload`,
+                ];
+                for (const payloadType of crudPayloadTypes) {
+                    if (typeRegistry.has(payloadType)) {
+                        usedPayloadTypes.add(payloadType);
+                    }
+                }
+            }
+        }
         const inputTypesFile = generateInputTypesFile(typeRegistry ?? new Map(), usedInputTypes, tables, usedPayloadTypes);
         files.push({ path: inputTypesFile.fileName, content: inputTypesFile.content });
     }

package/esm/cli/codegen/orm/input-types-generator.js

@@ -117,6 +117,47 @@ function addScalarFilterTypes(sourceFile) {
     }
 }
 // ============================================================================
+// Enum Types Collector
+// ============================================================================
+/**
+ * Check if a type is likely an enum (not a scalar and not ending with Input/Filter/etc)
+ */
+function isLikelyEnumType(typeName, typeRegistry) {
+    const typeInfo = typeRegistry.get(typeName);
+    return typeInfo?.kind === 'ENUM';
+}
+/**
+ * Collect enum types used by table fields
+ */
+function collectEnumTypesFromTables(tables, typeRegistry) {
+    const enumTypes = new Set();
+    for (const table of tables) {
+        for (const field of table.fields) {
+            const fieldType = typeof field.type === 'string' ? field.type : field.type.gqlType;
+            // Check if this type is an enum in the registry
+            if (isLikelyEnumType(fieldType, typeRegistry)) {
+                enumTypes.add(fieldType);
+            }
+        }
+    }
+    return enumTypes;
+}
+/**
+ * Add enum types to source file
+ */
+function addEnumTypes(sourceFile, typeRegistry, enumTypeNames) {
+    if (enumTypeNames.size === 0)
+        return;
+    addSectionComment(sourceFile, 'Enum Types');
+    for (const typeName of Array.from(enumTypeNames).sort()) {
+        const typeInfo = typeRegistry.get(typeName);
+        if (!typeInfo || typeInfo.kind !== 'ENUM' || !typeInfo.enumValues)
+            continue;
+        const values = typeInfo.enumValues.map((v) => `'${v}'`).join(' | ');
+        sourceFile.addTypeAlias(createTypeAlias(typeName, values));
+    }
+}
+// ============================================================================
 // Entity Types Generator (AST-based)
 // ============================================================================
 /**
@@ -382,10 +423,12 @@ function buildOrderByUnion(table) {
 }
 /**
  * Add OrderBy types
+ * Uses inflection from table metadata for correct pluralization
  */
 function addOrderByTypes(sourceFile, tables) {
     addSectionComment(sourceFile, 'OrderBy Types');
     for (const table of tables) {
+        // Use getOrderByTypeName which respects table.inflection.orderByType
         const enumName = getOrderByTypeName(table);
         sourceFile.addTypeAlias(createTypeAlias(enumName, buildOrderByUnion(table)));
     }
@@ -504,32 +547,39 @@ export function collectInputTypeNames(operations) {
     }
     return inputTypes;
 }
+/**
+ * Build a set of exact table CRUD input type names to skip
+ * These are generated by addAllCrudInputTypes, so we don't need to regenerate them
+ */
+function buildTableCrudTypeNames(tables) {
+    const crudTypes = new Set();
+    for (const table of tables) {
+        const { typeName } = getTableNames(table);
+        crudTypes.add(`Create${typeName}Input`);
+        crudTypes.add(`Update${typeName}Input`);
+        crudTypes.add(`Delete${typeName}Input`);
+        crudTypes.add(`${typeName}Filter`);
+        crudTypes.add(`${typeName}Patch`);
+    }
+    return crudTypes;
+}
 /**
  * Add custom input types from TypeRegistry
  */
-function addCustomInputTypes(sourceFile, typeRegistry, usedInputTypes) {
+function addCustomInputTypes(sourceFile, typeRegistry, usedInputTypes, tableCrudTypes) {
     addSectionComment(sourceFile, 'Custom Input Types (from schema)');
     const generatedTypes = new Set();
     const typesToGenerate = new Set(Array.from(usedInputTypes));
-    // Filter out types we've already generated
-    const typesToRemove = [];
-    typesToGenerate.forEach((typeName) => {
-        if (typeName.endsWith('Filter') ||
-            typeName.startsWith('Create') ||
-            typeName.startsWith('Update') ||
-            typeName.startsWith('Delete')) {
-            const isTableCrud = /^(Create|Update|Delete)[A-Z][a-zA-Z]+Input$/.test(typeName) ||
-                /^[A-Z][a-zA-Z]+Filter$/.test(typeName);
-            if (isTableCrud) {
-                typesToRemove.push(typeName);
+    // Filter out types we've already generated (exact matches for table CRUD types only)
+    if (tableCrudTypes) {
+        for (const typeName of Array.from(typesToGenerate)) {
+            if (tableCrudTypes.has(typeName)) {
+                typesToGenerate.delete(typeName);
             }
         }
-    });
-    typesToRemove.forEach((t) => typesToGenerate.delete(t));
-    let iterations = 0;
-    const maxIterations = 200;
-    while (typesToGenerate.size > 0 && iterations < maxIterations) {
-        iterations++;
+    }
+    // Process all types - no artificial limit
+    while (typesToGenerate.size > 0) {
         const typeNameResult = typesToGenerate.values().next();
         if (typeNameResult.done)
             break;
@@ -595,10 +645,8 @@ function addPayloadTypes(sourceFile, typeRegistry, usedPayloadTypes, alreadyGene
         'String', 'Int', 'Float', 'Boolean', 'ID', 'UUID', 'Datetime', 'Date',
         'Time', 'JSON', 'BigInt', 'BigFloat', 'Cursor', 'Query', 'Mutation',
     ]);
-    let iterations = 0;
-    const maxIterations = 200;
-    while (typesToGenerate.size > 0 && iterations < maxIterations) {
-        iterations++;
+    // Process all types - no artificial limit
+    while (typesToGenerate.size > 0) {
         const typeNameResult = typesToGenerate.values().next();
         if (typeNameResult.done)
             break;
@@ -665,7 +713,12 @@ export function generateInputTypesFile(typeRegistry, usedInputTypes, tables, use
     sourceFile.insertText(0, createFileHeader('GraphQL types for ORM client') + '\n');
     // 1. Scalar filter types
     addScalarFilterTypes(sourceFile);
-    // 2. Entity and relation types (if tables provided)
+    // 2. Enum types used by table fields
+    if (tables && tables.length > 0) {
+        const enumTypes = collectEnumTypesFromTables(tables, typeRegistry);
+        addEnumTypes(sourceFile, typeRegistry, enumTypes);
+    }
+    // 3. Entity and relation types (if tables provided)
     if (tables && tables.length > 0) {
         const tableByName = new Map(tables.map((table) => [table.name, table]));
         addEntityTypes(sourceFile, tables);
@@ -673,16 +726,17 @@ export function generateInputTypesFile(typeRegistry, usedInputTypes, tables, use
         addEntityRelationTypes(sourceFile, tables, tableByName);
         addEntityWithRelations(sourceFile, tables);
         addEntitySelectTypes(sourceFile, tables, tableByName);
-        // 3. Table filter types
+        // 4. Table filter types
         addTableFilterTypes(sourceFile, tables);
-        // 4. OrderBy types
+        // 5. OrderBy types
         addOrderByTypes(sourceFile, tables);
-        // 5. CRUD input types
+        // 6. CRUD input types
         addAllCrudInputTypes(sourceFile, tables);
     }
-    // 6. Custom input types from TypeRegistry
-    addCustomInputTypes(sourceFile, typeRegistry, usedInputTypes);
-    // 7. Payload/return types for custom operations
+    // 7. Custom input types from TypeRegistry
+    const tableCrudTypes = tables ? buildTableCrudTypeNames(tables) : undefined;
+    addCustomInputTypes(sourceFile, typeRegistry, usedInputTypes, tableCrudTypes);
+    // 8. Payload/return types for custom operations
     if (usedPayloadTypes && usedPayloadTypes.size > 0) {
         const alreadyGeneratedTypes = new Set();
         if (tables) {

package/esm/cli/codegen/orm/model-generator.js

@@ -1,5 +1,5 @@
 import { createProject, createSourceFile, getFormattedOutput, createFileHeader, createImport, } from '../ts-ast';
-import { getTableNames, lcFirst } from '../utils';
+import { getTableNames, getOrderByTypeName, getFilterTypeName, lcFirst } from '../utils';
 /**
  * Generate a model class file for a table
  */
@@ -7,13 +7,15 @@ export function generateModelFile(table, _useSharedTypes) {
     const project = createProject();
     const { typeName, singularName, pluralName } = getTableNames(table);
     const modelName = `${typeName}Model`;
-    const fileName = `${lcFirst(typeName)}.ts`;
+    // Avoid "index.ts" which clashes with barrel file
+    const baseFileName = lcFirst(typeName);
+    const fileName = baseFileName === 'index' ? `${baseFileName}Model.ts` : `${baseFileName}.ts`;
     const entityLower = singularName;
-    // Type names for this entity
+    // Type names for this entity - use inflection from table metadata
     const selectTypeName = `${typeName}Select`;
     const relationTypeName = `${typeName}WithRelations`;
-    const whereTypeName = `${typeName}Filter`;
-    const orderByTypeName = `${typeName}sOrderBy`; // PostGraphile uses plural
+    const whereTypeName = getFilterTypeName(table);
+    const orderByTypeName = getOrderByTypeName(table);
     const createInputTypeName = `Create${typeName}Input`;
     const updateInputTypeName = `Update${typeName}Input`;
     const deleteInputTypeName = `Delete${typeName}Input`;

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[];