@payloadcms/plugin-mcp 0.0.1-alpha.0

package/dist/mcp/tools/resource/find.js

@@ -0,0 +1,119 @@
+import { toCamelCase } from '../../../utils/camelCase.js';
+import { toolSchemas } from '../schemas.js';
+export const findResourceTool = (server, req, user, verboseLogs, collectionSlug, collections)=>{
+    const tool = async (id, limit = 10, page = 1, sort, where)=>{
+        const payload = req.payload;
+        if (verboseLogs) {
+            payload.logger.info(`[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}`);
+        }
+        try {
+            // Parse where clause if provided
+            let whereClause = {};
+            if (where) {
+                try {
+                    whereClause = JSON.parse(where);
+                    if (verboseLogs) {
+                        payload.logger.info(`[payload-mcp] Using where clause: ${where}`);
+                    }
+                } catch (_parseError) {
+                    payload.logger.warn(`[payload-mcp] Invalid where clause JSON: ${where}`);
+                    const response = {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: Invalid JSON in where clause'
+                            }
+                        ]
+                    };
+                    return collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response;
+                }
+            }
+            // If ID is provided, use findByID
+            if (id) {
+                try {
+                    const doc = await payload.findByID({
+                        id,
+                        collection: collectionSlug,
+                        user
+                    });
+                    if (verboseLogs) {
+                        payload.logger.info(`[payload-mcp] Found document with ID: ${id}`);
+                    }
+                    const response = {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Resource from collection "${collectionSlug}":
+${JSON.stringify(doc, null, 2)}`
+                            }
+                        ]
+                    };
+                    return collections?.[collectionSlug]?.overrideResponse?.(response, doc, req) || response;
+                } catch (_findError) {
+                    payload.logger.warn(`[payload-mcp] Document not found with ID: ${id} in collection: ${collectionSlug}`);
+                    const response = {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Error: Document with ID "${id}" not found in collection "${collectionSlug}"`
+                            }
+                        ]
+                    };
+                    return collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response;
+                }
+            }
+            // Otherwise, use find to get multiple documents
+            const findOptions = {
+                collection: collectionSlug,
+                limit,
+                page,
+                user
+            };
+            if (sort) {
+                findOptions.sort = sort;
+            }
+            if (Object.keys(whereClause).length > 0) {
+                findOptions.where = whereClause;
+            }
+            const result = await payload.find(findOptions);
+            if (verboseLogs) {
+                payload.logger.info(`[payload-mcp] Found ${result.docs.length} documents in collection: ${collectionSlug}`);
+            }
+            let responseText = `Collection: "${collectionSlug}"
+Total: ${result.totalDocs} documents
+Page: ${result.page} of ${result.totalPages}
+`;
+            for (const doc of result.docs){
+                responseText += `\n\`\`\`json\n${JSON.stringify(doc, null, 2)}\n\`\`\``;
+            }
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: responseText
+                    }
+                ]
+            };
+            return collections?.[collectionSlug]?.overrideResponse?.(response, result, req) || response;
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            payload.logger.error(`[payload-mcp] Error reading resources from collection ${collectionSlug}: ${errorMessage}`);
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ **Error reading resources from collection "${collectionSlug}":** ${errorMessage}`
+                    }
+                ]
+            };
+            return collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response;
+        }
+    };
+    if (collections?.[collectionSlug]?.enabled) {
+        server.tool(`find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${toolSchemas.findResources.description.trim()}\n\n${collections?.[collectionSlug]?.description || ''}`, toolSchemas.findResources.parameters.shape, async ({ id, limit, page, sort, where })=>{
+            return await tool(id, limit, page, sort, where);
+        });
+    }
+};
+
+//# sourceMappingURL=find.js.map

package/dist/mcp/tools/resource/find.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/tools/resource/find.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { toolSchemas } from '../schemas.js'\n\nexport const findResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n) => {\n  const tool = async (\n    id?: string,\n    limit: number = 10,\n    page: number = 1,\n    sort?: string,\n    where?: string,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}`,\n      )\n    }\n\n    try {\n      // Parse where clause if provided\n      let whereClause = {}\n      if (where) {\n        try {\n          whereClause = JSON.parse(where)\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Using where clause: ${where}`)\n          }\n        } catch (_parseError) {\n          payload.logger.warn(`[payload-mcp] Invalid where clause JSON: ${where}`)\n          const response = {\n            content: [{ type: 'text' as const, text: 'Error: Invalid JSON in where clause' }],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // If ID is provided, use findByID\n      if (id) {\n        try {\n          const doc = await payload.findByID({\n            id,\n            collection: collectionSlug,\n            user,\n          })\n\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Found document with ID: ${id}`)\n          }\n\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Resource from collection \"${collectionSlug}\":\n${JSON.stringify(doc, null, 2)}`,\n              },\n            ],\n          }\n\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, doc, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        } catch (_findError) {\n          payload.logger.warn(\n            `[payload-mcp] Document not found with ID: ${id} in collection: ${collectionSlug}`,\n          )\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Error: Document with ID \"${id}\" not found in collection \"${collectionSlug}\"`,\n              },\n            ],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // Otherwise, use find to get multiple documents\n      const findOptions: Parameters<typeof payload.find>[0] = {\n        collection: collectionSlug,\n        limit,\n        page,\n        user,\n      }\n\n      if (sort) {\n        findOptions.sort = sort\n      }\n\n      if (Object.keys(whereClause).length > 0) {\n        findOptions.where = whereClause\n      }\n\n      const result = await payload.find(findOptions)\n\n      if (verboseLogs) {\n        payload.logger.info(\n          `[payload-mcp] Found ${result.docs.length} documents in collection: ${collectionSlug}`,\n        )\n      }\n\n      let responseText = `Collection: \"${collectionSlug}\"\nTotal: ${result.totalDocs} documents\nPage: ${result.page} of ${result.totalPages}\n`\n\n      for (const doc of result.docs) {\n        responseText += `\\n\\`\\`\\`json\\n${JSON.stringify(doc, null, 2)}\\n\\`\\`\\``\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: responseText,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n        response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error reading resources from collection ${collectionSlug}: ${errorMessage}`,\n      )\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `❌ **Error reading resources from collection \"${collectionSlug}\":** ${errorMessage}`,\n          },\n        ],\n      }\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    server.tool(\n      `find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${toolSchemas.findResources.description.trim()}\\n\\n${collections?.[collectionSlug]?.description || ''}`,\n      toolSchemas.findResources.parameters.shape,\n      async ({ id, limit, page, sort, where }) => {\n        return await tool(id, limit, page, sort, where)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","findResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","limit","page","sort","where","payload","logger","info","whereClause","JSON","parse","_parseError","warn","response","content","type","text","overrideResponse","doc","findByID","collection","stringify","_findError","findOptions","Object","keys","length","result","find","docs","responseText","totalDocs","totalPages","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","findResources","description","trim","parameters","shape"],"mappings":"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"}

package/dist/mcp/tools/resource/update.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { JSONSchema4 } from 'json-schema';
+import type { PayloadRequest, TypedUser } from 'payload';
+import type { PluginMCPServerConfig } from '../../../types.js';
+export declare const updateResourceTool: (server: McpServer, req: PayloadRequest, user: TypedUser, verboseLogs: boolean, collectionSlug: string, collections: PluginMCPServerConfig["collections"], schema: JSONSchema4) => void;
+//# sourceMappingURL=update.d.ts.map

package/dist/mcp/tools/resource/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/resource/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK9D,eAAO,MAAM,kBAAkB,WACrB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,kBACJ,MAAM,eACT,qBAAqB,CAAC,aAAa,CAAC,UACzC,WAAW,SAuSpB,CAAA"}

package/dist/mcp/tools/resource/update.js

@@ -0,0 +1,201 @@
+import { z } from 'zod';
+import { toCamelCase } from '../../../utils/camelCase.js';
+import { convertCollectionSchemaToZod } from '../../../utils/convertCollectionSchemaToZod.js';
+import { toolSchemas } from '../schemas.js';
+export const updateResourceTool = (server, req, user, verboseLogs, collectionSlug, collections, schema)=>{
+    const tool = async (data, id, where, draft = false, depth = 0, overrideLock = true, filePath, overwriteExistingFiles = false)=>{
+        const payload = req.payload;
+        if (verboseLogs) {
+            payload.logger.info(`[payload-mcp] Updating resource in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}`);
+        }
+        try {
+            // Parse the data JSON
+            let parsedData;
+            try {
+                parsedData = JSON.parse(data);
+                if (verboseLogs) {
+                    payload.logger.info(`[payload-mcp] Parsed data for ${collectionSlug}: ${JSON.stringify(parsedData)}`);
+                }
+            } catch (_parseError) {
+                payload.logger.error(`[payload-mcp] Invalid JSON data provided: ${data}`);
+                const response = {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Invalid JSON data provided'
+                        }
+                    ]
+                };
+                return collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response;
+            }
+            // Validate that either id or where is provided
+            if (!id && !where) {
+                payload.logger.error('[payload-mcp] Either id or where clause must be provided');
+                const response = {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Either id or where clause must be provided'
+                        }
+                    ]
+                };
+                return collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response;
+            }
+            // Parse where clause if provided
+            let whereClause = {};
+            if (where) {
+                try {
+                    whereClause = JSON.parse(where);
+                    if (verboseLogs) {
+                        payload.logger.info(`[payload-mcp] Using where clause: ${where}`);
+                    }
+                } catch (_parseError) {
+                    payload.logger.error(`[payload-mcp] Invalid where clause JSON: ${where}`);
+                    const response = {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: Invalid JSON in where clause'
+                            }
+                        ]
+                    };
+                    return collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response;
+                }
+            }
+            // Update by ID or where clause
+            if (id) {
+                // Single document update
+                const updateOptions = {
+                    id,
+                    collection: collectionSlug,
+                    data: parsedData,
+                    depth,
+                    draft,
+                    overrideLock,
+                    user,
+                    ...filePath && {
+                        filePath
+                    },
+                    ...overwriteExistingFiles && {
+                        overwriteExistingFiles
+                    }
+                };
+                if (verboseLogs) {
+                    payload.logger.info(`[payload-mcp] Updating single document with ID: ${id}`);
+                }
+                const result = await payload.update({
+                    ...updateOptions,
+                    data: collections?.[collectionSlug]?.override?.(parsedData, req) || parsedData
+                });
+                if (verboseLogs) {
+                    payload.logger.info(`[payload-mcp] Successfully updated document with ID: ${id}`);
+                }
+                const response = {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Document updated successfully in collection "${collectionSlug}"!
+Updated document:
+\`\`\`json
+${JSON.stringify(result, null, 2)}
+\`\`\``
+                        }
+                    ]
+                };
+                return collections?.[collectionSlug]?.overrideResponse?.(response, result, req) || response;
+            } else {
+                // Multiple documents update
+                const updateOptions = {
+                    collection: collectionSlug,
+                    data: parsedData,
+                    depth,
+                    draft,
+                    overrideAccess: true,
+                    overrideLock,
+                    where: whereClause,
+                    ...filePath && {
+                        filePath
+                    },
+                    ...overwriteExistingFiles && {
+                        overwriteExistingFiles
+                    }
+                };
+                if (verboseLogs) {
+                    payload.logger.info(`[payload-mcp] Updating multiple documents with where clause`);
+                }
+                const result = await payload.update({
+                    ...updateOptions,
+                    data: collections?.[collectionSlug]?.override?.(parsedData, req) || parsedData
+                });
+                const bulkResult = result;
+                const docs = bulkResult.docs || [];
+                const errors = bulkResult.errors || [];
+                if (verboseLogs) {
+                    payload.logger.info(`[payload-mcp] Successfully updated ${docs.length} documents, ${errors.length} errors`);
+                }
+                let responseText = `Multiple documents updated in collection "${collectionSlug}"!
+Updated: ${docs.length} documents
+Errors: ${errors.length}
+---`;
+                if (docs.length > 0) {
+                    responseText += `\n\nUpdated documents:
+\`\`\`json
+${JSON.stringify(docs, null, 2)}
+\`\`\``;
+                }
+                if (errors.length > 0) {
+                    responseText += `\n\nErrors:
+\`\`\`json
+${JSON.stringify(errors, null, 2)}
+\`\`\``;
+                }
+                const response = {
+                    content: [
+                        {
+                            type: 'text',
+                            text: responseText
+                        }
+                    ]
+                };
+                return collections?.[collectionSlug]?.overrideResponse?.(response, {
+                    docs,
+                    errors
+                }, req) || response;
+            }
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            payload.logger.error(`[payload-mcp] Error updating resource in ${collectionSlug}: ${errorMessage}`);
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error updating resource in collection "${collectionSlug}": ${errorMessage}`
+                    }
+                ]
+            };
+            return collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response;
+        }
+    };
+    if (collections?.[collectionSlug]?.enabled) {
+        const convertedFields = convertCollectionSchemaToZod(schema);
+        // Create a new schema that combines the converted fields with update-specific parameters
+        const updateResourceSchema = z.object({
+            ...convertedFields.shape,
+            id: z.string().optional().describe('The ID of the document to update'),
+            depth: z.number().optional().default(0).describe('How many levels deep to populate relationships'),
+            draft: z.boolean().optional().default(false).describe('Whether to update the document as a draft'),
+            filePath: z.string().optional().describe('File path for file uploads'),
+            overrideLock: z.boolean().optional().default(true).describe('Whether to override document locks'),
+            overwriteExistingFiles: z.boolean().optional().default(false).describe('Whether to overwrite existing files'),
+            where: z.string().optional().describe('JSON string for where clause to update multiple documents')
+        });
+        server.tool(`update${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${toolSchemas.updateResource.description.trim()}\n\n${collections?.[collectionSlug]?.description || ''}`, updateResourceSchema.shape, async (params)=>{
+            const { id, depth, draft, filePath, overrideLock, overwriteExistingFiles, where, ...fieldData } = params;
+            // Convert field data back to JSON string format expected by the tool
+            const data = JSON.stringify(fieldData);
+            return await tool(data, id, where, draft, depth, overrideLock, filePath, overwriteExistingFiles);
+        });
+    }
+};
+
+//# sourceMappingURL=update.js.map

package/dist/mcp/tools/resource/update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/tools/resource/update.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { JSONSchema4 } from 'json-schema'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport { z } from 'zod'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { convertCollectionSchemaToZod } from '../../../utils/convertCollectionSchemaToZod.js'\nimport { toolSchemas } from '../schemas.js'\nexport const updateResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n  schema: JSONSchema4,\n) => {\n  const tool = async (\n    data: string,\n    id?: string,\n    where?: string,\n    draft: boolean = false,\n    depth: number = 0,\n    overrideLock: boolean = true,\n    filePath?: string,\n    overwriteExistingFiles: boolean = false,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Updating resource in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}`,\n      )\n    }\n\n    try {\n      // Parse the data JSON\n      let parsedData: Record<string, unknown>\n      try {\n        parsedData = JSON.parse(data)\n        if (verboseLogs) {\n          payload.logger.info(\n            `[payload-mcp] Parsed data for ${collectionSlug}: ${JSON.stringify(parsedData)}`,\n          )\n        }\n      } catch (_parseError) {\n        payload.logger.error(`[payload-mcp] Invalid JSON data provided: ${data}`)\n        const response = {\n          content: [{ type: 'text' as const, text: 'Error: Invalid JSON data provided' }],\n        }\n        return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n          response) as {\n          content: Array<{\n            text: string\n            type: 'text'\n          }>\n        }\n      }\n\n      // Validate that either id or where is provided\n      if (!id && !where) {\n        payload.logger.error('[payload-mcp] Either id or where clause must be provided')\n        const response = {\n          content: [\n            { type: 'text' as const, text: 'Error: Either id or where clause must be provided' },\n          ],\n        }\n        return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n          response) as {\n          content: Array<{\n            text: string\n            type: 'text'\n          }>\n        }\n      }\n\n      // Parse where clause if provided\n      let whereClause = {}\n      if (where) {\n        try {\n          whereClause = JSON.parse(where)\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Using where clause: ${where}`)\n          }\n        } catch (_parseError) {\n          payload.logger.error(`[payload-mcp] Invalid where clause JSON: ${where}`)\n          const response = {\n            content: [{ type: 'text' as const, text: 'Error: Invalid JSON in where clause' }],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // Update by ID or where clause\n      if (id) {\n        // Single document update\n        const updateOptions = {\n          id,\n          collection: collectionSlug,\n          data: parsedData,\n          depth,\n          draft,\n          overrideLock,\n          user,\n          ...(filePath && { filePath }),\n          ...(overwriteExistingFiles && { overwriteExistingFiles }),\n        }\n\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Updating single document with ID: ${id}`)\n        }\n        const result = await payload.update({\n          ...updateOptions,\n          data: collections?.[collectionSlug]?.override?.(parsedData, req) || parsedData,\n        } as any)\n\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Successfully updated document with ID: ${id}`)\n        }\n\n        const response = {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Document updated successfully in collection \"${collectionSlug}\"!\nUpdated document:\n\\`\\`\\`json\n${JSON.stringify(result, null, 2)}\n\\`\\`\\``,\n            },\n          ],\n        }\n\n        return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n          response) as {\n          content: Array<{\n            text: string\n            type: 'text'\n          }>\n        }\n      } else {\n        // Multiple documents update\n        const updateOptions = {\n          collection: collectionSlug,\n          data: parsedData,\n          depth,\n          draft,\n          overrideAccess: true,\n          overrideLock,\n          where: whereClause,\n          ...(filePath && { filePath }),\n          ...(overwriteExistingFiles && { overwriteExistingFiles }),\n        }\n\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Updating multiple documents with where clause`)\n        }\n        const result = await payload.update({\n          ...updateOptions,\n          data: collections?.[collectionSlug]?.override?.(parsedData, req) || parsedData,\n        } as any)\n\n        const bulkResult = result as { docs?: unknown[]; errors?: unknown[] }\n        const docs = bulkResult.docs || []\n        const errors = bulkResult.errors || []\n\n        if (verboseLogs) {\n          payload.logger.info(\n            `[payload-mcp] Successfully updated ${docs.length} documents, ${errors.length} errors`,\n          )\n        }\n\n        let responseText = `Multiple documents updated in collection \"${collectionSlug}\"!\nUpdated: ${docs.length} documents\nErrors: ${errors.length}\n---`\n\n        if (docs.length > 0) {\n          responseText += `\\n\\nUpdated documents:\n\\`\\`\\`json\n${JSON.stringify(docs, null, 2)}\n\\`\\`\\``\n        }\n\n        if (errors.length > 0) {\n          responseText += `\\n\\nErrors:\n\\`\\`\\`json\n${JSON.stringify(errors, null, 2)}\n\\`\\`\\``\n        }\n\n        const response = {\n          content: [\n            {\n              type: 'text' as const,\n              text: responseText,\n            },\n          ],\n        }\n\n        return (collections?.[collectionSlug]?.overrideResponse?.(\n          response,\n          { docs, errors },\n          req,\n        ) || response) as {\n          content: Array<{\n            text: string\n            type: 'text'\n          }>\n        }\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error updating resource in ${collectionSlug}: ${errorMessage}`,\n      )\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Error updating resource in collection \"${collectionSlug}\": ${errorMessage}`,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    const convertedFields = convertCollectionSchemaToZod(schema)\n\n    // Create a new schema that combines the converted fields with update-specific parameters\n    const updateResourceSchema = z.object({\n      ...convertedFields.shape,\n      id: z.string().optional().describe('The ID of the document to update'),\n      depth: z\n        .number()\n        .optional()\n        .default(0)\n        .describe('How many levels deep to populate relationships'),\n      draft: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to update the document as a draft'),\n      filePath: z.string().optional().describe('File path for file uploads'),\n      overrideLock: z\n        .boolean()\n        .optional()\n        .default(true)\n        .describe('Whether to override document locks'),\n      overwriteExistingFiles: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to overwrite existing files'),\n      where: z\n        .string()\n        .optional()\n        .describe('JSON string for where clause to update multiple documents'),\n    })\n\n    server.tool(\n      `update${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${toolSchemas.updateResource.description.trim()}\\n\\n${collections?.[collectionSlug]?.description || ''}`,\n      updateResourceSchema.shape,\n      async (params: Record<string, unknown>) => {\n        const {\n          id,\n          depth,\n          draft,\n          filePath,\n          overrideLock,\n          overwriteExistingFiles,\n          where,\n          ...fieldData\n        } = params\n        // Convert field data back to JSON string format expected by the tool\n        const data = JSON.stringify(fieldData)\n        return await tool(\n          data,\n          id as string | undefined,\n          where as string | undefined,\n          draft as boolean,\n          depth as number,\n          overrideLock as boolean,\n          filePath as string | undefined,\n          overwriteExistingFiles as boolean,\n        )\n      },\n    )\n  }\n}\n"],"names":["z","toCamelCase","convertCollectionSchemaToZod","toolSchemas","updateResourceTool","server","req","user","verboseLogs","collectionSlug","collections","schema","tool","data","id","where","draft","depth","overrideLock","filePath","overwriteExistingFiles","payload","logger","info","parsedData","JSON","parse","stringify","_parseError","error","response","content","type","text","overrideResponse","whereClause","updateOptions","collection","result","update","override","overrideAccess","bulkResult","docs","errors","length","responseText","errorMessage","Error","message","enabled","convertedFields","updateResourceSchema","object","shape","string","optional","describe","number","default","boolean","charAt","toUpperCase","slice","updateResource","description","trim","params","fieldData"],"mappings":"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"}