@constructive-io/graphql-codegen 4.40.5 → 4.41.0

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

@@ -120,7 +120,10 @@ function generateModelFile(table, _useSharedTypes, options, allTables) {
     const pkField = pkFields[0];
     const pluralQueryName = table.query?.all ?? pluralName;
     const singleQueryName = table.query?.one;
-    const singleResultFieldName = (0, utils_1.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;
@@ -133,6 +136,12 @@ 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',
@@ -142,6 +151,10 @@ 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', [
@@ -151,6 +164,7 @@ function generateModelFile(table, _useSharedTypes, options, allTables) {
         'CreateArgs',
         'UpdateArgs',
         'DeleteArgs',
+        ...(hasBulk ? ['BulkInsertArgs', 'BulkUpsertArgs', 'BulkUpdateArgs', 'BulkDeleteArgs', 'BulkMutationResult'] : []),
         'InferSelectResult',
         'StrictSelect',
     ], true));
@@ -229,15 +243,17 @@ 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(),
                 ]))),
             ]),
         ])));
@@ -250,6 +266,10 @@ 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),
@@ -257,9 +277,23 @@ 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 ((0, utils_1.hasValidPrimaryKey)(table)) {
@@ -450,6 +484,134 @@ 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/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/core/codegen/queries.js

@@ -471,7 +471,7 @@ function generateSingleQueryHook(table, options = {}) {
             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));
+        statements.push((0, hooks_ast_1.exportAsyncFunction)(fetchFnName, null, [(0, hooks_ast_1.createFunctionParam)('params', t.tsTypeLiteral(fImplProps))], fBody, (0, hooks_ast_1.typeRef)('Promise', [t.tsAnyKeyword()])));
     }
     // Prefetch function
     if (reactQueryEnabled) {

package/core/codegen/templates/cli-utils.ts

@@ -283,8 +283,8 @@ export function parseFindManyArgs<T = Record<string, unknown>>(
 
 /**
  * Build findFirst args from CLI argv.
- * Like parseFindManyArgs but only includes select and where
- * (no pagination flags — findFirst returns the first matching record).
+ * Like parseFindManyArgs but without pagination flags (no limit/offset/after/before/last)
+ * — findFirst returns the first matching record. Supports select, where, and orderBy.
  */
 export function parseFindFirstArgs<T = Record<string, unknown>>(
   argv: Record<string, unknown>,
@@ -293,10 +293,12 @@ export function parseFindFirstArgs<T = Record<string, unknown>>(
   const select = parseSelectFlag(argv, defaultSelect);
   const parsed = unflattenDotNotation(argv);
   const where = parsed.where;
+  const orderBy = parseOrderByFlag(argv);
 
   return {
     select,
     ...(where !== undefined ? { where } : {}),
+    ...(orderBy !== undefined ? { orderBy } : {}),
   } as unknown as T;
 }
 

package/core/codegen/templates/query-builder.ts

@@ -343,8 +343,9 @@ export function buildFindFirstDocument<TSelect, TWhere>(
   operationName: string,
   queryField: string,
   select: TSelect,
-  args: { where?: TWhere },
+  args: { where?: TWhere; orderBy?: string[] },
   filterTypeName: string,
+  orderByTypeName: string,
   connectionFieldsMap?: Record<string, Record<string, string>>,
 ): { document: string; variables: Record<string, unknown> } {
   const selections = select
@@ -376,6 +377,16 @@ export function buildFindFirstDocument<TSelect, TWhere>(
     queryArgs,
     variables,
   );
+  addVariable(
+    {
+      varName: 'orderBy',
+      typeName: '[' + orderByTypeName + '!]',
+      value: args.orderBy?.length ? args.orderBy : undefined,
+    },
+    variableDefinitions,
+    queryArgs,
+    variables,
+  );
 
   const document = t.document({
     definitions: [
@@ -962,3 +973,161 @@ function buildValueAst(
 
   throw new Error('Unsupported value type: ' + typeof value);
 }
+
+// ============================================================================
+// Bulk Mutation Document Builders
+// ============================================================================
+
+export function buildBulkInsertDocument<TSelect, TData>(
+  operationName: string,
+  mutationField: string,
+  select: TSelect,
+  data: TData[],
+  inputTypeName: string,
+  onConflict?: unknown,
+  connectionFieldsMap?: Record<string, Record<string, string>>,
+): { document: string; variables: Record<string, unknown> } {
+  const selections = select
+    ? buildSelections(
+        select as Record<string, unknown>,
+        connectionFieldsMap,
+        operationName,
+      )
+    : [t.field({ name: 'id' })];
+
+  return {
+    document: buildInputMutationDocument({
+      operationName,
+      mutationField,
+      inputTypeName,
+      resultSelections: [
+        t.field({ name: 'affectedCount' }),
+        t.field({
+          name: 'returning',
+          selectionSet: t.selectionSet({ selections }),
+        }),
+      ],
+    }),
+    variables: {
+      input: {
+        values: data,
+        ...(onConflict ? { onConflict } : {}),
+      },
+    },
+  };
+}
+
+export function buildBulkUpsertDocument<TSelect, TData>(
+  operationName: string,
+  mutationField: string,
+  select: TSelect,
+  data: TData[],
+  inputTypeName: string,
+  onConflict: unknown,
+  connectionFieldsMap?: Record<string, Record<string, string>>,
+): { document: string; variables: Record<string, unknown> } {
+  const selections = select
+    ? buildSelections(
+        select as Record<string, unknown>,
+        connectionFieldsMap,
+        operationName,
+      )
+    : [t.field({ name: 'id' })];
+
+  return {
+    document: buildInputMutationDocument({
+      operationName,
+      mutationField,
+      inputTypeName,
+      resultSelections: [
+        t.field({ name: 'affectedCount' }),
+        t.field({
+          name: 'returning',
+          selectionSet: t.selectionSet({ selections }),
+        }),
+      ],
+    }),
+    variables: {
+      input: {
+        values: data,
+        onConflict,
+      },
+    },
+  };
+}
+
+export function buildBulkUpdateDocument<TSelect, TWhere, TData>(
+  operationName: string,
+  mutationField: string,
+  select: TSelect,
+  where: TWhere,
+  data: TData,
+  inputTypeName: string,
+  connectionFieldsMap?: Record<string, Record<string, string>>,
+): { document: string; variables: Record<string, unknown> } {
+  const selections = select
+    ? buildSelections(
+        select as Record<string, unknown>,
+        connectionFieldsMap,
+        operationName,
+      )
+    : [t.field({ name: 'id' })];
+
+  return {
+    document: buildInputMutationDocument({
+      operationName,
+      mutationField,
+      inputTypeName,
+      resultSelections: [
+        t.field({ name: 'affectedCount' }),
+        t.field({
+          name: 'returning',
+          selectionSet: t.selectionSet({ selections }),
+        }),
+      ],
+    }),
+    variables: {
+      input: {
+        where,
+        patch: data,
+      },
+    },
+  };
+}
+
+export function buildBulkDeleteDocument<TSelect, TWhere>(
+  operationName: string,
+  mutationField: string,
+  select: TSelect,
+  where: TWhere,
+  inputTypeName: string,
+  connectionFieldsMap?: Record<string, Record<string, string>>,
+): { document: string; variables: Record<string, unknown> } {
+  const selections = select
+    ? buildSelections(
+        select as Record<string, unknown>,
+        connectionFieldsMap,
+        operationName,
+      )
+    : [t.field({ name: 'id' })];
+
+  return {
+    document: buildInputMutationDocument({
+      operationName,
+      mutationField,
+      inputTypeName,
+      resultSelections: [
+        t.field({ name: 'affectedCount' }),
+        t.field({
+          name: 'returning',
+          selectionSet: t.selectionSet({ selections }),
+        }),
+      ],
+    }),
+    variables: {
+      input: {
+        where,
+      },
+    },
+  };
+}

package/core/codegen/templates/select-types.ts

@@ -32,9 +32,10 @@ export interface FindManyArgs<TSelect, TWhere, TOrderBy = never> {
   offset?: number;
 }
 
-export interface FindFirstArgs<TSelect, TWhere> {
+export interface FindFirstArgs<TSelect, TWhere, TOrderBy> {
   select?: TSelect;
   where?: TWhere;
+  orderBy?: TOrderBy[];
 }
 
 export interface CreateArgs<TSelect, TData> {
@@ -61,6 +62,34 @@ export interface DeleteArgs<TWhere, TSelect = undefined> {
   select?: TSelect;
 }
 
+export interface BulkInsertArgs<TSelect, TData, TOnConflict = unknown> {
+  data: TData[];
+  select?: TSelect;
+  onConflict?: TOnConflict;
+}
+
+export interface BulkUpsertArgs<TSelect, TData, TOnConflict = unknown> {
+  data: TData[];
+  select?: TSelect;
+  onConflict: TOnConflict;
+}
+
+export interface BulkUpdateArgs<TSelect, TWhere, TData> {
+  where: TWhere;
+  data: TData;
+  select?: TSelect;
+}
+
+export interface BulkDeleteArgs<TSelect, TWhere> {
+  where: TWhere;
+  select?: TSelect;
+}
+
+export interface BulkMutationResult<T> {
+  affectedCount: number;
+  returning: T[];
+}
+
 type DepthLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
 type DecrementDepth = {
   0: 0;

package/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/core/codegen/utils.js

@@ -20,6 +20,14 @@ exports.getSingleRowQueryName = getSingleRowQueryName;
 exports.getCreateMutationName = getCreateMutationName;
 exports.getUpdateMutationName = getUpdateMutationName;
 exports.getDeleteMutationName = getDeleteMutationName;
+exports.getBulkCreateMutationHookName = getBulkCreateMutationHookName;
+exports.getBulkUpsertMutationHookName = getBulkUpsertMutationHookName;
+exports.getBulkUpdateMutationHookName = getBulkUpdateMutationHookName;
+exports.getBulkDeleteMutationHookName = getBulkDeleteMutationHookName;
+exports.getBulkCreateMutationFileName = getBulkCreateMutationFileName;
+exports.getBulkUpsertMutationFileName = getBulkUpsertMutationFileName;
+exports.getBulkUpdateMutationFileName = getBulkUpdateMutationFileName;
+exports.getBulkDeleteMutationFileName = getBulkDeleteMutationFileName;
 exports.getFilterTypeName = getFilterTypeName;
 exports.getOrderByTypeName = getOrderByTypeName;
 exports.getConditionTypeName = getConditionTypeName;
@@ -201,6 +209,37 @@ function getDeleteMutationName(table) {
     return table.query?.delete || `delete${table.name}`;
 }
 // ============================================================================
+// Bulk mutation naming helpers
+// ============================================================================
+function getBulkCreateMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkCreate${typeName}Mutation`;
+}
+function getBulkUpsertMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkUpsert${typeName}Mutation`;
+}
+function getBulkUpdateMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkUpdate${typeName}Mutation`;
+}
+function getBulkDeleteMutationHookName(table) {
+    const { typeName } = getTableNames(table);
+    return `useBulkDelete${typeName}Mutation`;
+}
+function getBulkCreateMutationFileName(table) {
+    return `${getBulkCreateMutationHookName(table)}.ts`;
+}
+function getBulkUpsertMutationFileName(table) {
+    return `${getBulkUpsertMutationHookName(table)}.ts`;
+}
+function getBulkUpdateMutationFileName(table) {
+    return `${getBulkUpdateMutationHookName(table)}.ts`;
+}
+function getBulkDeleteMutationFileName(table) {
+    return `${getBulkDeleteMutationHookName(table)}.ts`;
+}
+// ============================================================================
 // Type names
 // ============================================================================
 /**