@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,84 +1,54 @@
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;
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.installSyncSocketHandlers = exports.syncRoomForStream = exports.MAX_SYNC_SUBSCRIBE_ARRAY_LENGTH = exports.MAX_SYNC_COLLECTION_SUBSCRIPTIONS = void 0;
4
+ const logger_1 = require("../logger");
5
+ const orgContext_1 = require("../orgs/orgContext");
6
+ const permissions_1 = require("../permissions");
7
+ const socketUser_1 = require("../realtime/socketUser");
8
+ const adminBroadcastScope_1 = require("./adminBroadcastScope");
9
+ const adminWindowAccess_1 = require("./adminWindowAccess");
10
+ const registry_1 = require("./registry");
11
+ const streams_1 = require("./streams");
12
+ const syncBatch_1 = require("./syncBatch");
13
+ const requestFromOrganizationId = ({ organizationId, user, }) => {
14
+ const trimmed = organizationId?.trim();
15
+ if (!trimmed) {
16
+ return { user };
17
+ }
18
+ return {
19
+ header: (name) => {
20
+ return String(name).toLowerCase() === orgContext_1.ORGANIZATION_ID_HEADER ? trimmed : undefined;
21
+ },
22
+ user,
10
23
  };
11
- return __assign.apply(this, arguments);
12
24
  };
13
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
- return new (P || (P = Promise))(function (resolve, reject) {
16
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
- step((generator = generator.apply(thisArg, _arguments || [])).next());
20
- });
21
- };
22
- var __generator = (this && this.__generator) || function (thisArg, body) {
23
- 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);
24
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
- function verb(n) { return function (v) { return step([n, v]); }; }
26
- function step(op) {
27
- if (f) throw new TypeError("Generator is already executing.");
28
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
- 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;
30
- if (y = 0, t) op = [op[0] & 2, t.value];
31
- switch (op[0]) {
32
- case 0: case 1: t = op; break;
33
- case 4: _.label++; return { value: op[1], done: false };
34
- case 5: _.label++; y = op[1]; op = [0]; continue;
35
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
- default:
37
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
- if (t[2]) _.ops.pop();
42
- _.trys.pop(); continue;
43
- }
44
- op = body.call(thisArg, _);
45
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
25
+ const organizationIdFromPayload = (payload) => {
26
+ if (typeof payload !== "object" || payload === null) {
27
+ return undefined;
47
28
  }
29
+ const organizationId = payload.organizationId;
30
+ return typeof organizationId === "string" ? organizationId : undefined;
48
31
  };
49
- var __values = (this && this.__values) || function(o) {
50
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
51
- if (m) return m.call(o);
52
- if (o && typeof o.length === "number") return {
53
- next: function () {
54
- if (o && i >= o.length) o = void 0;
55
- return { value: o && o[i++], done: !o };
56
- }
57
- };
58
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
59
- };
60
- Object.defineProperty(exports, "__esModule", { value: true });
61
- exports.installSyncSocketHandlers = exports.syncRoomForStream = exports.MAX_SYNC_SUBSCRIBE_ARRAY_LENGTH = exports.MAX_SYNC_COLLECTION_SUBSCRIPTIONS = void 0;
62
- var logger_1 = require("../logger");
63
- var permissions_1 = require("../permissions");
64
- var socketUser_1 = require("../realtime/socketUser");
65
- var registry_1 = require("./registry");
66
- var streams_1 = require("./streams");
67
- var syncBatch_1 = require("./syncBatch");
68
32
  /**
69
33
  * Socket handlers for the SyncDB local-first protocol:
70
34
  *
71
- * - `sync:subscribe {collections}` / `sync:unsubscribe {collections}` — resolves the
35
+ * - `sync:subscribe {collections, mode?}` / `sync:unsubscribe {collections}` — resolves the
72
36
  * caller's streams from the sync registry scope config and joins/leaves `sync:{stream}`
73
37
  * rooms. Owner scopes always use the socket's own userId (never a client-supplied one);
74
38
  * tenant and custom scopes resolve stream values via `SyncAppOptions.getUserScopes`.
39
+ * `mode: "window"` joins `{collection}|admin` only (requires `adminBroadcast` and
40
+ * admin panel access: `admin:access` when `SyncApp` has `accessControl`, else
41
+ * `user.admin`). When AdminApp has registered a broadcast scope, list
42
+ * permission for that model is required as well. Confirms with
43
+ * `sync:subscribed {mode: "window"}` without dumping snapshot pages.
75
44
  * Sync deltas fan out through these dedicated `sync:{stream}` rooms rather than the
76
45
  * legacy realtime rooms so the two event families never overlap.
77
46
  * - `sync:mutate` — applies a mutation through `applySyncMutation` and replies with
78
47
  * `sync:ack {mutationId, id, seq}` or `sync:nack {mutationId, code, ...}`; when the
79
48
  * client supplied a Socket.io ack callback it also receives `{ack}` / `{nack}`.
80
49
  * - `sync:error {collection, message}` — emitted for per-collection subscribe failures
81
- * (unknown collection, permission denied, missing scope resolver, cap exceeded).
50
+ * (unknown collection, permission denied, non-admin window subscribe, missing scope
51
+ * resolver, cap exceeded).
82
52
  *
83
53
  * ## Wiring
84
54
  *
@@ -94,44 +64,34 @@ exports.MAX_SYNC_COLLECTION_SUBSCRIPTIONS = 50;
94
64
  */
95
65
  exports.MAX_SYNC_SUBSCRIBE_ARRAY_LENGTH = 100;
96
66
  /** The Socket.io room a sync stream fans out through. */
97
- var syncRoomForStream = function (stream) { return "sync:".concat(stream); };
67
+ const syncRoomForStream = (stream) => `sync:${stream}`;
98
68
  exports.syncRoomForStream = syncRoomForStream;
99
69
  /**
100
70
  * Resolve the streams a user may subscribe to for a collection. Returns null (after
101
71
  * emitting `sync:error`) when the scope cannot be resolved for this user/server config.
102
72
  */
103
- var resolveUserStreams = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
104
- var collection, emitError, error_1;
105
- var entry = _b.entry, user = _b.user, options = _b.options, socket = _b.socket;
106
- return __generator(this, function (_c) {
107
- switch (_c.label) {
108
- case 0:
109
- collection = entry.collectionTag;
110
- emitError = function (message) {
111
- socket.emit("sync:error", { collection: collection, message: message });
112
- };
113
- _c.label = 1;
114
- case 1:
115
- _c.trys.push([1, 3, , 4]);
116
- return [4 /*yield*/, (0, streams_1.resolveUserStreamsForEntry)({
117
- entry: entry,
118
- getUserScopes: options.getUserScopes,
119
- user: user,
120
- })];
121
- case 2: return [2 /*return*/, _c.sent()];
122
- case 3:
123
- error_1 = _c.sent();
124
- if (error_1 instanceof streams_1.MissingScopeResolverError) {
125
- emitError(error_1.message);
126
- return [2 /*return*/, null];
127
- }
128
- logger_1.logger.error("[sync] getUserScopes threw for ".concat(collection, ": ").concat(error_1));
129
- emitError("Failed to resolve scopes for ".concat(collection));
130
- return [2 /*return*/, null];
131
- case 4: return [2 /*return*/];
73
+ const resolveUserStreams = async ({ entry, user, options, socket, }) => {
74
+ const collection = entry.collectionTag;
75
+ const emitError = (message) => {
76
+ socket.emit("sync:error", { collection, message });
77
+ };
78
+ try {
79
+ return await (0, streams_1.resolveUserStreamsForEntry)({
80
+ entry,
81
+ getUserScopes: options.getUserScopes,
82
+ user,
83
+ });
84
+ }
85
+ catch (error) {
86
+ if (error instanceof streams_1.MissingScopeResolverError) {
87
+ emitError(error.message);
88
+ return null;
132
89
  }
133
- });
134
- }); };
90
+ logger_1.logger.error(`[sync] getUserScopes threw for ${collection}: ${error}`);
91
+ emitError(`Failed to resolve scopes for ${collection}`);
92
+ return null;
93
+ }
94
+ };
135
95
  /**
136
96
  * Install the sync socket handlers on a single socket. Wired into RealtimeApp's
137
97
  * connection handler alongside `installRealtimeSocketHandlers`.
@@ -139,12 +99,9 @@ var resolveUserStreams = function (_a) { return __awaiter(void 0, [_a], void 0,
139
99
  * The `_io` server parameter is accepted for signature symmetry with future fan-out
140
100
  * needs; the current handlers only act on the connecting socket.
141
101
  */
142
- var installSyncSocketHandlers = function (_io, socket, options, handlerOptions) {
143
- var _a, _b, _c, _d;
144
- if (options === void 0) { options = {}; }
145
- if (handlerOptions === void 0) { handlerOptions = {}; }
146
- var logInfo = (_a = handlerOptions.logInfo) !== null && _a !== void 0 ? _a : (function () { });
147
- var userId = (_b = socket.decodedToken) === null || _b === void 0 ? void 0 : _b.id;
102
+ const installSyncSocketHandlers = (_io, socket, options = {}, handlerOptions = {}) => {
103
+ const logInfo = handlerOptions.logInfo ?? (() => { });
104
+ const userId = socket.decodedToken?.id;
148
105
  // D2: re-derive the authorizing user on every event rather than capturing it once
149
106
  // at install time — `socket.data.fullUser` is loaded at handshake and refreshed by
150
107
  // D1's sweep, so a mutation sent after a refresh (e.g. after `organizationIds`
@@ -153,317 +110,229 @@ var installSyncSocketHandlers = function (_io, socket, options, handlerOptions)
153
110
  // Task 9.21: awaits the handshake load when it is still in flight, closing the window
154
111
  // where an event arriving first was authorized against the synthetic JWT-claim user
155
112
  // (no membership fields — tenant scopes resolved to nothing).
156
- var currentUser = function () { return (0, socketUser_1.awaitSocketFullUser)(socket); };
113
+ const currentUser = () => (0, socketUser_1.awaitSocketFullUser)(socket);
157
114
  // collection tag -> joined sync rooms, for unsubscribe/disconnect cleanup and D4's
158
115
  // sweep-time re-resolution. Exposed on socket.data (when present — real sockets
159
116
  // always have it; minimal test doubles may not) so the sweep, which runs outside
160
117
  // this closure, can read and mutate it directly.
161
- var subscriptions = (_d = (_c = socket.data) === null || _c === void 0 ? void 0 : _c.syncSubscriptions) !== null && _d !== void 0 ? _d : new Map();
118
+ const subscriptions = socket.data?.syncSubscriptions ?? new Map();
162
119
  if (socket.data) {
163
120
  socket.data.syncSubscriptions = subscriptions;
164
121
  }
165
- socket.on("sync:subscribe", function (payload) { return __awaiter(void 0, void 0, void 0, function () {
166
- var collections, collections_1, collections_1_1, collection, entry, user, streams, rooms, rooms_1, rooms_1_1, room, e_1_1, e_2_1;
167
- var e_2, _a, e_1, _b;
168
- return __generator(this, function (_c) {
169
- switch (_c.label) {
170
- case 0:
171
- collections = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.collections) ? payload.collections : null;
172
- if (!collections) {
173
- return [2 /*return*/];
174
- }
175
- // C8: reject an oversized array up front (length check before iterating).
176
- if (collections.length > exports.MAX_SYNC_SUBSCRIBE_ARRAY_LENGTH) {
177
- logInfo("[sync] User ".concat(userId, " sent an oversized sync:subscribe array"));
178
- socket.emit("sync:error", {
179
- collection: "",
180
- message: "sync:subscribe accepts at most ".concat(exports.MAX_SYNC_SUBSCRIBE_ARRAY_LENGTH, " collections"),
181
- });
182
- return [2 /*return*/];
183
- }
184
- _c.label = 1;
185
- case 1:
186
- _c.trys.push([1, 16, 17, 18]);
187
- collections_1 = __values(collections), collections_1_1 = collections_1.next();
188
- _c.label = 2;
189
- case 2:
190
- if (!!collections_1_1.done) return [3 /*break*/, 15];
191
- collection = collections_1_1.value;
192
- if (typeof collection !== "string" || collection.length === 0) {
193
- return [3 /*break*/, 14];
194
- }
195
- if (subscriptions.has(collection)) {
196
- // Already subscribed — idempotent.
197
- return [3 /*break*/, 14];
198
- }
199
- if (subscriptions.size >= exports.MAX_SYNC_COLLECTION_SUBSCRIPTIONS) {
200
- logInfo("[sync] User ".concat(userId, " hit sync collection subscription limit"));
201
- socket.emit("sync:error", {
202
- collection: collection,
203
- message: "Sync subscription limit of ".concat(exports.MAX_SYNC_COLLECTION_SUBSCRIPTIONS, " collections reached"),
204
- });
205
- return [3 /*break*/, 14];
206
- }
207
- entry = (0, registry_1.findSyncEntryByCollectionTag)(collection);
208
- if (!entry) {
209
- socket.emit("sync:error", { collection: collection, message: "Unknown sync collection: ".concat(collection) });
210
- return [3 /*break*/, 14];
211
- }
212
- return [4 /*yield*/, currentUser()];
213
- case 3:
214
- user = _c.sent();
215
- if (!user) {
216
- socket.emit("sync:error", { collection: collection, message: "Authentication required" });
217
- return [3 /*break*/, 14];
218
- }
219
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("list", entry.options.permissions.list, user)];
220
- case 4:
221
- if (!(_c.sent())) {
222
- logInfo("[sync] User ".concat(userId, " denied sync subscription for ").concat(collection));
223
- socket.emit("sync:error", {
224
- collection: collection,
225
- message: "Access to sync collection ".concat(collection, " denied"),
226
- });
227
- return [3 /*break*/, 14];
228
- }
229
- return [4 /*yield*/, resolveUserStreams({ entry: entry, options: options, socket: socket, user: user })];
230
- case 5:
231
- streams = _c.sent();
232
- if (!streams) {
233
- return [3 /*break*/, 14];
234
- }
235
- rooms = new Set(streams.map(exports.syncRoomForStream));
236
- _c.label = 6;
237
- case 6:
238
- _c.trys.push([6, 11, 12, 13]);
239
- rooms_1 = (e_1 = void 0, __values(rooms)), rooms_1_1 = rooms_1.next();
240
- _c.label = 7;
241
- case 7:
242
- if (!!rooms_1_1.done) return [3 /*break*/, 10];
243
- room = rooms_1_1.value;
244
- return [4 /*yield*/, socket.join(room)];
245
- case 8:
246
- _c.sent();
247
- _c.label = 9;
248
- case 9:
249
- rooms_1_1 = rooms_1.next();
250
- return [3 /*break*/, 7];
251
- case 10: return [3 /*break*/, 13];
252
- case 11:
253
- e_1_1 = _c.sent();
254
- e_1 = { error: e_1_1 };
255
- return [3 /*break*/, 13];
256
- case 12:
257
- try {
258
- if (rooms_1_1 && !rooms_1_1.done && (_b = rooms_1.return)) _b.call(rooms_1);
259
- }
260
- finally { if (e_1) throw e_1.error; }
261
- return [7 /*endfinally*/];
262
- case 13:
263
- subscriptions.set(collection, rooms);
264
- socket.emit("sync:subscribed", { collection: collection, streams: streams });
265
- logInfo("[sync] User ".concat(userId, " subscribed to ").concat(collection, ": ").concat(streams.join(", ")));
266
- _c.label = 14;
267
- case 14:
268
- collections_1_1 = collections_1.next();
269
- return [3 /*break*/, 2];
270
- case 15: return [3 /*break*/, 18];
271
- case 16:
272
- e_2_1 = _c.sent();
273
- e_2 = { error: e_2_1 };
274
- return [3 /*break*/, 18];
275
- case 17:
276
- try {
277
- if (collections_1_1 && !collections_1_1.done && (_a = collections_1.return)) _a.call(collections_1);
278
- }
279
- finally { if (e_2) throw e_2.error; }
280
- return [7 /*endfinally*/];
281
- case 18: return [2 /*return*/];
122
+ socket.on("sync:subscribe", async (payload) => {
123
+ const collections = Array.isArray(payload?.collections) ? payload.collections : null;
124
+ const isWindow = payload?.mode === "window";
125
+ if (!collections) {
126
+ return;
127
+ }
128
+ // C8: reject an oversized array up front (length check before iterating).
129
+ if (collections.length > exports.MAX_SYNC_SUBSCRIBE_ARRAY_LENGTH) {
130
+ logInfo(`[sync] User ${userId} sent an oversized sync:subscribe array`);
131
+ socket.emit("sync:error", {
132
+ collection: "",
133
+ message: `sync:subscribe accepts at most ${exports.MAX_SYNC_SUBSCRIBE_ARRAY_LENGTH} collections`,
134
+ });
135
+ return;
136
+ }
137
+ for (const collection of collections) {
138
+ if (typeof collection !== "string" || collection.length === 0) {
139
+ continue;
282
140
  }
283
- });
284
- }); });
285
- socket.on("sync:unsubscribe", function (payload) { return __awaiter(void 0, void 0, void 0, function () {
286
- var collections, collections_2, collections_2_1, collection, rooms, rooms_2, rooms_2_1, room, e_3_1, e_4_1;
287
- var e_4, _a, e_3, _b;
288
- return __generator(this, function (_c) {
289
- switch (_c.label) {
290
- case 0:
291
- collections = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.collections) ? payload.collections : null;
292
- if (!collections) {
293
- return [2 /*return*/];
294
- }
295
- _c.label = 1;
296
- case 1:
297
- _c.trys.push([1, 13, 14, 15]);
298
- collections_2 = __values(collections), collections_2_1 = collections_2.next();
299
- _c.label = 2;
300
- case 2:
301
- if (!!collections_2_1.done) return [3 /*break*/, 12];
302
- collection = collections_2_1.value;
303
- if (typeof collection !== "string") {
304
- return [3 /*break*/, 11];
305
- }
306
- rooms = subscriptions.get(collection);
307
- if (!rooms) {
308
- return [3 /*break*/, 11];
309
- }
310
- _c.label = 3;
311
- case 3:
312
- _c.trys.push([3, 8, 9, 10]);
313
- rooms_2 = (e_3 = void 0, __values(rooms)), rooms_2_1 = rooms_2.next();
314
- _c.label = 4;
315
- case 4:
316
- if (!!rooms_2_1.done) return [3 /*break*/, 7];
317
- room = rooms_2_1.value;
318
- return [4 /*yield*/, socket.leave(room)];
319
- case 5:
320
- _c.sent();
321
- _c.label = 6;
322
- case 6:
323
- rooms_2_1 = rooms_2.next();
324
- return [3 /*break*/, 4];
325
- case 7: return [3 /*break*/, 10];
326
- case 8:
327
- e_3_1 = _c.sent();
328
- e_3 = { error: e_3_1 };
329
- return [3 /*break*/, 10];
330
- case 9:
331
- try {
332
- if (rooms_2_1 && !rooms_2_1.done && (_b = rooms_2.return)) _b.call(rooms_2);
333
- }
334
- finally { if (e_3) throw e_3.error; }
335
- return [7 /*endfinally*/];
336
- case 10:
337
- subscriptions.delete(collection);
338
- logInfo("[sync] User ".concat(userId, " unsubscribed from ").concat(collection));
339
- _c.label = 11;
340
- case 11:
341
- collections_2_1 = collections_2.next();
342
- return [3 /*break*/, 2];
343
- case 12: return [3 /*break*/, 15];
344
- case 13:
345
- e_4_1 = _c.sent();
346
- e_4 = { error: e_4_1 };
347
- return [3 /*break*/, 15];
348
- case 14:
349
- try {
350
- if (collections_2_1 && !collections_2_1.done && (_a = collections_2.return)) _a.call(collections_2);
351
- }
352
- finally { if (e_4) throw e_4.error; }
353
- return [7 /*endfinally*/];
354
- case 15: return [2 /*return*/];
141
+ if (subscriptions.has(collection)) {
142
+ // Already subscribed — idempotent.
143
+ continue;
355
144
  }
356
- });
357
- }); });
358
- socket.on("sync:mutate", function (payload, ack) { return __awaiter(void 0, void 0, void 0, function () {
359
- var respond, nack, user, _a, outcome, stage, error_2;
360
- return __generator(this, function (_b) {
361
- switch (_b.label) {
362
- case 0:
363
- respond = function (outcome) {
364
- if (outcome.type === "ack") {
365
- socket.emit("sync:ack", outcome.ack);
366
- }
367
- else {
368
- socket.emit("sync:nack", outcome.nack);
369
- }
370
- if (typeof ack === "function") {
371
- ack(outcome.type === "ack" ? { ack: outcome.ack } : { nack: outcome.nack });
372
- }
373
- };
374
- nack = function (partial) {
375
- respond({
376
- nack: __assign({ mutationId: typeof (payload === null || payload === void 0 ? void 0 : payload.mutationId) === "string" ? payload.mutationId : "" }, partial),
377
- type: "nack",
378
- });
379
- };
380
- return [4 /*yield*/, currentUser()];
381
- case 1:
382
- user = _b.sent();
383
- if (!user) {
384
- nack({ code: "unauthorized", message: "Authentication required" });
385
- return [2 /*return*/];
386
- }
387
- _b.label = 2;
388
- case 2:
389
- _b.trys.push([2, 4, , 5]);
390
- return [4 /*yield*/, (0, syncBatch_1.runSyncMutation)({
391
- mutation: payload,
392
- scopeResolver: options.getUserScopes,
393
- user: user,
394
- })];
395
- case 3:
396
- _a = _b.sent(), outcome = _a.outcome, stage = _a.stage;
397
- if (stage === "rate_limited") {
398
- logInfo("[sync] User ".concat(userId, " hit the sync:mutate rate limit"));
399
- }
400
- respond(outcome);
401
- return [3 /*break*/, 5];
402
- case 4:
403
- error_2 = _b.sent();
404
- logger_1.logger.error("[sync] sync:mutate failed for socket ".concat(socket.id, ": ").concat(error_2));
405
- nack({ code: "error", message: "Internal error applying mutation" });
406
- return [3 /*break*/, 5];
407
- case 5: return [2 /*return*/];
145
+ if (subscriptions.size >= exports.MAX_SYNC_COLLECTION_SUBSCRIPTIONS) {
146
+ logInfo(`[sync] User ${userId} hit sync collection subscription limit`);
147
+ socket.emit("sync:error", {
148
+ collection,
149
+ message: `Sync subscription limit of ${exports.MAX_SYNC_COLLECTION_SUBSCRIPTIONS} collections reached`,
150
+ });
151
+ continue;
408
152
  }
409
- });
410
- }); });
411
- socket.on("sync:mutateBatch", function (payload, ack) { return __awaiter(void 0, void 0, void 0, function () {
412
- var respondBatch, singleNackBatch, mutations, user, _a, response, stage, error_3;
413
- return __generator(this, function (_b) {
414
- switch (_b.label) {
415
- case 0:
416
- // FIX 5: emit the receipt IMMEDIATELY, before any processing (including
417
- // rate-limit/auth checks) — this is what lets the client distinguish
418
- // "no sync:mutateBatch handler at all" (silence past the grace period)
419
- // from "the server is just slow finishing this batch" (a receipt
420
- // arrived; the client then waits the full batch timeout instead of
421
- // falling back to single sends and possibly double-processing).
422
- if (typeof (payload === null || payload === void 0 ? void 0 : payload.batchId) === "string" && payload.batchId.length > 0) {
423
- socket.emit("sync:batchReceived", { batchId: payload.batchId });
424
- }
425
- respondBatch = function (response) {
426
- if (typeof ack === "function") {
427
- ack(response);
428
- }
429
- };
430
- singleNackBatch = function (partial, mutationId) {
431
- if (mutationId === void 0) { mutationId = ""; }
432
- respondBatch({ results: [{ nack: __assign({ mutationId: mutationId }, partial), type: "nack" }] });
433
- };
434
- mutations = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.mutations) ? payload.mutations : [];
435
- return [4 /*yield*/, currentUser()];
436
- case 1:
437
- user = _b.sent();
438
- if (!user) {
439
- singleNackBatch({ code: "unauthorized", message: "Authentication required" });
440
- return [2 /*return*/];
441
- }
442
- _b.label = 2;
443
- case 2:
444
- _b.trys.push([2, 4, , 5]);
445
- return [4 /*yield*/, (0, syncBatch_1.runSyncBatch)({
446
- mutations: mutations,
447
- scopeResolver: options.getUserScopes,
448
- user: user,
449
- })];
450
- case 3:
451
- _a = _b.sent(), response = _a.response, stage = _a.stage;
452
- if (stage === "rate_limited") {
453
- logInfo("[sync] User ".concat(userId, " hit the sync:mutateBatch rate limit"));
454
- }
455
- respondBatch(response);
456
- return [3 /*break*/, 5];
457
- case 4:
458
- error_3 = _b.sent();
459
- logger_1.logger.error("[sync] sync:mutateBatch failed for socket ".concat(socket.id, ": ").concat(error_3));
460
- singleNackBatch({ code: "error", message: "Internal error applying batch" });
461
- return [3 /*break*/, 5];
462
- case 5: return [2 /*return*/];
153
+ const entry = (0, registry_1.findSyncEntryByCollectionTag)(collection);
154
+ if (!entry) {
155
+ socket.emit("sync:error", {
156
+ collection,
157
+ message: `Unknown sync collection: ${collection}`,
158
+ });
159
+ continue;
463
160
  }
464
- });
465
- }); });
466
- socket.on("disconnect", function () {
161
+ const user = await currentUser();
162
+ if (!user) {
163
+ socket.emit("sync:error", { collection, message: "Authentication required" });
164
+ continue;
165
+ }
166
+ if (!(await (0, permissions_1.checkPermissions)("list", entry.options.permissions.list, user))) {
167
+ logInfo(`[sync] User ${userId} denied sync subscription for ${collection}`);
168
+ socket.emit("sync:error", {
169
+ collection,
170
+ message: `Access to sync collection ${collection} denied`,
171
+ });
172
+ continue;
173
+ }
174
+ if (isWindow && entry.config.adminBroadcast !== true) {
175
+ socket.emit("sync:error", {
176
+ collection,
177
+ message: `Window subscribe requires adminBroadcast on ${collection}`,
178
+ });
179
+ continue;
180
+ }
181
+ if (isWindow &&
182
+ !(await (0, adminWindowAccess_1.canUseAdminBroadcastWindow)({
183
+ accessControl: options.accessControl,
184
+ canOpenAdminWindow: options.canOpenAdminWindow,
185
+ user,
186
+ }))) {
187
+ logInfo(`[sync] User ${userId} denied window subscribe for ${collection}`);
188
+ socket.emit("sync:error", {
189
+ collection,
190
+ message: `Window subscribe requires admin panel access for ${collection}`,
191
+ });
192
+ continue;
193
+ }
194
+ if (isWindow) {
195
+ const adminScope = (0, adminBroadcastScope_1.getAdminBroadcastScope)(entry.modelName);
196
+ if (adminScope && !(await (0, adminBroadcastScope_1.canListAdminBroadcastScope)({ scope: adminScope, user }))) {
197
+ logInfo(`[sync] User ${userId} denied window subscribe list for ${collection}`);
198
+ socket.emit("sync:error", {
199
+ collection,
200
+ message: `Window subscribe requires admin collection access for ${collection}`,
201
+ });
202
+ continue;
203
+ }
204
+ }
205
+ const streams = isWindow
206
+ ? [(0, streams_1.adminBroadcastStream)(collection)]
207
+ : await resolveUserStreams({ entry, options, socket, user });
208
+ if (!streams) {
209
+ continue;
210
+ }
211
+ const rooms = new Set(streams.map(exports.syncRoomForStream));
212
+ for (const room of rooms) {
213
+ await socket.join(room);
214
+ }
215
+ subscriptions.set(collection, rooms);
216
+ socket.emit("sync:subscribed", isWindow ? { collection, mode: "window", streams } : { collection, streams });
217
+ logInfo(`[sync] User ${userId} subscribed to ${collection}: ${streams.join(", ")}`);
218
+ }
219
+ });
220
+ socket.on("sync:unsubscribe", async (payload) => {
221
+ const collections = Array.isArray(payload?.collections) ? payload.collections : null;
222
+ if (!collections) {
223
+ return;
224
+ }
225
+ for (const collection of collections) {
226
+ if (typeof collection !== "string") {
227
+ continue;
228
+ }
229
+ const rooms = subscriptions.get(collection);
230
+ if (!rooms) {
231
+ continue;
232
+ }
233
+ for (const room of rooms) {
234
+ await socket.leave(room);
235
+ }
236
+ subscriptions.delete(collection);
237
+ logInfo(`[sync] User ${userId} unsubscribed from ${collection}`);
238
+ }
239
+ });
240
+ socket.on("sync:mutate", async (payload, ack) => {
241
+ const respond = (outcome) => {
242
+ if (outcome.type === "ack") {
243
+ socket.emit("sync:ack", outcome.ack);
244
+ }
245
+ else {
246
+ socket.emit("sync:nack", outcome.nack);
247
+ }
248
+ if (typeof ack === "function") {
249
+ ack(outcome.type === "ack" ? { ack: outcome.ack } : { nack: outcome.nack });
250
+ }
251
+ };
252
+ const nack = (partial) => {
253
+ respond({
254
+ nack: {
255
+ mutationId: typeof payload?.mutationId === "string" ? payload.mutationId : "",
256
+ ...partial,
257
+ },
258
+ type: "nack",
259
+ });
260
+ };
261
+ const user = await currentUser();
262
+ if (!user) {
263
+ nack({ code: "unauthorized", message: "Authentication required" });
264
+ return;
265
+ }
266
+ try {
267
+ // Task 9.20: the rate limit is charged inside the shared runner against this
268
+ // USER's window, so opening more sockets no longer multiplies the budget.
269
+ const { outcome, stage } = await (0, syncBatch_1.runSyncMutation)({
270
+ mutation: payload,
271
+ req: requestFromOrganizationId({
272
+ organizationId: organizationIdFromPayload(payload),
273
+ user,
274
+ }),
275
+ scopeResolver: options.getUserScopes,
276
+ syncOptions: options,
277
+ user,
278
+ });
279
+ if (stage === "rate_limited") {
280
+ logInfo(`[sync] User ${userId} hit the sync:mutate rate limit`);
281
+ }
282
+ respond(outcome);
283
+ }
284
+ catch (error) {
285
+ logger_1.logger.error(`[sync] sync:mutate failed for socket ${socket.id}: ${error}`);
286
+ nack({ code: "error", message: "Internal error applying mutation" });
287
+ }
288
+ });
289
+ socket.on("sync:mutateBatch", async (payload, ack) => {
290
+ // FIX 5: emit the receipt IMMEDIATELY, before any processing (including
291
+ // rate-limit/auth checks) — this is what lets the client distinguish
292
+ // "no sync:mutateBatch handler at all" (silence past the grace period)
293
+ // from "the server is just slow finishing this batch" (a receipt
294
+ // arrived; the client then waits the full batch timeout instead of
295
+ // falling back to single sends and possibly double-processing).
296
+ if (typeof payload?.batchId === "string" && payload.batchId.length > 0) {
297
+ socket.emit("sync:batchReceived", { batchId: payload.batchId });
298
+ }
299
+ const respondBatch = (response) => {
300
+ if (typeof ack === "function") {
301
+ ack(response);
302
+ }
303
+ };
304
+ const singleNackBatch = (partial, mutationId = "") => {
305
+ respondBatch({ results: [{ nack: { mutationId, ...partial }, type: "nack" }] });
306
+ };
307
+ const mutations = Array.isArray(payload?.mutations) ? payload.mutations : [];
308
+ const user = await currentUser();
309
+ if (!user) {
310
+ singleNackBatch({ code: "unauthorized", message: "Authentication required" });
311
+ return;
312
+ }
313
+ try {
314
+ // Task 9.20: validate -> rate limit -> apply, shared with POST /sync/mutate/batch.
315
+ const { response, stage } = await (0, syncBatch_1.runSyncBatch)({
316
+ mutations,
317
+ req: requestFromOrganizationId({
318
+ organizationId: organizationIdFromPayload(payload),
319
+ user,
320
+ }),
321
+ scopeResolver: options.getUserScopes,
322
+ syncOptions: options,
323
+ user,
324
+ });
325
+ if (stage === "rate_limited") {
326
+ logInfo(`[sync] User ${userId} hit the sync:mutateBatch rate limit`);
327
+ }
328
+ respondBatch(response);
329
+ }
330
+ catch (error) {
331
+ logger_1.logger.error(`[sync] sync:mutateBatch failed for socket ${socket.id}: ${error}`);
332
+ singleNackBatch({ code: "error", message: "Internal error applying batch" });
333
+ }
334
+ });
335
+ socket.on("disconnect", () => {
467
336
  subscriptions.clear();
468
337
  });
469
338
  };