@terreno/api 57.3.0 → 57.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -0,0 +1,563 @@
1
+ import type express from "express";
2
+ import {type Application, Router} from "express";
3
+ import type mongoose from "mongoose";
4
+
5
+ import {asyncHandler, type OpenApiMiddleware} from "../api";
6
+ import {authenticateMiddleware, type User, type UserModel} from "../auth";
7
+ import {APIError, ConflictError, ForbiddenError, NotFoundError} from "../errors";
8
+ import {logger} from "../logger";
9
+ import {createOpenApiBuilder, type OpenApiSchemaProperty} from "../openApiBuilder";
10
+ import {findOneOrNoneFor} from "../plugins";
11
+ import type {AnyTerrenoAccess} from "../rbac/types";
12
+ import type {TerrenoPlugin} from "../terrenoPlugin";
13
+ import type {MembershipDocument} from "../types/membership";
14
+ import type {OrganizationDocument} from "../types/organization";
15
+ import {
16
+ assertOrganizationSlugAvailable,
17
+ Membership,
18
+ Organization,
19
+ organizationSlugFromName,
20
+ } from "./organizationModel";
21
+ import {registerOrganizationSettings} from "./organizationSettings";
22
+ import {assertOrganizationEnabled, isPlatformOrgActor, runWithOrgContext} from "./orgContext";
23
+
24
+ const escapeRegularExpression = (value: string): string => {
25
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
26
+ };
27
+
28
+ const findUserForAttach = async (
29
+ userModel: UserModel,
30
+ args: {email: string; userId: string}
31
+ ): Promise<User | null> => {
32
+ if (args.email) {
33
+ return findOneOrNoneFor(userModel, {
34
+ email: {$options: "i", $regex: `^${escapeRegularExpression(args.email)}$`},
35
+ } as never);
36
+ }
37
+ if (args.userId) {
38
+ return findOneOrNoneFor(userModel, {_id: args.userId} as never);
39
+ }
40
+ throw new APIError({status: 400, title: "email or userId is required"});
41
+ };
42
+
43
+ export interface OrgAuditEvent {
44
+ actorId?: string;
45
+ organizationId?: string;
46
+ organizationLabel?: string;
47
+ verb:
48
+ | "created"
49
+ | "updated"
50
+ | "disabled"
51
+ | "deleted"
52
+ | "memberAttached"
53
+ | "memberUpdated"
54
+ | "memberRemoved";
55
+ }
56
+
57
+ export interface OrgsAppOptions {
58
+ access: AnyTerrenoAccess;
59
+ basePath?: string;
60
+ onOrgAudit?: (event: OrgAuditEvent, req: express.Request) => void | Promise<void>;
61
+ /** Nested schema for `Organization.settings`. Same as `registerOrganizationSettings`. */
62
+ settingsSchema?: mongoose.Schema;
63
+ userModel: UserModel;
64
+ }
65
+
66
+ const pathParam = (value: string | string[] | undefined, title: string): string => {
67
+ if (typeof value !== "string" || value.length === 0) {
68
+ throw new APIError({status: 400, title});
69
+ }
70
+ return value;
71
+ };
72
+
73
+ const userIdOf = (user: User): string => {
74
+ if (user._id) {
75
+ return String(user._id);
76
+ }
77
+ return user.id;
78
+ };
79
+
80
+ const requireUser = (req: express.Request): User => {
81
+ const user = req.user as User | undefined;
82
+ if (!user?.id) {
83
+ throw new APIError({status: 401, title: "Unauthorized"});
84
+ }
85
+ return user;
86
+ };
87
+
88
+ const emitOrgAudit = async (args: {
89
+ event: OrgAuditEvent;
90
+ onOrgAudit?: OrgsAppOptions["onOrgAudit"];
91
+ req: express.Request;
92
+ }): Promise<void> => {
93
+ if (!args.onOrgAudit) {
94
+ return;
95
+ }
96
+ try {
97
+ await args.onOrgAudit(args.event, args.req);
98
+ } catch (error) {
99
+ const detail = error instanceof Error ? error.message : String(error);
100
+ logger.error(`onOrgAudit failed after ${args.event.verb}: ${detail}`);
101
+ }
102
+ };
103
+
104
+ const loadOrganization = async (id: string): Promise<OrganizationDocument> => {
105
+ const organization = await Organization.findOneOrNone({_id: id});
106
+ if (!organization) {
107
+ throw new NotFoundError("Organization not found");
108
+ }
109
+ return organization;
110
+ };
111
+
112
+ const loadActiveMembership = async (
113
+ user: User,
114
+ organizationId: OrganizationDocument["_id"]
115
+ ): Promise<MembershipDocument | undefined> => {
116
+ const membership = await Membership.findOneOrNone({
117
+ organizationId,
118
+ status: "active",
119
+ userId: userIdOf(user),
120
+ });
121
+ return membership ?? undefined;
122
+ };
123
+
124
+ const countActiveOrgAdmins = async (
125
+ organizationId: OrganizationDocument["_id"]
126
+ ): Promise<number> => {
127
+ return Membership.countDocuments({
128
+ organizationId,
129
+ roleName: "org-admin",
130
+ status: "active",
131
+ });
132
+ };
133
+
134
+ const assertNotLastOrgAdmin = async (
135
+ membership: MembershipDocument,
136
+ nextRoleName?: string,
137
+ nextStatus?: string
138
+ ): Promise<void> => {
139
+ const remainsOrgAdmin =
140
+ (nextRoleName ?? membership.roleName) === "org-admin" &&
141
+ (nextStatus ?? membership.status) === "active";
142
+ if (remainsOrgAdmin) {
143
+ return;
144
+ }
145
+ if (membership.roleName !== "org-admin" || membership.status !== "active") {
146
+ return;
147
+ }
148
+ const activeAdmins = await countActiveOrgAdmins(membership.organizationId);
149
+ if (activeAdmins <= 1) {
150
+ throw new APIError({status: 400, title: "Cannot remove the last org-admin"});
151
+ }
152
+ };
153
+
154
+ const assertCan = async (args: {
155
+ access: AnyTerrenoAccess;
156
+ organization?: OrganizationDocument;
157
+ permissions: {organization: string[]};
158
+ user: User;
159
+ }): Promise<void> => {
160
+ const result = await args.access.can({
161
+ doc: args.organization,
162
+ permissions: args.permissions,
163
+ user: args.user,
164
+ });
165
+ if (result.allowed) {
166
+ return;
167
+ }
168
+ throw new ForbiddenError(result.reason ?? "Access denied");
169
+ };
170
+
171
+ export class OrgsApp implements TerrenoPlugin {
172
+ private readonly access: AnyTerrenoAccess;
173
+ private readonly basePath: string;
174
+ private readonly onOrgAudit?: OrgsAppOptions["onOrgAudit"];
175
+ private readonly userModel: UserModel;
176
+
177
+ constructor(options: OrgsAppOptions) {
178
+ this.access = options.access;
179
+ this.basePath = options.basePath ?? "/orgs";
180
+ this.onOrgAudit = options.onOrgAudit;
181
+ this.userModel = options.userModel;
182
+ if (options.settingsSchema) {
183
+ registerOrganizationSettings(options.settingsSchema);
184
+ }
185
+ }
186
+
187
+ register(app: Application, openApi?: unknown): void {
188
+ const router = Router();
189
+ const openApiMiddleware = openApi as OpenApiMiddleware | undefined;
190
+ const docs = (
191
+ summary: string,
192
+ requestBody?: Record<string, OpenApiSchemaProperty>
193
+ ): ReturnType<ReturnType<typeof createOpenApiBuilder>["build"]> => {
194
+ const builder = createOpenApiBuilder({openApi: openApiMiddleware})
195
+ .withTags(["organizations"])
196
+ .withSummary(summary);
197
+ if (requestBody) {
198
+ builder.withRequestBody(requestBody);
199
+ }
200
+ return builder.build();
201
+ };
202
+
203
+ router.post(
204
+ "/",
205
+ authenticateMiddleware(),
206
+ this.access.middleware({organization: ["create"]}),
207
+ docs("Create an organization", {
208
+ name: {description: "Organization name", required: true, type: "string"},
209
+ settings: {description: "App-defined organization settings", type: "object"},
210
+ }),
211
+ asyncHandler(async (req, res) => {
212
+ const user = requireUser(req);
213
+ const name = typeof req.body?.name === "string" ? req.body.name.trim() : "";
214
+ if (!name) {
215
+ throw new APIError({status: 400, title: "name is required"});
216
+ }
217
+ await assertOrganizationSlugAvailable(organizationSlugFromName(name));
218
+ const organization = await Organization.create({
219
+ name,
220
+ ownerId: userIdOf(user),
221
+ settings: req.body?.settings,
222
+ });
223
+ await emitOrgAudit({
224
+ event: {
225
+ actorId: user.id,
226
+ organizationId: String(organization._id),
227
+ organizationLabel: organization.name,
228
+ verb: "created",
229
+ },
230
+ onOrgAudit: this.onOrgAudit,
231
+ req,
232
+ });
233
+ return res.status(201).json({data: organization});
234
+ })
235
+ );
236
+
237
+ router.get(
238
+ "/",
239
+ authenticateMiddleware(),
240
+ this.access.middleware({organization: ["list"]}),
241
+ docs("List all organizations"),
242
+ asyncHandler(async (_req, res) => {
243
+ const organizations = await Organization.find({}).sort({name: 1});
244
+ return res.json({data: organizations});
245
+ })
246
+ );
247
+
248
+ router.get(
249
+ "/mine",
250
+ authenticateMiddleware(),
251
+ docs("List organizations the caller may switch into"),
252
+ asyncHandler(async (req, res) => {
253
+ const user = requireUser(req);
254
+ if (isPlatformOrgActor(user)) {
255
+ const organizations = await Organization.find({disabled: {$ne: true}}).sort({name: 1});
256
+ return res.json({data: organizations});
257
+ }
258
+ const memberships = await Membership.find({
259
+ roleName: "org-admin",
260
+ status: "active",
261
+ userId: userIdOf(user),
262
+ });
263
+ if (memberships.length === 0) {
264
+ throw new ForbiddenError("Access denied");
265
+ }
266
+ const organizations = await Organization.find({
267
+ _id: {$in: memberships.map((membership) => membership.organizationId)},
268
+ disabled: {$ne: true},
269
+ }).sort({name: 1});
270
+ return res.json({data: organizations});
271
+ })
272
+ );
273
+
274
+ router.get(
275
+ "/:id",
276
+ authenticateMiddleware(),
277
+ docs("Read an organization"),
278
+ asyncHandler(async (req, res) => {
279
+ const user = requireUser(req);
280
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
281
+ const membership = await loadActiveMembership(user, organization._id);
282
+ await runWithOrgContext({membership, organization}, () =>
283
+ assertCan({
284
+ access: this.access,
285
+ organization,
286
+ permissions: {organization: ["read"]},
287
+ user,
288
+ })
289
+ );
290
+ return res.json({data: organization});
291
+ })
292
+ );
293
+
294
+ router.patch(
295
+ "/:id",
296
+ authenticateMiddleware(),
297
+ docs("Update an organization", {
298
+ disabled: {description: "Disable the organization", type: "boolean"},
299
+ name: {description: "Organization name", type: "string"},
300
+ settings: {description: "App-defined organization settings", type: "object"},
301
+ }),
302
+ asyncHandler(async (req, res) => {
303
+ const user = requireUser(req);
304
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
305
+ const membership = await loadActiveMembership(user, organization._id);
306
+ const body = req.body ?? {};
307
+ const wantsDisable = "disabled" in body && Boolean(body.disabled) && !organization.disabled;
308
+
309
+ await runWithOrgContext({membership, organization}, async () => {
310
+ await assertCan({
311
+ access: this.access,
312
+ organization,
313
+ permissions: {organization: ["update"]},
314
+ user,
315
+ });
316
+ if (wantsDisable) {
317
+ await assertCan({
318
+ access: this.access,
319
+ organization,
320
+ permissions: {organization: ["disable"]},
321
+ user,
322
+ });
323
+ }
324
+ });
325
+
326
+ if (typeof body.name === "string" && body.name.trim()) {
327
+ const trimmedName = body.name.trim();
328
+ const slug = organizationSlugFromName(trimmedName);
329
+ await assertOrganizationSlugAvailable(slug, organization._id);
330
+ organization.name = trimmedName;
331
+ organization.slug = slug;
332
+ }
333
+ if ("settings" in body) {
334
+ organization.settings = body.settings;
335
+ }
336
+ if ("disabled" in body) {
337
+ organization.disabled = Boolean(body.disabled);
338
+ }
339
+ await organization.save();
340
+ if (wantsDisable) {
341
+ await Membership.updateMany({organizationId: organization._id}, {status: "suspended"});
342
+ }
343
+
344
+ await emitOrgAudit({
345
+ event: {
346
+ actorId: user.id,
347
+ organizationId: String(organization._id),
348
+ organizationLabel: organization.name,
349
+ verb: wantsDisable ? "disabled" : "updated",
350
+ },
351
+ onOrgAudit: this.onOrgAudit,
352
+ req,
353
+ });
354
+ return res.json({data: organization});
355
+ })
356
+ );
357
+
358
+ router.delete(
359
+ "/:id",
360
+ authenticateMiddleware(),
361
+ this.access.middleware({organization: ["delete"]}),
362
+ docs("Soft-delete an organization"),
363
+ asyncHandler(async (req, res) => {
364
+ const user = requireUser(req);
365
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
366
+ organization.deleted = true;
367
+ await organization.save();
368
+ await Membership.updateMany({organizationId: organization._id}, {status: "suspended"});
369
+ await emitOrgAudit({
370
+ event: {
371
+ actorId: user.id,
372
+ organizationId: String(organization._id),
373
+ organizationLabel: organization.name,
374
+ verb: "deleted",
375
+ },
376
+ onOrgAudit: this.onOrgAudit,
377
+ req,
378
+ });
379
+ return res.status(204).send();
380
+ })
381
+ );
382
+
383
+ router.get(
384
+ "/:id/members",
385
+ authenticateMiddleware(),
386
+ docs("List organization members"),
387
+ asyncHandler(async (req, res) => {
388
+ const user = requireUser(req);
389
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
390
+ const membership = await loadActiveMembership(user, organization._id);
391
+ await runWithOrgContext({membership, organization}, () =>
392
+ assertCan({
393
+ access: this.access,
394
+ organization,
395
+ permissions: {organization: ["manageMembers"]},
396
+ user,
397
+ })
398
+ );
399
+ const members = await Membership.find({organizationId: organization._id})
400
+ .sort({created: 1})
401
+ .populate({path: "userId", select: "email name"});
402
+ return res.json({data: members});
403
+ })
404
+ );
405
+
406
+ router.post(
407
+ "/:id/members",
408
+ authenticateMiddleware(),
409
+ docs("Attach an existing user as a member", {
410
+ email: {description: "Existing user email", type: "string"},
411
+ roleName: {
412
+ description: "Membership role",
413
+ type: "string",
414
+ },
415
+ userId: {description: "Existing user id", type: "string"},
416
+ }),
417
+ asyncHandler(async (req, res) => {
418
+ const user = requireUser(req);
419
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
420
+ assertOrganizationEnabled(organization);
421
+ const actorMembership = await loadActiveMembership(user, organization._id);
422
+ await runWithOrgContext({membership: actorMembership, organization}, () =>
423
+ assertCan({
424
+ access: this.access,
425
+ organization,
426
+ permissions: {organization: ["manageMembers"]},
427
+ user,
428
+ })
429
+ );
430
+ const email = typeof req.body?.email === "string" ? req.body.email.trim() : "";
431
+ const userId = typeof req.body?.userId === "string" ? req.body.userId.trim() : "";
432
+ const target = await findUserForAttach(this.userModel, {email, userId});
433
+ if (!target) {
434
+ throw new NotFoundError("User not found");
435
+ }
436
+ const existing = await Membership.findOneOrNone({
437
+ organizationId: organization._id,
438
+ userId: userIdOf(target),
439
+ });
440
+ if (existing) {
441
+ throw new ConflictError("User is already a member");
442
+ }
443
+ const roleName = req.body?.roleName === "org-admin" ? "org-admin" : "member";
444
+ const created = await Membership.create({
445
+ organizationId: organization._id,
446
+ roleName,
447
+ userId: userIdOf(target),
448
+ });
449
+ await emitOrgAudit({
450
+ event: {
451
+ actorId: user.id,
452
+ organizationId: String(organization._id),
453
+ organizationLabel: organization.name,
454
+ verb: "memberAttached",
455
+ },
456
+ onOrgAudit: this.onOrgAudit,
457
+ req,
458
+ });
459
+ return res.status(201).json({data: created});
460
+ })
461
+ );
462
+
463
+ router.patch(
464
+ "/:id/members/:memberId",
465
+ authenticateMiddleware(),
466
+ docs("Update a membership", {
467
+ roleName: {
468
+ description: "Membership role",
469
+ type: "string",
470
+ },
471
+ status: {
472
+ description: "Membership status",
473
+ type: "string",
474
+ },
475
+ }),
476
+ asyncHandler(async (req, res) => {
477
+ const user = requireUser(req);
478
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
479
+ assertOrganizationEnabled(organization);
480
+ const actorMembership = await loadActiveMembership(user, organization._id);
481
+ await runWithOrgContext({membership: actorMembership, organization}, () =>
482
+ assertCan({
483
+ access: this.access,
484
+ organization,
485
+ permissions: {organization: ["manageMembers"]},
486
+ user,
487
+ })
488
+ );
489
+ const member = await Membership.findOneOrNone({
490
+ _id: pathParam(req.params.memberId, "memberId is required"),
491
+ organizationId: organization._id,
492
+ });
493
+ if (!member) {
494
+ throw new NotFoundError("Membership not found");
495
+ }
496
+ const nextRoleName =
497
+ typeof req.body?.roleName === "string" ? req.body.roleName : member.roleName;
498
+ const nextStatus = typeof req.body?.status === "string" ? req.body.status : member.status;
499
+ await assertNotLastOrgAdmin(member, nextRoleName, nextStatus);
500
+ if (typeof req.body?.roleName === "string") {
501
+ member.roleName = req.body.roleName === "org-admin" ? "org-admin" : "member";
502
+ }
503
+ if (typeof req.body?.status === "string") {
504
+ member.status = req.body.status === "suspended" ? "suspended" : "active";
505
+ }
506
+ await member.save();
507
+ await emitOrgAudit({
508
+ event: {
509
+ actorId: user.id,
510
+ organizationId: String(organization._id),
511
+ organizationLabel: organization.name,
512
+ verb: "memberUpdated",
513
+ },
514
+ onOrgAudit: this.onOrgAudit,
515
+ req,
516
+ });
517
+ return res.json({data: member});
518
+ })
519
+ );
520
+
521
+ router.delete(
522
+ "/:id/members/:memberId",
523
+ authenticateMiddleware(),
524
+ docs("Remove a membership"),
525
+ asyncHandler(async (req, res) => {
526
+ const user = requireUser(req);
527
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
528
+ assertOrganizationEnabled(organization);
529
+ const actorMembership = await loadActiveMembership(user, organization._id);
530
+ await runWithOrgContext({membership: actorMembership, organization}, () =>
531
+ assertCan({
532
+ access: this.access,
533
+ organization,
534
+ permissions: {organization: ["manageMembers"]},
535
+ user,
536
+ })
537
+ );
538
+ const member = await Membership.findOneOrNone({
539
+ _id: pathParam(req.params.memberId, "memberId is required"),
540
+ organizationId: organization._id,
541
+ });
542
+ if (!member) {
543
+ throw new NotFoundError("Membership not found");
544
+ }
545
+ await assertNotLastOrgAdmin(member, "member", "suspended");
546
+ await member.deleteOne();
547
+ await emitOrgAudit({
548
+ event: {
549
+ actorId: user.id,
550
+ organizationId: String(organization._id),
551
+ organizationLabel: organization.name,
552
+ verb: "memberRemoved",
553
+ },
554
+ onOrgAudit: this.onOrgAudit,
555
+ req,
556
+ });
557
+ return res.status(204).send();
558
+ })
559
+ );
560
+
561
+ app.use(this.basePath, router);
562
+ }
563
+ }
@@ -1,5 +1,6 @@
1
1
  import {beforeEach, describe, expect, it} from "bun:test";
2
2
  import type express from "express";
3
+ import mongoose from "mongoose";
3
4
  import supertest from "supertest";
4
5
  import type TestAgent from "supertest/lib/agent";
5
6
 
@@ -10,6 +11,8 @@ import {
10
11
  addAuthRoutes,
11
12
  setupAuth,
12
13
  } from "./auth";
14
+ import {Membership, Organization} from "./orgs/organizationModel";
15
+ import {runWithOrgContext} from "./orgs/orgContext";
13
16
  import {
14
17
  getUserOrganizationIds,
15
18
  OrganizationQueryFilter,
@@ -249,59 +252,82 @@ describe("permissions module", () => {
249
252
  });
250
253
 
251
254
  describe("OrganizationQueryFilter", () => {
252
- it("returns an $in filter over the user's organizationIds", () => {
253
- const user = testUser({id: "u1", organizationIds: ["org-1", "org-2"]});
254
- expect(OrganizationQueryFilter(user)).toEqual({
255
- organizationId: {$in: ["org-1", "org-2"]},
256
- });
257
- });
258
-
259
- it("returns an empty $in filter when the user has no organizations", () => {
260
- const user = testUser({id: "u1"});
261
- expect(OrganizationQueryFilter(user)).toEqual({organizationId: {$in: []}});
255
+ it("scopes to the request organization context", () => {
256
+ const orgId = new mongoose.Types.ObjectId();
257
+ const filter = runWithOrgContext({organization: {_id: orgId} as never}, () =>
258
+ OrganizationQueryFilter(testUser({id: "u1"}))
259
+ );
260
+ expect(filter).toEqual({organizationId: orgId});
262
261
  });
263
262
 
264
- it("returns null when user is undefined", () => {
265
- expect(OrganizationQueryFilter(undefined)).toBeNull();
263
+ it("throws when organization context is missing", () => {
264
+ expect(() => OrganizationQueryFilter(testUser({id: "u1"}))).toThrow(
265
+ "Organization context required"
266
+ );
267
+ expect(() => OrganizationQueryFilter(undefined)).toThrow("Organization context required");
266
268
  });
267
269
  });
268
270
 
269
271
  describe("Permissions.IsOrganizationMember", () => {
270
- it("returns true when no object is provided", () => {
271
- const user = testUser({id: "u1", organizationIds: ["org-1"]});
272
- expect(Permissions.IsOrganizationMember("list", user, undefined)).toBe(true);
272
+ beforeEach(async () => {
273
+ await Membership.deleteMany({});
274
+ await Organization.deleteMany({});
273
275
  });
274
-
275
- it("returns false when there is no user", () => {
276
- expect(Permissions.IsOrganizationMember("read", undefined, {organizationId: "org-1"})).toBe(
277
- false
276
+ it("returns true when no object is provided", async () => {
277
+ expect(await Permissions.IsOrganizationMember("list", testUser({id: "u1"}), undefined)).toBe(
278
+ true
278
279
  );
279
280
  });
280
281
 
281
- it("returns true for admins regardless of membership", () => {
282
- const user = testUser({admin: true, id: "admin-1", organizationIds: []});
283
- expect(Permissions.IsOrganizationMember("update", user, {organizationId: "org-9"})).toBe(
284
- true
285
- );
282
+ it("returns false when there is no user", async () => {
283
+ expect(
284
+ await Permissions.IsOrganizationMember("read", undefined, {organizationId: "org-1"})
285
+ ).toBe(false);
286
286
  });
287
287
 
288
- it("returns true when the user belongs to the document's organization", () => {
289
- const user = testUser({id: "u1", organizationIds: ["org-1", "org-2"]});
290
- expect(Permissions.IsOrganizationMember("update", user, {organizationId: "org-2"})).toBe(
291
- true
292
- );
288
+ it("returns false for user.admin without platform org roles", async () => {
289
+ const user = testUser({
290
+ _id: new mongoose.Types.ObjectId(),
291
+ admin: true,
292
+ id: new mongoose.Types.ObjectId().toString(),
293
+ });
294
+ expect(
295
+ await Permissions.IsOrganizationMember("update", user, {
296
+ organizationId: new mongoose.Types.ObjectId(),
297
+ })
298
+ ).toBe(false);
293
299
  });
294
300
 
295
- it("returns false when the user does not belong to the document's organization", () => {
296
- const user = testUser({id: "u1", organizationIds: ["org-1"]});
297
- expect(Permissions.IsOrganizationMember("update", user, {organizationId: "org-9"})).toBe(
298
- false
301
+ it("returns true when the caller has an active membership in the active org context", async () => {
302
+ const org = await Organization.create({
303
+ name: "Perm Org",
304
+ ownerId: new mongoose.Types.ObjectId(),
305
+ });
306
+ const userId = new mongoose.Types.ObjectId();
307
+ await Membership.create({
308
+ organizationId: org._id,
309
+ roleName: "member",
310
+ userId,
311
+ });
312
+ const user = testUser({_id: userId, id: userId.toString()});
313
+ const allowed = await runWithOrgContext({organization: org}, () =>
314
+ Permissions.IsOrganizationMember("update", user, {organizationId: org._id})
299
315
  );
316
+ expect(await allowed).toBe(true);
317
+ });
318
+
319
+ it("returns false when the user does not belong to the document's organization", async () => {
320
+ const user = testUser({id: new mongoose.Types.ObjectId().toString()});
321
+ expect(
322
+ await Permissions.IsOrganizationMember("update", user, {
323
+ organizationId: new mongoose.Types.ObjectId(),
324
+ })
325
+ ).toBe(false);
300
326
  });
301
327
 
302
- it("returns false when the document has no organizationId", () => {
303
- const user = testUser({id: "u1", organizationIds: ["org-1"]});
304
- expect(Permissions.IsOrganizationMember("read", user, {})).toBe(false);
328
+ it("returns false when the document has no organizationId", async () => {
329
+ const user = testUser({id: "u1"});
330
+ expect(await Permissions.IsOrganizationMember("read", user, {})).toBe(false);
305
331
  });
306
332
  });
307
333