@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
@@ -53,13 +53,45 @@ describe("createPermissionResolver", () => {
53
53
  const first = await resolver.resolvePermissionsForUser(user);
54
54
  expect(first.todo).toEqual(["read"]);
55
55
 
56
- user.roles = [];
56
+ await RbacRole.findOneAndUpdate({name: "reader"}, {$set: {permissions: {todo: ["create"]}}});
57
57
  const cached = await resolver.resolvePermissionsForUser(user);
58
58
  expect(cached.todo).toEqual(["read"]);
59
59
 
60
60
  resolver.invalidateCache({userId: user.id});
61
61
  const refreshed = await resolver.resolvePermissionsForUser(user);
62
- expect(refreshed.todo).toBeUndefined();
62
+ expect(refreshed.todo).toEqual(["create"]);
63
+ });
64
+
65
+ it("does not reuse cached permissions after the user's roles change", async () => {
66
+ await setupDb();
67
+ const RbacRole = createRbacRoleModel(mongoose.connection);
68
+ await RbacRole.seedDefaults({statements: appStatements});
69
+ await RbacRole.findOneAndUpdate(
70
+ {name: "reader"},
71
+ {
72
+ $set: {
73
+ displayName: "Reader",
74
+ name: "reader",
75
+ permissions: {todo: ["read"]},
76
+ },
77
+ },
78
+ {upsert: true}
79
+ );
80
+
81
+ const resolver = createPermissionResolver({
82
+ cacheTtlMs: 60_000,
83
+ rbacRoleModel: RbacRole,
84
+ statements: appStatements,
85
+ });
86
+
87
+ const user = createTestUser({roles: ["reader"]});
88
+ const first = await resolver.resolvePermissionsForUser(user);
89
+ expect(first.todo).toEqual(["read"]);
90
+ expect(first.admin).toBeUndefined();
91
+
92
+ user.roles = ["superadmin"];
93
+ const promoted = await resolver.resolvePermissionsForUser(user);
94
+ expect(promoted.admin).toEqual(expect.arrayContaining(["access"]));
63
95
  });
64
96
 
65
97
  it("clears all cached permissions when invalidateCache is called without userId", async () => {
@@ -1,7 +1,9 @@
1
1
  import {createAccessControl} from "better-auth/plugins/access";
2
+ import {DateTime} from "luxon";
2
3
 
3
4
  import type {User} from "../auth";
4
5
  import {logger} from "../logger";
6
+ import {getOrgContext} from "../orgs/orgContext";
5
7
  import {unionPermissionSets} from "./permissionUtils";
6
8
  import type {RbacRoleModel} from "./roleModel";
7
9
  import type {PermissionSet, Statements} from "./statements";
@@ -25,6 +27,23 @@ const getUserRoles = (user: User): string[] => {
25
27
  return withRoles.roles ?? [];
26
28
  };
27
29
 
30
+ /** Include org context and roles so tenant switches and Mongo promotions are not stuck behind TTL. */
31
+ const permissionCacheKey = (user: User): string => {
32
+ const ctx = getOrgContext();
33
+ const organizationId = ctx?.organization?._id?.toString() ?? "";
34
+ const membershipRole = ctx?.membership?.roleName ?? "";
35
+ const roles = [...getUserRoles(user)].sort().join(",");
36
+ return `${user.id}::org=${organizationId}::role=${membershipRole}::roles=${roles}`;
37
+ };
38
+
39
+ const deletePermissionCacheForUser = (cache: Map<string, CacheEntry>, userId: string): void => {
40
+ for (const key of [...cache.keys()]) {
41
+ if (key === userId || key.startsWith(`${userId}:`) || key.startsWith(`${userId}::`)) {
42
+ cache.delete(key);
43
+ }
44
+ }
45
+ };
46
+
28
47
  export const createPermissionResolver = <S extends Statements>(args: {
29
48
  statements: S;
30
49
  rbacRoleModel: RbacRoleModel;
@@ -47,7 +66,7 @@ export const createPermissionResolver = <S extends Statements>(args: {
47
66
  const sourceCache = new Map<string, Map<string, SourceCacheEntry>>();
48
67
 
49
68
  const enforceCacheBound = (): void => {
50
- const now = Date.now();
69
+ const now = DateTime.now().toMillis();
51
70
  for (const [userId, entry] of permissionCache) {
52
71
  if (entry.expiresAt <= now) {
53
72
  permissionCache.delete(userId);
@@ -70,15 +89,15 @@ export const createPermissionResolver = <S extends Statements>(args: {
70
89
  }
71
90
  };
72
91
 
73
- const rememberPermissions = (userId: string, entry: CacheEntry): void => {
74
- permissionCache.delete(userId);
75
- permissionCache.set(userId, entry);
92
+ const rememberPermissions = (cacheKey: string, entry: CacheEntry): void => {
93
+ permissionCache.delete(cacheKey);
94
+ permissionCache.set(cacheKey, entry);
76
95
  enforceCacheBound();
77
96
  };
78
97
 
79
98
  const invalidateCache = (invalidateArgs?: {userId?: string}): void => {
80
99
  if (invalidateArgs?.userId) {
81
- permissionCache.delete(invalidateArgs.userId);
100
+ deletePermissionCacheForUser(permissionCache, invalidateArgs.userId);
82
101
  sourceCache.delete(invalidateArgs.userId);
83
102
  return;
84
103
  }
@@ -159,7 +178,7 @@ export const createPermissionResolver = <S extends Statements>(args: {
159
178
  source: PermissionSource,
160
179
  shouldCache = true
161
180
  ): Promise<PermissionSourceGrants | null> => {
162
- const now = Date.now();
181
+ const now = DateTime.now().toMillis();
163
182
  const cached = sourceCache.get(user.id)?.get(source.name);
164
183
 
165
184
  if (!shouldCache) {
@@ -204,10 +223,11 @@ export const createPermissionResolver = <S extends Statements>(args: {
204
223
  user: User,
205
224
  shouldCache: boolean
206
225
  ): Promise<PermissionSet> => {
226
+ const cacheKey = permissionCacheKey(user);
207
227
  if (shouldCache) {
208
- const cached = permissionCache.get(user.id);
209
- if (cached && cached.expiresAt > Date.now()) {
210
- rememberPermissions(user.id, cached);
228
+ const cached = permissionCache.get(cacheKey);
229
+ if (cached && cached.expiresAt > DateTime.now().toMillis()) {
230
+ rememberPermissions(cacheKey, cached);
211
231
  return cached.permissions;
212
232
  }
213
233
  }
@@ -250,8 +270,8 @@ export const createPermissionResolver = <S extends Statements>(args: {
250
270
  }
251
271
 
252
272
  if (shouldCache) {
253
- rememberPermissions(user.id, {
254
- expiresAt: Date.now() + cacheTtlMs,
273
+ rememberPermissions(cacheKey, {
274
+ expiresAt: DateTime.now().plus({milliseconds: cacheTtlMs}).toMillis(),
255
275
  permissions,
256
276
  });
257
277
  }
@@ -880,6 +880,175 @@ describe("roleManager", () => {
880
880
  expect(denied).toHaveLength(0);
881
881
  });
882
882
 
883
+ it("requires a configured user model for unassign and modify checks", async () => {
884
+ await setupDb();
885
+ const access = createAccess({
886
+ connection: mongoose.connection,
887
+ statements: appStatements,
888
+ });
889
+ await access.roles.seedDefaults();
890
+
891
+ const actor = createTestUser({roles: ["superadmin"]});
892
+ const userId = new mongoose.Types.ObjectId().toString();
893
+
894
+ await expect(
895
+ access.roles.unassign({actor, roleNames: ["member"], userId})
896
+ ).rejects.toMatchObject({status: 500, title: "User model not configured for role assignment"});
897
+
898
+ await expect(access.roles.assertCanModifyUser({actor, userId})).rejects.toMatchObject({
899
+ status: 500,
900
+ title: "User model not configured for role assignment",
901
+ });
902
+ });
903
+
904
+ it("returns 404 for unassign, previewAssignment, and assertCanModifyUser on missing users", async () => {
905
+ await setupDb();
906
+ const UserModel = getRbacTestUserModel();
907
+ const access = createAccess({
908
+ connection: mongoose.connection,
909
+ statements: appStatements,
910
+ userModel: UserModel as unknown as UserModel,
911
+ });
912
+ await access.roles.seedDefaults();
913
+
914
+ const actor = createTestUser({roles: ["superadmin"]});
915
+ const missingId = new mongoose.Types.ObjectId().toString();
916
+
917
+ await expect(
918
+ access.roles.unassign({actor, roleNames: ["member"], userId: missingId})
919
+ ).rejects.toMatchObject({status: 404, title: "User not found"});
920
+
921
+ await expect(
922
+ access.roles.previewAssignment({actor, roleNames: ["member"], userId: missingId})
923
+ ).rejects.toMatchObject({status: 404, title: "User not found"});
924
+
925
+ await expect(
926
+ access.roles.assertCanModifyUser({actor, userId: missingId})
927
+ ).rejects.toMatchObject({status: 404, title: "User not found"});
928
+ });
929
+
930
+ it("rejects conflicting role assignments declared by the second role", async () => {
931
+ await setupDb();
932
+ const UserModel = getRbacTestUserModel();
933
+ const access = createAccess({
934
+ connection: mongoose.connection,
935
+ defaultRoles: [
936
+ {
937
+ displayName: "Role C",
938
+ name: "role-c",
939
+ permissions: {todo: ["read"]},
940
+ },
941
+ {
942
+ displayName: "Role D",
943
+ excludesRoles: ["role-c"],
944
+ name: "role-d",
945
+ permissions: {todo: ["update"]},
946
+ },
947
+ ],
948
+ statements: appStatements,
949
+ userModel: UserModel as unknown as UserModel,
950
+ });
951
+ await access.roles.seedDefaults();
952
+
953
+ const actor = createTestUser({roles: ["superadmin"]});
954
+ const target = await UserModel.create({email: "reverse-conflict@example.com", roles: []});
955
+
956
+ await expect(
957
+ access.roles.assign({actor, roleNames: ["role-c", "role-d"], userId: target.id})
958
+ ).rejects.toMatchObject({
959
+ status: 409,
960
+ title: "Role role-c conflicts with role-d",
961
+ });
962
+ });
963
+
964
+ it("rejects changing locked fields on a locked role", async () => {
965
+ await setupDb();
966
+ const access = createAccess({
967
+ connection: mongoose.connection,
968
+ statements: appStatements,
969
+ });
970
+ await access.roles.seedDefaults();
971
+
972
+ const actor = createTestUser({roles: ["superadmin"]});
973
+ await expect(
974
+ access.roles.update({
975
+ actor,
976
+ changes: {isSealed: true},
977
+ roleName: "admin",
978
+ })
979
+ ).rejects.toMatchObject({status: 400, title: "Cannot change locked fields on a locked role"});
980
+ });
981
+
982
+ it("rejects excludesRoles updates that conflict with existing assignments", async () => {
983
+ await setupDb();
984
+ const UserModel = getRbacTestUserModel();
985
+ const access = createAccess({
986
+ connection: mongoose.connection,
987
+ defaultRoles: [
988
+ {
989
+ displayName: "Writer",
990
+ name: "writer",
991
+ permissions: {todo: ["update"]},
992
+ },
993
+ {
994
+ displayName: "Reader",
995
+ name: "reader",
996
+ permissions: {todo: ["read"]},
997
+ },
998
+ ],
999
+ statements: appStatements,
1000
+ userModel: UserModel as unknown as UserModel,
1001
+ });
1002
+ await access.roles.seedDefaults();
1003
+
1004
+ const actor = createTestUser({roles: ["superadmin"]});
1005
+ await UserModel.create({email: "both@example.com", roles: ["writer", "reader"]});
1006
+
1007
+ await expect(
1008
+ access.roles.update({
1009
+ actor,
1010
+ changes: {excludesRoles: ["reader"]},
1011
+ roleName: "writer",
1012
+ })
1013
+ ).rejects.toMatchObject({
1014
+ status: 400,
1015
+ title: "excludesRoles conflicts with existing assignments",
1016
+ });
1017
+ });
1018
+
1019
+ it("allows excludesRoles updates when no holder has the excluded role", async () => {
1020
+ await setupDb();
1021
+ const UserModel = getRbacTestUserModel();
1022
+ const access = createAccess({
1023
+ connection: mongoose.connection,
1024
+ defaultRoles: [
1025
+ {
1026
+ displayName: "Solo Writer",
1027
+ name: "solo-writer",
1028
+ permissions: {todo: ["update"]},
1029
+ },
1030
+ {
1031
+ displayName: "Solo Reader",
1032
+ name: "solo-reader",
1033
+ permissions: {todo: ["read"]},
1034
+ },
1035
+ ],
1036
+ statements: appStatements,
1037
+ userModel: UserModel as unknown as UserModel,
1038
+ });
1039
+ await access.roles.seedDefaults();
1040
+
1041
+ const actor = createTestUser({roles: ["superadmin"]});
1042
+ await UserModel.create({email: "writer-only@example.com", roles: ["solo-writer"]});
1043
+
1044
+ const updated = await access.roles.update({
1045
+ actor,
1046
+ changes: {excludesRoles: ["solo-reader"]},
1047
+ roleName: "solo-writer",
1048
+ });
1049
+ expect(updated.excludesRoles).toEqual(["solo-reader"]);
1050
+ });
1051
+
883
1052
  it("keeps the original escalation error when denied-audit persistence fails", async () => {
884
1053
  await setupDb();
885
1054
  await createRbacRoleModel(mongoose.connection).seedDefaults({statements: appStatements});
@@ -1,9 +1,15 @@
1
1
  import {describe, expect, it} from "bun:test";
2
+ import {assert} from "chai";
2
3
  import mongoose from "mongoose";
3
4
 
4
5
  import {setupDb} from "../tests";
5
6
  import {createRbacAuditModel} from "./auditModel";
6
- import {createRbacRoleModel, expandRolePermissions, terrenoDefaultRoles} from "./roleModel";
7
+ import {
8
+ createRbacRoleModel,
9
+ expandRolePermissions,
10
+ organizationOperatorRole,
11
+ terrenoDefaultRoles,
12
+ } from "./roleModel";
7
13
  import {READ_ONLY_ROLE_PERMISSIONS, terrenoStatements} from "./statements";
8
14
 
9
15
  describe("rbac role model", () => {
@@ -11,6 +17,15 @@ describe("rbac role model", () => {
11
17
  const names = terrenoDefaultRoles.map((role) => role.name);
12
18
 
13
19
  expect(names).toEqual(["superadmin", "admin", "auditor", "member"]);
20
+
21
+ const admin = terrenoDefaultRoles.find((role) => role.name === "admin");
22
+ assert.isObject(admin?.permissions);
23
+ if (!admin?.permissions || admin.permissions === "*" || "readOnly" in admin.permissions) {
24
+ assert.fail("Expected concrete admin permissions");
25
+ }
26
+ assert.deepEqual(admin.permissions.adminAnnouncementAcknowledgement, ["read"]);
27
+ assert.deepEqual(admin.permissions.adminAnnouncementClickEvent, ["read"]);
28
+ assert.deepEqual(admin.permissions.adminAnnouncementImpression, ["read"]);
14
29
  });
15
30
 
16
31
  it("seeds default roles with expanded permissions", async () => {
@@ -25,12 +40,30 @@ describe("rbac role model", () => {
25
40
  expect(superadmin.permissions.featureFlag).toContain("list");
26
41
  expect(superadmin.permissions.consentForm).toContain("list");
27
42
  expect(superadmin.permissions.consentResponse).toEqual(["list", "read"]);
43
+ expect(superadmin.permissions.organization).toContain("list");
44
+
45
+ expect(await RbacRole.findOne({name: "operator"})).toBeNull();
28
46
 
29
47
  const auditor = await RbacRole.findExactlyOne({name: "auditor"});
30
48
  expect(auditor.permissions.user).toEqual(["list", "read"]);
31
49
  expect(auditor.permissions.rbac).toEqual(["read"]);
32
50
  });
33
51
 
52
+ it("seeds the locked operator role when passed as an extra role", async () => {
53
+ await setupDb();
54
+ const RbacRole = createRbacRoleModel(mongoose.connection);
55
+ await RbacRole.seedDefaults({
56
+ extraRoles: [organizationOperatorRole],
57
+ statements: terrenoStatements,
58
+ });
59
+
60
+ const operator = await RbacRole.findExactlyOne({name: "operator"});
61
+ expect(operator.isLocked).toBe(true);
62
+ expect(operator.permissions.organization).toEqual([...terrenoStatements.organization]);
63
+ expect(operator.permissions.admin).toEqual(["access"]);
64
+ expect(operator.permissions.user).toEqual(["list", "read", "update"]);
65
+ });
66
+
34
67
  it("upserts default roles without duplicating", async () => {
35
68
  await setupDb();
36
69
  const RbacRole = createRbacRoleModel(mongoose.connection);
@@ -52,7 +52,7 @@ export {READ_ONLY_ROLE_PERMISSIONS} from "./statements";
52
52
  * Insert missing default roles. Existing unsealed roles are left unchanged so admin
53
53
  * customizations survive process restarts. Sealed roles are refreshed from code.
54
54
  */
55
- export const upsertSeededRole = async (
55
+ const upsertSeededRole = async (
56
56
  model: RbacRoleModel,
57
57
  role: RoleDefinition,
58
58
  statements: Statements
@@ -89,6 +89,18 @@ export const expandRolePermissions = (
89
89
  readActions: readonly string[] = READ_ACTIONS
90
90
  ): PermissionSet => expandRolePermissionSpec(spec, statements, readActions);
91
91
 
92
+ /** Locked platform role seeded only when `createAccess({organizations: true})`. */
93
+ export const organizationOperatorRole: RoleDefinition = {
94
+ displayName: "Operator",
95
+ isLocked: true,
96
+ name: "operator",
97
+ permissions: {
98
+ admin: ["access"],
99
+ organization: ["create", "list", "read", "update", "delete", "manageMembers", "disable"],
100
+ user: ["list", "read", "update"],
101
+ },
102
+ };
103
+
92
104
  export const terrenoDefaultRoles: RoleDefinition[] = [
93
105
  {
94
106
  displayName: "Super Admin",
@@ -103,6 +115,10 @@ export const terrenoDefaultRoles: RoleDefinition[] = [
103
115
  name: "admin",
104
116
  permissions: {
105
117
  admin: ["access"],
118
+ adminAnnouncement: ["read", "write", "writeOwned"],
119
+ adminAnnouncementAcknowledgement: ["read"],
120
+ adminAnnouncementClickEvent: ["read"],
121
+ adminAnnouncementImpression: ["read"],
106
122
  configuration: ["read", "update"],
107
123
  user: ["create", "list", "read", "update"],
108
124
  },
@@ -0,0 +1,233 @@
1
+ import {beforeEach, describe, expect, it} from "bun:test";
2
+ import type express from "express";
3
+ import mongoose, {type Model, model, Schema} from "mongoose";
4
+ import type TestAgent from "supertest/lib/agent";
5
+
6
+ import {type UserModel as AuthUserModel, addAuthRoutes, setupAuth} from "../auth";
7
+ import {apiErrorMiddleware} from "../errors";
8
+ import {authAsUser, getBaseServer, setupDb, UserModel} from "../tests";
9
+ import {createAccess} from "./access";
10
+ import {rbacRouter} from "./routes";
11
+ import {type PermissionSet, terrenoStatements} from "./statements";
12
+ import type {AnyTerrenoAccess} from "./types";
13
+
14
+ interface RouteUser {
15
+ admin: boolean;
16
+ email: string;
17
+ roles: string[];
18
+ }
19
+
20
+ const appStatements = {
21
+ ...terrenoStatements,
22
+ todo: ["create", "read", "update", "delete", "list"],
23
+ } as const;
24
+
25
+ const allPermissions: PermissionSet = Object.fromEntries(
26
+ Object.entries(appStatements).map(([resource, actions]) => [resource, [...actions]])
27
+ );
28
+
29
+ const getRouteUserModel = (): Model<RouteUser> => {
30
+ const modelName = "RbacRoutesTestUser";
31
+ if (mongoose.models[modelName]) {
32
+ return mongoose.models[modelName] as Model<RouteUser>;
33
+ }
34
+
35
+ const schema = new Schema<RouteUser>({
36
+ admin: {default: false, description: "Whether the user is an administrator", type: Boolean},
37
+ email: {description: "The user's email address", required: true, type: String},
38
+ roles: {default: [], description: "The user's RBAC roles", type: [String]},
39
+ });
40
+
41
+ return model<RouteUser>(modelName, schema);
42
+ };
43
+
44
+ const authUserModel = UserModel as unknown as AuthUserModel;
45
+
46
+ const createRequestMutationAccess = (
47
+ access: AnyTerrenoAccess,
48
+ mutate: (request: express.Request) => void
49
+ ): AnyTerrenoAccess => ({
50
+ ...access,
51
+ middleware: (permissions, options) => {
52
+ const accessMiddleware = access.middleware(permissions, options);
53
+ return (request, response, next) => {
54
+ accessMiddleware(request, response, (error?: unknown) => {
55
+ if (error) {
56
+ next(error);
57
+ return;
58
+ }
59
+ mutate(request);
60
+ next();
61
+ });
62
+ };
63
+ },
64
+ });
65
+
66
+ describe("rbacRouter", () => {
67
+ let app: express.Application;
68
+ let adminAgent: TestAgent;
69
+ let routeUserModel: Model<RouteUser>;
70
+ let targetUserId: string;
71
+
72
+ beforeEach(async () => {
73
+ await setupDb();
74
+ routeUserModel = getRouteUserModel();
75
+ await routeUserModel.deleteMany({});
76
+ const targetUser = await routeUserModel.create({
77
+ email: "target@example.com",
78
+ roles: ["member"],
79
+ });
80
+ targetUserId = targetUser.id;
81
+
82
+ const access = createAccess({
83
+ connection: mongoose.connection,
84
+ resolvePermissions: async ({user}) => (user.admin ? allPermissions : {}),
85
+ statements: appStatements,
86
+ userModel: routeUserModel as unknown as AuthUserModel,
87
+ });
88
+ await access.roles.seedDefaults();
89
+
90
+ app = getBaseServer();
91
+ setupAuth(app, authUserModel);
92
+ addAuthRoutes(app, authUserModel);
93
+ rbacRouter({
94
+ access,
95
+ basePath: "/rbac",
96
+ userModel: routeUserModel as unknown as AuthUserModel,
97
+ }).register(app);
98
+ rbacRouter({
99
+ access: createRequestMutationAccess(access, (request) => {
100
+ request.user = undefined;
101
+ }),
102
+ basePath: "/rbac-unauthorized",
103
+ userModel: routeUserModel as unknown as AuthUserModel,
104
+ }).register(app);
105
+ rbacRouter({
106
+ access: createRequestMutationAccess(access, (request) => {
107
+ Reflect.deleteProperty(request.params, "id");
108
+ Reflect.deleteProperty(request.params, "name");
109
+ }),
110
+ basePath: "/rbac-invalid-params",
111
+ userModel: routeUserModel as unknown as AuthUserModel,
112
+ }).register(app);
113
+ app.use(apiErrorMiddleware);
114
+
115
+ adminAgent = await authAsUser(app, "admin");
116
+ });
117
+
118
+ it("serves statements and supports role and user operations", async () => {
119
+ const statementsResponse = await adminAgent.get("/rbac/statements").expect(200);
120
+ expect(statementsResponse.body.data.statements.rbac).toEqual([
121
+ "read",
122
+ "manageRoles",
123
+ "assignRoles",
124
+ ]);
125
+
126
+ const rolesResponse = await adminAgent.get("/rbac/roles").expect(200);
127
+ expect(rolesResponse.body.data.map((role: {name: string}) => role.name)).toEqual(
128
+ expect.arrayContaining(["superadmin", "member"])
129
+ );
130
+
131
+ const createResponse = await adminAgent
132
+ .post("/rbac/roles")
133
+ .send({
134
+ displayName: "Route Editor",
135
+ name: "route-editor",
136
+ permissions: {todo: ["read"]},
137
+ })
138
+ .expect(201);
139
+ expect(createResponse.body.data.name).toBe("route-editor");
140
+
141
+ const updateResponse = await adminAgent
142
+ .patch("/rbac/roles/route-editor")
143
+ .send({displayName: "Updated Route Editor"})
144
+ .expect(200);
145
+ expect(updateResponse.body.data.displayName).toBe("Updated Route Editor");
146
+
147
+ const rolePreviewResponse = await adminAgent
148
+ .post("/rbac/roles/route-editor/preview")
149
+ .send({permissions: {todo: ["read", "update"]}})
150
+ .expect(200);
151
+ expect(rolePreviewResponse.body.data.gained.todo).toEqual(["update"]);
152
+
153
+ const permissionsResponse = await adminAgent
154
+ .get(`/rbac/users/${targetUserId}/permissions`)
155
+ .expect(200);
156
+ expect(permissionsResponse.body.data.roles).toEqual(["member"]);
157
+
158
+ await adminAgent
159
+ .put(`/rbac/users/${targetUserId}/roles`)
160
+ .send({roleNames: ["auditor"]})
161
+ .expect(200);
162
+ const assignedUser = await routeUserModel.findById(targetUserId);
163
+ expect(assignedUser?.roles).toEqual(["auditor"]);
164
+
165
+ const assignmentPreviewResponse = await adminAgent
166
+ .post(`/rbac/users/${targetUserId}/roles/preview`)
167
+ .send({roleNames: ["member"]})
168
+ .expect(200);
169
+ expect(assignmentPreviewResponse.body.data).toHaveProperty("gained");
170
+
171
+ await adminAgent.delete("/rbac/roles/route-editor").expect(204);
172
+ });
173
+
174
+ it("returns unauthorized when a handler has no actor", async () => {
175
+ const actorlessRoutes = [
176
+ {body: {}, method: "post", path: "/rbac-unauthorized/roles"},
177
+ {body: {}, method: "patch", path: "/rbac-unauthorized/roles/member"},
178
+ {method: "delete", path: "/rbac-unauthorized/roles/member"},
179
+ {
180
+ body: {roleNames: ["member"]},
181
+ method: "put",
182
+ path: `/rbac-unauthorized/users/${targetUserId}/roles`,
183
+ },
184
+ ] as const;
185
+
186
+ for (const route of actorlessRoutes) {
187
+ const response =
188
+ route.method === "post"
189
+ ? await adminAgent.post(route.path).send(route.body)
190
+ : route.method === "patch"
191
+ ? await adminAgent.patch(route.path).send(route.body)
192
+ : route.method === "put"
193
+ ? await adminAgent.put(route.path).send(route.body)
194
+ : await adminAgent.delete(route.path);
195
+ expect(response.status).toBe(401);
196
+ expect(response.body.title).toBe("Unauthorized");
197
+ }
198
+ });
199
+
200
+ it("validates missing route parameters", async () => {
201
+ const roleResponse = await adminAgent
202
+ .patch("/rbac-invalid-params/roles/member")
203
+ .send({displayName: "Missing Name"});
204
+ expect(roleResponse.status).toBe(400);
205
+ expect(roleResponse.body.title).toBe("Role name is required");
206
+
207
+ const userResponse = await adminAgent.get(
208
+ `/rbac-invalid-params/users/${targetUserId}/permissions`
209
+ );
210
+ expect(userResponse.status).toBe(400);
211
+ expect(userResponse.body.title).toBe("User id is required");
212
+ });
213
+
214
+ it("validates role assignment bodies and missing users", async () => {
215
+ const missingRoleNamesResponse = await adminAgent
216
+ .put(`/rbac/users/${targetUserId}/roles`)
217
+ .send({});
218
+ expect(missingRoleNamesResponse.status).toBe(400);
219
+ expect(missingRoleNamesResponse.body.title).toBe("roleNames is required");
220
+
221
+ const missingPreviewRoleNamesResponse = await adminAgent
222
+ .post(`/rbac/users/${targetUserId}/roles/preview`)
223
+ .send({});
224
+ expect(missingPreviewRoleNamesResponse.status).toBe(400);
225
+ expect(missingPreviewRoleNamesResponse.body.title).toBe("roleNames is required");
226
+
227
+ const missingUserResponse = await adminAgent.get(
228
+ `/rbac/users/${new mongoose.Types.ObjectId()}/permissions`
229
+ );
230
+ expect(missingUserResponse.status).toBe(404);
231
+ expect(missingUserResponse.body.title).toBe("User not found");
232
+ });
233
+ });