@constructive-io/graphql-codegen 4.40.6 → 4.41.1

package/core/codegen/cli/executor-generator.d.ts

@@ -7,9 +7,5 @@ export interface MultiTargetExecutorInput {
     endpoint: string;
     ormImportPath: string;
 }
-export interface ExecutorOptions {
-    /** Enable NodeHttpAdapter for *.localhost subdomain routing */
-    nodeHttpAdapter?: boolean;
-}
-export declare function generateExecutorFile(toolName: string, options?: ExecutorOptions): GeneratedFile;
-export declare function generateMultiTargetExecutorFile(toolName: string, targets: MultiTargetExecutorInput[], options?: ExecutorOptions): GeneratedFile;
+export declare function generateExecutorFile(toolName: string): GeneratedFile;
+export declare function generateMultiTargetExecutorFile(toolName: string, targets: MultiTargetExecutorInput[]): GeneratedFile;

package/core/codegen/cli/executor-generator.js

@@ -44,12 +44,8 @@ function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false
     decl.importKind = typeOnly ? 'type' : 'value';
     return decl;
 }
-function generateExecutorFile(toolName, options) {
+function generateExecutorFile(toolName) {
     const statements = [];
-    // Import NodeHttpAdapter for *.localhost subdomain routing
-    if (options?.nodeHttpAdapter) {
-        statements.push(createImportDeclaration('./node-fetch', ['NodeHttpAdapter']));
-    }
     statements.push(createImportDeclaration('appstash', ['createConfigStore']));
     statements.push(createImportDeclaration('../orm', ['createClient']));
     statements.push(t.variableDeclaration('const', [
@@ -109,26 +105,12 @@ function generateExecutorFile(toolName, options) {
                 ]))),
             ])),
         ])),
-        // Build createClient config — use NodeHttpAdapter for *.localhost endpoints
-        ...(options?.nodeHttpAdapter
-            ? [
-                t.returnStatement(t.callExpression(t.identifier('createClient'), [
-                    t.objectExpression([
-                        t.objectProperty(t.identifier('adapter'), t.newExpression(t.identifier('NodeHttpAdapter'), [
-                            t.memberExpression(t.identifier('ctx'), t.identifier('endpoint')),
-                            t.identifier('headers'),
-                        ])),
-                    ]),
-                ])),
-            ]
-            : [
-                t.returnStatement(t.callExpression(t.identifier('createClient'), [
-                    t.objectExpression([
-                        t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('ctx'), t.identifier('endpoint'))),
-                        t.objectProperty(t.identifier('headers'), t.identifier('headers')),
-                    ]),
-                ])),
+        t.returnStatement(t.callExpression(t.identifier('createClient'), [
+            t.objectExpression([
+                t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('ctx'), t.identifier('endpoint'))),
+                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
             ]),
+        ])),
     ]);
     const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [contextNameParam], getClientBody);
     statements.push(t.exportNamedDeclaration(getClientFunc));
@@ -139,12 +121,8 @@ function generateExecutorFile(toolName, options) {
         content: header + '\n' + code,
     };
 }
-function generateMultiTargetExecutorFile(toolName, targets, options) {
+function generateMultiTargetExecutorFile(toolName, targets) {
     const statements = [];
-    // Import NodeHttpAdapter for *.localhost subdomain routing
-    if (options?.nodeHttpAdapter) {
-        statements.push(createImportDeclaration('./node-fetch', ['NodeHttpAdapter']));
-    }
     statements.push(createImportDeclaration('appstash', ['createConfigStore']));
     for (const target of targets) {
         const aliasName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}Client`;
@@ -235,26 +213,12 @@ function generateMultiTargetExecutorFile(toolName, targets, options) {
         ]), t.blockStatement([
             t.expressionStatement(t.assignmentExpression('=', t.identifier('endpoint'), t.logicalExpression('||', t.memberExpression(t.identifier('defaultEndpoints'), t.identifier('targetName'), true), t.stringLiteral('')))),
         ])),
-        // Build createClient config — use NodeHttpAdapter for *.localhost endpoints
-        ...(options?.nodeHttpAdapter
-            ? [
-                t.returnStatement(t.callExpression(t.identifier('createFn'), [
-                    t.objectExpression([
-                        t.objectProperty(t.identifier('adapter'), t.newExpression(t.identifier('NodeHttpAdapter'), [
-                            t.identifier('endpoint'),
-                            t.identifier('headers'),
-                        ])),
-                    ]),
-                ])),
-            ]
-            : [
-                t.returnStatement(t.callExpression(t.identifier('createFn'), [
-                    t.objectExpression([
-                        t.objectProperty(t.identifier('endpoint'), t.identifier('endpoint')),
-                        t.objectProperty(t.identifier('headers'), t.identifier('headers')),
-                    ]),
-                ])),
+        t.returnStatement(t.callExpression(t.identifier('createFn'), [
+            t.objectExpression([
+                t.objectProperty(t.identifier('endpoint'), t.identifier('endpoint')),
+                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
             ]),
+        ])),
     ]);
     const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [targetNameParam, contextNameParam], getClientBody);
     statements.push(t.exportNamedDeclaration(getClientFunc));

package/core/codegen/cli/index.d.ts

@@ -39,8 +39,6 @@ export interface GenerateMultiTargetCliOptions {
     toolName: string;
     builtinNames?: BuiltinNames;
     targets: MultiTargetCliTarget[];
-    /** Enable NodeHttpAdapter for *.localhost subdomain routing */
-    nodeHttpAdapter?: boolean;
     /** Generate a runnable index.ts entry point */
     entryPoint?: boolean;
 }

package/core/codegen/cli/index.js

@@ -19,11 +19,7 @@ function generateCli(options) {
     const toolName = typeof cliConfig === 'object' && cliConfig.toolName
         ? cliConfig.toolName
         : 'app';
-    // Use top-level nodeHttpAdapter from config (auto-enabled for CLI by generate.ts)
-    const useNodeHttpAdapter = !!config.nodeHttpAdapter;
-    const executorFile = (0, executor_generator_1.generateExecutorFile)(toolName, {
-        nodeHttpAdapter: useNodeHttpAdapter,
-    });
+    const executorFile = (0, executor_generator_1.generateExecutorFile)(toolName);
     files.push(executorFile);
     const utilsFile = (0, utils_generator_1.generateUtilsFile)();
     files.push(utilsFile);
@@ -32,10 +28,6 @@ function generateCli(options) {
     if (hasAnyEmbeddings) {
         files.push((0, utils_generator_1.generateEmbedderFile)());
     }
-    // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
-    if (useNodeHttpAdapter) {
-        files.push((0, utils_generator_1.generateNodeFetchFile)());
-    }
     const contextFile = (0, infra_generator_1.generateContextCommand)(toolName);
     files.push(contextFile);
     const authFile = (0, infra_generator_1.generateAuthCommand)(toolName);
@@ -97,9 +89,7 @@ function generateMultiTargetCli(options) {
         endpoint: t.endpoint,
         ormImportPath: t.ormImportPath,
     }));
-    const executorFile = (0, executor_generator_1.generateMultiTargetExecutorFile)(toolName, executorInputs, {
-        nodeHttpAdapter: !!options.nodeHttpAdapter,
-    });
+    const executorFile = (0, executor_generator_1.generateMultiTargetExecutorFile)(toolName, executorInputs);
     files.push(executorFile);
     const utilsFile = (0, utils_generator_1.generateUtilsFile)();
     files.push(utilsFile);
@@ -108,10 +98,6 @@ function generateMultiTargetCli(options) {
     if (hasAnyMtEmbeddings) {
         files.push((0, utils_generator_1.generateEmbedderFile)());
     }
-    // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
-    if (options.nodeHttpAdapter) {
-        files.push((0, utils_generator_1.generateNodeFetchFile)());
-    }
     const contextFile = (0, infra_generator_1.generateMultiTargetContextCommand)(toolName, builtinNames.context, targets.map((t) => ({ name: t.name, endpoint: t.endpoint })));
     files.push(contextFile);
     const authFile = (0, infra_generator_1.generateAuthCommandWithName)(toolName, builtinNames.auth);

package/core/codegen/cli/table-command-generator.js

@@ -312,7 +312,7 @@ function buildFindManyArgsType(table) {
 }
 /**
  * Build the FindFirstArgs type instantiation for a table:
- * FindFirstArgs<SelectType, FilterType> & { select: SelectType }
+ * FindFirstArgs<SelectType, FilterType, OrderByType> & { select: SelectType }
  *
  * The intersection with { select: SelectType } makes select required,
  * matching what the ORM's findFirst method expects.
@@ -321,9 +321,11 @@ function buildFindFirstArgsType(table) {
     const { typeName } = (0, utils_1.getTableNames)(table);
     const selectTypeName = `${typeName}Select`;
     const whereTypeName = (0, utils_1.getFilterTypeName)(table);
+    const orderByTypeName = (0, utils_1.getOrderByTypeName)(table);
     const findFirstType = t.tsTypeReference(t.identifier('FindFirstArgs'), t.tsTypeParameterInstantiation([
         t.tsTypeReference(t.identifier(selectTypeName)),
         t.tsTypeReference(t.identifier(whereTypeName)),
+        t.tsTypeReference(t.identifier(orderByTypeName)),
     ]));
     // Intersect with { select: SelectType } to make select required
     return t.tsIntersectionType([
@@ -716,6 +718,114 @@ function buildMutationHandler(table, operation, vectorFieldNames, targetName, ty
         t.tryStatement(t.blockStatement(tryBody), buildErrorCatch(`Failed to ${operation} record.`)),
     ]), false, true);
 }
+function buildBulkMutationHandler(table, operation, targetName) {
+    const { singularName } = (0, utils_1.getTableNames)(table);
+    const selectObj = buildSelectObject(table);
+    // Map CLI op name to ORM method name
+    const ormMethod = (() => {
+        switch (operation) {
+            case 'bulk-create': return 'bulkCreate';
+            case 'bulk-upsert': return 'bulkUpsert';
+            case 'bulk-update': return 'bulkUpdate';
+            case 'bulk-delete': return 'bulkDelete';
+        }
+    })();
+    const tryBody = [];
+    if (operation === 'bulk-create' || operation === 'bulk-upsert') {
+        // Parse --data (JSON array) from argv
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('dataRaw'), t.memberExpression(t.identifier('argv'), t.identifier('data'))),
+        ]));
+        tryBody.push(t.ifStatement(t.unaryExpression('!', t.identifier('dataRaw')), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [t.stringLiteral(`--data is required for ${operation}. Provide a JSON array.`)])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(1)])),
+        ])));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('data'), t.callExpression(t.memberExpression(t.identifier('JSON'), t.identifier('parse')), [t.tsAsExpression(t.identifier('dataRaw'), t.tsStringKeyword())])),
+        ]));
+        let ormArgs;
+        if (operation === 'bulk-upsert') {
+            // Also parse --on-conflict
+            tryBody.push(t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('onConflictRaw'), t.memberExpression(t.identifier('argv'), t.identifier('on-conflict'))),
+            ]));
+            tryBody.push(t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('onConflict'), t.conditionalExpression(t.identifier('onConflictRaw'), t.callExpression(t.memberExpression(t.identifier('JSON'), t.identifier('parse')), [t.tsAsExpression(t.identifier('onConflictRaw'), t.tsStringKeyword())]), t.objectExpression([]))),
+            ]));
+            ormArgs = t.objectExpression([
+                t.objectProperty(t.identifier('data'), t.identifier('data')),
+                t.objectProperty(t.identifier('onConflict'), t.identifier('onConflict')),
+                t.objectProperty(t.identifier('select'), selectObj),
+            ]);
+        }
+        else {
+            ormArgs = t.objectExpression([
+                t.objectProperty(t.identifier('data'), t.identifier('data')),
+                t.objectProperty(t.identifier('select'), selectObj),
+            ]);
+        }
+        tryBody.push(buildGetClientStatement(targetName));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCall(singularName, ormMethod, ormArgs))),
+        ]));
+    }
+    else if (operation === 'bulk-update') {
+        // Parse --where (JSON) and --data (JSON)
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('whereRaw'), t.memberExpression(t.identifier('argv'), t.identifier('where'))),
+        ]));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('dataRaw'), t.memberExpression(t.identifier('argv'), t.identifier('data'))),
+        ]));
+        tryBody.push(t.ifStatement(t.logicalExpression('||', t.unaryExpression('!', t.identifier('whereRaw')), t.unaryExpression('!', t.identifier('dataRaw'))), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [t.stringLiteral('--where and --data are required for bulk-update. Provide JSON objects.')])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(1)])),
+        ])));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('where'), t.callExpression(t.memberExpression(t.identifier('JSON'), t.identifier('parse')), [t.tsAsExpression(t.identifier('whereRaw'), t.tsStringKeyword())])),
+        ]));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('data'), t.callExpression(t.memberExpression(t.identifier('JSON'), t.identifier('parse')), [t.tsAsExpression(t.identifier('dataRaw'), t.tsStringKeyword())])),
+        ]));
+        tryBody.push(buildGetClientStatement(targetName));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCall(singularName, ormMethod, t.objectExpression([
+                t.objectProperty(t.identifier('where'), t.identifier('where')),
+                t.objectProperty(t.identifier('data'), t.identifier('data')),
+                t.objectProperty(t.identifier('select'), selectObj),
+            ])))),
+        ]));
+    }
+    else {
+        // bulk-delete: parse --where (JSON)
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('whereRaw'), t.memberExpression(t.identifier('argv'), t.identifier('where'))),
+        ]));
+        tryBody.push(t.ifStatement(t.unaryExpression('!', t.identifier('whereRaw')), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [t.stringLiteral('--where is required for bulk-delete. Provide a JSON object.')])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(1)])),
+        ])));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('where'), t.callExpression(t.memberExpression(t.identifier('JSON'), t.identifier('parse')), [t.tsAsExpression(t.identifier('whereRaw'), t.tsStringKeyword())])),
+        ]));
+        tryBody.push(buildGetClientStatement(targetName));
+        tryBody.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCall(singularName, ormMethod, t.objectExpression([
+                t.objectProperty(t.identifier('where'), t.identifier('where')),
+                t.objectProperty(t.identifier('select'), selectObj),
+            ])))),
+        ]));
+    }
+    tryBody.push(buildJsonLog(t.identifier('result')));
+    const argvParam = t.identifier('argv');
+    argvParam.typeAnnotation = buildArgvType();
+    const prompterParam = t.identifier('prompter');
+    prompterParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Inquirerer')));
+    const handlerName = `handle${(0, utils_1.toPascalCase)(operation)}`;
+    return t.functionDeclaration(t.identifier(handlerName), [argvParam, prompterParam], t.blockStatement([
+        t.tryStatement(t.blockStatement(tryBody), buildErrorCatch(`Failed to ${operation}.`)),
+    ]), false, true);
+}
 function generateTableCommand(table, options) {
     const { singularName, typeName } = (0, utils_1.getTableNames)(table);
     const commandName = (0, inflekt_1.toKebabCase)(singularName);
@@ -793,6 +903,11 @@ function generateTableCommand(table, options) {
         const embedderPath = options?.targetName ? '../../embedder' : '../embedder';
         statements.push(createImportDeclaration(embedderPath, ['resolveEmbedder', 'autoEmbedWhere', 'autoEmbedInput']));
     }
+    // Detect bulk mutations
+    const hasBulkCreate = !!table.query?.bulkInsert;
+    const hasBulkUpsert = !!table.query?.bulkUpsert;
+    const hasBulkUpdate = !!table.query?.bulkUpdate;
+    const hasBulkDelete = !!table.query?.bulkDelete;
     const subcommands = ['list', 'find-first'];
     if (hasSearchFields)
         subcommands.push('search');
@@ -803,6 +918,14 @@ function generateTableCommand(table, options) {
         subcommands.push('update');
     if (hasDelete)
         subcommands.push('delete');
+    if (hasBulkCreate)
+        subcommands.push('bulk-create');
+    if (hasBulkUpsert)
+        subcommands.push('bulk-upsert');
+    if (hasBulkUpdate)
+        subcommands.push('bulk-update');
+    if (hasBulkDelete)
+        subcommands.push('bulk-delete');
     const usageLines = [
         '',
         `${commandName} <command>`,
@@ -823,7 +946,15 @@ function generateTableCommand(table, options) {
     }
     if (hasDelete)
         usageLines.push(`  delete                Delete a ${singularName}`);
-    usageLines.push('', 'List Options:', '  --limit <n>           Max number of records to return (forward pagination)', '  --last <n>            Number of records from the end (backward pagination)', '  --after <cursor>      Cursor for forward pagination', '  --before <cursor>     Cursor for backward pagination', '  --offset <n>          Number of records to skip', '  --select <fields>     Comma-separated list of fields to return', '  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)', '  --condition.<f>.<op>  Condition filter (dot-notation)', '  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)', '', 'Find-First Options:', '  --select <fields>     Comma-separated list of fields to return', '  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)', '  --condition.<f>.<op>  Condition filter (dot-notation)', '');
+    if (hasBulkCreate)
+        usageLines.push(`  bulk-create           Bulk create ${singularName} records`);
+    if (hasBulkUpsert)
+        usageLines.push(`  bulk-upsert           Bulk upsert ${singularName} records`);
+    if (hasBulkUpdate)
+        usageLines.push(`  bulk-update           Bulk update ${singularName} records`);
+    if (hasBulkDelete)
+        usageLines.push(`  bulk-delete           Bulk delete ${singularName} records`);
+    usageLines.push('', 'List Options:', '  --limit <n>           Max number of records to return (forward pagination)', '  --last <n>            Number of records from the end (backward pagination)', '  --after <cursor>      Cursor for forward pagination', '  --before <cursor>     Cursor for backward pagination', '  --offset <n>          Number of records to skip', '  --select <fields>     Comma-separated list of fields to return', '  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)', '  --condition.<f>.<op>  Condition filter (dot-notation)', '  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)', '', 'Find-First Options:', '  --select <fields>     Comma-separated list of fields to return', '  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)', '  --condition.<f>.<op>  Condition filter (dot-notation)', '  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)', '');
     if (hasSearchFields) {
         usageLines.push('Search Options:', '  <query>               Search query string (required)', '  --limit <n>           Max number of records to return', '  --offset <n>          Number of records to skip', '  --select <fields>     Comma-separated list of fields to return', '  --orderBy <values>    Comma-separated list of ordering values');
         if (hasEmbeddings) {
@@ -906,6 +1037,14 @@ function generateTableCommand(table, options) {
         statements.push(buildMutationHandler(table, 'update', vectorFieldNames, tn, options?.typeRegistry, ormTypes));
     if (hasDelete)
         statements.push(buildMutationHandler(table, 'delete', vectorFieldNames, tn, options?.typeRegistry, ormTypes));
+    if (hasBulkCreate)
+        statements.push(buildBulkMutationHandler(table, 'bulk-create', tn));
+    if (hasBulkUpsert)
+        statements.push(buildBulkMutationHandler(table, 'bulk-upsert', tn));
+    if (hasBulkUpdate)
+        statements.push(buildBulkMutationHandler(table, 'bulk-update', tn));
+    if (hasBulkDelete)
+        statements.push(buildBulkMutationHandler(table, 'bulk-delete', tn));
     const header = (0, utils_1.getGeneratedFileHeader)(`CLI commands for ${table.name}`);
     const code = (0, babel_ast_1.generateCode)(statements);
     return {

package/core/codegen/cli/utils-generator.d.ts

@@ -8,14 +8,6 @@ import type { GeneratedFile } from './executor-generator';
  * and mutation input parsing.
  */
 export declare function generateUtilsFile(): GeneratedFile;
-/**
- * Generate a node-fetch.ts file with NodeHttpAdapter for CLI.
- *
- * Provides a GraphQLAdapter implementation using node:http/node:https
- * instead of the Fetch API. This cleanly handles *.localhost subdomain
- * routing (DNS resolution + Host header) without any global patching.
- */
-export declare function generateNodeFetchFile(): GeneratedFile;
 /**
  * Generate an index.ts entry point file for the CLI.
  *

package/core/codegen/cli/utils-generator.js

@@ -34,7 +34,6 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateUtilsFile = generateUtilsFile;
-exports.generateNodeFetchFile = generateNodeFetchFile;
 exports.generateEntryPointFile = generateEntryPointFile;
 exports.generateEmbedderFile = generateEmbedderFile;
 const fs = __importStar(require("fs"));
@@ -79,19 +78,6 @@ function generateUtilsFile() {
         content: readTemplateFile('cli-utils.ts', 'CLI utility functions for type coercion and input handling'),
     };
 }
-/**
- * Generate a node-fetch.ts file with NodeHttpAdapter for CLI.
- *
- * Provides a GraphQLAdapter implementation using node:http/node:https
- * instead of the Fetch API. This cleanly handles *.localhost subdomain
- * routing (DNS resolution + Host header) without any global patching.
- */
-function generateNodeFetchFile() {
-    return {
-        fileName: 'node-fetch.ts',
-        content: readTemplateFile('node-fetch.ts', 'Node HTTP adapter for localhost subdomain routing'),
-    };
-}
 /**
  * Generate an index.ts entry point file for the CLI.
  *

package/core/codegen/mutation-keys.js

@@ -113,6 +113,24 @@ function generateEntityMutationKeysDeclaration(table, relationships) {
     const deleteProp = t.objectProperty(t.identifier('delete'), deleteArrowFn);
     (0, babel_ast_1.addJSDocComment)(deleteProp, [`Delete ${singularName} mutation key`]);
     properties.push(deleteProp);
+    // Bulk mutation keys (only if table has bulk operations)
+    const bulkOps = [
+        { key: 'bulkCreate', queryField: table.query?.bulkInsert },
+        { key: 'bulkUpsert', queryField: table.query?.bulkUpsert },
+        { key: 'bulkUpdate', queryField: table.query?.bulkUpdate },
+        { key: 'bulkDelete', queryField: table.query?.bulkDelete },
+    ];
+    for (const { key, queryField } of bulkOps) {
+        if (!queryField)
+            continue;
+        const arrowFn = t.arrowFunctionExpression([], (0, babel_ast_1.constArray)([
+            t.stringLiteral('mutation'),
+            t.stringLiteral(entityKey),
+            t.stringLiteral(key),
+        ]));
+        const prop = t.objectProperty(t.identifier(key), arrowFn);
+        properties.push(prop);
+    }
     return t.exportNamedDeclaration(t.variableDeclaration('const', [
         t.variableDeclarator(t.identifier(keysName), (0, babel_ast_1.asConst)(t.objectExpression(properties))),
     ]));

package/core/codegen/mutations.js

@@ -416,6 +416,185 @@ function generateDeleteMutationHook(table, options = {}) {
         content: (0, hooks_ast_1.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 } = (0, utils_1.getTableNames)(table);
+    const hookName = (() => {
+        switch (op) {
+            case 'bulkCreate': return (0, utils_1.getBulkCreateMutationHookName)(table);
+            case 'bulkUpsert': return (0, utils_1.getBulkUpsertMutationHookName)(table);
+            case 'bulkUpdate': return (0, utils_1.getBulkUpdateMutationHookName)(table);
+            case 'bulkDelete': return (0, utils_1.getBulkDeleteMutationHookName)(table);
+        }
+    })();
+    const fileName = (() => {
+        switch (op) {
+            case 'bulkCreate': return (0, utils_1.getBulkCreateMutationFileName)(table);
+            case 'bulkUpsert': return (0, utils_1.getBulkUpsertMutationFileName)(table);
+            case 'bulkUpdate': return (0, utils_1.getBulkUpdateMutationFileName)(table);
+            case 'bulkDelete': return (0, utils_1.getBulkDeleteMutationFileName)(table);
+        }
+    })();
+    const keysName = `${(0, utils_1.lcFirst)(typeName)}Keys`;
+    const mutationKeysName = `${(0, utils_1.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((0, hooks_ast_1.createImportDeclaration)('@tanstack/react-query', [
+        'useMutation',
+        'useQueryClient',
+    ]));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('@tanstack/react-query', ['UseMutationOptions', 'UseMutationResult'], true));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../client', ['getClient']));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../selection', ['buildSelectionArgs']));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../selection', ['SelectionConfig'], true));
+    if (useCentralizedKeys) {
+        statements.push((0, hooks_ast_1.createImportDeclaration)('../query-keys', [keysName]));
+        statements.push((0, hooks_ast_1.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((0, hooks_ast_1.createImportDeclaration)('../../orm/input-types', typeImports, true));
+    statements.push((0, hooks_ast_1.createImportDeclaration)('../../orm/select-types', ['InferSelectResult', 'BulkMutationResult', 'HookStrictSelect'], true));
+    // Re-exports
+    statements.push((0, hooks_ast_1.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((0, hooks_ast_1.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((0, hooks_ast_1.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((0, hooks_ast_1.typeRef)(filterTypeName))),
+                    t.tsPropertySignature(t.identifier('data'), t.tsTypeAnnotation((0, hooks_ast_1.typeRef)(patchTypeName))),
+                ]);
+            case 'bulkDelete':
+                return t.tsTypeLiteral([
+                    t.tsPropertySignature(t.identifier('where'), t.tsTypeAnnotation((0, hooks_ast_1.typeRef)(filterTypeName))),
+                ]);
+        }
+    })();
+    // Result type: BulkMutationResult<InferSelectResult<Relation, S>>
+    const bulkResultType = (sel) => (0, hooks_ast_1.typeRef)('BulkMutationResult', [(0, hooks_ast_1.inferSelectResultType)(relationTypeName, sel)]);
+    // Overload with fields
+    const o1ParamType = t.tsIntersectionType([
+        t.tsTypeLiteral([
+            t.tsPropertySignature(t.identifier('selection'), t.tsTypeAnnotation(buildFieldsSelectionType((0, hooks_ast_1.sRef)(), selectTypeName))),
+        ]),
+        (0, hooks_ast_1.useMutationOptionsType)(bulkResultType((0, hooks_ast_1.sRef)()), varType),
+    ]);
+    const o1 = (0, hooks_ast_1.exportDeclareFunction)(hookName, (0, hooks_ast_1.createSTypeParam)(selectTypeName), [(0, hooks_ast_1.createFunctionParam)('params', o1ParamType)], (0, hooks_ast_1.useMutationResultType)(bulkResultType((0, hooks_ast_1.sRef)()), varType));
+    (0, hooks_ast_1.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((0, hooks_ast_1.selectionConfigType)((0, hooks_ast_1.typeRef)(selectTypeName))));
+    const implParamType = t.tsIntersectionType([
+        t.tsTypeLiteral([implSelProp]),
+        (0, hooks_ast_1.omitType)((0, hooks_ast_1.typeRef)('UseMutationOptions', [
+            t.tsAnyKeyword(),
+            (0, hooks_ast_1.typeRef)('Error'),
+            varType,
+        ]), ['mutationFn']),
+    ]);
+    const body = [];
+    body.push((0, hooks_ast_1.buildSelectionArgsCall)(selectTypeName));
+    body.push((0, hooks_ast_1.destructureParamsWithSelection)('mutationOptions'));
+    body.push((0, hooks_ast_1.voidStatement)('_selection'));
+    body.push((0, hooks_ast_1.constDecl)('queryClient', (0, hooks_ast_1.callExpr)('useQueryClient', [])));
+    const mutationKeyExpr = useCentralizedKeys
+        ? (0, hooks_ast_1.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([
+                    (0, hooks_ast_1.shorthandProp)('data'),
+                    (0, hooks_ast_1.objectProp)('onConflict', t.memberExpression(t.identifier('vars'), t.identifier('onConflict'))),
+                    (0, hooks_ast_1.objectProp)('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+            case 'bulkUpsert':
+                return t.objectExpression([
+                    (0, hooks_ast_1.shorthandProp)('data'),
+                    (0, hooks_ast_1.objectProp)('onConflict', t.memberExpression(t.identifier('vars'), t.identifier('onConflict'))),
+                    (0, hooks_ast_1.objectProp)('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+            case 'bulkUpdate':
+                return t.objectExpression([
+                    (0, hooks_ast_1.objectProp)('where', t.memberExpression(t.identifier('vars'), t.identifier('where'))),
+                    (0, hooks_ast_1.shorthandProp)('data'),
+                    (0, hooks_ast_1.objectProp)('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+            case 'bulkDelete':
+                return t.objectExpression([
+                    (0, hooks_ast_1.objectProp)('where', t.memberExpression(t.identifier('vars'), t.identifier('where'))),
+                    (0, hooks_ast_1.objectProp)('select', t.memberExpression(t.identifier('args'), t.identifier('select'))),
+                ]);
+        }
+    })();
+    const varsParam = (0, hooks_ast_1.createFunctionParam)('vars', varType);
+    const mutationFnExpr = t.arrowFunctionExpression([varsParam], (0, hooks_ast_1.getClientCallUnwrap)(singularName, ormMethodName, mutationFnArgs));
+    // onSuccess: invalidate lists
+    const listKeyExpr = useCentralizedKeys
+        ? (0, hooks_ast_1.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((0, hooks_ast_1.callExpr)(t.memberExpression(t.identifier('queryClient'), t.identifier('invalidateQueries')), [t.objectExpression([(0, hooks_ast_1.objectProp)('queryKey', listKeyExpr)])])),
+    ]));
+    body.push((0, hooks_ast_1.returnUseMutation)(mutationFnExpr, [
+        (0, hooks_ast_1.objectProp)('onSuccess', onSuccessFn),
+        (0, hooks_ast_1.spreadObj)(t.identifier('mutationOptions')),
+    ], mutationKeyExpr));
+    statements.push((0, hooks_ast_1.exportFunction)(hookName, null, [(0, hooks_ast_1.createFunctionParam)('params', implParamType)], body));
+    return {
+        fileName,
+        content: (0, hooks_ast_1.generateHookFileCode)(table.description || `Bulk ${op.replace('bulk', '').toLowerCase()} mutation hook for ${typeName}`, statements),
+    };
+}
 function generateAllMutationHooks(tables, options = {}) {
     const files = [];
     for (const table of tables) {
@@ -431,6 +610,14 @@ 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/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;