@terreno/api 57.3.0 → 57.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,155 +1,61 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
37
- };
38
- 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
2
  Object.defineProperty(exports, "__esModule", { value: true });
50
3
  exports.OwnerScope = exports.defineScope = void 0;
51
- var queryMatcher_1 = require("../realtime/queryMatcher");
52
- var projectDocForFieldOf = function (doc, fragment, fieldOf) {
53
- var e_1, _a;
54
- var projected = {};
55
- try {
56
- for (var _b = __values(Object.keys(fragment)), _c = _b.next(); !_c.done; _c = _b.next()) {
57
- var path = _c.value;
58
- projected[path] = fieldOf(doc, path);
59
- }
60
- }
61
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
62
- finally {
63
- try {
64
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
65
- }
66
- finally { if (e_1) throw e_1.error; }
4
+ const queryMatcher_1 = require("../realtime/queryMatcher");
5
+ const projectDocForFieldOf = (doc, fragment, fieldOf) => {
6
+ const projected = {};
7
+ for (const path of Object.keys(fragment)) {
8
+ projected[path] = fieldOf(doc, path);
67
9
  }
68
10
  return projected;
69
11
  };
70
- var defineScope = function (def) {
12
+ const defineScope = (def) => {
71
13
  return {
72
- check: function (args) { return __awaiter(void 0, void 0, void 0, function () {
73
- var _a, fragment, subject;
74
- return __generator(this, function (_b) {
75
- switch (_b.label) {
76
- case 0:
77
- _a = def.adminBypass;
78
- if (!_a) return [3 /*break*/, 2];
79
- return [4 /*yield*/, def.adminBypass(args)];
80
- case 1:
81
- _a = (_b.sent());
82
- _b.label = 2;
83
- case 2:
84
- if (_a) {
85
- return [2 /*return*/, true];
86
- }
87
- return [4 /*yield*/, def.matches(args)];
88
- case 3:
89
- fragment = _b.sent();
90
- if (!fragment) {
91
- return [2 /*return*/, false];
92
- }
93
- if (!args.doc) {
94
- return [2 /*return*/, true];
95
- }
96
- subject = def.fieldOf
97
- ? projectDocForFieldOf(args.doc, fragment, def.fieldOf)
98
- : args.doc;
99
- return [2 /*return*/, (0, queryMatcher_1.matchesQuery)(subject, fragment)];
100
- }
101
- });
102
- }); },
103
- filter: function (args) { return __awaiter(void 0, void 0, void 0, function () {
104
- var _a;
105
- return __generator(this, function (_b) {
106
- switch (_b.label) {
107
- case 0:
108
- _a = def.adminBypass;
109
- if (!_a) return [3 /*break*/, 2];
110
- return [4 /*yield*/, def.adminBypass(args)];
111
- case 1:
112
- _a = (_b.sent());
113
- _b.label = 2;
114
- case 2:
115
- if (_a) {
116
- return [2 /*return*/, {}];
117
- }
118
- return [2 /*return*/, def.matches(args)];
119
- }
120
- });
121
- }); },
14
+ check: async (args) => {
15
+ if (def.adminBypass && (await def.adminBypass(args))) {
16
+ return true;
17
+ }
18
+ const fragment = await def.matches(args);
19
+ if (!fragment) {
20
+ return false;
21
+ }
22
+ if (!args.doc) {
23
+ return true;
24
+ }
25
+ const subject = def.fieldOf
26
+ ? projectDocForFieldOf(args.doc, fragment, def.fieldOf)
27
+ : args.doc;
28
+ return (0, queryMatcher_1.matchesQuery)(subject, fragment);
29
+ },
30
+ filter: async (args) => {
31
+ if (def.adminBypass && (await def.adminBypass(args))) {
32
+ return {};
33
+ }
34
+ return def.matches(args);
35
+ },
122
36
  };
123
37
  };
124
38
  exports.defineScope = defineScope;
125
- var defaultAdminBypass = function (_a) {
126
- var _b;
127
- var user = _a.user;
128
- var withRoles = user;
129
- if (user === null || user === void 0 ? void 0 : user.admin) {
39
+ const defaultAdminBypass = ({ user }) => {
40
+ const withRoles = user;
41
+ if (user?.admin) {
130
42
  return true;
131
43
  }
132
- return Boolean((_b = withRoles === null || withRoles === void 0 ? void 0 : withRoles.roles) === null || _b === void 0 ? void 0 : _b.includes("superadmin"));
44
+ return Boolean(withRoles?.roles?.includes("superadmin"));
133
45
  };
134
- var OwnerScope = function (options) {
135
- if (options === void 0) { options = {}; }
136
- var _a = typeof options === "string" ? { field: options } : options, _b = _a.field, field = _b === void 0 ? "ownerId" : _b, _c = _a.adminBypass, adminBypass = _c === void 0 ? defaultAdminBypass : _c;
46
+ const OwnerScope = (options = {}) => {
47
+ const { field = "ownerId", adminBypass = defaultAdminBypass } = typeof options === "string" ? { field: options } : options;
137
48
  return (0, exports.defineScope)({
138
- adminBypass: function (args) { return adminBypass({ user: args.user }); },
139
- fieldOf: function (doc, path) {
140
- var _a;
49
+ adminBypass: (args) => adminBypass({ user: args.user }),
50
+ fieldOf: (doc, path) => {
141
51
  if (path !== field) {
142
52
  return undefined;
143
53
  }
144
- var owner = doc === null || doc === void 0 ? void 0 : doc[field];
145
- var ownerId = (_a = owner === null || owner === void 0 ? void 0 : owner._id) !== null && _a !== void 0 ? _a : owner;
54
+ const owner = doc?.[field];
55
+ const ownerId = owner?._id ?? owner;
146
56
  return ownerId == null ? undefined : String(ownerId);
147
57
  },
148
- matches: function (_a) {
149
- var _b;
150
- var user = _a.user;
151
- return (user ? (_b = {}, _b[field] = user.id, _b) : null);
152
- },
58
+ matches: ({ user }) => (user ? { [field]: user.id } : null),
153
59
  });
154
60
  };
155
61
  exports.OwnerScope = OwnerScope;
@@ -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
  };
@@ -1,123 +1,72 @@
1
1
  "use strict";
2
- var __assign = (this && this.__assign) || function () {
3
- __assign = Object.assign || function(t) {
4
- for (var s, i = 1, n = arguments.length; i < n; i++) {
5
- s = arguments[i];
6
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
- t[p] = s[p];
8
- }
9
- return t;
10
- };
11
- return __assign.apply(this, arguments);
12
- };
13
- var __values = (this && this.__values) || function(o) {
14
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
15
- if (m) return m.call(o);
16
- if (o && typeof o.length === "number") return {
17
- next: function () {
18
- if (o && i >= o.length) o = void 0;
19
- return { value: o && o[i++], done: !o };
20
- }
21
- };
22
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
23
- };
24
- var __read = (this && this.__read) || function (o, n) {
25
- var m = typeof Symbol === "function" && o[Symbol.iterator];
26
- if (!m) return o;
27
- var i = m.call(o), r, ar = [], e;
28
- try {
29
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
30
- }
31
- catch (error) { e = { error: error }; }
32
- finally {
33
- try {
34
- if (r && !r.done && (m = i["return"])) m.call(i);
35
- }
36
- finally { if (e) throw e.error; }
37
- }
38
- return ar;
39
- };
40
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
41
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
42
- if (ar || !(i in from)) {
43
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
44
- ar[i] = from[i];
45
- }
46
- }
47
- return to.concat(ar || Array.prototype.slice.call(from));
48
- };
49
- var _a;
50
2
  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;
52
- var MODEL_CRUD = ["create", "list", "read", "update", "delete"];
3
+ 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;
4
+ const MODEL_CRUD = ["create", "list", "read", "update", "delete"];
53
5
  exports.ADMIN_MODEL_ACCESS = ["read", "write", "writeOwned"];
54
6
  /** Resource/action that opens the admin panel. Other admin permissions do not grant entry. */
55
7
  exports.ADMIN_PAGE_RESOURCE = "admin";
56
8
  exports.ADMIN_PAGE_ACTION = "access";
57
- exports.ADMIN_PAGE_PERMISSION = (_a = {},
58
- _a[exports.ADMIN_PAGE_RESOURCE] = [exports.ADMIN_PAGE_ACTION],
59
- _a);
9
+ exports.ADMIN_PAGE_PERMISSION = {
10
+ [exports.ADMIN_PAGE_RESOURCE]: [exports.ADMIN_PAGE_ACTION],
11
+ };
12
+ exports.ORGANIZATION_ACTIONS = [
13
+ "create",
14
+ "list",
15
+ "read",
16
+ "update",
17
+ "delete",
18
+ "manageMembers",
19
+ "disable",
20
+ ];
60
21
  exports.terrenoStatements = {
61
- admin: [exports.ADMIN_PAGE_ACTION, "runScripts", "viewBackgroundTasks"],
22
+ admin: [exports.ADMIN_PAGE_ACTION, "jobs", "runScripts", "viewBackgroundTasks"],
23
+ adminAnnouncement: exports.ADMIN_MODEL_ACCESS,
24
+ adminAnnouncementAcknowledgement: exports.ADMIN_MODEL_ACCESS,
25
+ adminAnnouncementClickEvent: exports.ADMIN_MODEL_ACCESS,
26
+ adminAnnouncementImpression: exports.ADMIN_MODEL_ACCESS,
62
27
  adminConsentForm: exports.ADMIN_MODEL_ACCESS,
63
28
  adminConsentResponse: exports.ADMIN_MODEL_ACCESS,
64
29
  adminFeatureFlag: exports.ADMIN_MODEL_ACCESS,
30
+ announcement: MODEL_CRUD,
31
+ announcementAcknowledgement: ["list", "read"],
32
+ announcementImpression: ["list", "read"],
65
33
  configuration: ["read", "update"],
66
34
  consentForm: MODEL_CRUD,
67
35
  consentResponse: ["list", "read"],
68
36
  featureFlag: MODEL_CRUD,
37
+ organization: exports.ORGANIZATION_ACTIONS,
69
38
  rbac: ["read", "manageRoles", "assignRoles"],
70
39
  user: ["create", "list", "read", "update", "delete", "impersonate", "setPassword"],
71
40
  };
72
41
  exports.READ_ACTIONS = ["read", "list", "view"];
73
42
  exports.READ_ONLY_ROLE_PERMISSIONS = { readOnly: true };
74
- var isReadOnlySentinel = function (spec) {
75
- return typeof spec === "object" &&
76
- spec !== null &&
77
- !Array.isArray(spec) &&
78
- Object.keys(spec).length === 1 &&
79
- spec.readOnly === true;
80
- };
81
- var mergeStatements = function (appStatements) {
82
- return __assign(__assign({}, exports.terrenoStatements), appStatements);
43
+ const isReadOnlySentinel = (spec) => typeof spec === "object" &&
44
+ spec !== null &&
45
+ !Array.isArray(spec) &&
46
+ Object.keys(spec).length === 1 &&
47
+ spec.readOnly === true;
48
+ const mergeStatements = (appStatements) => {
49
+ return {
50
+ ...exports.terrenoStatements,
51
+ ...appStatements,
52
+ };
83
53
  };
84
54
  exports.mergeStatements = mergeStatements;
85
- var expandRolePermissions = function (spec, statements, readActions) {
86
- var e_1, _a, e_2, _b;
55
+ const expandRolePermissions = (spec, statements, readActions) => {
87
56
  if (spec === "*") {
88
- var expanded = {};
89
- try {
90
- for (var _c = __values(Object.entries(statements)), _d = _c.next(); !_d.done; _d = _c.next()) {
91
- var _e = __read(_d.value, 2), resource = _e[0], actions = _e[1];
92
- expanded[resource] = __spreadArray([], __read(actions), false);
93
- }
94
- }
95
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
96
- finally {
97
- try {
98
- if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
99
- }
100
- finally { if (e_1) throw e_1.error; }
57
+ const expanded = {};
58
+ for (const [resource, actions] of Object.entries(statements)) {
59
+ expanded[resource] = [...actions];
101
60
  }
102
61
  return expanded;
103
62
  }
104
63
  if (isReadOnlySentinel(spec)) {
105
- var expanded = {};
106
- try {
107
- for (var _f = __values(Object.entries(statements)), _g = _f.next(); !_g.done; _g = _f.next()) {
108
- var _h = __read(_g.value, 2), resource = _h[0], actions = _h[1];
109
- var readish = actions.filter(function (action) { return readActions.includes(action); });
110
- if (readish.length > 0) {
111
- expanded[resource] = readish;
112
- }
113
- }
114
- }
115
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
116
- finally {
117
- try {
118
- if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
64
+ const expanded = {};
65
+ for (const [resource, actions] of Object.entries(statements)) {
66
+ const readish = actions.filter((action) => readActions.includes(action));
67
+ if (readish.length > 0) {
68
+ expanded[resource] = readish;
119
69
  }
120
- finally { if (e_2) throw e_2.error; }
121
70
  }
122
71
  return expanded;
123
72
  }
@@ -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>;
@@ -1,37 +1,11 @@
1
1
  "use strict";
2
- var __read = (this && this.__read) || function (o, n) {
3
- var m = typeof Symbol === "function" && o[Symbol.iterator];
4
- if (!m) return o;
5
- var i = m.call(o), r, ar = [], e;
6
- try {
7
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
8
- }
9
- catch (error) { e = { error: error }; }
10
- finally {
11
- try {
12
- if (r && !r.done && (m = i["return"])) m.call(i);
13
- }
14
- finally { if (e) throw e.error; }
15
- }
16
- return ar;
17
- };
18
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
19
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
20
- if (ar || !(i in from)) {
21
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
22
- ar[i] = from[i];
23
- }
24
- }
25
- return to.concat(ar || Array.prototype.slice.call(from));
26
- };
27
2
  Object.defineProperty(exports, "__esModule", { value: true });
28
3
  exports.rbacUserPlugin = void 0;
29
- var rbacUserPlugin = function (schema, options) {
30
- var _a;
31
- var defaultRoles = __spreadArray([], __read(((_a = options === null || options === void 0 ? void 0 : options.defaultRoles) !== null && _a !== void 0 ? _a : [])), false);
4
+ const rbacUserPlugin = (schema, options) => {
5
+ const defaultRoles = [...(options?.defaultRoles ?? [])];
32
6
  schema.add({
33
7
  roles: {
34
- default: function () { return __spreadArray([], __read(defaultRoles), false); },
8
+ default: () => [...defaultRoles],
35
9
  description: "RBAC role names assigned to this user",
36
10
  index: true,
37
11
  type: [String],
@@ -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.