@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
@@ -91,10 +91,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
91
91
  exports.handleDelete = exports.handleUpdate = exports.handleCreate = exports.handleRead = exports.handleList = exports.getMCPErrorCause = void 0;
92
92
  var mongoose_1 = __importDefault(require("mongoose"));
93
93
  var api_1 = require("../api");
94
- var auth_1 = require("../auth");
95
94
  var errors_1 = require("../errors");
96
95
  var permissions_1 = require("../permissions");
97
- var modelRouterAccess_1 = require("../rbac/modelRouterAccess");
96
+ var executors_1 = require("../sync/executors");
98
97
  var transformers_1 = require("../transformers");
99
98
  var createMCPRequest_1 = require("./createMCPRequest");
100
99
  var query_1 = require("./query");
@@ -329,11 +328,15 @@ var missingDocumentResult = function (id) {
329
328
  var requiresAuthentication = function (entry, user) {
330
329
  return !user && entry.options.allowAnonymous !== true;
331
330
  };
332
- var hookFailureResult = function (label, error) {
331
+ /** Map executor/APIError failures onto the MCP error envelope. */
332
+ var fromExecutorError = function (error) {
333
333
  if ((0, errors_1.isAPIError)(error)) {
334
334
  return errorResult(error.title, error);
335
335
  }
336
- return errorResult("".concat(label, ": ").concat(errorMessage(error)), error);
336
+ return errorResult(errorMessage(error), error);
337
+ };
338
+ var deniedWriteFields = function (entry, phase) {
339
+ return (0, schemaGenerator_1.writeExcludeFields)(entry.config, (0, schemaGenerator_1.restWriteExcludeFields)(phase, entry.options.validation));
337
340
  };
338
341
  var serializeResponse = function (data, method, entry, user) { return __awaiter(void 0, void 0, void 0, function () {
339
342
  var excludeFields, result_1, responseHandler, result, error_2;
@@ -486,93 +489,37 @@ var handleRead = function (entry, args, user) { return __awaiter(void 0, void 0,
486
489
  }); };
487
490
  exports.handleRead = handleRead;
488
491
  var handleCreate = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
489
- var model, options, body, error_4, error_5, data, _a, error_6, populateQuery, _b, error_7, serialized;
490
- return __generator(this, function (_c) {
491
- switch (_c.label) {
492
+ var model, options, body, req, data, result, error_4, serialized;
493
+ return __generator(this, function (_a) {
494
+ switch (_a.label) {
492
495
  case 0:
493
496
  model = entry.model, options = entry.options;
494
497
  if (requiresAuthentication(entry, user)) {
495
498
  return [2 /*return*/, errorResult("Permission denied: authentication required")];
496
499
  }
497
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("create", options.permissions.create, user)];
500
+ body = omitDeniedWriteFields(args, deniedWriteFields(entry, "create"));
501
+ req = (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user });
502
+ _a.label = 1;
498
503
  case 1:
499
- if (!(_c.sent())) {
500
- return [2 /*return*/, errorResult("Permission denied: cannot create")];
501
- }
502
- body = omitDeniedWriteFields(args, (0, schemaGenerator_1.writeExcludeFields)(entry.config, (0, schemaGenerator_1.restWriteExcludeFields)("create", options.validation)));
503
- try {
504
- body = (0, transformers_1.transform)(options, body, "create", user);
505
- }
506
- catch (error) {
507
- return [2 /*return*/, errorResult("Transform failed: ".concat(errorMessage(error)), error)];
508
- }
509
- if (!options.preCreate) return [3 /*break*/, 5];
510
- _c.label = 2;
511
- case 2:
512
- _c.trys.push([2, 4, , 5]);
513
- return [4 /*yield*/, options.preCreate(body, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }))];
514
- case 3:
515
- body = _c.sent();
516
- if (body === null || body === undefined) {
517
- return [2 /*return*/, errorResult("Create not allowed")];
518
- }
519
- return [3 /*break*/, 5];
520
- case 4:
521
- error_4 = _c.sent();
522
- return [2 /*return*/, hookFailureResult("preCreate hook failed", error_4)];
523
- case 5:
524
- body = (0, auth_1.omitUserRolesFromWriteBody)(entry.modelName, options.accessControl, body);
525
- _c.label = 6;
526
- case 6:
527
- _c.trys.push([6, 8, , 9]);
528
- return [4 /*yield*/, (0, modelRouterAccess_1.validateAccessWritePayload)({
504
+ _a.trys.push([1, 3, , 4]);
505
+ return [4 /*yield*/, (0, executors_1.executeCreate)({
529
506
  body: body,
507
+ model: model,
530
508
  options: options,
531
- phase: "create",
509
+ req: req,
532
510
  user: user,
511
+ writeModelName: entry.modelName,
533
512
  })];
534
- case 7:
535
- _c.sent();
536
- return [3 /*break*/, 9];
537
- case 8:
538
- error_5 = _c.sent();
539
- if ((0, errors_1.isAPIError)(error_5)) {
540
- return [2 /*return*/, errorResult(error_5.title, error_5)];
541
- }
542
- return [2 /*return*/, errorResult("Write validation failed: ".concat(errorMessage(error_5)), error_5)];
543
- case 9:
544
- _c.trys.push([9, 11, , 12]);
545
- _a = asDocument;
546
- return [4 /*yield*/, model.create(body)];
547
- case 10:
548
- data = _a.apply(void 0, [_c.sent()]);
549
- return [3 /*break*/, 12];
550
- case 11:
551
- error_6 = _c.sent();
552
- return [2 /*return*/, errorResult("Create failed: ".concat(errorMessage(error_6)), error_6)];
553
- case 12:
554
- if (!options.populatePaths) return [3 /*break*/, 14];
555
- populateQuery = (0, api_1.addPopulateToQuery)(model.findById(data === null || data === void 0 ? void 0 : data._id), options.populatePaths);
556
- _b = asDocument;
557
- return [4 /*yield*/, populateQuery.exec()];
558
- case 13:
559
- data = _b.apply(void 0, [_c.sent()]);
560
- _c.label = 14;
561
- case 14:
562
- if (!options.postCreate) return [3 /*break*/, 18];
563
- _c.label = 15;
564
- case 15:
565
- _c.trys.push([15, 17, , 18]);
566
- return [4 /*yield*/, options.postCreate(data, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }))];
567
- case 16:
568
- _c.sent();
569
- return [3 /*break*/, 18];
570
- case 17:
571
- error_7 = _c.sent();
572
- return [2 /*return*/, hookFailureResult("postCreate hook failed", error_7)];
573
- case 18: return [4 /*yield*/, serializeResponse(data, "create", entry, user)];
574
- case 19:
575
- serialized = _c.sent();
513
+ case 2:
514
+ result = _a.sent();
515
+ data = result.doc;
516
+ return [3 /*break*/, 4];
517
+ case 3:
518
+ error_4 = _a.sent();
519
+ return [2 /*return*/, fromExecutorError(error_4)];
520
+ case 4: return [4 /*yield*/, serializeResponse(data, "create", entry, user)];
521
+ case 5:
522
+ serialized = _a.sent();
576
523
  if ("error" in serialized) {
577
524
  return [2 /*return*/, serialized.error];
578
525
  }
@@ -582,113 +529,43 @@ var handleCreate = function (entry, args, user) { return __awaiter(void 0, void
582
529
  }); };
583
530
  exports.handleCreate = handleCreate;
584
531
  var handleUpdate = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
585
- var model, options, id, updateFields, documentId, doc, body, error_8, error_9, prevDoc, error_10, populateQuery, _a, error_11, serialized;
586
- return __generator(this, function (_b) {
587
- switch (_b.label) {
532
+ var model, options, id, updateFields, documentId, body, req, doc, result, error_5, serialized;
533
+ return __generator(this, function (_a) {
534
+ switch (_a.label) {
588
535
  case 0:
589
536
  model = entry.model, options = entry.options;
590
537
  id = args.id, updateFields = __rest(args, ["id"]);
591
538
  if (requiresAuthentication(entry, user)) {
592
539
  return [2 /*return*/, errorResult("Permission denied: authentication required")];
593
540
  }
594
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("update", options.permissions.update, user)];
595
- case 1:
596
- if (!(_b.sent())) {
597
- return [2 /*return*/, errorResult("Permission denied: cannot update")];
598
- }
599
541
  documentId = asOptionalString(id);
600
542
  if (!documentId) {
601
543
  return [2 /*return*/, missingDocumentResult(id)];
602
544
  }
603
- return [4 /*yield*/, execFindByIdQuery((0, api_1.addPopulateToQuery)(model.findById(documentId), options.populatePaths))];
604
- case 2:
605
- doc = _b.sent();
606
- if (!doc) {
607
- return [2 /*return*/, missingDocumentResult(documentId)];
608
- }
609
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("update", options.permissions.update, user, doc)];
610
- case 3:
611
- if (!(_b.sent())) {
612
- return [2 /*return*/, errorResult("Permission denied: cannot update this document")];
613
- }
614
- body = omitDeniedWriteFields(updateFields, (0, schemaGenerator_1.writeExcludeFields)(entry.config, (0, schemaGenerator_1.restWriteExcludeFields)("update", options.validation)));
615
- try {
616
- body = (0, transformers_1.transform)(options, body, "update", user);
617
- }
618
- catch (error) {
619
- return [2 /*return*/, errorResult("Transform failed: ".concat(errorMessage(error)), error)];
620
- }
621
- if (!options.preUpdate) return [3 /*break*/, 7];
622
- _b.label = 4;
623
- case 4:
624
- _b.trys.push([4, 6, , 7]);
625
- return [4 /*yield*/, options.preUpdate(body, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }))];
626
- case 5:
627
- body = _b.sent();
628
- if (body === null || body === undefined) {
629
- return [2 /*return*/, errorResult("Update not allowed")];
630
- }
631
- return [3 /*break*/, 7];
632
- case 6:
633
- error_8 = _b.sent();
634
- return [2 /*return*/, hookFailureResult("preUpdate hook failed", error_8)];
635
- case 7:
636
- body = (0, auth_1.omitUserRolesFromWriteBody)(entry.modelName, options.accessControl, body);
637
- _b.label = 8;
638
- case 8:
639
- _b.trys.push([8, 10, , 11]);
640
- return [4 /*yield*/, (0, modelRouterAccess_1.validateAccessWritePayload)({
545
+ body = omitDeniedWriteFields(updateFields, deniedWriteFields(entry, "update"));
546
+ req = (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user });
547
+ _a.label = 1;
548
+ case 1:
549
+ _a.trys.push([1, 3, , 4]);
550
+ return [4 /*yield*/, (0, executors_1.executeUpdate)({
641
551
  body: body,
642
- doc: doc,
552
+ id: documentId,
553
+ model: model,
643
554
  options: options,
644
- phase: "write",
555
+ req: req,
645
556
  user: user,
557
+ writeModelName: entry.modelName,
646
558
  })];
647
- case 9:
648
- _b.sent();
649
- return [3 /*break*/, 11];
650
- case 10:
651
- error_9 = _b.sent();
652
- if ((0, errors_1.isAPIError)(error_9)) {
653
- return [2 /*return*/, errorResult(error_9.title, error_9)];
654
- }
655
- return [2 /*return*/, errorResult("Write validation failed: ".concat(errorMessage(error_9)), error_9)];
656
- case 11:
657
- prevDoc = doc.toObject();
658
- _b.label = 12;
659
- case 12:
660
- _b.trys.push([12, 14, , 15]);
661
- doc.set(body);
662
- return [4 /*yield*/, doc.save()];
663
- case 13:
664
- _b.sent();
665
- return [3 /*break*/, 15];
666
- case 14:
667
- error_10 = _b.sent();
668
- return [2 /*return*/, errorResult("Update failed: ".concat(errorMessage(error_10)), error_10)];
669
- case 15:
670
- if (!options.populatePaths) return [3 /*break*/, 17];
671
- populateQuery = (0, api_1.addPopulateToQuery)(model.findById(doc._id), options.populatePaths);
672
- _a = asDocument;
673
- return [4 /*yield*/, populateQuery.exec()];
674
- case 16:
675
- doc = _a.apply(void 0, [_b.sent()]);
676
- _b.label = 17;
677
- case 17:
678
- if (!options.postUpdate) return [3 /*break*/, 21];
679
- _b.label = 18;
680
- case 18:
681
- _b.trys.push([18, 20, , 21]);
682
- return [4 /*yield*/, options.postUpdate(doc, body, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }), prevDoc)];
683
- case 19:
684
- _b.sent();
685
- return [3 /*break*/, 21];
686
- case 20:
687
- error_11 = _b.sent();
688
- return [2 /*return*/, hookFailureResult("postUpdate hook failed", error_11)];
689
- case 21: return [4 /*yield*/, serializeResponse(doc, "update", entry, user)];
690
- case 22:
691
- serialized = _b.sent();
559
+ case 2:
560
+ result = _a.sent();
561
+ doc = result.doc;
562
+ return [3 /*break*/, 4];
563
+ case 3:
564
+ error_5 = _a.sent();
565
+ return [2 /*return*/, fromExecutorError(error_5)];
566
+ case 4: return [4 /*yield*/, serializeResponse(doc, "update", entry, user)];
567
+ case 5:
568
+ serialized = _a.sent();
692
569
  if ("error" in serialized) {
693
570
  return [2 /*return*/, serialized.error];
694
571
  }
@@ -698,7 +575,7 @@ var handleUpdate = function (entry, args, user) { return __awaiter(void 0, void
698
575
  }); };
699
576
  exports.handleUpdate = handleUpdate;
700
577
  var handleDelete = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
701
- var model, options, id, documentId, doc, result, error_12, error_13, error_14;
578
+ var model, options, id, documentId, error_6;
702
579
  return __generator(this, function (_a) {
703
580
  switch (_a.label) {
704
581
  case 0:
@@ -707,70 +584,27 @@ var handleDelete = function (entry, args, user) { return __awaiter(void 0, void
707
584
  if (requiresAuthentication(entry, user)) {
708
585
  return [2 /*return*/, errorResult("Permission denied: authentication required")];
709
586
  }
710
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user)];
711
- case 1:
712
- if (!(_a.sent())) {
713
- return [2 /*return*/, errorResult("Permission denied: cannot delete")];
714
- }
715
587
  documentId = asOptionalString(id);
716
588
  if (!documentId) {
717
589
  return [2 /*return*/, missingDocumentResult(id)];
718
590
  }
719
- return [4 /*yield*/, execFindByIdQuery((0, api_1.addPopulateToQuery)(model.findById(documentId), options.populatePaths))];
591
+ _a.label = 1;
592
+ case 1:
593
+ _a.trys.push([1, 3, , 4]);
594
+ return [4 /*yield*/, (0, executors_1.executeDelete)({
595
+ id: documentId,
596
+ model: model,
597
+ options: options,
598
+ req: (0, createMCPRequest_1.createMCPRequest)({ body: args, user: user }),
599
+ user: user,
600
+ })];
720
601
  case 2:
721
- doc = _a.sent();
722
- if (!doc) {
723
- return [2 /*return*/, missingDocumentResult(documentId)];
724
- }
725
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user, doc)];
726
- case 3:
727
- if (!(_a.sent())) {
728
- return [2 /*return*/, errorResult("Permission denied: cannot delete this document")];
729
- }
730
- if (!options.preDelete) return [3 /*break*/, 7];
731
- _a.label = 4;
732
- case 4:
733
- _a.trys.push([4, 6, , 7]);
734
- return [4 /*yield*/, options.preDelete(doc, (0, createMCPRequest_1.createMCPRequest)({ body: args, user: user }))];
735
- case 5:
736
- result = _a.sent();
737
- if (result === null || result === undefined) {
738
- return [2 /*return*/, errorResult("Delete not allowed")];
739
- }
740
- return [3 /*break*/, 7];
741
- case 6:
742
- error_12 = _a.sent();
743
- return [2 /*return*/, hookFailureResult("preDelete hook failed", error_12)];
744
- case 7:
745
- _a.trys.push([7, 12, , 13]);
746
- if (!(Object.keys(model.schema.paths).includes("deleted") &&
747
- model.schema.paths.deleted.instance === "Boolean")) return [3 /*break*/, 9];
748
- doc.deleted = true;
749
- return [4 /*yield*/, doc.save()];
750
- case 8:
751
- _a.sent();
752
- return [3 /*break*/, 11];
753
- case 9: return [4 /*yield*/, doc.deleteOne()];
754
- case 10:
755
602
  _a.sent();
756
- _a.label = 11;
757
- case 11: return [3 /*break*/, 13];
758
- case 12:
759
- error_13 = _a.sent();
760
- return [2 /*return*/, errorResult("Delete failed: ".concat(errorMessage(error_13)), error_13)];
761
- case 13:
762
- if (!options.postDelete) return [3 /*break*/, 17];
763
- _a.label = 14;
764
- case 14:
765
- _a.trys.push([14, 16, , 17]);
766
- return [4 /*yield*/, options.postDelete((0, createMCPRequest_1.createMCPRequest)({ body: args, user: user }), doc)];
767
- case 15:
768
- _a.sent();
769
- return [3 /*break*/, 17];
770
- case 16:
771
- error_14 = _a.sent();
772
- return [2 /*return*/, hookFailureResult("postDelete hook failed", error_14)];
773
- case 17: return [2 /*return*/, textResult(JSON.stringify({ success: true }))];
603
+ return [3 /*break*/, 4];
604
+ case 3:
605
+ error_6 = _a.sent();
606
+ return [2 /*return*/, fromExecutorError(error_6)];
607
+ case 4: return [2 /*return*/, textResult(JSON.stringify({ success: true }))];
774
608
  }
775
609
  });
776
610
  }); };
@@ -1,18 +1,5 @@
1
1
  import type { ModelRouterOptions } from "../api";
2
2
  import type { MCPConfig, MCPToolArgs } from "./types";
3
- /** Args consumed by pagination/population, never treated as filters. */
4
- export declare const RESERVED_LIST_ARGS: Set<string>;
5
- /**
6
- * Top-level logical operators an MCP client may send. Mirrors the REST list endpoint,
7
- * which allows `$and` / `$or` and validates every nested key against `queryFields`.
8
- */
9
- export declare const ALLOWED_LOGICAL_OPERATORS: Set<string>;
10
- /**
11
- * Comparison operators allowed inside a field's value, e.g. `{completed: {$ne: true}}`.
12
- * Deliberately excludes evaluation operators that can run arbitrary code or ignore
13
- * indexes ($where, $expr, $function, $accumulator, $jsonSchema, $text).
14
- */
15
- export declare const ALLOWED_FIELD_OPERATORS: Set<string>;
16
3
  export interface BuildListQueryResult {
17
4
  query?: Record<string, unknown>;
18
5
  error?: string;
@@ -25,8 +12,8 @@ export interface BuildListQueryResult {
25
12
  * Anything else is rejected rather than silently dropped so the calling LLM can correct
26
13
  * itself instead of receiving results for a query it did not ask for.
27
14
  */
28
- export declare const buildListQuery: ({ args, config, options, }: {
15
+ export declare const buildListQuery: <T>({ args, config, options, }: {
29
16
  args: MCPToolArgs;
30
17
  config: MCPConfig;
31
- options: ModelRouterOptions<any>;
18
+ options: ModelRouterOptions<T>;
32
19
  }) => BuildListQueryResult;
package/dist/mcp/query.js CHANGED
@@ -38,21 +38,21 @@ var __read = (this && this.__read) || function (o, n) {
38
38
  return ar;
39
39
  };
40
40
  Object.defineProperty(exports, "__esModule", { value: true });
41
- exports.buildListQuery = exports.ALLOWED_FIELD_OPERATORS = exports.ALLOWED_LOGICAL_OPERATORS = exports.RESERVED_LIST_ARGS = void 0;
41
+ exports.buildListQuery = void 0;
42
42
  var schemaGenerator_1 = require("./schemaGenerator");
43
43
  /** Args consumed by pagination/population, never treated as filters. */
44
- exports.RESERVED_LIST_ARGS = new Set(["limit", "page", "populate", "sort"]);
44
+ var RESERVED_LIST_ARGS = new Set(["limit", "page", "populate", "sort"]);
45
45
  /**
46
46
  * Top-level logical operators an MCP client may send. Mirrors the REST list endpoint,
47
47
  * which allows `$and` / `$or` and validates every nested key against `queryFields`.
48
48
  */
49
- exports.ALLOWED_LOGICAL_OPERATORS = new Set(["$and", "$or"]);
49
+ var ALLOWED_LOGICAL_OPERATORS = new Set(["$and", "$or"]);
50
50
  /**
51
51
  * Comparison operators allowed inside a field's value, e.g. `{completed: {$ne: true}}`.
52
52
  * Deliberately excludes evaluation operators that can run arbitrary code or ignore
53
53
  * indexes ($where, $expr, $function, $accumulator, $jsonSchema, $text).
54
54
  */
55
- exports.ALLOWED_FIELD_OPERATORS = new Set([
55
+ var ALLOWED_FIELD_OPERATORS = new Set([
56
56
  "$all",
57
57
  "$eq",
58
58
  "$exists",
@@ -103,7 +103,7 @@ var findDisallowedOperator = function (value) {
103
103
  try {
104
104
  for (var _c = __values(Object.entries(value)), _d = _c.next(); !_d.done; _d = _c.next()) {
105
105
  var _e = __read(_d.value, 2), key = _e[0], nested = _e[1];
106
- if (key.startsWith("$") && !exports.ALLOWED_FIELD_OPERATORS.has(key)) {
106
+ if (key.startsWith("$") && !ALLOWED_FIELD_OPERATORS.has(key)) {
107
107
  return key;
108
108
  }
109
109
  var found = findDisallowedOperator(nested);
@@ -133,7 +133,7 @@ var validateLogicalBranch = function (branch, allowedQueryFields) {
133
133
  try {
134
134
  for (var _b = __values(Object.entries(branch)), _c = _b.next(); !_c.done; _c = _b.next()) {
135
135
  var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
136
- if (exports.ALLOWED_LOGICAL_OPERATORS.has(key)) {
136
+ if (ALLOWED_LOGICAL_OPERATORS.has(key)) {
137
137
  var error = validateLogicalClause(key, value, allowedQueryFields);
138
138
  if (error) {
139
139
  return error;
@@ -199,10 +199,10 @@ var buildListQuery = function (_a) {
199
199
  try {
200
200
  for (var _f = __values(Object.entries(args)), _g = _f.next(); !_g.done; _g = _f.next()) {
201
201
  var _h = __read(_g.value, 2), key = _h[0], value = _h[1];
202
- if (exports.RESERVED_LIST_ARGS.has(key) || value === undefined) {
202
+ if (RESERVED_LIST_ARGS.has(key) || value === undefined) {
203
203
  continue;
204
204
  }
205
- if (exports.ALLOWED_LOGICAL_OPERATORS.has(key)) {
205
+ if (ALLOWED_LOGICAL_OPERATORS.has(key)) {
206
206
  var error = validateLogicalClause(key, value, allowedQueryFields);
207
207
  if (error) {
208
208
  return { error: error };
@@ -9,11 +9,7 @@ export interface MCPCustomTool {
9
9
  name: string;
10
10
  zodSchema: ZodType;
11
11
  }
12
- export declare const registerMCPModel: (model: Model<any>, config: MCPConfig, options: ModelRouterOptions<any>) => void;
13
- /**
14
- * Replace options on an existing MCP registry entry after TerrenoApp injects
15
- * accessControl (same contract as updateRealtimeRegistryOptions).
16
- */
12
+ export declare const registerMCPModel: <T>(model: Model<T>, config: MCPConfig, options: ModelRouterOptions<T>) => void;
17
13
  export declare const updateMCPRegistryOptions: (modelName: string, options: ModelRouterOptions<unknown>) => void;
18
14
  export declare const registerMCPTool: (tool: MCPCustomTool) => void;
19
15
  export declare const getMCPRegistry: () => MCPRegistryEntry[];
@@ -1,33 +1,37 @@
1
1
  "use strict";
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
12
+ };
2
13
  Object.defineProperty(exports, "__esModule", { value: true });
3
14
  exports.clearMCPRegistry = exports.getMCPCustomTools = exports.getMCPRegistry = exports.registerMCPTool = exports.updateMCPRegistryOptions = exports.registerMCPModel = void 0;
4
- var mcpRegistry = [];
15
+ var collectionRegistry_1 = require("../collectionRegistry");
5
16
  var mcpCustomTools = [];
6
- var registerMCPModel = function (
7
- // noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
8
- // biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
9
- model, config,
10
- // noExplicitAny: ModelRouterOptions is generic over the consumer's document type
11
- // biome-ignore lint/suspicious/noExplicitAny: ModelRouterOptions is generic over the consumer's document type
12
- options) {
13
- mcpRegistry.push({
14
- config: config,
17
+ var findCollectionByModelName = function (modelName) {
18
+ return (0, collectionRegistry_1.listCollections)().find(function (record) { return record.model.modelName === modelName; });
19
+ };
20
+ var mcpRoutePathForModel = function (model) { var _a, _b; return (_b = (_a = findCollectionByModelName(model.modelName)) === null || _a === void 0 ? void 0 : _a.routePath) !== null && _b !== void 0 ? _b : "/_mcp/".concat(model.modelName); };
21
+ var registerMCPModel = function (model, config, options) {
22
+ (0, collectionRegistry_1.registerCollection)({
15
23
  model: model,
16
- modelName: model.modelName,
17
- options: options,
24
+ options: __assign(__assign({}, options), { mcp: config }),
25
+ routePath: mcpRoutePathForModel(model),
18
26
  });
19
27
  };
20
28
  exports.registerMCPModel = registerMCPModel;
21
- /**
22
- * Replace options on an existing MCP registry entry after TerrenoApp injects
23
- * accessControl (same contract as updateRealtimeRegistryOptions).
24
- */
25
29
  var updateMCPRegistryOptions = function (modelName, options) {
26
- var existing = mcpRegistry.find(function (entry) { return entry.modelName === modelName; });
30
+ var existing = findCollectionByModelName(modelName);
27
31
  if (!existing) {
28
32
  return;
29
33
  }
30
- existing.options = options;
34
+ (0, collectionRegistry_1.replaceCollectionOptions)(existing.routePath, options);
31
35
  };
32
36
  exports.updateMCPRegistryOptions = updateMCPRegistryOptions;
33
37
  var registerMCPTool = function (tool) {
@@ -40,7 +44,14 @@ var registerMCPTool = function (tool) {
40
44
  };
41
45
  exports.registerMCPTool = registerMCPTool;
42
46
  var getMCPRegistry = function () {
43
- return mcpRegistry;
47
+ return (0, collectionRegistry_1.listCollections)()
48
+ .filter(function (record) { return record.surfaces.mcp; })
49
+ .map(function (record) { return ({
50
+ config: record.options.mcp,
51
+ model: record.model,
52
+ modelName: record.model.modelName,
53
+ options: record.options,
54
+ }); });
44
55
  };
45
56
  exports.getMCPRegistry = getMCPRegistry;
46
57
  var getMCPCustomTools = function () {
@@ -48,7 +59,7 @@ var getMCPCustomTools = function () {
48
59
  };
49
60
  exports.getMCPCustomTools = getMCPCustomTools;
50
61
  var clearMCPRegistry = function () {
51
- mcpRegistry.length = 0;
62
+ (0, collectionRegistry_1.clearCollectionRegistry)();
52
63
  mcpCustomTools.length = 0;
53
64
  };
54
65
  exports.clearMCPRegistry = clearMCPRegistry;
@@ -3,12 +3,7 @@ import { type ZodType } from "zod";
3
3
  import type { PopulatePath } from "../populate";
4
4
  import type { MCPConfig, MCPMethod } from "./types";
5
5
  export declare const isFieldExcluded: (fieldPath: string, excludeFields: string[]) => boolean;
6
- /**
7
- * REST write denylist from `validation.excludeFromCreate` / `excludeFromUpdate`.
8
- * MCP create/update must apply the same keys REST strips in `validateModelRequestBody`.
9
- */
10
6
  export declare const restWriteExcludeFields: (method: MCPMethod, validation: unknown) => string[];
11
- /** MCP `excludeFields` plus REST write denylist — used for tool schemas and persist. */
12
7
  export declare const writeExcludeFields: (config: MCPConfig, restExcludeFields: string[]) => string[];
13
- export declare const generateInputSchema: (model: Model<any>, method: MCPMethod, config: MCPConfig, queryFields?: string[], populatePaths?: PopulatePath[], restExcludeFields?: string[]) => ZodType;
14
- export declare const generateToolDescription: (model: Model<any>, method: MCPMethod, config: MCPConfig, queryFields?: string[], populatePaths?: PopulatePath[], restExcludeFields?: string[]) => string;
8
+ export declare const generateInputSchema: <T>(model: Model<T>, method: MCPMethod, config: MCPConfig, queryFields?: string[], populatePaths?: PopulatePath[], restExcludeFields?: string[]) => ZodType;
9
+ export declare const generateToolDescription: <T>(model: Model<T>, method: MCPMethod, config: MCPConfig, queryFields?: string[], populatePaths?: PopulatePath[], restExcludeFields?: string[]) => string;