@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,262 @@
1
+ import mongoose from "mongoose";
2
+
3
+ import {APIError, ConflictError} from "../errors";
4
+ import {createdUpdatedPlugin, findExactlyOne, findOneOrNone, isDeletedPlugin} from "../plugins";
5
+ import type {MembershipDocument, MembershipModel} from "../types/membership";
6
+ import type {OrganizationDocument, OrganizationModel} from "../types/organization";
7
+ import {applyOrganizationSettings} from "./organizationSettings";
8
+
9
+ export type {
10
+ MembershipDocument,
11
+ MembershipMethods,
12
+ MembershipModel,
13
+ MembershipRoleName,
14
+ MembershipSchema,
15
+ MembershipStatics,
16
+ MembershipStatus,
17
+ } from "../types/membership";
18
+ export type {
19
+ OrganizationDocument,
20
+ OrganizationMethods,
21
+ OrganizationModel,
22
+ OrganizationSchema,
23
+ OrganizationSettings,
24
+ OrganizationStatics,
25
+ } from "../types/organization";
26
+
27
+ const MEMBERSHIP_ROLE_NAMES = ["org-admin", "member"] as const;
28
+ const MEMBERSHIP_STATUSES = ["active", "suspended"] as const;
29
+
30
+ const toObjectId = (value: mongoose.Types.ObjectId | string): mongoose.Types.ObjectId => {
31
+ if (value instanceof mongoose.Types.ObjectId) {
32
+ return value;
33
+ }
34
+ return new mongoose.Types.ObjectId(value);
35
+ };
36
+
37
+ export const assertOrganizationSlugAvailable = async (
38
+ slug: string,
39
+ excludeOrganizationId?: mongoose.Types.ObjectId
40
+ ): Promise<void> => {
41
+ const query: {
42
+ _id?: {$ne: mongoose.Types.ObjectId};
43
+ deleted: {$in: boolean[]};
44
+ slug: string;
45
+ } = {deleted: {$in: [true, false]}, slug};
46
+ if (excludeOrganizationId) {
47
+ query._id = {$ne: excludeOrganizationId};
48
+ }
49
+ const existing = await Organization.findOneOrNone(query);
50
+ if (existing) {
51
+ throw new ConflictError("Organization name already in use");
52
+ }
53
+ };
54
+
55
+ export const organizationSlugFromName = (name: string): string => {
56
+ const slug = name
57
+ .trim()
58
+ .toLowerCase()
59
+ .replace(/[^a-z0-9]+/g, "-")
60
+ .replace(/^-+|-+$/g, "");
61
+ if (!slug) {
62
+ throw new APIError({
63
+ status: 400,
64
+ title: "Organization name must produce a slug",
65
+ });
66
+ }
67
+ return slug;
68
+ };
69
+
70
+ const organizationSchema = new mongoose.Schema<OrganizationDocument, OrganizationModel>(
71
+ {
72
+ disabled: {
73
+ default: false,
74
+ description: "Whether operators have disabled this organization",
75
+ type: Boolean,
76
+ },
77
+ name: {
78
+ description: "Human-readable organization name",
79
+ required: true,
80
+ trim: true,
81
+ type: String,
82
+ },
83
+ ownerId: {
84
+ description: "User who created the organization; transferable",
85
+ ref: "User",
86
+ required: true,
87
+ type: mongoose.Schema.Types.ObjectId,
88
+ },
89
+ settings: {
90
+ description: "App-defined organization settings object",
91
+ type: mongoose.Schema.Types.Mixed,
92
+ },
93
+ slug: {
94
+ description: "URL-safe unique identifier generated from the organization name",
95
+ required: true,
96
+ trim: true,
97
+ type: String,
98
+ unique: true,
99
+ },
100
+ },
101
+ {strict: "throw", toJSON: {virtuals: true}, toObject: {virtuals: true}}
102
+ );
103
+
104
+ organizationSchema.plugin(createdUpdatedPlugin);
105
+ organizationSchema.plugin(isDeletedPlugin);
106
+ organizationSchema.plugin(findOneOrNone);
107
+ organizationSchema.plugin(findExactlyOne);
108
+
109
+ organizationSchema.pre("validate", function (this: OrganizationDocument): void {
110
+ if (!this.slug) {
111
+ this.slug = organizationSlugFromName(this.name);
112
+ }
113
+ if (!this.isModified("settings")) {
114
+ return;
115
+ }
116
+ this.settings = applyOrganizationSettings(this.settings);
117
+ });
118
+
119
+ const membershipSchema = new mongoose.Schema<MembershipDocument, MembershipModel>(
120
+ {
121
+ organizationId: {
122
+ description: "Organization this membership belongs to",
123
+ index: true,
124
+ ref: "TerrenoOrganization",
125
+ required: true,
126
+ type: mongoose.Schema.Types.ObjectId,
127
+ },
128
+ roleName: {
129
+ default: "member",
130
+ description: "Per-organization role: org-admin or member",
131
+ enum: MEMBERSHIP_ROLE_NAMES,
132
+ required: true,
133
+ type: String,
134
+ },
135
+ status: {
136
+ default: "active",
137
+ description: "Whether this membership is active or suspended",
138
+ enum: MEMBERSHIP_STATUSES,
139
+ required: true,
140
+ type: String,
141
+ },
142
+ userId: {
143
+ description: "User who holds this membership",
144
+ index: true,
145
+ ref: "User",
146
+ required: true,
147
+ type: mongoose.Schema.Types.ObjectId,
148
+ },
149
+ },
150
+ {strict: "throw", toJSON: {virtuals: true}, toObject: {virtuals: true}}
151
+ );
152
+
153
+ membershipSchema.index({organizationId: 1, userId: 1}, {unique: true});
154
+
155
+ membershipSchema.plugin(createdUpdatedPlugin);
156
+ membershipSchema.plugin(isDeletedPlugin);
157
+ membershipSchema.plugin(findOneOrNone);
158
+ membershipSchema.plugin(findExactlyOne);
159
+
160
+ membershipSchema.statics = {
161
+ ...membershipSchema.statics,
162
+ async findActiveForUser(
163
+ this: MembershipModel,
164
+ userId: mongoose.Types.ObjectId | string
165
+ ): Promise<MembershipDocument[]> {
166
+ return this.find({
167
+ status: "active",
168
+ userId: toObjectId(userId),
169
+ });
170
+ },
171
+ async isMember(
172
+ this: MembershipModel,
173
+ userId: mongoose.Types.ObjectId | string,
174
+ organizationId: mongoose.Types.ObjectId | string
175
+ ): Promise<boolean> {
176
+ const membership = await this.findOneOrNone({
177
+ organizationId: toObjectId(organizationId),
178
+ status: "active",
179
+ userId: toObjectId(userId),
180
+ });
181
+ return Boolean(membership);
182
+ },
183
+ async isOrgAdmin(
184
+ this: MembershipModel,
185
+ userId: mongoose.Types.ObjectId | string,
186
+ organizationId: mongoose.Types.ObjectId | string
187
+ ): Promise<boolean> {
188
+ const membership = await this.findOneOrNone({
189
+ organizationId: toObjectId(organizationId),
190
+ roleName: "org-admin",
191
+ status: "active",
192
+ userId: toObjectId(userId),
193
+ });
194
+ return Boolean(membership);
195
+ },
196
+ };
197
+
198
+ export const getOrganizationModel = (): OrganizationModel => {
199
+ const existing = mongoose.models.TerrenoOrganization as OrganizationModel | undefined;
200
+ if (existing) {
201
+ return existing;
202
+ }
203
+ return mongoose.model<OrganizationDocument, OrganizationModel>(
204
+ "TerrenoOrganization",
205
+ organizationSchema,
206
+ "organizations"
207
+ );
208
+ };
209
+
210
+ export const getMembershipModel = (): MembershipModel => {
211
+ const existing = mongoose.models.TerrenoMembership as MembershipModel | undefined;
212
+ if (existing) {
213
+ return existing;
214
+ }
215
+ return mongoose.model<MembershipDocument, MembershipModel>(
216
+ "TerrenoMembership",
217
+ membershipSchema,
218
+ "memberships"
219
+ );
220
+ };
221
+
222
+ const createLazyModel = <T extends mongoose.Model<unknown>>(getModel: () => T): T => {
223
+ const handler: ProxyHandler<object> = {
224
+ apply(_target, thisArg, argArray) {
225
+ return Reflect.apply(
226
+ getModel() as unknown as (...args: unknown[]) => unknown,
227
+ thisArg,
228
+ argArray
229
+ );
230
+ },
231
+ construct(_target, argArray) {
232
+ const Model = getModel() as unknown as new (...args: unknown[]) => object;
233
+ return new Model(...argArray);
234
+ },
235
+ get(_target, prop) {
236
+ const model = getModel();
237
+ const value = Reflect.get(model, prop, model);
238
+ if (typeof value === "function") {
239
+ return value.bind(model);
240
+ }
241
+ return value;
242
+ },
243
+ getPrototypeOf() {
244
+ return Object.getPrototypeOf(getModel());
245
+ },
246
+ has(_target, prop) {
247
+ return prop in getModel();
248
+ },
249
+ set(_target, prop, value) {
250
+ Reflect.set(getModel(), prop, value);
251
+ return true;
252
+ },
253
+ };
254
+ class LazyMongooseModel {}
255
+ return new Proxy(LazyMongooseModel, handler) as unknown as T;
256
+ };
257
+
258
+ /** Lazy so importing `@terreno/api` does not register Organization until first use. */
259
+ export const Organization = createLazyModel(getOrganizationModel);
260
+
261
+ /** Lazy so importing `@terreno/api` does not register Membership until first use. */
262
+ export const Membership = createLazyModel(getMembershipModel);
@@ -0,0 +1,113 @@
1
+ import {afterEach, describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+ import mongoose from "mongoose";
4
+
5
+ import {ValidationError} from "../errors";
6
+ import {Organization} from "./organizationModel";
7
+ import {
8
+ applyOrganizationSettings,
9
+ createOrganizationSettingsSchema,
10
+ getOrganizationSettingsSchema,
11
+ organizationSettingsOf,
12
+ registerOrganizationSettings,
13
+ } from "./organizationSettings";
14
+
15
+ const userId = (): mongoose.Types.ObjectId => new mongoose.Types.ObjectId();
16
+
17
+ interface ExampleSettings {
18
+ timezone?: string;
19
+ }
20
+
21
+ describe("organization settings schema", () => {
22
+ afterEach(() => {
23
+ registerOrganizationSettings();
24
+ });
25
+
26
+ it("passes Mixed settings through when no schema is registered", () => {
27
+ const settings = applyOrganizationSettings({nested: {ok: true}, plan: "pro"});
28
+ assert.deepEqual(settings, {nested: {ok: true}, plan: "pro"});
29
+ });
30
+
31
+ it("returns an empty object from organizationSettingsOf when settings are missing", () => {
32
+ assert.deepEqual(organizationSettingsOf({}), {});
33
+ assert.deepEqual(organizationSettingsOf({settings: {timezone: "UTC"}}), {timezone: "UTC"});
34
+ });
35
+
36
+ it("rejects unknown keys and wrong types when a schema is registered", () => {
37
+ registerOrganizationSettings(
38
+ createOrganizationSettingsSchema({
39
+ timezone: {
40
+ description: "IANA timezone for the organization",
41
+ type: String,
42
+ },
43
+ })
44
+ );
45
+ assert.isDefined(getOrganizationSettingsSchema());
46
+
47
+ const valid = applyOrganizationSettings({timezone: "America/New_York"});
48
+ assert.equal((valid as ExampleSettings).timezone, "America/New_York");
49
+
50
+ let extraKeyError: unknown;
51
+ try {
52
+ applyOrganizationSettings({plan: "pro"});
53
+ } catch (caughtError) {
54
+ extraKeyError = caughtError;
55
+ }
56
+ assert.instanceOf(extraKeyError, ValidationError);
57
+ assert.equal((extraKeyError as ValidationError).title, "Organization settings are invalid");
58
+ assert.match(
59
+ String((extraKeyError as ValidationError).meta?.fields?.settings),
60
+ /Unknown settings field: plan/
61
+ );
62
+
63
+ let typeError: unknown;
64
+ try {
65
+ applyOrganizationSettings({timezone: {notAString: true}});
66
+ } catch (caughtError) {
67
+ typeError = caughtError;
68
+ }
69
+ assert.instanceOf(typeError, ValidationError);
70
+
71
+ let notObjectError: unknown;
72
+ try {
73
+ applyOrganizationSettings(["timezone"]);
74
+ } catch (caughtError) {
75
+ notObjectError = caughtError;
76
+ }
77
+ assert.instanceOf(notObjectError, ValidationError);
78
+ assert.equal(
79
+ (notObjectError as ValidationError).title,
80
+ "Organization settings must be an object"
81
+ );
82
+ });
83
+
84
+ it("validates settings on Organization.create", async () => {
85
+ registerOrganizationSettings(
86
+ createOrganizationSettingsSchema({
87
+ timezone: {
88
+ description: "IANA timezone for the organization",
89
+ type: String,
90
+ },
91
+ })
92
+ );
93
+
94
+ const org = await Organization.create({
95
+ name: "Settings Org",
96
+ ownerId: userId(),
97
+ settings: {timezone: "UTC"},
98
+ });
99
+ assert.equal(organizationSettingsOf<ExampleSettings>(org).timezone, "UTC");
100
+
101
+ let error: unknown;
102
+ try {
103
+ await Organization.create({
104
+ name: "Bad Settings Org",
105
+ ownerId: userId(),
106
+ settings: {unknown: true},
107
+ });
108
+ } catch (caughtError) {
109
+ error = caughtError;
110
+ }
111
+ assert.instanceOf(error, ValidationError);
112
+ });
113
+ });
@@ -0,0 +1,126 @@
1
+ import mongoose from "mongoose";
2
+
3
+ import {ValidationError} from "../errors";
4
+ import type {OrganizationSettings} from "../types/organization";
5
+
6
+ const SETTINGS_VALIDATOR_MODEL = "__TerrenoOrganizationSettings";
7
+
8
+ let registeredOrganizationSettingsSchema: mongoose.Schema | undefined;
9
+
10
+ const dropSettingsValidatorModel = (): void => {
11
+ const existing = mongoose.models[SETTINGS_VALIDATOR_MODEL];
12
+ if (existing) {
13
+ mongoose.deleteModel(SETTINGS_VALIDATOR_MODEL);
14
+ }
15
+ };
16
+
17
+ /**
18
+ * Build a nested Mongoose schema for `Organization.settings`.
19
+ * Fields should be optional or have defaults so existing organizations still validate.
20
+ */
21
+ export const createOrganizationSettingsSchema = (
22
+ definition: mongoose.SchemaDefinition,
23
+ options?: mongoose.SchemaOptions
24
+ ): mongoose.Schema => {
25
+ return new mongoose.Schema(definition, {
26
+ _id: false,
27
+ id: false,
28
+ strict: "throw",
29
+ ...options,
30
+ });
31
+ };
32
+
33
+ /** Register the app settings schema. Call before creating or patching organizations. */
34
+ export const registerOrganizationSettings = (schema?: mongoose.Schema): void => {
35
+ dropSettingsValidatorModel();
36
+ registeredOrganizationSettingsSchema = schema;
37
+ };
38
+
39
+ export const getOrganizationSettingsSchema = (): mongoose.Schema | undefined => {
40
+ return registeredOrganizationSettingsSchema;
41
+ };
42
+
43
+ const settingsValidationMessage = (error: unknown): string => {
44
+ if (error instanceof mongoose.Error.ValidationError) {
45
+ return Object.values(error.errors)
46
+ .map((fieldError) => fieldError.message)
47
+ .join("; ");
48
+ }
49
+ if (error instanceof Error) {
50
+ return error.message;
51
+ }
52
+ return "Organization settings are invalid";
53
+ };
54
+
55
+ const getSettingsValidatorModel = (schema: mongoose.Schema): mongoose.Model<mongoose.Document> => {
56
+ const existing = mongoose.models[SETTINGS_VALIDATOR_MODEL] as
57
+ | mongoose.Model<mongoose.Document>
58
+ | undefined;
59
+ if (existing) {
60
+ return existing;
61
+ }
62
+ return mongoose.model<mongoose.Document>(SETTINGS_VALIDATOR_MODEL, schema, undefined, {
63
+ overwriteModels: true,
64
+ });
65
+ };
66
+
67
+ /**
68
+ * Validate and cast `Organization.settings` when a schema is registered.
69
+ * With no schema, Mixed values pass through unchanged.
70
+ */
71
+ export const applyOrganizationSettings = <
72
+ TSettings extends OrganizationSettings = OrganizationSettings,
73
+ >(
74
+ settings: unknown
75
+ ): TSettings | undefined => {
76
+ if (settings === undefined || settings === null) {
77
+ return undefined;
78
+ }
79
+ const schema = registeredOrganizationSettingsSchema;
80
+ if (!schema) {
81
+ return settings as TSettings;
82
+ }
83
+ if (typeof settings !== "object" || Array.isArray(settings)) {
84
+ throw new ValidationError({
85
+ fields: {settings: "Organization settings must be an object"},
86
+ title: "Organization settings must be an object",
87
+ });
88
+ }
89
+ try {
90
+ const unknownKeys = Object.keys(settings).filter((key) => {
91
+ return schema.path(key) === undefined;
92
+ });
93
+ if (unknownKeys.length > 0) {
94
+ throw new ValidationError({
95
+ fields: {settings: `Unknown settings field: ${unknownKeys.join(", ")}`},
96
+ title: "Organization settings are invalid",
97
+ });
98
+ }
99
+ const ValidatorModel = getSettingsValidatorModel(schema);
100
+ const document = new ValidatorModel(settings);
101
+ const validationError = document.validateSync();
102
+ if (validationError) {
103
+ throw validationError;
104
+ }
105
+ return document.toObject({versionKey: false}) as unknown as TSettings;
106
+ } catch (error) {
107
+ if (error instanceof ValidationError) {
108
+ throw error;
109
+ }
110
+ throw new ValidationError({
111
+ cause: error instanceof Error ? error : undefined,
112
+ detail: settingsValidationMessage(error),
113
+ fields: {settings: settingsValidationMessage(error)},
114
+ title: "Organization settings are invalid",
115
+ });
116
+ }
117
+ };
118
+
119
+ /** Read typed settings from an organization document or API payload. */
120
+ export const organizationSettingsOf = <
121
+ TSettings extends OrganizationSettings = OrganizationSettings,
122
+ >(organization: {
123
+ settings?: TSettings | null;
124
+ }): TSettings => {
125
+ return (organization.settings ?? {}) as TSettings;
126
+ };