@constructive-io/graphql-codegen 4.40.6 → 4.41.1

package/esm/core/codegen/mutations.js

@@ -9,7 +9,7 @@
  */
 import * as t from '@babel/types';
 import { addJSDocComment, buildSelectionArgsCall, callExpr, constDecl, createFunctionParam, createImportDeclaration, createSTypeParam, createTypeReExport, destructureParamsWithSelection, exportDeclareFunction, exportFunction, generateHookFileCode, getClientCallUnwrap, inferSelectResultType, objectProp, omitType, returnUseMutation, selectionConfigType, shorthandProp, spreadObj, sRef, typeRef, typeLiteralWithProps, useMutationOptionsType, useMutationResultType, voidStatement, } from './hooks-ast';
-import { getCreateMutationFileName, getCreateMutationHookName, getCreateMutationName, getDeleteMutationFileName, getDeleteMutationHookName, getDeleteMutationName, getPrimaryKeyInfo, getTableNames, getUpdateMutationFileName, getUpdateMutationHookName, getUpdateMutationName, hasValidPrimaryKey, lcFirst, } from './utils';
+import { getBulkCreateMutationFileName, getBulkCreateMutationHookName, getBulkDeleteMutationFileName, getBulkDeleteMutationHookName, getBulkUpdateMutationFileName, getBulkUpdateMutationHookName, getBulkUpsertMutationFileName, getBulkUpsertMutationHookName, getCreateMutationFileName, getCreateMutationHookName, getCreateMutationName, getDeleteMutationFileName, getDeleteMutationHookName, getDeleteMutationName, getPrimaryKeyInfo, getTableNames, getUpdateMutationFileName, getUpdateMutationHookName, getUpdateMutationName, hasValidPrimaryKey, lcFirst, } from './utils';
 function buildMutationResultType(mutationName, singularName, relationTypeName, selectType) {
     return typeLiteralWithProps([
         {
@@ -377,6 +377,185 @@ export function generateDeleteMutationHook(table, options = {}) {
         content: generateHookFileCode(table.description || `Delete mutation hook for ${typeName}`, statements),
     };
 }
+function generateBulkMutationHook(table, op, options = {}) {
+    const { reactQueryEnabled = true, useCentralizedKeys = true } = options;
+    if (!reactQueryEnabled)
+        return null;
+    const mutationFieldName = (() => {
+        switch (op) {
+            case 'bulkCreate': return table.query?.bulkInsert;
+            case 'bulkUpsert': return table.query?.bulkUpsert;
+            case 'bulkUpdate': return table.query?.bulkUpdate;
+            case 'bulkDelete': return table.query?.bulkDelete;
+        }
+    })();
+    if (!mutationFieldName)
+        return null;
+    const { typeName, singularName } = getTableNames(table);
+    const hookName = (() => {
+        switch (op) {
+            case 'bulkCreate': return getBulkCreateMutationHookName(table);
+            case 'bulkUpsert': return getBulkUpsertMutationHookName(table);
+            case 'bulkUpdate': return getBulkUpdateMutationHookName(table);
+            case 'bulkDelete': return getBulkDeleteMutationHookName(table);
+        }
+    })();
+    const fileName = (() => {
+        switch (op) {
+            case 'bulkCreate': return getBulkCreateMutationFileName(table);
+            case 'bulkUpsert': return getBulkUpsertMutationFileName(table);
+            case 'bulkUpdate': return getBulkUpdateMutationFileName(table);
+            case 'bulkDelete': return getBulkDeleteMutationFileName(table);
+        }
+    })();
+    const keysName = `${lcFirst(typeName)}Keys`;
+    const mutationKeysName = `${lcFirst(typeName)}MutationKeys`;
+    const selectTypeName = `${typeName}Select`;
+    const relationTypeName = `${typeName}WithRelations`;
+    const createInputTypeName = `Create${typeName}Input`;
+    const patchTypeName = `${typeName}Patch`;
+    const filterTypeName = `${typeName}Filter`;
+    const statements = [];
+    // Imports
+    statements.push(createImportDeclaration('@tanstack/react-query', [
+        'useMutation',
+        'useQueryClient',
+    ]));
+    statements.push(createImportDeclaration('@tanstack/react-query', ['UseMutationOptions', 'UseMutationResult'], true));
+    statements.push(createImportDeclaration('../client', ['getClient']));
+    statements.push(createImportDeclaration('../selection', ['buildSelectionArgs']));
+    statements.push(createImportDeclaration('../selection', ['SelectionConfig'], true));
+    if (useCentralizedKeys) {
+        statements.push(createImportDeclaration('../query-keys', [keysName]));
+        statements.push(createImportDeclaration('../mutation-keys', [mutationKeysName]));
+    }
+    // Determine which types to import
+    const typeImports = [selectTypeName, relationTypeName];
+    if (op === 'bulkCreate' || op === 'bulkUpsert') {
+        typeImports.push(createInputTypeName);
+    }
+    if (op === 'bulkUpdate') {
+        typeImports.push(patchTypeName);
+        typeImports.push(filterTypeName);
+    }
+    if (op === 'bulkDelete') {
+        typeImports.push(filterTypeName);
+    }
+    statements.push(createImportDeclaration('../../orm/input-types', typeImports, true));
+    statements.push(createImportDeclaration('../../orm/select-types', ['InferSelectResult', 'BulkMutationResult', 'HookStrictSelect'], true));
+    // Re-exports
+    statements.push(createTypeReExport(typeImports, '../../orm/input-types'));
+    // Build the variable type for the mutationFn parameter
+    const varType = (() => {
+        switch (op) {
+            case 'bulkCreate':
+                return t.tsTypeLiteral([
+                    t.tsPropertySignature(t.identifier('data'), t.tsTypeAnnotation(t.tsArrayType(t.tsIndexedAccessType(typeRef(createInputTypeName), t.tsLiteralType(t.stringLiteral(singularName)))))),
+                    (() => {
+                        const p = t.tsPropertySignature(t.identifier('onConflict'), t.tsTypeAnnotation(t.tsUnknownKeyword()));
+                        p.optional = true;
+                        return p;
+                    })(),
+                ]);
+            case 'bulkUpsert':
+                return t.tsTypeLiteral([
+                    t.tsPropertySignature(t.identifier('data'), t.tsTypeAnnotation(t.tsArrayType(t.tsIndexedAccessType(typeRef(createInputTypeName), t.tsLiteralType(t.stringLiteral(singularName)))))),
+                    t.tsPropertySignature(t.identifier('onConflict'), t.tsTypeAnnotation(t.tsUnknownKeyword())),
+                ]);
+            case 'bulkUpdate':
+                return t.tsTypeLiteral([
+                    t.tsPropertySignature(t.identifier('where'), t.tsTypeAnnotation(typeRef(filterTypeName))),
+                    t.tsPropertySignature(t.identifier('data'), t.tsTypeAnnotation(typeRef(patchTypeName))),
+                ]);
+            case 'bulkDelete':
+                return t.tsTypeLiteral([
+                    t.tsPropertySignature(t.identifier('where'), t.tsTypeAnnotation(typeRef(filterTypeName))),
+                ]);
+        }
+    })();
+    // Result type: BulkMutationResult<InferSelectResult<Relation, S>>
+    const bulkResultType = (sel) => typeRef('BulkMutationResult', [inferSelectResultType(relationTypeName, sel)]);
+    // Overload with fields
+    const o1ParamType = t.tsIntersectionType([
+        t.tsTypeLiteral([
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation(buildFieldsSelectionType(sRef(), selectTypeName))),
+        ]),
+        useMutationOptionsType(bulkResultType(sRef()), varType),
+    ]);
+    const o1 = exportDeclareFunction(hookName, createSTypeParam(selectTypeName), [createFunctionParam('params', o1ParamType)], useMutationResultType(bulkResultType(sRef()), varType));
+    addJSDocComment(o1, [
+        table.description || `Bulk ${op.replace('bulk', '').toLowerCase()} mutation hook for ${typeName}`,
+    ]);
+    statements.push(o1);
+    // Implementation
+    const implSelProp = t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation(selectionConfigType(typeRef(selectTypeName))));
+    const implParamType = t.tsIntersectionType([
+        t.tsTypeLiteral([implSelProp]),
+        omitType(typeRef('UseMutationOptions', [
+            t.tsAnyKeyword(),
+            typeRef('Error'),
+            varType,
+        ]), ['mutationFn']),
+    ]);
+    const body = [];
+    body.push(buildSelectionArgsCall(selectTypeName));
+    body.push(destructureParamsWithSelection('mutationOptions'));
+    body.push(voidStatement('_selection'));
+    body.push(constDecl('queryClient', callExpr('useQueryClient', [])));
+    const mutationKeyExpr = useCentralizedKeys
+        ? callExpr(t.memberExpression(t.identifier(mutationKeysName), t.identifier(op)), [])
+        : undefined;
+    // Build the ORM method call depending on the operation
+    const ormMethodName = op;
+    const mutationFnArgs = (() => {
+        switch (op) {
+            case 'bulkCreate':
+                return t.objectExpression([
+                    shorthandProp('data'),
+                    objectProp('onConflict', t.memberExpression(t.identifier('vars'), t.identifier('onConflict'))),
+                    objectProp('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+            case 'bulkUpsert':
+                return t.objectExpression([
+                    shorthandProp('data'),
+                    objectProp('onConflict', t.memberExpression(t.identifier('vars'), t.identifier('onConflict'))),
+                    objectProp('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+            case 'bulkUpdate':
+                return t.objectExpression([
+                    objectProp('where', t.memberExpression(t.identifier('vars'), t.identifier('where'))),
+                    shorthandProp('data'),
+                    objectProp('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+            case 'bulkDelete':
+                return t.objectExpression([
+                    objectProp('where', t.memberExpression(t.identifier('vars'), t.identifier('where'))),
+                    objectProp('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+        }
+    })();
+    const varsParam = createFunctionParam('vars', varType);
+    const mutationFnExpr = t.arrowFunctionExpression([varsParam], getClientCallUnwrap(singularName, ormMethodName, mutationFnArgs));
+    // onSuccess: invalidate lists
+    const listKeyExpr = useCentralizedKeys
+        ? callExpr(t.memberExpression(t.identifier(keysName), t.identifier('lists')), [])
+        : t.arrayExpression([
+            t.stringLiteral(typeName.toLowerCase()),
+            t.stringLiteral('list'),
+        ]);
+    const onSuccessFn = t.arrowFunctionExpression([], t.blockStatement([
+        t.expressionStatement(callExpr(t.memberExpression(t.identifier('queryClient'), t.identifier('invalidateQueries')), [t.objectExpression([objectProp('queryKey', listKeyExpr)])])),
+    ]));
+    body.push(returnUseMutation(mutationFnExpr, [
+        objectProp('onSuccess', onSuccessFn),
+        spreadObj(t.identifier('mutationOptions')),
+    ], mutationKeyExpr));
+    statements.push(exportFunction(hookName, null, [createFunctionParam('params', implParamType)], body));
+    return {
+        fileName,
+        content: generateHookFileCode(table.description || `Bulk ${op.replace('bulk', '').toLowerCase()} mutation hook for ${typeName}`, statements),
+    };
+}
 export function generateAllMutationHooks(tables, options = {}) {
     const files = [];
     for (const table of tables) {
@@ -392,6 +571,14 @@ export function generateAllMutationHooks(tables, options = {}) {
         if (deleteHook) {
             files.push(deleteHook);
         }
+        // Bulk mutation hooks
+        const bulkOps = ['bulkCreate', 'bulkUpsert', 'bulkUpdate', 'bulkDelete'];
+        for (const op of bulkOps) {
+            const hook = generateBulkMutationHook(table, op, options);
+            if (hook) {
+                files.push(hook);
+            }
+        }
     }
     return files;
 }

package/esm/core/codegen/orm/client-generator.d.ts

@@ -31,6 +31,4 @@ export declare function generateSelectTypesFile(): GeneratedClientFile;
 /**
  * Generate the main index.ts with createClient factory
  */
-export declare function generateCreateClientFile(tables: Table[], hasCustomQueries: boolean, hasCustomMutations: boolean, options?: {
-    nodeHttpAdapter?: boolean;
-}): GeneratedClientFile;
+export declare function generateCreateClientFile(tables: Table[], hasCustomQueries: boolean, hasCustomMutations: boolean): GeneratedClientFile;

package/esm/core/codegen/orm/client-generator.js

@@ -86,7 +86,7 @@ function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false
 /**
  * Generate the main index.ts with createClient factory
  */
-export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations, options) {
+export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations) {
     const statements = [];
     // Add imports
     // Import OrmClient (value) and OrmClientConfig (type) separately
@@ -128,12 +128,6 @@ export function generateCreateClientFile(tables, hasCustomQueries, hasCustomMuta
     statements.push(t.exportAllDeclaration(t.stringLiteral('./select-types')));
     // Re-export all models
     statements.push(t.exportAllDeclaration(t.stringLiteral('./models')));
-    // Re-export NodeHttpAdapter when enabled (for use in any Node.js application)
-    if (options?.nodeHttpAdapter) {
-        statements.push(t.exportNamedDeclaration(null, [
-            t.exportSpecifier(t.identifier('NodeHttpAdapter'), t.identifier('NodeHttpAdapter')),
-        ], t.stringLiteral('./node-fetch')));
-    }
     // Re-export custom operations
     if (hasCustomQueries) {
         statements.push(t.exportNamedDeclaration(null, [

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

@@ -90,7 +90,7 @@ export function generateOrm(options) {
     const typesBarrel = generateTypesBarrel(useSharedTypes);
     files.push({ path: typesBarrel.fileName, content: typesBarrel.content });
     // 7. Generate main index.ts with createClient
-    const indexFile = generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations, { nodeHttpAdapter: !!options.config.nodeHttpAdapter });
+    const indexFile = generateCreateClientFile(tables, hasCustomQueries, hasCustomMutations);
     files.push({ path: indexFile.fileName, content: indexFile.content });
     return {
         files,

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

@@ -7,7 +7,7 @@
 import * as t from '@babel/types';
 import { singularize } from 'inflekt';
 import { generateCode } from '../babel-ast';
-import { getCreateInputTypeName, getCreateMutationName, getDeleteInputTypeName, getDeleteMutationName, getFilterTypeName, getGeneratedFileHeader, getOrderByTypeName, getPrimaryKeyInfo, getSingleRowQueryName, getTableNames, hasValidPrimaryKey, lcFirst, ucFirst, } from '../utils';
+import { getCreateInputTypeName, getCreateMutationName, getDeleteInputTypeName, getDeleteMutationName, getFilterTypeName, getGeneratedFileHeader, getOrderByTypeName, getPrimaryKeyInfo, getTableNames, hasValidPrimaryKey, lcFirst, ucFirst, } from '../utils';
 function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false) {
     const specifiers = namedImports.map((name) => t.importSpecifier(t.identifier(name), t.identifier(name)));
     const decl = t.importDeclaration(specifiers, t.stringLiteral(moduleSpecifier));
@@ -83,7 +83,10 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
     const pkField = pkFields[0];
     const pluralQueryName = table.query?.all ?? pluralName;
     const singleQueryName = table.query?.one;
-    const singleResultFieldName = getSingleRowQueryName(table);
+    // The unwrapped result key for findFirst/findOne — must be the friendly
+    // singular noun (e.g. "animal"), NOT the GraphQL by-id query name (e.g.
+    // "animalById"), so the surface aligns with the rest of the SDK.
+    const singleResultFieldName = singularName;
     const createMutationName = table.query?.create ?? `create${typeName}`;
     const updateMutationName = table.query?.update;
     const deleteMutationName = table.query?.delete;
@@ -96,6 +99,12 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
         const jt = allTables?.find((tb) => tb.name === r.junctionTable);
         return jt?.query?.delete != null;
     });
+    // Detect which bulk mutations are available for this table
+    const bulkInsertMutationName = table.query?.bulkInsert ?? null;
+    const bulkUpsertMutationName = table.query?.bulkUpsert ?? null;
+    const bulkUpdateMutationName = table.query?.bulkUpdate ?? null;
+    const bulkDeleteMutationName = table.query?.bulkDelete ?? null;
+    const hasBulk = !!(bulkInsertMutationName || bulkUpsertMutationName || bulkUpdateMutationName || bulkDeleteMutationName);
     const queryBuilderImports = [
         'QueryBuilder',
         'buildFindManyDocument',
@@ -105,6 +114,10 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
         'buildUpdateByPkDocument',
         'buildDeleteByPkDocument',
         ...(needsJunctionRemove ? ['buildJunctionRemoveDocument'] : []),
+        ...(bulkInsertMutationName ? ['buildBulkInsertDocument'] : []),
+        ...(bulkUpsertMutationName ? ['buildBulkUpsertDocument'] : []),
+        ...(bulkUpdateMutationName ? ['buildBulkUpdateDocument'] : []),
+        ...(bulkDeleteMutationName ? ['buildBulkDeleteDocument'] : []),
     ];
     statements.push(createImportDeclaration('../query-builder', queryBuilderImports));
     statements.push(createImportDeclaration('../select-types', [
@@ -114,6 +127,7 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
         'CreateArgs',
         'UpdateArgs',
         'DeleteArgs',
+        ...(hasBulk ? ['BulkInsertArgs', 'BulkUpsertArgs', 'BulkUpdateArgs', 'BulkDeleteArgs', 'BulkMutationResult'] : []),
         'InferSelectResult',
         'StrictSelect',
     ], true));
@@ -192,15 +206,17 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
         const findFirstTypeArgs = [
             (sel) => sel,
             () => t.tsTypeReference(t.identifier(whereTypeName)),
+            () => t.tsTypeReference(t.identifier(orderByTypeName)),
         ];
         const argsType = (sel) => t.tsTypeReference(t.identifier('FindFirstArgs'), t.tsTypeParameterInstantiation(findFirstTypeArgs.map(fn => fn(sel))));
         const retType = (sel) => t.tsTypeAnnotation(t.tsTypeReference(t.identifier('QueryBuilder'), t.tsTypeParameterInstantiation([
             t.tsTypeLiteral([
-                t.tsPropertySignature(t.identifier(pluralQueryName), t.tsTypeAnnotation(t.tsTypeLiteral([
-                    t.tsPropertySignature(t.identifier('nodes'), t.tsTypeAnnotation(t.tsArrayType(t.tsTypeReference(t.identifier('InferSelectResult'), t.tsTypeParameterInstantiation([
+                t.tsPropertySignature(t.identifier(singleResultFieldName), t.tsTypeAnnotation(t.tsUnionType([
+                    t.tsTypeReference(t.identifier('InferSelectResult'), t.tsTypeParameterInstantiation([
                         t.tsTypeReference(t.identifier(relationTypeName)),
                         sel,
-                    ]))))),
+                    ])),
+                    t.tsNullKeyword(),
                 ]))),
             ]),
         ])));
@@ -213,6 +229,10 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
         const selectExpr = t.memberExpression(t.identifier('args'), t.identifier('select'));
         const findFirstObjProps = [
             t.objectProperty(t.identifier('where'), t.optionalMemberExpression(t.identifier('args'), t.identifier('where'), false, true)),
+            t.objectProperty(t.identifier('orderBy'), t.tsAsExpression(t.optionalMemberExpression(t.identifier('args'), t.identifier('orderBy'), false, true), t.tsUnionType([
+                t.tsArrayType(t.tsStringKeyword()),
+                t.tsUndefinedKeyword(),
+            ]))),
         ];
         const bodyArgs = [
             t.stringLiteral(typeName),
@@ -220,9 +240,23 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
             selectExpr,
             t.objectExpression(findFirstObjProps),
             t.stringLiteral(whereTypeName),
+            t.stringLiteral(orderByTypeName),
             t.identifier('connectionFieldsMap'),
         ];
-        classBody.push(createClassMethod('findFirst', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildFindFirstDocument', bodyArgs, 'query', typeName, pluralQueryName)));
+        const transformDataParam = t.identifier('data');
+        const transformedNodesProp = t.tsPropertySignature(t.identifier('nodes'), t.tsTypeAnnotation(t.tsArrayType(t.tsTypeReference(t.identifier('InferSelectResult'), t.tsTypeParameterInstantiation([
+            t.tsTypeReference(t.identifier(relationTypeName)),
+            sRef(),
+        ])))));
+        transformedNodesProp.optional = true;
+        const transformedCollectionProp = t.tsPropertySignature(t.identifier(pluralQueryName), t.tsTypeAnnotation(t.tsTypeLiteral([transformedNodesProp])));
+        transformedCollectionProp.optional = true;
+        transformDataParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeLiteral([transformedCollectionProp]));
+        const firstNodeExpr = t.optionalMemberExpression(t.optionalMemberExpression(t.memberExpression(t.identifier('data'), t.identifier(pluralQueryName)), t.identifier('nodes'), false, true), t.numericLiteral(0), true, true);
+        const transformFn = t.arrowFunctionExpression([transformDataParam], t.objectExpression([
+            t.objectProperty(t.stringLiteral(singleResultFieldName), t.logicalExpression('??', firstNodeExpr, t.nullLiteral())),
+        ]));
+        classBody.push(createClassMethod('findFirst', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildFindFirstDocument', bodyArgs, 'query', typeName, singleResultFieldName, [t.objectProperty(t.identifier('transform'), transformFn)])));
     }
     // ── findOne ────────────────────────────────────────────────────────────
     if (hasValidPrimaryKey(table)) {
@@ -413,6 +447,134 @@ export function generateModelFile(table, _useSharedTypes, options, allTables) {
         ];
         classBody.push(createClassMethod('delete', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildDeleteByPkDocument', bodyArgs, 'mutation', typeName, deleteMutationName)));
     }
+    // ── bulkCreate ──────────────────────────────────────────────────────────
+    if (bulkInsertMutationName) {
+        const bulkInsertInputTypeName = `BulkCreate${typeName}Input`;
+        const dataType = () => t.tsIndexedAccessType(t.tsTypeReference(t.identifier(createInputTypeName)), t.tsLiteralType(t.stringLiteral(singularName)));
+        const argsType = (sel) => t.tsTypeReference(t.identifier('BulkInsertArgs'), t.tsTypeParameterInstantiation([sel, dataType()]));
+        const retType = (sel) => t.tsTypeAnnotation(t.tsTypeReference(t.identifier('QueryBuilder'), t.tsTypeParameterInstantiation([
+            t.tsTypeReference(t.identifier('BulkMutationResult'), t.tsTypeParameterInstantiation([
+                t.tsTypeReference(t.identifier('InferSelectResult'), t.tsTypeParameterInstantiation([
+                    t.tsTypeReference(t.identifier(relationTypeName)),
+                    sel,
+                ])),
+            ])),
+        ])));
+        const implParam = t.identifier('args');
+        implParam.typeAnnotation = t.tsTypeAnnotation(t.tsIntersectionType([
+            argsType(sRef()),
+            t.tsTypeLiteral([requiredSelectProp()]),
+            strictSelectGuard(selectTypeName),
+        ]));
+        const selectExpr = t.memberExpression(t.identifier('args'), t.identifier('select'));
+        const bodyArgs = [
+            t.stringLiteral(typeName),
+            t.stringLiteral(bulkInsertMutationName),
+            selectExpr,
+            t.memberExpression(t.identifier('args'), t.identifier('data')),
+            t.stringLiteral(bulkInsertInputTypeName),
+            t.memberExpression(t.identifier('args'), t.identifier('onConflict')),
+            t.identifier('connectionFieldsMap'),
+        ];
+        classBody.push(createClassMethod('bulkCreate', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildBulkInsertDocument', bodyArgs, 'mutation', typeName, bulkInsertMutationName)));
+    }
+    // ── bulkUpsert ─────────────────────────────────────────────────────────
+    if (bulkUpsertMutationName) {
+        const bulkUpsertInputTypeName = `BulkUpsert${typeName}Input`;
+        const dataType = () => t.tsIndexedAccessType(t.tsTypeReference(t.identifier(createInputTypeName)), t.tsLiteralType(t.stringLiteral(singularName)));
+        const argsType = (sel) => t.tsTypeReference(t.identifier('BulkUpsertArgs'), t.tsTypeParameterInstantiation([sel, dataType()]));
+        const retType = (sel) => t.tsTypeAnnotation(t.tsTypeReference(t.identifier('QueryBuilder'), t.tsTypeParameterInstantiation([
+            t.tsTypeReference(t.identifier('BulkMutationResult'), t.tsTypeParameterInstantiation([
+                t.tsTypeReference(t.identifier('InferSelectResult'), t.tsTypeParameterInstantiation([
+                    t.tsTypeReference(t.identifier(relationTypeName)),
+                    sel,
+                ])),
+            ])),
+        ])));
+        const implParam = t.identifier('args');
+        implParam.typeAnnotation = t.tsTypeAnnotation(t.tsIntersectionType([
+            argsType(sRef()),
+            t.tsTypeLiteral([requiredSelectProp()]),
+            strictSelectGuard(selectTypeName),
+        ]));
+        const selectExpr = t.memberExpression(t.identifier('args'), t.identifier('select'));
+        const bodyArgs = [
+            t.stringLiteral(typeName),
+            t.stringLiteral(bulkUpsertMutationName),
+            selectExpr,
+            t.memberExpression(t.identifier('args'), t.identifier('data')),
+            t.stringLiteral(bulkUpsertInputTypeName),
+            t.memberExpression(t.identifier('args'), t.identifier('onConflict')),
+            t.identifier('connectionFieldsMap'),
+        ];
+        classBody.push(createClassMethod('bulkUpsert', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildBulkUpsertDocument', bodyArgs, 'mutation', typeName, bulkUpsertMutationName)));
+    }
+    // ── bulkUpdate ─────────────────────────────────────────────────────────
+    if (bulkUpdateMutationName) {
+        const bulkUpdateInputTypeName = `BulkUpdate${typeName}Input`;
+        const argsType = (sel) => t.tsTypeReference(t.identifier('BulkUpdateArgs'), t.tsTypeParameterInstantiation([
+            sel,
+            t.tsTypeReference(t.identifier(whereTypeName)),
+            t.tsTypeReference(t.identifier(patchTypeName)),
+        ]));
+        const retType = (sel) => t.tsTypeAnnotation(t.tsTypeReference(t.identifier('QueryBuilder'), t.tsTypeParameterInstantiation([
+            t.tsTypeReference(t.identifier('BulkMutationResult'), t.tsTypeParameterInstantiation([
+                t.tsTypeReference(t.identifier('InferSelectResult'), t.tsTypeParameterInstantiation([
+                    t.tsTypeReference(t.identifier(relationTypeName)),
+                    sel,
+                ])),
+            ])),
+        ])));
+        const implParam = t.identifier('args');
+        implParam.typeAnnotation = t.tsTypeAnnotation(t.tsIntersectionType([
+            argsType(sRef()),
+            t.tsTypeLiteral([requiredSelectProp()]),
+            strictSelectGuard(selectTypeName),
+        ]));
+        const selectExpr = t.memberExpression(t.identifier('args'), t.identifier('select'));
+        const bodyArgs = [
+            t.stringLiteral(typeName),
+            t.stringLiteral(bulkUpdateMutationName),
+            selectExpr,
+            t.memberExpression(t.identifier('args'), t.identifier('where')),
+            t.memberExpression(t.identifier('args'), t.identifier('data')),
+            t.stringLiteral(bulkUpdateInputTypeName),
+            t.identifier('connectionFieldsMap'),
+        ];
+        classBody.push(createClassMethod('bulkUpdate', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildBulkUpdateDocument', bodyArgs, 'mutation', typeName, bulkUpdateMutationName)));
+    }
+    // ── bulkDelete ─────────────────────────────────────────────────────────
+    if (bulkDeleteMutationName) {
+        const bulkDeleteInputTypeName = `BulkDelete${typeName}Input`;
+        const argsType = (sel) => t.tsTypeReference(t.identifier('BulkDeleteArgs'), t.tsTypeParameterInstantiation([
+            sel,
+            t.tsTypeReference(t.identifier(whereTypeName)),
+        ]));
+        const retType = (sel) => t.tsTypeAnnotation(t.tsTypeReference(t.identifier('QueryBuilder'), t.tsTypeParameterInstantiation([
+            t.tsTypeReference(t.identifier('BulkMutationResult'), t.tsTypeParameterInstantiation([
+                t.tsTypeReference(t.identifier('InferSelectResult'), t.tsTypeParameterInstantiation([
+                    t.tsTypeReference(t.identifier(relationTypeName)),
+                    sel,
+                ])),
+            ])),
+        ])));
+        const implParam = t.identifier('args');
+        implParam.typeAnnotation = t.tsTypeAnnotation(t.tsIntersectionType([
+            argsType(sRef()),
+            t.tsTypeLiteral([requiredSelectProp()]),
+            strictSelectGuard(selectTypeName),
+        ]));
+        const selectExpr = t.memberExpression(t.identifier('args'), t.identifier('select'));
+        const bodyArgs = [
+            t.stringLiteral(typeName),
+            t.stringLiteral(bulkDeleteMutationName),
+            selectExpr,
+            t.memberExpression(t.identifier('args'), t.identifier('where')),
+            t.stringLiteral(bulkDeleteInputTypeName),
+            t.identifier('connectionFieldsMap'),
+        ];
+        classBody.push(createClassMethod('bulkDelete', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildBulkDeleteDocument', bodyArgs, 'mutation', typeName, bulkDeleteMutationName)));
+    }
     // ── M:N add/remove methods ────────────────────────────────────────────
     for (const rel of m2nRels) {
         if (!rel.fieldName)

package/esm/core/codegen/orm/select-types.d.ts

@@ -167,9 +167,10 @@ export interface FindManyArgs<TSelect, TWhere, TOrderBy> {
 /**
  * Arguments for findFirst/findUnique operations
  */
-export interface FindFirstArgs<TSelect, TWhere> {
+export interface FindFirstArgs<TSelect, TWhere, TOrderBy> {
     select?: TSelect;
     where?: TWhere;
+    orderBy?: TOrderBy[];
 }
 /**
  * Arguments for create operations

package/esm/core/codegen/queries.js

@@ -433,7 +433,7 @@ export function generateSingleQueryHook(table, options = {}) {
             t.tsPropertySignature(t.identifier(pkFieldName), t.tsTypeAnnotation(pkTsType)),
             t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation(selectionConfigType(typeRef(selectTypeName)))),
         ];
-        statements.push(exportAsyncFunction(fetchFnName, null, [createFunctionParam('params', t.tsTypeLiteral(fImplProps))], fBody));
+        statements.push(exportAsyncFunction(fetchFnName, null, [createFunctionParam('params', t.tsTypeLiteral(fImplProps))], fBody, typeRef('Promise', [t.tsAnyKeyword()])));
     }
     // Prefetch function
     if (reactQueryEnabled) {

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

@@ -101,6 +101,14 @@ export declare function getUpdateMutationName(table: Table): string;
  * Get the GraphQL mutation name for deleting
  */
 export declare function getDeleteMutationName(table: Table): string;
+export declare function getBulkCreateMutationHookName(table: Table): string;
+export declare function getBulkUpsertMutationHookName(table: Table): string;
+export declare function getBulkUpdateMutationHookName(table: Table): string;
+export declare function getBulkDeleteMutationHookName(table: Table): string;
+export declare function getBulkCreateMutationFileName(table: Table): string;
+export declare function getBulkUpsertMutationFileName(table: Table): string;
+export declare function getBulkUpdateMutationFileName(table: Table): string;
+export declare function getBulkDeleteMutationFileName(table: Table): string;
 /**
  * Get PostGraphile filter type name
  * e.g., "CarFilter"

package/esm/core/codegen/utils.js

@@ -154,6 +154,37 @@ export function getDeleteMutationName(table) {
     return table.query?.delete || `delete${table.name}`;
 }
 // ============================================================================
+// Bulk mutation naming helpers
+// ============================================================================
+export function getBulkCreateMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkCreate${typeName}Mutation`;
+}
+export function getBulkUpsertMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkUpsert${typeName}Mutation`;
+}
+export function getBulkUpdateMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkUpdate${typeName}Mutation`;
+}
+export function getBulkDeleteMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkDelete${typeName}Mutation`;
+}
+export function getBulkCreateMutationFileName(table) {
+    return `${getBulkCreateMutationHookName(table)}.ts`;
+}
+export function getBulkUpsertMutationFileName(table) {
+    return `${getBulkUpsertMutationHookName(table)}.ts`;
+}
+export function getBulkUpdateMutationFileName(table) {
+    return `${getBulkUpdateMutationHookName(table)}.ts`;
+}
+export function getBulkDeleteMutationFileName(table) {
+    return `${getBulkDeleteMutationHookName(table)}.ts`;
+}
+// ============================================================================
 // Type names
 // ============================================================================
 /**

package/esm/core/generate.js

@@ -47,9 +47,6 @@ export async function generate(options = {}, internalOptions) {
     const runReactQuery = config.reactQuery ?? false;
     const runCli = internalOptions?.skipCli ? false : !!config.cli;
     const runOrm = runReactQuery || !!config.cli || (options.orm !== undefined ? !!options.orm : false);
-    // Auto-enable nodeHttpAdapter when CLI is enabled, unless explicitly set to false
-    const useNodeHttpAdapter = options.nodeHttpAdapter === true ||
-        (runCli && options.nodeHttpAdapter !== false);
     const schemaEnabled = !!options.schema?.enabled;
     if (!schemaEnabled && !runReactQuery && !runOrm && !runCli) {
         return {
@@ -184,22 +181,13 @@ export async function generate(options = {}, internalOptions) {
                 mutations: customOperations.mutations,
                 typeRegistry: customOperations.typeRegistry,
             },
-            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
+            config,
             sharedTypesPath: bothEnabled ? '..' : undefined,
         });
         filesToWrite.push(...files.map((file) => ({
             ...file,
             path: path.posix.join('orm', file.path),
         })));
-        // Generate NodeHttpAdapter in ORM output when enabled
-        if (useNodeHttpAdapter) {
-            const { generateNodeFetchFile } = await import('./codegen/cli/utils-generator');
-            const nodeFetchFile = generateNodeFetchFile();
-            filesToWrite.push({
-                path: path.posix.join('orm', nodeFetchFile.fileName),
-                content: nodeFetchFile.content,
-            });
-        }
     }
     // Generate CLI commands
     if (runCli) {
@@ -210,7 +198,7 @@ export async function generate(options = {}, internalOptions) {
                 queries: customOperations.queries,
                 mutations: customOperations.mutations,
             },
-            config: { ...config, nodeHttpAdapter: useNodeHttpAdapter },
+            config,
             typeRegistry: customOperations.typeRegistry,
         });
         filesToWrite.push(...files.map((file) => ({
@@ -540,16 +528,11 @@ export async function generateMulti(options) {
         if (useUnifiedCli && cliTargets.length > 0 && !dryRun) {
             const cliConfig = typeof unifiedCli === 'object' ? unifiedCli : {};
             const toolName = cliConfig.toolName ?? 'app';
-            // Auto-enable nodeHttpAdapter for unified CLI unless explicitly disabled
-            // Check first target config for explicit nodeHttpAdapter setting
             const firstTargetConfig = configs[names[0]];
-            const multiNodeHttpAdapter = firstTargetConfig?.nodeHttpAdapter === true ||
-                (firstTargetConfig?.nodeHttpAdapter !== false);
             const { files } = generateMultiTargetCli({
                 toolName,
                 builtinNames: cliConfig.builtinNames,
                 targets: cliTargets,
-                nodeHttpAdapter: multiNodeHttpAdapter,
                 entryPoint: cliConfig.entryPoint,
             });
             const cliFilesToWrite = files.map((file) => ({