@terreno/api 57.2.0 → 57.4.0

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 (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,12 +1,12 @@
1
1
  import mongoose from "mongoose";
2
2
 
3
3
  import {addPopulateToQuery, type JSONValue} from "../api";
4
- import {omitUserRolesFromWriteBody, type User} from "../auth";
4
+ import type {User} from "../auth";
5
5
  import {isAPIError} from "../errors";
6
6
  import {checkPermissions} from "../permissions";
7
7
  import type {PopulatePath} from "../populate";
8
- import {validateAccessWritePayload} from "../rbac/modelRouterAccess";
9
- import {defaultResponseHandler, transform} from "../transformers";
8
+ import {executeCreate, executeDelete, executeUpdate} from "../sync/executors";
9
+ import {defaultResponseHandler} from "../transformers";
10
10
  import {createMCPRequest} from "./createMCPRequest";
11
11
  import {buildListQuery} from "./query";
12
12
  import {restWriteExcludeFields, writeExcludeFields} from "./schemaGenerator";
@@ -210,11 +210,16 @@ const requiresAuthentication = (entry: MCPRegistryEntry, user?: User): boolean =
210
210
  return !user && entry.options.allowAnonymous !== true;
211
211
  };
212
212
 
213
- const hookFailureResult = (label: string, error: unknown): MCPToolResult => {
213
+ /** Map executor/APIError failures onto the MCP error envelope. */
214
+ const fromExecutorError = (error: unknown): MCPToolResult => {
214
215
  if (isAPIError(error)) {
215
216
  return errorResult(error.title, error);
216
217
  }
217
- return errorResult(`${label}: ${errorMessage(error)}`, error);
218
+ return errorResult(errorMessage(error), error);
219
+ };
220
+
221
+ const deniedWriteFields = (entry: MCPRegistryEntry, phase: "create" | "update"): string[] => {
222
+ return writeExcludeFields(entry.config, restWriteExcludeFields(phase, entry.options.validation));
218
223
  };
219
224
 
220
225
  const serializeResponse = async (
@@ -234,7 +239,12 @@ const serializeResponse = async (
234
239
  // Use the model router's responseHandler if available, otherwise default
235
240
  const responseHandler = entry.options.responseHandler ?? defaultResponseHandler;
236
241
 
237
- const result = await responseHandler(data, method, createMCPRequest({user}), entry.options);
242
+ const result = await responseHandler(
243
+ data as NonNullable<Parameters<typeof responseHandler>[0]>,
244
+ method,
245
+ createMCPRequest({user}),
246
+ entry.options
247
+ );
238
248
  return {value: stripExcludedFields(result, excludeFields) as JSONValue};
239
249
  } catch (error) {
240
250
  if (isAPIError(error)) {
@@ -379,65 +389,22 @@ export const handleCreate = async (
379
389
  return errorResult("Permission denied: authentication required");
380
390
  }
381
391
 
382
- if (!(await checkPermissions("create", options.permissions.create, user))) {
383
- return errorResult("Permission denied: cannot create");
384
- }
385
-
386
- let body: MCPToolArgs | null = omitDeniedWriteFields(
387
- args,
388
- writeExcludeFields(entry.config, restWriteExcludeFields("create", options.validation))
389
- );
390
- try {
391
- body = transform(options, body, "create", user) as MCPToolArgs;
392
- } catch (error) {
393
- return errorResult(`Transform failed: ${errorMessage(error)}`, error);
394
- }
395
-
396
- if (options.preCreate) {
397
- try {
398
- body = await options.preCreate(body, createMCPRequest({body, user}));
399
- if (body === null || body === undefined) {
400
- return errorResult("Create not allowed");
401
- }
402
- } catch (error) {
403
- return hookFailureResult("preCreate hook failed", error);
404
- }
405
- }
406
-
407
- body = omitUserRolesFromWriteBody(entry.modelName, options.accessControl, body) as MCPToolArgs;
392
+ const body = omitDeniedWriteFields(args, deniedWriteFields(entry, "create")) as MCPToolArgs;
393
+ const req = createMCPRequest({body, user});
408
394
 
395
+ let data: MCPDocument | null;
409
396
  try {
410
- await validateAccessWritePayload({
397
+ const result = await executeCreate({
411
398
  body,
399
+ model,
412
400
  options,
413
- phase: "create",
401
+ req,
414
402
  user,
403
+ writeModelName: entry.modelName,
415
404
  });
405
+ data = result.doc as MCPDocument;
416
406
  } catch (error) {
417
- if (isAPIError(error)) {
418
- return errorResult(error.title, error);
419
- }
420
- return errorResult(`Write validation failed: ${errorMessage(error)}`, error);
421
- }
422
-
423
- let data: MCPDocument | null;
424
- try {
425
- data = asDocument(await model.create(body));
426
- } catch (error) {
427
- return errorResult(`Create failed: ${errorMessage(error)}`, error);
428
- }
429
-
430
- if (options.populatePaths) {
431
- const populateQuery = addPopulateToQuery(model.findById(data?._id), options.populatePaths);
432
- data = asDocument(await populateQuery.exec());
433
- }
434
-
435
- if (options.postCreate) {
436
- try {
437
- await options.postCreate(data, createMCPRequest({body, user}));
438
- } catch (error) {
439
- return hookFailureResult("postCreate hook failed", error);
440
- }
407
+ return fromExecutorError(error);
441
408
  }
442
409
 
443
410
  const serialized = await serializeResponse(data, "create", entry, user);
@@ -459,85 +426,31 @@ export const handleUpdate = async (
459
426
  return errorResult("Permission denied: authentication required");
460
427
  }
461
428
 
462
- if (!(await checkPermissions("update", options.permissions.update, user))) {
463
- return errorResult("Permission denied: cannot update");
464
- }
465
-
466
429
  const documentId = asOptionalString(id);
467
430
  if (!documentId) {
468
431
  return missingDocumentResult(id);
469
432
  }
470
433
 
471
- let doc = await execFindByIdQuery(
472
- addPopulateToQuery(model.findById(documentId), options.populatePaths)
473
- );
474
-
475
- if (!doc) {
476
- return missingDocumentResult(documentId);
477
- }
478
-
479
- if (!(await checkPermissions("update", options.permissions.update, user, doc))) {
480
- return errorResult("Permission denied: cannot update this document");
481
- }
482
-
483
- let body: MCPToolArgs | null = omitDeniedWriteFields(
434
+ const body = omitDeniedWriteFields(
484
435
  updateFields,
485
- writeExcludeFields(entry.config, restWriteExcludeFields("update", options.validation))
486
- );
487
- try {
488
- body = transform(options, body, "update", user) as MCPToolArgs;
489
- } catch (error) {
490
- return errorResult(`Transform failed: ${errorMessage(error)}`, error);
491
- }
492
-
493
- if (options.preUpdate) {
494
- try {
495
- body = await options.preUpdate(body, createMCPRequest({body, user}));
496
- if (body === null || body === undefined) {
497
- return errorResult("Update not allowed");
498
- }
499
- } catch (error) {
500
- return hookFailureResult("preUpdate hook failed", error);
501
- }
502
- }
503
-
504
- body = omitUserRolesFromWriteBody(entry.modelName, options.accessControl, body) as MCPToolArgs;
436
+ deniedWriteFields(entry, "update")
437
+ ) as MCPToolArgs;
438
+ const req = createMCPRequest({body, user});
505
439
 
440
+ let doc: MCPDocument | null;
506
441
  try {
507
- await validateAccessWritePayload({
442
+ const result = await executeUpdate({
508
443
  body,
509
- doc,
444
+ id: documentId,
445
+ model,
510
446
  options,
511
- phase: "write",
447
+ req,
512
448
  user,
449
+ writeModelName: entry.modelName,
513
450
  });
451
+ doc = result.doc as MCPDocument;
514
452
  } catch (error) {
515
- if (isAPIError(error)) {
516
- return errorResult(error.title, error);
517
- }
518
- return errorResult(`Write validation failed: ${errorMessage(error)}`, error);
519
- }
520
-
521
- const prevDoc = doc.toObject();
522
-
523
- try {
524
- doc.set(body);
525
- await doc.save();
526
- } catch (error) {
527
- return errorResult(`Update failed: ${errorMessage(error)}`, error);
528
- }
529
-
530
- if (options.populatePaths) {
531
- const populateQuery = addPopulateToQuery(model.findById(doc._id), options.populatePaths);
532
- doc = asDocument(await populateQuery.exec());
533
- }
534
-
535
- if (options.postUpdate) {
536
- try {
537
- await options.postUpdate(doc, body, createMCPRequest({body, user}), prevDoc);
538
- } catch (error) {
539
- return hookFailureResult("postUpdate hook failed", error);
540
- }
453
+ return fromExecutorError(error);
541
454
  }
542
455
 
543
456
  const serialized = await serializeResponse(doc, "update", entry, user);
@@ -559,61 +472,21 @@ export const handleDelete = async (
559
472
  return errorResult("Permission denied: authentication required");
560
473
  }
561
474
 
562
- if (!(await checkPermissions("delete", options.permissions.delete, user))) {
563
- return errorResult("Permission denied: cannot delete");
564
- }
565
-
566
475
  const documentId = asOptionalString(id);
567
476
  if (!documentId) {
568
477
  return missingDocumentResult(id);
569
478
  }
570
479
 
571
- // Populate before the object-level permission check so custom permissions can inspect
572
- // populated refs, matching handleRead/handleUpdate and REST's permissionMiddleware.
573
- const doc = await execFindByIdQuery(
574
- addPopulateToQuery(model.findById(documentId), options.populatePaths)
575
- );
576
-
577
- if (!doc) {
578
- return missingDocumentResult(documentId);
579
- }
580
-
581
- if (!(await checkPermissions("delete", options.permissions.delete, user, doc))) {
582
- return errorResult("Permission denied: cannot delete this document");
583
- }
584
-
585
- if (options.preDelete) {
586
- try {
587
- const result = await options.preDelete(doc, createMCPRequest({body: args, user}));
588
- if (result === null || result === undefined) {
589
- return errorResult("Delete not allowed");
590
- }
591
- } catch (error) {
592
- return hookFailureResult("preDelete hook failed", error);
593
- }
594
- }
595
-
596
- // Support soft delete via isDeleted plugin
597
480
  try {
598
- if (
599
- Object.keys(model.schema.paths).includes("deleted") &&
600
- model.schema.paths.deleted.instance === "Boolean"
601
- ) {
602
- doc.deleted = true;
603
- await doc.save();
604
- } else {
605
- await doc.deleteOne();
606
- }
481
+ await executeDelete({
482
+ id: documentId,
483
+ model,
484
+ options,
485
+ req: createMCPRequest({body: args, user}),
486
+ user,
487
+ });
607
488
  } catch (error) {
608
- return errorResult(`Delete failed: ${errorMessage(error)}`, error);
609
- }
610
-
611
- if (options.postDelete) {
612
- try {
613
- await options.postDelete(createMCPRequest({body: args, user}), doc);
614
- } catch (error) {
615
- return hookFailureResult("postDelete hook failed", error);
616
- }
489
+ return fromExecutorError(error);
617
490
  }
618
491
 
619
492
  return textResult(JSON.stringify({success: true}));
@@ -1,4 +1,4 @@
1
- import {beforeEach, describe, expect, it} from "bun:test";
1
+ import {beforeEach, describe, expect, it, spyOn} from "bun:test";
2
2
  import type express from "express";
3
3
  import mongoose, {Schema} from "mongoose";
4
4
 
@@ -7,6 +7,7 @@ import {APIError} from "../errors";
7
7
  import {OwnerQueryFilter, Permissions} from "../permissions";
8
8
  import {createAccess} from "../rbac/access";
9
9
  import {terrenoStatements} from "../rbac/statements";
10
+ import * as executors from "../sync/executors";
10
11
  import {setupDb} from "../tests";
11
12
  import {handleCreate, handleDelete, handleList, handleRead, handleUpdate} from "./handlers";
12
13
  import {
@@ -155,6 +156,16 @@ describe("MCP Integration", () => {
155
156
  expect(String(parsed.data.ownerId)).toBe(normalUser.id);
156
157
  });
157
158
 
159
+ it("calls executeCreate instead of persisting in the handler", async () => {
160
+ const createSpy = spyOn(executors, "executeCreate");
161
+ const result = await handleCreate(entry, {title: "Via executor"}, asUser(normalUser));
162
+ const parsed = parseResult(result);
163
+
164
+ expect(createSpy).toHaveBeenCalledTimes(1);
165
+ expect(parsed.data.title).toBe("Via executor");
166
+ createSpy.mockRestore();
167
+ });
168
+
158
169
  it("denies create without user", async () => {
159
170
  const result = await handleCreate(entry, {title: "Test"});
160
171
  const parsed = parseResult(result);
@@ -209,6 +220,7 @@ describe("MCP Integration", () => {
209
220
  });
210
221
 
211
222
  it("drops User roles on MCP create when accessControl is set", async () => {
223
+ let seenRoles: unknown;
212
224
  const writeEntry: MCPRegistryEntry = {
213
225
  config: {methods: ["create"]},
214
226
  model: UserWriteModel,
@@ -222,6 +234,10 @@ describe("MCP Integration", () => {
222
234
  read: [],
223
235
  update: [],
224
236
  },
237
+ preCreate: (body) => {
238
+ seenRoles = (body as {roles?: string[]}).roles;
239
+ return body;
240
+ },
225
241
  },
226
242
  };
227
243
  const result = await handleCreate(
@@ -230,6 +246,7 @@ describe("MCP Integration", () => {
230
246
  asUser(normalUser)
231
247
  );
232
248
  const parsed = parseResult(result);
249
+ expect(seenRoles).toEqual(["superadmin"]);
233
250
  expect(parsed.data.email).toBe("mcp-roles@example.com");
234
251
  expect(parsed.data.roles ?? []).toEqual([]);
235
252
  const stored = await UserWriteModel.findOne({email: "mcp-roles@example.com"}).lean();
@@ -561,6 +578,21 @@ describe("MCP Integration", () => {
561
578
  expect(parsed.data.title).toBe("Updated");
562
579
  });
563
580
 
581
+ it("calls executeUpdate instead of saving in the handler", async () => {
582
+ const doc = await TodoModel.create({ownerId: normalUser._id, title: "Spy update"});
583
+ const updateSpy = spyOn(executors, "executeUpdate");
584
+ const result = await handleUpdate(
585
+ entry,
586
+ {id: doc._id.toString(), title: "Spy updated"},
587
+ asUser(normalUser)
588
+ );
589
+ const parsed = parseResult(result);
590
+
591
+ expect(updateSpy).toHaveBeenCalledTimes(1);
592
+ expect(parsed.data.title).toBe("Spy updated");
593
+ updateSpy.mockRestore();
594
+ });
595
+
564
596
  it("denies update by non-owner", async () => {
565
597
  const doc = await TodoModel.create({ownerId: normalUser._id, title: "Not yours"});
566
598
  const result = await handleUpdate(
@@ -571,7 +603,8 @@ describe("MCP Integration", () => {
571
603
  const parsed = parseResult(result);
572
604
 
573
605
  expect(parsed.error).toBeDefined();
574
- expect(parsed.error).toContain("Permission denied");
606
+ expect(parsed.error).toContain("Access to GET on MCPTodo");
607
+ expect(parsed.error).toContain("denied");
575
608
  });
576
609
 
577
610
  it("admin can update any document", async () => {
@@ -688,6 +721,7 @@ describe("MCP Integration", () => {
688
721
  });
689
722
 
690
723
  it("drops User roles on MCP update when accessControl is set", async () => {
724
+ let seenRoles: unknown;
691
725
  const doc = await UserWriteModel.create({email: "mcp-roles-update@example.com", roles: []});
692
726
  const writeEntry: MCPRegistryEntry = {
693
727
  config: {methods: ["update"]},
@@ -702,6 +736,10 @@ describe("MCP Integration", () => {
702
736
  read: [],
703
737
  update: [Permissions.IsAuthenticated],
704
738
  },
739
+ preUpdate: (body) => {
740
+ seenRoles = (body as {roles?: string[]}).roles;
741
+ return body;
742
+ },
705
743
  },
706
744
  };
707
745
  const result = await handleUpdate(
@@ -710,6 +748,7 @@ describe("MCP Integration", () => {
710
748
  asUser(normalUser)
711
749
  );
712
750
  const parsed = parseResult(result);
751
+ expect(seenRoles).toEqual(["superadmin"]);
713
752
  expect(parsed.data.email).toBe("mcp-roles-update@example.com");
714
753
  expect(parsed.data.roles ?? []).toEqual([]);
715
754
  expect((await UserWriteModel.findById(doc._id).lean())?.roles ?? []).toEqual([]);
@@ -801,6 +840,17 @@ describe("MCP Integration", () => {
801
840
  expect(found).toBeNull();
802
841
  });
803
842
 
843
+ it("calls executeDelete instead of persisting in the handler", async () => {
844
+ const doc = await TodoModel.create({ownerId: normalUser._id, title: "Spy delete"});
845
+ const deleteSpy = spyOn(executors, "executeDelete");
846
+ const result = await handleDelete(entry, {id: doc._id.toString()}, asUser(normalUser));
847
+ const parsed = parseResult(result);
848
+
849
+ expect(deleteSpy).toHaveBeenCalledTimes(1);
850
+ expect(parsed.success).toBe(true);
851
+ deleteSpy.mockRestore();
852
+ });
853
+
804
854
  it("returns not found for a non-ObjectId id without throwing", async () => {
805
855
  const result = await handleDelete(entry, {id: "not-an-object-id"}, asUser(normalUser));
806
856
  const parsed = parseResult(result);
@@ -910,7 +960,7 @@ describe("MCP Integration", () => {
910
960
 
911
961
  const parsed = parseResult(await handleCreate(anonymousWrites, {title: "Anon"}));
912
962
 
913
- expect(parsed.error).toContain("Permission denied");
963
+ expect(parsed.error).toContain("Access to CREATE on MCPTodo denied");
914
964
  });
915
965
  });
916
966
 
@@ -1025,7 +1075,7 @@ describe("MCP Integration", () => {
1025
1075
 
1026
1076
  const parsed = parseResult(await handleCreate(failing, {title: "No"}, asUser(normalUser)));
1027
1077
 
1028
- expect(parsed.error).toContain("preCreate hook failed: boom");
1078
+ expect(parsed.error).toBe("preCreate hook error");
1029
1079
  });
1030
1080
 
1031
1081
  it("preserves APIError titles thrown from preCreate", async () => {
@@ -1059,7 +1109,7 @@ describe("MCP Integration", () => {
1059
1109
 
1060
1110
  const parsed = parseResult(await handleCreate(failing, {title: "Yes"}, asUser(normalUser)));
1061
1111
 
1062
- expect(parsed.error).toContain("postCreate hook failed: after");
1112
+ expect(parsed.error).toBe("postCreate hook error");
1063
1113
  });
1064
1114
 
1065
1115
  it("reports a preUpdate hook that returns null", async () => {
@@ -1092,7 +1142,7 @@ describe("MCP Integration", () => {
1092
1142
  await handleUpdate(failing, {id: doc._id.toString(), title: "Changed"}, asUser(normalUser))
1093
1143
  );
1094
1144
 
1095
- expect(parsed.error).toContain("postUpdate hook failed: late");
1145
+ expect(parsed.error).toBe("postUpdate hook error");
1096
1146
  });
1097
1147
 
1098
1148
  it("reports a preDelete hook that returns null", async () => {
@@ -1125,7 +1175,7 @@ describe("MCP Integration", () => {
1125
1175
  await handleDelete(failing, {id: doc._id.toString()}, asUser(normalUser))
1126
1176
  );
1127
1177
 
1128
- expect(parsed.error).toContain("postDelete hook failed: cascade");
1178
+ expect(parsed.error).toBe("postDelete hook error");
1129
1179
  });
1130
1180
 
1131
1181
  it("passes the update fields as the MCP request body, without the id", async () => {
@@ -1313,7 +1363,7 @@ describe("MCP Integration", () => {
1313
1363
  user: normalUser,
1314
1364
  });
1315
1365
  expectStubRequest({
1316
- body: {ownerId: normalUser._id, title: "Hooked"},
1366
+ body: {title: "Hooked"},
1317
1367
  request: seen.postCreate,
1318
1368
  user: normalUser,
1319
1369
  });
@@ -1456,7 +1506,7 @@ describe("MCP Integration", () => {
1456
1506
  const result = await handleDelete(registered, {id: doc._id.toString()}, asUser(normalUser));
1457
1507
  const parsed = parseResult(result);
1458
1508
 
1459
- expect(parsed.error).toContain("cannot delete");
1509
+ expect(parsed.error).toContain("Access to DELETE on MCPTodo denied");
1460
1510
  expect(await TodoModel.findById(doc._id)).toBeTruthy();
1461
1511
  });
1462
1512
 
package/src/mcp/query.ts CHANGED
@@ -3,20 +3,20 @@ import {isFieldExcluded} from "./schemaGenerator";
3
3
  import type {MCPConfig, MCPToolArgs} from "./types";
4
4
 
5
5
  /** Args consumed by pagination/population, never treated as filters. */
6
- export const RESERVED_LIST_ARGS = new Set(["limit", "page", "populate", "sort"]);
6
+ const RESERVED_LIST_ARGS = new Set(["limit", "page", "populate", "sort"]);
7
7
 
8
8
  /**
9
9
  * Top-level logical operators an MCP client may send. Mirrors the REST list endpoint,
10
10
  * which allows `$and` / `$or` and validates every nested key against `queryFields`.
11
11
  */
12
- export const ALLOWED_LOGICAL_OPERATORS = new Set(["$and", "$or"]);
12
+ const ALLOWED_LOGICAL_OPERATORS = new Set(["$and", "$or"]);
13
13
 
14
14
  /**
15
15
  * Comparison operators allowed inside a field's value, e.g. `{completed: {$ne: true}}`.
16
16
  * Deliberately excludes evaluation operators that can run arbitrary code or ignore
17
17
  * indexes ($where, $expr, $function, $accumulator, $jsonSchema, $text).
18
18
  */
19
- export const ALLOWED_FIELD_OPERATORS = new Set([
19
+ const ALLOWED_FIELD_OPERATORS = new Set([
20
20
  "$all",
21
21
  "$eq",
22
22
  "$exists",
@@ -132,16 +132,14 @@ export interface BuildListQueryResult {
132
132
  * Anything else is rejected rather than silently dropped so the calling LLM can correct
133
133
  * itself instead of receiving results for a query it did not ask for.
134
134
  */
135
- export const buildListQuery = ({
135
+ export const buildListQuery = <T>({
136
136
  args,
137
137
  config,
138
138
  options,
139
139
  }: {
140
140
  args: MCPToolArgs;
141
141
  config: MCPConfig;
142
- // noExplicitAny: ModelRouterOptions is generic over the consumer's document type
143
- // biome-ignore lint/suspicious/noExplicitAny: ModelRouterOptions is generic over the consumer's document type
144
- options: ModelRouterOptions<any>;
142
+ options: ModelRouterOptions<T>;
145
143
  }): BuildListQueryResult => {
146
144
  const query: Record<string, unknown> = {...(options.defaultQueryParams ?? {})};
147
145
  const excludeFields = config.excludeFields ?? [];
@@ -3,6 +3,12 @@ import type {ZodType} from "zod";
3
3
 
4
4
  import type {ModelRouterOptions} from "../api";
5
5
  import type {User} from "../auth";
6
+ import {
7
+ clearCollectionRegistry,
8
+ listCollections,
9
+ registerCollection,
10
+ replaceCollectionOptions,
11
+ } from "../collectionRegistry";
6
12
  import type {MCPConfig, MCPRegistryEntry, MCPToolArgs, MCPToolResult} from "./types";
7
13
 
8
14
  export interface MCPCustomTool {
@@ -12,39 +18,35 @@ export interface MCPCustomTool {
12
18
  zodSchema: ZodType;
13
19
  }
14
20
 
15
- const mcpRegistry: MCPRegistryEntry[] = [];
16
21
  const mcpCustomTools: MCPCustomTool[] = [];
17
22
 
18
- export const registerMCPModel = (
19
- // noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
20
- // biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
21
- model: Model<any>,
23
+ const findCollectionByModelName = (modelName: string) =>
24
+ listCollections().find((record) => record.model.modelName === modelName);
25
+
26
+ const mcpRoutePathForModel = <T>(model: Model<T>): string =>
27
+ findCollectionByModelName(model.modelName)?.routePath ?? `/_mcp/${model.modelName}`;
28
+
29
+ export const registerMCPModel = <T>(
30
+ model: Model<T>,
22
31
  config: MCPConfig,
23
- // noExplicitAny: ModelRouterOptions is generic over the consumer's document type
24
- // biome-ignore lint/suspicious/noExplicitAny: ModelRouterOptions is generic over the consumer's document type
25
- options: ModelRouterOptions<any>
32
+ options: ModelRouterOptions<T>
26
33
  ): void => {
27
- mcpRegistry.push({
28
- config,
34
+ registerCollection({
29
35
  model,
30
- modelName: model.modelName,
31
- options,
36
+ options: {...options, mcp: config},
37
+ routePath: mcpRoutePathForModel(model),
32
38
  });
33
39
  };
34
40
 
35
- /**
36
- * Replace options on an existing MCP registry entry after TerrenoApp injects
37
- * accessControl (same contract as updateRealtimeRegistryOptions).
38
- */
39
41
  export const updateMCPRegistryOptions = (
40
42
  modelName: string,
41
43
  options: ModelRouterOptions<unknown>
42
44
  ): void => {
43
- const existing = mcpRegistry.find((entry) => entry.modelName === modelName);
45
+ const existing = findCollectionByModelName(modelName);
44
46
  if (!existing) {
45
47
  return;
46
48
  }
47
- existing.options = options as MCPRegistryEntry["options"];
49
+ replaceCollectionOptions(existing.routePath, options);
48
50
  };
49
51
 
50
52
  export const registerMCPTool = (tool: MCPCustomTool): void => {
@@ -57,7 +59,14 @@ export const registerMCPTool = (tool: MCPCustomTool): void => {
57
59
  };
58
60
 
59
61
  export const getMCPRegistry = (): MCPRegistryEntry[] => {
60
- return mcpRegistry;
62
+ return listCollections()
63
+ .filter((record) => record.surfaces.mcp)
64
+ .map((record) => ({
65
+ config: record.options.mcp as MCPConfig,
66
+ model: record.model,
67
+ modelName: record.model.modelName,
68
+ options: record.options,
69
+ }));
61
70
  };
62
71
 
63
72
  export const getMCPCustomTools = (): MCPCustomTool[] => {
@@ -65,6 +74,6 @@ export const getMCPCustomTools = (): MCPCustomTool[] => {
65
74
  };
66
75
 
67
76
  export const clearMCPRegistry = (): void => {
68
- mcpRegistry.length = 0;
77
+ clearCollectionRegistry();
69
78
  mcpCustomTools.length = 0;
70
79
  };
@@ -14,6 +14,7 @@ const createTestModel = () => {
14
14
  const schema = new Schema({
15
15
  completed: {default: false, description: "Whether the item is complete", type: Boolean},
16
16
  count: {description: "A count", type: Number},
17
+ eatenBy: [{description: "Eaters", ref: "User", type: Schema.Types.ObjectId}],
17
18
  name: {description: "The name", required: true, type: String},
18
19
  ownerId: {description: "Owner", ref: "User", type: Schema.Types.ObjectId},
19
20
  secretField: {description: "A secret", type: String},
@@ -135,6 +136,13 @@ describe("generateToolDescription", () => {
135
136
  expect(desc).toContain("ownerId (ref: User)");
136
137
  });
137
138
 
139
+ it("labels ObjectId array refs as arrays in create description", () => {
140
+ const desc = generateToolDescription(model, "create", {});
141
+ expect(desc).toContain("eatenBy (ref:User[])");
142
+ expect(desc).not.toContain("eatenBy (ObjectId)");
143
+ expect(desc).not.toContain("eatenBy (ref: User) ");
144
+ });
145
+
138
146
  it("generates read description with the declared populate-able refs", () => {
139
147
  const desc = generateToolDescription(model, "read", {}, undefined, [{path: "ownerId"}]);
140
148
  expect(desc).toContain("Read a single MCPTestItem");