@terreno/api 57.3.0 → 57.6.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 (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -0,0 +1,275 @@
1
+ import {beforeEach, describe, it, spyOn} from "bun:test";
2
+ import {assert} from "chai";
3
+ import mongoose, {Schema} from "mongoose";
4
+
5
+ import type {User} from "../auth";
6
+ import {APIError} from "../errors";
7
+ import {Permissions} from "../permissions";
8
+ import * as executors from "../sync/executors";
9
+ import {handleCreate, handleDelete, handleList, handleRead, handleUpdate} from "./handlers";
10
+ import type {MCPRegistryEntry, MCPToolResult} from "./types";
11
+
12
+ interface NoteDocFields {
13
+ _id: mongoose.Types.ObjectId;
14
+ [key: string]: unknown;
15
+ }
16
+
17
+ const noteSchema = new Schema({
18
+ body: {description: "Note body", type: String},
19
+ ownerId: {description: "Owner of the note", type: Schema.Types.ObjectId},
20
+ secret: {description: "Redacted field", type: String},
21
+ title: {description: "Note title", required: true, type: String},
22
+ });
23
+
24
+ const getOrCreateModel = (): mongoose.Model<NoteDocFields> => {
25
+ try {
26
+ return mongoose.model<NoteDocFields>("MCPHandlerNote");
27
+ } catch {
28
+ return mongoose.model<NoteDocFields>("MCPHandlerNote", noteSchema);
29
+ }
30
+ };
31
+
32
+ const NoteModel = getOrCreateModel();
33
+
34
+ interface TestUser {
35
+ _id: mongoose.Types.ObjectId;
36
+ admin: boolean;
37
+ id: string;
38
+ }
39
+
40
+ const makeUser = (admin = false): TestUser => {
41
+ const _id = new mongoose.Types.ObjectId();
42
+ return {_id, admin, id: _id.toString()};
43
+ };
44
+
45
+ const asUser = (user: TestUser): User => user as unknown as User;
46
+
47
+ const owner = makeUser();
48
+ const stranger = makeUser();
49
+
50
+ const parseResult = (result: MCPToolResult): Record<string, unknown> => {
51
+ return JSON.parse(result.content[0].text) as Record<string, unknown>;
52
+ };
53
+
54
+ const errorText = (result: MCPToolResult): string => {
55
+ assert.isTrue(result.isError, "expected an error result");
56
+ return String(parseResult(result).error);
57
+ };
58
+
59
+ const createEntry = (overrides: Partial<MCPRegistryEntry["options"]> = {}): MCPRegistryEntry => ({
60
+ config: {
61
+ maxLimit: 10,
62
+ methods: ["create", "list", "read", "update", "delete"],
63
+ },
64
+ model: NoteModel,
65
+ modelName: "MCPHandlerNote",
66
+ options: {
67
+ permissions: {
68
+ create: [Permissions.IsAuthenticated],
69
+ delete: [Permissions.IsOwner],
70
+ list: [Permissions.IsAuthenticated],
71
+ read: [Permissions.IsOwner],
72
+ update: [Permissions.IsOwner],
73
+ },
74
+ preCreate: (body, req) => ({
75
+ ...(body as Record<string, unknown>),
76
+ ownerId: (req.user as unknown as TestUser | undefined)?._id,
77
+ }),
78
+ queryFields: ["title"],
79
+ ...overrides,
80
+ },
81
+ });
82
+
83
+ const throwingResponseHandler = async (): Promise<never> => {
84
+ throw new APIError({status: 422, title: "Cannot serialize"});
85
+ };
86
+
87
+ describe("MCP handlers", () => {
88
+ let entry: MCPRegistryEntry;
89
+
90
+ beforeEach(async () => {
91
+ await NoteModel.deleteMany({});
92
+ entry = createEntry();
93
+ });
94
+
95
+ describe("authentication and permissions", () => {
96
+ it("denies list to an authenticated user who fails the list permission", async () => {
97
+ const adminOnly = createEntry({
98
+ permissions: {...entry.options.permissions, list: [Permissions.IsAdmin]},
99
+ });
100
+ const result = await handleList(adminOnly, {}, asUser(owner));
101
+ assert.equal(errorText(result), "Permission denied: cannot list");
102
+ });
103
+
104
+ it("denies read to an authenticated user who fails the read permission", async () => {
105
+ const adminOnly = createEntry({
106
+ permissions: {...entry.options.permissions, read: [Permissions.IsAdmin]},
107
+ });
108
+ const doc = await NoteModel.create({ownerId: owner._id, title: "Private"});
109
+ const result = await handleRead(adminOnly, {id: doc._id.toString()}, asUser(owner));
110
+ assert.equal(errorText(result), "Permission denied: cannot read");
111
+ });
112
+
113
+ it("denies read of a document owned by someone else", async () => {
114
+ const doc = await NoteModel.create({ownerId: owner._id, title: "Mine"});
115
+ const result = await handleRead(entry, {id: doc._id.toString()}, asUser(stranger));
116
+ assert.equal(errorText(result), "Permission denied: cannot read this document");
117
+ });
118
+
119
+ it("denies update without a user", async () => {
120
+ const doc = await NoteModel.create({ownerId: owner._id, title: "Mine"});
121
+ const result = await handleUpdate(entry, {id: doc._id.toString(), title: "Nope"});
122
+ assert.equal(errorText(result), "Permission denied: authentication required");
123
+ });
124
+
125
+ it("denies delete without a user", async () => {
126
+ const doc = await NoteModel.create({ownerId: owner._id, title: "Mine"});
127
+ const result = await handleDelete(entry, {id: doc._id.toString()});
128
+ assert.equal(errorText(result), "Permission denied: authentication required");
129
+ });
130
+ });
131
+
132
+ describe("missing ids", () => {
133
+ it("returns not found when read is called without an id", async () => {
134
+ const result = await handleRead(entry, {}, asUser(owner));
135
+ assert.equal(errorText(result), "Document undefined not found");
136
+ });
137
+
138
+ it("returns not found when update gets a non-string id", async () => {
139
+ const result = await handleUpdate(entry, {id: 42, title: "x"}, asUser(owner));
140
+ assert.equal(errorText(result), "Document 42 not found");
141
+ });
142
+
143
+ it("returns not found when delete gets a non-string id", async () => {
144
+ const result = await handleDelete(entry, {id: null}, asUser(owner));
145
+ assert.equal(errorText(result), "Document null not found");
146
+ });
147
+ });
148
+
149
+ describe("populate resolution", () => {
150
+ it("treats a populate string of only separators as no populate request", async () => {
151
+ await NoteModel.create({ownerId: owner._id, title: "One"});
152
+ const result = await handleList(entry, {populate: " , ,"}, asUser(owner));
153
+ assert.notEqual(result.isError, true);
154
+ const parsed = parseResult(result) as {data: Array<{title: string}>};
155
+ assert.equal(parsed.data.length, 1);
156
+ assert.equal(parsed.data[0].title, "One");
157
+ });
158
+ });
159
+
160
+ describe("queryFilter", () => {
161
+ it("returns an empty page when queryFilter resolves to null", async () => {
162
+ await NoteModel.create({ownerId: owner._id, title: "Hidden"});
163
+ const filtered = createEntry({queryFilter: async () => null});
164
+ const result = await handleList(filtered, {}, asUser(owner));
165
+ assert.notEqual(result.isError, true);
166
+ assert.deepEqual(parseResult(result), {data: [], more: false, page: 1, total: 0});
167
+ });
168
+
169
+ it("surfaces an APIError thrown by queryFilter using its title", async () => {
170
+ const filtered = createEntry({
171
+ queryFilter: async () => {
172
+ throw new APIError({status: 403, title: "Filter refused"});
173
+ },
174
+ });
175
+ const result = await handleList(filtered, {}, asUser(owner));
176
+ assert.equal(errorText(result), "Filter refused");
177
+ });
178
+ });
179
+
180
+ describe("findById failures", () => {
181
+ it("rethrows non-cast errors from the read query", async () => {
182
+ const findSpy = spyOn(NoteModel, "findById").mockReturnValue({
183
+ exec: async () => {
184
+ throw new Error("connection dropped");
185
+ },
186
+ populate: function populate() {
187
+ return this;
188
+ },
189
+ } as unknown as ReturnType<typeof NoteModel.findById>);
190
+ try {
191
+ let thrown: unknown;
192
+ try {
193
+ await handleRead(entry, {id: new mongoose.Types.ObjectId().toString()}, asUser(owner));
194
+ } catch (error) {
195
+ thrown = error;
196
+ }
197
+ assert.instanceOf(thrown, Error);
198
+ assert.equal((thrown as Error).message, "connection dropped");
199
+ } finally {
200
+ findSpy.mockRestore();
201
+ }
202
+ });
203
+ });
204
+
205
+ describe("executor errors", () => {
206
+ it("maps a plain Error from the executor onto the error envelope", async () => {
207
+ const createSpy = spyOn(executors, "executeCreate").mockRejectedValue(
208
+ new Error("executor exploded")
209
+ );
210
+ try {
211
+ const result = await handleCreate(entry, {title: "Boom"}, asUser(owner));
212
+ assert.equal(errorText(result), "executor exploded");
213
+ } finally {
214
+ createSpy.mockRestore();
215
+ }
216
+ });
217
+ });
218
+
219
+ describe("response serialization", () => {
220
+ it("returns the APIError title when the responseHandler throws on list", async () => {
221
+ await NoteModel.create({ownerId: owner._id, title: "One"});
222
+ const failing = createEntry({responseHandler: throwingResponseHandler});
223
+ const result = await handleList(failing, {}, asUser(owner));
224
+ assert.equal(errorText(result), "Cannot serialize");
225
+ });
226
+
227
+ it("returns the APIError title when the responseHandler throws on create", async () => {
228
+ const failing = createEntry({responseHandler: throwingResponseHandler});
229
+ const result = await handleCreate(failing, {title: "One"}, asUser(owner));
230
+ assert.equal(errorText(result), "Cannot serialize");
231
+ assert.equal(await NoteModel.countDocuments({title: "One"}), 1);
232
+ });
233
+
234
+ it("returns the APIError title when the responseHandler throws on update", async () => {
235
+ const doc = await NoteModel.create({ownerId: owner._id, title: "Before"});
236
+ const failing = createEntry({responseHandler: throwingResponseHandler});
237
+ const result = await handleUpdate(
238
+ failing,
239
+ {id: doc._id.toString(), title: "After"},
240
+ asUser(owner)
241
+ );
242
+ assert.equal(errorText(result), "Cannot serialize");
243
+ const updated = await NoteModel.findById(doc._id);
244
+ assert.equal(updated?.title, "After");
245
+ });
246
+
247
+ it("wraps a non-APIError thrown by the responseHandler", async () => {
248
+ const doc = await NoteModel.create({ownerId: owner._id, title: "Read"});
249
+ const failing = createEntry({
250
+ responseHandler: async () => {
251
+ throw new Error("kaboom");
252
+ },
253
+ });
254
+ const result = await handleRead(failing, {id: doc._id.toString()}, asUser(owner));
255
+ assert.equal(errorText(result), "Response handler failed: kaboom");
256
+ });
257
+
258
+ it("converts Mongoose documents returned by mcpResponseHandler before redacting", async () => {
259
+ const doc = await NoteModel.create({ownerId: owner._id, secret: "s3cret", title: "Doc"});
260
+ const redacting: MCPRegistryEntry = {
261
+ ...entry,
262
+ config: {
263
+ ...entry.config,
264
+ excludeFields: ["secret"],
265
+ mcpResponseHandler: async (value) => value as never,
266
+ },
267
+ };
268
+ const result = await handleRead(redacting, {id: doc._id.toString()}, asUser(owner));
269
+ assert.notEqual(result.isError, true);
270
+ const parsed = parseResult(result) as {data: Record<string, unknown>};
271
+ assert.equal(parsed.data.title, "Doc");
272
+ assert.notProperty(parsed.data, "secret");
273
+ });
274
+ });
275
+ });
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",
@@ -6,6 +6,7 @@ import winston from "winston";
6
6
 
7
7
  import {winstonLogger} from "../logger";
8
8
  import {Permissions} from "../permissions";
9
+ import {getCurrentRequestContext, runWithRequestContext} from "../requestContext";
9
10
  import {generateAllTools, generateToolsForEntry} from "./toolGenerator";
10
11
  import type {MCPRegistryEntry} from "./types";
11
12
 
@@ -248,6 +249,86 @@ describe("tool-call observability", () => {
248
249
  expect(captureException).toHaveBeenCalledTimes(1);
249
250
  expect(captureException.mock.calls[0][0]).toBeInstanceOf(Error);
250
251
  });
252
+
253
+ it("attaches the calling user's id to the request context", async () => {
254
+ const entry = createEntry({
255
+ config: {methods: ["list"]},
256
+ options: {
257
+ permissions: {
258
+ create: [],
259
+ delete: [],
260
+ list: [Permissions.IsAuthenticated],
261
+ read: [],
262
+ update: [],
263
+ },
264
+ },
265
+ });
266
+ const [tool] = generateToolsForEntry(entry);
267
+ const user = {_id: new mongoose.Types.ObjectId(), admin: false, id: "user-123"};
268
+
269
+ await runWithRequestContext({}, async () => {
270
+ const result = await tool.handler({}, user);
271
+ expect(result.isError).not.toBe(true);
272
+ expect(getCurrentRequestContext()?.userId).toBe("user-123");
273
+ });
274
+ });
275
+
276
+ it("falls back to _id when the user has no id", async () => {
277
+ const [tool] = generateToolsForEntry(createEntry({config: {methods: ["list"]}}));
278
+ const objectId = new mongoose.Types.ObjectId();
279
+ const user = {_id: objectId, admin: false} as unknown as Parameters<typeof tool.handler>[1];
280
+
281
+ await runWithRequestContext({}, async () => {
282
+ await tool.handler({}, user);
283
+ expect(getCurrentRequestContext()?.userId).toBe(String(objectId));
284
+ });
285
+ });
286
+
287
+ it("logs and rethrows when a handler crashes", async () => {
288
+ process.env.USE_SENTRY_LOGGING = "true";
289
+ const crash = new Error("permission check exploded");
290
+ const entry = createEntry({
291
+ config: {methods: ["list"]},
292
+ options: {
293
+ allowAnonymous: true,
294
+ permissions: {
295
+ create: [],
296
+ delete: [],
297
+ list: [
298
+ async () => {
299
+ throw crash;
300
+ },
301
+ ],
302
+ read: [],
303
+ update: [],
304
+ },
305
+ },
306
+ });
307
+ const [tool] = generateToolsForEntry(entry);
308
+
309
+ const logs = await captureLogs(async () => {
310
+ let thrown: unknown;
311
+ try {
312
+ await tool.handler({});
313
+ } catch (error) {
314
+ thrown = error;
315
+ }
316
+ expect(thrown).toBe(crash);
317
+ });
318
+
319
+ const crashed = logs.find((line) => line.message.includes("MCP tool call crashed"));
320
+ expect(crashed?.level).toBe("error");
321
+ expect(crashed?.terrenoLabels).toEqual({
322
+ mcpMethod: "list",
323
+ mcpModel: "MCPToolGenTest",
324
+ mcpTool: "mcptoolgentests_list",
325
+ });
326
+ expect(logs.some((line) => line.level === "error" && line.message.includes("Caught:"))).toBe(
327
+ true
328
+ );
329
+ expect(captureException).toHaveBeenCalledTimes(1);
330
+ expect(captureException.mock.calls[0][0]).toBe(crash);
331
+ });
251
332
  });
252
333
 
253
334
  describe("tool pluralization", () => {