@terreno/api 57.3.0 → 57.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,77 +1,28 @@
1
1
  "use strict";
2
- var __values = (this && this.__values) || function(o) {
3
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
4
- if (m) return m.call(o);
5
- if (o && typeof o.length === "number") return {
6
- next: function () {
7
- if (o && i >= o.length) o = void 0;
8
- return { value: o && o[i++], done: !o };
9
- }
10
- };
11
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
12
- };
13
- var __read = (this && this.__read) || function (o, n) {
14
- var m = typeof Symbol === "function" && o[Symbol.iterator];
15
- if (!m) return o;
16
- var i = m.call(o), r, ar = [], e;
17
- try {
18
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
19
- }
20
- catch (error) { e = { error: error }; }
21
- finally {
22
- try {
23
- if (r && !r.done && (m = i["return"])) m.call(i);
24
- }
25
- finally { if (e) throw e.error; }
26
- }
27
- return ar;
28
- };
29
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
30
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
31
- if (ar || !(i in from)) {
32
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
33
- ar[i] = from[i];
34
- }
35
- }
36
- return to.concat(ar || Array.prototype.slice.call(from));
37
- };
38
2
  var __importDefault = (this && this.__importDefault) || function (mod) {
39
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
40
4
  };
41
5
  Object.defineProperty(exports, "__esModule", { value: true });
42
6
  exports.getDisallowedWriteKeys = exports.applyReadMask = void 0;
43
- var cloneDeep_1 = __importDefault(require("lodash/cloneDeep"));
44
- var isPlainObject = function (value) {
45
- return typeof value === "object" && value !== null && !Array.isArray(value);
46
- };
47
- var getNestedValue = function (doc, path) {
48
- var e_1, _a;
49
- var parts = path.split(".");
50
- var current = doc;
51
- try {
52
- for (var parts_1 = __values(parts), parts_1_1 = parts_1.next(); !parts_1_1.done; parts_1_1 = parts_1.next()) {
53
- var part = parts_1_1.value;
54
- if (!isPlainObject(current)) {
55
- return undefined;
56
- }
57
- current = current[part];
7
+ const cloneDeep_1 = __importDefault(require("lodash/cloneDeep"));
8
+ const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
9
+ const getNestedValue = (doc, path) => {
10
+ const parts = path.split(".");
11
+ let current = doc;
12
+ for (const part of parts) {
13
+ if (!isPlainObject(current)) {
14
+ return undefined;
58
15
  }
59
- }
60
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
61
- finally {
62
- try {
63
- if (parts_1_1 && !parts_1_1.done && (_a = parts_1.return)) _a.call(parts_1);
64
- }
65
- finally { if (e_1) throw e_1.error; }
16
+ current = current[part];
66
17
  }
67
18
  return current;
68
19
  };
69
- var setNestedValue = function (doc, path, value) {
70
- var parts = path.split(".");
71
- var current = doc;
72
- for (var index = 0; index < parts.length - 1; index++) {
73
- var part = parts[index];
74
- var next = current[part];
20
+ const setNestedValue = (doc, path, value) => {
21
+ const parts = path.split(".");
22
+ let current = doc;
23
+ for (let index = 0; index < parts.length - 1; index++) {
24
+ const part = parts[index];
25
+ const next = current[part];
75
26
  if (!isPlainObject(next)) {
76
27
  current[part] = {};
77
28
  }
@@ -79,120 +30,74 @@ var setNestedValue = function (doc, path, value) {
79
30
  }
80
31
  current[parts[parts.length - 1]] = value;
81
32
  };
82
- var pickPaths = function (doc, paths) {
83
- var e_2, _a;
84
- var result = {};
85
- try {
86
- for (var paths_1 = __values(paths), paths_1_1 = paths_1.next(); !paths_1_1.done; paths_1_1 = paths_1.next()) {
87
- var path = paths_1_1.value;
88
- var value = getNestedValue(doc, path);
89
- if (value !== undefined) {
90
- setNestedValue(result, path, (0, cloneDeep_1.default)(value));
91
- }
33
+ const pickPaths = (doc, paths) => {
34
+ const result = {};
35
+ for (const path of paths) {
36
+ const value = getNestedValue(doc, path);
37
+ if (value !== undefined) {
38
+ setNestedValue(result, path, (0, cloneDeep_1.default)(value));
92
39
  }
93
40
  }
94
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
95
- finally {
96
- try {
97
- if (paths_1_1 && !paths_1_1.done && (_a = paths_1.return)) _a.call(paths_1);
98
- }
99
- finally { if (e_2) throw e_2.error; }
100
- }
101
41
  return result;
102
42
  };
103
- var omitPath = function (doc, omitPathName) {
104
- var parts = omitPathName.split(".");
43
+ const omitPath = (doc, omitPathName) => {
44
+ const parts = omitPathName.split(".");
105
45
  if (parts.length === 1) {
106
46
  delete doc[parts[0]];
107
47
  return;
108
48
  }
109
- var parent = getNestedValue(doc, parts.slice(0, -1).join("."));
49
+ const parent = getNestedValue(doc, parts.slice(0, -1).join("."));
110
50
  if (isPlainObject(parent)) {
111
51
  delete parent[parts[parts.length - 1]];
112
52
  }
113
53
  };
114
- var applyReadMask = function (value, mask) {
115
- var e_3, _a;
116
- var _b;
54
+ const applyReadMask = (value, mask) => {
117
55
  if (!isPlainObject(value) && !Array.isArray(value)) {
118
56
  return value;
119
57
  }
120
58
  if (Array.isArray(value)) {
121
- return value.map(function (item) { return (0, exports.applyReadMask)(item, mask); });
59
+ return value.map((item) => (0, exports.applyReadMask)(item, mask));
122
60
  }
123
- var doc = value;
124
- var result;
61
+ const doc = value;
62
+ let result;
125
63
  if (mask.read === "*") {
126
64
  result = (0, cloneDeep_1.default)(doc);
127
65
  }
128
66
  else {
129
67
  result = pickPaths(doc, mask.read);
130
68
  }
131
- try {
132
- for (var _c = __values((_b = mask.omit) !== null && _b !== void 0 ? _b : []), _d = _c.next(); !_d.done; _d = _c.next()) {
133
- var pathToOmit = _d.value;
134
- omitPath(result, pathToOmit);
135
- }
136
- }
137
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
138
- finally {
139
- try {
140
- if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
141
- }
142
- finally { if (e_3) throw e_3.error; }
69
+ for (const pathToOmit of mask.omit ?? []) {
70
+ omitPath(result, pathToOmit);
143
71
  }
144
72
  return result;
145
73
  };
146
74
  exports.applyReadMask = applyReadMask;
147
- var isWritePathAllowed = function (path, write) {
148
- var e_4, _a;
149
- try {
150
- for (var write_1 = __values(write), write_1_1 = write_1.next(); !write_1_1.done; write_1_1 = write_1.next()) {
151
- var allowed = write_1_1.value;
152
- if (path === allowed || path.startsWith("".concat(allowed, "."))) {
153
- return true;
154
- }
75
+ const isWritePathAllowed = (path, write) => {
76
+ for (const allowed of write) {
77
+ if (path === allowed || path.startsWith(`${allowed}.`)) {
78
+ return true;
155
79
  }
156
80
  }
157
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
158
- finally {
159
- try {
160
- if (write_1_1 && !write_1_1.done && (_a = write_1.return)) _a.call(write_1);
161
- }
162
- finally { if (e_4) throw e_4.error; }
163
- }
164
81
  return false;
165
82
  };
166
- var pathHasNestedWriteAllow = function (path, write) {
167
- return write.some(function (allowed) { return allowed.startsWith("".concat(path, ".")); });
83
+ const pathHasNestedWriteAllow = (path, write) => {
84
+ return write.some((allowed) => allowed.startsWith(`${path}.`));
168
85
  };
169
- var collectDisallowedWriteKeys = function (body, write, prefix) {
170
- var e_5, _a;
171
- if (prefix === void 0) { prefix = ""; }
172
- var disallowed = [];
173
- try {
174
- for (var _b = __values(Object.entries(body)), _c = _b.next(); !_c.done; _c = _b.next()) {
175
- var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
176
- var path = prefix ? "".concat(prefix, ".").concat(key) : key;
177
- if (isPlainObject(value) && pathHasNestedWriteAllow(path, write)) {
178
- disallowed.push.apply(disallowed, __spreadArray([], __read(collectDisallowedWriteKeys(value, write, path)), false));
179
- continue;
180
- }
181
- if (!isWritePathAllowed(path, write)) {
182
- disallowed.push(path);
183
- }
86
+ const collectDisallowedWriteKeys = (body, write, prefix = "") => {
87
+ const disallowed = [];
88
+ for (const [key, value] of Object.entries(body)) {
89
+ const path = prefix ? `${prefix}.${key}` : key;
90
+ if (isPlainObject(value) && pathHasNestedWriteAllow(path, write)) {
91
+ disallowed.push(...collectDisallowedWriteKeys(value, write, path));
92
+ continue;
184
93
  }
185
- }
186
- catch (e_5_1) { e_5 = { error: e_5_1 }; }
187
- finally {
188
- try {
189
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
94
+ if (!isWritePathAllowed(path, write)) {
95
+ disallowed.push(path);
190
96
  }
191
- finally { if (e_5) throw e_5.error; }
192
97
  }
193
98
  return disallowed;
194
99
  };
195
- var getDisallowedWriteKeys = function (body, mask) {
100
+ const getDisallowedWriteKeys = (body, mask) => {
196
101
  if (mask.write === "*") {
197
102
  return [];
198
103
  }
@@ -0,0 +1,6 @@
1
+ import type { PermissionSet } from "./statements";
2
+ import type { PermissionSource } from "./types";
3
+ export declare const MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = "membership-org-admin";
4
+ /** Grants applied when `Membership.roleName` is `org-admin` in the current org context. */
5
+ export declare const ORG_ADMIN_PERMISSION_BUNDLE: PermissionSet;
6
+ export declare const membershipOrgAdminPermissionSource: () => PermissionSource;
@@ -0,0 +1,51 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.membershipOrgAdminPermissionSource = exports.ORG_ADMIN_PERMISSION_BUNDLE = exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = void 0;
4
+ const organizationModel_1 = require("../orgs/organizationModel");
5
+ const orgContext_1 = require("../orgs/orgContext");
6
+ exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = "membership-org-admin";
7
+ /** Grants applied when `Membership.roleName` is `org-admin` in the current org context. */
8
+ exports.ORG_ADMIN_PERMISSION_BUNDLE = {
9
+ admin: ["access"],
10
+ organization: ["read", "update", "manageMembers"],
11
+ };
12
+ const userIdForMembershipLookup = (user) => {
13
+ if (user._id) {
14
+ return String(user._id);
15
+ }
16
+ return user.id;
17
+ };
18
+ const isActiveOrgAdminMembership = (membership) => {
19
+ return membership?.roleName === "org-admin" && membership.status === "active";
20
+ };
21
+ const fullOrgAdminGrants = () => ({
22
+ permissions: {
23
+ admin: [...exports.ORG_ADMIN_PERMISSION_BUNDLE.admin],
24
+ organization: [...exports.ORG_ADMIN_PERMISSION_BUNDLE.organization],
25
+ },
26
+ });
27
+ const shellOnlyOrgAdminGrants = () => ({
28
+ permissions: {
29
+ admin: [...exports.ORG_ADMIN_PERMISSION_BUNDLE.admin],
30
+ },
31
+ });
32
+ const membershipOrgAdminPermissionSource = () => ({
33
+ getGrants: async ({ user }) => {
34
+ const contextMembership = (0, orgContext_1.getOrgContext)()?.membership;
35
+ if (contextMembership) {
36
+ if (!isActiveOrgAdminMembership(contextMembership)) {
37
+ return null;
38
+ }
39
+ return fullOrgAdminGrants();
40
+ }
41
+ const activeMemberships = await organizationModel_1.Membership.findActiveForUser(userIdForMembershipLookup(user));
42
+ const hasOrgAdminMembership = activeMemberships.some((row) => row.roleName === "org-admin");
43
+ if (!hasOrgAdminMembership) {
44
+ return null;
45
+ }
46
+ return shellOnlyOrgAdminGrants();
47
+ },
48
+ name: exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME,
49
+ ttlMs: 0,
50
+ });
51
+ exports.membershipOrgAdminPermissionSource = membershipOrgAdminPermissionSource;
@@ -1,107 +1,41 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
37
- };
38
2
  Object.defineProperty(exports, "__esModule", { value: true });
39
3
  exports.requireAccess = exports.createRequireAccess = exports.IsPermitted = exports.createIsPermitted = void 0;
40
- var errors_1 = require("../errors");
41
- var createIsPermitted = function (_a) {
42
- var can = _a.can;
43
- return function (permissions) {
44
- return function (_method, user, obj) { return __awaiter(void 0, void 0, void 0, function () {
45
- var result;
46
- return __generator(this, function (_a) {
47
- switch (_a.label) {
48
- case 0: return [4 /*yield*/, can({
49
- doc: obj,
50
- permissions: permissions,
51
- user: user,
52
- })];
53
- case 1:
54
- result = _a.sent();
55
- return [2 /*return*/, result.allowed];
56
- }
57
- });
58
- }); };
4
+ const errors_1 = require("../errors");
5
+ const createIsPermitted = ({ can }) => (permissions) => {
6
+ return async (_method, user, obj) => {
7
+ const result = await can({
8
+ doc: obj,
9
+ permissions,
10
+ user,
11
+ });
12
+ return result.allowed;
59
13
  };
60
14
  };
61
15
  exports.createIsPermitted = createIsPermitted;
62
16
  exports.IsPermitted = exports.createIsPermitted;
63
- var createRequireAccess = function (_a) {
64
- var can = _a.can;
65
- return function (permissions, options) {
66
- return function (req, _res, next) { return __awaiter(void 0, void 0, void 0, function () {
67
- var doc, _a, result, error_1;
68
- return __generator(this, function (_b) {
69
- switch (_b.label) {
70
- case 0:
71
- _b.trys.push([0, 5, , 6]);
72
- if (!(options === null || options === void 0 ? void 0 : options.getDoc)) return [3 /*break*/, 2];
73
- return [4 /*yield*/, options.getDoc(req)];
74
- case 1:
75
- _a = _b.sent();
76
- return [3 /*break*/, 3];
77
- case 2:
78
- _a = undefined;
79
- _b.label = 3;
80
- case 3:
81
- doc = _a;
82
- return [4 /*yield*/, can({
83
- context: { req: req },
84
- doc: doc,
85
- permissions: permissions,
86
- user: req.user,
87
- })];
88
- case 4:
89
- result = _b.sent();
90
- if (!result.allowed) {
91
- throw new errors_1.APIError({
92
- detail: result.reason,
93
- status: 403,
94
- title: "Access denied",
95
- });
96
- }
97
- return [2 /*return*/, next()];
98
- case 5:
99
- error_1 = _b.sent();
100
- return [2 /*return*/, next(error_1)];
101
- case 6: return [2 /*return*/];
102
- }
17
+ const createRequireAccess = ({ can }) => (permissions, options) => {
18
+ return async (req, _res, next) => {
19
+ try {
20
+ const doc = options?.getDoc ? await options.getDoc(req) : undefined;
21
+ const result = await can({
22
+ context: { req },
23
+ doc,
24
+ permissions,
25
+ user: req.user,
103
26
  });
104
- }); };
27
+ if (!result.allowed) {
28
+ throw new errors_1.APIError({
29
+ detail: result.reason,
30
+ status: 403,
31
+ title: "Access denied",
32
+ });
33
+ }
34
+ return next();
35
+ }
36
+ catch (error) {
37
+ return next(error);
38
+ }
105
39
  };
106
40
  };
107
41
  exports.createRequireAccess = createRequireAccess;
@@ -4,8 +4,11 @@ import type { User } from "../auth";
4
4
  import type { RESTPermissions } from "../permissions";
5
5
  import type { AnyTerrenoAccess, ModelRouterAccessOptions, ResourceScope } from "./types";
6
6
  export declare const resolveActionForMethod: (method: RESTMethod, access: ModelRouterAccessOptions, statements: Record<string, readonly string[]>) => string | null;
7
+ /** @internal */
7
8
  export declare const buildAccessPermissions: <T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions) => RESTPermissions<T>;
9
+ /** @internal */
8
10
  export declare const buildAccessQueryFilter: <_T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions, existing?: (user?: express.Request["user"], query?: Record<string, unknown>) => Record<string, unknown> | null | Promise<Record<string, unknown> | null>) => (user?: express.Request["user"], query?: Record<string, unknown>) => Promise<Record<string, unknown> | null>;
11
+ /** @internal */
9
12
  export declare const wrapAccessResponseHandler: <T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions, baseHandler: (value: T | T[], method: RESTMethod, request: express.Request, options: {
10
13
  access?: ModelRouterAccessOptions;
11
14
  }) => Promise<unknown> | unknown) => (value: T | T[], method: "list" | "create" | "read" | "update" | "delete", request: express.Request, options: {