@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
@@ -0,0 +1,307 @@
1
+ import type {Application, NextFunction, Request, Response} from "express";
2
+ import {DateTime} from "luxon";
3
+ import mongoose from "mongoose";
4
+
5
+ import {asyncHandler, type OpenApiMiddleware} from "../api";
6
+ import {authenticateMiddleware, type User} from "../auth";
7
+ import {BadRequestError, NotFoundError, UnauthorizedError} from "../errors";
8
+ import {McpServiceToken} from "../models/mcpServiceToken";
9
+ import {createOpenApiBuilder} from "../openApiBuilder";
10
+ import type {McpServiceTokenDocument} from "../types/mcpServiceToken";
11
+
12
+ export const MAX_ACTIVE_MCP_SERVICE_TOKENS = 10;
13
+
14
+ const DEFAULT_LIST_LIMIT = 100;
15
+ const MAX_LIST_LIMIT = 100;
16
+
17
+ export interface McpServiceTokenRoutesOptions {
18
+ openApi?: OpenApiMiddleware;
19
+ publicMcpUrl?: string;
20
+ }
21
+
22
+ export type McpServiceTokensAppOption =
23
+ | boolean
24
+ | {
25
+ enabled: boolean;
26
+ publicMcpUrl?: string;
27
+ };
28
+
29
+ export const resolveMcpServiceTokensOption = (
30
+ option: McpServiceTokensAppOption | undefined
31
+ ): {enabled: boolean; publicMcpUrl?: string} => {
32
+ if (option === true) {
33
+ return {enabled: true};
34
+ }
35
+ if (option && typeof option === "object" && option.enabled === true) {
36
+ return {enabled: true, publicMcpUrl: option.publicMcpUrl};
37
+ }
38
+ return {enabled: false};
39
+ };
40
+
41
+ const bearerFromRequest = (req: Request): string | undefined => {
42
+ const authorization = req.headers.authorization;
43
+ if (typeof authorization !== "string") {
44
+ return undefined;
45
+ }
46
+ if (authorization.startsWith("Bearer ")) {
47
+ return authorization.slice("Bearer ".length);
48
+ }
49
+ return authorization;
50
+ };
51
+
52
+ const rejectMcpServiceTokenBearer = (req: Request, _res: Response, next: NextFunction): void => {
53
+ const token = bearerFromRequest(req);
54
+ if (token?.startsWith("mcp_")) {
55
+ next(new UnauthorizedError("MCP service tokens cannot manage service tokens"));
56
+ return;
57
+ }
58
+ next();
59
+ };
60
+
61
+ const requireAuthenticatedUser = (req: Request): User => {
62
+ const user = req.user as unknown as User | undefined;
63
+ if (!user?._id) {
64
+ throw new UnauthorizedError("Unauthorized");
65
+ }
66
+ return user;
67
+ };
68
+
69
+ const parseName = (value: unknown): string => {
70
+ if (typeof value !== "string") {
71
+ throw new BadRequestError({title: "name is required"});
72
+ }
73
+ const name = value.trim();
74
+ if (!name) {
75
+ throw new BadRequestError({title: "name is required"});
76
+ }
77
+ return name;
78
+ };
79
+
80
+ const parseExpiresAt = (value: unknown): Date | undefined => {
81
+ if (value === undefined || value === null || value === "") {
82
+ return undefined;
83
+ }
84
+ if (typeof value !== "string") {
85
+ throw new BadRequestError({title: "expiresAt must be an ISO-8601 datetime string"});
86
+ }
87
+ const parsed = DateTime.fromISO(value, {setZone: true});
88
+ if (!parsed.isValid) {
89
+ throw new BadRequestError({title: "expiresAt must be an ISO-8601 datetime string"});
90
+ }
91
+ if (parsed.toMillis() <= DateTime.now().toMillis()) {
92
+ throw new BadRequestError({title: "expiresAt must be in the future"});
93
+ }
94
+ return parsed.toUTC().toJSDate();
95
+ };
96
+
97
+ const parsePage = (value: unknown): number => {
98
+ if (value === undefined) {
99
+ return 1;
100
+ }
101
+ const page = Number(value);
102
+ if (!Number.isInteger(page) || page < 1) {
103
+ throw new BadRequestError({code: "invalid-page", title: "Invalid page"});
104
+ }
105
+ return page;
106
+ };
107
+
108
+ const parseLimit = (value: unknown): number => {
109
+ if (value === undefined) {
110
+ return DEFAULT_LIST_LIMIT;
111
+ }
112
+ const limit = Number(value);
113
+ if (!Number.isInteger(limit) || limit < 1) {
114
+ throw new BadRequestError({title: "Invalid limit"});
115
+ }
116
+ return Math.min(limit, MAX_LIST_LIMIT);
117
+ };
118
+
119
+ const resolveMcpUrl = (req: Request, publicMcpUrl?: string): string => {
120
+ const configured = publicMcpUrl ?? process.env.BETTER_AUTH_URL;
121
+ if (configured) {
122
+ const base = configured.replace(/\/$/, "");
123
+ if (base.endsWith("/mcp")) {
124
+ return base;
125
+ }
126
+ return `${base}/mcp`;
127
+ }
128
+ const host = req.get("host") ?? "localhost";
129
+ return `${req.protocol}://${host}/mcp`;
130
+ };
131
+
132
+ const toListItem = (doc: McpServiceTokenDocument): Record<string, unknown> => {
133
+ return {
134
+ created: doc.created.toISOString(),
135
+ expiresAt: doc.expiresAt ? doc.expiresAt.toISOString() : null,
136
+ id: String(doc._id),
137
+ lastUsedAt: doc.lastUsedAt ? doc.lastUsedAt.toISOString() : null,
138
+ name: doc.name,
139
+ revokedAt: doc.revokedAt ? doc.revokedAt.toISOString() : null,
140
+ tokenPrefix: doc.tokenPrefix,
141
+ };
142
+ };
143
+
144
+ const serviceTokenGuards = [rejectMcpServiceTokenBearer, authenticateMiddleware()];
145
+
146
+ const createdTokenFields = {
147
+ created: {type: "string"},
148
+ expiresAt: {type: "string"},
149
+ id: {type: "string"},
150
+ mcpUrl: {type: "string"},
151
+ name: {type: "string"},
152
+ token: {type: "string"},
153
+ tokenPrefix: {type: "string"},
154
+ };
155
+
156
+ export const addMcpServiceTokenRoutes = (
157
+ app: Application,
158
+ options: McpServiceTokenRoutesOptions = {}
159
+ ): void => {
160
+ const openApiOptions = {openApi: options.openApi};
161
+
162
+ app.post(
163
+ "/mcp/service-tokens",
164
+ [
165
+ ...serviceTokenGuards,
166
+ createOpenApiBuilder(openApiOptions)
167
+ .withTags(["mcp"])
168
+ .withOperationId("createMcpServiceToken")
169
+ .withSummary("Create an MCP service token")
170
+ .withDescription(
171
+ "Mints a personal MCP service token that acts as the signed-in user on POST /mcp. The plaintext token is returned once."
172
+ )
173
+ .withRequestBody({
174
+ expiresAt: {
175
+ description: "Optional ISO-8601 expiry; omit for a token that does not expire",
176
+ type: "string",
177
+ },
178
+ name: {
179
+ description: "User-visible label for this token",
180
+ required: true,
181
+ type: "string",
182
+ },
183
+ })
184
+ .withResponse(200, {
185
+ data: {
186
+ properties: createdTokenFields,
187
+ type: "object",
188
+ },
189
+ })
190
+ .build(),
191
+ ],
192
+ asyncHandler(async (req, res) => {
193
+ const user = requireAuthenticatedUser(req);
194
+ const name = parseName(req.body?.name);
195
+ const expiresAt = parseExpiresAt(req.body?.expiresAt);
196
+ const activeCount = await McpServiceToken.countActiveForUser(
197
+ new mongoose.Types.ObjectId(String(user._id))
198
+ );
199
+ if (activeCount >= MAX_ACTIVE_MCP_SERVICE_TOKENS) {
200
+ throw new BadRequestError({
201
+ title: `Maximum of ${MAX_ACTIVE_MCP_SERVICE_TOKENS} active MCP service tokens`,
202
+ });
203
+ }
204
+ const issued = await McpServiceToken.issueFor({_id: user._id}, {expiresAt, name});
205
+ return res.json({
206
+ data: {
207
+ created: issued.mcpServiceToken.created.toISOString(),
208
+ expiresAt: issued.mcpServiceToken.expiresAt
209
+ ? issued.mcpServiceToken.expiresAt.toISOString()
210
+ : null,
211
+ id: String(issued.mcpServiceToken._id),
212
+ mcpUrl: resolveMcpUrl(req, options.publicMcpUrl),
213
+ name: issued.mcpServiceToken.name,
214
+ token: issued.token,
215
+ tokenPrefix: issued.mcpServiceToken.tokenPrefix,
216
+ },
217
+ });
218
+ })
219
+ );
220
+
221
+ app.get(
222
+ "/mcp/service-tokens",
223
+ [
224
+ ...serviceTokenGuards,
225
+ createOpenApiBuilder(openApiOptions)
226
+ .withTags(["mcp"])
227
+ .withOperationId("listMcpServiceTokens")
228
+ .withSummary("List MCP service tokens")
229
+ .withDescription(
230
+ "Lists MCP service tokens owned by the signed-in user. Never includes plaintext or tokenHash."
231
+ )
232
+ .withQueryParameter("page", {type: "number"}, {required: false})
233
+ .withQueryParameter("limit", {type: "number"}, {required: false})
234
+ .withResponse(200, {
235
+ data: {type: "array"},
236
+ limit: {type: "number"},
237
+ more: {type: "boolean"},
238
+ page: {type: "number"},
239
+ total: {type: "number"},
240
+ })
241
+ .build(),
242
+ ],
243
+ asyncHandler(async (req, res) => {
244
+ const user = requireAuthenticatedUser(req);
245
+ const page = parsePage(req.query.page);
246
+ const limit = parseLimit(req.query.limit);
247
+ const filter = {userId: new mongoose.Types.ObjectId(String(user._id))};
248
+ const total = await McpServiceToken.countDocuments(filter);
249
+ const docs = await McpServiceToken.find(filter)
250
+ .sort("-created")
251
+ .skip((page - 1) * limit)
252
+ .limit(limit + 1);
253
+ const more = docs.length > limit;
254
+ const pageDocs = more ? docs.slice(0, limit) : docs;
255
+ return res.json({
256
+ data: pageDocs.map(toListItem),
257
+ limit,
258
+ more,
259
+ page,
260
+ total,
261
+ });
262
+ })
263
+ );
264
+
265
+ app.delete(
266
+ "/mcp/service-tokens/:id",
267
+ [
268
+ ...serviceTokenGuards,
269
+ createOpenApiBuilder(openApiOptions)
270
+ .withTags(["mcp"])
271
+ .withOperationId("revokeMcpServiceToken")
272
+ .withSummary("Revoke an MCP service token")
273
+ .withDescription("Sets revokedAt on a token owned by the signed-in user.")
274
+ .withPathParameter("id", {type: "string"})
275
+ .withResponse(200, {
276
+ data: {
277
+ properties: {
278
+ id: {type: "string"},
279
+ revokedAt: {type: "string"},
280
+ },
281
+ type: "object",
282
+ },
283
+ })
284
+ .build(),
285
+ ],
286
+ asyncHandler(async (req, res) => {
287
+ const user = requireAuthenticatedUser(req);
288
+ const tokenId = req.params.id;
289
+ if (!mongoose.Types.ObjectId.isValid(tokenId)) {
290
+ throw new NotFoundError("MCP service token not found");
291
+ }
292
+ const revoked = await McpServiceToken.revokeForUser(
293
+ {_id: user._id},
294
+ new mongoose.Types.ObjectId(tokenId)
295
+ );
296
+ if (!revoked) {
297
+ throw new NotFoundError("MCP service token not found");
298
+ }
299
+ return res.json({
300
+ data: {
301
+ id: String(revoked._id),
302
+ revokedAt: revoked.revokedAt ? revoked.revokedAt.toISOString() : null,
303
+ },
304
+ });
305
+ })
306
+ );
307
+ };
@@ -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
 
@@ -236,7 +237,7 @@ describe("tool-call observability", () => {
236
237
  const logs = await captureLogs(async () => {
237
238
  const result = await tool.handler({});
238
239
  expect(result.isError).toBe(true);
239
- expect(result.content[0].text).toContain("Create failed");
240
+ expect(result.content[0].text).toContain("Validation failed");
240
241
  expect(result.content[0].text).not.toContain("ValidationError:");
241
242
  expect(Object.keys(result)).toEqual(["content", "isError"]);
242
243
  });
@@ -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", () => {
package/src/mcp/types.ts CHANGED
@@ -85,11 +85,7 @@ export interface MCPConfig {
85
85
 
86
86
  export interface MCPRegistryEntry {
87
87
  modelName: string;
88
- // noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
89
- // biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
90
- model: Model<any>;
88
+ model: Model<unknown>;
91
89
  config: MCPConfig;
92
- // noExplicitAny: ModelRouterOptions is generic over the consumer's document type
93
- // biome-ignore lint/suspicious/noExplicitAny: ModelRouterOptions is generic over the consumer's document type
94
- options: ModelRouterOptions<any>;
90
+ options: ModelRouterOptions<unknown>;
95
91
  }