feat: codegen support for bulk mutations (Phase 6)

[pyramation]

Summary

Phase 6 of the bulk mutations feature: extends the codegen pipeline to generate ORM methods, React Query mutation hooks, and CLI commands for the bulk mutations exposed by the graphile-bulk-mutations plugin (Phases 1-4) and integrated via enable_bulk database settings (Phase 5).

Changes

Introspection (graphql/query)

• Extended TableQueryNames interface with bulkInsert, bulkUpsert, bulkUpdate, bulkDelete fields
• Extended matchMutationOperations() to detect bulkCreate{Plural}, bulkUpsert{Plural}, etc. from the schema
• Extended getTableOperationNames() to include bulk mutations in the exclusion set (prevents them from being treated as custom operations)

Templates (graphql/codegen/src/core/codegen/templates/)

• query-builder.ts: Added buildBulkInsertDocument, buildBulkUpsertDocument, buildBulkUpdateDocument, buildBulkDeleteDocument functions
• select-types.ts: Added BulkInsertArgs, BulkUpsertArgs, BulkUpdateArgs, BulkDeleteArgs, and BulkMutationResult types

ORM Model Generation (model-generator.ts)

• Generates bulkCreate(), bulkUpsert(), bulkUpdate(), bulkDelete() class methods when the table has the corresponding bulk mutations
• Returns QueryBuilder<BulkMutationResult<InferSelectResult<T, S>>>

React Query Hooks (mutations.ts)

• Generates useBulkCreate{Type}Mutation, useBulkUpsert{Type}Mutation, useBulkUpdate{Type}Mutation, useBulkDelete{Type}Mutation hooks
• Includes proper query key invalidation (invalidates list queries on success)
• Adds bulk mutation keys to mutation-keys.ts

CLI Commands (table-command-generator.ts)

• Generates bulk-create, bulk-upsert, bulk-update, bulk-delete subcommands
• bulk-create/upsert accept --data (JSON array), bulk-update accepts --where + --data, bulk-delete accepts --where

Utils

• Added bulk naming helpers: getBulkCreateMutationHookName, getBulkCreateMutationFileName, etc.

Review & Testing Checklist for Human

• Run codegen against a schema with enable_bulk enabled and tables tagged with @behavior +bulkInsert +bulkUpsert +bulkUpdate +bulkDelete — verify generated ORM model has bulk methods
• Verify generated React Query hooks compile and are properly typed (data arrays, where clauses, BulkMutationResult return type)
• Verify generated CLI commands appear in the subcommand list and accept the expected flags
• Check that tables WITHOUT bulk smart tags produce NO bulk methods/hooks/commands (opt-in only)

Notes

• All code generation uses Babel AST per the AGENTS.md rules — no string concatenation
• Builds and typechecks clean (tsc --noEmit passes)
• Bulk hooks follow the same patterns as existing create/update/delete hooks for consistency
• The bulk CLI commands use JSON input (since they deal with arrays/objects) rather than interactive prompting

Link to Devin session: https://app.devin.ai/sessions/b5701e74c8b44bbf89db370f3323acf2
Requested by: @pyramation

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring