@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,15 +1,4 @@
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
2
  var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
14
3
  if (k2 === undefined) k2 = k;
15
4
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -43,58 +32,22 @@ var __importStar = (this && this.__importStar) || (function () {
43
32
  return result;
44
33
  };
45
34
  })();
46
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
47
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
48
- return new (P || (P = Promise))(function (resolve, reject) {
49
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
50
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
51
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
52
- step((generator = generator.apply(thisArg, _arguments || [])).next());
53
- });
54
- };
55
- var __generator = (this && this.__generator) || function (thisArg, body) {
56
- 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);
57
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
58
- function verb(n) { return function (v) { return step([n, v]); }; }
59
- function step(op) {
60
- if (f) throw new TypeError("Generator is already executing.");
61
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
62
- 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;
63
- if (y = 0, t) op = [op[0] & 2, t.value];
64
- switch (op[0]) {
65
- case 0: case 1: t = op; break;
66
- case 4: _.label++; return { value: op[1], done: false };
67
- case 5: _.label++; y = op[1]; op = [0]; continue;
68
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
69
- default:
70
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
71
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
72
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
73
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
74
- if (t[2]) _.ops.pop();
75
- _.trys.pop(); continue;
76
- }
77
- op = body.call(thisArg, _);
78
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
79
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
80
- }
81
- };
82
35
  Object.defineProperty(exports, "__esModule", { value: true });
83
36
  exports.RealtimeApp = exports.installRealtimeSocketHandlers = exports.redactCredentials = exports.MAX_QUERY_SUBSCRIPTIONS = exports.MAX_DOCUMENT_SUBSCRIPTIONS = exports.MAX_MODEL_SUBSCRIPTIONS = void 0;
84
- var Sentry = __importStar(require("@sentry/bun"));
85
- var socket_io_1 = require("socket.io");
86
- var errors_1 = require("../errors");
87
- var logger_1 = require("../logger");
88
- var realtimeAccess_1 = require("../rbac/realtimeAccess");
89
- var registry_1 = require("../sync/registry");
90
- var socketHandlers_1 = require("../sync/socketHandlers");
91
- var syncApp_1 = require("../sync/syncApp");
92
- var changeStreamWatcher_1 = require("./changeStreamWatcher");
93
- var queryStore_1 = require("./queryStore");
94
- var registry_2 = require("./registry");
95
- var sessionRevalidation_1 = require("./sessionRevalidation");
96
- var socketAuth_1 = require("./socketAuth");
97
- var socketUser_1 = require("./socketUser");
37
+ const Sentry = __importStar(require("@sentry/bun"));
38
+ const socket_io_1 = require("socket.io");
39
+ const errors_1 = require("../errors");
40
+ const logger_1 = require("../logger");
41
+ const realtimeAccess_1 = require("../rbac/realtimeAccess");
42
+ const registry_1 = require("../sync/registry");
43
+ const socketHandlers_1 = require("../sync/socketHandlers");
44
+ const syncApp_1 = require("../sync/syncApp");
45
+ const changeStreamWatcher_1 = require("./changeStreamWatcher");
46
+ const queryStore_1 = require("./queryStore");
47
+ const registry_2 = require("./registry");
48
+ const sessionRevalidation_1 = require("./sessionRevalidation");
49
+ const socketAuth_1 = require("./socketAuth");
50
+ const socketUser_1 = require("./socketUser");
98
51
  /**
99
52
  * Caps on per-socket subscriptions. Prevents a malicious or buggy client from
100
53
  * exhausting server memory by opening unbounded subscriptions.
@@ -109,58 +62,46 @@ exports.MAX_QUERY_SUBSCRIPTIONS = 100;
109
62
  *
110
63
  * Exported for testing.
111
64
  */
112
- var redactCredentials = function (url) {
65
+ /** @internal */
66
+ const redactCredentials = (url) => {
113
67
  try {
114
- var parsed = new URL(url);
68
+ const parsed = new URL(url);
115
69
  if (parsed.username || parsed.password) {
116
70
  parsed.username = "";
117
71
  parsed.password = "";
118
72
  // URL serialization drops the empty userinfo; reinsert a sentinel so logs make it
119
73
  // obvious credentials were stripped rather than silently absent from the source URL.
120
- return parsed.toString().replace("".concat(parsed.protocol, "//"), "".concat(parsed.protocol, "//***@"));
74
+ return parsed.toString().replace(`${parsed.protocol}//`, `${parsed.protocol}//***@`);
121
75
  }
122
76
  return parsed.toString();
123
77
  }
124
- catch (_a) {
78
+ catch {
125
79
  return url.replace(/^(\w+):\/\/[^@/]*@/, "$1://***@");
126
80
  }
127
81
  };
128
82
  exports.redactCredentials = redactCredentials;
129
- var canSubscribe = function (entry, method, user) { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
130
- return [2 /*return*/, (0, realtimeAccess_1.canSubscribeRealtime)(entry, method, user)];
131
- }); }); };
132
- var getAuthorizedQuery = function (entry, query, user) { return __awaiter(void 0, void 0, void 0, function () {
133
- var filteredQuery, error_1;
134
- return __generator(this, function (_a) {
135
- switch (_a.label) {
136
- case 0: return [4 /*yield*/, canSubscribe(entry, "list", user)];
137
- case 1:
138
- if (!(_a.sent())) {
139
- return [2 /*return*/, null];
140
- }
141
- if (!entry.options.queryFilter) {
142
- return [2 /*return*/, query];
143
- }
144
- _a.label = 2;
145
- case 2:
146
- _a.trys.push([2, 4, , 5]);
147
- return [4 /*yield*/, entry.options.queryFilter(user, query)];
148
- case 3:
149
- filteredQuery = _a.sent();
150
- return [3 /*break*/, 5];
151
- case 4:
152
- error_1 = _a.sent();
153
- logger_1.logger.error("[realtime] queryFilter threw for ".concat(entry.modelName, "/list: ").concat(error_1, ". Denying query subscription."));
154
- Sentry.captureException(error_1);
155
- return [2 /*return*/, null];
156
- case 5:
157
- if (filteredQuery === null) {
158
- return [2 /*return*/, null];
159
- }
160
- return [2 /*return*/, __assign(__assign({}, query), filteredQuery)];
161
- }
162
- });
163
- }); };
83
+ const canSubscribe = async (entry, method, user) => (0, realtimeAccess_1.canSubscribeRealtime)(entry, method, user);
84
+ const getAuthorizedQuery = async (entry, query, user) => {
85
+ if (!(await canSubscribe(entry, "list", user))) {
86
+ return null;
87
+ }
88
+ if (!entry.options.queryFilter) {
89
+ return query;
90
+ }
91
+ let filteredQuery;
92
+ try {
93
+ filteredQuery = await entry.options.queryFilter(user, query);
94
+ }
95
+ catch (error) {
96
+ logger_1.logger.error(`[realtime] queryFilter threw for ${entry.modelName}/list: ${error}. Denying query subscription.`);
97
+ Sentry.captureException(error);
98
+ return null;
99
+ }
100
+ if (filteredQuery === null) {
101
+ return null;
102
+ }
103
+ return { ...query, ...filteredQuery };
104
+ };
164
105
  /**
165
106
  * Install the realtime subscription handlers on a single socket. Extracted from the
166
107
  * RealtimeApp connection handler so this logic can be unit-tested with a mock socket
@@ -172,228 +113,155 @@ var getAuthorizedQuery = function (entry, query, user) { return __awaiter(void 0
172
113
  * - owner-strategy isolation (non-admin users cannot subscribe to other users' rooms)
173
114
  * - server-side queryId computation (clients can't hijack queries by colliding ids)
174
115
  */
175
- var installRealtimeSocketHandlers = function (socket, options) {
176
- var _a, _b, _c;
177
- if (options === void 0) { options = {}; }
178
- var logInfo = (_a = options.logInfo) !== null && _a !== void 0 ? _a : (function () { });
179
- var userId = (_b = socket.decodedToken) === null || _b === void 0 ? void 0 : _b.id;
180
- var isAdmin = ((_c = socket.decodedToken) === null || _c === void 0 ? void 0 : _c.admin) === true;
116
+ const installRealtimeSocketHandlers = (socket, options = {}) => {
117
+ const logInfo = options.logInfo ?? (() => { });
118
+ const userId = socket.decodedToken?.id;
119
+ const isAdmin = socket.decodedToken?.admin === true;
181
120
  // D2: re-derive per event rather than capturing once at install time, so a
182
121
  // handshake-time-loaded full user (or one refreshed by D1's sweep) is always used.
183
- var currentUser = function () { return (0, socketUser_1.getSocketUser)(socket); };
184
- var counts = { document: 0, model: 0, query: 0 };
185
- var joinUserRooms = function () { return __awaiter(void 0, void 0, void 0, function () {
186
- return __generator(this, function (_a) {
187
- switch (_a.label) {
188
- case 0:
189
- if (!userId) return [3 /*break*/, 3];
190
- return [4 /*yield*/, socket.join("user:".concat(userId))];
191
- case 1:
192
- _a.sent();
193
- return [4 /*yield*/, socket.join("authenticated")];
194
- case 2:
195
- _a.sent();
196
- logInfo("[realtime] User ".concat(userId, " connected"));
197
- _a.label = 3;
198
- case 3:
199
- if (!isAdmin) return [3 /*break*/, 5];
200
- return [4 /*yield*/, socket.join("admin")];
201
- case 4:
202
- _a.sent();
203
- logInfo("[realtime] Admin user ".concat(userId, " joined admin room"));
204
- _a.label = 5;
205
- case 5: return [2 /*return*/];
206
- }
207
- });
208
- }); };
122
+ const currentUser = () => (0, socketUser_1.getSocketUser)(socket);
123
+ const counts = { document: 0, model: 0, query: 0 };
124
+ const joinUserRooms = async () => {
125
+ if (userId) {
126
+ await socket.join(`user:${userId}`);
127
+ await socket.join("authenticated");
128
+ logInfo(`[realtime] User ${userId} connected`);
129
+ }
130
+ if (isAdmin) {
131
+ await socket.join("admin");
132
+ logInfo(`[realtime] Admin user ${userId} joined admin room`);
133
+ }
134
+ };
209
135
  // Fire-and-forget — there is nothing useful for the caller to await.
210
136
  void joinUserRooms();
211
- socket.on("subscribe:model", function (modelName) { return __awaiter(void 0, void 0, void 0, function () {
212
- var entry;
213
- return __generator(this, function (_a) {
214
- switch (_a.label) {
215
- case 0:
216
- if (typeof modelName !== "string" || modelName.length === 0) {
217
- return [2 /*return*/];
218
- }
219
- if (counts.model >= exports.MAX_MODEL_SUBSCRIPTIONS) {
220
- logInfo("[realtime] User ".concat(userId, " hit model subscription limit"));
221
- return [2 /*return*/];
222
- }
223
- entry = (0, registry_2.findRegistryEntryByRoutePath)(modelName);
224
- if (!entry) {
225
- logInfo("[realtime] User ".concat(userId, " denied model subscription: collection \"").concat(modelName, "\" not registered"));
226
- return [2 /*return*/];
227
- }
228
- // Owner-strategy models fan out via user:{ownerId} — there is no shared model room
229
- // that should be open to all users. Owners receive events through their user room
230
- // automatically; admins can use the admin room to see everything.
231
- if (entry.config.roomStrategy === "owner" && !isAdmin) {
232
- logInfo("[realtime] User ".concat(userId, " denied model subscription for ").concat(modelName, ": ") +
233
- "owner strategy restricts model room to admins");
234
- return [2 /*return*/];
235
- }
236
- return [4 /*yield*/, canSubscribe(entry, "list", currentUser())];
237
- case 1:
238
- if (!(_a.sent())) {
239
- logInfo("[realtime] User ".concat(userId, " denied model subscription for ").concat(modelName, ": list permission denied"));
240
- return [2 /*return*/];
241
- }
242
- counts.model += 1;
243
- return [4 /*yield*/, socket.join("model:".concat(modelName))];
244
- case 2:
245
- _a.sent();
246
- logInfo("[realtime] User ".concat(userId, " subscribed to model:").concat(modelName));
247
- return [2 /*return*/];
248
- }
249
- });
250
- }); });
251
- socket.on("unsubscribe:model", function (modelName) { return __awaiter(void 0, void 0, void 0, function () {
252
- return __generator(this, function (_a) {
253
- switch (_a.label) {
254
- case 0:
255
- if (!(typeof modelName === "string" && modelName.length > 0)) return [3 /*break*/, 2];
256
- return [4 /*yield*/, socket.leave("model:".concat(modelName))];
257
- case 1:
258
- _a.sent();
259
- counts.model = Math.max(0, counts.model - 1);
260
- logInfo("[realtime] User ".concat(userId, " unsubscribed from model:").concat(modelName));
261
- _a.label = 2;
262
- case 2: return [2 /*return*/];
263
- }
264
- });
265
- }); });
266
- socket.on("subscribe:document", function (payload) { return __awaiter(void 0, void 0, void 0, function () {
267
- var entry, room;
268
- return __generator(this, function (_a) {
269
- switch (_a.label) {
270
- case 0:
271
- if (!(payload === null || payload === void 0 ? void 0 : payload.collection) ||
272
- !(payload === null || payload === void 0 ? void 0 : payload.id) ||
273
- typeof payload.collection !== "string" ||
274
- typeof payload.id !== "string") {
275
- return [2 /*return*/];
276
- }
277
- if (counts.document >= exports.MAX_DOCUMENT_SUBSCRIPTIONS) {
278
- logInfo("[realtime] User ".concat(userId, " hit document subscription limit"));
279
- return [2 /*return*/];
280
- }
281
- entry = (0, registry_2.findRegistryEntryByRoutePath)(payload.collection);
282
- if (!entry) {
283
- logInfo("[realtime] User ".concat(userId, " denied document subscription: ") +
284
- "collection \"".concat(payload.collection, "\" not registered"));
285
- return [2 /*return*/];
286
- }
287
- return [4 /*yield*/, canSubscribe(entry, "read", currentUser())];
288
- case 1:
289
- if (!(_a.sent())) {
290
- logInfo("[realtime] User ".concat(userId, " denied document subscription for ") +
291
- "".concat(payload.collection, "/").concat(payload.id, ": read permission denied"));
292
- return [2 /*return*/];
293
- }
294
- if (entry.config.roomStrategy === "owner" && !isAdmin) {
295
- logInfo("[realtime] User ".concat(userId, " denied document subscription for ") +
296
- "".concat(payload.collection, "/").concat(payload.id, ": owner strategy requires admin"));
297
- return [2 /*return*/];
298
- }
299
- counts.document += 1;
300
- room = "document:".concat(payload.collection, ":").concat(payload.id);
301
- return [4 /*yield*/, socket.join(room)];
302
- case 2:
303
- _a.sent();
304
- logInfo("[realtime] User ".concat(userId, " subscribed to ").concat(room));
305
- return [2 /*return*/];
306
- }
307
- });
308
- }); });
309
- socket.on("unsubscribe:document", function (payload) { return __awaiter(void 0, void 0, void 0, function () {
310
- var room;
311
- return __generator(this, function (_a) {
312
- switch (_a.label) {
313
- case 0:
314
- if (!((payload === null || payload === void 0 ? void 0 : payload.collection) && (payload === null || payload === void 0 ? void 0 : payload.id))) return [3 /*break*/, 2];
315
- room = "document:".concat(payload.collection, ":").concat(payload.id);
316
- return [4 /*yield*/, socket.leave(room)];
317
- case 1:
318
- _a.sent();
319
- counts.document = Math.max(0, counts.document - 1);
320
- logInfo("[realtime] User ".concat(userId, " unsubscribed from ").concat(room));
321
- _a.label = 2;
322
- case 2: return [2 /*return*/];
323
- }
324
- });
325
- }); });
326
- socket.on("subscribe:query", function (payload) { return __awaiter(void 0, void 0, void 0, function () {
327
- var entry, query, queryId;
328
- return __generator(this, function (_a) {
329
- switch (_a.label) {
330
- case 0:
331
- if (!(payload === null || payload === void 0 ? void 0 : payload.collection) ||
332
- !(payload === null || payload === void 0 ? void 0 : payload.query) ||
333
- typeof payload.collection !== "string" ||
334
- typeof payload.query !== "object" ||
335
- Array.isArray(payload.query)) {
336
- return [2 /*return*/];
337
- }
338
- if (counts.query >= exports.MAX_QUERY_SUBSCRIPTIONS) {
339
- logInfo("[realtime] User ".concat(userId, " hit query subscription limit"));
340
- return [2 /*return*/];
341
- }
342
- entry = (0, registry_2.findRegistryEntryByRoutePath)(payload.collection);
343
- if (!entry) {
344
- logInfo("[realtime] User ".concat(userId, " denied query subscription: ") +
345
- "collection \"".concat(payload.collection, "\" not registered"));
346
- return [2 /*return*/];
347
- }
348
- return [4 /*yield*/, getAuthorizedQuery(entry, __assign({}, payload.query), currentUser())];
349
- case 1:
350
- query = _a.sent();
351
- if (!query) {
352
- logInfo("[realtime] User ".concat(userId, " denied query subscription for ").concat(payload.collection, ": ") +
353
- "list permission or query filter denied");
354
- return [2 /*return*/];
355
- }
356
- if (entry.config.roomStrategy === "owner" && !isAdmin) {
357
- if (!userId) {
358
- return [2 /*return*/];
359
- }
360
- query = __assign(__assign({}, query), { ownerId: userId });
361
- }
362
- queryId = (0, queryStore_1.computeQueryId)(payload.collection, query);
363
- (0, queryStore_1.addQuerySubscription)(socket.id, payload.collection, query, queryId);
364
- counts.query += 1;
365
- return [4 /*yield*/, socket.join("query:".concat(queryId))];
366
- case 2:
367
- _a.sent();
368
- socket.emit("query:subscribed", {
369
- clientQueryId: payload.queryId,
370
- collection: payload.collection,
371
- queryId: queryId,
372
- });
373
- logInfo("[realtime] User ".concat(userId, " subscribed to query:").concat(queryId, " on ").concat(payload.collection));
374
- return [2 /*return*/];
375
- }
376
- });
377
- }); });
378
- socket.on("unsubscribe:query", function (payload) { return __awaiter(void 0, void 0, void 0, function () {
379
- return __generator(this, function (_a) {
380
- switch (_a.label) {
381
- case 0:
382
- if (!(payload === null || payload === void 0 ? void 0 : payload.queryId)) return [3 /*break*/, 2];
383
- (0, queryStore_1.removeQuerySubscription)(socket.id, payload.queryId);
384
- return [4 /*yield*/, socket.leave("query:".concat(payload.queryId))];
385
- case 1:
386
- _a.sent();
387
- counts.query = Math.max(0, counts.query - 1);
388
- logInfo("[realtime] User ".concat(userId, " unsubscribed from query:").concat(payload.queryId));
389
- _a.label = 2;
390
- case 2: return [2 /*return*/];
137
+ socket.on("subscribe:model", async (modelName) => {
138
+ if (typeof modelName !== "string" || modelName.length === 0) {
139
+ return;
140
+ }
141
+ if (counts.model >= exports.MAX_MODEL_SUBSCRIPTIONS) {
142
+ logInfo(`[realtime] User ${userId} hit model subscription limit`);
143
+ return;
144
+ }
145
+ const entry = (0, registry_2.findRegistryEntryByRoutePath)(modelName);
146
+ if (!entry) {
147
+ logInfo(`[realtime] User ${userId} denied model subscription: collection "${modelName}" not registered`);
148
+ return;
149
+ }
150
+ // Owner-strategy models fan out via user:{ownerId} — there is no shared model room
151
+ // that should be open to all users. Owners receive events through their user room
152
+ // automatically; admins can use the admin room to see everything.
153
+ if (entry.config.roomStrategy === "owner" && !isAdmin) {
154
+ logInfo(`[realtime] User ${userId} denied model subscription for ${modelName}: ` +
155
+ "owner strategy restricts model room to admins");
156
+ return;
157
+ }
158
+ if (!(await canSubscribe(entry, "list", currentUser()))) {
159
+ logInfo(`[realtime] User ${userId} denied model subscription for ${modelName}: list permission denied`);
160
+ return;
161
+ }
162
+ counts.model += 1;
163
+ await socket.join(`model:${modelName}`);
164
+ logInfo(`[realtime] User ${userId} subscribed to model:${modelName}`);
165
+ });
166
+ socket.on("unsubscribe:model", async (modelName) => {
167
+ if (typeof modelName === "string" && modelName.length > 0) {
168
+ await socket.leave(`model:${modelName}`);
169
+ counts.model = Math.max(0, counts.model - 1);
170
+ logInfo(`[realtime] User ${userId} unsubscribed from model:${modelName}`);
171
+ }
172
+ });
173
+ socket.on("subscribe:document", async (payload) => {
174
+ if (!payload?.collection ||
175
+ !payload?.id ||
176
+ typeof payload.collection !== "string" ||
177
+ typeof payload.id !== "string") {
178
+ return;
179
+ }
180
+ if (counts.document >= exports.MAX_DOCUMENT_SUBSCRIPTIONS) {
181
+ logInfo(`[realtime] User ${userId} hit document subscription limit`);
182
+ return;
183
+ }
184
+ const entry = (0, registry_2.findRegistryEntryByRoutePath)(payload.collection);
185
+ if (!entry) {
186
+ logInfo(`[realtime] User ${userId} denied document subscription: ` +
187
+ `collection "${payload.collection}" not registered`);
188
+ return;
189
+ }
190
+ if (!(await canSubscribe(entry, "read", currentUser()))) {
191
+ logInfo(`[realtime] User ${userId} denied document subscription for ` +
192
+ `${payload.collection}/${payload.id}: read permission denied`);
193
+ return;
194
+ }
195
+ if (entry.config.roomStrategy === "owner" && !isAdmin) {
196
+ logInfo(`[realtime] User ${userId} denied document subscription for ` +
197
+ `${payload.collection}/${payload.id}: owner strategy requires admin`);
198
+ return;
199
+ }
200
+ counts.document += 1;
201
+ const room = `document:${payload.collection}:${payload.id}`;
202
+ await socket.join(room);
203
+ logInfo(`[realtime] User ${userId} subscribed to ${room}`);
204
+ });
205
+ socket.on("unsubscribe:document", async (payload) => {
206
+ if (payload?.collection && payload?.id) {
207
+ const room = `document:${payload.collection}:${payload.id}`;
208
+ await socket.leave(room);
209
+ counts.document = Math.max(0, counts.document - 1);
210
+ logInfo(`[realtime] User ${userId} unsubscribed from ${room}`);
211
+ }
212
+ });
213
+ socket.on("subscribe:query", async (payload) => {
214
+ if (!payload?.collection ||
215
+ !payload?.query ||
216
+ typeof payload.collection !== "string" ||
217
+ typeof payload.query !== "object" ||
218
+ Array.isArray(payload.query)) {
219
+ return;
220
+ }
221
+ if (counts.query >= exports.MAX_QUERY_SUBSCRIPTIONS) {
222
+ logInfo(`[realtime] User ${userId} hit query subscription limit`);
223
+ return;
224
+ }
225
+ const entry = (0, registry_2.findRegistryEntryByRoutePath)(payload.collection);
226
+ if (!entry) {
227
+ logInfo(`[realtime] User ${userId} denied query subscription: ` +
228
+ `collection "${payload.collection}" not registered`);
229
+ return;
230
+ }
231
+ let query = await getAuthorizedQuery(entry, { ...payload.query }, currentUser());
232
+ if (!query) {
233
+ logInfo(`[realtime] User ${userId} denied query subscription for ${payload.collection}: ` +
234
+ "list permission or query filter denied");
235
+ return;
236
+ }
237
+ if (entry.config.roomStrategy === "owner" && !isAdmin) {
238
+ if (!userId) {
239
+ return;
391
240
  }
241
+ query = { ...query, ownerId: userId };
242
+ }
243
+ const queryId = (0, queryStore_1.computeQueryId)(payload.collection, query);
244
+ (0, queryStore_1.addQuerySubscription)(socket.id, payload.collection, query, queryId);
245
+ counts.query += 1;
246
+ await socket.join(`query:${queryId}`);
247
+ socket.emit("query:subscribed", {
248
+ clientQueryId: payload.queryId,
249
+ collection: payload.collection,
250
+ queryId,
392
251
  });
393
- }); });
394
- socket.on("disconnect", function () {
252
+ logInfo(`[realtime] User ${userId} subscribed to query:${queryId} on ${payload.collection}`);
253
+ });
254
+ socket.on("unsubscribe:query", async (payload) => {
255
+ if (payload?.queryId) {
256
+ (0, queryStore_1.removeQuerySubscription)(socket.id, payload.queryId);
257
+ await socket.leave(`query:${payload.queryId}`);
258
+ counts.query = Math.max(0, counts.query - 1);
259
+ logInfo(`[realtime] User ${userId} unsubscribed from query:${payload.queryId}`);
260
+ }
261
+ });
262
+ socket.on("disconnect", () => {
395
263
  (0, queryStore_1.removeAllSocketQueries)(socket.id);
396
- logInfo("[realtime] User ".concat(userId, " disconnected"));
264
+ logInfo(`[realtime] User ${userId} disconnected`);
397
265
  });
398
266
  };
399
267
  exports.installRealtimeSocketHandlers = installRealtimeSocketHandlers;
@@ -421,39 +289,35 @@ exports.installRealtimeSocketHandlers = installRealtimeSocketHandlers;
421
289
  * .start();
422
290
  * ```
423
291
  */
424
- var RealtimeApp = /** @class */ (function () {
425
- function RealtimeApp(config) {
426
- if (config === void 0) { config = {}; }
427
- this.app = null;
428
- this.io = null;
429
- this.sessionRevalidation = null;
292
+ class RealtimeApp {
293
+ app = null;
294
+ io = null;
295
+ config;
296
+ sessionRevalidation = null;
297
+ constructor(config = {}) {
430
298
  this.config = config;
431
299
  }
432
300
  /**
433
301
  * Register routes and middleware. Adds a /realtime/health endpoint.
434
302
  */
435
- RealtimeApp.prototype.register = function (app) {
436
- var _this = this;
303
+ register(app) {
437
304
  this.app = app;
438
- app.get("/realtime/health", function (_req, res) {
439
- var _a, _b, _c, _d;
440
- var connected = (_c = (_b = (_a = _this.io) === null || _a === void 0 ? void 0 : _a.engine) === null || _b === void 0 ? void 0 : _b.clientsCount) !== null && _c !== void 0 ? _c : 0;
305
+ app.get("/realtime/health", (_req, res) => {
306
+ const connected = this.io?.engine?.clientsCount ?? 0;
441
307
  res.json({
442
308
  clients: connected,
443
- debug: (_d = _this.config.debug) !== null && _d !== void 0 ? _d : false,
444
- status: _this.io ? "running" : "not_started",
309
+ debug: this.config.debug ?? false,
310
+ status: this.io ? "running" : "not_started",
445
311
  });
446
312
  });
447
- };
313
+ }
448
314
  /**
449
315
  * Called after the HTTP server is created. Sets up Socket.io, auth, rooms,
450
316
  * and starts the change stream watcher.
451
317
  */
452
- RealtimeApp.prototype.onServerCreated = function (server) {
453
- var _this = this;
454
- var _a, _b, _c, _d, _e;
455
- var debug = (_a = this.config.debug) !== null && _a !== void 0 ? _a : false;
456
- var logInfo = function (message) {
318
+ onServerCreated(server) {
319
+ const debug = this.config.debug ?? false;
320
+ const logInfo = (message) => {
457
321
  if (debug) {
458
322
  logger_1.logger.info(message);
459
323
  }
@@ -462,15 +326,15 @@ var RealtimeApp = /** @class */ (function () {
462
326
  logInfo("[realtime] Setting up Socket.io server...");
463
327
  // Prefer an injected Server constructor in tests so callers never need
464
328
  // process-wide `mock.module("socket.io")` (which poisons later files).
465
- var SocketServerCtor = (_b = this.config.SocketServer) !== null && _b !== void 0 ? _b : socket_io_1.Server;
329
+ const SocketServerCtor = this.config.SocketServer ?? socket_io_1.Server;
466
330
  this.io = new SocketServerCtor(server, {
467
- cors: (_c = this.config.cors) !== null && _c !== void 0 ? _c : {
331
+ cors: this.config.cors ?? {
468
332
  methods: ["GET", "POST"],
469
333
  origin: "*",
470
334
  },
471
335
  });
472
336
  // Authentication middleware: legacy JWT first when configured, optionally Better Auth sessions.
473
- var tokenSecret = (_d = this.config.tokenSecret) !== null && _d !== void 0 ? _d : process.env.TOKEN_SECRET;
337
+ const tokenSecret = this.config.tokenSecret ?? process.env.TOKEN_SECRET;
474
338
  if (!tokenSecret && !this.config.betterAuth) {
475
339
  throw new errors_1.APIError({
476
340
  status: 500,
@@ -484,12 +348,16 @@ var RealtimeApp = /** @class */ (function () {
484
348
  // thunk (not a value captured once here) so a later change to
485
349
  // process.env.TOKEN_ISSUER — or to an explicitly configured tokenIssuer — is
486
350
  // honored on every handshake, matching the HTTP path's per-request env read.
487
- var resolveTokenIssuer = function () { var _a; return (_a = _this.config.tokenIssuer) !== null && _a !== void 0 ? _a : process.env.TOKEN_ISSUER; };
488
- this.io.use((0, socketAuth_1.createSocketAuthMiddleware)(__assign({ betterAuth: this.config.betterAuth, issuer: resolveTokenIssuer }, (tokenSecret ? { tokenSecret: tokenSecret } : {}))));
489
- var authKinds = [tokenSecret ? "JWT" : null, this.config.betterAuth ? "Better Auth" : null]
351
+ const resolveTokenIssuer = () => this.config.tokenIssuer ?? process.env.TOKEN_ISSUER;
352
+ this.io.use((0, socketAuth_1.createSocketAuthMiddleware)({
353
+ betterAuth: this.config.betterAuth,
354
+ issuer: resolveTokenIssuer,
355
+ tokenSecret,
356
+ }));
357
+ const authKinds = [tokenSecret ? "JWT" : null, this.config.betterAuth ? "Better Auth" : null]
490
358
  .filter(Boolean)
491
359
  .join(" + ");
492
- logInfo("[realtime] Socket auth middleware added (".concat(authKinds, ")"));
360
+ logInfo(`[realtime] Socket auth middleware added (${authKinds})`);
493
361
  // Task 9.21: tenant/custom sync scopes can only be resolved from the full user
494
362
  // document, so warn loudly here (once, at startup) rather than silently serving
495
363
  // empty tenant streams for the life of the process.
@@ -497,106 +365,86 @@ var RealtimeApp = /** @class */ (function () {
497
365
  // Configure adapter for multi-instance deployments
498
366
  this.setupAdapter(logInfo);
499
367
  // Connection handling
500
- this.io.on("connection", function (socket) {
501
- var _a, _b;
368
+ this.io.on("connection", (socket) => {
502
369
  try {
503
370
  // D2: load the full user document once at handshake (by the decoded
504
371
  // token's id) and cache it on socket.data.fullUser — getSocketUser prefers
505
372
  // it over the synthetic {_id, admin, id} shape for every authorization
506
373
  // check below. Fire-and-forget: handlers install synchronously and fall
507
374
  // back to the synthetic shape until this resolves.
508
- void (0, sessionRevalidation_1.loadFullUserForSocket)(socket, _this.config.userModel);
375
+ void (0, sessionRevalidation_1.loadFullUserForSocket)(socket, this.config.userModel);
509
376
  // The auth middleware adds `decodedToken` at runtime; cast through
510
377
  // RealtimeSocketLike (a structural subset) to keep socket handler logic testable.
511
- (0, exports.installRealtimeSocketHandlers)(socket, { logInfo: logInfo });
378
+ (0, exports.installRealtimeSocketHandlers)(socket, { logInfo });
512
379
  // Sync protocol handlers (sync:subscribe / sync:mutate). Options come from the
513
380
  // SyncApp registered on this Express app or an explicit `sync` override here;
514
381
  // with neither, the handlers still install and reject unknown collections.
515
- (0, socketHandlers_1.installSyncSocketHandlers)(_this.io, socket, (_b = (_a = _this.config.sync) !== null && _a !== void 0 ? _a : (_this.app ? (0, syncApp_1.getSyncAppOptions)(_this.app) : undefined)) !== null && _b !== void 0 ? _b : {}, { logInfo: logInfo });
382
+ (0, socketHandlers_1.installSyncSocketHandlers)(this.io, socket, this.config.sync ?? (this.app ? (0, syncApp_1.getSyncAppOptions)(this.app) : undefined) ?? {}, { logInfo });
516
383
  }
517
384
  catch (error) {
518
- logger_1.logger.error("[realtime] Error handling connection: ".concat(error));
385
+ logger_1.logger.error(`[realtime] Error handling connection: ${error}`);
519
386
  Sentry.captureException(error);
520
387
  }
521
388
  });
522
- this.io.on("connect_error", function (error) {
523
- logger_1.logger.error("[realtime] Connection error: ".concat(error.message));
389
+ this.io.on("connect_error", (error) => {
390
+ logger_1.logger.error(`[realtime] Connection error: ${error.message}`);
524
391
  Sentry.captureException(error);
525
392
  });
526
393
  // Start the change stream watcher (injectable for unit tests — see SocketServer).
527
- var startWatcher = (_e = this.config.startChangeStreamWatcher) !== null && _e !== void 0 ? _e : changeStreamWatcher_1.startChangeStreamWatcher;
394
+ const startWatcher = this.config.startChangeStreamWatcher ?? changeStreamWatcher_1.startChangeStreamWatcher;
528
395
  startWatcher(this.io, this.config.changeStream, debug);
529
396
  // D1: periodic session re-validation sweep — disconnects sockets whose JWT has
530
397
  // expired, whose Better Auth session is no longer valid, or whose user has
531
398
  // since been disabled; also refreshes socket.data.fullUser (D2) and
532
399
  // re-resolves sync room membership (D4) for sockets that remain valid.
533
400
  // A thunk (not a snapshot) reads this app's SyncApp options fresh on every sweep.
534
- this.sessionRevalidation = (0, sessionRevalidation_1.startSessionRevalidationSweep)(this.io, function () {
535
- var _a;
536
- return ({
537
- betterAuth: _this.config.betterAuth,
538
- intervalMs: _this.config.sessionRevalidationIntervalMs,
539
- logInfo: logInfo,
540
- sync: (_a = _this.config.sync) !== null && _a !== void 0 ? _a : (_this.app ? (0, syncApp_1.getSyncAppOptions)(_this.app) : undefined),
541
- userModel: _this.config.userModel,
542
- });
543
- });
401
+ this.sessionRevalidation = (0, sessionRevalidation_1.startSessionRevalidationSweep)(this.io, () => ({
402
+ betterAuth: this.config.betterAuth,
403
+ intervalMs: this.config.sessionRevalidationIntervalMs,
404
+ logInfo,
405
+ sync: this.config.sync ?? (this.app ? (0, syncApp_1.getSyncAppOptions)(this.app) : undefined),
406
+ userModel: this.config.userModel,
407
+ }));
544
408
  logInfo("[realtime] Socket.io server setup complete");
545
409
  }
546
410
  catch (error) {
547
- logger_1.logger.error("[realtime] Failed to set up Socket.io: ".concat(error));
411
+ logger_1.logger.error(`[realtime] Failed to set up Socket.io: ${error}`);
548
412
  Sentry.captureException(error);
549
413
  throw error;
550
414
  }
551
- };
415
+ }
552
416
  /**
553
417
  * Get the Socket.io server instance.
554
418
  */
555
- RealtimeApp.prototype.getIo = function () {
419
+ getIo() {
556
420
  return this.io;
557
- };
421
+ }
558
422
  /**
559
423
  * Gracefully shut down the real-time server.
560
424
  */
561
- RealtimeApp.prototype.close = function () {
562
- return __awaiter(this, void 0, void 0, function () {
563
- var error_2;
564
- var _a;
565
- return __generator(this, function (_b) {
566
- switch (_b.label) {
567
- case 0:
568
- _b.trys.push([0, 4, , 5]);
569
- (_a = this.sessionRevalidation) === null || _a === void 0 ? void 0 : _a.stop();
570
- this.sessionRevalidation = null;
571
- return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
572
- case 1:
573
- _b.sent();
574
- if (!this.io) return [3 /*break*/, 3];
575
- return [4 /*yield*/, this.io.close()];
576
- case 2:
577
- _b.sent();
578
- this.io = null;
579
- _b.label = 3;
580
- case 3: return [3 /*break*/, 5];
581
- case 4:
582
- error_2 = _b.sent();
583
- logger_1.logger.error("[realtime] Error closing: ".concat(error_2));
584
- return [3 /*break*/, 5];
585
- case 5: return [2 /*return*/];
586
- }
587
- });
588
- });
589
- };
590
- RealtimeApp.prototype.setupAdapter = function (logInfo) {
591
- var _a, _b, _c;
425
+ async close() {
426
+ try {
427
+ this.sessionRevalidation?.stop();
428
+ this.sessionRevalidation = null;
429
+ await (0, changeStreamWatcher_1.stopChangeStreamWatcher)();
430
+ if (this.io) {
431
+ await this.io.close();
432
+ this.io = null;
433
+ }
434
+ }
435
+ catch (error) {
436
+ logger_1.logger.error(`[realtime] Error closing: ${error}`);
437
+ }
438
+ }
439
+ setupAdapter(logInfo) {
592
440
  if (!this.io) {
593
441
  return;
594
442
  }
595
- var adapter = (_a = this.config.adapter) !== null && _a !== void 0 ? _a : "none";
443
+ const adapter = this.config.adapter ?? "none";
596
444
  if (adapter === "redis") {
597
- var redisUrl = (_c = (_b = this.config.redisUrl) !== null && _b !== void 0 ? _b : process.env.VALKEY_URL) !== null && _c !== void 0 ? _c : process.env.REDIS_URL;
445
+ const redisUrl = this.config.redisUrl ?? process.env.VALKEY_URL ?? process.env.REDIS_URL;
598
446
  if (redisUrl) {
599
- logInfo("[realtime] Redis adapter configured with URL: ".concat((0, exports.redactCredentials)(redisUrl)));
447
+ logInfo(`[realtime] Redis adapter configured with URL: ${(0, exports.redactCredentials)(redisUrl)}`);
600
448
  // Redis adapter must be configured externally by the consuming app
601
449
  // since @socket.io/redis-adapter and ioredis are optional peer dependencies.
602
450
  // Use realtimeApp.getIo() to access the Socket.io instance and call
@@ -609,7 +457,6 @@ var RealtimeApp = /** @class */ (function () {
609
457
  }
610
458
  }
611
459
  // 'none' — no adapter, single instance mode
612
- };
613
- return RealtimeApp;
614
- }());
460
+ }
461
+ }
615
462
  exports.RealtimeApp = RealtimeApp;