@constructive-io/graphql-codegen 2.24.0 → 2.24.1

package/esm/cli/codegen/mutations.js

@@ -1,5 +1,5 @@
 import * as t from '@babel/types';
-import { generateCode, addJSDocComment, typedParam } from './babel-ast';
+import { generateCode, addJSDocComment, typedParam, createTypedCallExpression } from './babel-ast';
 import { buildCreateMutationAST, buildUpdateMutationAST, buildDeleteMutationAST, printGraphQL, } from './gql-ast';
 import { getTableNames, getCreateMutationHookName, getUpdateMutationHookName, getDeleteMutationHookName, getCreateMutationFileName, getUpdateMutationFileName, getDeleteMutationFileName, getCreateMutationName, getUpdateMutationName, getDeleteMutationName, getScalarFields, getPrimaryKeyInfo, fieldTypeToTs, ucFirst, lcFirst, getGeneratedFileHeader, } from './utils';
 function isAutoGeneratedField(fieldName, pkFieldNames) {
@@ -14,7 +14,7 @@ function isAutoGeneratedField(fieldName, pkFieldNames) {
     return timestampPatterns.includes(name);
 }
 export function generateCreateMutationHook(table, options = {}) {
-    const { reactQueryEnabled = true, enumsFromSchemaTypes = [], useCentralizedKeys = true, hasRelationships = false, } = options;
+    const { reactQueryEnabled = true, enumsFromSchemaTypes = [], useCentralizedKeys = true, hasRelationships = false, tableTypeNames = new Set(), } = options;
     if (!reactQueryEnabled) {
         return null;
     }
@@ -28,11 +28,16 @@ export function generateCreateMutationHook(table, options = {}) {
     const scalarFields = getScalarFields(table);
     const pkFieldNames = new Set(getPrimaryKeyInfo(table).map((pk) => pk.name));
     const usedEnums = new Set();
+    const usedTableTypes = new Set();
     for (const field of scalarFields) {
         const cleanType = field.type.gqlType.replace(/!/g, '');
         if (enumSet.has(cleanType)) {
             usedEnums.add(cleanType);
         }
+        else if (tableTypeNames.has(cleanType) && cleanType !== typeName) {
+            // Track table types used in scalar fields (excluding the main type which is already imported)
+            usedTableTypes.add(cleanType);
+        }
     }
     const mutationAST = buildCreateMutationAST({ table });
     const mutationDocument = printGraphQL(mutationAST);
@@ -47,7 +52,9 @@ export function generateCreateMutationHook(table, options = {}) {
     statements.push(reactQueryTypeImport);
     const clientImport = t.importDeclaration([t.importSpecifier(t.identifier('execute'), t.identifier('execute'))], t.stringLiteral('../client'));
     statements.push(clientImport);
-    const typesImport = t.importDeclaration([t.importSpecifier(t.identifier(typeName), t.identifier(typeName))], t.stringLiteral('../types'));
+    // Import the main type and any other table types used in scalar fields
+    const allTypesToImport = [typeName, ...Array.from(usedTableTypes)].sort();
+    const typesImport = t.importDeclaration(allTypesToImport.map((t_) => t.importSpecifier(t.identifier(t_), t.identifier(t_))), t.stringLiteral('../types'));
     typesImport.importKind = 'type';
     statements.push(typesImport);
     if (usedEnums.size > 0) {
@@ -108,9 +115,9 @@ export function generateCreateMutationHook(table, options = {}) {
     if (useCentralizedKeys) {
         mutationOptions.push(t.objectProperty(t.identifier('mutationKey'), t.callExpression(t.memberExpression(t.identifier(mutationKeysName), t.identifier('create')), [])));
     }
-    mutationOptions.push(t.objectProperty(t.identifier('mutationFn'), t.arrowFunctionExpression([typedParam('variables', t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)))], t.callExpression(t.identifier('execute'), [
-        t.identifier(`${mutationName}MutationDocument`),
-        t.identifier('variables'),
+    mutationOptions.push(t.objectProperty(t.identifier('mutationFn'), t.arrowFunctionExpression([typedParam('variables', t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)))], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${mutationName}MutationDocument`), t.identifier('variables')], [
+        t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationResult`)),
+        t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)),
     ]))));
     const invalidateQueryKey = useCentralizedKeys
         ? t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('lists')), [])
@@ -151,7 +158,7 @@ export function generateCreateMutationHook(table, options = {}) {
     };
 }
 export function generateUpdateMutationHook(table, options = {}) {
-    const { reactQueryEnabled = true, enumsFromSchemaTypes = [], useCentralizedKeys = true, hasRelationships = false, } = options;
+    const { reactQueryEnabled = true, enumsFromSchemaTypes = [], useCentralizedKeys = true, hasRelationships = false, tableTypeNames = new Set(), } = options;
     if (!reactQueryEnabled) {
         return null;
     }
@@ -170,11 +177,15 @@ export function generateUpdateMutationHook(table, options = {}) {
     const pkField = pkFields[0];
     const pkFieldNames = new Set(pkFields.map((pk) => pk.name));
     const usedEnums = new Set();
+    const usedTableTypes = new Set();
     for (const field of scalarFields) {
         const cleanType = field.type.gqlType.replace(/!/g, '');
         if (enumSet.has(cleanType)) {
             usedEnums.add(cleanType);
         }
+        else if (tableTypeNames.has(cleanType) && cleanType !== typeName) {
+            usedTableTypes.add(cleanType);
+        }
     }
     const mutationAST = buildUpdateMutationAST({ table });
     const mutationDocument = printGraphQL(mutationAST);
@@ -189,7 +200,9 @@ export function generateUpdateMutationHook(table, options = {}) {
     statements.push(reactQueryTypeImport);
     const clientImport = t.importDeclaration([t.importSpecifier(t.identifier('execute'), t.identifier('execute'))], t.stringLiteral('../client'));
     statements.push(clientImport);
-    const typesImport = t.importDeclaration([t.importSpecifier(t.identifier(typeName), t.identifier(typeName))], t.stringLiteral('../types'));
+    // Import the main type and any other table types used in scalar fields
+    const allTypesToImportUpdate = [typeName, ...Array.from(usedTableTypes)].sort();
+    const typesImport = t.importDeclaration(allTypesToImportUpdate.map((t_) => t.importSpecifier(t.identifier(t_), t.identifier(t_))), t.stringLiteral('../types'));
     typesImport.importKind = 'type';
     statements.push(typesImport);
     if (usedEnums.size > 0) {
@@ -256,9 +269,9 @@ export function generateUpdateMutationHook(table, options = {}) {
     if (useCentralizedKeys) {
         mutationOptions.push(t.objectProperty(t.identifier('mutationKey'), t.memberExpression(t.identifier(mutationKeysName), t.identifier('all'))));
     }
-    mutationOptions.push(t.objectProperty(t.identifier('mutationFn'), t.arrowFunctionExpression([typedParam('variables', t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)))], t.callExpression(t.identifier('execute'), [
-        t.identifier(`${mutationName}MutationDocument`),
-        t.identifier('variables'),
+    mutationOptions.push(t.objectProperty(t.identifier('mutationFn'), t.arrowFunctionExpression([typedParam('variables', t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)))], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${mutationName}MutationDocument`), t.identifier('variables')], [
+        t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationResult`)),
+        t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)),
     ]))));
     const detailQueryKey = useCentralizedKeys
         ? t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.memberExpression(t.memberExpression(t.identifier('variables'), t.identifier('input')), t.identifier(pkField.name))])
@@ -378,9 +391,9 @@ export function generateDeleteMutationHook(table, options = {}) {
     if (useCentralizedKeys) {
         mutationOptions.push(t.objectProperty(t.identifier('mutationKey'), t.memberExpression(t.identifier(mutationKeysName), t.identifier('all'))));
     }
-    mutationOptions.push(t.objectProperty(t.identifier('mutationFn'), t.arrowFunctionExpression([typedParam('variables', t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)))], t.callExpression(t.identifier('execute'), [
-        t.identifier(`${mutationName}MutationDocument`),
-        t.identifier('variables'),
+    mutationOptions.push(t.objectProperty(t.identifier('mutationFn'), t.arrowFunctionExpression([typedParam('variables', t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)))], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${mutationName}MutationDocument`), t.identifier('variables')], [
+        t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationResult`)),
+        t.tsTypeReference(t.identifier(`${ucFirst(mutationName)}MutationVariables`)),
     ]))));
     const detailQueryKey = useCentralizedKeys
         ? t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('detail')), [t.memberExpression(t.memberExpression(t.identifier('variables'), t.identifier('input')), t.identifier(pkField.name))])

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

@@ -193,6 +193,22 @@ const SCALAR_FILTER_CONFIGS = [
         operators: ['equality', 'distinct', 'inArray', 'comparison', 'inet'],
     },
     { name: 'FullTextFilter', tsType: 'string', operators: ['fulltext'] },
+    // List filters (for array fields like string[], int[], uuid[])
+    {
+        name: 'StringListFilter',
+        tsType: 'string[]',
+        operators: ['equality', 'distinct', 'comparison', 'listArray'],
+    },
+    {
+        name: 'IntListFilter',
+        tsType: 'number[]',
+        operators: ['equality', 'distinct', 'comparison', 'listArray'],
+    },
+    {
+        name: 'UUIDListFilter',
+        tsType: 'string[]',
+        operators: ['equality', 'distinct', 'comparison', 'listArray'],
+    },
 ];
 /**
  * Build filter properties based on operator sets
@@ -232,6 +248,12 @@ function buildScalarFilterProperties(config) {
     if (operators.includes('fulltext')) {
         props.push({ name: 'matches', type: 'string', optional: true });
     }
+    // List/Array operators (contains, overlaps, anyEqualTo, etc.)
+    if (operators.includes('listArray')) {
+        // Extract base type from array type (e.g., 'string[]' -> 'string')
+        const baseType = tsType.replace('[]', '');
+        props.push({ name: 'contains', type: tsType, optional: true }, { name: 'containedBy', type: tsType, optional: true }, { name: 'overlaps', type: tsType, optional: true }, { name: 'anyEqualTo', type: baseType, optional: true }, { name: 'anyNotEqualTo', type: baseType, optional: true }, { name: 'anyLessThan', type: baseType, optional: true }, { name: 'anyLessThanOrEqualTo', type: baseType, optional: true }, { name: 'anyGreaterThan', type: baseType, optional: true }, { name: 'anyGreaterThanOrEqualTo', type: baseType, optional: true });
+    }
     return props;
 }
 /**

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

@@ -17,5 +17,5 @@ export interface QueryGeneratorOptions {
     hasRelationships?: boolean;
 }
 export declare function generateListQueryHook(table: CleanTable, options?: QueryGeneratorOptions): GeneratedQueryFile;
-export declare function generateSingleQueryHook(table: CleanTable, options?: QueryGeneratorOptions): GeneratedQueryFile;
+export declare function generateSingleQueryHook(table: CleanTable, options?: QueryGeneratorOptions): GeneratedQueryFile | null;
 export declare function generateAllQueryHooks(tables: CleanTable[], options?: QueryGeneratorOptions): GeneratedQueryFile[];

package/esm/cli/codegen/queries.js

@@ -1,7 +1,7 @@
 import * as t from '@babel/types';
-import { generateCode, addJSDocComment, typedParam } from './babel-ast';
+import { generateCode, addJSDocComment, typedParam, createTypedCallExpression } from './babel-ast';
 import { buildListQueryAST, buildSingleQueryAST, printGraphQL, } from './gql-ast';
-import { getTableNames, getListQueryHookName, getSingleQueryHookName, getListQueryFileName, getSingleQueryFileName, getAllRowsQueryName, getSingleRowQueryName, getFilterTypeName, getOrderByTypeName, getScalarFields, getScalarFilterType, getPrimaryKeyInfo, toScreamingSnake, ucFirst, lcFirst, getGeneratedFileHeader, } from './utils';
+import { getTableNames, getListQueryHookName, getSingleQueryHookName, getListQueryFileName, getSingleQueryFileName, getAllRowsQueryName, getSingleRowQueryName, getFilterTypeName, getConditionTypeName, getOrderByTypeName, getScalarFields, getScalarFilterType, getPrimaryKeyInfo, hasValidPrimaryKey, fieldTypeToTs, toScreamingSnake, ucFirst, lcFirst, getGeneratedFileHeader, } from './utils';
 function createUnionType(values) {
     return t.tsUnionType(values.map((v) => t.tsLiteralType(t.stringLiteral(v))));
 }
@@ -34,6 +34,7 @@ export function generateListQueryHook(table, options = {}) {
     const hookName = getListQueryHookName(table);
     const queryName = getAllRowsQueryName(table);
     const filterTypeName = getFilterTypeName(table);
+    const conditionTypeName = getConditionTypeName(table);
     const orderByTypeName = getOrderByTypeName(table);
     const scalarFields = getScalarFields(table);
     const keysName = `${lcFirst(typeName)}Keys`;
@@ -98,6 +99,59 @@ export function generateListQueryHook(table, options = {}) {
     })
         .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 = 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) => [
             `${toScreamingSnake(f.name)}_ASC`,
@@ -115,16 +169,36 @@ export function generateListQueryHook(table, options = {}) {
             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;
@@ -184,9 +258,9 @@ export function generateListQueryHook(table, options = {}) {
             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([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryVariables`)),
                     ]))),
                     t.spreadElement(t.identifier('queryOptions')),
                 ]),
@@ -196,9 +270,9 @@ export function generateListQueryHook(table, options = {}) {
             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([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryVariables`)),
                     ]))),
                     t.spreadElement(t.identifier('options')),
                 ]),
@@ -210,9 +284,9 @@ export function generateListQueryHook(table, options = {}) {
                     t.objectProperty(t.identifier('queryKey'), t.callExpression(t.identifier(`${queryName}QueryKey`), [
                         t.identifier('variables'),
                     ])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryVariables`)),
                     ]))),
                     t.spreadElement(t.identifier('options')),
                 ]),
@@ -260,10 +334,9 @@ export function generateListQueryHook(table, options = {}) {
         statements.push(hookExport);
     }
     const fetchFuncBody = t.blockStatement([
-        t.returnStatement(t.callExpression(t.identifier('execute'), [
-            t.identifier(`${queryName}QueryDocument`),
-            t.identifier('variables'),
-            t.identifier('options'),
+        t.returnStatement(createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
+            t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryResult`)),
+            t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryVariables`)),
         ])),
     ]);
     const fetchFunc = t.functionDeclaration(t.identifier(`fetch${ucFirst(pluralName)}Query`), [
@@ -314,10 +387,9 @@ export function generateListQueryHook(table, options = {}) {
             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([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
-                        t.identifier('options'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(pluralName)}QueryVariables`)),
                     ]))),
                 ]),
             ]))),
@@ -347,6 +419,10 @@ export function generateListQueryHook(table, options = {}) {
     };
 }
 export function generateSingleQueryHook(table, options = {}) {
+    // Skip tables with composite keys - they are handled as custom queries
+    if (!hasValidPrimaryKey(table)) {
+        return null;
+    }
     const { reactQueryEnabled = true, useCentralizedKeys = true, hasRelationships = false, } = options;
     const { typeName, singularName } = getTableNames(table);
     const hookName = getSingleQueryHookName(table);
@@ -454,9 +530,9 @@ export function generateSingleQueryHook(table, options = {}) {
                         t.memberExpression(t.identifier('variables'), t.identifier(pkName)),
                         t.identifier('scope'),
                     ])),
-                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryVariables`)),
                     ]))),
                     t.spreadElement(t.identifier('queryOptions')),
                 ]),
@@ -468,9 +544,9 @@ export function generateSingleQueryHook(table, options = {}) {
                     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([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryVariables`)),
                     ]))),
                     t.spreadElement(t.identifier('options')),
                 ]),
@@ -482,9 +558,9 @@ export function generateSingleQueryHook(table, options = {}) {
                     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([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryVariables`)),
                     ]))),
                     t.spreadElement(t.identifier('options')),
                 ]),
@@ -528,10 +604,9 @@ export function generateSingleQueryHook(table, options = {}) {
         statements.push(hookExport);
     }
     const fetchFuncBody = t.blockStatement([
-        t.returnStatement(t.callExpression(t.identifier('execute'), [
-            t.identifier(`${queryName}QueryDocument`),
-            t.identifier('variables'),
-            t.identifier('options'),
+        t.returnStatement(createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
+            t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryResult`)),
+            t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryVariables`)),
         ])),
     ]);
     const fetchFunc = t.functionDeclaration(t.identifier(`fetch${ucFirst(singularName)}Query`), [
@@ -578,10 +653,9 @@ export function generateSingleQueryHook(table, options = {}) {
             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([], t.callExpression(t.identifier('execute'), [
-                        t.identifier(`${queryName}QueryDocument`),
-                        t.identifier('variables'),
-                        t.identifier('options'),
+                    t.objectProperty(t.identifier('queryFn'), t.arrowFunctionExpression([], createTypedCallExpression(t.identifier('execute'), [t.identifier(`${queryName}QueryDocument`), t.identifier('variables'), t.identifier('options')], [
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryResult`)),
+                        t.tsTypeReference(t.identifier(`${ucFirst(singularName)}QueryVariables`)),
                     ]))),
                 ]),
             ]))),
@@ -614,7 +688,10 @@ export function generateAllQueryHooks(tables, options = {}) {
     const files = [];
     for (const table of tables) {
         files.push(generateListQueryHook(table, options));
-        files.push(generateSingleQueryHook(table, options));
+        const singleHook = generateSingleQueryHook(table, options);
+        if (singleHook) {
+            files.push(singleHook);
+        }
     }
     return files;
 }

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

@@ -171,6 +171,12 @@ export declare function getPrimaryKeyInfo(table: CleanTable): PrimaryKeyField[];
  * Get primary key field names (convenience wrapper)
  */
 export declare function getPrimaryKeyFields(table: CleanTable): string[];
+/**
+ * Check if table has a valid single-field primary key
+ * Used to determine if a single query hook can be generated
+ * Tables with composite keys return false (handled as custom queries)
+ */
+export declare function hasValidPrimaryKey(table: CleanTable): boolean;
 /**
  * Generate query key prefix for a table
  * e.g., "cars" for list queries, "car" for detail queries

package/esm/cli/codegen/utils.js

@@ -291,6 +291,24 @@ export function getPrimaryKeyInfo(table) {
 export function getPrimaryKeyFields(table) {
     return getPrimaryKeyInfo(table).map((pk) => pk.name);
 }
+/**
+ * Check if table has a valid single-field primary key
+ * Used to determine if a single query hook can be generated
+ * Tables with composite keys return false (handled as custom queries)
+ */
+export function hasValidPrimaryKey(table) {
+    // Check for explicit primary key constraint with single field
+    const pk = table.constraints?.primaryKey?.[0];
+    if (pk && pk.fields.length === 1) {
+        return true;
+    }
+    // Check for 'id' field as fallback
+    const idField = table.fields.find((f) => f.name.toLowerCase() === 'id');
+    if (idField) {
+        return true;
+    }
+    return false;
+}
 // ============================================================================
 // Query key generation
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.24.0",
+  "version": "2.24.1",
   "description": "CLI-based GraphQL SDK generator for PostGraphile endpoints with React Query hooks",
   "keywords": [
     "graphql",
@@ -83,5 +83,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "36d48ae1cde080add7953f46a6738a31909cf050"
+  "gitHead": "3e08dd946ec5eab57c296e8df180f1dcb1d06514"
 }