@payloadcms/plugin-mcp 4.0.0-internal.5b1e7cd → 4.0.0-internal.5d2e3d1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (446) hide show
  1. package/LICENSE.md +1 -1
  2. package/bin.js +39 -0
  3. package/dist/defaultAccess.d.ts +3 -0
  4. package/dist/defaultAccess.d.ts.map +1 -0
  5. package/dist/defaultAccess.js +3 -0
  6. package/dist/defaultAccess.js.map +1 -0
  7. package/dist/defineTool.d.ts +26 -0
  8. package/dist/defineTool.d.ts.map +1 -0
  9. package/dist/defineTool.js +37 -0
  10. package/dist/defineTool.js.map +1 -0
  11. package/dist/endpoint/access.d.ts +22 -0
  12. package/dist/endpoint/access.d.ts.map +1 -0
  13. package/dist/endpoint/access.js +130 -0
  14. package/dist/endpoint/access.js.map +1 -0
  15. package/dist/endpoint/index.d.ts +3 -0
  16. package/dist/endpoint/index.d.ts.map +1 -0
  17. package/dist/endpoint/index.js +141 -0
  18. package/dist/endpoint/index.js.map +1 -0
  19. package/dist/endpoint/oauth.d.ts +37 -0
  20. package/dist/endpoint/oauth.d.ts.map +1 -0
  21. package/dist/endpoint/oauth.js +105 -0
  22. package/dist/endpoint/oauth.js.map +1 -0
  23. package/dist/endpoint/oauthLoginToken.d.ts +23 -0
  24. package/dist/endpoint/oauthLoginToken.d.ts.map +1 -0
  25. package/dist/endpoint/oauthLoginToken.js +80 -0
  26. package/dist/endpoint/oauthLoginToken.js.map +1 -0
  27. package/dist/endpoint/oauthServer.d.ts +28 -0
  28. package/dist/endpoint/oauthServer.d.ts.map +1 -0
  29. package/dist/endpoint/oauthServer.js +423 -0
  30. package/dist/endpoint/oauthServer.js.map +1 -0
  31. package/dist/exports/client.d.ts +2 -0
  32. package/dist/exports/client.d.ts.map +1 -0
  33. package/dist/exports/client.js +4 -0
  34. package/dist/exports/client.js.map +1 -0
  35. package/dist/exports/internal.d.ts +2 -0
  36. package/dist/exports/internal.d.ts.map +1 -0
  37. package/dist/exports/internal.js +3 -0
  38. package/dist/exports/internal.js.map +1 -0
  39. package/dist/exports/rsc.d.ts +2 -0
  40. package/dist/exports/rsc.d.ts.map +1 -0
  41. package/dist/exports/rsc.js +3 -0
  42. package/dist/exports/rsc.js.map +1 -0
  43. package/dist/index.d.ts +14 -9
  44. package/dist/index.d.ts.map +1 -1
  45. package/dist/index.js +63 -67
  46. package/dist/index.js.map +1 -1
  47. package/dist/mcp/buildMcpServer.d.ts +19 -0
  48. package/dist/mcp/buildMcpServer.d.ts.map +1 -0
  49. package/dist/mcp/buildMcpServer.js +235 -0
  50. package/dist/mcp/buildMcpServer.js.map +1 -0
  51. package/dist/mcp/builtin/collections/authTools.d.ts +7 -0
  52. package/dist/mcp/builtin/collections/authTools.d.ts.map +1 -0
  53. package/dist/mcp/builtin/collections/authTools.js +312 -0
  54. package/dist/mcp/builtin/collections/authTools.js.map +1 -0
  55. package/dist/mcp/builtin/collections/countTool.d.ts +2 -0
  56. package/dist/mcp/builtin/collections/countTool.d.ts.map +1 -0
  57. package/dist/mcp/builtin/collections/countTool.js +63 -0
  58. package/dist/mcp/builtin/collections/countTool.js.map +1 -0
  59. package/dist/mcp/builtin/collections/countVersionsTool.d.ts +2 -0
  60. package/dist/mcp/builtin/collections/countVersionsTool.d.ts.map +1 -0
  61. package/dist/mcp/builtin/collections/countVersionsTool.js +60 -0
  62. package/dist/mcp/builtin/collections/countVersionsTool.js.map +1 -0
  63. package/dist/mcp/builtin/collections/createTool.d.ts +2 -0
  64. package/dist/mcp/builtin/collections/createTool.d.ts.map +1 -0
  65. package/dist/mcp/builtin/collections/createTool.js +137 -0
  66. package/dist/mcp/builtin/collections/createTool.js.map +1 -0
  67. package/dist/mcp/builtin/collections/deleteTool.d.ts +2 -0
  68. package/dist/mcp/builtin/collections/deleteTool.d.ts.map +1 -0
  69. package/dist/mcp/builtin/collections/deleteTool.js +113 -0
  70. package/dist/mcp/builtin/collections/deleteTool.js.map +1 -0
  71. package/dist/mcp/builtin/collections/duplicateTool.d.ts +2 -0
  72. package/dist/mcp/builtin/collections/duplicateTool.d.ts.map +1 -0
  73. package/dist/mcp/builtin/collections/duplicateTool.js +90 -0
  74. package/dist/mcp/builtin/collections/duplicateTool.js.map +1 -0
  75. package/dist/mcp/builtin/collections/fileInput.d.ts +28 -0
  76. package/dist/mcp/builtin/collections/fileInput.d.ts.map +1 -0
  77. package/dist/mcp/builtin/collections/fileInput.js +88 -0
  78. package/dist/mcp/builtin/collections/fileInput.js.map +1 -0
  79. package/dist/mcp/builtin/collections/findDistinctTool.d.ts +2 -0
  80. package/dist/mcp/builtin/collections/findDistinctTool.d.ts.map +1 -0
  81. package/dist/mcp/builtin/collections/findDistinctTool.js +77 -0
  82. package/dist/mcp/builtin/collections/findDistinctTool.js.map +1 -0
  83. package/dist/mcp/builtin/collections/findTool.d.ts +2 -0
  84. package/dist/mcp/builtin/collections/findTool.d.ts.map +1 -0
  85. package/dist/mcp/builtin/collections/findTool.js +146 -0
  86. package/dist/mcp/builtin/collections/findTool.js.map +1 -0
  87. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts +2 -0
  88. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts.map +1 -0
  89. package/dist/mcp/builtin/collections/findVersionByIDTool.js +74 -0
  90. package/dist/mcp/builtin/collections/findVersionByIDTool.js.map +1 -0
  91. package/dist/mcp/builtin/collections/findVersionsTool.d.ts +2 -0
  92. package/dist/mcp/builtin/collections/findVersionsTool.d.ts.map +1 -0
  93. package/dist/mcp/builtin/collections/findVersionsTool.js +84 -0
  94. package/dist/mcp/builtin/collections/findVersionsTool.js.map +1 -0
  95. package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts +2 -0
  96. package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts.map +1 -0
  97. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js +103 -0
  98. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js.map +1 -0
  99. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts +2 -0
  100. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts.map +1 -0
  101. package/dist/mcp/builtin/collections/restoreVersionTool.js +69 -0
  102. package/dist/mcp/builtin/collections/restoreVersionTool.js.map +1 -0
  103. package/dist/mcp/builtin/collections/updateTool.d.ts +2 -0
  104. package/dist/mcp/builtin/collections/updateTool.d.ts.map +1 -0
  105. package/dist/mcp/builtin/collections/updateTool.js +172 -0
  106. package/dist/mcp/builtin/collections/updateTool.js.map +1 -0
  107. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts +2 -0
  108. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map +1 -0
  109. package/dist/mcp/builtin/collections/uploadInstructionsTool.js +55 -0
  110. package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map +1 -0
  111. package/dist/mcp/builtin/formatEntityError.d.ts +16 -0
  112. package/dist/mcp/builtin/formatEntityError.d.ts.map +1 -0
  113. package/dist/mcp/builtin/formatEntityError.js +55 -0
  114. package/dist/mcp/builtin/formatEntityError.js.map +1 -0
  115. package/dist/mcp/builtin/getConfigInfoTool.d.ts +2 -0
  116. package/dist/mcp/builtin/getConfigInfoTool.d.ts.map +1 -0
  117. package/dist/mcp/builtin/getConfigInfoTool.js +69 -0
  118. package/dist/mcp/builtin/getConfigInfoTool.js.map +1 -0
  119. package/dist/mcp/builtin/globals/countVersionsTool.d.ts +2 -0
  120. package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map +1 -0
  121. package/dist/mcp/builtin/globals/countVersionsTool.js +60 -0
  122. package/dist/mcp/builtin/globals/countVersionsTool.js.map +1 -0
  123. package/dist/mcp/builtin/globals/findTool.d.ts +2 -0
  124. package/dist/mcp/builtin/globals/findTool.d.ts.map +1 -0
  125. package/dist/mcp/builtin/globals/findTool.js +67 -0
  126. package/dist/mcp/builtin/globals/findTool.js.map +1 -0
  127. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts +2 -0
  128. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map +1 -0
  129. package/dist/mcp/builtin/globals/findVersionByIDTool.js +68 -0
  130. package/dist/mcp/builtin/globals/findVersionByIDTool.js.map +1 -0
  131. package/dist/mcp/builtin/globals/findVersionsTool.d.ts +2 -0
  132. package/dist/mcp/builtin/globals/findVersionsTool.d.ts.map +1 -0
  133. package/dist/mcp/builtin/globals/findVersionsTool.js +78 -0
  134. package/dist/mcp/builtin/globals/findVersionsTool.js.map +1 -0
  135. package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts +2 -0
  136. package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts.map +1 -0
  137. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js +81 -0
  138. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js.map +1 -0
  139. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts +2 -0
  140. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts.map +1 -0
  141. package/dist/mcp/builtin/globals/restoreVersionTool.js +70 -0
  142. package/dist/mcp/builtin/globals/restoreVersionTool.js.map +1 -0
  143. package/dist/mcp/builtin/globals/updateTool.d.ts +2 -0
  144. package/dist/mcp/builtin/globals/updateTool.d.ts.map +1 -0
  145. package/dist/mcp/builtin/globals/updateTool.js +78 -0
  146. package/dist/mcp/builtin/globals/updateTool.js.map +1 -0
  147. package/dist/mcp/builtinTools.d.ts +168 -0
  148. package/dist/mcp/builtinTools.d.ts.map +1 -0
  149. package/dist/mcp/builtinTools.js +169 -0
  150. package/dist/mcp/builtinTools.js.map +1 -0
  151. package/dist/mcp/sanitizeMCPConfig.d.ts +16 -0
  152. package/dist/mcp/sanitizeMCPConfig.d.ts.map +1 -0
  153. package/dist/mcp/sanitizeMCPConfig.js +236 -0
  154. package/dist/mcp/sanitizeMCPConfig.js.map +1 -0
  155. package/dist/stdio.d.ts +8 -0
  156. package/dist/stdio.d.ts.map +1 -0
  157. package/dist/stdio.js +128 -0
  158. package/dist/stdio.js.map +1 -0
  159. package/dist/types.d.ts +352 -441
  160. package/dist/types.d.ts.map +1 -1
  161. package/dist/types.js +4 -1
  162. package/dist/types.js.map +1 -1
  163. package/dist/utils/getLogger.d.ts +10 -0
  164. package/dist/utils/getLogger.d.ts.map +1 -0
  165. package/dist/utils/getLogger.js +22 -0
  166. package/dist/utils/getLogger.js.map +1 -0
  167. package/dist/utils/getPluginConfig.d.ts +12 -0
  168. package/dist/utils/getPluginConfig.d.ts.map +1 -0
  169. package/dist/utils/getPluginConfig.js +15 -0
  170. package/dist/utils/getPluginConfig.js.map +1 -0
  171. package/dist/utils/resolveProjectRoot.d.ts +7 -0
  172. package/dist/utils/resolveProjectRoot.d.ts.map +1 -0
  173. package/dist/utils/resolveProjectRoot.js +15 -0
  174. package/dist/utils/resolveProjectRoot.js.map +1 -0
  175. package/dist/utils/seal.d.ts +17 -0
  176. package/dist/utils/seal.d.ts.map +1 -0
  177. package/dist/utils/seal.js +24 -0
  178. package/dist/utils/seal.js.map +1 -0
  179. package/dist/utils/toStandardSchema.d.ts +5 -0
  180. package/dist/utils/toStandardSchema.d.ts.map +1 -0
  181. package/dist/utils/toStandardSchema.js +4 -0
  182. package/dist/utils/toStandardSchema.js.map +1 -0
  183. package/dist/views/Authorize/AllowButtons/index.d.ts +18 -0
  184. package/dist/views/Authorize/AllowButtons/index.d.ts.map +1 -0
  185. package/dist/views/Authorize/AllowButtons/index.js +88 -0
  186. package/dist/views/Authorize/AllowButtons/index.js.map +1 -0
  187. package/dist/views/Authorize/index.css +19 -0
  188. package/dist/views/Authorize/index.d.ts +9 -0
  189. package/dist/views/Authorize/index.d.ts.map +1 -0
  190. package/dist/views/Authorize/index.js +86 -0
  191. package/dist/views/Authorize/index.js.map +1 -0
  192. package/package.json +48 -26
  193. package/src/defaultAccess.ts +3 -0
  194. package/src/defineTool.ts +44 -0
  195. package/src/endpoint/access.ts +153 -0
  196. package/src/endpoint/index.ts +123 -0
  197. package/src/endpoint/oauth.ts +108 -0
  198. package/src/endpoint/oauthLoginToken.ts +94 -0
  199. package/src/endpoint/oauthServer.ts +452 -0
  200. package/src/exports/client.ts +3 -0
  201. package/src/exports/internal.ts +1 -0
  202. package/src/exports/rsc.ts +1 -0
  203. package/src/index.ts +74 -88
  204. package/src/mcp/buildMcpServer.ts +294 -0
  205. package/src/mcp/builtin/collections/authTools.ts +280 -0
  206. package/src/mcp/builtin/collections/countTool.ts +61 -0
  207. package/src/mcp/builtin/collections/countVersionsTool.ts +60 -0
  208. package/src/mcp/builtin/collections/createTool.ts +143 -0
  209. package/src/mcp/builtin/collections/deleteTool.ts +99 -0
  210. package/src/mcp/builtin/collections/duplicateTool.ts +84 -0
  211. package/src/mcp/builtin/collections/fileInput.spec.ts +93 -0
  212. package/src/mcp/builtin/collections/fileInput.ts +127 -0
  213. package/src/mcp/builtin/collections/findDistinctTool.ts +67 -0
  214. package/src/mcp/builtin/collections/findTool.ts +134 -0
  215. package/src/mcp/builtin/collections/findVersionByIDTool.ts +66 -0
  216. package/src/mcp/builtin/collections/findVersionsTool.ts +83 -0
  217. package/src/mcp/builtin/collections/getCollectionSchemaTool.ts +91 -0
  218. package/src/mcp/builtin/collections/restoreVersionTool.ts +65 -0
  219. package/src/mcp/builtin/collections/updateTool.ts +173 -0
  220. package/src/mcp/builtin/collections/uploadInstructionsTool.ts +64 -0
  221. package/src/mcp/builtin/formatEntityError.ts +77 -0
  222. package/src/mcp/builtin/getConfigInfoTool.ts +68 -0
  223. package/src/mcp/builtin/globals/countVersionsTool.ts +60 -0
  224. package/src/mcp/builtin/globals/findTool.ts +66 -0
  225. package/src/mcp/builtin/globals/findVersionByIDTool.ts +64 -0
  226. package/src/mcp/builtin/globals/findVersionsTool.ts +69 -0
  227. package/src/mcp/builtin/globals/getGlobalSchemaTool.ts +73 -0
  228. package/src/mcp/builtin/globals/restoreVersionTool.ts +68 -0
  229. package/src/mcp/builtin/globals/updateTool.ts +92 -0
  230. package/src/mcp/builtinTools.ts +161 -0
  231. package/src/mcp/sanitizeMCPConfig.ts +282 -0
  232. package/src/stdio.ts +131 -0
  233. package/src/types.ts +401 -481
  234. package/src/utils/getLogger.ts +22 -0
  235. package/src/utils/getPluginConfig.ts +24 -0
  236. package/src/utils/resolveProjectRoot.ts +17 -0
  237. package/src/utils/seal.ts +46 -0
  238. package/src/utils/toStandardSchema.ts +9 -0
  239. package/src/views/Authorize/AllowButtons/index.tsx +97 -0
  240. package/src/views/Authorize/index.css +19 -0
  241. package/src/views/Authorize/index.tsx +93 -0
  242. package/dist/collections/createApiKeysCollection.d.ts +0 -7
  243. package/dist/collections/createApiKeysCollection.d.ts.map +0 -1
  244. package/dist/collections/createApiKeysCollection.js +0 -317
  245. package/dist/collections/createApiKeysCollection.js.map +0 -1
  246. package/dist/defaults.d.ts +0 -4
  247. package/dist/defaults.d.ts.map +0 -1
  248. package/dist/defaults.js +0 -5
  249. package/dist/defaults.js.map +0 -1
  250. package/dist/endpoints/mcp.d.ts +0 -4
  251. package/dist/endpoints/mcp.d.ts.map +0 -1
  252. package/dist/endpoints/mcp.js +0 -71
  253. package/dist/endpoints/mcp.js.map +0 -1
  254. package/dist/mcp/createRequest.d.ts +0 -3
  255. package/dist/mcp/createRequest.d.ts.map +0 -1
  256. package/dist/mcp/createRequest.js +0 -14
  257. package/dist/mcp/createRequest.js.map +0 -1
  258. package/dist/mcp/getMcpHandler.d.ts +0 -4
  259. package/dist/mcp/getMcpHandler.d.ts.map +0 -1
  260. package/dist/mcp/getMcpHandler.js +0 -231
  261. package/dist/mcp/getMcpHandler.js.map +0 -1
  262. package/dist/mcp/helpers/config.d.ts +0 -22
  263. package/dist/mcp/helpers/config.d.ts.map +0 -1
  264. package/dist/mcp/helpers/config.js +0 -153
  265. package/dist/mcp/helpers/config.js.map +0 -1
  266. package/dist/mcp/helpers/fields.d.ts +0 -19
  267. package/dist/mcp/helpers/fields.d.ts.map +0 -1
  268. package/dist/mcp/helpers/fields.js +0 -102
  269. package/dist/mcp/helpers/fields.js.map +0 -1
  270. package/dist/mcp/helpers/fileValidation.d.ts +0 -67
  271. package/dist/mcp/helpers/fileValidation.d.ts.map +0 -1
  272. package/dist/mcp/helpers/fileValidation.js +0 -267
  273. package/dist/mcp/helpers/fileValidation.js.map +0 -1
  274. package/dist/mcp/registerTool.d.ts +0 -6
  275. package/dist/mcp/registerTool.d.ts.map +0 -1
  276. package/dist/mcp/registerTool.js +0 -18
  277. package/dist/mcp/registerTool.js.map +0 -1
  278. package/dist/mcp/tools/auth/auth.d.ts +0 -4
  279. package/dist/mcp/tools/auth/auth.d.ts.map +0 -1
  280. package/dist/mcp/tools/auth/auth.js +0 -57
  281. package/dist/mcp/tools/auth/auth.js.map +0 -1
  282. package/dist/mcp/tools/auth/forgotPassword.d.ts +0 -4
  283. package/dist/mcp/tools/auth/forgotPassword.d.ts.map +0 -1
  284. package/dist/mcp/tools/auth/forgotPassword.js +0 -48
  285. package/dist/mcp/tools/auth/forgotPassword.js.map +0 -1
  286. package/dist/mcp/tools/auth/login.d.ts +0 -4
  287. package/dist/mcp/tools/auth/login.d.ts.map +0 -1
  288. package/dist/mcp/tools/auth/login.js +0 -51
  289. package/dist/mcp/tools/auth/login.js.map +0 -1
  290. package/dist/mcp/tools/auth/resetPassword.d.ts +0 -4
  291. package/dist/mcp/tools/auth/resetPassword.d.ts.map +0 -1
  292. package/dist/mcp/tools/auth/resetPassword.js +0 -49
  293. package/dist/mcp/tools/auth/resetPassword.js.map +0 -1
  294. package/dist/mcp/tools/auth/unlock.d.ts +0 -4
  295. package/dist/mcp/tools/auth/unlock.d.ts.map +0 -1
  296. package/dist/mcp/tools/auth/unlock.js +0 -48
  297. package/dist/mcp/tools/auth/unlock.js.map +0 -1
  298. package/dist/mcp/tools/auth/verify.d.ts +0 -4
  299. package/dist/mcp/tools/auth/verify.d.ts.map +0 -1
  300. package/dist/mcp/tools/auth/verify.js +0 -45
  301. package/dist/mcp/tools/auth/verify.js.map +0 -1
  302. package/dist/mcp/tools/collection/create.d.ts +0 -10
  303. package/dist/mcp/tools/collection/create.d.ts.map +0 -1
  304. package/dist/mcp/tools/collection/create.js +0 -139
  305. package/dist/mcp/tools/collection/create.js.map +0 -1
  306. package/dist/mcp/tools/collection/delete.d.ts +0 -10
  307. package/dist/mcp/tools/collection/delete.d.ts.map +0 -1
  308. package/dist/mcp/tools/collection/delete.js +0 -154
  309. package/dist/mcp/tools/collection/delete.js.map +0 -1
  310. package/dist/mcp/tools/collection/find.d.ts +0 -10
  311. package/dist/mcp/tools/collection/find.d.ts.map +0 -1
  312. package/dist/mcp/tools/collection/find.js +0 -165
  313. package/dist/mcp/tools/collection/find.js.map +0 -1
  314. package/dist/mcp/tools/collection/update.d.ts +0 -10
  315. package/dist/mcp/tools/collection/update.d.ts.map +0 -1
  316. package/dist/mcp/tools/collection/update.js +0 -209
  317. package/dist/mcp/tools/collection/update.js.map +0 -1
  318. package/dist/mcp/tools/config/find.d.ts +0 -10
  319. package/dist/mcp/tools/config/find.d.ts.map +0 -1
  320. package/dist/mcp/tools/config/find.js +0 -97
  321. package/dist/mcp/tools/config/find.js.map +0 -1
  322. package/dist/mcp/tools/config/update.d.ts +0 -10
  323. package/dist/mcp/tools/config/update.d.ts.map +0 -1
  324. package/dist/mcp/tools/config/update.js +0 -215
  325. package/dist/mcp/tools/config/update.js.map +0 -1
  326. package/dist/mcp/tools/global/find.d.ts +0 -5
  327. package/dist/mcp/tools/global/find.d.ts.map +0 -1
  328. package/dist/mcp/tools/global/find.js +0 -82
  329. package/dist/mcp/tools/global/find.js.map +0 -1
  330. package/dist/mcp/tools/global/update.d.ts +0 -6
  331. package/dist/mcp/tools/global/update.d.ts.map +0 -1
  332. package/dist/mcp/tools/global/update.js +0 -124
  333. package/dist/mcp/tools/global/update.js.map +0 -1
  334. package/dist/mcp/tools/job/create.d.ts +0 -10
  335. package/dist/mcp/tools/job/create.d.ts.map +0 -1
  336. package/dist/mcp/tools/job/create.js +0 -293
  337. package/dist/mcp/tools/job/create.js.map +0 -1
  338. package/dist/mcp/tools/job/run.d.ts +0 -10
  339. package/dist/mcp/tools/job/run.d.ts.map +0 -1
  340. package/dist/mcp/tools/job/run.js +0 -129
  341. package/dist/mcp/tools/job/run.js.map +0 -1
  342. package/dist/mcp/tools/job/update.d.ts +0 -11
  343. package/dist/mcp/tools/job/update.d.ts.map +0 -1
  344. package/dist/mcp/tools/job/update.js +0 -186
  345. package/dist/mcp/tools/job/update.js.map +0 -1
  346. package/dist/mcp/tools/resource/create.d.ts +0 -6
  347. package/dist/mcp/tools/resource/create.d.ts.map +0 -1
  348. package/dist/mcp/tools/resource/create.js +0 -124
  349. package/dist/mcp/tools/resource/create.js.map +0 -1
  350. package/dist/mcp/tools/resource/delete.d.ts +0 -5
  351. package/dist/mcp/tools/resource/delete.d.ts.map +0 -1
  352. package/dist/mcp/tools/resource/delete.js +0 -151
  353. package/dist/mcp/tools/resource/delete.js.map +0 -1
  354. package/dist/mcp/tools/resource/find.d.ts +0 -5
  355. package/dist/mcp/tools/resource/find.d.ts.map +0 -1
  356. package/dist/mcp/tools/resource/find.js +0 -170
  357. package/dist/mcp/tools/resource/find.js.map +0 -1
  358. package/dist/mcp/tools/resource/update.d.ts +0 -6
  359. package/dist/mcp/tools/resource/update.d.ts.map +0 -1
  360. package/dist/mcp/tools/resource/update.js +0 -256
  361. package/dist/mcp/tools/resource/update.js.map +0 -1
  362. package/dist/mcp/tools/schemas.d.ts +0 -457
  363. package/dist/mcp/tools/schemas.d.ts.map +0 -1
  364. package/dist/mcp/tools/schemas.js +0 -243
  365. package/dist/mcp/tools/schemas.js.map +0 -1
  366. package/dist/utils/adminEntitySettings.d.ts +0 -17
  367. package/dist/utils/adminEntitySettings.d.ts.map +0 -1
  368. package/dist/utils/adminEntitySettings.js +0 -41
  369. package/dist/utils/adminEntitySettings.js.map +0 -1
  370. package/dist/utils/createApiKeyFields.d.ts +0 -15
  371. package/dist/utils/createApiKeyFields.d.ts.map +0 -1
  372. package/dist/utils/createApiKeyFields.js +0 -57
  373. package/dist/utils/createApiKeyFields.js.map +0 -1
  374. package/dist/utils/getEnabledSlugs.d.ts +0 -13
  375. package/dist/utils/getEnabledSlugs.d.ts.map +0 -1
  376. package/dist/utils/getEnabledSlugs.js +0 -32
  377. package/dist/utils/getEnabledSlugs.js.map +0 -1
  378. package/dist/utils/getVirtualFieldNames.d.ts +0 -14
  379. package/dist/utils/getVirtualFieldNames.d.ts.map +0 -1
  380. package/dist/utils/getVirtualFieldNames.js +0 -35
  381. package/dist/utils/getVirtualFieldNames.js.map +0 -1
  382. package/dist/utils/schemaConversion/convertCollectionSchemaToZod.d.ts +0 -3
  383. package/dist/utils/schemaConversion/convertCollectionSchemaToZod.d.ts.map +0 -1
  384. package/dist/utils/schemaConversion/convertCollectionSchemaToZod.js +0 -43
  385. package/dist/utils/schemaConversion/convertCollectionSchemaToZod.js.map +0 -1
  386. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts +0 -7
  387. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts.map +0 -1
  388. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js +0 -20
  389. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js.map +0 -1
  390. package/dist/utils/schemaConversion/sanitizeJsonSchema.d.ts +0 -13
  391. package/dist/utils/schemaConversion/sanitizeJsonSchema.d.ts.map +0 -1
  392. package/dist/utils/schemaConversion/sanitizeJsonSchema.js +0 -56
  393. package/dist/utils/schemaConversion/sanitizeJsonSchema.js.map +0 -1
  394. package/dist/utils/schemaConversion/simplifyRelationshipFields.d.ts +0 -20
  395. package/dist/utils/schemaConversion/simplifyRelationshipFields.d.ts.map +0 -1
  396. package/dist/utils/schemaConversion/simplifyRelationshipFields.js +0 -53
  397. package/dist/utils/schemaConversion/simplifyRelationshipFields.js.map +0 -1
  398. package/dist/utils/schemaConversion/transformPointFields.d.ts +0 -3
  399. package/dist/utils/schemaConversion/transformPointFields.d.ts.map +0 -1
  400. package/dist/utils/schemaConversion/transformPointFields.js +0 -51
  401. package/dist/utils/schemaConversion/transformPointFields.js.map +0 -1
  402. package/dist/utils/transformPointDataToPayload.d.ts +0 -7
  403. package/dist/utils/transformPointDataToPayload.d.ts.map +0 -1
  404. package/dist/utils/transformPointDataToPayload.js +0 -28
  405. package/dist/utils/transformPointDataToPayload.js.map +0 -1
  406. package/src/collections/createApiKeysCollection.ts +0 -373
  407. package/src/defaults.ts +0 -3
  408. package/src/endpoints/mcp.ts +0 -91
  409. package/src/mcp/createRequest.ts +0 -13
  410. package/src/mcp/getMcpHandler.ts +0 -545
  411. package/src/mcp/helpers/config.ts +0 -213
  412. package/src/mcp/helpers/fields.ts +0 -154
  413. package/src/mcp/helpers/fileValidation.ts +0 -362
  414. package/src/mcp/registerTool.ts +0 -22
  415. package/src/mcp/tools/auth/auth.ts +0 -71
  416. package/src/mcp/tools/auth/forgotPassword.ts +0 -70
  417. package/src/mcp/tools/auth/login.ts +0 -72
  418. package/src/mcp/tools/auth/resetPassword.ts +0 -61
  419. package/src/mcp/tools/auth/unlock.ts +0 -64
  420. package/src/mcp/tools/auth/verify.ts +0 -57
  421. package/src/mcp/tools/collection/create.ts +0 -210
  422. package/src/mcp/tools/collection/delete.ts +0 -211
  423. package/src/mcp/tools/collection/find.ts +0 -224
  424. package/src/mcp/tools/collection/update.ts +0 -290
  425. package/src/mcp/tools/config/find.ts +0 -128
  426. package/src/mcp/tools/config/update.ts +0 -280
  427. package/src/mcp/tools/global/find.ts +0 -128
  428. package/src/mcp/tools/global/update.ts +0 -207
  429. package/src/mcp/tools/job/create.ts +0 -416
  430. package/src/mcp/tools/job/run.ts +0 -167
  431. package/src/mcp/tools/job/update.ts +0 -274
  432. package/src/mcp/tools/resource/create.ts +0 -211
  433. package/src/mcp/tools/resource/delete.ts +0 -218
  434. package/src/mcp/tools/resource/find.ts +0 -246
  435. package/src/mcp/tools/resource/update.ts +0 -383
  436. package/src/mcp/tools/schemas.ts +0 -520
  437. package/src/utils/adminEntitySettings.ts +0 -40
  438. package/src/utils/createApiKeyFields.ts +0 -72
  439. package/src/utils/getEnabledSlugs.ts +0 -42
  440. package/src/utils/getVirtualFieldNames.ts +0 -53
  441. package/src/utils/schemaConversion/convertCollectionSchemaToZod.ts +0 -52
  442. package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts +0 -27
  443. package/src/utils/schemaConversion/sanitizeJsonSchema.ts +0 -62
  444. package/src/utils/schemaConversion/simplifyRelationshipFields.ts +0 -65
  445. package/src/utils/schemaConversion/transformPointFields.ts +0 -55
  446. package/src/utils/transformPointDataToPayload.ts +0 -40
@@ -0,0 +1,94 @@
1
+ import type { PayloadRequest } from 'payload'
2
+
3
+ import { APIError, createAuthToken, executeAuthStrategies, redeemRefreshToken } from 'payload'
4
+
5
+ import type { MCPOAuthTokens } from '../types.js'
6
+
7
+ import { seal, unseal } from '../utils/seal.js'
8
+
9
+ /**
10
+ * The default `issueToken`: a Payload login token, sealed so it only works for MCP, where
11
+ * `authenticateLoginToken` unseals it. Otherwise an MCP client could use it as the user's admin
12
+ * panel login. When the collection uses sessions, the client also gets a refresh token.
13
+ */
14
+ export const issueLoginToken = async ({
15
+ req,
16
+ }: {
17
+ req: PayloadRequest
18
+ }): Promise<MCPOAuthTokens> => {
19
+ const collectionConfig = req.payload.collections[req.user!.collection]!.config
20
+
21
+ if (collectionConfig.auth.disableLocalStrategy) {
22
+ throw new APIError(
23
+ `MCP clients can't get Payload login tokens for the "${collectionConfig.slug}" collection because its local strategy is disabled. Pass oauth.issueToken to the MCP plugin.`,
24
+ )
25
+ }
26
+
27
+ // The full document, like the one a password login starts its session on
28
+ const user = (await req.payload.db.findOne<NonNullable<PayloadRequest['user']>>({
29
+ collection: collectionConfig.slug,
30
+ req,
31
+ where: { id: { equals: req.user!.id } },
32
+ }))!
33
+
34
+ const { refreshToken, token } = await createAuthToken({
35
+ collectionConfig,
36
+ email: user.email!,
37
+ req,
38
+ shouldCreateRefreshToken: true,
39
+ user,
40
+ })
41
+
42
+ return {
43
+ accessToken: sealLoginToken({ req, token }),
44
+ expiresIn: collectionConfig.auth.tokenExpiration,
45
+ refreshToken,
46
+ }
47
+ }
48
+
49
+ /** The default `refreshToken`. Payload logs out the session when a refresh token is reused. */
50
+ export const refreshLoginToken = async ({
51
+ refreshToken,
52
+ req,
53
+ reuseInterval,
54
+ }: {
55
+ refreshToken: string
56
+ req: PayloadRequest
57
+ /** See `redeemRefreshToken`. */
58
+ reuseInterval?: number
59
+ }): Promise<MCPOAuthTokens | null> => {
60
+ const refreshed = await redeemRefreshToken({ refreshToken, req, reuseInterval })
61
+
62
+ return (
63
+ refreshed && {
64
+ accessToken: sealLoginToken({ req, token: refreshed.token }),
65
+ expiresIn: refreshed.collectionConfig.auth.tokenExpiration,
66
+ refreshToken: refreshed.refreshToken,
67
+ }
68
+ )
69
+ }
70
+
71
+ /** Finds the user of an MCP request's access token from `issueLoginToken`. */
72
+ export const authenticateLoginToken = async ({
73
+ req,
74
+ token,
75
+ }: {
76
+ req: PayloadRequest
77
+ token: string
78
+ }): Promise<PayloadRequest['user']> => {
79
+ const loginToken = unseal<{ token: string }>({ type: 'access', req, value: token })
80
+
81
+ if (!loginToken) {
82
+ return null
83
+ }
84
+
85
+ const headers = new Headers({
86
+ Authorization: `JWT ${loginToken.token}`,
87
+ DisableAutologin: 'true',
88
+ })
89
+
90
+ return (await executeAuthStrategies({ headers, payload: req.payload, req })).user
91
+ }
92
+
93
+ const sealLoginToken = ({ req, token }: { req: PayloadRequest; token: string }): string =>
94
+ seal({ type: 'access', data: { token }, req })
@@ -0,0 +1,452 @@
1
+ import type {
2
+ OAuthClientInformationFull,
3
+ OAuthTokens,
4
+ OpenIdProviderDiscoveryMetadata,
5
+ } from '@modelcontextprotocol/server'
6
+ import type { Endpoint, PayloadHandler, PayloadRequest } from 'payload'
7
+
8
+ import { OAuthErrorCode } from '@modelcontextprotocol/server'
9
+ import { createHash } from 'crypto'
10
+ import { formatAdminURL } from 'payload/shared'
11
+
12
+ import type { MCPBuiltinOAuthConfig, MCPOAuthTokens } from '../types.js'
13
+
14
+ import { getPluginConfig } from '../utils/getPluginConfig.js'
15
+ import { seal, unseal } from '../utils/seal.js'
16
+ import { getMCPResource } from './oauth.js'
17
+ import { issueLoginToken, refreshLoginToken } from './oauthLoginToken.js'
18
+
19
+ export type Client = { name: string; redirectURIs: string[] }
20
+
21
+ export type Consent = {
22
+ clientID: string
23
+ codeChallenge: string
24
+ collection: string
25
+ redirectURI: string
26
+ state: null | string
27
+ userID: number | string
28
+ }
29
+
30
+ type Code = {
31
+ clientID: string
32
+ codeChallenge: string
33
+ redirectURI: string
34
+ tokens: MCPOAuthTokens
35
+ }
36
+
37
+ /** Why `MCPAuthorizeView` can't show the Allow form. */
38
+ export type AuthorizeViewError = 'expired' | 'invalid-link'
39
+
40
+ /** The admin page where users allow MCP clients, `MCPAuthorizeView`. */
41
+ export const authorizeViewPath = '/mcp/authorize'
42
+
43
+ type RefreshToken = {
44
+ clientID: string
45
+ refreshToken: string
46
+ }
47
+
48
+ /**
49
+ * Turns Payload into the OAuth authorization server for MCP clients when `oauth.type` is
50
+ * `'builtin'`. Clients register, the user allows them after logging in to the admin panel, and
51
+ * the client receives the tokens `issueToken` creates.
52
+ *
53
+ * Clients, consent forms, authorization codes, and refresh tokens are encrypted and handed to the
54
+ * client instead of being stored. Only the default tokens write to the database, to the user's
55
+ * login sessions.
56
+ */
57
+ export const oauthServerEndpoints: Endpoint[] = [
58
+ {
59
+ disableAuth: true,
60
+ handler: (req) => withIssuer(req, (issuer) => metadataResponse(issuer)),
61
+ method: 'get',
62
+ // OpenID discovery is the only metadata location MCP clients check below the issuer's path,
63
+ // which lets this work under /api without a route at the site root
64
+ path: '/mcp/oauth/.well-known/openid-configuration',
65
+ },
66
+ {
67
+ disableAuth: true,
68
+ handler: (req) => withIssuer(req, () => Response.json({ keys: [] })),
69
+ method: 'get',
70
+ path: '/mcp/oauth/jwks',
71
+ },
72
+ {
73
+ disableAuth: true,
74
+ handler: (req) => withIssuer(req, () => register(req)),
75
+ method: 'post',
76
+ path: '/mcp/oauth/register',
77
+ },
78
+ {
79
+ handler: (req) => withIssuer(req, () => authorize(req)),
80
+ method: 'get',
81
+ path: '/mcp/oauth/authorize',
82
+ },
83
+ {
84
+ handler: (req) => withIssuer(req, (issuer) => approve({ issuer, req })),
85
+ method: 'post',
86
+ path: '/mcp/oauth/authorize',
87
+ },
88
+ {
89
+ disableAuth: true,
90
+ handler: (req) => withIssuer(req, () => token(req)),
91
+ method: 'post',
92
+ path: '/mcp/oauth/token',
93
+ },
94
+ ]
95
+
96
+ /** The authorization server URL, or `undefined` when Payload isn't the authorization server. */
97
+ const getIssuer = (req: PayloadRequest): string | undefined =>
98
+ getPluginConfig({ config: req.payload.config }).oauth?.type === 'builtin'
99
+ ? `${getMCPResource({ req })}/oauth`
100
+ : undefined
101
+
102
+ const withIssuer = (
103
+ req: PayloadRequest,
104
+ handler: (issuer: string) => Promise<Response> | Response,
105
+ ): Promise<Response> | Response => {
106
+ const issuer = getIssuer(req)
107
+ return issuer ? handler(issuer) : new Response(null, { status: 404 })
108
+ }
109
+
110
+ /**
111
+ * The user logged in to this browser, who can allow MCP clients. Tokens and API keys in the
112
+ * `Authorization` header can't, or an MCP client could use its access token to approve itself a
113
+ * new, separate login.
114
+ */
115
+ const getBrowserUser = (req: PayloadRequest): PayloadRequest['user'] =>
116
+ req.headers.has('Authorization') ? null : req.user
117
+
118
+ const metadataResponse = (issuer: string): Response =>
119
+ Response.json(
120
+ {
121
+ authorization_endpoint: `${issuer}/authorize`,
122
+ authorization_response_iss_parameter_supported: true,
123
+ code_challenge_methods_supported: ['S256'],
124
+ grant_types_supported: ['authorization_code', 'refresh_token'],
125
+ // Required by OpenID discovery. No ID tokens are issued.
126
+ id_token_signing_alg_values_supported: ['RS256'],
127
+ issuer,
128
+ jwks_uri: `${issuer}/jwks`,
129
+ registration_endpoint: `${issuer}/register`,
130
+ response_types_supported: ['code'],
131
+ subject_types_supported: ['public'],
132
+ token_endpoint: `${issuer}/token`,
133
+ token_endpoint_auth_methods_supported: ['none'],
134
+ } satisfies OpenIdProviderDiscoveryMetadata,
135
+ // Not cached, since without `serverURL` its URLs come from the request
136
+ { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'no-store' } },
137
+ )
138
+
139
+ const register: PayloadHandler = async (req) => {
140
+ const { client_name, redirect_uris } = await req.json!().catch(() => ({}))
141
+
142
+ if (
143
+ !Array.isArray(redirect_uris) ||
144
+ !redirect_uris.length ||
145
+ !redirect_uris.every(isValidRedirectURI)
146
+ ) {
147
+ return Response.json({ error: OAuthErrorCode.InvalidRedirectUri }, { status: 400 })
148
+ }
149
+
150
+ const client: Client = {
151
+ name: typeof client_name === 'string' ? client_name : 'An MCP client',
152
+ redirectURIs: redirect_uris,
153
+ }
154
+
155
+ return Response.json(
156
+ {
157
+ client_id: seal({ type: 'client', data: client, req }),
158
+ client_name: client.name,
159
+ grant_types: ['authorization_code', 'refresh_token'],
160
+ redirect_uris: client.redirectURIs,
161
+ response_types: ['code'],
162
+ token_endpoint_auth_method: 'none',
163
+ } satisfies OAuthClientInformationFull,
164
+ { status: 201 },
165
+ )
166
+ }
167
+
168
+ const authorize: PayloadHandler = (req) => {
169
+ const url = new URL(req.url!)
170
+ const params = url.searchParams
171
+ const clientID = params.get('client_id')
172
+ const client = unseal<Client>({ type: 'client', req, value: clientID })
173
+ // Optional when the client registered only one
174
+ const redirectURI =
175
+ params.get('redirect_uri') ??
176
+ (client?.redirectURIs.length === 1 ? client.redirectURIs[0]! : null)
177
+
178
+ // Never redirect to an address the client didn't register
179
+ if (!client || !redirectURI || !client.redirectURIs.includes(redirectURI)) {
180
+ return redirectToAuthorizeView({ params: { error: 'invalid-link' }, req })
181
+ }
182
+
183
+ const state = params.get('state')
184
+ const codeChallenge = params.get('code_challenge')
185
+
186
+ // Not sent to the client's address: anyone can register a client, so that would let a link to
187
+ // this site send users to any site without them doing anything
188
+ if (
189
+ params.get('response_type') !== 'code' ||
190
+ params.get('code_challenge_method') !== 'S256' ||
191
+ !codeChallenge
192
+ ) {
193
+ return redirectToAuthorizeView({ params: { error: 'invalid-link' }, req })
194
+ }
195
+
196
+ const user = getBrowserUser(req)
197
+
198
+ if (!user) {
199
+ const loginURL = formatAdminURL({
200
+ adminRoute: req.payload.config.routes.admin,
201
+ path: req.payload.config.admin.routes.login,
202
+ })
203
+
204
+ return new Response(null, {
205
+ headers: {
206
+ Location: `${loginURL}?redirect=${encodeURIComponent(url.pathname + url.search)}`,
207
+ },
208
+ status: 302,
209
+ })
210
+ }
211
+
212
+ const consent: Consent = {
213
+ clientID: clientID!,
214
+ codeChallenge,
215
+ collection: user.collection,
216
+ redirectURI,
217
+ state,
218
+ userID: user.id,
219
+ }
220
+
221
+ return redirectToAuthorizeView({
222
+ params: { consent: seal({ type: 'consent', data: consent, expiresInSeconds: 20 * 60, req }) },
223
+ req,
224
+ })
225
+ }
226
+
227
+ const approve = async ({
228
+ issuer,
229
+ req,
230
+ }: {
231
+ issuer: string
232
+ req: PayloadRequest
233
+ }): Promise<Response> => {
234
+ // The Allow page is part of the admin panel, which other sites may be able to frame. Only
235
+ // accepting clicks from a top-level page stops them from tricking users into clicking Allow.
236
+ // Browsers too old to send the header get through here, but the page hides its buttons in frames.
237
+ const fetchDestination = req.headers.get('Sec-Fetch-Dest')
238
+ // Only the Allow page itself may submit the form, not a copy of it on another site
239
+ const fetchSite = req.headers.get('Sec-Fetch-Site')
240
+ if (
241
+ (fetchDestination && fetchDestination !== 'document') ||
242
+ (fetchSite && fetchSite !== 'same-origin')
243
+ ) {
244
+ return new Response(null, { status: 403 })
245
+ }
246
+
247
+ const form = new URLSearchParams(await req.text!())
248
+ const consent = unseal<Consent>({ type: 'consent', req, value: form.get('consent') })
249
+ const user = getBrowserUser(req)
250
+
251
+ // The form is only valid for the user it was shown to
252
+ if (!consent || user?.id !== consent.userID || user.collection !== consent.collection) {
253
+ return redirectToAuthorizeView({ params: { error: 'expired' }, req })
254
+ }
255
+
256
+ const { clientID, codeChallenge, redirectURI, state } = consent
257
+
258
+ // Responses to the client name this server in `iss`, so clients that use several authorization
259
+ // servers can tell which one answered
260
+ if (form.get('decision') !== 'allow') {
261
+ return redirect({
262
+ params: { error: OAuthErrorCode.AccessDenied, iss: issuer, state },
263
+ redirectURI,
264
+ })
265
+ }
266
+
267
+ const code: Code = {
268
+ clientID,
269
+ codeChallenge,
270
+ redirectURI,
271
+ tokens: await getTokenHooks(req).issueToken({ req }),
272
+ }
273
+
274
+ return redirect({
275
+ params: {
276
+ code: seal({ type: 'code', data: code, expiresInSeconds: 60, req }),
277
+ iss: issuer,
278
+ state,
279
+ },
280
+ redirectURI,
281
+ })
282
+ }
283
+
284
+ const token: PayloadHandler = async (req) => {
285
+ const form = new URLSearchParams(await req.text!())
286
+ const clientID = form.get('client_id')
287
+ const grantType = form.get('grant_type')
288
+
289
+ if (grantType !== 'authorization_code' && grantType !== 'refresh_token') {
290
+ return Response.json(
291
+ { error: grantType ? OAuthErrorCode.UnsupportedGrantType : OAuthErrorCode.InvalidRequest },
292
+ { status: 400 },
293
+ )
294
+ }
295
+
296
+ const requiredParams =
297
+ grantType === 'refresh_token' ? ['refresh_token'] : ['code', 'code_verifier']
298
+
299
+ if (!clientID || requiredParams.some((param) => !form.get(param))) {
300
+ return Response.json({ error: OAuthErrorCode.InvalidRequest }, { status: 400 })
301
+ }
302
+
303
+ const tokens =
304
+ grantType === 'refresh_token'
305
+ ? await refresh({ clientID, form, req })
306
+ : await redeemCode({ clientID, form, req })
307
+
308
+ if (!tokens) {
309
+ return Response.json({ error: OAuthErrorCode.InvalidGrant }, { status: 400 })
310
+ }
311
+
312
+ return Response.json(
313
+ {
314
+ access_token: tokens.accessToken,
315
+ expires_in: tokens.expiresIn,
316
+ refresh_token:
317
+ tokens.refreshToken &&
318
+ seal({
319
+ type: 'refresh',
320
+ data: { clientID, refreshToken: tokens.refreshToken } satisfies RefreshToken,
321
+ req,
322
+ }),
323
+ token_type: 'Bearer',
324
+ } satisfies OAuthTokens,
325
+ { headers: { 'Cache-Control': 'no-store' } },
326
+ )
327
+ }
328
+
329
+ const redeemCode = async ({
330
+ clientID,
331
+ form,
332
+ req,
333
+ }: {
334
+ clientID: string
335
+ form: URLSearchParams
336
+ req: PayloadRequest
337
+ }): Promise<MCPOAuthTokens | null | undefined> => {
338
+ const code = unseal<Code>({ type: 'code', req, value: form.get('code') })
339
+
340
+ if (
341
+ code?.clientID === clientID &&
342
+ // OAuth 2.1 clients leave it out, since PKCE does its job. OAuth 2.0 clients send it, and it must
343
+ // match then.
344
+ (!form.has('redirect_uri') || form.get('redirect_uri') === code.redirectURI) &&
345
+ // PKCE: only the client that started the sign-in knows the verifier
346
+ createHash('sha256')
347
+ .update(form.get('code_verifier') ?? '')
348
+ .digest('base64url') === code.codeChallenge
349
+ ) {
350
+ // A code must only work once. Trading it also trades its refresh token, with no leeway, so
351
+ // using the code again counts as a copied refresh token: it's refused, and the tokens revoked.
352
+ const hooks = getTokenHooks(req)
353
+ if (hooks.refreshToken && code.tokens.refreshToken) {
354
+ return await hooks.refreshToken({
355
+ refreshToken: code.tokens.refreshToken,
356
+ req,
357
+ reuseInterval: 0,
358
+ })
359
+ }
360
+
361
+ return code.tokens
362
+ }
363
+ }
364
+
365
+ const refresh = async ({
366
+ clientID,
367
+ form,
368
+ req,
369
+ }: {
370
+ clientID: string
371
+ form: URLSearchParams
372
+ req: PayloadRequest
373
+ }): Promise<MCPOAuthTokens | null | undefined> => {
374
+ const refreshToken = unseal<RefreshToken>({
375
+ type: 'refresh',
376
+ req,
377
+ value: form.get('refresh_token'),
378
+ })
379
+
380
+ // Only the client a refresh token was issued to can use it
381
+ if (refreshToken?.clientID === clientID) {
382
+ return await getTokenHooks(req).refreshToken?.({
383
+ refreshToken: refreshToken.refreshToken,
384
+ req,
385
+ })
386
+ }
387
+ }
388
+
389
+ /** `issueToken` and `refreshToken`, or the defaults for Payload login tokens. */
390
+ const getTokenHooks = (req: PayloadRequest) => {
391
+ const oauth = getPluginConfig({ config: req.payload.config }).oauth as MCPBuiltinOAuthConfig
392
+
393
+ return oauth.issueToken
394
+ ? { issueToken: oauth.issueToken, refreshToken: oauth.refreshToken }
395
+ : { issueToken: issueLoginToken, refreshToken: refreshLoginToken }
396
+ }
397
+
398
+ const redirect = ({
399
+ params,
400
+ redirectURI,
401
+ }: {
402
+ params: Record<string, null | string>
403
+ redirectURI: string
404
+ }): Response => {
405
+ const location = new URL(redirectURI)
406
+
407
+ for (const [key, value] of Object.entries(params)) {
408
+ if (value) {
409
+ location.searchParams.set(key, value)
410
+ }
411
+ }
412
+
413
+ return new Response(null, { headers: { Location: location.href }, status: 302 })
414
+ }
415
+
416
+ /**
417
+ * Accepts https, http to the user's own computer only, since the code would otherwise travel
418
+ * unencrypted, and app schemes like `cursor://` that desktop apps register to receive the code.
419
+ */
420
+ const isValidRedirectURI = (uri: unknown): boolean => {
421
+ if (typeof uri !== 'string' || !URL.canParse(uri) || uri.includes('#')) {
422
+ return false
423
+ }
424
+
425
+ const { hostname, protocol } = new URL(uri)
426
+
427
+ if (protocol === 'http:') {
428
+ return ['[::1]', '127.0.0.1', 'localhost'].includes(hostname)
429
+ }
430
+
431
+ // Browser schemes that run or show content instead of sending the code to an app
432
+ return protocol !== 'javascript:' && protocol !== 'data:'
433
+ }
434
+
435
+ /** Sends the browser to `MCPAuthorizeView`, with the Allow form or the reason it can't show it. */
436
+ const redirectToAuthorizeView = ({
437
+ params,
438
+ req,
439
+ }: {
440
+ params: { consent: string } | { error: AuthorizeViewError }
441
+ req: PayloadRequest
442
+ }): Response => {
443
+ const viewURL = formatAdminURL({
444
+ adminRoute: req.payload.config.routes.admin,
445
+ path: authorizeViewPath,
446
+ })
447
+
448
+ return new Response(null, {
449
+ headers: { Location: `${viewURL}?${new URLSearchParams(params)}` },
450
+ status: 302,
451
+ })
452
+ }
@@ -0,0 +1,3 @@
1
+ 'use client'
2
+
3
+ export { AllowButtons } from '../views/Authorize/AllowButtons/index.js'
@@ -0,0 +1 @@
1
+ export { filterMCPItems, getAuthorizedMCP } from '../endpoint/access.js'
@@ -0,0 +1 @@
1
+ export { MCPAuthorizeView } from '../views/Authorize/index.js'