@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,416 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.OrgsApp = void 0;
4
+ const express_1 = require("express");
5
+ const api_1 = require("../api");
6
+ const auth_1 = require("../auth");
7
+ const errors_1 = require("../errors");
8
+ const logger_1 = require("../logger");
9
+ const openApiBuilder_1 = require("../openApiBuilder");
10
+ const plugins_1 = require("../plugins");
11
+ const organizationModel_1 = require("./organizationModel");
12
+ const organizationSettings_1 = require("./organizationSettings");
13
+ const orgContext_1 = require("./orgContext");
14
+ const escapeRegularExpression = (value) => {
15
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
16
+ };
17
+ const findUserForAttach = async (userModel, args) => {
18
+ if (args.email) {
19
+ return (0, plugins_1.findOneOrNoneFor)(userModel, {
20
+ email: { $options: "i", $regex: `^${escapeRegularExpression(args.email)}$` },
21
+ });
22
+ }
23
+ if (args.userId) {
24
+ return (0, plugins_1.findOneOrNoneFor)(userModel, { _id: args.userId });
25
+ }
26
+ throw new errors_1.APIError({ status: 400, title: "email or userId is required" });
27
+ };
28
+ const pathParam = (value, title) => {
29
+ if (typeof value !== "string" || value.length === 0) {
30
+ throw new errors_1.APIError({ status: 400, title });
31
+ }
32
+ return value;
33
+ };
34
+ const userIdOf = (user) => {
35
+ if (user._id) {
36
+ return String(user._id);
37
+ }
38
+ return user.id;
39
+ };
40
+ const requireUser = (req) => {
41
+ const user = req.user;
42
+ if (!user?.id) {
43
+ throw new errors_1.APIError({ status: 401, title: "Unauthorized" });
44
+ }
45
+ return user;
46
+ };
47
+ const emitOrgAudit = async (args) => {
48
+ if (!args.onOrgAudit) {
49
+ return;
50
+ }
51
+ try {
52
+ await args.onOrgAudit(args.event, args.req);
53
+ }
54
+ catch (error) {
55
+ const detail = error instanceof Error ? error.message : String(error);
56
+ logger_1.logger.error(`onOrgAudit failed after ${args.event.verb}: ${detail}`);
57
+ }
58
+ };
59
+ const loadOrganization = async (id) => {
60
+ const organization = await organizationModel_1.Organization.findOneOrNone({ _id: id });
61
+ if (!organization) {
62
+ throw new errors_1.NotFoundError("Organization not found");
63
+ }
64
+ return organization;
65
+ };
66
+ const loadActiveMembership = async (user, organizationId) => {
67
+ const membership = await organizationModel_1.Membership.findOneOrNone({
68
+ organizationId,
69
+ status: "active",
70
+ userId: userIdOf(user),
71
+ });
72
+ return membership ?? undefined;
73
+ };
74
+ const countActiveOrgAdmins = async (organizationId) => {
75
+ return organizationModel_1.Membership.countDocuments({
76
+ organizationId,
77
+ roleName: "org-admin",
78
+ status: "active",
79
+ });
80
+ };
81
+ const assertNotLastOrgAdmin = async (membership, nextRoleName, nextStatus) => {
82
+ const remainsOrgAdmin = (nextRoleName ?? membership.roleName) === "org-admin" &&
83
+ (nextStatus ?? membership.status) === "active";
84
+ if (remainsOrgAdmin) {
85
+ return;
86
+ }
87
+ if (membership.roleName !== "org-admin" || membership.status !== "active") {
88
+ return;
89
+ }
90
+ const activeAdmins = await countActiveOrgAdmins(membership.organizationId);
91
+ if (activeAdmins <= 1) {
92
+ throw new errors_1.APIError({ status: 400, title: "Cannot remove the last org-admin" });
93
+ }
94
+ };
95
+ const assertCan = async (args) => {
96
+ const result = await args.access.can({
97
+ doc: args.organization,
98
+ permissions: args.permissions,
99
+ user: args.user,
100
+ });
101
+ if (result.allowed) {
102
+ return;
103
+ }
104
+ throw new errors_1.ForbiddenError(result.reason ?? "Access denied");
105
+ };
106
+ class OrgsApp {
107
+ access;
108
+ basePath;
109
+ onOrgAudit;
110
+ userModel;
111
+ constructor(options) {
112
+ this.access = options.access;
113
+ this.basePath = options.basePath ?? "/orgs";
114
+ this.onOrgAudit = options.onOrgAudit;
115
+ this.userModel = options.userModel;
116
+ if (options.settingsSchema) {
117
+ (0, organizationSettings_1.registerOrganizationSettings)(options.settingsSchema);
118
+ }
119
+ }
120
+ register(app, openApi) {
121
+ const router = (0, express_1.Router)();
122
+ const openApiMiddleware = openApi;
123
+ const docs = (summary, requestBody) => {
124
+ const builder = (0, openApiBuilder_1.createOpenApiBuilder)({ openApi: openApiMiddleware })
125
+ .withTags(["organizations"])
126
+ .withSummary(summary);
127
+ if (requestBody) {
128
+ builder.withRequestBody(requestBody);
129
+ }
130
+ return builder.build();
131
+ };
132
+ router.post("/", (0, auth_1.authenticateMiddleware)(), this.access.middleware({ organization: ["create"] }), docs("Create an organization", {
133
+ name: { description: "Organization name", required: true, type: "string" },
134
+ settings: { description: "App-defined organization settings", type: "object" },
135
+ }), (0, api_1.asyncHandler)(async (req, res) => {
136
+ const user = requireUser(req);
137
+ const name = typeof req.body?.name === "string" ? req.body.name.trim() : "";
138
+ if (!name) {
139
+ throw new errors_1.APIError({ status: 400, title: "name is required" });
140
+ }
141
+ await (0, organizationModel_1.assertOrganizationSlugAvailable)((0, organizationModel_1.organizationSlugFromName)(name));
142
+ const organization = await organizationModel_1.Organization.create({
143
+ name,
144
+ ownerId: userIdOf(user),
145
+ settings: req.body?.settings,
146
+ });
147
+ await emitOrgAudit({
148
+ event: {
149
+ actorId: user.id,
150
+ organizationId: String(organization._id),
151
+ organizationLabel: organization.name,
152
+ verb: "created",
153
+ },
154
+ onOrgAudit: this.onOrgAudit,
155
+ req,
156
+ });
157
+ return res.status(201).json({ data: organization });
158
+ }));
159
+ router.get("/", (0, auth_1.authenticateMiddleware)(), this.access.middleware({ organization: ["list"] }), docs("List all organizations"), (0, api_1.asyncHandler)(async (_req, res) => {
160
+ const organizations = await organizationModel_1.Organization.find({}).sort({ name: 1 });
161
+ return res.json({ data: organizations });
162
+ }));
163
+ router.get("/mine", (0, auth_1.authenticateMiddleware)(), docs("List organizations the caller may switch into"), (0, api_1.asyncHandler)(async (req, res) => {
164
+ const user = requireUser(req);
165
+ if ((0, orgContext_1.isPlatformOrgActor)(user)) {
166
+ const organizations = await organizationModel_1.Organization.find({ disabled: { $ne: true } }).sort({ name: 1 });
167
+ return res.json({ data: organizations });
168
+ }
169
+ const memberships = await organizationModel_1.Membership.find({
170
+ roleName: "org-admin",
171
+ status: "active",
172
+ userId: userIdOf(user),
173
+ });
174
+ if (memberships.length === 0) {
175
+ throw new errors_1.ForbiddenError("Access denied");
176
+ }
177
+ const organizations = await organizationModel_1.Organization.find({
178
+ _id: { $in: memberships.map((membership) => membership.organizationId) },
179
+ disabled: { $ne: true },
180
+ }).sort({ name: 1 });
181
+ return res.json({ data: organizations });
182
+ }));
183
+ router.get("/:id", (0, auth_1.authenticateMiddleware)(), docs("Read an organization"), (0, api_1.asyncHandler)(async (req, res) => {
184
+ const user = requireUser(req);
185
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
186
+ const membership = await loadActiveMembership(user, organization._id);
187
+ await (0, orgContext_1.runWithOrgContext)({ membership, organization }, () => assertCan({
188
+ access: this.access,
189
+ organization,
190
+ permissions: { organization: ["read"] },
191
+ user,
192
+ }));
193
+ return res.json({ data: organization });
194
+ }));
195
+ router.patch("/:id", (0, auth_1.authenticateMiddleware)(), docs("Update an organization", {
196
+ disabled: { description: "Disable the organization", type: "boolean" },
197
+ name: { description: "Organization name", type: "string" },
198
+ settings: { description: "App-defined organization settings", type: "object" },
199
+ }), (0, api_1.asyncHandler)(async (req, res) => {
200
+ const user = requireUser(req);
201
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
202
+ const membership = await loadActiveMembership(user, organization._id);
203
+ const body = req.body ?? {};
204
+ const wantsDisable = "disabled" in body && Boolean(body.disabled) && !organization.disabled;
205
+ await (0, orgContext_1.runWithOrgContext)({ membership, organization }, async () => {
206
+ await assertCan({
207
+ access: this.access,
208
+ organization,
209
+ permissions: { organization: ["update"] },
210
+ user,
211
+ });
212
+ if (wantsDisable) {
213
+ await assertCan({
214
+ access: this.access,
215
+ organization,
216
+ permissions: { organization: ["disable"] },
217
+ user,
218
+ });
219
+ }
220
+ });
221
+ if (typeof body.name === "string" && body.name.trim()) {
222
+ const trimmedName = body.name.trim();
223
+ const slug = (0, organizationModel_1.organizationSlugFromName)(trimmedName);
224
+ await (0, organizationModel_1.assertOrganizationSlugAvailable)(slug, organization._id);
225
+ organization.name = trimmedName;
226
+ organization.slug = slug;
227
+ }
228
+ if ("settings" in body) {
229
+ organization.settings = body.settings;
230
+ }
231
+ if ("disabled" in body) {
232
+ organization.disabled = Boolean(body.disabled);
233
+ }
234
+ await organization.save();
235
+ if (wantsDisable) {
236
+ await organizationModel_1.Membership.updateMany({ organizationId: organization._id }, { status: "suspended" });
237
+ }
238
+ await emitOrgAudit({
239
+ event: {
240
+ actorId: user.id,
241
+ organizationId: String(organization._id),
242
+ organizationLabel: organization.name,
243
+ verb: wantsDisable ? "disabled" : "updated",
244
+ },
245
+ onOrgAudit: this.onOrgAudit,
246
+ req,
247
+ });
248
+ return res.json({ data: organization });
249
+ }));
250
+ router.delete("/:id", (0, auth_1.authenticateMiddleware)(), this.access.middleware({ organization: ["delete"] }), docs("Soft-delete an organization"), (0, api_1.asyncHandler)(async (req, res) => {
251
+ const user = requireUser(req);
252
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
253
+ organization.deleted = true;
254
+ await organization.save();
255
+ await organizationModel_1.Membership.updateMany({ organizationId: organization._id }, { status: "suspended" });
256
+ await emitOrgAudit({
257
+ event: {
258
+ actorId: user.id,
259
+ organizationId: String(organization._id),
260
+ organizationLabel: organization.name,
261
+ verb: "deleted",
262
+ },
263
+ onOrgAudit: this.onOrgAudit,
264
+ req,
265
+ });
266
+ return res.status(204).send();
267
+ }));
268
+ router.get("/:id/members", (0, auth_1.authenticateMiddleware)(), docs("List organization members"), (0, api_1.asyncHandler)(async (req, res) => {
269
+ const user = requireUser(req);
270
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
271
+ const membership = await loadActiveMembership(user, organization._id);
272
+ await (0, orgContext_1.runWithOrgContext)({ membership, organization }, () => assertCan({
273
+ access: this.access,
274
+ organization,
275
+ permissions: { organization: ["manageMembers"] },
276
+ user,
277
+ }));
278
+ const members = await organizationModel_1.Membership.find({ organizationId: organization._id })
279
+ .sort({ created: 1 })
280
+ .populate({ path: "userId", select: "email name" });
281
+ return res.json({ data: members });
282
+ }));
283
+ router.post("/:id/members", (0, auth_1.authenticateMiddleware)(), docs("Attach an existing user as a member", {
284
+ email: { description: "Existing user email", type: "string" },
285
+ roleName: {
286
+ description: "Membership role",
287
+ type: "string",
288
+ },
289
+ userId: { description: "Existing user id", type: "string" },
290
+ }), (0, api_1.asyncHandler)(async (req, res) => {
291
+ const user = requireUser(req);
292
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
293
+ (0, orgContext_1.assertOrganizationEnabled)(organization);
294
+ const actorMembership = await loadActiveMembership(user, organization._id);
295
+ await (0, orgContext_1.runWithOrgContext)({ membership: actorMembership, organization }, () => assertCan({
296
+ access: this.access,
297
+ organization,
298
+ permissions: { organization: ["manageMembers"] },
299
+ user,
300
+ }));
301
+ const email = typeof req.body?.email === "string" ? req.body.email.trim() : "";
302
+ const userId = typeof req.body?.userId === "string" ? req.body.userId.trim() : "";
303
+ const target = await findUserForAttach(this.userModel, { email, userId });
304
+ if (!target) {
305
+ throw new errors_1.NotFoundError("User not found");
306
+ }
307
+ const existing = await organizationModel_1.Membership.findOneOrNone({
308
+ organizationId: organization._id,
309
+ userId: userIdOf(target),
310
+ });
311
+ if (existing) {
312
+ throw new errors_1.ConflictError("User is already a member");
313
+ }
314
+ const roleName = req.body?.roleName === "org-admin" ? "org-admin" : "member";
315
+ const created = await organizationModel_1.Membership.create({
316
+ organizationId: organization._id,
317
+ roleName,
318
+ userId: userIdOf(target),
319
+ });
320
+ await emitOrgAudit({
321
+ event: {
322
+ actorId: user.id,
323
+ organizationId: String(organization._id),
324
+ organizationLabel: organization.name,
325
+ verb: "memberAttached",
326
+ },
327
+ onOrgAudit: this.onOrgAudit,
328
+ req,
329
+ });
330
+ return res.status(201).json({ data: created });
331
+ }));
332
+ router.patch("/:id/members/:memberId", (0, auth_1.authenticateMiddleware)(), docs("Update a membership", {
333
+ roleName: {
334
+ description: "Membership role",
335
+ type: "string",
336
+ },
337
+ status: {
338
+ description: "Membership status",
339
+ type: "string",
340
+ },
341
+ }), (0, api_1.asyncHandler)(async (req, res) => {
342
+ const user = requireUser(req);
343
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
344
+ (0, orgContext_1.assertOrganizationEnabled)(organization);
345
+ const actorMembership = await loadActiveMembership(user, organization._id);
346
+ await (0, orgContext_1.runWithOrgContext)({ membership: actorMembership, organization }, () => assertCan({
347
+ access: this.access,
348
+ organization,
349
+ permissions: { organization: ["manageMembers"] },
350
+ user,
351
+ }));
352
+ const member = await organizationModel_1.Membership.findOneOrNone({
353
+ _id: pathParam(req.params.memberId, "memberId is required"),
354
+ organizationId: organization._id,
355
+ });
356
+ if (!member) {
357
+ throw new errors_1.NotFoundError("Membership not found");
358
+ }
359
+ const nextRoleName = typeof req.body?.roleName === "string" ? req.body.roleName : member.roleName;
360
+ const nextStatus = typeof req.body?.status === "string" ? req.body.status : member.status;
361
+ await assertNotLastOrgAdmin(member, nextRoleName, nextStatus);
362
+ if (typeof req.body?.roleName === "string") {
363
+ member.roleName = req.body.roleName === "org-admin" ? "org-admin" : "member";
364
+ }
365
+ if (typeof req.body?.status === "string") {
366
+ member.status = req.body.status === "suspended" ? "suspended" : "active";
367
+ }
368
+ await member.save();
369
+ await emitOrgAudit({
370
+ event: {
371
+ actorId: user.id,
372
+ organizationId: String(organization._id),
373
+ organizationLabel: organization.name,
374
+ verb: "memberUpdated",
375
+ },
376
+ onOrgAudit: this.onOrgAudit,
377
+ req,
378
+ });
379
+ return res.json({ data: member });
380
+ }));
381
+ router.delete("/:id/members/:memberId", (0, auth_1.authenticateMiddleware)(), docs("Remove a membership"), (0, api_1.asyncHandler)(async (req, res) => {
382
+ const user = requireUser(req);
383
+ const organization = await loadOrganization(pathParam(req.params.id, "id is required"));
384
+ (0, orgContext_1.assertOrganizationEnabled)(organization);
385
+ const actorMembership = await loadActiveMembership(user, organization._id);
386
+ await (0, orgContext_1.runWithOrgContext)({ membership: actorMembership, organization }, () => assertCan({
387
+ access: this.access,
388
+ organization,
389
+ permissions: { organization: ["manageMembers"] },
390
+ user,
391
+ }));
392
+ const member = await organizationModel_1.Membership.findOneOrNone({
393
+ _id: pathParam(req.params.memberId, "memberId is required"),
394
+ organizationId: organization._id,
395
+ });
396
+ if (!member) {
397
+ throw new errors_1.NotFoundError("Membership not found");
398
+ }
399
+ await assertNotLastOrgAdmin(member, "member", "suspended");
400
+ await member.deleteOne();
401
+ await emitOrgAudit({
402
+ event: {
403
+ actorId: user.id,
404
+ organizationId: String(organization._id),
405
+ organizationLabel: organization.name,
406
+ verb: "memberRemoved",
407
+ },
408
+ onOrgAudit: this.onOrgAudit,
409
+ req,
410
+ });
411
+ return res.status(204).send();
412
+ }));
413
+ app.use(this.basePath, router);
414
+ }
415
+ }
416
+ exports.OrgsApp = OrgsApp;
@@ -25,27 +25,21 @@ export interface OrganizationScopedUser extends User {
25
25
  /** Reads the caller's organization ids, tolerating users without the `organizationIds` field. */
26
26
  export declare const getUserOrganizationIds: (user?: User) => string[];
27
27
  /**
28
- * Restricts list queries to documents belonging to one of the caller's organizations. This is the
29
- * tenant-scoped analog of {@link OwnerQueryFilter}: it filters on the document's `organizationId`
30
- * field using the user's `organizationIds`. Returns `null` for anonymous callers (no user).
28
+ * Restricts list queries to the current request organization (`X-Organization-Id` or inferred
29
+ * single org-admin membership). Does not read `User.organizationIds`.
31
30
  */
32
- export declare const OrganizationQueryFilter: (user?: User) => {
33
- organizationId: {
34
- $in: string[];
35
- };
36
- } | null;
31
+ export declare const OrganizationQueryFilter: (_user?: User, _query?: Record<string, unknown>) => Record<string, unknown>;
37
32
  export declare const Permissions: {
38
33
  IsAdmin: (_method: RESTMethod, user?: User) => boolean;
39
34
  IsAny: () => boolean;
40
35
  IsAuthenticated: (_method: RESTMethod, user?: User) => boolean;
41
36
  IsAuthenticatedOrReadOnly: (method: RESTMethod, user?: User) => boolean;
42
37
  /**
43
- * Object-level permission for tenant-scoped documents: the caller must belong to the document's
44
- * organization (admins always pass). With no object (list/create checks) it returns true and
45
- * defers to the {@link OrganizationQueryFilter} / a `preCreate` hook to scope access. Expects the
46
- * document to expose an `organizationId` and the user an `organizationIds` array.
38
+ * Object-level permission for tenant-scoped documents: platform org actors must match the
39
+ * current org context; everyone else needs an active Membership. With no object (list/create)
40
+ * it returns true and defers to {@link OrganizationQueryFilter}.
47
41
  */
48
- IsOrganizationMember: (_method: RESTMethod, user?: User, obj?: unknown) => boolean;
42
+ IsOrganizationMember: PermissionMethod<unknown>;
49
43
  IsOwner: (_method: RESTMethod, user?: User, obj?: unknown) => boolean;
50
44
  IsOwnerOrReadOnly: (method: RESTMethod, user?: User, obj?: unknown) => boolean;
51
45
  };