@payloadcms/plugin-mcp 3.65.0-internal.ef3958a → 3.66.0-canary.0

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

@@ -1,10 +1,10 @@
 import { toCamelCase } from '../../../utils/camelCase.js';
 import { toolSchemas } from '../schemas.js';
 export const deleteResourceTool = (server, req, user, verboseLogs, collectionSlug, collections)=>{
-    const tool = async (id, where, depth = 0)=>{
+    const tool = async (id, where, depth = 0, locale, fallbackLocale)=>{
         const payload = req.payload;
         if (verboseLogs) {
-            payload.logger.info(`[payload-mcp] Deleting resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}`);
+            payload.logger.info(`[payload-mcp] Deleting resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}${locale ? `, locale: ${locale}` : ''}`);
         }
         try {
             // Validate that either id or where is provided
@@ -47,7 +47,13 @@ export const deleteResourceTool = (server, req, user, verboseLogs, collectionSlu
                 depth,
                 overrideAccess: false,
                 req,
-                user
+                user,
+                ...locale && {
+                    locale
+                },
+                ...fallbackLocale && {
+                    fallbackLocale
+                }
             };
             // Delete by ID or where clause
             if (id) {
@@ -133,8 +139,8 @@ ${JSON.stringify(errors, null, 2)}
         }
     };
     if (collections?.[collectionSlug]?.enabled) {
-        server.tool(`delete${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.deleteResource.description.trim()}`, toolSchemas.deleteResource.parameters.shape, async ({ id, depth, where })=>{
-            return await tool(id, where, depth);
+        server.tool(`delete${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.deleteResource.description.trim()}`, toolSchemas.deleteResource.parameters.shape, async ({ id, depth, fallbackLocale, locale, where })=>{
+            return await tool(id, where, depth, locale, fallbackLocale);
         });
     }
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/tools/resource/delete.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 deleteResourceTool = (\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    where?: string,\n    depth: number = 0,\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] Deleting resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}`,\n      )\n    }\n\n    try {\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.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      // Build delete options\n      const deleteOptions: Record<string, unknown> = {\n        collection: collectionSlug,\n        depth,\n        overrideAccess: false,\n        req,\n        user,\n      }\n\n      // Delete by ID or where clause\n      if (id) {\n        deleteOptions.id = id\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Deleting single document with ID: ${id}`)\n        }\n      } else {\n        deleteOptions.where = whereClause\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Deleting multiple documents with where clause`)\n        }\n      }\n\n      const result = await payload.delete(deleteOptions as Parameters<typeof payload.delete>[0])\n\n      // Handle different result types\n      if (id) {\n        // Single document deletion\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Successfully deleted document with ID: ${id}`)\n        }\n\n        const response = {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Document deleted successfully from collection \"${collectionSlug}\"!\nDeleted 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 deletion\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 deleted ${docs.length} documents, ${errors.length} errors`,\n          )\n        }\n\n        let responseText = `Document deleted successfully from collection \"${collectionSlug}\"!\nDeleted: ${docs.length} documents\nErrors: ${errors.length}\n---`\n\n        if (docs.length > 0) {\n          responseText += `\\n\\nDeleted 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 deleting resource from ${collectionSlug}: ${errorMessage}`,\n      )\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Error deleting resource from 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    server.tool(\n      `delete${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.deleteResource.description.trim()}`,\n      toolSchemas.deleteResource.parameters.shape,\n      async ({ id, depth, where }) => {\n        return await tool(id, where, depth)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","deleteResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","where","depth","payload","logger","info","error","response","content","type","text","overrideResponse","whereClause","JSON","parse","_parseError","warn","deleteOptions","collection","overrideAccess","result","delete","stringify","bulkResult","docs","errors","length","responseText","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","deleteResource","trim","parameters","shape"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/tools/resource/delete.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 deleteResourceTool = (\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?: number | string,\n    where?: string,\n    depth: number = 0,\n    locale?: string,\n    fallbackLocale?: 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] Deleting resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}${locale ? `, locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\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.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      // Build delete options\n      const deleteOptions: Record<string, unknown> = {\n        collection: collectionSlug,\n        depth,\n        overrideAccess: false,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\n      }\n\n      // Delete by ID or where clause\n      if (id) {\n        deleteOptions.id = id\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Deleting single document with ID: ${id}`)\n        }\n      } else {\n        deleteOptions.where = whereClause\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Deleting multiple documents with where clause`)\n        }\n      }\n\n      const result = await payload.delete(deleteOptions as Parameters<typeof payload.delete>[0])\n\n      // Handle different result types\n      if (id) {\n        // Single document deletion\n        if (verboseLogs) {\n          payload.logger.info(`[payload-mcp] Successfully deleted document with ID: ${id}`)\n        }\n\n        const response = {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Document deleted successfully from collection \"${collectionSlug}\"!\nDeleted 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 deletion\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 deleted ${docs.length} documents, ${errors.length} errors`,\n          )\n        }\n\n        let responseText = `Document deleted successfully from collection \"${collectionSlug}\"!\nDeleted: ${docs.length} documents\nErrors: ${errors.length}\n---`\n\n        if (docs.length > 0) {\n          responseText += `\\n\\nDeleted 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 deleting resource from ${collectionSlug}: ${errorMessage}`,\n      )\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Error deleting resource from 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    server.tool(\n      `delete${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.deleteResource.description.trim()}`,\n      toolSchemas.deleteResource.parameters.shape,\n      async ({ id, depth, fallbackLocale, locale, where }) => {\n        return await tool(id, where, depth, locale, fallbackLocale)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","deleteResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","where","depth","locale","fallbackLocale","payload","logger","info","error","response","content","type","text","overrideResponse","whereClause","JSON","parse","_parseError","warn","deleteOptions","collection","overrideAccess","result","delete","stringify","bulkResult","docs","errors","length","responseText","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","deleteResource","trim","parameters","shape"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/resource/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK9D,eAAO,MAAM,gBAAgB,WACnB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,kBACJ,MAAM,eACT,qBAAqB,CAAC,aAAa,CAAC,SAuLlD,CAAA"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/resource/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK9D,eAAO,MAAM,gBAAgB,WACnB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,kBACJ,MAAM,eACT,qBAAqB,CAAC,aAAa,CAAC,SA6LlD,CAAA"}

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

@@ -1,10 +1,10 @@
 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 tool = async (id, limit = 10, page = 1, sort, where, locale, fallbackLocale)=>{
         const payload = req.payload;
         if (verboseLogs) {
-            payload.logger.info(`[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}`);
+            payload.logger.info(`[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}${locale ? `, locale: ${locale}` : ''}`);
         }
         try {
             // Parse where clause if provided
@@ -36,7 +36,13 @@ export const findResourceTool = (server, req, user, verboseLogs, collectionSlug,
                         collection: collectionSlug,
                         overrideAccess: false,
                         req,
-                        user
+                        user,
+                        ...locale && {
+                            locale
+                        },
+                        ...fallbackLocale && {
+                            fallbackLocale
+                        }
                     });
                     if (verboseLogs) {
                         payload.logger.info(`[payload-mcp] Found document with ID: ${id}`);
@@ -71,7 +77,13 @@ ${JSON.stringify(doc, null, 2)}`
                 overrideAccess: false,
                 page,
                 req,
-                user
+                user,
+                ...locale && {
+                    locale
+                },
+                ...fallbackLocale && {
+                    fallbackLocale
+                }
             };
             if (sort) {
                 findOptions.sort = sort;
@@ -114,8 +126,8 @@ Page: ${result.page} of ${result.totalPages}
         }
     };
     if (collections?.[collectionSlug]?.enabled) {
-        server.tool(`find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`, toolSchemas.findResources.parameters.shape, async ({ id, limit, page, sort, where })=>{
-            return await tool(id, limit, page, sort, where);
+        server.tool(`find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`, toolSchemas.findResources.parameters.shape, async ({ id, fallbackLocale, limit, locale, page, sort, where })=>{
+            return await tool(id, limit, page, sort, where, locale, fallbackLocale);
         });
     }
 };

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

@@ -1 +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            overrideAccess: false,\n            req,\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        overrideAccess: false,\n        page,\n        req,\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      `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`,\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","overrideAccess","stringify","_findError","findOptions","Object","keys","length","result","find","docs","responseText","totalDocs","totalPages","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","findResources","trim","parameters","shape"],"mappings":"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"}
+{"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?: number | string,\n    limit: number = 10,\n    page: number = 1,\n    sort?: string,\n    where?: string,\n    locale?: string,\n    fallbackLocale?: 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}${locale ? `, locale: ${locale}` : ''}`,\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            overrideAccess: false,\n            req,\n            user,\n            ...(locale && { locale }),\n            ...(fallbackLocale && { fallbackLocale }),\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        overrideAccess: false,\n        page,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\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      `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`,\n      toolSchemas.findResources.parameters.shape,\n      async ({ id, fallbackLocale, limit, locale, page, sort, where }) => {\n        return await tool(id, limit, page, sort, where, locale, fallbackLocale)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","findResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","limit","page","sort","where","locale","fallbackLocale","payload","logger","info","whereClause","JSON","parse","_parseError","warn","response","content","type","text","overrideResponse","doc","findByID","collection","overrideAccess","stringify","_findError","findOptions","Object","keys","length","result","find","docs","responseText","totalDocs","totalPages","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","findResources","trim","parameters","shape"],"mappings":"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"}

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

@@ -1 +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,SA2SpB,CAAA"}
+{"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,SAgUpB,CAAA"}

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

@@ -3,10 +3,10 @@ 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 tool = async (data, id, where, draft = false, depth = 0, overrideLock = true, filePath, overwriteExistingFiles = false, locale, fallbackLocale)=>{
         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}`);
+            payload.logger.info(`[payload-mcp] Updating resource in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`);
         }
         try {
             // Parse the data JSON
@@ -80,6 +80,12 @@ export const updateResourceTool = (server, req, user, verboseLogs, collectionSlu
                     },
                     ...overwriteExistingFiles && {
                         overwriteExistingFiles
+                    },
+                    ...locale && {
+                        locale
+                    },
+                    ...fallbackLocale && {
+                        fallbackLocale
                     }
                 };
                 if (verboseLogs) {
@@ -122,6 +128,12 @@ ${JSON.stringify(result, null, 2)}
                     },
                     ...overwriteExistingFiles && {
                         overwriteExistingFiles
+                    },
+                    ...locale && {
+                        locale
+                    },
+                    ...fallbackLocale && {
+                        fallbackLocale
                     }
                 };
                 if (verboseLogs) {
@@ -183,21 +195,27 @@ ${JSON.stringify(errors, null, 2)}
     if (collections?.[collectionSlug]?.enabled) {
         const convertedFields = convertCollectionSchemaToZod(schema);
         // Create a new schema that combines the converted fields with update-specific parameters
+        // Use .partial() to make all fields optional for partial updates
         const updateResourceSchema = z.object({
-            ...convertedFields.shape,
-            id: z.string().optional().describe('The ID of the document to update'),
+            ...convertedFields.partial().shape,
+            id: z.union([
+                z.string(),
+                z.number()
+            ]).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'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
             filePath: z.string().optional().describe('File path for file uploads'),
+            locale: z.string().optional().describe('Optional: locale code to update the document in (e.g., "en", "es"). Defaults to the default locale'),
             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)}`, `${collections?.[collectionSlug]?.description || toolSchemas.updateResource.description.trim()}`, updateResourceSchema.shape, async (params)=>{
-            const { id, depth, draft, filePath, overrideLock, overwriteExistingFiles, where, ...fieldData } = params;
+            const { id, depth, draft, fallbackLocale, filePath, locale, 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);
+            return await tool(data, id, where, draft, depth, overrideLock, filePath, overwriteExistingFiles, locale, fallbackLocale);
         });
     }
 };

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

@@ -1 +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          overrideAccess: false,\n          overrideLock,\n          req,\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: 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: false,\n          overrideLock,\n          req,\n          user,\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: 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      `${collections?.[collectionSlug]?.description || toolSchemas.updateResource.description.trim()}`,\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","overrideAccess","result","update","bulkResult","docs","errors","length","responseText","errorMessage","Error","message","enabled","convertedFields","updateResourceSchema","object","shape","string","optional","describe","number","default","boolean","charAt","toUpperCase","slice","description","updateResource","trim","params","fieldData"],"mappings":"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"}
+{"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?: number | string,\n    where?: string,\n    draft: boolean = false,\n    depth: number = 0,\n    overrideLock: boolean = true,\n    filePath?: string,\n    overwriteExistingFiles: boolean = false,\n    locale?: string,\n    fallbackLocale?: 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] Updating resource in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`,\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          overrideAccess: false,\n          overrideLock,\n          req,\n          user,\n          ...(filePath && { filePath }),\n          ...(overwriteExistingFiles && { overwriteExistingFiles }),\n          ...(locale && { locale }),\n          ...(fallbackLocale && { fallbackLocale }),\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: 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: false,\n          overrideLock,\n          req,\n          user,\n          where: whereClause,\n          ...(filePath && { filePath }),\n          ...(overwriteExistingFiles && { overwriteExistingFiles }),\n          ...(locale && { locale }),\n          ...(fallbackLocale && { fallbackLocale }),\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: 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    // Use .partial() to make all fields optional for partial updates\n    const updateResourceSchema = z.object({\n      ...convertedFields.partial().shape,\n      id: z.union([z.string(), z.number()]).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      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      filePath: z.string().optional().describe('File path for file uploads'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to update the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\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      `${collections?.[collectionSlug]?.description || toolSchemas.updateResource.description.trim()}`,\n      updateResourceSchema.shape,\n      async (params: Record<string, unknown>) => {\n        const {\n          id,\n          depth,\n          draft,\n          fallbackLocale,\n          filePath,\n          locale,\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 number | 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          locale as string | undefined,\n          fallbackLocale as string | undefined,\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","locale","fallbackLocale","payload","logger","info","parsedData","JSON","parse","stringify","_parseError","error","response","content","type","text","overrideResponse","whereClause","updateOptions","collection","overrideAccess","result","update","bulkResult","docs","errors","length","responseText","errorMessage","Error","message","enabled","convertedFields","updateResourceSchema","object","partial","shape","union","string","number","optional","describe","default","boolean","charAt","toUpperCase","slice","description","updateResource","trim","params","fieldData"],"mappings":"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"}

package/dist/mcp/tools/schemas.d.ts

@@ -3,8 +3,10 @@ export declare const toolSchemas: {
     findResources: {
         description: string;
         parameters: z.ZodObject<{
-            id: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fallbackLocale: z.ZodOptional<z.ZodString>;
             limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            locale: z.ZodOptional<z.ZodString>;
             page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             sort: z.ZodOptional<z.ZodString>;
             where: z.ZodOptional<z.ZodString>;
@@ -12,11 +14,15 @@ export declare const toolSchemas: {
             limit: number;
             page: number;
             sort?: string | undefined;
-            id?: string | undefined;
+            locale?: string | undefined;
+            id?: string | number | undefined;
+            fallbackLocale?: string | undefined;
             where?: string | undefined;
         }, {
             sort?: string | undefined;
-            id?: string | undefined;
+            locale?: string | undefined;
+            id?: string | number | undefined;
+            fallbackLocale?: string | undefined;
             limit?: number | undefined;
             page?: number | undefined;
             where?: string | undefined;
@@ -27,22 +33,30 @@ export declare const toolSchemas: {
         parameters: z.ZodObject<{
             data: z.ZodString;
             draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            fallbackLocale: z.ZodOptional<z.ZodString>;
+            locale: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             draft: boolean;
             data: string;
+            locale?: string | undefined;
+            fallbackLocale?: string | undefined;
         }, {
             data: string;
+            locale?: string | undefined;
             draft?: boolean | undefined;
+            fallbackLocale?: string | undefined;
         }>;
     };
     updateResource: {
         description: string;
         parameters: z.ZodObject<{
-            id: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
             data: z.ZodString;
             depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            fallbackLocale: z.ZodOptional<z.ZodString>;
             filePath: z.ZodOptional<z.ZodString>;
+            locale: z.ZodOptional<z.ZodString>;
             overrideLock: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             overwriteExistingFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             where: z.ZodOptional<z.ZodString>;
@@ -52,14 +66,18 @@ export declare const toolSchemas: {
             data: string;
             overrideLock: boolean;
             overwriteExistingFiles: boolean;
-            id?: string | undefined;
+            locale?: string | undefined;
+            id?: string | number | undefined;
+            fallbackLocale?: string | undefined;
             where?: string | undefined;
             filePath?: string | undefined;
         }, {
             data: string;
             depth?: number | undefined;
+            locale?: string | undefined;
             draft?: boolean | undefined;
-            id?: string | undefined;
+            id?: string | number | undefined;
+            fallbackLocale?: string | undefined;
             where?: string | undefined;
             filePath?: string | undefined;
             overrideLock?: boolean | undefined;
@@ -69,16 +87,22 @@ export declare const toolSchemas: {
     deleteResource: {
         description: string;
         parameters: z.ZodObject<{
-            id: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
             depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            fallbackLocale: z.ZodOptional<z.ZodString>;
+            locale: z.ZodOptional<z.ZodString>;
             where: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             depth: number;
-            id?: string | undefined;
+            locale?: string | undefined;
+            id?: string | number | undefined;
+            fallbackLocale?: string | undefined;
             where?: string | undefined;
         }, {
             depth?: number | undefined;
-            id?: string | undefined;
+            locale?: string | undefined;
+            id?: string | number | undefined;
+            fallbackLocale?: string | undefined;
             where?: string | undefined;
         }>;
     };

package/dist/mcp/tools/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkXvB,CAAA"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgavB,CAAA"}

package/dist/mcp/tools/schemas.js

@@ -3,8 +3,13 @@ export const toolSchemas = {
     findResources: {
         description: 'Find documents in a collection by ID or where clause using Find or FindByID.',
         parameters: z.object({
-            id: z.string().optional().describe('Optional: specific document ID to retrieve. If not provided, returns all documents'),
+            id: z.union([
+                z.string(),
+                z.number()
+            ]).optional().describe('Optional: specific document ID to retrieve. If not provided, returns all documents'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
             limit: z.number().int().min(1, 'Limit must be at least 1').max(100, 'Limit cannot exceed 100').optional().default(10).describe('Maximum number of documents to return (default: 10, max: 100)'),
+            locale: z.string().optional().describe('Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields'),
             page: z.number().int().min(1, 'Page must be at least 1').optional().default(1).describe('Page number for pagination (default: 1)'),
             sort: z.string().optional().describe('Field to sort by (e.g., "createdAt", "-updatedAt" for descending)'),
             where: z.string().optional().describe('Optional JSON string for where clause filtering (e.g., \'{"title": {"contains": "test"}}\')')
@@ -14,17 +19,24 @@ export const toolSchemas = {
         description: 'Create a document in a collection.',
         parameters: z.object({
             data: z.string().describe('JSON string containing the data for the new document'),
-            draft: z.boolean().optional().default(false).describe('Whether to create the document as a draft')
+            draft: z.boolean().optional().default(false).describe('Whether to create the document as a draft'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
+            locale: z.string().optional().describe('Optional: locale code to create the document in (e.g., "en", "es"). Defaults to the default locale')
         })
     },
     updateResource: {
         description: 'Update documents in a collection by ID or where clause.',
         parameters: z.object({
-            id: z.string().optional().describe('Optional: specific document ID to update'),
+            id: z.union([
+                z.string(),
+                z.number()
+            ]).optional().describe('Optional: specific document ID to update'),
             data: z.string().describe('JSON string containing the data to update'),
             depth: z.number().int().min(0).max(10).optional().default(0).describe('Depth of population for relationships'),
             draft: z.boolean().optional().default(false).describe('Whether to update as a draft'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
             filePath: z.string().optional().describe('Optional: absolute file path for file uploads'),
+            locale: z.string().optional().describe('Optional: locale code to update the document in (e.g., "en", "es"). Defaults to the default locale'),
             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('Optional: JSON string for where clause to update multiple documents')
@@ -33,8 +45,13 @@ export const toolSchemas = {
     deleteResource: {
         description: 'Delete documents in a collection by ID or where clause.',
         parameters: z.object({
-            id: z.string().optional().describe('Optional: specific document ID to delete'),
+            id: z.union([
+                z.string(),
+                z.number()
+            ]).optional().describe('Optional: specific document ID to delete'),
             depth: z.number().int().min(0).max(10).optional().default(0).describe('Depth of population for relationships in response'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
+            locale: z.string().optional().describe('Optional: locale code for the operation (e.g., "en", "es"). Defaults to the default locale'),
             where: z.string().optional().describe('Optional: JSON string for where clause to delete multiple documents')
         })
     },