@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
@@ -1,134 +1,33 @@
1
1
  "use strict";
2
- var __assign = (this && this.__assign) || function () {
3
- __assign = Object.assign || function(t) {
4
- for (var s, i = 1, n = arguments.length; i < n; i++) {
5
- s = arguments[i];
6
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
- t[p] = s[p];
8
- }
9
- return t;
10
- };
11
- return __assign.apply(this, arguments);
12
- };
13
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
- return new (P || (P = Promise))(function (resolve, reject) {
16
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
- step((generator = generator.apply(thisArg, _arguments || [])).next());
20
- });
21
- };
22
- var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
- function verb(n) { return function (v) { return step([n, v]); }; }
26
- function step(op) {
27
- if (f) throw new TypeError("Generator is already executing.");
28
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
30
- if (y = 0, t) op = [op[0] & 2, t.value];
31
- switch (op[0]) {
32
- case 0: case 1: t = op; break;
33
- case 4: _.label++; return { value: op[1], done: false };
34
- case 5: _.label++; y = op[1]; op = [0]; continue;
35
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
- default:
37
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
- if (t[2]) _.ops.pop();
42
- _.trys.pop(); continue;
43
- }
44
- op = body.call(thisArg, _);
45
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
47
- }
48
- };
49
- var __values = (this && this.__values) || function(o) {
50
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
51
- if (m) return m.call(o);
52
- if (o && typeof o.length === "number") return {
53
- next: function () {
54
- if (o && i >= o.length) o = void 0;
55
- return { value: o && o[i++], done: !o };
56
- }
57
- };
58
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
59
- };
60
- var __read = (this && this.__read) || function (o, n) {
61
- var m = typeof Symbol === "function" && o[Symbol.iterator];
62
- if (!m) return o;
63
- var i = m.call(o), r, ar = [], e;
64
- try {
65
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
66
- }
67
- catch (error) { e = { error: error }; }
68
- finally {
69
- try {
70
- if (r && !r.done && (m = i["return"])) m.call(i);
71
- }
72
- finally { if (e) throw e.error; }
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createRoleManager = void 0;
4
+ const errors_1 = require("../errors");
5
+ const logger_1 = require("../logger");
6
+ const auditModel_1 = require("./auditModel");
7
+ const permissionUtils_1 = require("./permissionUtils");
8
+ const roleModel_1 = require("./roleModel");
9
+ const assertCanManageRoles = async (actor, getActorPermissions) => {
10
+ const actorPermissions = await getActorPermissions(actor);
11
+ if (!actorPermissions.rbac?.includes("manageRoles")) {
12
+ throw new errors_1.APIError({ status: 403, title: "Missing rbac:manageRoles permission" });
73
13
  }
74
- return ar;
75
14
  };
76
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
77
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
78
- if (ar || !(i in from)) {
79
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
80
- ar[i] = from[i];
81
- }
15
+ const assertCanAssignRoles = async (actor, getActorPermissions) => {
16
+ const actorPermissions = await getActorPermissions(actor);
17
+ if (!actorPermissions.rbac?.includes("assignRoles")) {
18
+ throw new errors_1.APIError({ status: 403, title: "Missing rbac:assignRoles permission" });
82
19
  }
83
- return to.concat(ar || Array.prototype.slice.call(from));
84
20
  };
85
- Object.defineProperty(exports, "__esModule", { value: true });
86
- exports.createRoleManager = void 0;
87
- var errors_1 = require("../errors");
88
- var logger_1 = require("../logger");
89
- var auditModel_1 = require("./auditModel");
90
- var permissionUtils_1 = require("./permissionUtils");
91
- var roleModel_1 = require("./roleModel");
92
- var assertCanManageRoles = function (actor, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
93
- var actorPermissions;
94
- var _a;
95
- return __generator(this, function (_b) {
96
- switch (_b.label) {
97
- case 0: return [4 /*yield*/, getActorPermissions(actor)];
98
- case 1:
99
- actorPermissions = _b.sent();
100
- if (!((_a = actorPermissions.rbac) === null || _a === void 0 ? void 0 : _a.includes("manageRoles"))) {
101
- throw new errors_1.APIError({ status: 403, title: "Missing rbac:manageRoles permission" });
102
- }
103
- return [2 /*return*/];
104
- }
105
- });
106
- }); };
107
- var assertCanAssignRoles = function (actor, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
108
- var actorPermissions;
109
- var _a;
110
- return __generator(this, function (_b) {
111
- switch (_b.label) {
112
- case 0: return [4 /*yield*/, getActorPermissions(actor)];
113
- case 1:
114
- actorPermissions = _b.sent();
115
- if (!((_a = actorPermissions.rbac) === null || _a === void 0 ? void 0 : _a.includes("assignRoles"))) {
116
- throw new errors_1.APIError({ status: 403, title: "Missing rbac:assignRoles permission" });
117
- }
118
- return [2 /*return*/];
119
- }
120
- });
121
- }); };
122
- var assertValidPermissionSet = function (permissions, statements) {
21
+ const assertValidPermissionSet = (permissions, statements) => {
123
22
  try {
124
23
  (0, permissionUtils_1.validatePermissionSet)(permissions, statements);
125
24
  }
126
25
  catch (error) {
127
- var message = error instanceof Error ? error.message : "Invalid permissions";
26
+ const message = error instanceof Error ? error.message : "Invalid permissions";
128
27
  throw new errors_1.APIError({ detail: message, status: 400, title: "Invalid permissions" });
129
28
  }
130
29
  };
131
- var assertUserSaveAvailable = function (targetUser) {
30
+ const assertUserSaveAvailable = (targetUser) => {
132
31
  if (typeof targetUser.save !== "function") {
133
32
  throw new errors_1.APIError({
134
33
  status: 500,
@@ -136,606 +35,325 @@ var assertUserSaveAvailable = function (targetUser) {
136
35
  });
137
36
  }
138
37
  };
139
- var isEscalationDenial = function (error) {
38
+ const isEscalationDenial = (error) => {
140
39
  return ((0, errors_1.isAPIError)(error) &&
141
40
  error.status === 403 &&
142
41
  error.title === "Cannot grant permissions you do not hold");
143
42
  };
144
- var assertNoEscalation = function (actor, permissions, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
145
- var actorPermissions;
146
- return __generator(this, function (_a) {
147
- switch (_a.label) {
148
- case 0: return [4 /*yield*/, getActorPermissions(actor)];
149
- case 1:
150
- actorPermissions = _a.sent();
151
- if (!(0, permissionUtils_1.isPermissionSubset)(actorPermissions, permissions)) {
152
- logger_1.logger.warn("RBAC escalation attempt denied", {
153
- actorId: actor.id,
154
- requestedPermissions: permissions,
155
- });
156
- throw new errors_1.APIError({
157
- status: 403,
158
- title: "Cannot grant permissions you do not hold",
159
- });
160
- }
161
- return [2 /*return*/];
43
+ const assertNoEscalation = async (actor, permissions, getActorPermissions) => {
44
+ const actorPermissions = await getActorPermissions(actor);
45
+ if (!(0, permissionUtils_1.isPermissionSubset)(actorPermissions, permissions)) {
46
+ logger_1.logger.warn("RBAC escalation attempt denied", {
47
+ actorId: actor.id,
48
+ requestedPermissions: permissions,
49
+ });
50
+ throw new errors_1.APIError({
51
+ status: 403,
52
+ title: "Cannot grant permissions you do not hold",
53
+ });
54
+ }
55
+ };
56
+ const assertCanModifyTargetUser = async (actor, target, getActorPermissions) => {
57
+ const actorPermissions = await getActorPermissions(actor);
58
+ const targetPermissions = await getActorPermissions(target);
59
+ if (!(0, permissionUtils_1.isPermissionSubset)(actorPermissions, targetPermissions)) {
60
+ logger_1.logger.warn("RBAC privileged-user mutation denied", {
61
+ actorId: actor.id,
62
+ targetId: target.id,
63
+ });
64
+ throw new errors_1.APIError({
65
+ status: 403,
66
+ title: "Cannot modify a user with permissions you do not hold",
67
+ });
68
+ }
69
+ };
70
+ const createRoleManager = (args) => {
71
+ const { connection, statements, defaultRoles = roleModel_1.terrenoDefaultRoles, getActorPermissions, getPreviewPermissions, invalidateCache, userModel, persistAudit = true, auditSinks = [], } = args;
72
+ const rbacRoleModel = (0, roleModel_1.createRbacRoleModel)(connection);
73
+ const rbacAuditModel = persistAudit ? (0, auditModel_1.createRbacAuditModel)(connection) : undefined;
74
+ const emitAudit = async (record) => {
75
+ try {
76
+ if (rbacAuditModel) {
77
+ await (0, auditModel_1.recordRbacAudit)(rbacAuditModel, record);
78
+ }
79
+ for (const sink of auditSinks) {
80
+ await sink(record);
81
+ }
162
82
  }
163
- });
164
- }); };
165
- var assertCanModifyTargetUser = function (actor, target, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
166
- var actorPermissions, targetPermissions;
167
- return __generator(this, function (_a) {
168
- switch (_a.label) {
169
- case 0: return [4 /*yield*/, getActorPermissions(actor)];
170
- case 1:
171
- actorPermissions = _a.sent();
172
- return [4 /*yield*/, getActorPermissions(target)];
173
- case 2:
174
- targetPermissions = _a.sent();
175
- if (!(0, permissionUtils_1.isPermissionSubset)(actorPermissions, targetPermissions)) {
176
- logger_1.logger.warn("RBAC privileged-user mutation denied", {
177
- actorId: actor.id,
178
- targetId: target.id,
179
- });
180
- throw new errors_1.APIError({
181
- status: 403,
182
- title: "Cannot modify a user with permissions you do not hold",
183
- });
184
- }
185
- return [2 /*return*/];
83
+ catch (error) {
84
+ logger_1.logger.error("Failed to write RbacAudit", {
85
+ action: record.action,
86
+ actorId: record.actorId,
87
+ error,
88
+ });
89
+ throw error;
186
90
  }
187
- });
188
- }); };
189
- var createRoleManager = function (args) {
190
- var connection = args.connection, statements = args.statements, _a = args.defaultRoles, defaultRoles = _a === void 0 ? roleModel_1.terrenoDefaultRoles : _a, getActorPermissions = args.getActorPermissions, getPreviewPermissions = args.getPreviewPermissions, invalidateCache = args.invalidateCache, userModel = args.userModel, _b = args.persistAudit, persistAudit = _b === void 0 ? true : _b, _c = args.auditSinks, auditSinks = _c === void 0 ? [] : _c;
191
- var rbacRoleModel = (0, roleModel_1.createRbacRoleModel)(connection);
192
- var rbacAuditModel = persistAudit ? (0, auditModel_1.createRbacAuditModel)(connection) : undefined;
193
- var emitAudit = function (record) { return __awaiter(void 0, void 0, void 0, function () {
194
- var auditSinks_1, auditSinks_1_1, sink, e_1_1, error_1;
195
- var e_1, _a;
196
- return __generator(this, function (_b) {
197
- switch (_b.label) {
198
- case 0:
199
- _b.trys.push([0, 10, , 11]);
200
- if (!rbacAuditModel) return [3 /*break*/, 2];
201
- return [4 /*yield*/, (0, auditModel_1.recordRbacAudit)(rbacAuditModel, record)];
202
- case 1:
203
- _b.sent();
204
- _b.label = 2;
205
- case 2:
206
- _b.trys.push([2, 7, 8, 9]);
207
- auditSinks_1 = __values(auditSinks), auditSinks_1_1 = auditSinks_1.next();
208
- _b.label = 3;
209
- case 3:
210
- if (!!auditSinks_1_1.done) return [3 /*break*/, 6];
211
- sink = auditSinks_1_1.value;
212
- return [4 /*yield*/, sink(record)];
213
- case 4:
214
- _b.sent();
215
- _b.label = 5;
216
- case 5:
217
- auditSinks_1_1 = auditSinks_1.next();
218
- return [3 /*break*/, 3];
219
- case 6: return [3 /*break*/, 9];
220
- case 7:
221
- e_1_1 = _b.sent();
222
- e_1 = { error: e_1_1 };
223
- return [3 /*break*/, 9];
224
- case 8:
225
- try {
226
- if (auditSinks_1_1 && !auditSinks_1_1.done && (_a = auditSinks_1.return)) _a.call(auditSinks_1);
227
- }
228
- finally { if (e_1) throw e_1.error; }
229
- return [7 /*endfinally*/];
230
- case 9: return [3 /*break*/, 11];
231
- case 10:
232
- error_1 = _b.sent();
233
- logger_1.logger.error("Failed to write RbacAudit", {
234
- action: record.action,
235
- actorId: record.actorId,
236
- error: error_1,
237
- });
238
- throw error_1;
239
- case 11: return [2 /*return*/];
91
+ };
92
+ const assertNoEscalationOrAudit = async (args) => {
93
+ try {
94
+ await assertNoEscalation(args.actor, args.permissions, getActorPermissions);
95
+ }
96
+ catch (error) {
97
+ if (!isEscalationDenial(error)) {
98
+ throw error;
240
99
  }
241
- });
242
- }); };
243
- var assertNoEscalationOrAudit = function (args) { return __awaiter(void 0, void 0, void 0, function () {
244
- var error_2, auditError_1;
245
- return __generator(this, function (_a) {
246
- switch (_a.label) {
247
- case 0:
248
- _a.trys.push([0, 2, , 7]);
249
- return [4 /*yield*/, assertNoEscalation(args.actor, args.permissions, getActorPermissions)];
250
- case 1:
251
- _a.sent();
252
- return [3 /*break*/, 7];
253
- case 2:
254
- error_2 = _a.sent();
255
- if (!isEscalationDenial(error_2)) {
256
- throw error_2;
257
- }
258
- _a.label = 3;
259
- case 3:
260
- _a.trys.push([3, 5, , 6]);
261
- return [4 /*yield*/, emitAudit({
262
- action: args.action,
263
- actorId: args.actor.id,
264
- denied: true,
265
- permissionDelta: { gained: args.permissions, lost: {} },
266
- targetRoleName: args.targetRoleName,
267
- targetUserId: args.targetUserId,
268
- })];
269
- case 4:
270
- _a.sent();
271
- return [3 /*break*/, 6];
272
- case 5:
273
- auditError_1 = _a.sent();
274
- logger_1.logger.error("Failed to write denied RbacAudit", {
275
- action: args.action,
276
- actorId: args.actor.id,
277
- error: auditError_1,
278
- });
279
- return [3 /*break*/, 6];
280
- case 6: throw error_2;
281
- case 7: return [2 /*return*/];
100
+ try {
101
+ await emitAudit({
102
+ action: args.action,
103
+ actorId: args.actor.id,
104
+ denied: true,
105
+ permissionDelta: { gained: args.permissions, lost: {} },
106
+ targetRoleName: args.targetRoleName,
107
+ targetUserId: args.targetUserId,
108
+ });
282
109
  }
283
- });
284
- }); };
285
- var seedDefaults = function () { return __awaiter(void 0, void 0, void 0, function () {
286
- return __generator(this, function (_a) {
287
- switch (_a.label) {
288
- case 0: return [4 /*yield*/, rbacRoleModel.seedDefaults({ extraRoles: defaultRoles, statements: statements })];
289
- case 1:
290
- _a.sent();
291
- return [2 /*return*/];
110
+ catch (auditError) {
111
+ logger_1.logger.error("Failed to write denied RbacAudit", {
112
+ action: args.action,
113
+ actorId: args.actor.id,
114
+ error: auditError,
115
+ });
292
116
  }
293
- });
294
- }); };
295
- var roleManager = {
296
- assertCanModifyUser: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
297
- var targetUser;
298
- var actor = _b.actor, userId = _b.userId;
299
- return __generator(this, function (_c) {
300
- switch (_c.label) {
301
- case 0:
302
- if (!userModel) {
303
- throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
304
- }
305
- return [4 /*yield*/, userModel.findById(userId)];
306
- case 1:
307
- targetUser = _c.sent();
308
- if (!targetUser) {
309
- throw new errors_1.APIError({ status: 404, title: "User not found" });
310
- }
311
- return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
312
- case 2:
313
- _c.sent();
314
- return [2 /*return*/];
117
+ throw error;
118
+ }
119
+ };
120
+ const seedDefaults = async () => {
121
+ await rbacRoleModel.seedDefaults({ extraRoles: defaultRoles, statements });
122
+ };
123
+ const roleManager = {
124
+ assertCanModifyUser: async ({ actor, userId }) => {
125
+ if (!userModel) {
126
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
127
+ }
128
+ const targetUser = await userModel.findById(userId);
129
+ if (!targetUser) {
130
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
131
+ }
132
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
133
+ },
134
+ assign: async ({ actor, userId, roleNames }) => {
135
+ await assertCanAssignRoles(actor, getActorPermissions);
136
+ if (!userModel) {
137
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
138
+ }
139
+ const targetUser = await userModel.findById(userId);
140
+ if (!targetUser) {
141
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
142
+ }
143
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
144
+ const uniqueRoleNames = [...new Set(roleNames)];
145
+ for (let i = 0; i < uniqueRoleNames.length; i++) {
146
+ for (let j = i + 1; j < uniqueRoleNames.length; j++) {
147
+ const roleA = await rbacRoleModel.findExactlyOne({ name: uniqueRoleNames[i] });
148
+ const roleB = await rbacRoleModel.findExactlyOne({ name: uniqueRoleNames[j] });
149
+ if (roleA.excludesRoles.includes(roleB.name) ||
150
+ roleB.excludesRoles.includes(roleA.name)) {
151
+ throw new errors_1.APIError({
152
+ status: 409,
153
+ title: `Role ${roleA.name} conflicts with ${roleB.name}`,
154
+ });
155
+ }
315
156
  }
157
+ }
158
+ for (const roleName of uniqueRoleNames) {
159
+ const role = await rbacRoleModel.findExactlyOne({ name: roleName });
160
+ const permissions = role.permissions ?? {};
161
+ await assertNoEscalationOrAudit({
162
+ action: "role.assign",
163
+ actor,
164
+ permissions,
165
+ targetUserId: userId,
166
+ });
167
+ }
168
+ assertUserSaveAvailable(targetUser);
169
+ const before = await getPreviewPermissions(targetUser);
170
+ const rbacUser = targetUser;
171
+ rbacUser.roles = uniqueRoleNames;
172
+ await targetUser.save();
173
+ invalidateCache({ userId });
174
+ const after = await getPreviewPermissions(targetUser);
175
+ await emitAudit({
176
+ action: "role.assign",
177
+ actorId: actor.id,
178
+ permissionDelta: (0, permissionUtils_1.diffPermissionSets)(before, after),
179
+ targetUserId: userId,
316
180
  });
317
- }); },
318
- assign: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
319
- var targetUser, uniqueRoleNames, i, j, roleA, roleB, uniqueRoleNames_1, uniqueRoleNames_1_1, roleName, role, permissions, e_2_1, before, rbacUser, after;
320
- var e_2, _c;
321
- var _d;
322
- var actor = _b.actor, userId = _b.userId, roleNames = _b.roleNames;
323
- return __generator(this, function (_e) {
324
- switch (_e.label) {
325
- case 0: return [4 /*yield*/, assertCanAssignRoles(actor, getActorPermissions)];
326
- case 1:
327
- _e.sent();
328
- if (!userModel) {
329
- throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
330
- }
331
- return [4 /*yield*/, userModel.findById(userId)];
332
- case 2:
333
- targetUser = _e.sent();
334
- if (!targetUser) {
335
- throw new errors_1.APIError({ status: 404, title: "User not found" });
336
- }
337
- return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
338
- case 3:
339
- _e.sent();
340
- uniqueRoleNames = __spreadArray([], __read(new Set(roleNames)), false);
341
- i = 0;
342
- _e.label = 4;
343
- case 4:
344
- if (!(i < uniqueRoleNames.length)) return [3 /*break*/, 10];
345
- j = i + 1;
346
- _e.label = 5;
347
- case 5:
348
- if (!(j < uniqueRoleNames.length)) return [3 /*break*/, 9];
349
- return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: uniqueRoleNames[i] })];
350
- case 6:
351
- roleA = _e.sent();
352
- return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: uniqueRoleNames[j] })];
353
- case 7:
354
- roleB = _e.sent();
355
- if (roleA.excludesRoles.includes(roleB.name) ||
356
- roleB.excludesRoles.includes(roleA.name)) {
357
- throw new errors_1.APIError({
358
- status: 409,
359
- title: "Role ".concat(roleA.name, " conflicts with ").concat(roleB.name),
360
- });
361
- }
362
- _e.label = 8;
363
- case 8:
364
- j++;
365
- return [3 /*break*/, 5];
366
- case 9:
367
- i++;
368
- return [3 /*break*/, 4];
369
- case 10:
370
- _e.trys.push([10, 16, 17, 18]);
371
- uniqueRoleNames_1 = __values(uniqueRoleNames), uniqueRoleNames_1_1 = uniqueRoleNames_1.next();
372
- _e.label = 11;
373
- case 11:
374
- if (!!uniqueRoleNames_1_1.done) return [3 /*break*/, 15];
375
- roleName = uniqueRoleNames_1_1.value;
376
- return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
377
- case 12:
378
- role = _e.sent();
379
- permissions = (_d = role.permissions) !== null && _d !== void 0 ? _d : {};
380
- return [4 /*yield*/, assertNoEscalationOrAudit({
381
- action: "role.assign",
382
- actor: actor,
383
- permissions: permissions,
384
- targetUserId: userId,
385
- })];
386
- case 13:
387
- _e.sent();
388
- _e.label = 14;
389
- case 14:
390
- uniqueRoleNames_1_1 = uniqueRoleNames_1.next();
391
- return [3 /*break*/, 11];
392
- case 15: return [3 /*break*/, 18];
393
- case 16:
394
- e_2_1 = _e.sent();
395
- e_2 = { error: e_2_1 };
396
- return [3 /*break*/, 18];
397
- case 17:
398
- try {
399
- if (uniqueRoleNames_1_1 && !uniqueRoleNames_1_1.done && (_c = uniqueRoleNames_1.return)) _c.call(uniqueRoleNames_1);
400
- }
401
- finally { if (e_2) throw e_2.error; }
402
- return [7 /*endfinally*/];
403
- case 18:
404
- assertUserSaveAvailable(targetUser);
405
- return [4 /*yield*/, getPreviewPermissions(targetUser)];
406
- case 19:
407
- before = _e.sent();
408
- rbacUser = targetUser;
409
- rbacUser.roles = uniqueRoleNames;
410
- return [4 /*yield*/, targetUser.save()];
411
- case 20:
412
- _e.sent();
413
- invalidateCache({ userId: userId });
414
- return [4 /*yield*/, getPreviewPermissions(targetUser)];
415
- case 21:
416
- after = _e.sent();
417
- return [4 /*yield*/, emitAudit({
418
- action: "role.assign",
419
- actorId: actor.id,
420
- permissionDelta: (0, permissionUtils_1.diffPermissionSets)(before, after),
421
- targetUserId: userId,
422
- })];
423
- case 22:
424
- _e.sent();
425
- return [2 /*return*/];
426
- }
181
+ },
182
+ create: async ({ actor, role }) => {
183
+ await assertCanManageRoles(actor, getActorPermissions);
184
+ assertValidPermissionSet(role.permissions, statements);
185
+ await assertNoEscalationOrAudit({
186
+ action: "role.create",
187
+ actor,
188
+ permissions: role.permissions,
189
+ targetRoleName: role.name,
427
190
  });
428
- }); },
429
- create: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
430
- var created;
431
- var _c, _d, _e, _f;
432
- var actor = _b.actor, role = _b.role;
433
- return __generator(this, function (_g) {
434
- switch (_g.label) {
435
- case 0: return [4 /*yield*/, assertCanManageRoles(actor, getActorPermissions)];
436
- case 1:
437
- _g.sent();
438
- assertValidPermissionSet(role.permissions, statements);
439
- return [4 /*yield*/, assertNoEscalationOrAudit({
440
- action: "role.create",
441
- actor: actor,
442
- permissions: role.permissions,
443
- targetRoleName: role.name,
444
- })];
445
- case 2:
446
- _g.sent();
447
- return [4 /*yield*/, rbacRoleModel.create(__assign(__assign({}, role), { description: (_c = role.description) !== null && _c !== void 0 ? _c : undefined, excludesRoles: (_d = role.excludesRoles) !== null && _d !== void 0 ? _d : [], isLocked: (_e = role.isLocked) !== null && _e !== void 0 ? _e : false, isSealed: (_f = role.isSealed) !== null && _f !== void 0 ? _f : false }))];
448
- case 3:
449
- created = _g.sent();
450
- return [4 /*yield*/, emitAudit({
451
- action: "role.create",
452
- actorId: actor.id,
453
- permissionDelta: { gained: created.permissions, lost: {} },
454
- targetRoleName: created.name,
455
- })];
456
- case 4:
457
- _g.sent();
458
- return [2 /*return*/, created];
459
- }
191
+ const created = await rbacRoleModel.create({
192
+ ...role,
193
+ description: role.description ?? undefined,
194
+ excludesRoles: role.excludesRoles ?? [],
195
+ isLocked: role.isLocked ?? false,
196
+ isSealed: role.isSealed ?? false,
460
197
  });
461
- }); },
462
- list: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
463
- return [2 /*return*/, rbacRoleModel.find({}).sort({ name: 1 })];
464
- }); }); },
465
- previewAssignment: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
466
- var targetUser, uniqueRoleNames, uniqueRoleNames_2, uniqueRoleNames_2_1, roleName, role, e_3_1, before, previewUser, after, diff;
467
- var e_3, _c;
468
- var _d;
469
- var actor = _b.actor, userId = _b.userId, roleNames = _b.roleNames;
470
- return __generator(this, function (_e) {
471
- switch (_e.label) {
472
- case 0: return [4 /*yield*/, assertCanAssignRoles(actor, getActorPermissions)];
473
- case 1:
474
- _e.sent();
475
- if (!userModel) {
476
- throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
477
- }
478
- return [4 /*yield*/, userModel.findById(userId)];
479
- case 2:
480
- targetUser = _e.sent();
481
- if (!targetUser) {
482
- throw new errors_1.APIError({ status: 404, title: "User not found" });
483
- }
484
- return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
485
- case 3:
486
- _e.sent();
487
- uniqueRoleNames = __spreadArray([], __read(new Set(roleNames)), false);
488
- _e.label = 4;
489
- case 4:
490
- _e.trys.push([4, 10, 11, 12]);
491
- uniqueRoleNames_2 = __values(uniqueRoleNames), uniqueRoleNames_2_1 = uniqueRoleNames_2.next();
492
- _e.label = 5;
493
- case 5:
494
- if (!!uniqueRoleNames_2_1.done) return [3 /*break*/, 9];
495
- roleName = uniqueRoleNames_2_1.value;
496
- return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
497
- case 6:
498
- role = _e.sent();
499
- return [4 /*yield*/, assertNoEscalation(actor, (_d = role.permissions) !== null && _d !== void 0 ? _d : {}, getActorPermissions)];
500
- case 7:
501
- _e.sent();
502
- _e.label = 8;
503
- case 8:
504
- uniqueRoleNames_2_1 = uniqueRoleNames_2.next();
505
- return [3 /*break*/, 5];
506
- case 9: return [3 /*break*/, 12];
507
- case 10:
508
- e_3_1 = _e.sent();
509
- e_3 = { error: e_3_1 };
510
- return [3 /*break*/, 12];
511
- case 11:
512
- try {
513
- if (uniqueRoleNames_2_1 && !uniqueRoleNames_2_1.done && (_c = uniqueRoleNames_2.return)) _c.call(uniqueRoleNames_2);
514
- }
515
- finally { if (e_3) throw e_3.error; }
516
- return [7 /*endfinally*/];
517
- case 12: return [4 /*yield*/, getPreviewPermissions(targetUser)];
518
- case 13:
519
- before = _e.sent();
520
- previewUser = __assign(__assign({}, (typeof targetUser.toObject ===
521
- "function"
522
- ? targetUser.toObject()
523
- : targetUser)), { id: targetUser.id, roles: uniqueRoleNames });
524
- return [4 /*yield*/, getPreviewPermissions(previewUser)];
525
- case 14:
526
- after = _e.sent();
527
- diff = (0, permissionUtils_1.diffPermissionSets)(before, after);
528
- return [2 /*return*/, __assign(__assign({}, diff), { resulting: after })];
529
- }
198
+ await emitAudit({
199
+ action: "role.create",
200
+ actorId: actor.id,
201
+ permissionDelta: { gained: created.permissions, lost: {} },
202
+ targetRoleName: created.name,
530
203
  });
531
- }); },
532
- previewRoleChange: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
533
- var existing, diff, affectedUserCount, _c;
534
- var roleName = _b.roleName, permissions = _b.permissions;
535
- return __generator(this, function (_d) {
536
- switch (_d.label) {
537
- case 0: return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
538
- case 1:
539
- existing = _d.sent();
540
- diff = (0, permissionUtils_1.diffPermissionSets)(existing.permissions, permissions);
541
- if (!userModel) return [3 /*break*/, 3];
542
- return [4 /*yield*/, userModel.countDocuments({ roles: roleName })];
543
- case 2:
544
- _c = _d.sent();
545
- return [3 /*break*/, 4];
546
- case 3:
547
- _c = 0;
548
- _d.label = 4;
549
- case 4:
550
- affectedUserCount = _c;
551
- return [2 /*return*/, __assign(__assign({}, diff), { affectedUserCount: affectedUserCount })];
552
- }
204
+ return created;
205
+ },
206
+ list: async () => rbacRoleModel.find({}).sort({ name: 1 }),
207
+ previewAssignment: async ({ actor, userId, roleNames }) => {
208
+ await assertCanAssignRoles(actor, getActorPermissions);
209
+ if (!userModel) {
210
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
211
+ }
212
+ const targetUser = await userModel.findById(userId);
213
+ if (!targetUser) {
214
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
215
+ }
216
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
217
+ const uniqueRoleNames = [...new Set(roleNames)];
218
+ for (const roleName of uniqueRoleNames) {
219
+ const role = await rbacRoleModel.findExactlyOne({ name: roleName });
220
+ await assertNoEscalation(actor, role.permissions ?? {}, getActorPermissions);
221
+ }
222
+ const before = await getPreviewPermissions(targetUser);
223
+ const previewUser = {
224
+ ...(typeof targetUser.toObject ===
225
+ "function"
226
+ ? targetUser.toObject()
227
+ : targetUser),
228
+ id: targetUser.id,
229
+ roles: uniqueRoleNames,
230
+ };
231
+ const after = await getPreviewPermissions(previewUser);
232
+ const diff = (0, permissionUtils_1.diffPermissionSets)(before, after);
233
+ return {
234
+ ...diff,
235
+ resulting: after,
236
+ };
237
+ },
238
+ previewRoleChange: async ({ roleName, permissions }) => {
239
+ const existing = await rbacRoleModel.findExactlyOne({ name: roleName });
240
+ const diff = (0, permissionUtils_1.diffPermissionSets)(existing.permissions, permissions);
241
+ const affectedUserCount = userModel ? await userModel.countDocuments({ roles: roleName }) : 0;
242
+ return {
243
+ ...diff,
244
+ affectedUserCount,
245
+ };
246
+ },
247
+ remove: async ({ actor, roleName }) => {
248
+ await assertCanManageRoles(actor, getActorPermissions);
249
+ const existing = await rbacRoleModel.findExactlyOne({ name: roleName });
250
+ if (existing.isLocked) {
251
+ throw new errors_1.APIError({ status: 400, title: "Cannot delete a locked role" });
252
+ }
253
+ await assertNoEscalationOrAudit({
254
+ action: "role.remove",
255
+ actor,
256
+ permissions: existing.permissions ?? {},
257
+ targetRoleName: roleName,
553
258
  });
554
- }); },
555
- remove: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
556
- var existing;
557
- var _c;
558
- var actor = _b.actor, roleName = _b.roleName;
559
- return __generator(this, function (_d) {
560
- switch (_d.label) {
561
- case 0: return [4 /*yield*/, assertCanManageRoles(actor, getActorPermissions)];
562
- case 1:
563
- _d.sent();
564
- return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
565
- case 2:
566
- existing = _d.sent();
567
- if (existing.isLocked) {
568
- throw new errors_1.APIError({ status: 400, title: "Cannot delete a locked role" });
569
- }
570
- return [4 /*yield*/, assertNoEscalationOrAudit({
571
- action: "role.remove",
572
- actor: actor,
573
- permissions: (_c = existing.permissions) !== null && _c !== void 0 ? _c : {},
574
- targetRoleName: roleName,
575
- })];
576
- case 3:
577
- _d.sent();
578
- return [4 /*yield*/, existing.deleteOne()];
579
- case 4:
580
- _d.sent();
581
- invalidateCache();
582
- return [4 /*yield*/, emitAudit({
583
- action: "role.remove",
584
- actorId: actor.id,
585
- permissionDelta: { gained: {}, lost: existing.permissions },
586
- targetRoleName: roleName,
587
- })];
588
- case 5:
589
- _d.sent();
590
- return [2 /*return*/];
591
- }
259
+ await existing.deleteOne();
260
+ invalidateCache();
261
+ await emitAudit({
262
+ action: "role.remove",
263
+ actorId: actor.id,
264
+ permissionDelta: { gained: {}, lost: existing.permissions },
265
+ targetRoleName: roleName,
592
266
  });
593
- }); },
594
- seedDefaults: seedDefaults,
595
- unassign: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
596
- var targetUser, before, rbacUser, after;
597
- var actor = _b.actor, userId = _b.userId, roleNames = _b.roleNames;
598
- return __generator(this, function (_c) {
599
- switch (_c.label) {
600
- case 0: return [4 /*yield*/, assertCanAssignRoles(actor, getActorPermissions)];
601
- case 1:
602
- _c.sent();
603
- if (!userModel) {
604
- throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
605
- }
606
- return [4 /*yield*/, userModel.findById(userId)];
607
- case 2:
608
- targetUser = _c.sent();
609
- if (!targetUser) {
610
- throw new errors_1.APIError({ status: 404, title: "User not found" });
611
- }
612
- return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
613
- case 3:
614
- _c.sent();
615
- assertUserSaveAvailable(targetUser);
616
- return [4 /*yield*/, getPreviewPermissions(targetUser)];
617
- case 4:
618
- before = _c.sent();
619
- rbacUser = targetUser;
620
- rbacUser.roles = rbacUser.roles.filter(function (role) { return !roleNames.includes(role); });
621
- return [4 /*yield*/, targetUser.save()];
622
- case 5:
623
- _c.sent();
624
- invalidateCache({ userId: userId });
625
- return [4 /*yield*/, getPreviewPermissions(targetUser)];
626
- case 6:
627
- after = _c.sent();
628
- return [4 /*yield*/, emitAudit({
629
- action: "role.unassign",
630
- actorId: actor.id,
631
- permissionDelta: (0, permissionUtils_1.diffPermissionSets)(before, after),
632
- targetUserId: userId,
633
- })];
634
- case 7:
635
- _c.sent();
636
- return [2 /*return*/];
637
- }
267
+ },
268
+ seedDefaults,
269
+ unassign: async ({ actor, userId, roleNames }) => {
270
+ await assertCanAssignRoles(actor, getActorPermissions);
271
+ if (!userModel) {
272
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
273
+ }
274
+ const targetUser = await userModel.findById(userId);
275
+ if (!targetUser) {
276
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
277
+ }
278
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
279
+ assertUserSaveAvailable(targetUser);
280
+ const before = await getPreviewPermissions(targetUser);
281
+ const rbacUser = targetUser;
282
+ rbacUser.roles = rbacUser.roles.filter((role) => !roleNames.includes(role));
283
+ await targetUser.save();
284
+ invalidateCache({ userId });
285
+ const after = await getPreviewPermissions(targetUser);
286
+ await emitAudit({
287
+ action: "role.unassign",
288
+ actorId: actor.id,
289
+ permissionDelta: (0, permissionUtils_1.diffPermissionSets)(before, after),
290
+ targetUserId: userId,
638
291
  });
639
- }); },
640
- update: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
641
- var existing, forbidden, holders, excluded_1, conflicts, allowedChanges, _c, _d, key, value, beforePermissions;
642
- var e_4, _e;
643
- var _f;
644
- var actor = _b.actor, roleName = _b.roleName, changes = _b.changes;
645
- return __generator(this, function (_g) {
646
- switch (_g.label) {
647
- case 0: return [4 /*yield*/, assertCanManageRoles(actor, getActorPermissions)];
648
- case 1:
649
- _g.sent();
650
- return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
651
- case 2:
652
- existing = _g.sent();
653
- if (existing.isSealed) {
654
- throw new errors_1.APIError({ status: 400, title: "Cannot modify a sealed role" });
655
- }
656
- if (existing.isLocked) {
657
- forbidden = Object.keys(changes).filter(function (key) {
658
- return !["description", "displayName", "permissions", "excludesRoles", "name"].includes(key);
659
- });
660
- if (forbidden.length > 0) {
661
- throw new errors_1.APIError({
662
- status: 400,
663
- title: "Cannot change locked fields on a locked role",
664
- });
665
- }
666
- }
667
- if (!changes.permissions) return [3 /*break*/, 4];
668
- assertValidPermissionSet(changes.permissions, statements);
669
- return [4 /*yield*/, assertNoEscalationOrAudit({
670
- action: "role.update",
671
- actor: actor,
672
- permissions: (0, permissionUtils_1.unionPermissionSets)((_f = existing.permissions) !== null && _f !== void 0 ? _f : {}, changes.permissions),
673
- targetRoleName: roleName,
674
- })];
675
- case 3:
676
- _g.sent();
677
- _g.label = 4;
678
- case 4:
679
- if (changes.name && existing.isLocked) {
680
- throw new errors_1.APIError({ status: 400, title: "Cannot rename a locked role" });
681
- }
682
- if (!(changes.excludesRoles && userModel)) return [3 /*break*/, 6];
683
- return [4 /*yield*/, userModel.find({ roles: roleName })];
684
- case 5:
685
- holders = _g.sent();
686
- excluded_1 = new Set(changes.excludesRoles);
687
- conflicts = holders.filter(function (holder) {
688
- var _a;
689
- var holderRoles = ((_a = holder.roles) !== null && _a !== void 0 ? _a : []).filter(function (role) { return role !== roleName; });
690
- return holderRoles.some(function (role) { return excluded_1.has(role); });
691
- });
692
- if (conflicts.length > 0) {
693
- throw new errors_1.APIError({
694
- status: 400,
695
- title: "excludesRoles conflicts with existing assignments",
696
- });
697
- }
698
- _g.label = 6;
699
- case 6:
700
- allowedChanges = {};
701
- try {
702
- for (_c = __values(["description", "displayName", "permissions", "excludesRoles", "name"]), _d = _c.next(); !_d.done; _d = _c.next()) {
703
- key = _d.value;
704
- if (key in changes) {
705
- value = changes[key];
706
- allowedChanges[key] = value === null ? undefined : value;
707
- }
708
- }
709
- }
710
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
711
- finally {
712
- try {
713
- if (_d && !_d.done && (_e = _c.return)) _e.call(_c);
714
- }
715
- finally { if (e_4) throw e_4.error; }
716
- }
717
- beforePermissions = existing.permissions;
718
- Object.assign(existing, allowedChanges);
719
- if (changes.description === null) {
720
- existing.set("description", undefined);
721
- }
722
- return [4 /*yield*/, existing.save()];
723
- case 7:
724
- _g.sent();
725
- invalidateCache();
726
- return [4 /*yield*/, emitAudit({
727
- action: "role.update",
728
- actorId: actor.id,
729
- permissionDelta: (0, permissionUtils_1.diffPermissionSets)(beforePermissions, existing.permissions),
730
- targetRoleName: existing.name,
731
- })];
732
- case 8:
733
- _g.sent();
734
- return [2 /*return*/, existing];
292
+ },
293
+ update: async ({ actor, roleName, changes }) => {
294
+ await assertCanManageRoles(actor, getActorPermissions);
295
+ const existing = await rbacRoleModel.findExactlyOne({ name: roleName });
296
+ if (existing.isSealed) {
297
+ throw new errors_1.APIError({ status: 400, title: "Cannot modify a sealed role" });
298
+ }
299
+ if (existing.isLocked) {
300
+ const forbidden = Object.keys(changes).filter((key) => !["description", "displayName", "permissions", "excludesRoles", "name"].includes(key));
301
+ if (forbidden.length > 0) {
302
+ throw new errors_1.APIError({
303
+ status: 400,
304
+ title: "Cannot change locked fields on a locked role",
305
+ });
735
306
  }
307
+ }
308
+ if (changes.permissions) {
309
+ assertValidPermissionSet(changes.permissions, statements);
310
+ await assertNoEscalationOrAudit({
311
+ action: "role.update",
312
+ actor,
313
+ permissions: (0, permissionUtils_1.unionPermissionSets)(existing.permissions ?? {}, changes.permissions),
314
+ targetRoleName: roleName,
315
+ });
316
+ }
317
+ if (changes.name && existing.isLocked) {
318
+ throw new errors_1.APIError({ status: 400, title: "Cannot rename a locked role" });
319
+ }
320
+ if (changes.excludesRoles && userModel) {
321
+ const holders = await userModel.find({ roles: roleName });
322
+ const excluded = new Set(changes.excludesRoles);
323
+ const conflicts = holders.filter((holder) => {
324
+ const holderRoles = (holder.roles ?? []).filter((role) => role !== roleName);
325
+ return holderRoles.some((role) => excluded.has(role));
326
+ });
327
+ if (conflicts.length > 0) {
328
+ throw new errors_1.APIError({
329
+ status: 400,
330
+ title: "excludesRoles conflicts with existing assignments",
331
+ });
332
+ }
333
+ }
334
+ const allowedChanges = {};
335
+ for (const key of ["description", "displayName", "permissions", "excludesRoles", "name"]) {
336
+ if (key in changes) {
337
+ const value = changes[key];
338
+ allowedChanges[key] = value === null ? undefined : value;
339
+ }
340
+ }
341
+ const beforePermissions = existing.permissions;
342
+ Object.assign(existing, allowedChanges);
343
+ if (changes.description === null) {
344
+ existing.set("description", undefined);
345
+ }
346
+ await existing.save();
347
+ invalidateCache();
348
+ await emitAudit({
349
+ action: "role.update",
350
+ actorId: actor.id,
351
+ permissionDelta: (0, permissionUtils_1.diffPermissionSets)(beforePermissions, existing.permissions),
352
+ targetRoleName: existing.name,
736
353
  });
737
- }); },
354
+ return existing;
355
+ },
738
356
  };
739
- return { roleManager: roleManager };
357
+ return { roleManager };
740
358
  };
741
359
  exports.createRoleManager = createRoleManager;