@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;
@@ -71,10 +60,23 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
71
60
  }
72
61
  return to.concat(ar || Array.prototype.slice.call(from));
73
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
+ };
74
74
  Object.defineProperty(exports, "__esModule", { value: true });
75
75
  exports.createPermissionResolver = void 0;
76
76
  var access_1 = require("better-auth/plugins/access");
77
+ var luxon_1 = require("luxon");
77
78
  var logger_1 = require("../logger");
79
+ var orgContext_1 = require("../orgs/orgContext");
78
80
  var permissionUtils_1 = require("./permissionUtils");
79
81
  var DEFAULT_CACHE_TTL_MS = 30000;
80
82
  var DEFAULT_MAX_CACHE_ENTRIES = 10000;
@@ -83,14 +85,41 @@ var getUserRoles = function (user) {
83
85
  var withRoles = user;
84
86
  return (_a = withRoles.roles) !== null && _a !== void 0 ? _a : [];
85
87
  };
88
+ /** Include org context and roles so tenant switches and Mongo promotions are not stuck behind TTL. */
89
+ var permissionCacheKey = function (user) {
90
+ var _a, _b, _c, _d, _e;
91
+ var ctx = (0, orgContext_1.getOrgContext)();
92
+ var organizationId = (_c = (_b = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.organization) === null || _a === void 0 ? void 0 : _a._id) === null || _b === void 0 ? void 0 : _b.toString()) !== null && _c !== void 0 ? _c : "";
93
+ var membershipRole = (_e = (_d = ctx === null || ctx === void 0 ? void 0 : ctx.membership) === null || _d === void 0 ? void 0 : _d.roleName) !== null && _e !== void 0 ? _e : "";
94
+ var roles = __spreadArray([], __read(getUserRoles(user)), false).sort().join(",");
95
+ return "".concat(user.id, "::org=").concat(organizationId, "::role=").concat(membershipRole, "::roles=").concat(roles);
96
+ };
97
+ var deletePermissionCacheForUser = function (cache, userId) {
98
+ var e_1, _a;
99
+ try {
100
+ for (var _b = __values(__spreadArray([], __read(cache.keys()), false)), _c = _b.next(); !_c.done; _c = _b.next()) {
101
+ var key = _c.value;
102
+ if (key === userId || key.startsWith("".concat(userId, ":")) || key.startsWith("".concat(userId, "::"))) {
103
+ cache.delete(key);
104
+ }
105
+ }
106
+ }
107
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
108
+ finally {
109
+ try {
110
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
111
+ }
112
+ finally { if (e_1) throw e_1.error; }
113
+ }
114
+ };
86
115
  var createPermissionResolver = function (args) {
87
116
  var statements = args.statements, rbacRoleModel = args.rbacRoleModel, _a = args.sources, sources = _a === void 0 ? [] : _a, _b = args.cacheTtlMs, cacheTtlMs = _b === void 0 ? DEFAULT_CACHE_TTL_MS : _b, _c = args.maxCacheEntries, maxCacheEntries = _c === void 0 ? DEFAULT_MAX_CACHE_ENTRIES : _c, resolvePermissions = args.resolvePermissions;
88
117
  var ac = (0, access_1.createAccessControl)(statements);
89
118
  var permissionCache = new Map();
90
119
  var sourceCache = new Map();
91
120
  var enforceCacheBound = function () {
92
- var e_1, _a;
93
- var now = Date.now();
121
+ var e_2, _a;
122
+ var now = luxon_1.DateTime.now().toMillis();
94
123
  try {
95
124
  for (var permissionCache_1 = __values(permissionCache), permissionCache_1_1 = permissionCache_1.next(); !permissionCache_1_1.done; permissionCache_1_1 = permissionCache_1.next()) {
96
125
  var _b = __read(permissionCache_1_1.value, 2), userId = _b[0], entry = _b[1];
@@ -99,12 +128,12 @@ var createPermissionResolver = function (args) {
99
128
  }
100
129
  }
101
130
  }
102
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
131
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
103
132
  finally {
104
133
  try {
105
134
  if (permissionCache_1_1 && !permissionCache_1_1.done && (_a = permissionCache_1.return)) _a.call(permissionCache_1);
106
135
  }
107
- finally { if (e_1) throw e_1.error; }
136
+ finally { if (e_2) throw e_2.error; }
108
137
  }
109
138
  while (permissionCache.size > maxCacheEntries) {
110
139
  var oldestUserId = permissionCache.keys().next().value;
@@ -122,14 +151,14 @@ var createPermissionResolver = function (args) {
122
151
  sourceCache.delete(oldestUserId);
123
152
  }
124
153
  };
125
- var rememberPermissions = function (userId, entry) {
126
- permissionCache.delete(userId);
127
- permissionCache.set(userId, entry);
154
+ var rememberPermissions = function (cacheKey, entry) {
155
+ permissionCache.delete(cacheKey);
156
+ permissionCache.set(cacheKey, entry);
128
157
  enforceCacheBound();
129
158
  };
130
159
  var invalidateCache = function (invalidateArgs) {
131
160
  if (invalidateArgs === null || invalidateArgs === void 0 ? void 0 : invalidateArgs.userId) {
132
- permissionCache.delete(invalidateArgs.userId);
161
+ deletePermissionCacheForUser(permissionCache, invalidateArgs.userId);
133
162
  sourceCache.delete(invalidateArgs.userId);
134
163
  return;
135
164
  }
@@ -152,7 +181,7 @@ var createPermissionResolver = function (args) {
152
181
  });
153
182
  }); };
154
183
  var applyDenyGrants = function (permissions, deny) {
155
- var e_2, _a;
184
+ var e_3, _a;
156
185
  var _b;
157
186
  if (!deny) {
158
187
  return permissions;
@@ -171,12 +200,12 @@ var createPermissionResolver = function (args) {
171
200
  _loop_1(resource, actions);
172
201
  }
173
202
  }
174
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
203
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
175
204
  finally {
176
205
  try {
177
206
  if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
178
207
  }
179
- finally { if (e_2) throw e_2.error; }
208
+ finally { if (e_3) throw e_3.error; }
180
209
  }
181
210
  return result;
182
211
  };
@@ -219,7 +248,7 @@ var createPermissionResolver = function (args) {
219
248
  return __generator(this, function (_f) {
220
249
  switch (_f.label) {
221
250
  case 0:
222
- now = Date.now();
251
+ now = luxon_1.DateTime.now().toMillis();
223
252
  cached = (_a = sourceCache.get(user.id)) === null || _a === void 0 ? void 0 : _a.get(source.name);
224
253
  if (!!shouldCache) return [3 /*break*/, 4];
225
254
  _f.label = 1;
@@ -266,16 +295,17 @@ var createPermissionResolver = function (args) {
266
295
  });
267
296
  };
268
297
  var resolveEffectivePermissions = function (user, shouldCache) { return __awaiter(void 0, void 0, void 0, function () {
269
- var cached, roleNames, permissionSets, sourceResults, sources_1, sources_1_1, source, grants, e_3_1, uniqueRoleNames, _a, _b, _c, _d, custom, permissions, sources_2, sources_2_1, source, grants;
270
- var e_3, _e, e_4, _f;
298
+ var cacheKey, cached, roleNames, permissionSets, sourceResults, sources_1, sources_1_1, source, grants, e_4_1, uniqueRoleNames, _a, _b, _c, _d, custom, permissions, sources_2, sources_2_1, source, grants;
299
+ var e_4, _e, e_5, _f;
271
300
  var _g;
272
301
  return __generator(this, function (_h) {
273
302
  switch (_h.label) {
274
303
  case 0:
304
+ cacheKey = permissionCacheKey(user);
275
305
  if (shouldCache) {
276
- cached = permissionCache.get(user.id);
277
- if (cached && cached.expiresAt > Date.now()) {
278
- rememberPermissions(user.id, cached);
306
+ cached = permissionCache.get(cacheKey);
307
+ if (cached && cached.expiresAt > luxon_1.DateTime.now().toMillis()) {
308
+ rememberPermissions(cacheKey, cached);
279
309
  return [2 /*return*/, cached.permissions];
280
310
  }
281
311
  }
@@ -309,14 +339,14 @@ var createPermissionResolver = function (args) {
309
339
  return [3 /*break*/, 2];
310
340
  case 5: return [3 /*break*/, 8];
311
341
  case 6:
312
- e_3_1 = _h.sent();
313
- e_3 = { error: e_3_1 };
342
+ e_4_1 = _h.sent();
343
+ e_4 = { error: e_4_1 };
314
344
  return [3 /*break*/, 8];
315
345
  case 7:
316
346
  try {
317
347
  if (sources_1_1 && !sources_1_1.done && (_e = sources_1.return)) _e.call(sources_1);
318
348
  }
319
- finally { if (e_3) throw e_3.error; }
349
+ finally { if (e_4) throw e_4.error; }
320
350
  return [7 /*endfinally*/];
321
351
  case 8:
322
352
  uniqueRoleNames = __spreadArray([], __read(new Set(roleNames)), false);
@@ -345,16 +375,16 @@ var createPermissionResolver = function (args) {
345
375
  }
346
376
  }
347
377
  }
348
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
378
+ catch (e_5_1) { e_5 = { error: e_5_1 }; }
349
379
  finally {
350
380
  try {
351
381
  if (sources_2_1 && !sources_2_1.done && (_f = sources_2.return)) _f.call(sources_2);
352
382
  }
353
- finally { if (e_4) throw e_4.error; }
383
+ finally { if (e_5) throw e_5.error; }
354
384
  }
355
385
  if (shouldCache) {
356
- rememberPermissions(user.id, {
357
- expiresAt: Date.now() + cacheTtlMs,
386
+ rememberPermissions(cacheKey, {
387
+ expiresAt: luxon_1.DateTime.now().plus({ milliseconds: cacheTtlMs }).toMillis(),
358
388
  permissions: permissions,
359
389
  });
360
390
  }
@@ -32,11 +32,8 @@ export type RbacRoleModel = Model<RbacRoleDocument> & {
32
32
  }) => Promise<void>;
33
33
  };
34
34
  export { READ_ONLY_ROLE_PERMISSIONS } from "./statements";
35
- /**
36
- * Insert missing default roles. Existing unsealed roles are left unchanged so admin
37
- * customizations survive process restarts. Sealed roles are refreshed from code.
38
- */
39
- export declare const upsertSeededRole: (model: RbacRoleModel, role: RoleDefinition, statements: Statements) => Promise<void>;
40
35
  export declare const expandRolePermissions: (spec: RolePermissionSpec, statements: Statements, readActions?: readonly string[]) => PermissionSet;
36
+ /** Locked platform role seeded only when `createAccess({organizations: true})`. */
37
+ export declare const organizationOperatorRole: RoleDefinition;
41
38
  export declare const terrenoDefaultRoles: RoleDefinition[];
42
39
  export declare const createRbacRoleModel: (connection: Connection) => RbacRoleModel;
@@ -61,7 +61,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
61
61
  return (mod && mod.__esModule) ? mod : { "default": mod };
62
62
  };
63
63
  Object.defineProperty(exports, "__esModule", { value: true });
64
- exports.createRbacRoleModel = exports.terrenoDefaultRoles = exports.expandRolePermissions = exports.upsertSeededRole = exports.READ_ONLY_ROLE_PERMISSIONS = void 0;
64
+ exports.createRbacRoleModel = exports.terrenoDefaultRoles = exports.organizationOperatorRole = exports.expandRolePermissions = exports.READ_ONLY_ROLE_PERMISSIONS = void 0;
65
65
  var mongoose_1 = __importDefault(require("mongoose"));
66
66
  var plugins_1 = require("../plugins");
67
67
  var statements_1 = require("./statements");
@@ -110,12 +110,22 @@ var upsertSeededRole = function (model, role, statements) { return __awaiter(voi
110
110
  }
111
111
  });
112
112
  }); };
113
- exports.upsertSeededRole = upsertSeededRole;
114
113
  var expandRolePermissions = function (spec, statements, readActions) {
115
114
  if (readActions === void 0) { readActions = statements_1.READ_ACTIONS; }
116
115
  return (0, statements_1.expandRolePermissions)(spec, statements, readActions);
117
116
  };
118
117
  exports.expandRolePermissions = expandRolePermissions;
118
+ /** Locked platform role seeded only when `createAccess({organizations: true})`. */
119
+ exports.organizationOperatorRole = {
120
+ displayName: "Operator",
121
+ isLocked: true,
122
+ name: "operator",
123
+ permissions: {
124
+ admin: ["access"],
125
+ organization: ["create", "list", "read", "update", "delete", "manageMembers", "disable"],
126
+ user: ["list", "read", "update"],
127
+ },
128
+ };
119
129
  exports.terrenoDefaultRoles = [
120
130
  {
121
131
  displayName: "Super Admin",
@@ -130,6 +140,10 @@ exports.terrenoDefaultRoles = [
130
140
  name: "admin",
131
141
  permissions: {
132
142
  admin: ["access"],
143
+ adminAnnouncement: ["read", "write", "writeOwned"],
144
+ adminAnnouncementAcknowledgement: ["read"],
145
+ adminAnnouncementClickEvent: ["read"],
146
+ adminAnnouncementImpression: ["read"],
133
147
  configuration: ["read", "update"],
134
148
  user: ["create", "list", "read", "update"],
135
149
  },
@@ -207,7 +221,7 @@ rbacRoleSchema.statics = __assign(__assign({}, rbacRoleSchema.statics), { seedDe
207
221
  case 2:
208
222
  if (!!terrenoDefaultRoles_1_1.done) return [3 /*break*/, 5];
209
223
  role = terrenoDefaultRoles_1_1.value;
210
- return [4 /*yield*/, (0, exports.upsertSeededRole)(this, role, statements)];
224
+ return [4 /*yield*/, upsertSeededRole(this, role, statements)];
211
225
  case 3:
212
226
  _g.sent();
213
227
  _g.label = 4;
@@ -235,7 +249,7 @@ rbacRoleSchema.statics = __assign(__assign({}, rbacRoleSchema.statics), { seedDe
235
249
  if (terrenoNames.has(role.name)) {
236
250
  return [3 /*break*/, 11];
237
251
  }
238
- return [4 /*yield*/, (0, exports.upsertSeededRole)(this, role, statements)];
252
+ return [4 /*yield*/, upsertSeededRole(this, role, statements)];
239
253
  case 10:
240
254
  _g.sent();
241
255
  _g.label = 11;
@@ -44,6 +44,12 @@ var express_1 = __importDefault(require("express"));
44
44
  var api_1 = require("../api");
45
45
  var auth_1 = require("../auth");
46
46
  var errors_1 = require("../errors");
47
+ var pathParam = function (value, title) {
48
+ if (typeof value !== "string" || value.length === 0) {
49
+ throw new errors_1.APIError({ status: 400, title: title });
50
+ }
51
+ return value;
52
+ };
47
53
  var rbacRouter = function (_a) {
48
54
  var access = _a.access, userModel = _a.userModel, _b = _a.basePath, basePath = _b === void 0 ? "/rbac" : _b;
49
55
  return {
@@ -97,7 +103,7 @@ var rbacRouter = function (_a) {
97
103
  return [4 /*yield*/, access.roles.update({
98
104
  actor: actor,
99
105
  changes: req.body,
100
- roleName: req.params.name,
106
+ roleName: pathParam(req.params.name, "Role name is required"),
101
107
  })];
102
108
  case 1:
103
109
  role = _a.sent();
@@ -114,7 +120,10 @@ var rbacRouter = function (_a) {
114
120
  if (!actor) {
115
121
  throw new errors_1.APIError({ status: 401, title: "Unauthorized" });
116
122
  }
117
- return [4 /*yield*/, access.roles.remove({ actor: actor, roleName: req.params.name })];
123
+ return [4 /*yield*/, access.roles.remove({
124
+ actor: actor,
125
+ roleName: pathParam(req.params.name, "Role name is required"),
126
+ })];
118
127
  case 1:
119
128
  _a.sent();
120
129
  return [2 /*return*/, res.status(204).send()];
@@ -127,7 +136,7 @@ var rbacRouter = function (_a) {
127
136
  switch (_a.label) {
128
137
  case 0: return [4 /*yield*/, access.roles.previewRoleChange({
129
138
  permissions: req.body.permissions,
130
- roleName: req.params.name,
139
+ roleName: pathParam(req.params.name, "Role name is required"),
131
140
  })];
132
141
  case 1:
133
142
  diff = _a.sent();
@@ -140,7 +149,7 @@ var rbacRouter = function (_a) {
140
149
  var _a;
141
150
  return __generator(this, function (_b) {
142
151
  switch (_b.label) {
143
- case 0: return [4 /*yield*/, userModel.findById(req.params.id)];
152
+ case 0: return [4 /*yield*/, userModel.findById(pathParam(req.params.id, "User id is required"))];
144
153
  case 1:
145
154
  user = _b.sent();
146
155
  if (!user) {
@@ -176,7 +185,7 @@ var rbacRouter = function (_a) {
176
185
  return [4 /*yield*/, access.roles.assign({
177
186
  actor: actor,
178
187
  roleNames: req.body.roleNames,
179
- userId: req.params.id,
188
+ userId: pathParam(req.params.id, "User id is required"),
180
189
  })];
181
190
  case 1:
182
191
  _a.sent();
@@ -196,7 +205,7 @@ var rbacRouter = function (_a) {
196
205
  return [4 /*yield*/, access.roles.previewAssignment({
197
206
  actor: actor,
198
207
  roleNames: req.body.roleNames,
199
- userId: req.params.id,
208
+ userId: pathParam(req.params.id, "User id is required"),
200
209
  })];
201
210
  case 1:
202
211
  diff = _a.sent();
@@ -5,15 +5,24 @@ export declare const ADMIN_PAGE_ACTION: "access";
5
5
  export declare const ADMIN_PAGE_PERMISSION: {
6
6
  readonly admin: readonly ["access"];
7
7
  };
8
+ export declare const ORGANIZATION_ACTIONS: readonly ["create", "list", "read", "update", "delete", "manageMembers", "disable"];
8
9
  export declare const terrenoStatements: {
9
- readonly admin: readonly ["access", "runScripts", "viewBackgroundTasks"];
10
+ readonly admin: readonly ["access", "jobs", "runScripts", "viewBackgroundTasks"];
11
+ readonly adminAnnouncement: readonly ["read", "write", "writeOwned"];
12
+ readonly adminAnnouncementAcknowledgement: readonly ["read", "write", "writeOwned"];
13
+ readonly adminAnnouncementClickEvent: readonly ["read", "write", "writeOwned"];
14
+ readonly adminAnnouncementImpression: readonly ["read", "write", "writeOwned"];
10
15
  readonly adminConsentForm: readonly ["read", "write", "writeOwned"];
11
16
  readonly adminConsentResponse: readonly ["read", "write", "writeOwned"];
12
17
  readonly adminFeatureFlag: readonly ["read", "write", "writeOwned"];
18
+ readonly announcement: readonly ["create", "list", "read", "update", "delete"];
19
+ readonly announcementAcknowledgement: readonly ["list", "read"];
20
+ readonly announcementImpression: readonly ["list", "read"];
13
21
  readonly configuration: readonly ["read", "update"];
14
22
  readonly consentForm: readonly ["create", "list", "read", "update", "delete"];
15
23
  readonly consentResponse: readonly ["list", "read"];
16
24
  readonly featureFlag: readonly ["create", "list", "read", "update", "delete"];
25
+ readonly organization: readonly ["create", "list", "read", "update", "delete", "manageMembers", "disable"];
17
26
  readonly rbac: readonly ["read", "manageRoles", "assignRoles"];
18
27
  readonly user: readonly ["create", "list", "read", "update", "delete", "impersonate", "setPassword"];
19
28
  };
@@ -48,7 +48,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
48
48
  };
49
49
  var _a;
50
50
  Object.defineProperty(exports, "__esModule", { value: true });
51
- exports.expandRolePermissions = exports.mergeStatements = exports.READ_ONLY_ROLE_PERMISSIONS = exports.READ_ACTIONS = exports.terrenoStatements = exports.ADMIN_PAGE_PERMISSION = exports.ADMIN_PAGE_ACTION = exports.ADMIN_PAGE_RESOURCE = exports.ADMIN_MODEL_ACCESS = void 0;
51
+ exports.expandRolePermissions = exports.mergeStatements = exports.READ_ONLY_ROLE_PERMISSIONS = exports.READ_ACTIONS = exports.terrenoStatements = exports.ORGANIZATION_ACTIONS = exports.ADMIN_PAGE_PERMISSION = exports.ADMIN_PAGE_ACTION = exports.ADMIN_PAGE_RESOURCE = exports.ADMIN_MODEL_ACCESS = void 0;
52
52
  var MODEL_CRUD = ["create", "list", "read", "update", "delete"];
53
53
  exports.ADMIN_MODEL_ACCESS = ["read", "write", "writeOwned"];
54
54
  /** Resource/action that opens the admin panel. Other admin permissions do not grant entry. */
@@ -57,15 +57,32 @@ exports.ADMIN_PAGE_ACTION = "access";
57
57
  exports.ADMIN_PAGE_PERMISSION = (_a = {},
58
58
  _a[exports.ADMIN_PAGE_RESOURCE] = [exports.ADMIN_PAGE_ACTION],
59
59
  _a);
60
+ exports.ORGANIZATION_ACTIONS = [
61
+ "create",
62
+ "list",
63
+ "read",
64
+ "update",
65
+ "delete",
66
+ "manageMembers",
67
+ "disable",
68
+ ];
60
69
  exports.terrenoStatements = {
61
- admin: [exports.ADMIN_PAGE_ACTION, "runScripts", "viewBackgroundTasks"],
70
+ admin: [exports.ADMIN_PAGE_ACTION, "jobs", "runScripts", "viewBackgroundTasks"],
71
+ adminAnnouncement: exports.ADMIN_MODEL_ACCESS,
72
+ adminAnnouncementAcknowledgement: exports.ADMIN_MODEL_ACCESS,
73
+ adminAnnouncementClickEvent: exports.ADMIN_MODEL_ACCESS,
74
+ adminAnnouncementImpression: exports.ADMIN_MODEL_ACCESS,
62
75
  adminConsentForm: exports.ADMIN_MODEL_ACCESS,
63
76
  adminConsentResponse: exports.ADMIN_MODEL_ACCESS,
64
77
  adminFeatureFlag: exports.ADMIN_MODEL_ACCESS,
78
+ announcement: MODEL_CRUD,
79
+ announcementAcknowledgement: ["list", "read"],
80
+ announcementImpression: ["list", "read"],
65
81
  configuration: ["read", "update"],
66
82
  consentForm: MODEL_CRUD,
67
83
  consentResponse: ["list", "read"],
68
84
  featureFlag: MODEL_CRUD,
85
+ organization: exports.ORGANIZATION_ACTIONS,
69
86
  rbac: ["read", "manageRoles", "assignRoles"],
70
87
  user: ["create", "list", "read", "update", "delete", "impersonate", "setPassword"],
71
88
  };
@@ -150,6 +150,11 @@ export type RbacAuditSink = (record: RbacAuditWrite) => void | Promise<void>;
150
150
  export interface AccessOptions<S extends Statements> {
151
151
  connection: Connection;
152
152
  statements: S;
153
+ /**
154
+ * Opt in to organization RBAC: membership `org-admin` grants and the locked `operator` seed.
155
+ * Default `false` so existing single-tenant apps stay unchanged. New apps from bootstrap pass `true`.
156
+ */
157
+ organizations?: boolean;
153
158
  userModel?: UserModel;
154
159
  defaultRoles?: RoleDefinition[];
155
160
  scopes?: ResourceScopes<S>;
@@ -13,22 +13,20 @@ import type { ChangeStreamConfig, RealtimeEvent } from "./types";
13
13
  type WatchedChange = Extract<ChangeStreamDocument, {
14
14
  operationType: "insert" | "update" | "replace" | "delete";
15
15
  }>;
16
- /** First restart delay; doubles per consecutive attempt up to the max. */
17
- export declare const CHANGE_STREAM_RESTART_BASE_DELAY_MS = 250;
18
- /** Ceiling for the restart backoff — a long outage retries once every 30s, forever. */
19
- export declare const CHANGE_STREAM_RESTART_MAX_DELAY_MS = 30000;
20
16
  /**
21
17
  * Socket event telling clients their cached cursors may have gaps and they must
22
18
  * re-bootstrap. Emitted when the change stream's oplog history is gone
23
19
  * (`ChangeStreamHistoryLost`), which is the one failure a resume token cannot repair.
24
20
  * Payload: {@link SyncResyncHint}.
25
21
  */
22
+ /** @internal */
26
23
  export declare const SYNC_RESYNC_EVENT = "sync:resync-required";
27
24
  /**
28
25
  * C7: the sync bookkeeping collections must never drive fan-out — their own change
29
26
  * events are internal (counters/ledger/markers/keys), and processing them would emit
30
27
  * spurious deltas or reprocess scope-move markers. Exported for testing.
31
28
  */
29
+ /** @internal */
32
30
  export declare const DEFAULT_IGNORED_COLLECTIONS: string[];
33
31
  /**
34
32
  * Map MongoDB change stream operation types to our method names.
@@ -42,28 +40,33 @@ export declare const DEFAULT_IGNORED_COLLECTIONS: string[];
42
40
  *
43
41
  * Exported for testing.
44
42
  */
43
+ /** @internal */
45
44
  export declare const mapOperationType: (operationType: string, change: ChangeStreamDocument, enabledMethods?: ReadonlyArray<"create" | "update" | "delete">) => "create" | "update" | "delete" | null;
46
45
  /**
47
46
  * The minimal registry-entry shape the authorized-room emitters need. Both
48
47
  * `RealtimeRegistryEntry` and `SyncRegistryEntry` satisfy it structurally.
49
48
  */
50
49
  export interface AuthorizedEmitEntry {
50
+ collectionTag?: string;
51
51
  modelName: string;
52
52
  options: {
53
53
  permissions: {
54
54
  read: PermissionMethod<unknown>[];
55
55
  };
56
56
  };
57
+ routePath?: string;
57
58
  }
58
59
  /**
59
60
  * Determine which Socket.io rooms to emit to based on the room strategy.
60
61
  * Exported for testing.
61
62
  */
63
+ /** @internal */
62
64
  export declare const resolveRooms: (entry: RealtimeRegistryEntry, doc: Record<string, unknown>, method: string) => string[];
63
65
  /**
64
66
  * Ensure serialized documents include `id` to match REST API responses.
65
67
  * Change stream fullDocument payloads are raw BSON objects with `_id` only.
66
68
  */
69
+ /** @internal */
67
70
  export declare const ensureApiId: (data: unknown) => unknown;
68
71
  /**
69
72
  * Serialize a document for emission.
@@ -81,6 +84,7 @@ export declare const ensureApiId: (data: unknown) => unknown;
81
84
  * would risk leaking unsanitized fields (e.g. `hash`/`salt`) that the handler
82
85
  * was supposed to strip.
83
86
  */
87
+ /** @internal */
84
88
  export declare const serializeDoc: (entry: RealtimeRegistryEntry, doc: Record<string, unknown>, method: "create" | "update" | "delete", user?: User) => Promise<unknown>;
85
89
  /**
86
90
  * Generalized authorized-room emitter: iterates the sockets in `room`, runs the per-socket
@@ -100,6 +104,7 @@ export declare const emitPayloadToAuthorizedRoom: ({ io, room, eventName, entry,
100
104
  buildPayload: (user: User | undefined) => Promise<unknown> | unknown;
101
105
  logDebug: (msg: string) => void;
102
106
  }) => Promise<void>;
107
+ /** @internal */
103
108
  export declare const emitToAuthorizedRoom: (io: Server, room: string, event: RealtimeEvent, entry: RealtimeRegistryEntry, fullDocument: Record<string, unknown> | undefined, logDebug: (msg: string) => void) => Promise<void>;
104
109
  /**
105
110
  * Emit a sync event to document-specific and query rooms.
@@ -117,6 +122,7 @@ export declare const emitToAuthorizedRoom: (io: Server, room: string, event: Rea
117
122
  *
118
123
  * Exported for testing.
119
124
  */
125
+ /** @internal */
120
126
  export declare const emitToDocumentAndQueryRooms: (io: Server, collection: string, event: RealtimeEvent, fullDocument: Record<string, unknown> | undefined, logDebug: (msg: string) => void, entry?: RealtimeRegistryEntry) => Promise<void>;
121
127
  /**
122
128
  * Emit `sync:delta` events for a change on a sync-registered collection.