@constructive-io/graphql-codegen 3.2.0 → 3.3.0

package/core/codegen/index.js

@@ -1,20 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateInvalidationFile = exports.generateMutationKeysFile = exports.generateQueryKeysFile = exports.generateCustomMutationsBarrel = exports.generateCustomQueriesBarrel = exports.generateMainBarrel = exports.generateMutationsBarrel = exports.generateQueriesBarrel = exports.generateCustomMutationHook = exports.generateAllCustomMutationHooks = exports.generateCustomQueryHook = exports.generateAllCustomQueryHooks = exports.generateDeleteMutationHook = exports.generateUpdateMutationHook = exports.generateCreateMutationHook = exports.generateAllMutationHooks = exports.generateSingleQueryHook = exports.generateListQueryHook = exports.generateAllQueryHooks = exports.generateTypesFile = exports.generateClientFile = void 0;
+exports.generateQueryKeysFile = exports.generateSingleQueryHook = exports.generateListQueryHook = exports.generateAllQueryHooks = exports.generateUpdateMutationHook = exports.generateDeleteMutationHook = exports.generateCreateMutationHook = exports.generateAllMutationHooks = exports.generateMutationKeysFile = exports.generateInvalidationFile = exports.generateCustomQueryHook = exports.generateAllCustomQueryHooks = exports.generateCustomMutationHook = exports.generateAllCustomMutationHooks = exports.generateClientFile = exports.generateQueriesBarrel = exports.generateMutationsBarrel = exports.generateMainBarrel = exports.generateCustomQueriesBarrel = exports.generateCustomMutationsBarrel = void 0;
 exports.generateAllFiles = generateAllFiles;
 exports.generate = generate;
 const config_1 = require("../../types/config");
+const barrel_1 = require("./barrel");
 const client_1 = require("./client");
-const types_1 = require("./types");
-const schema_types_generator_1 = require("./schema-types-generator");
-const queries_1 = require("./queries");
-const mutations_1 = require("./mutations");
-const custom_queries_1 = require("./custom-queries");
 const custom_mutations_1 = require("./custom-mutations");
-const query_keys_1 = require("./query-keys");
-const mutation_keys_1 = require("./mutation-keys");
+const custom_queries_1 = require("./custom-queries");
 const invalidation_1 = require("./invalidation");
-const barrel_1 = require("./barrel");
+const mutation_keys_1 = require("./mutation-keys");
+const mutations_1 = require("./mutations");
+const queries_1 = require("./queries");
+const query_keys_1 = require("./query-keys");
+const selection_1 = require("./selection");
 const utils_1 = require("./utils");
 // ============================================================================
 // Main orchestrator
@@ -32,68 +31,30 @@ function generateAllFiles(tables, config) {
  * (they're expected to exist in the shared types directory).
  */
 function generate(options) {
-    const { tables, customOperations, config, sharedTypesPath } = options;
+    const { tables, customOperations, config } = options;
     const files = [];
     // Extract codegen options
-    const maxDepth = config.codegen.maxFieldDepth;
     const skipQueryField = config.codegen.skipQueryField;
     const reactQueryEnabled = config.reactQuery;
     // Query key configuration (use defaults if not provided)
     const queryKeyConfig = config.queryKeys ?? config_1.DEFAULT_QUERY_KEY_CONFIG;
     const useCentralizedKeys = queryKeyConfig.generateScopedKeys;
     const hasRelationships = Object.keys(queryKeyConfig.relationships).length > 0;
-    // 1. Generate client.ts
+    // 1. Generate client.ts (ORM client wrapper)
     files.push({
         path: 'client.ts',
-        content: (0, client_1.generateClientFile)({
-            browserCompatible: config.browserCompatible ?? true,
-        }),
+        content: (0, client_1.generateClientFile)(),
+    });
+    // 1b. Generate selection.ts (shared selection adapters for hooks)
+    files.push({
+        path: 'selection.ts',
+        content: (0, selection_1.generateSelectionFile)(),
     });
     // Collect table type names for import path resolution
     const tableTypeNames = new Set(tables.map((t) => (0, utils_1.getTableNames)(t).typeName));
-    // When using shared types, skip generating types.ts and schema-types.ts
-    // They're already generated in the shared directory
-    let hasSchemaTypes = false;
-    let generatedEnumNames = [];
-    if (sharedTypesPath) {
-        // Using shared types - check if schema-types would be generated
-        if (customOperations && customOperations.typeRegistry) {
-            const schemaTypesResult = (0, schema_types_generator_1.generateSchemaTypesFile)({
-                typeRegistry: customOperations.typeRegistry,
-                tableTypeNames,
-            });
-            if (schemaTypesResult.content.split('\n').length > 10) {
-                hasSchemaTypes = true;
-                generatedEnumNames = schemaTypesResult.generatedEnums || [];
-            }
-        }
-    }
-    else {
-        // 2. Generate schema-types.ts for custom operations (if any)
-        // NOTE: This must come BEFORE types.ts so that types.ts can import enum types
-        if (customOperations && customOperations.typeRegistry) {
-            const schemaTypesResult = (0, schema_types_generator_1.generateSchemaTypesFile)({
-                typeRegistry: customOperations.typeRegistry,
-                tableTypeNames,
-            });
-            // Only include if there's meaningful content
-            if (schemaTypesResult.content.split('\n').length > 10) {
-                files.push({
-                    path: 'schema-types.ts',
-                    content: schemaTypesResult.content,
-                });
-                hasSchemaTypes = true;
-                generatedEnumNames = schemaTypesResult.generatedEnums || [];
-            }
-        }
-        // 3. Generate types.ts (can now import enums from schema-types)
-        files.push({
-            path: 'types.ts',
-            content: (0, types_1.generateTypesFile)(tables, {
-                enumsFromSchemaTypes: generatedEnumNames,
-            }),
-        });
-    }
+    // NOTE: types.ts and schema-types.ts are no longer generated here.
+    // Hooks now import types directly from the ORM's input-types.ts,
+    // which serves as the single source of truth for all types.
     // 3b. Generate centralized query keys (query-keys.ts)
     let hasQueryKeys = false;
     if (useCentralizedKeys) {
@@ -153,7 +114,6 @@ function generate(options) {
         customQueryHooks = (0, custom_queries_1.generateAllCustomQueryHooks)({
             operations: customOperations.queries,
             typeRegistry: customOperations.typeRegistry,
-            maxDepth,
             skipQueryField,
             reactQueryEnabled,
             tableTypeNames,
@@ -176,10 +136,7 @@ function generate(options) {
     // 6. Generate table-based mutation hooks (mutations/*.ts)
     const mutationHooks = (0, mutations_1.generateAllMutationHooks)(tables, {
         reactQueryEnabled,
-        enumsFromSchemaTypes: generatedEnumNames,
         useCentralizedKeys,
-        hasRelationships,
-        tableTypeNames,
     });
     for (const hook of mutationHooks) {
         files.push({
@@ -193,7 +150,6 @@ function generate(options) {
         customMutationHooks = (0, custom_mutations_1.generateAllCustomMutationHooks)({
             operations: customOperations.mutations,
             typeRegistry: customOperations.typeRegistry,
-            maxDepth,
             skipQueryField,
             reactQueryEnabled,
             tableTypeNames,
@@ -217,11 +173,11 @@ function generate(options) {
                 : (0, barrel_1.generateMutationsBarrel)(tables),
         });
     }
-    // 9. Generate main index.ts barrel (with schema-types if present)
+    // 9. Generate main index.ts barrel
+    // No longer includes types.ts or schema-types.ts - hooks import from ORM directly
     files.push({
         path: 'index.ts',
         content: (0, barrel_1.generateMainBarrel)(tables, {
-            hasSchemaTypes,
             hasMutations,
             hasQueryKeys,
             hasMutationKeys,
@@ -243,34 +199,32 @@ function generate(options) {
 // ============================================================================
 // Re-exports for convenience
 // ============================================================================
+var barrel_2 = require("./barrel");
+Object.defineProperty(exports, "generateCustomMutationsBarrel", { enumerable: true, get: function () { return barrel_2.generateCustomMutationsBarrel; } });
+Object.defineProperty(exports, "generateCustomQueriesBarrel", { enumerable: true, get: function () { return barrel_2.generateCustomQueriesBarrel; } });
+Object.defineProperty(exports, "generateMainBarrel", { enumerable: true, get: function () { return barrel_2.generateMainBarrel; } });
+Object.defineProperty(exports, "generateMutationsBarrel", { enumerable: true, get: function () { return barrel_2.generateMutationsBarrel; } });
+Object.defineProperty(exports, "generateQueriesBarrel", { enumerable: true, get: function () { return barrel_2.generateQueriesBarrel; } });
 var client_2 = require("./client");
 Object.defineProperty(exports, "generateClientFile", { enumerable: true, get: function () { return client_2.generateClientFile; } });
-var types_2 = require("./types");
-Object.defineProperty(exports, "generateTypesFile", { enumerable: true, get: function () { return types_2.generateTypesFile; } });
-var queries_2 = require("./queries");
-Object.defineProperty(exports, "generateAllQueryHooks", { enumerable: true, get: function () { return queries_2.generateAllQueryHooks; } });
-Object.defineProperty(exports, "generateListQueryHook", { enumerable: true, get: function () { return queries_2.generateListQueryHook; } });
-Object.defineProperty(exports, "generateSingleQueryHook", { enumerable: true, get: function () { return queries_2.generateSingleQueryHook; } });
+var custom_mutations_2 = require("./custom-mutations");
+Object.defineProperty(exports, "generateAllCustomMutationHooks", { enumerable: true, get: function () { return custom_mutations_2.generateAllCustomMutationHooks; } });
+Object.defineProperty(exports, "generateCustomMutationHook", { enumerable: true, get: function () { return custom_mutations_2.generateCustomMutationHook; } });
+var custom_queries_2 = require("./custom-queries");
+Object.defineProperty(exports, "generateAllCustomQueryHooks", { enumerable: true, get: function () { return custom_queries_2.generateAllCustomQueryHooks; } });
+Object.defineProperty(exports, "generateCustomQueryHook", { enumerable: true, get: function () { return custom_queries_2.generateCustomQueryHook; } });
+var invalidation_2 = require("./invalidation");
+Object.defineProperty(exports, "generateInvalidationFile", { enumerable: true, get: function () { return invalidation_2.generateInvalidationFile; } });
+var mutation_keys_2 = require("./mutation-keys");
+Object.defineProperty(exports, "generateMutationKeysFile", { enumerable: true, get: function () { return mutation_keys_2.generateMutationKeysFile; } });
 var mutations_2 = require("./mutations");
 Object.defineProperty(exports, "generateAllMutationHooks", { enumerable: true, get: function () { return mutations_2.generateAllMutationHooks; } });
 Object.defineProperty(exports, "generateCreateMutationHook", { enumerable: true, get: function () { return mutations_2.generateCreateMutationHook; } });
-Object.defineProperty(exports, "generateUpdateMutationHook", { enumerable: true, get: function () { return mutations_2.generateUpdateMutationHook; } });
 Object.defineProperty(exports, "generateDeleteMutationHook", { enumerable: true, get: function () { return mutations_2.generateDeleteMutationHook; } });
-var custom_queries_2 = require("./custom-queries");
-Object.defineProperty(exports, "generateAllCustomQueryHooks", { enumerable: true, get: function () { return custom_queries_2.generateAllCustomQueryHooks; } });
-Object.defineProperty(exports, "generateCustomQueryHook", { enumerable: true, get: function () { return custom_queries_2.generateCustomQueryHook; } });
-var custom_mutations_2 = require("./custom-mutations");
-Object.defineProperty(exports, "generateAllCustomMutationHooks", { enumerable: true, get: function () { return custom_mutations_2.generateAllCustomMutationHooks; } });
-Object.defineProperty(exports, "generateCustomMutationHook", { enumerable: true, get: function () { return custom_mutations_2.generateCustomMutationHook; } });
-var barrel_2 = require("./barrel");
-Object.defineProperty(exports, "generateQueriesBarrel", { enumerable: true, get: function () { return barrel_2.generateQueriesBarrel; } });
-Object.defineProperty(exports, "generateMutationsBarrel", { enumerable: true, get: function () { return barrel_2.generateMutationsBarrel; } });
-Object.defineProperty(exports, "generateMainBarrel", { enumerable: true, get: function () { return barrel_2.generateMainBarrel; } });
-Object.defineProperty(exports, "generateCustomQueriesBarrel", { enumerable: true, get: function () { return barrel_2.generateCustomQueriesBarrel; } });
-Object.defineProperty(exports, "generateCustomMutationsBarrel", { enumerable: true, get: function () { return barrel_2.generateCustomMutationsBarrel; } });
+Object.defineProperty(exports, "generateUpdateMutationHook", { enumerable: true, get: function () { return mutations_2.generateUpdateMutationHook; } });
+var queries_2 = require("./queries");
+Object.defineProperty(exports, "generateAllQueryHooks", { enumerable: true, get: function () { return queries_2.generateAllQueryHooks; } });
+Object.defineProperty(exports, "generateListQueryHook", { enumerable: true, get: function () { return queries_2.generateListQueryHook; } });
+Object.defineProperty(exports, "generateSingleQueryHook", { enumerable: true, get: function () { return queries_2.generateSingleQueryHook; } });
 var query_keys_2 = require("./query-keys");
 Object.defineProperty(exports, "generateQueryKeysFile", { enumerable: true, get: function () { return query_keys_2.generateQueryKeysFile; } });
-var mutation_keys_2 = require("./mutation-keys");
-Object.defineProperty(exports, "generateMutationKeysFile", { enumerable: true, get: function () { return mutation_keys_2.generateMutationKeysFile; } });
-var invalidation_2 = require("./invalidation");
-Object.defineProperty(exports, "generateInvalidationFile", { enumerable: true, get: function () { return invalidation_2.generateInvalidationFile; } });

package/core/codegen/invalidation.d.ts

@@ -1,11 +1,5 @@
-/**
- * Cache invalidation helpers generator
- *
- * Generates type-safe cache invalidation utilities with cascade support
- * for parent-child entity relationships.
- */
-import type { CleanTable } from '../../types/schema';
 import type { QueryKeyConfig } from '../../types/config';
+import type { CleanTable } from '../../types/schema';
 export interface InvalidationGeneratorOptions {
     tables: CleanTable[];
     config: QueryKeyConfig;

package/core/codegen/invalidation.js

@@ -34,9 +34,15 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateInvalidationFile = generateInvalidationFile;
-const utils_1 = require("./utils");
+/**
+ * Cache invalidation helpers generator
+ *
+ * Generates type-safe cache invalidation utilities with cascade support
+ * for parent-child entity relationships.
+ */
 const t = __importStar(require("@babel/types"));
 const babel_ast_1 = require("./babel-ast");
+const utils_1 = require("./utils");
 /**
  * Build a map of parent -> children for cascade invalidation
  */
@@ -83,7 +89,11 @@ function buildEntityInvalidateProperty(table, relationships, childrenMap, allTab
     const queryClientTypeRef = () => t.tsTypeReference(t.identifier('QueryClient'));
     const stringOrNumberType = () => t.tsUnionType([t.tsStringKeyword(), t.tsNumberKeyword()]);
     // Helper to create queryClient.invalidateQueries({ queryKey: ... })
-    const invalidateCall = (queryKeyExpr) => t.callExpression(t.memberExpression(t.identifier('queryClient'), t.identifier('invalidateQueries')), [t.objectExpression([t.objectProperty(t.identifier('queryKey'), queryKeyExpr)])]);
+    const invalidateCall = (queryKeyExpr) => t.callExpression(t.memberExpression(t.identifier('queryClient'), t.identifier('invalidateQueries')), [
+        t.objectExpression([
+            t.objectProperty(t.identifier('queryKey'), queryKeyExpr),
+        ]),
+    ]);
     // all property
     const allArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef())], invalidateCall(t.memberExpression(t.identifier(keysName), t.identifier('all'))));
     const allProp = t.objectProperty(t.identifier('all'), allArrowFn);
@@ -108,11 +118,18 @@ function buildEntityInvalidateProperty(table, relationships, childrenMap, allTab
     if (hasParent) {
         const scopeTypeName = `${typeName}Scope`;
         const scopeParam = (0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true);
-        const detailArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()), (0, babel_ast_1.typedParam)('id', stringOrNumberType()), scopeParam], invalidateCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id'), t.identifier('scope')])));
+        const detailArrowFn = t.arrowFunctionExpression([
+            (0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()),
+            (0, babel_ast_1.typedParam)('id', stringOrNumberType()),
+            scopeParam,
+        ], invalidateCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id'), t.identifier('scope')])));
         detailProp = t.objectProperty(t.identifier('detail'), detailArrowFn);
     }
     else {
-        const detailArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()), (0, babel_ast_1.typedParam)('id', stringOrNumberType())], invalidateCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id')])));
+        const detailArrowFn = t.arrowFunctionExpression([
+            (0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()),
+            (0, babel_ast_1.typedParam)('id', stringOrNumberType()),
+        ], invalidateCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id')])));
         detailProp = t.objectProperty(t.identifier('detail'), detailArrowFn);
     }
     (0, babel_ast_1.addJSDocComment)(detailProp, [`Invalidate a specific ${singularName}`]);
@@ -156,7 +173,10 @@ function buildEntityInvalidateProperty(table, relationships, childrenMap, allTab
                 }
             }
         }
-        const withChildrenArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()), (0, babel_ast_1.typedParam)('id', stringOrNumberType())], t.blockStatement(cascadeStatements));
+        const withChildrenArrowFn = t.arrowFunctionExpression([
+            (0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()),
+            (0, babel_ast_1.typedParam)('id', stringOrNumberType()),
+        ], t.blockStatement(cascadeStatements));
         const withChildrenProp = t.objectProperty(t.identifier('withChildren'), withChildrenArrowFn);
         (0, babel_ast_1.addJSDocComment)(withChildrenProp, [
             `Invalidate ${singularName} and all child entities`,
@@ -179,19 +199,30 @@ function buildEntityRemoveProperty(table, relationships) {
     const queryClientTypeRef = () => t.tsTypeReference(t.identifier('QueryClient'));
     const stringOrNumberType = () => t.tsUnionType([t.tsStringKeyword(), t.tsNumberKeyword()]);
     // Helper to create queryClient.removeQueries({ queryKey: ... })
-    const removeCall = (queryKeyExpr) => t.callExpression(t.memberExpression(t.identifier('queryClient'), t.identifier('removeQueries')), [t.objectExpression([t.objectProperty(t.identifier('queryKey'), queryKeyExpr)])]);
+    const removeCall = (queryKeyExpr) => t.callExpression(t.memberExpression(t.identifier('queryClient'), t.identifier('removeQueries')), [
+        t.objectExpression([
+            t.objectProperty(t.identifier('queryKey'), queryKeyExpr),
+        ]),
+    ]);
     let removeProp;
     if (relationship) {
         const scopeTypeName = `${typeName}Scope`;
         const scopeParam = (0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true);
-        const removeArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()), (0, babel_ast_1.typedParam)('id', stringOrNumberType()), scopeParam], t.blockStatement([
-            t.expressionStatement(removeCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id'), t.identifier('scope')])))
+        const removeArrowFn = t.arrowFunctionExpression([
+            (0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()),
+            (0, babel_ast_1.typedParam)('id', stringOrNumberType()),
+            scopeParam,
+        ], t.blockStatement([
+            t.expressionStatement(removeCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id'), t.identifier('scope')]))),
         ]));
         removeProp = t.objectProperty(t.identifier(singularName), removeArrowFn);
     }
     else {
-        const removeArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()), (0, babel_ast_1.typedParam)('id', stringOrNumberType())], t.blockStatement([
-            t.expressionStatement(removeCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id')])))
+        const removeArrowFn = t.arrowFunctionExpression([
+            (0, babel_ast_1.typedParam)('queryClient', queryClientTypeRef()),
+            (0, babel_ast_1.typedParam)('id', stringOrNumberType()),
+        ], t.blockStatement([
+            t.expressionStatement(removeCall(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.identifier('id')]))),
         ]));
         removeProp = t.objectProperty(t.identifier(singularName), removeArrowFn);
     }
@@ -207,7 +238,9 @@ function generateInvalidationFile(options) {
     const childrenMap = buildChildrenMap(relationships);
     const statements = [];
     // Import QueryClient type
-    const queryClientImport = t.importDeclaration([t.importSpecifier(t.identifier('QueryClient'), t.identifier('QueryClient'))], t.stringLiteral('@tanstack/react-query'));
+    const queryClientImport = t.importDeclaration([
+        t.importSpecifier(t.identifier('QueryClient'), t.identifier('QueryClient')),
+    ], t.stringLiteral('@tanstack/react-query'));
     queryClientImport.importKind = 'type';
     statements.push(queryClientImport);
     // Import query keys
@@ -216,7 +249,7 @@ function generateInvalidationFile(options) {
         const { typeName } = (0, utils_1.getTableNames)(table);
         keyImports.push(`${(0, utils_1.lcFirst)(typeName)}Keys`);
     }
-    statements.push(t.importDeclaration(keyImports.map(name => t.importSpecifier(t.identifier(name), t.identifier(name))), t.stringLiteral('./query-keys')));
+    statements.push(t.importDeclaration(keyImports.map((name) => t.importSpecifier(t.identifier(name), t.identifier(name))), t.stringLiteral('./query-keys')));
     // Import scope types if needed
     const scopeTypes = [];
     for (const table of tables) {
@@ -226,7 +259,7 @@ function generateInvalidationFile(options) {
         }
     }
     if (scopeTypes.length > 0) {
-        const scopeImport = t.importDeclaration(scopeTypes.map(name => t.importSpecifier(t.identifier(name), t.identifier(name))), t.stringLiteral('./query-keys'));
+        const scopeImport = t.importDeclaration(scopeTypes.map((name) => t.importSpecifier(t.identifier(name), t.identifier(name))), t.stringLiteral('./query-keys'));
         scopeImport.importKind = 'type';
         statements.push(scopeImport);
     }
@@ -236,7 +269,7 @@ function generateInvalidationFile(options) {
         invalidateProperties.push(buildEntityInvalidateProperty(table, relationships, childrenMap, tables));
     }
     const invalidateDecl = t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('invalidate'), (0, babel_ast_1.asConst)(t.objectExpression(invalidateProperties)))
+        t.variableDeclarator(t.identifier('invalidate'), (0, babel_ast_1.asConst)(t.objectExpression(invalidateProperties))),
     ]));
     // Build JSDoc for invalidate
     const invalidateDocLines = [
@@ -267,7 +300,7 @@ function generateInvalidationFile(options) {
         removeProperties.push(buildEntityRemoveProperty(table, relationships));
     }
     const removeDecl = t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('remove'), (0, babel_ast_1.asConst)(t.objectExpression(removeProperties)))
+        t.variableDeclarator(t.identifier('remove'), (0, babel_ast_1.asConst)(t.objectExpression(removeProperties))),
     ]));
     (0, babel_ast_1.addJSDocComment)(removeDecl, [
         'Remove queries from cache (for delete operations)',
@@ -300,7 +333,8 @@ ${description}
     for (let i = 0; i < codeLines.length; i++) {
         const line = codeLines[i];
         // Detect invalidation section (after imports)
-        if (!addedInvalidationSection && line.includes('* Type-safe query invalidation helpers')) {
+        if (!addedInvalidationSection &&
+            line.includes('* Type-safe query invalidation helpers')) {
             content += `// ============================================================================
 // Invalidation Helpers
 // ============================================================================

package/core/codegen/mutation-keys.d.ts

@@ -1,14 +1,5 @@
-/**
- * Mutation key factory generator
- *
- * Generates centralized mutation keys for tracking in-flight mutations.
- * Useful for:
- * - Optimistic updates with rollback
- * - Mutation deduplication
- * - Tracking mutation state with useIsMutating
- */
-import type { CleanTable, CleanOperation } from '../../types/schema';
 import type { QueryKeyConfig } from '../../types/config';
+import type { CleanOperation, CleanTable } from '../../types/schema';
 export interface MutationKeyGeneratorOptions {
     tables: CleanTable[];
     customMutations: CleanOperation[];

package/core/codegen/mutation-keys.js

@@ -34,9 +34,18 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateMutationKeysFile = generateMutationKeysFile;
-const utils_1 = require("./utils");
+/**
+ * Mutation key factory generator
+ *
+ * Generates centralized mutation keys for tracking in-flight mutations.
+ * Useful for:
+ * - Optimistic updates with rollback
+ * - Mutation deduplication
+ * - Tracking mutation state with useIsMutating
+ */
 const t = __importStar(require("@babel/types"));
 const babel_ast_1 = require("./babel-ast");
+const utils_1 = require("./utils");
 /**
  * Generate mutation keys declaration for a single table entity
  */
@@ -61,7 +70,7 @@ function generateEntityMutationKeysDeclaration(table, relationships) {
             t.stringLiteral(entityKey),
             t.stringLiteral('create'),
             t.objectExpression([
-                t.objectProperty(t.identifier(relationship.foreignKey), t.identifier(relationship.foreignKey), false, true)
+                t.objectProperty(t.identifier(relationship.foreignKey), t.identifier(relationship.foreignKey), false, true),
             ]),
         ]), (0, babel_ast_1.constArray)([
             t.stringLiteral('mutation'),
@@ -81,7 +90,9 @@ function generateEntityMutationKeysDeclaration(table, relationships) {
     (0, babel_ast_1.addJSDocComment)(createProp, [`Create ${singularName} mutation key`]);
     properties.push(createProp);
     // update property
-    const updateArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('id', t.tsUnionType([t.tsStringKeyword(), t.tsNumberKeyword()]))], (0, babel_ast_1.constArray)([
+    const updateArrowFn = t.arrowFunctionExpression([
+        (0, babel_ast_1.typedParam)('id', t.tsUnionType([t.tsStringKeyword(), t.tsNumberKeyword()])),
+    ], (0, babel_ast_1.constArray)([
         t.stringLiteral('mutation'),
         t.stringLiteral(entityKey),
         t.stringLiteral('update'),
@@ -91,7 +102,9 @@ function generateEntityMutationKeysDeclaration(table, relationships) {
     (0, babel_ast_1.addJSDocComment)(updateProp, [`Update ${singularName} mutation key`]);
     properties.push(updateProp);
     // delete property
-    const deleteArrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)('id', t.tsUnionType([t.tsStringKeyword(), t.tsNumberKeyword()]))], (0, babel_ast_1.constArray)([
+    const deleteArrowFn = t.arrowFunctionExpression([
+        (0, babel_ast_1.typedParam)('id', t.tsUnionType([t.tsStringKeyword(), t.tsNumberKeyword()])),
+    ], (0, babel_ast_1.constArray)([
         t.stringLiteral('mutation'),
         t.stringLiteral(entityKey),
         t.stringLiteral('delete'),
@@ -101,7 +114,7 @@ function generateEntityMutationKeysDeclaration(table, relationships) {
     (0, babel_ast_1.addJSDocComment)(deleteProp, [`Delete ${singularName} mutation key`]);
     properties.push(deleteProp);
     return t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier(keysName), (0, babel_ast_1.asConst)(t.objectExpression(properties)))
+        t.variableDeclarator(t.identifier(keysName), (0, babel_ast_1.asConst)(t.objectExpression(properties))),
     ]));
 }
 /**
@@ -133,7 +146,7 @@ function generateCustomMutationKeysDeclaration(operations) {
         properties.push(prop);
     }
     return t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('customMutationKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties)))
+        t.variableDeclarator(t.identifier('customMutationKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties))),
     ]));
 }
 /**
@@ -150,7 +163,7 @@ function generateUnifiedMutationStoreDeclaration(tables, hasCustomMutations) {
         properties.push(t.objectProperty(t.identifier('custom'), t.identifier('customMutationKeys')));
     }
     const decl = t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('mutationKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties)))
+        t.variableDeclarator(t.identifier('mutationKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties))),
     ]));
     (0, babel_ast_1.addJSDocComment)(decl, [
         'Unified mutation key store',
@@ -219,7 +232,8 @@ ${description}
     for (let i = 0; i < codeLines.length; i++) {
         const line = codeLines[i];
         // Detect custom mutation keys section
-        if (!addedCustomSection && line.startsWith('export const customMutationKeys')) {
+        if (!addedCustomSection &&
+            line.startsWith('export const customMutationKeys')) {
             content += `
 // ============================================================================
 // Custom Mutation Keys

package/core/codegen/mutations.d.ts

@@ -1,12 +1,3 @@
-/**
- * Mutation hook generators using Babel AST-based code generation
- *
- * Output structure:
- * mutations/
- *   useCreateCarMutation.ts
- *   useUpdateCarMutation.ts
- *   useDeleteCarMutation.ts
- */
 import type { CleanTable } from '../../types/schema';
 export interface GeneratedMutationFile {
     fileName: string;
@@ -14,11 +5,7 @@ export interface GeneratedMutationFile {
 }
 export interface MutationGeneratorOptions {
     reactQueryEnabled?: boolean;
-    enumsFromSchemaTypes?: string[];
     useCentralizedKeys?: boolean;
-    hasRelationships?: boolean;
-    /** All table type names for determining which types to import from types.ts vs schema-types.ts */
-    tableTypeNames?: Set<string>;
 }
 export declare function generateCreateMutationHook(table: CleanTable, options?: MutationGeneratorOptions): GeneratedMutationFile | null;
 export declare function generateUpdateMutationHook(table: CleanTable, options?: MutationGeneratorOptions): GeneratedMutationFile | null;