@constructive-io/graphql-codegen 3.2.0 → 3.3.0

package/core/codegen/queries.js

@@ -36,325 +36,109 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateListQueryHook = generateListQueryHook;
 exports.generateSingleQueryHook = generateSingleQueryHook;
 exports.generateAllQueryHooks = generateAllQueryHooks;
+/**
+ * Query hook generators - delegates to ORM model methods (Babel AST-based)
+ *
+ * Output structure:
+ * queries/
+ *   useCarsQuery.ts    - List query hook -> ORM findMany
+ *   useCarQuery.ts     - Single item query hook -> ORM findOne
+ */
 const t = __importStar(require("@babel/types"));
 const babel_ast_1 = require("./babel-ast");
-const gql_ast_1 = require("./gql-ast");
+const hooks_ast_1 = require("./hooks-ast");
 const utils_1 = require("./utils");
-function createUnionType(values) {
-    return t.tsUnionType(values.map((v) => t.tsLiteralType(t.stringLiteral(v))));
-}
-function createFilterInterfaceDeclaration(name, fieldFilters, isExported = true) {
-    const properties = [];
-    for (const filter of fieldFilters) {
-        const prop = t.tsPropertySignature(t.identifier(filter.fieldName), t.tsTypeAnnotation(t.tsTypeReference(t.identifier(filter.filterType))));
-        prop.optional = true;
-        properties.push(prop);
-    }
-    const andProp = t.tsPropertySignature(t.identifier('and'), t.tsTypeAnnotation(t.tsArrayType(t.tsTypeReference(t.identifier(name)))));
-    andProp.optional = true;
-    properties.push(andProp);
-    const orProp = t.tsPropertySignature(t.identifier('or'), t.tsTypeAnnotation(t.tsArrayType(t.tsTypeReference(t.identifier(name)))));
-    orProp.optional = true;
-    properties.push(orProp);
-    const notProp = t.tsPropertySignature(t.identifier('not'), t.tsTypeAnnotation(t.tsTypeReference(t.identifier(name))));
-    notProp.optional = true;
-    properties.push(notProp);
-    const body = t.tsInterfaceBody(properties);
-    const interfaceDecl = t.tsInterfaceDeclaration(t.identifier(name), null, null, body);
-    if (isExported) {
-        return t.exportNamedDeclaration(interfaceDecl);
-    }
-    return interfaceDecl;
-}
 function generateListQueryHook(table, options = {}) {
     const { reactQueryEnabled = true, useCentralizedKeys = true, hasRelationships = false, } = options;
-    const { typeName, pluralName } = (0, utils_1.getTableNames)(table);
+    const { typeName, pluralName, singularName } = (0, utils_1.getTableNames)(table);
     const hookName = (0, utils_1.getListQueryHookName)(table);
     const queryName = (0, utils_1.getAllRowsQueryName)(table);
     const filterTypeName = (0, utils_1.getFilterTypeName)(table);
-    const conditionTypeName = (0, utils_1.getConditionTypeName)(table);
     const orderByTypeName = (0, utils_1.getOrderByTypeName)(table);
-    const scalarFields = (0, utils_1.getScalarFields)(table);
     const keysName = `${(0, utils_1.lcFirst)(typeName)}Keys`;
     const scopeTypeName = `${typeName}Scope`;
-    const queryAST = (0, gql_ast_1.buildListQueryAST)({ table });
-    const queryDocument = (0, gql_ast_1.printGraphQL)(queryAST);
+    const selectTypeName = `${typeName}Select`;
+    const relationTypeName = `${typeName}WithRelations`;
+    const listResultTypeAST = (sel) => (0, hooks_ast_1.listQueryResultType)(queryName, relationTypeName, sel);
     const statements = [];
-    const filterTypesUsed = new Set();
-    for (const field of scalarFields) {
-        const filterType = (0, utils_1.getScalarFilterType)(field.type.gqlType, field.type.isArray);
-        if (filterType) {
-            filterTypesUsed.add(filterType);
-        }
-    }
+    // Imports
     if (reactQueryEnabled) {
-        const reactQueryImport = t.importDeclaration([t.importSpecifier(t.identifier('useQuery'), t.identifier('useQuery'))], t.stringLiteral('@tanstack/react-query'));
-        statements.push(reactQueryImport);
-        const reactQueryTypeImport = t.importDeclaration([
-            t.importSpecifier(t.identifier('UseQueryOptions'), t.identifier('UseQueryOptions')),
-            t.importSpecifier(t.identifier('QueryClient'), t.identifier('QueryClient')),
-        ], t.stringLiteral('@tanstack/react-query'));
-        reactQueryTypeImport.importKind = 'type';
-        statements.push(reactQueryTypeImport);
+        statements.push((0, hooks_ast_1.createImportDeclaration)('@tanstack/react-query', ['useQuery']));
+        statements.push((0, hooks_ast_1.createImportDeclaration)('@tanstack/react-query', ['UseQueryOptions', 'UseQueryResult', 'QueryClient'], true));
     }
-    const clientImport = t.importDeclaration([t.importSpecifier(t.identifier('execute'), t.identifier('execute'))], t.stringLiteral('../client'));
-    statements.push(clientImport);
-    const clientTypeImport = t.importDeclaration([
-        t.importSpecifier(t.identifier('ExecuteOptions'), t.identifier('ExecuteOptions')),
-    ], t.stringLiteral('../client'));
-    clientTypeImport.importKind = 'type';
-    statements.push(clientTypeImport);
-    const typesImport = t.importDeclaration([
-        t.importSpecifier(t.identifier(typeName), t.identifier(typeName)),
-        ...Array.from(filterTypesUsed).map((ft) => t.importSpecifier(t.identifier(ft), t.identifier(ft))),
-    ], t.stringLiteral('../types'));
-    typesImport.importKind = 'type';
-    statements.push(typesImport);
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../client', ['getClient']));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../selection', ['buildListSelectionArgs']));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../selection', ['ListSelectionConfig'], true));
     if (useCentralizedKeys) {
-        const queryKeyImport = t.importDeclaration([t.importSpecifier(t.identifier(keysName), t.identifier(keysName))], t.stringLiteral('../query-keys'));
-        statements.push(queryKeyImport);
+        statements.push((0, hooks_ast_1.createImportDeclaration)('../query-keys', [keysName]));
         if (hasRelationships) {
-            const scopeTypeImport = t.importDeclaration([
-                t.importSpecifier(t.identifier(scopeTypeName), t.identifier(scopeTypeName)),
-            ], t.stringLiteral('../query-keys'));
-            scopeTypeImport.importKind = 'type';
-            statements.push(scopeTypeImport);
+            statements.push((0, hooks_ast_1.createImportDeclaration)('../query-keys', [scopeTypeName], true));
         }
     }
-    const reExportDecl = t.exportNamedDeclaration(null, [t.exportSpecifier(t.identifier(typeName), t.identifier(typeName))], t.stringLiteral('../types'));
-    reExportDecl.exportKind = 'type';
-    statements.push(reExportDecl);
-    const queryDocConst = t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier(`${queryName}QueryDocument`), t.templateLiteral([
-            t.templateElement({ raw: '\n' + queryDocument, cooked: '\n' + queryDocument }, true),
-        ], [])),
-    ]);
-    statements.push(t.exportNamedDeclaration(queryDocConst));
-    const fieldFilters = scalarFields
-        .map((field) => {
-        const filterType = (0, utils_1.getScalarFilterType)(field.type.gqlType, field.type.isArray);
-        return filterType ? { fieldName: field.name, filterType } : null;
-    })
-        .filter((f) => f !== null);
-    statements.push(createFilterInterfaceDeclaration(filterTypeName, fieldFilters, false));
-    // Generate Condition interface (simple equality filter with scalar types)
-    // Track non-primitive types (enums) that need to be imported
-    const enumTypesUsed = new Set();
-    const conditionProperties = scalarFields.map((field) => {
-        const tsType = (0, utils_1.fieldTypeToTs)(field.type);
-        const isPrimitive = tsType === 'string' ||
-            tsType === 'number' ||
-            tsType === 'boolean' ||
-            tsType === 'unknown' ||
-            tsType.endsWith('[]');
-        let typeAnnotation;
-        if (field.type.isArray) {
-            const baseType = tsType.replace('[]', '');
-            const isBasePrimitive = baseType === 'string' ||
-                baseType === 'number' ||
-                baseType === 'boolean' ||
-                baseType === 'unknown';
-            if (!isBasePrimitive) {
-                enumTypesUsed.add(baseType);
-            }
-            typeAnnotation = t.tsArrayType(baseType === 'string'
-                ? t.tsStringKeyword()
-                : baseType === 'number'
-                    ? t.tsNumberKeyword()
-                    : baseType === 'boolean'
-                        ? t.tsBooleanKeyword()
-                        : t.tsTypeReference(t.identifier(baseType)));
-        }
-        else {
-            if (!isPrimitive) {
-                enumTypesUsed.add(tsType);
-            }
-            typeAnnotation =
-                tsType === 'string'
-                    ? t.tsStringKeyword()
-                    : tsType === 'number'
-                        ? t.tsNumberKeyword()
-                        : tsType === 'boolean'
-                            ? t.tsBooleanKeyword()
-                            : t.tsTypeReference(t.identifier(tsType));
-        }
-        const prop = t.tsPropertySignature(t.identifier(field.name), t.tsTypeAnnotation(typeAnnotation));
-        prop.optional = true;
-        return prop;
-    });
-    // Add import for enum types if any are used
-    if (enumTypesUsed.size > 0) {
-        const schemaTypesImport = t.importDeclaration(Array.from(enumTypesUsed).map((et) => t.importSpecifier(t.identifier(et), t.identifier(et))), t.stringLiteral('../schema-types'));
-        schemaTypesImport.importKind = 'type';
-        statements.push(schemaTypesImport);
-    }
-    const conditionInterface = t.tsInterfaceDeclaration(t.identifier(conditionTypeName), null, null, t.tsInterfaceBody(conditionProperties));
-    statements.push(conditionInterface);
-    const orderByValues = [
-        ...scalarFields.flatMap((f) => [
-            `${(0, utils_1.toScreamingSnake)(f.name)}_ASC`,
-            `${(0, utils_1.toScreamingSnake)(f.name)}_DESC`,
-        ]),
-        'NATURAL',
-        'PRIMARY_KEY_ASC',
-        'PRIMARY_KEY_DESC',
-    ];
-    const orderByTypeAlias = t.tsTypeAliasDeclaration(t.identifier(orderByTypeName), null, createUnionType(orderByValues));
-    statements.push(orderByTypeAlias);
-    const variablesInterfaceBody = t.tsInterfaceBody([
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('first'), t.tsTypeAnnotation(t.tsNumberKeyword()));
-            p.optional = true;
-            return p;
-        })(),
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('last'), t.tsTypeAnnotation(t.tsNumberKeyword()));
-            p.optional = true;
-            return p;
-        })(),
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('offset'), t.tsTypeAnnotation(t.tsNumberKeyword()));
-            p.optional = true;
-            return p;
-        })(),
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('before'), t.tsTypeAnnotation(t.tsStringKeyword()));
-            p.optional = true;
-            return p;
-        })(),
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('after'), t.tsTypeAnnotation(t.tsStringKeyword()));
-            p.optional = true;
-            return p;
-        })(),
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('filter'), t.tsTypeAnnotation(t.tsTypeReference(t.identifier(filterTypeName))));
-            p.optional = true;
-            return p;
-        })(),
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('condition'), t.tsTypeAnnotation(t.tsTypeReference(t.identifier(conditionTypeName))));
-            p.optional = true;
-            return p;
-        })(),
-        (() => {
-            const p = t.tsPropertySignature(t.identifier('orderBy'), t.tsTypeAnnotation(t.tsArrayType(t.tsTypeReference(t.identifier(orderByTypeName)))));
-            p.optional = true;
-            return p;
-        })(),
-    ]);
-    const variablesInterface = t.tsInterfaceDeclaration(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`), null, null, variablesInterfaceBody);
-    statements.push(t.exportNamedDeclaration(variablesInterface));
-    const pageInfoType = t.tsTypeLiteral([
-        t.tsPropertySignature(t.identifier('hasNextPage'), t.tsTypeAnnotation(t.tsBooleanKeyword())),
-        t.tsPropertySignature(t.identifier('hasPreviousPage'), t.tsTypeAnnotation(t.tsBooleanKeyword())),
-        t.tsPropertySignature(t.identifier('startCursor'), t.tsTypeAnnotation(t.tsUnionType([t.tsStringKeyword(), t.tsNullKeyword()]))),
-        t.tsPropertySignature(t.identifier('endCursor'), t.tsTypeAnnotation(t.tsUnionType([t.tsStringKeyword(), t.tsNullKeyword()]))),
-    ]);
-    const resultType = t.tsTypeLiteral([
-        t.tsPropertySignature(t.identifier('totalCount'), t.tsTypeAnnotation(t.tsNumberKeyword())),
-        t.tsPropertySignature(t.identifier('nodes'), t.tsTypeAnnotation(t.tsArrayType(t.tsTypeReference(t.identifier(typeName))))),
-        t.tsPropertySignature(t.identifier('pageInfo'), t.tsTypeAnnotation(pageInfoType)),
-    ]);
-    const resultInterfaceBody = t.tsInterfaceBody([
-        t.tsPropertySignature(t.identifier(queryName), t.tsTypeAnnotation(resultType)),
-    ]);
-    const resultInterface = t.tsInterfaceDeclaration(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryResult`), null, null, resultInterfaceBody);
-    statements.push(t.exportNamedDeclaration(resultInterface));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../../orm/input-types', [selectTypeName, relationTypeName, filterTypeName, orderByTypeName], true));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../../orm/select-types', ['FindManyArgs', 'InferSelectResult', 'ConnectionResult', 'StrictSelect'], true));
+    // Re-exports
+    statements.push((0, hooks_ast_1.createTypeReExport)([selectTypeName, relationTypeName, filterTypeName, orderByTypeName], '../../orm/input-types'));
+    // Query key
     if (useCentralizedKeys) {
-        const queryKeyConst = t.variableDeclaration('const', [
+        const keyDecl = t.exportNamedDeclaration(t.variableDeclaration('const', [
             t.variableDeclarator(t.identifier(`${queryName}QueryKey`), t.memberExpression(t.identifier(keysName), t.identifier('list'))),
-        ]);
-        const queryKeyExport = t.exportNamedDeclaration(queryKeyConst);
-        (0, babel_ast_1.addJSDocComment)(queryKeyExport, [
+        ]));
+        (0, hooks_ast_1.addJSDocComment)(keyDecl, [
             'Query key factory - re-exported from query-keys.ts',
         ]);
-        statements.push(queryKeyExport);
+        statements.push(keyDecl);
     }
     else {
-        const queryKeyArrow = t.arrowFunctionExpression([
-            (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)), true),
-        ], t.tsAsExpression(t.arrayExpression([
+        const keyFn = t.arrowFunctionExpression([
+            (0, hooks_ast_1.createFunctionParam)('variables', (0, hooks_ast_1.typeRef)('FindManyArgs', [
+                t.tsUnknownKeyword(),
+                (0, hooks_ast_1.typeRef)(filterTypeName),
+                (0, hooks_ast_1.typeRef)(orderByTypeName),
+            ]), true),
+        ], (0, babel_ast_1.asConst)(t.arrayExpression([
             t.stringLiteral(typeName.toLowerCase()),
             t.stringLiteral('list'),
             t.identifier('variables'),
-        ]), t.tsTypeReference(t.identifier('const'))));
-        const queryKeyConst = t.variableDeclaration('const', [
-            t.variableDeclarator(t.identifier(`${queryName}QueryKey`), queryKeyArrow),
-        ]);
-        statements.push(t.exportNamedDeclaration(queryKeyConst));
+        ])));
+        statements.push(t.exportNamedDeclaration(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier(`${queryName}QueryKey`), keyFn),
+        ])));
     }
-    if (reactQueryEnabled) {
-        const hookBodyStatements = [];
-        if (hasRelationships && useCentralizedKeys) {
-            hookBodyStatements.push(t.variableDeclaration('const', [
-                t.variableDeclarator(t.objectPattern([
-                    t.objectProperty(t.identifier('scope'), t.identifier('scope'), false, true),
-                    t.restElement(t.identifier('queryOptions')),
-                ]), t.logicalExpression('??', t.identifier('options'), t.objectExpression([]))),
-            ]));
-            hookBodyStatements.push(t.returnStatement(t.callExpression(t.identifier('useQuery'), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('list')), [t.identifier('variables'), t.identifier('scope')])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)),
-                    ]))),
-                    t.spreadElement(t.identifier('queryOptions')),
-                ]),
-            ])));
-        }
-        else if (useCentralizedKeys) {
-            hookBodyStatements.push(t.returnStatement(t.callExpression(t.identifier('useQuery'), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('list')), [t.identifier('variables')])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)),
-                    ]))),
-                    t.spreadElement(t.identifier('options')),
-                ]),
-            ])));
-        }
-        else {
-            hookBodyStatements.push(t.returnStatement(t.callExpression(t.identifier('useQuery'), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), t.callExpression(t.identifier(`${queryName}QueryKey`), [
-                        t.identifier('variables'),
-                    ])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)),
-                    ]))),
-                    t.spreadElement(t.identifier('options')),
-                ]),
-            ])));
+    // Helper for query key call
+    const buildListQueryKey = (argsExpr, scopeExpr) => {
+        if (useCentralizedKeys) {
+            const args = [argsExpr];
+            if (scopeExpr)
+                args.push(scopeExpr);
+            return (0, hooks_ast_1.callExpr)(t.memberExpression(t.identifier(keysName), t.identifier('list')), args);
         }
-        const hookParams = [
-            (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)), true),
-        ];
-        let optionsTypeStr;
+        return (0, hooks_ast_1.callExpr)(t.identifier(`${queryName}QueryKey`), [argsExpr]);
+    };
+    // Helper for findMany queryFn
+    const buildFindManyFn = () => t.arrowFunctionExpression([], (0, hooks_ast_1.buildFindManyCallExpr)(singularName, 'args'));
+    // Options type builder with optional scope
+    const buildOptionsType = (queryDataType, dataType) => {
+        const base = (0, hooks_ast_1.omitType)((0, hooks_ast_1.typeRef)('UseQueryOptions', [queryDataType, (0, hooks_ast_1.typeRef)('Error'), dataType]), ['queryKey', 'queryFn']);
         if (hasRelationships && useCentralizedKeys) {
-            optionsTypeStr = `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(pluralName)}QueryResult, Error>, 'queryKey' | 'queryFn'> & { scope?: ${scopeTypeName} }`;
+            return t.tsIntersectionType([base, (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName)]);
         }
-        else {
-            optionsTypeStr = `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(pluralName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`;
-        }
-        const optionsParam = t.identifier('options');
-        optionsParam.optional = true;
-        optionsParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier(optionsTypeStr)));
-        hookParams.push(optionsParam);
-        const hookFunc = t.functionDeclaration(t.identifier(hookName), hookParams, t.blockStatement(hookBodyStatements));
-        const hookExport = t.exportNamedDeclaration(hookFunc);
+        return base;
+    };
+    // Hook
+    if (reactQueryEnabled) {
         const docLines = [
             `Query hook for fetching ${typeName} list`,
             '',
             '@example',
             '```tsx',
             `const { data, isLoading } = ${hookName}({`,
-            '  first: 10,',
-            '  filter: { name: { equalTo: "example" } },',
-            "  orderBy: ['CREATED_AT_DESC'],",
+            '  selection: {',
+            '    fields: { id: true, name: true },',
+            '    where: { name: { equalTo: "example" } },',
+            "    orderBy: ['CREATED_AT_DESC'],",
+            '    first: 10,',
+            '  },',
             '});',
             '```',
         ];
@@ -362,364 +146,381 @@ function generateListQueryHook(table, options = {}) {
             docLines.push('');
             docLines.push('@example With scope for hierarchical cache invalidation');
             docLines.push('```tsx');
-            docLines.push(`const { data } = ${hookName}(`);
-            docLines.push('  { first: 10 },');
-            docLines.push("  { scope: { parentId: 'parent-id' } }");
-            docLines.push(');');
+            docLines.push(`const { data } = ${hookName}({`);
+            docLines.push('  selection: { fields: { id: true }, first: 10 },');
+            docLines.push("  scope: { parentId: 'parent-id' },");
+            docLines.push('});');
             docLines.push('```');
         }
-        (0, babel_ast_1.addJSDocComment)(hookExport, docLines);
-        statements.push(hookExport);
-    }
-    const fetchFuncBody = t.blockStatement([
-        t.returnStatement((0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
-            t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryResult`)),
-            t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)),
-        ])),
-    ]);
-    const fetchFunc = t.functionDeclaration(t.identifier(`fetch${(0, utils_1.ucFirst)(pluralName)}Query`), [
-        (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)), true),
-        (0, babel_ast_1.typedParam)('options', t.tsTypeReference(t.identifier('ExecuteOptions')), true),
-    ], fetchFuncBody);
-    fetchFunc.async = true;
-    fetchFunc.returnType = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Promise'), t.tsTypeParameterInstantiation([
-        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryResult`)),
-    ])));
-    const fetchExport = t.exportNamedDeclaration(fetchFunc);
-    (0, babel_ast_1.addJSDocComment)(fetchExport, [
-        `Fetch ${typeName} list without React hooks`,
-        '',
-        '@example',
-        '```ts',
-        '// Direct fetch',
-        `const data = await fetch${(0, utils_1.ucFirst)(pluralName)}Query({ first: 10 });`,
-        '',
-        '// With QueryClient',
-        'const data = await queryClient.fetchQuery({',
-        `  queryKey: ${queryName}QueryKey(variables),`,
-        `  queryFn: () => fetch${(0, utils_1.ucFirst)(pluralName)}Query(variables),`,
-        '});',
-        '```',
-    ]);
-    statements.push(fetchExport);
-    if (reactQueryEnabled) {
-        const prefetchParams = [
-            (0, babel_ast_1.typedParam)('queryClient', t.tsTypeReference(t.identifier('QueryClient'))),
-            (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)), true),
-        ];
-        if (hasRelationships && useCentralizedKeys) {
-            prefetchParams.push((0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true));
-        }
-        prefetchParams.push((0, babel_ast_1.typedParam)('options', t.tsTypeReference(t.identifier('ExecuteOptions')), true));
-        let prefetchQueryKeyExpr;
+        // Overload 1: with fields
+        const o1ParamType = t.tsIntersectionType([
+            t.tsTypeLiteral([
+                t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.withFieldsListSelectionType)((0, hooks_ast_1.sRef)(), selectTypeName, filterTypeName, orderByTypeName))),
+            ]),
+            buildOptionsType(listResultTypeAST((0, hooks_ast_1.sRef)()), (0, hooks_ast_1.typeRef)('TData')),
+        ]);
+        const o1 = (0, hooks_ast_1.exportDeclareFunction)(hookName, (0, hooks_ast_1.createSAndTDataTypeParams)(selectTypeName, listResultTypeAST((0, hooks_ast_1.sRef)())), [(0, hooks_ast_1.createFunctionParam)('params', o1ParamType)], (0, hooks_ast_1.typeRef)('UseQueryResult', [(0, hooks_ast_1.typeRef)('TData')]));
+        (0, hooks_ast_1.addJSDocComment)(o1, docLines);
+        statements.push(o1);
+        // Implementation
+        const implSelProp = t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.listSelectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName), filterTypeName, orderByTypeName)));
+        const implOptionsType = (() => {
+            const base = (0, hooks_ast_1.useQueryOptionsImplType)();
+            if (hasRelationships && useCentralizedKeys) {
+                return t.tsIntersectionType([base, (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName)]);
+            }
+            return base;
+        })();
+        const implParamType = t.tsIntersectionType([
+            t.tsTypeLiteral([implSelProp]),
+            implOptionsType,
+        ]);
+        const body = [];
+        body.push((0, hooks_ast_1.buildListSelectionArgsCall)(selectTypeName, filterTypeName, orderByTypeName));
         if (hasRelationships && useCentralizedKeys) {
-            prefetchQueryKeyExpr = t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('list')), [t.identifier('variables'), t.identifier('scope')]);
-        }
-        else if (useCentralizedKeys) {
-            prefetchQueryKeyExpr = t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('list')), [t.identifier('variables')]);
+            body.push((0, hooks_ast_1.destructureParamsWithSelectionAndScope)('queryOptions'));
+            body.push((0, hooks_ast_1.voidStatement)('_selection'));
+            body.push((0, hooks_ast_1.returnUseQuery)(buildListQueryKey(t.identifier('args'), t.identifier('scope')), buildFindManyFn(), [(0, hooks_ast_1.spreadObj)(t.identifier('queryOptions'))]));
         }
         else {
-            prefetchQueryKeyExpr = t.callExpression(t.identifier(`${queryName}QueryKey`), [t.identifier('variables')]);
+            body.push((0, hooks_ast_1.destructureParamsWithSelection)('queryOptions'));
+            body.push((0, hooks_ast_1.voidStatement)('_selection'));
+            body.push((0, hooks_ast_1.returnUseQuery)(buildListQueryKey(t.identifier('args')), buildFindManyFn(), [(0, hooks_ast_1.spreadObj)(t.identifier('queryOptions'))]));
         }
-        const prefetchFuncBody = t.blockStatement([
-            t.expressionStatement(t.awaitExpression(t.callExpression(t.memberExpression(t.identifier('queryClient'), t.identifier('prefetchQuery')), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), prefetchQueryKeyExpr),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(pluralName)}QueryVariables`)),
-                    ]))),
-                ]),
-            ]))),
+        statements.push((0, hooks_ast_1.exportFunction)(hookName, null, [(0, hooks_ast_1.createFunctionParam)('params', implParamType)], body));
+    }
+    // Fetch function
+    const fetchFnName = `fetch${(0, utils_1.ucFirst)(pluralName)}Query`;
+    {
+        // Overload 1: with fields
+        const f1ParamType = t.tsTypeLiteral([
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.withFieldsListSelectionType)((0, hooks_ast_1.sRef)(), selectTypeName, filterTypeName, orderByTypeName))),
+        ]);
+        const f1Decl = (0, hooks_ast_1.exportAsyncDeclareFunction)(fetchFnName, (0, hooks_ast_1.createSTypeParam)(selectTypeName), [(0, hooks_ast_1.createFunctionParam)('params', f1ParamType)], (0, hooks_ast_1.typeRef)('Promise', [listResultTypeAST((0, hooks_ast_1.sRef)())]));
+        (0, hooks_ast_1.addJSDocComment)(f1Decl, [
+            `Fetch ${typeName} list without React hooks`,
+            '',
+            '@example',
+            '```ts',
+            `const data = await ${fetchFnName}({`,
+            '  selection: {',
+            '    fields: { id: true },',
+            '    first: 10,',
+            '  },',
+            '});',
+            '```',
+        ]);
+        statements.push(f1Decl);
+        // Implementation
+        const fImplParamType = t.tsTypeLiteral([
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.listSelectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName), filterTypeName, orderByTypeName))),
         ]);
-        const prefetchFunc = t.functionDeclaration(t.identifier(`prefetch${(0, utils_1.ucFirst)(pluralName)}Query`), prefetchParams, prefetchFuncBody);
-        prefetchFunc.async = true;
-        prefetchFunc.returnType = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Promise'), t.tsTypeParameterInstantiation([t.tsVoidKeyword()])));
-        const prefetchExport = t.exportNamedDeclaration(prefetchFunc);
-        (0, babel_ast_1.addJSDocComment)(prefetchExport, [
+        const fBody = [];
+        fBody.push((0, hooks_ast_1.buildListSelectionArgsCall)(selectTypeName, filterTypeName, orderByTypeName));
+        fBody.push(t.returnStatement((0, hooks_ast_1.buildFindManyCallExpr)(singularName, 'args')));
+        statements.push((0, hooks_ast_1.exportAsyncFunction)(fetchFnName, null, [(0, hooks_ast_1.createFunctionParam)('params', fImplParamType)], fBody));
+    }
+    // Prefetch function
+    if (reactQueryEnabled) {
+        const prefetchFnName = `prefetch${(0, utils_1.ucFirst)(pluralName)}Query`;
+        // Overload 1: with fields
+        const p1Params = [
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.withFieldsListSelectionType)((0, hooks_ast_1.sRef)(), selectTypeName, filterTypeName, orderByTypeName))),
+        ];
+        const p1ParamType = hasRelationships && useCentralizedKeys
+            ? t.tsIntersectionType([
+                t.tsTypeLiteral(p1Params),
+                (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName),
+            ])
+            : t.tsTypeLiteral(p1Params);
+        const p1Decl = (0, hooks_ast_1.exportAsyncDeclareFunction)(prefetchFnName, (0, hooks_ast_1.createSTypeParam)(selectTypeName), [
+            (0, hooks_ast_1.createFunctionParam)('queryClient', (0, hooks_ast_1.typeRef)('QueryClient')),
+            (0, hooks_ast_1.createFunctionParam)('params', p1ParamType),
+        ], (0, hooks_ast_1.typeRef)('Promise', [t.tsVoidKeyword()]));
+        (0, hooks_ast_1.addJSDocComment)(p1Decl, [
             `Prefetch ${typeName} list for SSR or cache warming`,
             '',
             '@example',
             '```ts',
-            `await prefetch${(0, utils_1.ucFirst)(pluralName)}Query(queryClient, { first: 10 });`,
+            `await ${prefetchFnName}(queryClient, { selection: { fields: { id: true }, first: 10 } });`,
             '```',
         ]);
-        statements.push(prefetchExport);
+        statements.push(p1Decl);
+        // Implementation
+        const pImplParamType = hasRelationships && useCentralizedKeys
+            ? t.tsIntersectionType([
+                t.tsTypeLiteral([
+                    t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.listSelectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName), filterTypeName, orderByTypeName))),
+                ]),
+                (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName),
+            ])
+            : t.tsTypeLiteral([
+                t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.listSelectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName), filterTypeName, orderByTypeName))),
+            ]);
+        const pBody = [];
+        pBody.push((0, hooks_ast_1.buildListSelectionArgsCall)(selectTypeName, filterTypeName, orderByTypeName));
+        const queryKeyExpr = hasRelationships && useCentralizedKeys
+            ? buildListQueryKey(t.identifier('args'), t.optionalMemberExpression(t.identifier('params'), t.identifier('scope'), false, true))
+            : buildListQueryKey(t.identifier('args'));
+        const prefetchCall = (0, hooks_ast_1.callExpr)(t.memberExpression(t.identifier('queryClient'), t.identifier('prefetchQuery')), [
+            t.objectExpression([
+                (0, hooks_ast_1.objectProp)('queryKey', queryKeyExpr),
+                (0, hooks_ast_1.objectProp)('queryFn', buildFindManyFn()),
+            ]),
+        ]);
+        pBody.push(t.expressionStatement(t.awaitExpression(prefetchCall)));
+        statements.push((0, hooks_ast_1.exportAsyncFunction)(prefetchFnName, null, [
+            (0, hooks_ast_1.createFunctionParam)('queryClient', (0, hooks_ast_1.typeRef)('QueryClient')),
+            (0, hooks_ast_1.createFunctionParam)('params', pImplParamType),
+        ], pBody, (0, hooks_ast_1.typeRef)('Promise', [t.tsVoidKeyword()])));
     }
-    const code = (0, babel_ast_1.generateCode)(statements);
     const headerText = reactQueryEnabled
         ? `List query hook for ${typeName}`
         : `List query functions for ${typeName}`;
-    const content = (0, utils_1.getGeneratedFileHeader)(headerText) + '\n\n' + code;
     return {
         fileName: (0, utils_1.getListQueryFileName)(table),
-        content,
+        content: (0, hooks_ast_1.generateHookFileCode)(headerText, statements),
     };
 }
 function generateSingleQueryHook(table, options = {}) {
-    // Skip tables with composite keys - they are handled as custom queries
-    if (!(0, utils_1.hasValidPrimaryKey)(table)) {
+    if (!(0, utils_1.hasValidPrimaryKey)(table))
         return null;
-    }
     const { reactQueryEnabled = true, useCentralizedKeys = true, hasRelationships = false, } = options;
     const { typeName, singularName } = (0, utils_1.getTableNames)(table);
     const hookName = (0, utils_1.getSingleQueryHookName)(table);
     const queryName = (0, utils_1.getSingleRowQueryName)(table);
     const keysName = `${(0, utils_1.lcFirst)(typeName)}Keys`;
     const scopeTypeName = `${typeName}Scope`;
+    const selectTypeName = `${typeName}Select`;
+    const relationTypeName = `${typeName}WithRelations`;
     const pkFields = (0, utils_1.getPrimaryKeyInfo)(table);
     const pkField = pkFields[0];
-    const pkName = pkField.name;
-    const pkTsType = pkField.tsType;
-    const queryAST = (0, gql_ast_1.buildSingleQueryAST)({ table });
-    const queryDocument = (0, gql_ast_1.printGraphQL)(queryAST);
+    const pkFieldName = pkField?.name ?? 'id';
+    const pkFieldTsType = pkField?.tsType ?? 'string';
+    const pkTsType = pkFieldTsType === 'string' ? t.tsStringKeyword() : t.tsNumberKeyword();
+    const singleResultTypeAST = (sel) => (0, hooks_ast_1.singleQueryResultType)(queryName, relationTypeName, sel);
     const statements = [];
+    // Imports
     if (reactQueryEnabled) {
-        const reactQueryImport = t.importDeclaration([t.importSpecifier(t.identifier('useQuery'), t.identifier('useQuery'))], t.stringLiteral('@tanstack/react-query'));
-        statements.push(reactQueryImport);
-        const reactQueryTypeImport = t.importDeclaration([
-            t.importSpecifier(t.identifier('UseQueryOptions'), t.identifier('UseQueryOptions')),
-            t.importSpecifier(t.identifier('QueryClient'), t.identifier('QueryClient')),
-        ], t.stringLiteral('@tanstack/react-query'));
-        reactQueryTypeImport.importKind = 'type';
-        statements.push(reactQueryTypeImport);
+        statements.push((0, hooks_ast_1.createImportDeclaration)('@tanstack/react-query', ['useQuery']));
+        statements.push((0, hooks_ast_1.createImportDeclaration)('@tanstack/react-query', ['UseQueryOptions', 'UseQueryResult', 'QueryClient'], true));
     }
-    const clientImport = t.importDeclaration([t.importSpecifier(t.identifier('execute'), t.identifier('execute'))], t.stringLiteral('../client'));
-    statements.push(clientImport);
-    const clientTypeImport = t.importDeclaration([
-        t.importSpecifier(t.identifier('ExecuteOptions'), t.identifier('ExecuteOptions')),
-    ], t.stringLiteral('../client'));
-    clientTypeImport.importKind = 'type';
-    statements.push(clientTypeImport);
-    const typesImport = t.importDeclaration([t.importSpecifier(t.identifier(typeName), t.identifier(typeName))], t.stringLiteral('../types'));
-    typesImport.importKind = 'type';
-    statements.push(typesImport);
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../client', ['getClient']));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../selection', ['buildSelectionArgs']));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../selection', ['SelectionConfig'], true));
     if (useCentralizedKeys) {
-        const queryKeyImport = t.importDeclaration([t.importSpecifier(t.identifier(keysName), t.identifier(keysName))], t.stringLiteral('../query-keys'));
-        statements.push(queryKeyImport);
+        statements.push((0, hooks_ast_1.createImportDeclaration)('../query-keys', [keysName]));
         if (hasRelationships) {
-            const scopeTypeImport = t.importDeclaration([
-                t.importSpecifier(t.identifier(scopeTypeName), t.identifier(scopeTypeName)),
-            ], t.stringLiteral('../query-keys'));
-            scopeTypeImport.importKind = 'type';
-            statements.push(scopeTypeImport);
+            statements.push((0, hooks_ast_1.createImportDeclaration)('../query-keys', [scopeTypeName], true));
         }
     }
-    const reExportDecl = t.exportNamedDeclaration(null, [t.exportSpecifier(t.identifier(typeName), t.identifier(typeName))], t.stringLiteral('../types'));
-    reExportDecl.exportKind = 'type';
-    statements.push(reExportDecl);
-    const queryDocConst = t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier(`${queryName}QueryDocument`), t.templateLiteral([
-            t.templateElement({ raw: '\n' + queryDocument, cooked: '\n' + queryDocument }, true),
-        ], [])),
-    ]);
-    statements.push(t.exportNamedDeclaration(queryDocConst));
-    const pkTypeAnnotation = pkTsType === 'string'
-        ? t.tsStringKeyword()
-        : pkTsType === 'number'
-            ? t.tsNumberKeyword()
-            : t.tsTypeReference(t.identifier(pkTsType));
-    const variablesInterfaceBody = t.tsInterfaceBody([
-        t.tsPropertySignature(t.identifier(pkName), t.tsTypeAnnotation(pkTypeAnnotation)),
-    ]);
-    const variablesInterface = t.tsInterfaceDeclaration(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`), null, null, variablesInterfaceBody);
-    statements.push(t.exportNamedDeclaration(variablesInterface));
-    const resultInterfaceBody = t.tsInterfaceBody([
-        t.tsPropertySignature(t.identifier(queryName), t.tsTypeAnnotation(t.tsUnionType([
-            t.tsTypeReference(t.identifier(typeName)),
-            t.tsNullKeyword(),
-        ]))),
-    ]);
-    const resultInterface = t.tsInterfaceDeclaration(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryResult`), null, null, resultInterfaceBody);
-    statements.push(t.exportNamedDeclaration(resultInterface));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../../orm/input-types', [selectTypeName, relationTypeName], true));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../../orm/select-types', ['InferSelectResult', 'StrictSelect'], true));
+    // Re-exports
+    statements.push((0, hooks_ast_1.createTypeReExport)([selectTypeName, relationTypeName], '../../orm/input-types'));
+    // Query key
     if (useCentralizedKeys) {
-        const queryKeyConst = t.variableDeclaration('const', [
+        const keyDecl = t.exportNamedDeclaration(t.variableDeclaration('const', [
             t.variableDeclarator(t.identifier(`${queryName}QueryKey`), t.memberExpression(t.identifier(keysName), t.identifier('detail'))),
-        ]);
-        const queryKeyExport = t.exportNamedDeclaration(queryKeyConst);
-        (0, babel_ast_1.addJSDocComment)(queryKeyExport, [
+        ]));
+        (0, hooks_ast_1.addJSDocComment)(keyDecl, [
             'Query key factory - re-exported from query-keys.ts',
         ]);
-        statements.push(queryKeyExport);
+        statements.push(keyDecl);
     }
     else {
-        const queryKeyArrow = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)(pkName, pkTypeAnnotation)], t.tsAsExpression(t.arrayExpression([
+        const keyFn = t.arrowFunctionExpression([(0, hooks_ast_1.createFunctionParam)('id', pkTsType)], (0, babel_ast_1.asConst)(t.arrayExpression([
             t.stringLiteral(typeName.toLowerCase()),
             t.stringLiteral('detail'),
-            t.identifier(pkName),
-        ]), t.tsTypeReference(t.identifier('const'))));
-        const queryKeyConst = t.variableDeclaration('const', [
-            t.variableDeclarator(t.identifier(`${queryName}QueryKey`), queryKeyArrow),
-        ]);
-        statements.push(t.exportNamedDeclaration(queryKeyConst));
+            t.identifier('id'),
+        ])));
+        statements.push(t.exportNamedDeclaration(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier(`${queryName}QueryKey`), keyFn),
+        ])));
     }
-    if (reactQueryEnabled) {
-        const hookBodyStatements = [];
-        if (hasRelationships && useCentralizedKeys) {
-            hookBodyStatements.push(t.variableDeclaration('const', [
-                t.variableDeclarator(t.objectPattern([
-                    t.objectProperty(t.identifier('scope'), t.identifier('scope'), false, true),
-                    t.restElement(t.identifier('queryOptions')),
-                ]), t.logicalExpression('??', t.identifier('options'), t.objectExpression([]))),
-            ]));
-            hookBodyStatements.push(t.returnStatement(t.callExpression(t.identifier('useQuery'), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [
-                        t.memberExpression(t.identifier('variables'), t.identifier(pkName)),
-                        t.identifier('scope'),
-                    ])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`)),
-                    ]))),
-                    t.spreadElement(t.identifier('queryOptions')),
-                ]),
-            ])));
+    // Helper for query key call
+    const buildDetailQueryKey = (pkExpr, scopeExpr) => {
+        if (useCentralizedKeys) {
+            const args = [pkExpr];
+            if (scopeExpr)
+                args.push(scopeExpr);
+            return (0, hooks_ast_1.callExpr)(t.memberExpression(t.identifier(keysName), t.identifier('detail')), args);
         }
-        else if (useCentralizedKeys) {
-            hookBodyStatements.push(t.returnStatement(t.callExpression(t.identifier('useQuery'), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [
-                        t.memberExpression(t.identifier('variables'), t.identifier(pkName)),
-                    ])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`)),
-                    ]))),
-                    t.spreadElement(t.identifier('options')),
-                ]),
-            ])));
-        }
-        else {
-            hookBodyStatements.push(t.returnStatement(t.callExpression(t.identifier('useQuery'), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), t.callExpression(t.identifier(`${queryName}QueryKey`), [
-                        t.memberExpression(t.identifier('variables'), t.identifier(pkName)),
-                    ])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`)),
-                    ]))),
-                    t.spreadElement(t.identifier('options')),
-                ]),
-            ])));
-        }
-        const hookParams = [
-            (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`))),
-        ];
-        let optionsTypeStr;
+        return (0, hooks_ast_1.callExpr)(t.identifier(`${queryName}QueryKey`), [pkExpr]);
+    };
+    // Helper for findOne queryFn
+    const buildFindOneFn = () => t.arrowFunctionExpression([], (0, hooks_ast_1.buildFindOneCallExpr)(singularName, pkFieldName, 'args'));
+    // Options type builder with optional scope
+    const buildSingleOptionsType = (queryDataType, dataType) => {
+        const base = (0, hooks_ast_1.omitType)((0, hooks_ast_1.typeRef)('UseQueryOptions', [queryDataType, (0, hooks_ast_1.typeRef)('Error'), dataType]), ['queryKey', 'queryFn']);
         if (hasRelationships && useCentralizedKeys) {
-            optionsTypeStr = `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(singularName)}QueryResult, Error>, 'queryKey' | 'queryFn'> & { scope?: ${scopeTypeName} }`;
-        }
-        else {
-            optionsTypeStr = `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(singularName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`;
+            return t.tsIntersectionType([base, (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName)]);
         }
-        const optionsParam = t.identifier('options');
-        optionsParam.optional = true;
-        optionsParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier(optionsTypeStr)));
-        hookParams.push(optionsParam);
-        const hookFunc = t.functionDeclaration(t.identifier(hookName), hookParams, t.blockStatement(hookBodyStatements));
-        const hookExport = t.exportNamedDeclaration(hookFunc);
+        return base;
+    };
+    // Hook
+    if (reactQueryEnabled) {
         const docLines = [
             `Query hook for fetching a single ${typeName}`,
             '',
             '@example',
             '```tsx',
-            `const { data, isLoading } = ${hookName}({ ${pkName}: 'some-id' });`,
+            `const { data, isLoading } = ${hookName}({`,
+            `  ${pkFieldName}: 'some-id',`,
+            '  selection: { fields: { id: true, name: true } },',
+            '});',
             '```',
         ];
         if (hasRelationships && useCentralizedKeys) {
             docLines.push('');
             docLines.push('@example With scope for hierarchical cache invalidation');
             docLines.push('```tsx');
-            docLines.push(`const { data } = ${hookName}(`);
-            docLines.push(`  { ${pkName}: 'some-id' },`);
-            docLines.push("  { scope: { parentId: 'parent-id' } }");
-            docLines.push(');');
+            docLines.push(`const { data } = ${hookName}({`);
+            docLines.push(`  ${pkFieldName}: 'some-id',`);
+            docLines.push('  selection: { fields: { id: true } },');
+            docLines.push("  scope: { parentId: 'parent-id' },");
+            docLines.push('});');
             docLines.push('```');
         }
-        (0, babel_ast_1.addJSDocComment)(hookExport, docLines);
-        statements.push(hookExport);
-    }
-    const fetchFuncBody = t.blockStatement([
-        t.returnStatement((0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
-            t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryResult`)),
-            t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`)),
-        ])),
-    ]);
-    const fetchFunc = t.functionDeclaration(t.identifier(`fetch${(0, utils_1.ucFirst)(singularName)}Query`), [
-        (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`))),
-        (0, babel_ast_1.typedParam)('options', t.tsTypeReference(t.identifier('ExecuteOptions')), true),
-    ], fetchFuncBody);
-    fetchFunc.async = true;
-    fetchFunc.returnType = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Promise'), t.tsTypeParameterInstantiation([
-        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryResult`)),
-    ])));
-    const fetchExport = t.exportNamedDeclaration(fetchFunc);
-    (0, babel_ast_1.addJSDocComment)(fetchExport, [
-        `Fetch a single ${typeName} without React hooks`,
-        '',
-        '@example',
-        '```ts',
-        `const data = await fetch${(0, utils_1.ucFirst)(singularName)}Query({ ${pkName}: 'some-id' });`,
-        '```',
-    ]);
-    statements.push(fetchExport);
-    if (reactQueryEnabled) {
-        const prefetchParams = [
-            (0, babel_ast_1.typedParam)('queryClient', t.tsTypeReference(t.identifier('QueryClient'))),
-            (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`))),
+        // Overload 1: with fields
+        const o1Props = [
+            t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.withFieldsSelectionType)((0, hooks_ast_1.sRef)(), selectTypeName))),
         ];
+        const o1ParamType = t.tsIntersectionType([
+            t.tsTypeLiteral(o1Props),
+            buildSingleOptionsType(singleResultTypeAST((0, hooks_ast_1.sRef)()), (0, hooks_ast_1.typeRef)('TData')),
+        ]);
+        const o1 = (0, hooks_ast_1.exportDeclareFunction)(hookName, (0, hooks_ast_1.createSAndTDataTypeParams)(selectTypeName, singleResultTypeAST((0, hooks_ast_1.sRef)())), [(0, hooks_ast_1.createFunctionParam)('params', o1ParamType)], (0, hooks_ast_1.typeRef)('UseQueryResult', [(0, hooks_ast_1.typeRef)('TData')]));
+        (0, hooks_ast_1.addJSDocComment)(o1, docLines);
+        statements.push(o1);
+        // Implementation
+        const implProps = [
+            t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.selectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName)))),
+        ];
+        const implOptionsType = (() => {
+            const base = (0, hooks_ast_1.useQueryOptionsImplType)();
+            if (hasRelationships && useCentralizedKeys) {
+                return t.tsIntersectionType([base, (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName)]);
+            }
+            return base;
+        })();
+        const implParamType = t.tsIntersectionType([
+            t.tsTypeLiteral(implProps),
+            implOptionsType,
+        ]);
+        const body = [];
+        body.push((0, hooks_ast_1.buildSelectionArgsCall)(selectTypeName));
+        const pkMemberExpr = t.memberExpression(t.identifier('params'), t.identifier(pkFieldName));
         if (hasRelationships && useCentralizedKeys) {
-            prefetchParams.push((0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true));
-        }
-        prefetchParams.push((0, babel_ast_1.typedParam)('options', t.tsTypeReference(t.identifier('ExecuteOptions')), true));
-        let prefetchQueryKeyExpr;
-        if (hasRelationships && useCentralizedKeys) {
-            prefetchQueryKeyExpr = t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [
-                t.memberExpression(t.identifier('variables'), t.identifier(pkName)),
-                t.identifier('scope'),
-            ]);
-        }
-        else if (useCentralizedKeys) {
-            prefetchQueryKeyExpr = t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.memberExpression(t.identifier('variables'), t.identifier(pkName))]);
+            body.push((0, hooks_ast_1.destructureParamsWithSelectionAndScope)('queryOptions'));
+            body.push((0, hooks_ast_1.voidStatement)('_selection'));
+            body.push((0, hooks_ast_1.returnUseQuery)(buildDetailQueryKey(pkMemberExpr, t.identifier('scope')), buildFindOneFn(), [(0, hooks_ast_1.spreadObj)(t.identifier('queryOptions'))]));
         }
         else {
-            prefetchQueryKeyExpr = t.callExpression(t.identifier(`${queryName}QueryKey`), [t.memberExpression(t.identifier('variables'), t.identifier(pkName))]);
+            body.push((0, hooks_ast_1.destructureParamsWithSelection)('queryOptions'));
+            body.push((0, hooks_ast_1.voidStatement)('_selection'));
+            body.push((0, hooks_ast_1.returnUseQuery)(buildDetailQueryKey(pkMemberExpr), buildFindOneFn(), [
+                (0, hooks_ast_1.spreadObj)(t.identifier('queryOptions')),
+            ]));
         }
-        const prefetchFuncBody = t.blockStatement([
-            t.expressionStatement(t.awaitExpression(t.callExpression(t.memberExpression(t.identifier('queryClient'), t.identifier('prefetchQuery')), [
-                t.objectExpression([
-                    t.objectProperty(t.identifier('queryKey'), prefetchQueryKeyExpr),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], (0, babel_ast_1.createTypedCallExpression)(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryResult`)),
-                        t.tsTypeReference(t.identifier(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`)),
-                    ]))),
-                ]),
-            ]))),
+        statements.push((0, hooks_ast_1.exportFunction)(hookName, null, [(0, hooks_ast_1.createFunctionParam)('params', implParamType)], body));
+    }
+    // Fetch function
+    const fetchFnName = `fetch${(0, utils_1.ucFirst)(singularName)}Query`;
+    {
+        // Overload 1: with fields
+        const f1Props = [
+            t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.withFieldsSelectionType)((0, hooks_ast_1.sRef)(), selectTypeName))),
+        ];
+        const f1Decl = (0, hooks_ast_1.exportAsyncDeclareFunction)(fetchFnName, (0, hooks_ast_1.createSTypeParam)(selectTypeName), [(0, hooks_ast_1.createFunctionParam)('params', t.tsTypeLiteral(f1Props))], (0, hooks_ast_1.typeRef)('Promise', [singleResultTypeAST((0, hooks_ast_1.sRef)())]));
+        (0, hooks_ast_1.addJSDocComment)(f1Decl, [
+            `Fetch a single ${typeName} without React hooks`,
+            '',
+            '@example',
+            '```ts',
+            `const data = await ${fetchFnName}({`,
+            `  ${pkFieldName}: 'some-id',`,
+            '  selection: { fields: { id: true } },',
+            '});',
+            '```',
         ]);
-        const prefetchFunc = t.functionDeclaration(t.identifier(`prefetch${(0, utils_1.ucFirst)(singularName)}Query`), prefetchParams, prefetchFuncBody);
-        prefetchFunc.async = true;
-        prefetchFunc.returnType = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Promise'), t.tsTypeParameterInstantiation([t.tsVoidKeyword()])));
-        const prefetchExport = t.exportNamedDeclaration(prefetchFunc);
-        (0, babel_ast_1.addJSDocComment)(prefetchExport, [
+        statements.push(f1Decl);
+        // Implementation
+        const fBody = [];
+        fBody.push((0, hooks_ast_1.buildSelectionArgsCall)(selectTypeName));
+        fBody.push(t.returnStatement((0, hooks_ast_1.buildFindOneCallExpr)(singularName, pkFieldName, 'args')));
+        const fImplProps = [
+            t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.selectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName)))),
+        ];
+        statements.push((0, hooks_ast_1.exportAsyncFunction)(fetchFnName, null, [(0, hooks_ast_1.createFunctionParam)('params', t.tsTypeLiteral(fImplProps))], fBody));
+    }
+    // Prefetch function
+    if (reactQueryEnabled) {
+        const prefetchFnName = `prefetch${(0, utils_1.ucFirst)(singularName)}Query`;
+        // Overload 1: with fields
+        const p1Props = [
+            t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.withFieldsSelectionType)((0, hooks_ast_1.sRef)(), selectTypeName))),
+        ];
+        const p1ParamType = hasRelationships && useCentralizedKeys
+            ? t.tsIntersectionType([
+                t.tsTypeLiteral(p1Props),
+                (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName),
+            ])
+            : t.tsTypeLiteral(p1Props);
+        const p1Decl = (0, hooks_ast_1.exportAsyncDeclareFunction)(prefetchFnName, (0, hooks_ast_1.createSTypeParam)(selectTypeName), [
+            (0, hooks_ast_1.createFunctionParam)('queryClient', (0, hooks_ast_1.typeRef)('QueryClient')),
+            (0, hooks_ast_1.createFunctionParam)('params', p1ParamType),
+        ], (0, hooks_ast_1.typeRef)('Promise', [t.tsVoidKeyword()]));
+        (0, hooks_ast_1.addJSDocComment)(p1Decl, [
             `Prefetch a single ${typeName} for SSR or cache warming`,
             '',
             '@example',
             '```ts',
-            `await prefetch${(0, utils_1.ucFirst)(singularName)}Query(queryClient, { ${pkName}: 'some-id' });`,
+            `await ${prefetchFnName}(queryClient, { ${pkFieldName}: 'some-id', selection: { fields: { id: true } } });`,
             '```',
         ]);
-        statements.push(prefetchExport);
+        statements.push(p1Decl);
+        // Implementation
+        const pImplParamType = hasRelationships && useCentralizedKeys
+            ? t.tsIntersectionType([
+                t.tsTypeLiteral([
+                    t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
+                    t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.selectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName)))),
+                ]),
+                (0, hooks_ast_1.scopeTypeLiteral)(scopeTypeName),
+            ])
+            : t.tsTypeLiteral([
+                t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
+                t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation((0, hooks_ast_1.selectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName)))),
+            ]);
+        const pBody = [];
+        pBody.push((0, hooks_ast_1.buildSelectionArgsCall)(selectTypeName));
+        const queryKeyExpr = hasRelationships && useCentralizedKeys
+            ? buildDetailQueryKey(t.memberExpression(t.identifier('params'), t.identifier(pkFieldName)), t.optionalMemberExpression(t.identifier('params'), t.identifier('scope'), false, true))
+            : buildDetailQueryKey(t.memberExpression(t.identifier('params'), t.identifier(pkFieldName)));
+        const prefetchCall = (0, hooks_ast_1.callExpr)(t.memberExpression(t.identifier('queryClient'), t.identifier('prefetchQuery')), [
+            t.objectExpression([
+                (0, hooks_ast_1.objectProp)('queryKey', queryKeyExpr),
+                (0, hooks_ast_1.objectProp)('queryFn', buildFindOneFn()),
+            ]),
+        ]);
+        pBody.push(t.expressionStatement(t.awaitExpression(prefetchCall)));
+        statements.push((0, hooks_ast_1.exportAsyncFunction)(prefetchFnName, null, [
+            (0, hooks_ast_1.createFunctionParam)('queryClient', (0, hooks_ast_1.typeRef)('QueryClient')),
+            (0, hooks_ast_1.createFunctionParam)('params', pImplParamType),
+        ], pBody, (0, hooks_ast_1.typeRef)('Promise', [t.tsVoidKeyword()])));
     }
-    const code = (0, babel_ast_1.generateCode)(statements);
     const headerText = reactQueryEnabled
         ? `Single item query hook for ${typeName}`
         : `Single item query functions for ${typeName}`;
-    const content = (0, utils_1.getGeneratedFileHeader)(headerText) + '\n\n' + code;
     return {
         fileName: (0, utils_1.getSingleQueryFileName)(table),
-        content,
+        content: (0, hooks_ast_1.generateHookFileCode)(headerText, statements),
     };
 }
 function generateAllQueryHooks(tables, options = {}) {