@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
@@ -0,0 +1,64 @@
1
+ import type {Request} from "express";
2
+
3
+ /** Default fixed window: 15 minutes. */
4
+ export const DEFAULT_WINDOW_MS = 15 * 60 * 1000;
5
+
6
+ /** Stricter bucket for login, signup, refresh, OTP, GitHub OAuth, Better Auth sign-in. */
7
+ export const DEFAULT_AUTH_MAX = 20;
8
+
9
+ /** Looser bucket for modelRouter and other framework HTTP. */
10
+ export const DEFAULT_API_MAX = 600;
11
+
12
+ export interface RateLimitLimits {
13
+ windowMs?: number;
14
+ authMax?: number;
15
+ apiMax?: number;
16
+ }
17
+
18
+ export interface RateLimitOptions {
19
+ store?: "memory" | "redis" | "mongo";
20
+ limits?: RateLimitLimits;
21
+ trustProxy?: boolean | number | string | string[];
22
+ skip?: (req: Request) => boolean;
23
+ /**
24
+ * Better Auth `basePath` (default `/api/auth`). Used to classify sign-in,
25
+ * sign-up, password reset, and OAuth callback routes as the auth bucket.
26
+ * When omitted, TerrenoApp copies `BetterAuthApp` config.basePath if that plugin is registered.
27
+ */
28
+ betterAuthBasePath?: string;
29
+ /** Test-only clock. */
30
+ now?: () => number;
31
+ /**
32
+ * Test-only store override. Production uses `store`.
33
+ */
34
+ storeImpl?: RateLimitStore;
35
+ /**
36
+ * Test-only Redis client. Production Redis store builds a client from VALKEY_URL / REDIS_URL.
37
+ */
38
+ redisClient?: RateLimitRedisClient;
39
+ }
40
+
41
+ export interface RateLimitConsumeArgs {
42
+ key: string;
43
+ max: number;
44
+ windowMs: number;
45
+ now: number;
46
+ }
47
+
48
+ export interface RateLimitConsumeResult {
49
+ allowed: boolean;
50
+ remaining: number;
51
+ resetAt: number;
52
+ }
53
+
54
+ export interface RateLimitStore {
55
+ consume: (args: RateLimitConsumeArgs) => Promise<RateLimitConsumeResult>;
56
+ }
57
+
58
+ export interface RateLimitRedisClient {
59
+ incr: (key: string) => Promise<number>;
60
+ pExpire: (key: string, milliseconds: number) => Promise<unknown>;
61
+ pTTL: (key: string) => Promise<number>;
62
+ }
63
+
64
+ export type RateLimitPolicyName = "auth" | "api";
@@ -1,9 +1,11 @@
1
1
  import type {User} from "../auth";
2
+ import {APIError} from "../errors";
2
3
  import {normalizeRbacAuditSinks} from "./auditModel";
4
+ import {membershipOrgAdminPermissionSource} from "./membershipOrgAdminSource";
3
5
  import {createIsPermitted, createRequireAccess} from "./middleware";
4
6
  import {createPermissionResolver} from "./resolve";
5
7
  import {createRoleManager} from "./roleManager";
6
- import {createRbacRoleModel} from "./roleModel";
8
+ import {createRbacRoleModel, organizationOperatorRole} from "./roleModel";
7
9
  import {mergeStatements, type Statements} from "./statements";
8
10
  import type {
9
11
  AccessCheckArgs,
@@ -30,24 +32,34 @@ export const createAccess = <S extends Statements>(options: AccessOptions<S>): T
30
32
  const persistAudit = options.persistAudit !== false;
31
33
  const auditSinks = normalizeRbacAuditSinks(options.auditSink);
32
34
  if (!persistAudit && auditSinks.length === 0) {
33
- throw new Error("RBAC audit requires persistAudit or at least one auditSink");
35
+ throw new APIError({
36
+ status: 500,
37
+ title: "RBAC audit requires persistAudit or at least one auditSink",
38
+ });
34
39
  }
35
40
 
36
41
  const mergedStatements = mergeStatements(options.statements) as S;
37
42
  const rbacRoleModel = createRbacRoleModel(options.connection);
43
+ const extraRoles = [...(options.defaultRoles ?? [])];
44
+ if (options.organizations && !extraRoles.some((role) => role.name === "operator")) {
45
+ extraRoles.push(organizationOperatorRole);
46
+ }
47
+ const sources = options.organizations
48
+ ? [membershipOrgAdminPermissionSource(), ...(options.sources ?? [])]
49
+ : (options.sources ?? []);
38
50
 
39
51
  const resolver = createPermissionResolver({
40
52
  cacheTtlMs: options.cacheTtlMs,
41
53
  rbacRoleModel,
42
54
  resolvePermissions: options.resolvePermissions,
43
- sources: options.sources,
55
+ sources,
44
56
  statements: mergedStatements,
45
57
  });
46
58
 
47
59
  const {roleManager} = createRoleManager({
48
60
  auditSinks,
49
61
  connection: options.connection,
50
- defaultRoles: options.defaultRoles,
62
+ defaultRoles: extraRoles,
51
63
  getActorPermissions: (user) => resolver.resolvePermissionsForUser(user),
52
64
  getPreviewPermissions: (user) => resolver.resolvePermissionsForUserUncached(user),
53
65
  invalidateCache: resolver.invalidateCache,
@@ -0,0 +1,325 @@
1
+ import {describe, expect, it, mock} from "bun:test";
2
+ import mongoose from "mongoose";
3
+
4
+ import type {User} from "../auth";
5
+ import {type APIError, isAPIError} from "../errors";
6
+ import {Permissions} from "../permissions";
7
+ import {setupDb} from "../tests";
8
+ import {createAccess} from "./access";
9
+ import {assertAllowed} from "./assertAllowed";
10
+ import {terrenoStatements} from "./statements";
11
+ import type {AnyTerrenoAccess} from "./types";
12
+
13
+ const appStatements = {
14
+ ...terrenoStatements,
15
+ todo: ["create", "read", "update", "delete", "list"],
16
+ } as const;
17
+
18
+ const createUser = (
19
+ overrides: Partial<User & {roles: string[]}> = {}
20
+ ): User & {roles: string[]} => {
21
+ const id = new mongoose.Types.ObjectId();
22
+ return {
23
+ _id: id as unknown as User["_id"],
24
+ admin: false,
25
+ id: id.toString(),
26
+ roles: [],
27
+ ...overrides,
28
+ };
29
+ };
30
+
31
+ const fullLegacyPermissions = {
32
+ create: [Permissions.IsAny],
33
+ delete: [Permissions.IsAny],
34
+ list: [Permissions.IsAny],
35
+ read: [Permissions.IsAny],
36
+ update: [Permissions.IsAny],
37
+ };
38
+
39
+ describe("assertAllowed", () => {
40
+ it("allows access when can() passes even if legacy permissions would deny", async () => {
41
+ const user = createUser();
42
+ const can = mock(async () => ({allowed: true}));
43
+ const accessControl = {
44
+ can,
45
+ statements: appStatements,
46
+ } as unknown as AnyTerrenoAccess;
47
+
48
+ await assertAllowed({
49
+ method: "create",
50
+ options: {
51
+ access: {resource: "todo"},
52
+ accessControl,
53
+ permissions: {
54
+ ...fullLegacyPermissions,
55
+ create: [Permissions.IsAdmin],
56
+ },
57
+ },
58
+ user,
59
+ });
60
+
61
+ expect(can).toHaveBeenCalled();
62
+ });
63
+
64
+ it("throws 405 when legacy permissions array is empty", async () => {
65
+ const user = createUser({admin: true});
66
+
67
+ await expect(
68
+ assertAllowed({
69
+ method: "delete",
70
+ options: {
71
+ permissions: {
72
+ ...fullLegacyPermissions,
73
+ delete: [],
74
+ },
75
+ },
76
+ user,
77
+ })
78
+ ).rejects.toMatchObject({status: 405});
79
+ });
80
+
81
+ it("throws 403 when can() denies", async () => {
82
+ const user = createUser();
83
+ const can = mock(async () => ({
84
+ allowed: false,
85
+ deniedBy: "role" as const,
86
+ reason: "Missing todo:create",
87
+ }));
88
+ const accessControl = {
89
+ can,
90
+ statements: appStatements,
91
+ } as unknown as AnyTerrenoAccess;
92
+
93
+ await expect(
94
+ assertAllowed({
95
+ method: "create",
96
+ options: {
97
+ access: {resource: "todo"},
98
+ accessControl,
99
+ permissions: fullLegacyPermissions,
100
+ },
101
+ user,
102
+ })
103
+ ).rejects.toMatchObject({
104
+ detail: "Missing todo:create",
105
+ status: 403,
106
+ title: "Access denied",
107
+ });
108
+ });
109
+
110
+ it("applies legacy AND semantics across permission methods", async () => {
111
+ const user = createUser();
112
+
113
+ await expect(
114
+ assertAllowed({
115
+ method: "create",
116
+ options: {
117
+ permissions: {
118
+ ...fullLegacyPermissions,
119
+ create: [Permissions.IsAuthenticated, Permissions.IsAdmin],
120
+ },
121
+ },
122
+ user,
123
+ })
124
+ ).rejects.toMatchObject({status: 405});
125
+ });
126
+
127
+ it("throws 403 for legacy object-level denial when doc is provided", async () => {
128
+ const ownerId = new mongoose.Types.ObjectId();
129
+ const user = createUser();
130
+ const doc = {ownerId: ownerId.toString()} as {ownerId: string};
131
+
132
+ try {
133
+ await assertAllowed({
134
+ doc,
135
+ method: "read",
136
+ options: {
137
+ permissions: {
138
+ ...fullLegacyPermissions,
139
+ read: [Permissions.IsOwner],
140
+ },
141
+ },
142
+ user,
143
+ });
144
+ throw new Error("expected assertAllowed to throw");
145
+ } catch (error) {
146
+ expect(isAPIError(error)).toBe(true);
147
+ expect((error as APIError).status).toBe(403);
148
+ }
149
+ });
150
+
151
+ it("throws 405 when RBAC action is disabled", async () => {
152
+ await setupDb();
153
+ const access = createAccess({
154
+ connection: mongoose.connection,
155
+ statements: appStatements,
156
+ });
157
+ await access.roles.seedDefaults();
158
+ const user = createUser({roles: ["superadmin"]});
159
+
160
+ await expect(
161
+ assertAllowed({
162
+ method: "delete",
163
+ options: {
164
+ access: {actions: {delete: null}, resource: "todo"},
165
+ accessControl: access as AnyTerrenoAccess,
166
+ permissions: fullLegacyPermissions,
167
+ },
168
+ user,
169
+ })
170
+ ).rejects.toMatchObject({status: 405});
171
+ });
172
+
173
+ it("denies RBAC create via real can() when role lacks permission", async () => {
174
+ await setupDb();
175
+ const access = createAccess({
176
+ connection: mongoose.connection,
177
+ defaultRoles: [
178
+ {
179
+ displayName: "Reader",
180
+ name: "reader",
181
+ permissions: {todo: ["read", "list"]},
182
+ },
183
+ ],
184
+ statements: appStatements,
185
+ });
186
+ await access.roles.seedDefaults();
187
+ const user = createUser({roles: ["reader"]});
188
+
189
+ await expect(
190
+ assertAllowed({
191
+ method: "create",
192
+ options: {
193
+ access: {resource: "todo"},
194
+ accessControl: access as AnyTerrenoAccess,
195
+ permissions: fullLegacyPermissions,
196
+ },
197
+ user,
198
+ })
199
+ ).rejects.toMatchObject({status: 403});
200
+ });
201
+
202
+ it("throws 500 when neither access nor permissions are configured", async () => {
203
+ await expect(
204
+ assertAllowed({
205
+ method: "create",
206
+ options: {},
207
+ user: createUser(),
208
+ })
209
+ ).rejects.toMatchObject({
210
+ status: 500,
211
+ title: "modelRouter requires permissions or access with accessControl",
212
+ });
213
+ });
214
+
215
+ it("denies when scope.check returns false", async () => {
216
+ const user = createUser();
217
+ const can = mock(async () => ({allowed: true}));
218
+ const scopeCheck = mock(async () => false);
219
+ const accessControl = {
220
+ can,
221
+ statements: appStatements,
222
+ } as unknown as AnyTerrenoAccess;
223
+
224
+ await expect(
225
+ assertAllowed({
226
+ method: "read",
227
+ options: {
228
+ access: {
229
+ resource: "todo",
230
+ scope: {check: scopeCheck},
231
+ },
232
+ accessControl,
233
+ permissions: fullLegacyPermissions,
234
+ },
235
+ user,
236
+ })
237
+ ).rejects.toMatchObject({status: 403, title: "Access denied"});
238
+
239
+ expect(scopeCheck).toHaveBeenCalled();
240
+ });
241
+
242
+ it("denies when scope.check requires extra permissions that can() rejects", async () => {
243
+ const user = createUser();
244
+ const can = mock(async ({permissions}) => {
245
+ const todoPerms = (permissions as {todo?: string[]}).todo ?? [];
246
+ if (todoPerms.includes("admin")) {
247
+ return {allowed: false, reason: "Missing admin"};
248
+ }
249
+ return {allowed: true};
250
+ });
251
+ const scopeCheck = mock(async () => ({todo: ["admin"]}));
252
+ const accessControl = {
253
+ can,
254
+ statements: appStatements,
255
+ } as unknown as AnyTerrenoAccess;
256
+
257
+ await expect(
258
+ assertAllowed({
259
+ method: "read",
260
+ options: {
261
+ access: {
262
+ resource: "todo",
263
+ scope: {check: scopeCheck},
264
+ },
265
+ accessControl,
266
+ permissions: fullLegacyPermissions,
267
+ },
268
+ user,
269
+ })
270
+ ).rejects.toMatchObject({
271
+ detail: "Missing admin",
272
+ status: 403,
273
+ title: "Access denied",
274
+ });
275
+ });
276
+
277
+ it("denies scope when user is missing even if can() allows anonymous access", async () => {
278
+ const can = mock(async () => ({allowed: true}));
279
+ const scopeCheck = mock(async () => true);
280
+ const accessControl = {
281
+ can,
282
+ statements: appStatements,
283
+ } as unknown as AnyTerrenoAccess;
284
+
285
+ await expect(
286
+ assertAllowed({
287
+ method: "read",
288
+ options: {
289
+ access: {
290
+ resource: "todo",
291
+ scope: {check: scopeCheck},
292
+ },
293
+ accessControl,
294
+ permissions: fullLegacyPermissions,
295
+ },
296
+ })
297
+ ).rejects.toMatchObject({status: 403, title: "Access denied"});
298
+
299
+ expect(scopeCheck).not.toHaveBeenCalled();
300
+ });
301
+
302
+ it("enforces access.also legacy permission checks", async () => {
303
+ const user = createUser();
304
+ const can = mock(async () => ({allowed: true}));
305
+ const accessControl = {
306
+ can,
307
+ statements: appStatements,
308
+ } as unknown as AnyTerrenoAccess;
309
+
310
+ await expect(
311
+ assertAllowed({
312
+ method: "create",
313
+ options: {
314
+ access: {
315
+ also: {create: [Permissions.IsAdmin]},
316
+ resource: "todo",
317
+ },
318
+ accessControl,
319
+ permissions: fullLegacyPermissions,
320
+ },
321
+ user,
322
+ })
323
+ ).rejects.toMatchObject({status: 405});
324
+ });
325
+ });
@@ -0,0 +1,157 @@
1
+ import type {ModelRouterOptions, RESTMethod} from "../api";
2
+ import type {User} from "../auth";
3
+ import {APIError} from "../errors";
4
+ import {checkPermissions, type PermissionMethod} from "../permissions";
5
+ import {resolveActionForMethod} from "./modelRouterAccess";
6
+ import type {AnyTerrenoAccess, ModelRouterAccessOptions} from "./types";
7
+
8
+ export interface AssertAllowedArgs<T> {
9
+ method: RESTMethod;
10
+ options: Pick<ModelRouterOptions<T>, "access" | "accessControl" | "permissions">;
11
+ user?: User;
12
+ doc?: T;
13
+ }
14
+
15
+ const throwAccessDenied = ({
16
+ status,
17
+ title,
18
+ detail,
19
+ }: {
20
+ status: 403 | 405;
21
+ title: string;
22
+ detail?: string;
23
+ }): never => {
24
+ throw new APIError({
25
+ detail,
26
+ status,
27
+ title,
28
+ });
29
+ };
30
+
31
+ const assertAllowedViaAccess = async <T>({
32
+ method,
33
+ access,
34
+ accessControl,
35
+ user,
36
+ doc,
37
+ }: {
38
+ method: RESTMethod;
39
+ access: ModelRouterAccessOptions;
40
+ accessControl: AnyTerrenoAccess;
41
+ user?: User;
42
+ doc?: T;
43
+ }): Promise<void> => {
44
+ const statements = accessControl.statements as Record<string, readonly string[]>;
45
+ const action = resolveActionForMethod(method, access, statements);
46
+ if (action === null) {
47
+ throw new APIError({status: 405, title: "Method not allowed"});
48
+ }
49
+
50
+ const result = await accessControl.can({
51
+ doc,
52
+ permissions: {[access.resource]: [action]} as never,
53
+ user,
54
+ });
55
+ if (!result.allowed) {
56
+ throwAccessDenied({
57
+ detail: result.reason,
58
+ status: 403,
59
+ title: "Access denied",
60
+ });
61
+ }
62
+
63
+ if (access.scope?.check) {
64
+ if (user === undefined) {
65
+ throw new APIError({status: 403, title: "Access denied"});
66
+ }
67
+ const scopeResult = await access.scope.check({
68
+ action,
69
+ doc,
70
+ user,
71
+ });
72
+ if (scopeResult === false) {
73
+ throwAccessDenied({status: 403, title: "Access denied"});
74
+ }
75
+ if (scopeResult && typeof scopeResult === "object") {
76
+ const extra = await accessControl.can({
77
+ doc,
78
+ permissions: scopeResult as never,
79
+ user,
80
+ });
81
+ if (!extra.allowed) {
82
+ throwAccessDenied({
83
+ detail: extra.reason,
84
+ status: 403,
85
+ title: "Access denied",
86
+ });
87
+ }
88
+ }
89
+ }
90
+
91
+ const also = access.also?.[method] ?? [];
92
+ if (also.length > 0) {
93
+ const alsoAllowed = await checkPermissions(method, also as PermissionMethod<T>[], user, doc);
94
+ if (!alsoAllowed) {
95
+ throwAccessDenied({
96
+ status: doc ? 403 : 405,
97
+ title: doc ? "Access denied" : "Method not allowed",
98
+ });
99
+ }
100
+ }
101
+ };
102
+
103
+ const assertAllowedViaPermissions = async <T>({
104
+ method,
105
+ permissions,
106
+ user,
107
+ doc,
108
+ }: {
109
+ method: RESTMethod;
110
+ permissions: PermissionMethod<T>[];
111
+ user?: User;
112
+ doc?: T;
113
+ }): Promise<void> => {
114
+ if (permissions.length === 0) {
115
+ throwAccessDenied({status: 405, title: "Method not allowed"});
116
+ }
117
+
118
+ const allowed = await checkPermissions(method, permissions, user, doc);
119
+ if (!allowed) {
120
+ throwAccessDenied({
121
+ status: doc ? 403 : 405,
122
+ title: doc ? "Access denied" : "Method not allowed",
123
+ });
124
+ }
125
+ };
126
+
127
+ export const assertAllowed = async <T>({
128
+ method,
129
+ options,
130
+ user,
131
+ doc,
132
+ }: AssertAllowedArgs<T>): Promise<void> => {
133
+ if (options.access && options.accessControl) {
134
+ await assertAllowedViaAccess({
135
+ access: options.access,
136
+ accessControl: options.accessControl,
137
+ doc,
138
+ method,
139
+ user,
140
+ });
141
+ return;
142
+ }
143
+
144
+ if (!options.permissions) {
145
+ throw new APIError({
146
+ status: 500,
147
+ title: "modelRouter requires permissions or access with accessControl",
148
+ });
149
+ }
150
+
151
+ await assertAllowedViaPermissions({
152
+ doc,
153
+ method,
154
+ permissions: options.permissions[method],
155
+ user,
156
+ });
157
+ };