@terreno/api 57.2.0 → 57.4.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 (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -35,17 +35,6 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
35
35
  if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
36
  }
37
37
  };
38
- var __values = (this && this.__values) || function(o) {
39
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
- if (m) return m.call(o);
41
- if (o && typeof o.length === "number") return {
42
- next: function () {
43
- if (o && i >= o.length) o = void 0;
44
- return { value: o && o[i++], done: !o };
45
- }
46
- };
47
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
- };
49
38
  var __read = (this && this.__read) || function (o, n) {
50
39
  var m = typeof Symbol === "function" && o[Symbol.iterator];
51
40
  if (!m) return o;
@@ -62,9 +51,31 @@ var __read = (this && this.__read) || function (o, n) {
62
51
  }
63
52
  return ar;
64
53
  };
54
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
55
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
56
+ if (ar || !(i in from)) {
57
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
58
+ ar[i] = from[i];
59
+ }
60
+ }
61
+ return to.concat(ar || Array.prototype.slice.call(from));
62
+ };
63
+ var __values = (this && this.__values) || function(o) {
64
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
65
+ if (m) return m.call(o);
66
+ if (o && typeof o.length === "number") return {
67
+ next: function () {
68
+ if (o && i >= o.length) o = void 0;
69
+ return { value: o && o[i++], done: !o };
70
+ }
71
+ };
72
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
73
+ };
65
74
  Object.defineProperty(exports, "__esModule", { value: true });
66
75
  exports.createAccess = void 0;
76
+ var errors_1 = require("../errors");
67
77
  var auditModel_1 = require("./auditModel");
78
+ var membershipOrgAdminSource_1 = require("./membershipOrgAdminSource");
68
79
  var middleware_1 = require("./middleware");
69
80
  var resolve_1 = require("./resolve");
70
81
  var roleManager_1 = require("./roleManager");
@@ -81,24 +92,34 @@ var EMPTY_FIELD_MASK = {
81
92
  write: [],
82
93
  };
83
94
  var createAccess = function (options) {
95
+ var _a, _b, _c;
84
96
  var persistAudit = options.persistAudit !== false;
85
97
  var auditSinks = (0, auditModel_1.normalizeRbacAuditSinks)(options.auditSink);
86
98
  if (!persistAudit && auditSinks.length === 0) {
87
- throw new Error("RBAC audit requires persistAudit or at least one auditSink");
99
+ throw new errors_1.APIError({
100
+ status: 500,
101
+ title: "RBAC audit requires persistAudit or at least one auditSink",
102
+ });
88
103
  }
89
104
  var mergedStatements = (0, statements_1.mergeStatements)(options.statements);
90
105
  var rbacRoleModel = (0, roleModel_1.createRbacRoleModel)(options.connection);
106
+ var extraRoles = __spreadArray([], __read(((_a = options.defaultRoles) !== null && _a !== void 0 ? _a : [])), false);
107
+ if (options.organizations && !extraRoles.some(function (role) { return role.name === "operator"; })) {
108
+ extraRoles.push(roleModel_1.organizationOperatorRole);
109
+ }
110
+ var sources = options.organizations
111
+ ? __spreadArray([(0, membershipOrgAdminSource_1.membershipOrgAdminPermissionSource)()], __read(((_b = options.sources) !== null && _b !== void 0 ? _b : [])), false) : ((_c = options.sources) !== null && _c !== void 0 ? _c : []);
91
112
  var resolver = (0, resolve_1.createPermissionResolver)({
92
113
  cacheTtlMs: options.cacheTtlMs,
93
114
  rbacRoleModel: rbacRoleModel,
94
115
  resolvePermissions: options.resolvePermissions,
95
- sources: options.sources,
116
+ sources: sources,
96
117
  statements: mergedStatements,
97
118
  });
98
119
  var roleManager = (0, roleManager_1.createRoleManager)({
99
120
  auditSinks: auditSinks,
100
121
  connection: options.connection,
101
- defaultRoles: options.defaultRoles,
122
+ defaultRoles: extraRoles,
102
123
  getActorPermissions: function (user) { return resolver.resolvePermissionsForUser(user); },
103
124
  getPreviewPermissions: function (user) { return resolver.resolvePermissionsForUserUncached(user); },
104
125
  invalidateCache: resolver.invalidateCache,
@@ -0,0 +1,9 @@
1
+ import type { ModelRouterOptions, RESTMethod } from "../api";
2
+ import type { User } from "../auth";
3
+ export interface AssertAllowedArgs<T> {
4
+ method: RESTMethod;
5
+ options: Pick<ModelRouterOptions<T>, "access" | "accessControl" | "permissions">;
6
+ user?: User;
7
+ doc?: T;
8
+ }
9
+ export declare const assertAllowed: <T>({ method, options, user, doc, }: AssertAllowedArgs<T>) => Promise<void>;
@@ -0,0 +1,182 @@
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
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.assertAllowed = void 0;
40
+ var errors_1 = require("../errors");
41
+ var permissions_1 = require("../permissions");
42
+ var modelRouterAccess_1 = require("./modelRouterAccess");
43
+ var throwAccessDenied = function (_a) {
44
+ var status = _a.status, title = _a.title, detail = _a.detail;
45
+ throw new errors_1.APIError({
46
+ detail: detail,
47
+ status: status,
48
+ title: title,
49
+ });
50
+ };
51
+ var assertAllowedViaAccess = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
52
+ var statements, action, result, scopeResult, extra, also, alsoAllowed;
53
+ var _c;
54
+ var _d, _e, _f;
55
+ var method = _b.method, access = _b.access, accessControl = _b.accessControl, user = _b.user, doc = _b.doc;
56
+ return __generator(this, function (_g) {
57
+ switch (_g.label) {
58
+ case 0:
59
+ statements = accessControl.statements;
60
+ action = (0, modelRouterAccess_1.resolveActionForMethod)(method, access, statements);
61
+ if (action === null) {
62
+ throw new errors_1.APIError({ status: 405, title: "Method not allowed" });
63
+ }
64
+ return [4 /*yield*/, accessControl.can({
65
+ doc: doc,
66
+ permissions: (_c = {}, _c[access.resource] = [action], _c),
67
+ user: user,
68
+ })];
69
+ case 1:
70
+ result = _g.sent();
71
+ if (!result.allowed) {
72
+ throwAccessDenied({
73
+ detail: result.reason,
74
+ status: 403,
75
+ title: "Access denied",
76
+ });
77
+ }
78
+ if (!((_d = access.scope) === null || _d === void 0 ? void 0 : _d.check)) return [3 /*break*/, 4];
79
+ if (user === undefined) {
80
+ throw new errors_1.APIError({ status: 403, title: "Access denied" });
81
+ }
82
+ return [4 /*yield*/, access.scope.check({
83
+ action: action,
84
+ doc: doc,
85
+ user: user,
86
+ })];
87
+ case 2:
88
+ scopeResult = _g.sent();
89
+ if (scopeResult === false) {
90
+ throwAccessDenied({ status: 403, title: "Access denied" });
91
+ }
92
+ if (!(scopeResult && typeof scopeResult === "object")) return [3 /*break*/, 4];
93
+ return [4 /*yield*/, accessControl.can({
94
+ doc: doc,
95
+ permissions: scopeResult,
96
+ user: user,
97
+ })];
98
+ case 3:
99
+ extra = _g.sent();
100
+ if (!extra.allowed) {
101
+ throwAccessDenied({
102
+ detail: extra.reason,
103
+ status: 403,
104
+ title: "Access denied",
105
+ });
106
+ }
107
+ _g.label = 4;
108
+ case 4:
109
+ also = (_f = (_e = access.also) === null || _e === void 0 ? void 0 : _e[method]) !== null && _f !== void 0 ? _f : [];
110
+ if (!(also.length > 0)) return [3 /*break*/, 6];
111
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)(method, also, user, doc)];
112
+ case 5:
113
+ alsoAllowed = _g.sent();
114
+ if (!alsoAllowed) {
115
+ throwAccessDenied({
116
+ status: doc ? 403 : 405,
117
+ title: doc ? "Access denied" : "Method not allowed",
118
+ });
119
+ }
120
+ _g.label = 6;
121
+ case 6: return [2 /*return*/];
122
+ }
123
+ });
124
+ }); };
125
+ var assertAllowedViaPermissions = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
126
+ var allowed;
127
+ var method = _b.method, permissions = _b.permissions, user = _b.user, doc = _b.doc;
128
+ return __generator(this, function (_c) {
129
+ switch (_c.label) {
130
+ case 0:
131
+ if (permissions.length === 0) {
132
+ throwAccessDenied({ status: 405, title: "Method not allowed" });
133
+ }
134
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)(method, permissions, user, doc)];
135
+ case 1:
136
+ allowed = _c.sent();
137
+ if (!allowed) {
138
+ throwAccessDenied({
139
+ status: doc ? 403 : 405,
140
+ title: doc ? "Access denied" : "Method not allowed",
141
+ });
142
+ }
143
+ return [2 /*return*/];
144
+ }
145
+ });
146
+ }); };
147
+ var assertAllowed = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
148
+ var method = _b.method, options = _b.options, user = _b.user, doc = _b.doc;
149
+ return __generator(this, function (_c) {
150
+ switch (_c.label) {
151
+ case 0:
152
+ if (!(options.access && options.accessControl)) return [3 /*break*/, 2];
153
+ return [4 /*yield*/, assertAllowedViaAccess({
154
+ access: options.access,
155
+ accessControl: options.accessControl,
156
+ doc: doc,
157
+ method: method,
158
+ user: user,
159
+ })];
160
+ case 1:
161
+ _c.sent();
162
+ return [2 /*return*/];
163
+ case 2:
164
+ if (!options.permissions) {
165
+ throw new errors_1.APIError({
166
+ status: 500,
167
+ title: "modelRouter requires permissions or access with accessControl",
168
+ });
169
+ }
170
+ return [4 /*yield*/, assertAllowedViaPermissions({
171
+ doc: doc,
172
+ method: method,
173
+ permissions: options.permissions[method],
174
+ user: user,
175
+ })];
176
+ case 3:
177
+ _c.sent();
178
+ return [2 /*return*/];
179
+ }
180
+ });
181
+ }); };
182
+ exports.assertAllowed = assertAllowed;
@@ -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,122 @@
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
+ var __read = (this && this.__read) || function (o, n) {
39
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
40
+ if (!m) return o;
41
+ var i = m.call(o), r, ar = [], e;
42
+ try {
43
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
44
+ }
45
+ catch (error) { e = { error: error }; }
46
+ finally {
47
+ try {
48
+ if (r && !r.done && (m = i["return"])) m.call(i);
49
+ }
50
+ finally { if (e) throw e.error; }
51
+ }
52
+ return ar;
53
+ };
54
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
55
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
56
+ if (ar || !(i in from)) {
57
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
58
+ ar[i] = from[i];
59
+ }
60
+ }
61
+ return to.concat(ar || Array.prototype.slice.call(from));
62
+ };
63
+ Object.defineProperty(exports, "__esModule", { value: true });
64
+ exports.membershipOrgAdminPermissionSource = exports.ORG_ADMIN_PERMISSION_BUNDLE = exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = void 0;
65
+ var organizationModel_1 = require("../orgs/organizationModel");
66
+ var orgContext_1 = require("../orgs/orgContext");
67
+ exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = "membership-org-admin";
68
+ /** Grants applied when `Membership.roleName` is `org-admin` in the current org context. */
69
+ exports.ORG_ADMIN_PERMISSION_BUNDLE = {
70
+ admin: ["access"],
71
+ organization: ["read", "update", "manageMembers"],
72
+ };
73
+ var userIdForMembershipLookup = function (user) {
74
+ if (user._id) {
75
+ return String(user._id);
76
+ }
77
+ return user.id;
78
+ };
79
+ var isActiveOrgAdminMembership = function (membership) {
80
+ return (membership === null || membership === void 0 ? void 0 : membership.roleName) === "org-admin" && membership.status === "active";
81
+ };
82
+ var fullOrgAdminGrants = function () { return ({
83
+ permissions: {
84
+ admin: __spreadArray([], __read(exports.ORG_ADMIN_PERMISSION_BUNDLE.admin), false),
85
+ organization: __spreadArray([], __read(exports.ORG_ADMIN_PERMISSION_BUNDLE.organization), false),
86
+ },
87
+ }); };
88
+ var shellOnlyOrgAdminGrants = function () { return ({
89
+ permissions: {
90
+ admin: __spreadArray([], __read(exports.ORG_ADMIN_PERMISSION_BUNDLE.admin), false),
91
+ },
92
+ }); };
93
+ var membershipOrgAdminPermissionSource = function () { return ({
94
+ getGrants: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
95
+ var contextMembership, activeMemberships, hasOrgAdminMembership;
96
+ var _c;
97
+ var user = _b.user;
98
+ return __generator(this, function (_d) {
99
+ switch (_d.label) {
100
+ case 0:
101
+ contextMembership = (_c = (0, orgContext_1.getOrgContext)()) === null || _c === void 0 ? void 0 : _c.membership;
102
+ if (contextMembership) {
103
+ if (!isActiveOrgAdminMembership(contextMembership)) {
104
+ return [2 /*return*/, null];
105
+ }
106
+ return [2 /*return*/, fullOrgAdminGrants()];
107
+ }
108
+ return [4 /*yield*/, organizationModel_1.Membership.findActiveForUser(userIdForMembershipLookup(user))];
109
+ case 1:
110
+ activeMemberships = _d.sent();
111
+ hasOrgAdminMembership = activeMemberships.some(function (row) { return row.roleName === "org-admin"; });
112
+ if (!hasOrgAdminMembership) {
113
+ return [2 /*return*/, null];
114
+ }
115
+ return [2 /*return*/, shellOnlyOrgAdminGrants()];
116
+ }
117
+ });
118
+ }); },
119
+ name: exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME,
120
+ ttlMs: 0,
121
+ }); };
122
+ exports.membershipOrgAdminPermissionSource = membershipOrgAdminPermissionSource;
@@ -3,8 +3,12 @@ import type { RESTMethod } from "../api";
3
3
  import type { User } from "../auth";
4
4
  import type { RESTPermissions } from "../permissions";
5
5
  import type { AnyTerrenoAccess, ModelRouterAccessOptions, ResourceScope } from "./types";
6
+ export declare const resolveActionForMethod: (method: RESTMethod, access: ModelRouterAccessOptions, statements: Record<string, readonly string[]>) => string | null;
7
+ /** @internal */
6
8
  export declare const buildAccessPermissions: <T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions) => RESTPermissions<T>;
9
+ /** @internal */
7
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 */
8
12
  export declare const wrapAccessResponseHandler: <T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions, baseHandler: (value: T | T[], method: RESTMethod, request: express.Request, options: {
9
13
  access?: ModelRouterAccessOptions;
10
14
  }) => Promise<unknown> | unknown) => (value: T | T[], method: "list" | "create" | "read" | "update" | "delete", request: express.Request, options: {
@@ -83,7 +83,7 @@ var __values = (this && this.__values) || function(o) {
83
83
  throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
84
84
  };
85
85
  Object.defineProperty(exports, "__esModule", { value: true });
86
- exports.resolveModelRouterAccess = exports.validateAccessWritePayload = exports.validateAccessWriteBody = exports.wrapAccessResponseHandler = exports.buildAccessQueryFilter = exports.buildAccessPermissions = void 0;
86
+ exports.resolveModelRouterAccess = exports.validateAccessWritePayload = exports.validateAccessWriteBody = exports.wrapAccessResponseHandler = exports.buildAccessQueryFilter = exports.buildAccessPermissions = exports.resolveActionForMethod = void 0;
87
87
  var errors_1 = require("../errors");
88
88
  var transformers_1 = require("../transformers");
89
89
  var fieldViews_1 = require("./fieldViews");
@@ -128,18 +128,20 @@ var resolveActionForMethod = function (method, access, statements) {
128
128
  }
129
129
  return DEFAULT_METHOD_ACTIONS[method];
130
130
  };
131
+ exports.resolveActionForMethod = resolveActionForMethod;
131
132
  var buildPermissionRequest = function (resource, action) {
132
133
  var _a;
133
134
  return (_a = {},
134
135
  _a[resource] = [action],
135
136
  _a);
136
137
  };
138
+ /** @internal */
137
139
  var buildAccessPermissions = function (accessControl, access) {
138
140
  var isPermitted = (0, middleware_1.createIsPermitted)({ can: accessControl.can });
139
141
  var statements = accessControl.statements;
140
142
  var buildMethodPermissions = function (method) {
141
143
  var _a, _b, _c;
142
- var action = resolveActionForMethod(method, access, statements);
144
+ var action = (0, exports.resolveActionForMethod)(method, access, statements);
143
145
  if (!action) {
144
146
  return [];
145
147
  }
@@ -192,6 +194,7 @@ var buildAccessPermissions = function (accessControl, access) {
192
194
  };
193
195
  };
194
196
  exports.buildAccessPermissions = buildAccessPermissions;
197
+ /** @internal */
195
198
  var buildAccessQueryFilter = function (accessControl, access, existing) {
196
199
  return function (user, query) { return __awaiter(void 0, void 0, void 0, function () {
197
200
  var merged, statements, listAction, scopeFilter, withAccessScope, routerScopeFilter;
@@ -210,7 +213,7 @@ var buildAccessQueryFilter = function (accessControl, access, existing) {
210
213
  _b.label = 2;
211
214
  case 2:
212
215
  statements = accessControl.statements;
213
- listAction = resolveActionForMethod("list", access, statements);
216
+ listAction = (0, exports.resolveActionForMethod)("list", access, statements);
214
217
  if (!listAction) {
215
218
  return [2 /*return*/, merged];
216
219
  }
@@ -238,6 +241,7 @@ var buildAccessQueryFilter = function (accessControl, access, existing) {
238
241
  }); };
239
242
  };
240
243
  exports.buildAccessQueryFilter = buildAccessQueryFilter;
244
+ /** @internal */
241
245
  var wrapAccessResponseHandler = function (accessControl, access, baseHandler) {
242
246
  return function (value, method, request, options) { return __awaiter(void 0, void 0, void 0, function () {
243
247
  var serialized, docs, masked;
@@ -368,7 +372,10 @@ var resolveModelRouterAccess = function (options) {
368
372
  var _a, _b;
369
373
  if (!options.access || !options.accessControl) {
370
374
  if (!options.permissions) {
371
- throw new Error("modelRouter requires permissions or access with accessControl");
375
+ throw new errors_1.APIError({
376
+ status: 500,
377
+ title: "modelRouter requires permissions or access with accessControl",
378
+ });
372
379
  }
373
380
  return {
374
381
  permissions: options.permissions,
@@ -37,6 +37,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
37
37
  };
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.validatePermissionSet = exports.diffPermissionSets = exports.isPermissionSubset = exports.unionPermissionSets = void 0;
40
+ var errors_1 = require("../errors");
40
41
  var unionPermissionSets = function () {
41
42
  var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
42
43
  var sets = [];
@@ -179,13 +180,13 @@ var validatePermissionSet = function (permissions, statements) {
179
180
  var _e = __read(_d.value, 2), resource = _e[0], actions = _e[1];
180
181
  var allowedActions = statements[resource];
181
182
  if (!allowedActions) {
182
- throw new Error("Unknown resource: ".concat(resource));
183
+ throw new errors_1.APIError({ status: 500, title: "Unknown resource: ".concat(resource) });
183
184
  }
184
185
  try {
185
186
  for (var actions_3 = (e_9 = void 0, __values(actions)), actions_3_1 = actions_3.next(); !actions_3_1.done; actions_3_1 = actions_3.next()) {
186
187
  var action = actions_3_1.value;
187
188
  if (!allowedActions.includes(action)) {
188
- throw new Error("Unknown permission: ".concat(resource, ":").concat(action));
189
+ throw new errors_1.APIError({ status: 500, title: "Unknown permission: ".concat(resource, ":").concat(action) });
189
190
  }
190
191
  }
191
192
  }