@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,382 @@
1
+ import {afterEach, beforeEach, describe, it} from "bun:test";
2
+ import {authAsUser as loginWithPassword} from "@terreno/test";
3
+ import {assert} from "chai";
4
+ import type {Application} from "express";
5
+ import mongoose from "mongoose";
6
+ import type {PassportLocalMongooseDocument} from "passport-local-mongoose";
7
+
8
+ import {type UserModel as AuthUserModel, addAuthRoutes, setupAuth} from "../auth";
9
+ import {apiErrorMiddleware, apiUnauthorizedMiddleware} from "../errors";
10
+ import {createAccess} from "../rbac/access";
11
+ import {terrenoStatements} from "../rbac/statements";
12
+ import {getBaseServer} from "../tests";
13
+ import {type User, UserModel} from "../tests/models";
14
+ import {Membership, Organization} from "./organizationModel";
15
+ import {
16
+ createOrganizationSettingsSchema,
17
+ registerOrganizationSettings,
18
+ } from "./organizationSettings";
19
+ import {type OrgAuditEvent, OrgsApp} from "./orgsApp";
20
+
21
+ const PASSWORD = "testpassword123";
22
+
23
+ const setPassword = async (user: User, password: string): Promise<void> => {
24
+ await (user as unknown as PassportLocalMongooseDocument).setPassword(password);
25
+ await (user as unknown as {save: () => Promise<void>}).save();
26
+ };
27
+
28
+ const createUser = async (args: {email: string; roles?: string[]}): Promise<User> => {
29
+ const user = await UserModel.create({
30
+ email: args.email,
31
+ name: args.email,
32
+ roles: args.roles ?? [],
33
+ });
34
+ await setPassword(user, PASSWORD);
35
+ return user;
36
+ };
37
+
38
+ describe("OrgsApp", () => {
39
+ let app: Application;
40
+ let auditEvents: OrgAuditEvent[];
41
+
42
+ beforeEach(async () => {
43
+ await Promise.all([
44
+ Membership.deleteMany({}),
45
+ Organization.deleteMany({}),
46
+ UserModel.deleteMany({}),
47
+ ]);
48
+ auditEvents = [];
49
+ const access = createAccess({
50
+ connection: mongoose.connection,
51
+ organizations: true,
52
+ statements: terrenoStatements,
53
+ userModel: UserModel as unknown as AuthUserModel,
54
+ });
55
+ await access.roles.seedDefaults();
56
+
57
+ app = getBaseServer();
58
+ setupAuth(app, UserModel as unknown as AuthUserModel);
59
+ addAuthRoutes(app, UserModel as unknown as AuthUserModel);
60
+ app.use(apiUnauthorizedMiddleware);
61
+ new OrgsApp({
62
+ access,
63
+ onOrgAudit: (event): void => {
64
+ auditEvents.push(event);
65
+ },
66
+ userModel: UserModel as unknown as AuthUserModel,
67
+ }).register(app);
68
+ app.use(apiErrorMiddleware);
69
+ });
70
+
71
+ afterEach(() => {
72
+ registerOrganizationSettings();
73
+ });
74
+
75
+ it("returns 403 on GET /orgs for org-admin and 200 for operator", async () => {
76
+ const operator = await createUser({email: "operator@example.com", roles: ["operator"]});
77
+ const orgAdmin = await createUser({email: "orgadmin@example.com"});
78
+ const org = await Organization.create({name: "Acme", ownerId: operator._id});
79
+ await Membership.create({
80
+ organizationId: org._id,
81
+ roleName: "org-admin",
82
+ userId: orgAdmin._id,
83
+ });
84
+
85
+ const orgAdminAgent = await loginWithPassword(app, {
86
+ email: "orgadmin@example.com",
87
+ password: PASSWORD,
88
+ });
89
+ const denied = await orgAdminAgent.get("/orgs");
90
+ assert.equal(denied.status, 403);
91
+
92
+ const operatorAgent = await loginWithPassword(app, {
93
+ email: "operator@example.com",
94
+ password: PASSWORD,
95
+ });
96
+ const listed = await operatorAgent.get("/orgs");
97
+ assert.equal(listed.status, 200);
98
+ assert.equal(listed.body.data.length, 1);
99
+ assert.equal(listed.body.data[0].name, "Acme");
100
+ });
101
+
102
+ it("creates an organization without requiring membership", async () => {
103
+ await createUser({email: "operator@example.com", roles: ["operator"]});
104
+ const operatorAgent = await loginWithPassword(app, {
105
+ email: "operator@example.com",
106
+ password: PASSWORD,
107
+ });
108
+ const created = await operatorAgent.post("/orgs").send({name: "New Co"});
109
+ assert.equal(created.status, 201);
110
+ assert.equal(created.body.data.name, "New Co");
111
+ const memberships = await Membership.find({organizationId: created.body.data._id});
112
+ assert.equal(memberships.length, 0);
113
+ assert.equal(auditEvents[0]?.verb, "created");
114
+ });
115
+
116
+ it("lists /orgs/mine as orgs the caller admins", async () => {
117
+ const operator = await createUser({email: "operator@example.com", roles: ["operator"]});
118
+ const orgAdmin = await createUser({email: "orgadmin@example.com"});
119
+ const acme = await Organization.create({name: "Acme", ownerId: operator._id});
120
+ await Organization.create({name: "Other", ownerId: operator._id});
121
+ await Membership.create({
122
+ organizationId: acme._id,
123
+ roleName: "org-admin",
124
+ userId: orgAdmin._id,
125
+ });
126
+
127
+ const orgAdminAgent = await loginWithPassword(app, {
128
+ email: "orgadmin@example.com",
129
+ password: PASSWORD,
130
+ });
131
+ const mine = await orgAdminAgent.get("/orgs/mine");
132
+ assert.equal(mine.status, 200);
133
+ assert.equal(mine.body.data.length, 1);
134
+ assert.equal(mine.body.data[0].name, "Acme");
135
+ });
136
+
137
+ it("lets org-admin read and patch name but not disable", async () => {
138
+ const owner = await createUser({email: "owner@example.com", roles: ["operator"]});
139
+ const orgAdmin = await createUser({email: "orgadmin@example.com"});
140
+ const org = await Organization.create({name: "Acme", ownerId: owner._id});
141
+ await Membership.create({
142
+ organizationId: org._id,
143
+ roleName: "org-admin",
144
+ userId: orgAdmin._id,
145
+ });
146
+ const orgAdminAgent = await loginWithPassword(app, {
147
+ email: "orgadmin@example.com",
148
+ password: PASSWORD,
149
+ });
150
+
151
+ const read = await orgAdminAgent.get(`/orgs/${org._id}`);
152
+ assert.equal(read.status, 200);
153
+
154
+ const patched = await orgAdminAgent.patch(`/orgs/${org._id}`).send({name: "Acme Renamed"});
155
+ assert.equal(patched.status, 200);
156
+ assert.equal(patched.body.data.name, "Acme Renamed");
157
+
158
+ const disable = await orgAdminAgent.patch(`/orgs/${org._id}`).send({disabled: true});
159
+ assert.equal(disable.status, 403);
160
+ });
161
+
162
+ it("disables an organization and suspends memberships", async () => {
163
+ const operator = await createUser({email: "operator@example.com", roles: ["operator"]});
164
+ const orgAdmin = await createUser({email: "orgadmin@example.com"});
165
+ const org = await Organization.create({name: "Acme", ownerId: operator._id});
166
+ await Membership.create({
167
+ organizationId: org._id,
168
+ roleName: "org-admin",
169
+ userId: orgAdmin._id,
170
+ });
171
+ const operatorAgent = await loginWithPassword(app, {
172
+ email: "operator@example.com",
173
+ password: PASSWORD,
174
+ });
175
+ const disabled = await operatorAgent.patch(`/orgs/${org._id}`).send({disabled: true});
176
+ assert.equal(disabled.status, 200);
177
+ assert.isTrue(disabled.body.data.disabled);
178
+ const membership = await Membership.findOne({organizationId: org._id});
179
+ assert.equal(membership?.status, "suspended");
180
+ assert.isTrue(auditEvents.some((event) => event.verb === "disabled"));
181
+ });
182
+
183
+ it("soft-deletes an organization and suspends memberships", async () => {
184
+ const operator = await createUser({email: "operator@example.com", roles: ["operator"]});
185
+ const orgAdmin = await createUser({email: "orgadmin@example.com"});
186
+ const org = await Organization.create({name: "Acme", ownerId: operator._id});
187
+ await Membership.create({
188
+ organizationId: org._id,
189
+ roleName: "org-admin",
190
+ userId: orgAdmin._id,
191
+ });
192
+
193
+ const orgAdminAgent = await loginWithPassword(app, {
194
+ email: "orgadmin@example.com",
195
+ password: PASSWORD,
196
+ });
197
+ const deniedDelete = await orgAdminAgent.delete(`/orgs/${org._id}`);
198
+ assert.equal(deniedDelete.status, 403);
199
+
200
+ const operatorAgent = await loginWithPassword(app, {
201
+ email: "operator@example.com",
202
+ password: PASSWORD,
203
+ });
204
+ const deleted = await operatorAgent.delete(`/orgs/${org._id}`);
205
+ assert.equal(deleted.status, 204);
206
+
207
+ const gone = await Organization.findOne({_id: org._id});
208
+ assert.isNull(gone);
209
+ const withDeleted = await Organization.findOne({_id: org._id, deleted: true});
210
+ assert.isOk(withDeleted);
211
+ const membership = await Membership.findOne({organizationId: org._id});
212
+ assert.equal(membership?.status, "suspended");
213
+ assert.isTrue(auditEvents.some((event) => event.verb === "deleted"));
214
+ });
215
+
216
+ it("attaches an existing user by email and 404s unknown emails", async () => {
217
+ const operator = await createUser({email: "operator@example.com", roles: ["operator"]});
218
+ await createUser({email: "member@example.com"});
219
+ const org = await Organization.create({name: "Acme", ownerId: operator._id});
220
+ const operatorAgent = await loginWithPassword(app, {
221
+ email: "operator@example.com",
222
+ password: PASSWORD,
223
+ });
224
+
225
+ const missing = await operatorAgent
226
+ .post(`/orgs/${org._id}/members`)
227
+ .send({email: "ghost@example.com", roleName: "member"});
228
+ assert.equal(missing.status, 404);
229
+ assert.equal(missing.body.title, "User not found");
230
+
231
+ const attached = await operatorAgent
232
+ .post(`/orgs/${org._id}/members`)
233
+ .send({email: "member@example.com", roleName: "member"});
234
+ assert.equal(attached.status, 201);
235
+ assert.equal(attached.body.data.roleName, "member");
236
+ assert.isTrue(auditEvents.some((event) => event.verb === "memberAttached"));
237
+
238
+ const listed = await operatorAgent.get(`/orgs/${org._id}/members`);
239
+ assert.equal(listed.status, 200);
240
+ assert.equal(listed.body.data.length, 1);
241
+ assert.equal(listed.body.data[0].userId.email, "member@example.com");
242
+
243
+ const mixedCase = await operatorAgent
244
+ .post(`/orgs/${org._id}/members`)
245
+ .send({email: "Member@Example.com", roleName: "member"});
246
+ assert.equal(mixedCase.status, 409);
247
+ });
248
+
249
+ it("attaches an existing user by userId", async () => {
250
+ const operator = await createUser({email: "operator@example.com", roles: ["operator"]});
251
+ const member = await createUser({email: "member-id@example.com"});
252
+ const org = await Organization.create({name: "Acme", ownerId: operator._id});
253
+ const operatorAgent = await loginWithPassword(app, {
254
+ email: "operator@example.com",
255
+ password: PASSWORD,
256
+ });
257
+
258
+ const attached = await operatorAgent
259
+ .post(`/orgs/${org._id}/members`)
260
+ .send({roleName: "member", userId: String(member._id)});
261
+ assert.equal(attached.status, 201);
262
+ assert.equal(attached.body.data.roleName, "member");
263
+ });
264
+
265
+ it("rejects demoting or removing the last org-admin", async () => {
266
+ const operator = await createUser({email: "operator@example.com", roles: ["operator"]});
267
+ const orgAdmin = await createUser({email: "orgadmin@example.com"});
268
+ const org = await Organization.create({name: "Acme", ownerId: operator._id});
269
+ const membership = await Membership.create({
270
+ organizationId: org._id,
271
+ roleName: "org-admin",
272
+ userId: orgAdmin._id,
273
+ });
274
+ const operatorAgent = await loginWithPassword(app, {
275
+ email: "operator@example.com",
276
+ password: PASSWORD,
277
+ });
278
+
279
+ const demote = await operatorAgent
280
+ .patch(`/orgs/${org._id}/members/${membership._id}`)
281
+ .send({roleName: "member"});
282
+ assert.equal(demote.status, 400);
283
+ assert.equal(demote.body.title, "Cannot remove the last org-admin");
284
+
285
+ const removed = await operatorAgent.delete(`/orgs/${org._id}/members/${membership._id}`);
286
+ assert.equal(removed.status, 400);
287
+ assert.equal(removed.body.title, "Cannot remove the last org-admin");
288
+ const stillAdmin = await Membership.findById(membership._id);
289
+ assert.equal(stillAdmin?.roleName, "org-admin");
290
+ });
291
+
292
+ it("returns 409 when POST /orgs collides with a soft-deleted slug", async () => {
293
+ const operator = await createUser({email: "op-deleted@example.com", roles: ["operator"]});
294
+ const org = await Organization.create({name: "Acme Corp", ownerId: operator._id});
295
+ const operatorAgent = await loginWithPassword(app, {
296
+ email: "op-deleted@example.com",
297
+ password: PASSWORD,
298
+ });
299
+ const deleted = await operatorAgent.delete(`/orgs/${org._id}`);
300
+ assert.equal(deleted.status, 204);
301
+
302
+ const created = await operatorAgent.post("/orgs").send({name: "Acme Corp"});
303
+ assert.equal(created.status, 409);
304
+ assert.equal(created.body.title, "Organization name already in use");
305
+ });
306
+
307
+ it("returns 409 when POST /orgs collides on slug", async () => {
308
+ const operator = await createUser({email: "op@example.com", roles: ["operator"]});
309
+ await Organization.create({name: "Acme Corp", ownerId: operator._id});
310
+
311
+ const operatorAgent = await loginWithPassword(app, {
312
+ email: "op@example.com",
313
+ password: PASSWORD,
314
+ });
315
+ const created = await operatorAgent.post("/orgs").send({name: "Acme Corp"});
316
+ assert.equal(created.status, 409);
317
+ assert.equal(created.body.title, "Organization name already in use");
318
+ });
319
+
320
+ it("returns 409 when PATCH /orgs/:id rename collides on slug", async () => {
321
+ const operator = await createUser({email: "op2@example.com", roles: ["operator"]});
322
+ await Organization.create({name: "Acme Corp", ownerId: operator._id});
323
+ const other = await Organization.create({name: "Other Co", ownerId: operator._id});
324
+
325
+ const operatorAgent = await loginWithPassword(app, {
326
+ email: "op2@example.com",
327
+ password: PASSWORD,
328
+ });
329
+ const patched = await operatorAgent.patch(`/orgs/${other._id}`).send({name: "Acme Corp"});
330
+ assert.equal(patched.status, 409);
331
+ assert.equal(patched.body.title, "Organization name already in use");
332
+ });
333
+
334
+ it("lets an org-admin attach another existing user", async () => {
335
+ const owner = await createUser({email: "owner@example.com", roles: ["operator"]});
336
+ const orgAdmin = await createUser({email: "orgadmin@example.com"});
337
+ await createUser({email: "teammate@example.com"});
338
+ const org = await Organization.create({name: "Acme", ownerId: owner._id});
339
+ await Membership.create({
340
+ organizationId: org._id,
341
+ roleName: "org-admin",
342
+ userId: orgAdmin._id,
343
+ });
344
+ const orgAdminAgent = await loginWithPassword(app, {
345
+ email: "orgadmin@example.com",
346
+ password: PASSWORD,
347
+ });
348
+ const attached = await orgAdminAgent
349
+ .post(`/orgs/${org._id}/members`)
350
+ .send({email: "teammate@example.com", roleName: "member"});
351
+ assert.equal(attached.status, 201);
352
+ });
353
+
354
+ it("validates PATCH settings against a registered settings schema", async () => {
355
+ registerOrganizationSettings(
356
+ createOrganizationSettingsSchema({
357
+ timezone: {
358
+ description: "IANA timezone for the organization",
359
+ type: String,
360
+ },
361
+ })
362
+ );
363
+ const operator = await createUser({email: "settings-op@example.com", roles: ["operator"]});
364
+ const org = await Organization.create({name: "Settings Co", ownerId: operator._id});
365
+ const operatorAgent = await loginWithPassword(app, {
366
+ email: "settings-op@example.com",
367
+ password: PASSWORD,
368
+ });
369
+
370
+ const rejected = await operatorAgent
371
+ .patch(`/orgs/${org._id}`)
372
+ .send({settings: {plan: "enterprise"}});
373
+ assert.equal(rejected.status, 400);
374
+ assert.equal(rejected.body.title, "Organization settings are invalid");
375
+
376
+ const patched = await operatorAgent
377
+ .patch(`/orgs/${org._id}`)
378
+ .send({settings: {timezone: "America/Chicago"}});
379
+ assert.equal(patched.status, 200);
380
+ assert.equal(patched.body.data.settings.timezone, "America/Chicago");
381
+ });
382
+ });