@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
@@ -6,6 +6,7 @@ import type {ModelRouterOptions, RESTMethod} from "./api";
6
6
  import type {User} from "./auth";
7
7
  import {loadDocOr404} from "./docLoader";
8
8
  import {APIError} from "./errors";
9
+ import {isOrgMemberPermission, OrgQueryFilter} from "./orgs/orgPermissions";
9
10
 
10
11
  export type PermissionMethod<T> = (
11
12
  method: RESTMethod,
@@ -43,16 +44,10 @@ export const getUserOrganizationIds = (user?: User): string[] => {
43
44
  };
44
45
 
45
46
  /**
46
- * Restricts list queries to documents belonging to one of the caller's organizations. This is the
47
- * tenant-scoped analog of {@link OwnerQueryFilter}: it filters on the document's `organizationId`
48
- * field using the user's `organizationIds`. Returns `null` for anonymous callers (no user).
47
+ * Restricts list queries to the current request organization (`X-Organization-Id` or inferred
48
+ * single org-admin membership). Does not read `User.organizationIds`.
49
49
  */
50
- export const OrganizationQueryFilter = (user?: User) => {
51
- if (!user) {
52
- return null;
53
- }
54
- return {organizationId: {$in: getUserOrganizationIds(user)}};
55
- };
50
+ export const OrganizationQueryFilter = OrgQueryFilter;
56
51
 
57
52
  export const Permissions = {
58
53
  IsAdmin: (_method: RESTMethod, user?: User) => {
@@ -74,28 +69,11 @@ export const Permissions = {
74
69
  return method === "list" || method === "read";
75
70
  },
76
71
  /**
77
- * Object-level permission for tenant-scoped documents: the caller must belong to the document's
78
- * organization (admins always pass). With no object (list/create checks) it returns true and
79
- * defers to the {@link OrganizationQueryFilter} / a `preCreate` hook to scope access. Expects the
80
- * document to expose an `organizationId` and the user an `organizationIds` array.
72
+ * Object-level permission for tenant-scoped documents: platform org actors must match the
73
+ * current org context; everyone else needs an active Membership. With no object (list/create)
74
+ * it returns true and defers to {@link OrganizationQueryFilter}.
81
75
  */
82
- IsOrganizationMember: (_method: RESTMethod, user?: User, obj?: unknown) => {
83
- // When checking if we can possibly perform the action, return true.
84
- if (!obj) {
85
- return true;
86
- }
87
- if (!user) {
88
- return false;
89
- }
90
- if (user?.admin) {
91
- return true;
92
- }
93
- const organizationId = (obj as {organizationId?: string}).organizationId;
94
- if (!organizationId) {
95
- return false;
96
- }
97
- return getUserOrganizationIds(user).includes(organizationId);
98
- },
76
+ IsOrganizationMember: isOrgMemberPermission,
99
77
  IsOwner: (_method: RESTMethod, user?: User, obj?: unknown) => {
100
78
  // When checking if we can possibly perform the action, return true.
101
79
  if (!obj) {
@@ -172,6 +172,11 @@ describe("isDeleted", () => {
172
172
  stuff = await StuffModel.findOne({deleted: true});
173
173
  expect(stuff?.name).toBe("Things");
174
174
  });
175
+
176
+ it('filters out deleted documents from "countDocuments" unless deleted is explicit', async () => {
177
+ expect(await StuffModel.countDocuments({})).toBe(1);
178
+ expect(await StuffModel.countDocuments({deleted: true})).toBe(1);
179
+ });
175
180
  });
176
181
 
177
182
  describe("findOneOrNone", () => {
package/src/plugins.ts CHANGED
@@ -93,6 +93,9 @@ export const isDeletedPlugin = (schema: Schema<any, any, any, any>, defaultValue
93
93
  schema.pre("findOne", function () {
94
94
  applyDeleteFilter(this);
95
95
  });
96
+ schema.pre("countDocuments", function () {
97
+ applyDeleteFilter(this);
98
+ });
96
99
  };
97
100
 
98
101
  export const isDisabledPlugin = (
@@ -10,7 +10,7 @@ const secondsUntil = (resetAt: number, now: number): number => {
10
10
  return Math.max(1, Math.ceil((resetAt - now) / 1000));
11
11
  };
12
12
 
13
- export const setRateLimitExceededHeaders = ({
13
+ const setRateLimitExceededHeaders = ({
14
14
  max,
15
15
  remaining,
16
16
  resetAt,
@@ -4,6 +4,7 @@ import mongoose from "mongoose";
4
4
  import {APIError} from "../errors";
5
5
  import type {RateLimitConsumeArgs, RateLimitConsumeResult, RateLimitStore} from "./types";
6
6
 
7
+ /** @internal */
7
8
  export const RATE_LIMIT_HITS_COLLECTION = "rateLimitHits";
8
9
 
9
10
  const ensureIndexes = async (collection: mongoose.mongo.Collection): Promise<void> => {
@@ -12,7 +12,7 @@ const stripQueryAndFragment = (url: string): string => {
12
12
  };
13
13
 
14
14
  /** Strip query, fragment, and a trailing slash so `/auth/login/` matches `/auth/login`. */
15
- export const normalizeRequestPath = (url: string): string => {
15
+ const normalizeRequestPath = (url: string): string => {
16
16
  const withoutQuery = stripQueryAndFragment(url);
17
17
  const withoutSlash =
18
18
  withoutQuery.length > 1 && withoutQuery.endsWith("/")
@@ -22,7 +22,7 @@ export const normalizeRequestPath = (url: string): string => {
22
22
  };
23
23
 
24
24
  /** Prefer Express `req.path` (routing) over the raw request-target. */
25
- export const requestPath = (req: Request): string => {
25
+ const requestPath = (req: Request): string => {
26
26
  const raw = req.path || req.url || req.originalUrl || "";
27
27
  return normalizeRequestPath(raw);
28
28
  };
@@ -7,6 +7,7 @@ import type {
7
7
  RateLimitStore,
8
8
  } from "./types";
9
9
 
10
+ /** @internal */
10
11
  export const redisUrlFromEnv = (): string | undefined => {
11
12
  return process.env.VALKEY_URL || process.env.REDIS_URL;
12
13
  };
@@ -1,10 +1,11 @@
1
1
  import type {User} from "../auth";
2
2
  import {APIError} from "../errors";
3
3
  import {normalizeRbacAuditSinks} from "./auditModel";
4
+ import {membershipOrgAdminPermissionSource} from "./membershipOrgAdminSource";
4
5
  import {createIsPermitted, createRequireAccess} from "./middleware";
5
6
  import {createPermissionResolver} from "./resolve";
6
7
  import {createRoleManager} from "./roleManager";
7
- import {createRbacRoleModel} from "./roleModel";
8
+ import {createRbacRoleModel, organizationOperatorRole} from "./roleModel";
8
9
  import {mergeStatements, type Statements} from "./statements";
9
10
  import type {
10
11
  AccessCheckArgs,
@@ -39,19 +40,26 @@ export const createAccess = <S extends Statements>(options: AccessOptions<S>): T
39
40
 
40
41
  const mergedStatements = mergeStatements(options.statements) as S;
41
42
  const rbacRoleModel = createRbacRoleModel(options.connection);
43
+ const extraRoles = [...(options.defaultRoles ?? [])];
44
+ if (options.organizations && !extraRoles.some((role) => role.name === "operator")) {
45
+ extraRoles.push(organizationOperatorRole);
46
+ }
47
+ const sources = options.organizations
48
+ ? [membershipOrgAdminPermissionSource(), ...(options.sources ?? [])]
49
+ : (options.sources ?? []);
42
50
 
43
51
  const resolver = createPermissionResolver({
44
52
  cacheTtlMs: options.cacheTtlMs,
45
53
  rbacRoleModel,
46
54
  resolvePermissions: options.resolvePermissions,
47
- sources: options.sources,
55
+ sources,
48
56
  statements: mergedStatements,
49
57
  });
50
58
 
51
59
  const {roleManager} = createRoleManager({
52
60
  auditSinks,
53
61
  connection: options.connection,
54
- defaultRoles: options.defaultRoles,
62
+ defaultRoles: extraRoles,
55
63
  getActorPermissions: (user) => resolver.resolvePermissionsForUser(user),
56
64
  getPreviewPermissions: (user) => resolver.resolvePermissionsForUserUncached(user),
57
65
  invalidateCache: resolver.invalidateCache,
@@ -0,0 +1,59 @@
1
+ import type {User} from "../auth";
2
+ import {Membership} from "../orgs/organizationModel";
3
+ import {getOrgContext} from "../orgs/orgContext";
4
+ import type {PermissionSet} from "./statements";
5
+ import type {PermissionSource, PermissionSourceGrants} from "./types";
6
+
7
+ export const MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = "membership-org-admin";
8
+
9
+ /** Grants applied when `Membership.roleName` is `org-admin` in the current org context. */
10
+ export const ORG_ADMIN_PERMISSION_BUNDLE: PermissionSet = {
11
+ admin: ["access"],
12
+ organization: ["read", "update", "manageMembers"],
13
+ };
14
+
15
+ const userIdForMembershipLookup = (user: User): string => {
16
+ if (user._id) {
17
+ return String(user._id);
18
+ }
19
+ return user.id;
20
+ };
21
+
22
+ const isActiveOrgAdminMembership = (membership?: {roleName?: string; status?: string}): boolean => {
23
+ return membership?.roleName === "org-admin" && membership.status === "active";
24
+ };
25
+
26
+ const fullOrgAdminGrants = (): PermissionSourceGrants => ({
27
+ permissions: {
28
+ admin: [...ORG_ADMIN_PERMISSION_BUNDLE.admin],
29
+ organization: [...ORG_ADMIN_PERMISSION_BUNDLE.organization],
30
+ },
31
+ });
32
+
33
+ const shellOnlyOrgAdminGrants = (): PermissionSourceGrants => ({
34
+ permissions: {
35
+ admin: [...ORG_ADMIN_PERMISSION_BUNDLE.admin],
36
+ },
37
+ });
38
+
39
+ export const membershipOrgAdminPermissionSource = (): PermissionSource => ({
40
+ getGrants: async ({user}): Promise<PermissionSourceGrants | null> => {
41
+ const contextMembership = getOrgContext()?.membership;
42
+ if (contextMembership) {
43
+ if (!isActiveOrgAdminMembership(contextMembership)) {
44
+ return null;
45
+ }
46
+ return fullOrgAdminGrants();
47
+ }
48
+
49
+ const activeMemberships = await Membership.findActiveForUser(userIdForMembershipLookup(user));
50
+ const hasOrgAdminMembership = activeMemberships.some((row) => row.roleName === "org-admin");
51
+ if (!hasOrgAdminMembership) {
52
+ return null;
53
+ }
54
+
55
+ return shellOnlyOrgAdminGrants();
56
+ },
57
+ name: MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME,
58
+ ttlMs: 0,
59
+ });
@@ -62,6 +62,7 @@ const buildPermissionRequest = (resource: string, action: string): Record<string
62
62
  [resource]: [action],
63
63
  });
64
64
 
65
+ /** @internal */
65
66
  export const buildAccessPermissions = <T>(
66
67
  accessControl: AnyTerrenoAccess,
67
68
  access: ModelRouterAccessOptions
@@ -115,6 +116,7 @@ export const buildAccessPermissions = <T>(
115
116
  };
116
117
  };
117
118
 
119
+ /** @internal */
118
120
  export const buildAccessQueryFilter = <_T>(
119
121
  accessControl: AnyTerrenoAccess,
120
122
  access: ModelRouterAccessOptions,
@@ -161,6 +163,7 @@ export const buildAccessQueryFilter = <_T>(
161
163
  };
162
164
  };
163
165
 
166
+ /** @internal */
164
167
  export const wrapAccessResponseHandler = <T>(
165
168
  accessControl: AnyTerrenoAccess,
166
169
  access: ModelRouterAccessOptions,
@@ -101,12 +101,33 @@ describe("rbac permission utils and middleware", () => {
101
101
  const first = await access.getPermissions({user});
102
102
  expect(first.todo).toEqual(["read"]);
103
103
 
104
- user.roles = [];
105
- const cached = await access.getPermissions({user});
106
- expect(cached.todo).toEqual(["read"]);
107
-
108
104
  access.invalidateCache({userId: user.id});
109
105
  const refreshed = await access.getPermissions({user});
110
- expect(refreshed.todo).toBeUndefined();
106
+ expect(refreshed.todo).toEqual(["read"]);
107
+ });
108
+
109
+ it("does not reuse cached permissions after the user's roles change", async () => {
110
+ await setupDb();
111
+ const access = createAccess({
112
+ cacheTtlMs: 60_000,
113
+ connection: mongoose.connection,
114
+ defaultRoles: [
115
+ {
116
+ displayName: "Reader",
117
+ name: "reader",
118
+ permissions: {todo: ["read"]},
119
+ },
120
+ ],
121
+ statements: appStatements,
122
+ });
123
+ await access.roles.seedDefaults();
124
+
125
+ const user = createUser({roles: ["reader"]});
126
+ const first = await access.getPermissions({user});
127
+ expect(first.todo).toEqual(["read"]);
128
+
129
+ user.roles = [];
130
+ const afterRoleChange = await access.getPermissions({user});
131
+ expect(afterRoleChange.todo).toBeUndefined();
111
132
  });
112
133
  });
@@ -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 () => {
@@ -3,6 +3,7 @@ import {DateTime} from "luxon";
3
3
 
4
4
  import type {User} from "../auth";
5
5
  import {logger} from "../logger";
6
+ import {getOrgContext} from "../orgs/orgContext";
6
7
  import {unionPermissionSets} from "./permissionUtils";
7
8
  import type {RbacRoleModel} from "./roleModel";
8
9
  import type {PermissionSet, Statements} from "./statements";
@@ -26,6 +27,23 @@ const getUserRoles = (user: User): string[] => {
26
27
  return withRoles.roles ?? [];
27
28
  };
28
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
+
29
47
  export const createPermissionResolver = <S extends Statements>(args: {
30
48
  statements: S;
31
49
  rbacRoleModel: RbacRoleModel;
@@ -71,15 +89,15 @@ export const createPermissionResolver = <S extends Statements>(args: {
71
89
  }
72
90
  };
73
91
 
74
- const rememberPermissions = (userId: string, entry: CacheEntry): void => {
75
- permissionCache.delete(userId);
76
- permissionCache.set(userId, entry);
92
+ const rememberPermissions = (cacheKey: string, entry: CacheEntry): void => {
93
+ permissionCache.delete(cacheKey);
94
+ permissionCache.set(cacheKey, entry);
77
95
  enforceCacheBound();
78
96
  };
79
97
 
80
98
  const invalidateCache = (invalidateArgs?: {userId?: string}): void => {
81
99
  if (invalidateArgs?.userId) {
82
- permissionCache.delete(invalidateArgs.userId);
100
+ deletePermissionCacheForUser(permissionCache, invalidateArgs.userId);
83
101
  sourceCache.delete(invalidateArgs.userId);
84
102
  return;
85
103
  }
@@ -205,10 +223,11 @@ export const createPermissionResolver = <S extends Statements>(args: {
205
223
  user: User,
206
224
  shouldCache: boolean
207
225
  ): Promise<PermissionSet> => {
226
+ const cacheKey = permissionCacheKey(user);
208
227
  if (shouldCache) {
209
- const cached = permissionCache.get(user.id);
228
+ const cached = permissionCache.get(cacheKey);
210
229
  if (cached && cached.expiresAt > DateTime.now().toMillis()) {
211
- rememberPermissions(user.id, cached);
230
+ rememberPermissions(cacheKey, cached);
212
231
  return cached.permissions;
213
232
  }
214
233
  }
@@ -251,7 +270,7 @@ export const createPermissionResolver = <S extends Statements>(args: {
251
270
  }
252
271
 
253
272
  if (shouldCache) {
254
- rememberPermissions(user.id, {
273
+ rememberPermissions(cacheKey, {
255
274
  expiresAt: DateTime.now().plus({milliseconds: cacheTtlMs}).toMillis(),
256
275
  permissions,
257
276
  });
@@ -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
  },
@@ -1,4 +1,5 @@
1
1
  import {describe, expect, it} from "bun:test";
2
+ import {assert} from "chai";
2
3
 
3
4
  import {
4
5
  ADMIN_PAGE_PERMISSION,
@@ -12,13 +13,27 @@ import {
12
13
  describe("rbac statements", () => {
13
14
  it("exports terreno default vocabulary", () => {
14
15
  expect(terrenoStatements.admin).toContain("access");
16
+ expect(terrenoStatements.admin).toContain("jobs");
15
17
  expect(ADMIN_PAGE_PERMISSION).toEqual({admin: ["access"]});
16
18
  expect(terrenoStatements.rbac).toContain("manageRoles");
17
19
  expect(terrenoStatements.user).toContain("read");
18
20
  expect(terrenoStatements.configuration).toContain("update");
19
21
  expect(terrenoStatements.featureFlag).toEqual(["create", "list", "read", "update", "delete"]);
22
+ expect(terrenoStatements.organization).toEqual([
23
+ "create",
24
+ "list",
25
+ "read",
26
+ "update",
27
+ "delete",
28
+ "manageMembers",
29
+ "disable",
30
+ ]);
20
31
  expect(terrenoStatements.consentForm).toEqual(["create", "list", "read", "update", "delete"]);
21
32
  expect(terrenoStatements.consentResponse).toEqual(["list", "read"]);
33
+ assert.deepEqual(
34
+ [...terrenoStatements.adminAnnouncementClickEvent],
35
+ ["read", "write", "writeOwned"]
36
+ );
22
37
  });
23
38
 
24
39
  it("merges app statements over terreno defaults", () => {
@@ -40,6 +55,9 @@ describe("rbac statements", () => {
40
55
  expect(expanded.featureFlag).toEqual([...terrenoStatements.featureFlag]);
41
56
  expect(expanded.consentForm).toEqual([...terrenoStatements.consentForm]);
42
57
  expect(expanded.consentResponse).toEqual([...terrenoStatements.consentResponse]);
58
+ assert.deepEqual(expanded.adminAnnouncementClickEvent, [
59
+ ...terrenoStatements.adminAnnouncementClickEvent,
60
+ ]);
43
61
  });
44
62
 
45
63
  it("expands read-only sentinel to read-ish actions", () => {
@@ -56,6 +74,7 @@ describe("rbac statements", () => {
56
74
  expect(expanded.featureFlag).toEqual(["list", "read"]);
57
75
  expect(expanded.consentForm).toEqual(["list", "read"]);
58
76
  expect(expanded.consentResponse).toEqual(["list", "read"]);
77
+ expect(expanded.organization).toEqual(["list", "read"]);
59
78
  });
60
79
 
61
80
  it("returns concrete permission sets unchanged", () => {
@@ -8,15 +8,33 @@ export const ADMIN_PAGE_PERMISSION = {
8
8
  [ADMIN_PAGE_RESOURCE]: [ADMIN_PAGE_ACTION],
9
9
  } as const;
10
10
 
11
+ export const ORGANIZATION_ACTIONS = [
12
+ "create",
13
+ "list",
14
+ "read",
15
+ "update",
16
+ "delete",
17
+ "manageMembers",
18
+ "disable",
19
+ ] as const;
20
+
11
21
  export const terrenoStatements = {
12
- admin: [ADMIN_PAGE_ACTION, "runScripts", "viewBackgroundTasks"],
22
+ admin: [ADMIN_PAGE_ACTION, "jobs", "runScripts", "viewBackgroundTasks"],
23
+ adminAnnouncement: ADMIN_MODEL_ACCESS,
24
+ adminAnnouncementAcknowledgement: ADMIN_MODEL_ACCESS,
25
+ adminAnnouncementClickEvent: ADMIN_MODEL_ACCESS,
26
+ adminAnnouncementImpression: ADMIN_MODEL_ACCESS,
13
27
  adminConsentForm: ADMIN_MODEL_ACCESS,
14
28
  adminConsentResponse: ADMIN_MODEL_ACCESS,
15
29
  adminFeatureFlag: ADMIN_MODEL_ACCESS,
30
+ announcement: MODEL_CRUD,
31
+ announcementAcknowledgement: ["list", "read"],
32
+ announcementImpression: ["list", "read"],
16
33
  configuration: ["read", "update"],
17
34
  consentForm: MODEL_CRUD,
18
35
  consentResponse: ["list", "read"],
19
36
  featureFlag: MODEL_CRUD,
37
+ organization: ORGANIZATION_ACTIONS,
20
38
  rbac: ["read", "manageRoles", "assignRoles"],
21
39
  user: ["create", "list", "read", "update", "delete", "impersonate", "setPassword"],
22
40
  } as const;
package/src/rbac/types.ts CHANGED
@@ -150,6 +150,11 @@ export type RbacAuditSink = (record: RbacAuditWrite) => void | Promise<void>;
150
150
  export interface AccessOptions<S extends Statements> {
151
151
  connection: Connection;
152
152
  statements: S;
153
+ /**
154
+ * Opt in to organization RBAC: membership `org-admin` grants and the locked `operator` seed.
155
+ * Default `false` so existing single-tenant apps stay unchanged. New apps from bootstrap pass `true`.
156
+ */
157
+ organizations?: boolean;
153
158
  userModel?: UserModel;
154
159
  defaultRoles?: RoleDefinition[];
155
160
  scopes?: ResourceScopes<S>;