@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,78 +1,15 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
37
- };
38
- var __values = (this && this.__values) || function(o) {
39
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
- if (m) return m.call(o);
41
- if (o && typeof o.length === "number") return {
42
- next: function () {
43
- if (o && i >= o.length) o = void 0;
44
- return { value: o && o[i++], done: !o };
45
- }
46
- };
47
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
- };
49
- var __read = (this && this.__read) || function (o, n) {
50
- var m = typeof Symbol === "function" && o[Symbol.iterator];
51
- if (!m) return o;
52
- var i = m.call(o), r, ar = [], e;
53
- try {
54
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
- }
56
- catch (error) { e = { error: error }; }
57
- finally {
58
- try {
59
- if (r && !r.done && (m = i["return"])) m.call(i);
60
- }
61
- finally { if (e) throw e.error; }
62
- }
63
- return ar;
64
- };
65
2
  var __importDefault = (this && this.__importDefault) || function (mod) {
66
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
67
4
  };
68
5
  Object.defineProperty(exports, "__esModule", { value: true });
69
6
  exports.compactTombstones = exports.compactEntryTombstones = exports.DEFAULT_TOMBSTONE_RETENTION_DAYS = void 0;
70
- var luxon_1 = require("luxon");
71
- var mongoose_1 = __importDefault(require("mongoose"));
72
- var logger_1 = require("../../logger");
73
- var models_1 = require("../models");
74
- var registry_1 = require("../registry");
75
- var streams_1 = require("../streams");
7
+ const luxon_1 = require("luxon");
8
+ const mongoose_1 = __importDefault(require("mongoose"));
9
+ const logger_1 = require("../../logger");
10
+ const models_1 = require("../models");
11
+ const registry_1 = require("../registry");
12
+ const streams_1 = require("../streams");
76
13
  /**
77
14
  * C7 tombstone retention maintenance.
78
15
  *
@@ -89,10 +26,9 @@ var streams_1 = require("../streams");
89
26
  */
90
27
  /** Default retention window when a model does not override `sync.retentionDays`. */
91
28
  exports.DEFAULT_TOMBSTONE_RETENTION_DAYS = 90;
92
- var retentionCutoff = function (entry) {
93
- var _a;
94
- var days = (_a = entry.config.retentionDays) !== null && _a !== void 0 ? _a : exports.DEFAULT_TOMBSTONE_RETENTION_DAYS;
95
- return luxon_1.DateTime.now().minus({ days: days }).toJSDate();
29
+ const retentionCutoff = (entry) => {
30
+ const days = entry.config.retentionDays ?? exports.DEFAULT_TOMBSTONE_RETENTION_DAYS;
31
+ return luxon_1.DateTime.now().minus({ days }).toJSDate();
96
32
  };
97
33
  /**
98
34
  * Compact tombstones and scope-move markers for one registry entry: hard-delete
@@ -107,162 +43,81 @@ var retentionCutoff = function (entry) {
107
43
  * carries a TTL index: an expiry that fires outside this function reaps rows with no
108
44
  * watermark update and ignores the model's `retentionDays`.
109
45
  */
110
- var compactEntryTombstones = function (entry) { return __awaiter(void 0, void 0, void 0, function () {
111
- var cutoff, model, scopeField, tombstoneFilter, markerFilter, watermarks, raiseWatermark, isCustomScope, projection, doomedTombstones, doomedTombstones_1, doomedTombstones_1_1, row, doomedMarkers, doomedMarkers_1, doomedMarkers_1_1, marker, tombstoneResult, markerResult, watermarks_1, watermarks_1_1, _a, stream, seq, e_1_1;
112
- var _b, e_2, _c, e_3, _d, e_1, _e;
113
- var _f, _g;
114
- return __generator(this, function (_h) {
115
- switch (_h.label) {
116
- case 0:
117
- cutoff = retentionCutoff(entry);
118
- model = mongoose_1.default.model(entry.modelName);
119
- scopeField = (0, streams_1.getScopeField)(entry.config.scope);
120
- tombstoneFilter = {
121
- $or: [{ updated: { $lt: cutoff } }, { created: { $lt: cutoff }, updated: { $exists: false } }],
122
- deleted: true,
123
- };
124
- markerFilter = { collectionTag: entry.collectionTag, created: { $lt: cutoff } };
125
- watermarks = new Map();
126
- raiseWatermark = function (stream, seq) {
127
- var _a;
128
- if (typeof seq !== "number" || seq <= 0) {
129
- return;
130
- }
131
- if (seq > ((_a = watermarks.get(stream)) !== null && _a !== void 0 ? _a : 0)) {
132
- watermarks.set(stream, seq);
133
- }
134
- };
135
- isCustomScope = typeof entry.config.scope === "function";
136
- projection = scopeField
137
- ? (_b = { _id: 1, _syncSeq: 1 }, _b[scopeField] = 1, _b) : isCustomScope
138
- ? undefined
139
- : { _id: 1, _syncSeq: 1 };
140
- return [4 /*yield*/, model.collection
141
- .find(tombstoneFilter, projection ? { projection: projection } : {})
142
- .toArray()];
143
- case 1:
144
- doomedTombstones = _h.sent();
145
- try {
146
- for (doomedTombstones_1 = __values(doomedTombstones), doomedTombstones_1_1 = doomedTombstones_1.next(); !doomedTombstones_1_1.done; doomedTombstones_1_1 = doomedTombstones_1.next()) {
147
- row = doomedTombstones_1_1.value;
148
- raiseWatermark((0, streams_1.resolveStreamForDoc)({
149
- collectionTag: entry.collectionTag,
150
- doc: row,
151
- scope: entry.config.scope,
152
- }), row._syncSeq);
153
- }
154
- }
155
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
156
- finally {
157
- try {
158
- if (doomedTombstones_1_1 && !doomedTombstones_1_1.done && (_c = doomedTombstones_1.return)) _c.call(doomedTombstones_1);
159
- }
160
- finally { if (e_2) throw e_2.error; }
161
- }
162
- return [4 /*yield*/, models_1.SyncScopeMove.collection
163
- .find(markerFilter, { projection: { _id: 1, fromStream: 1, seq: 1 } })
164
- .toArray()];
165
- case 2:
166
- doomedMarkers = _h.sent();
167
- try {
168
- for (doomedMarkers_1 = __values(doomedMarkers), doomedMarkers_1_1 = doomedMarkers_1.next(); !doomedMarkers_1_1.done; doomedMarkers_1_1 = doomedMarkers_1.next()) {
169
- marker = doomedMarkers_1_1.value;
170
- raiseWatermark(String(marker.fromStream), marker.seq);
171
- }
172
- }
173
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
174
- finally {
175
- try {
176
- if (doomedMarkers_1_1 && !doomedMarkers_1_1.done && (_d = doomedMarkers_1.return)) _d.call(doomedMarkers_1);
177
- }
178
- finally { if (e_3) throw e_3.error; }
179
- }
180
- return [4 /*yield*/, model.collection.deleteMany(tombstoneFilter)];
181
- case 3:
182
- tombstoneResult = _h.sent();
183
- return [4 /*yield*/, models_1.SyncScopeMove.collection.deleteMany(markerFilter)];
184
- case 4:
185
- markerResult = _h.sent();
186
- _h.label = 5;
187
- case 5:
188
- _h.trys.push([5, 10, 11, 12]);
189
- watermarks_1 = __values(watermarks), watermarks_1_1 = watermarks_1.next();
190
- _h.label = 6;
191
- case 6:
192
- if (!!watermarks_1_1.done) return [3 /*break*/, 9];
193
- _a = __read(watermarks_1_1.value, 2), stream = _a[0], seq = _a[1];
194
- return [4 /*yield*/, (0, models_1.recordCompactedThroughSeq)({ seq: seq, stream: stream })];
195
- case 7:
196
- _h.sent();
197
- _h.label = 8;
198
- case 8:
199
- watermarks_1_1 = watermarks_1.next();
200
- return [3 /*break*/, 6];
201
- case 9: return [3 /*break*/, 12];
202
- case 10:
203
- e_1_1 = _h.sent();
204
- e_1 = { error: e_1_1 };
205
- return [3 /*break*/, 12];
206
- case 11:
207
- try {
208
- if (watermarks_1_1 && !watermarks_1_1.done && (_e = watermarks_1.return)) _e.call(watermarks_1);
209
- }
210
- finally { if (e_1) throw e_1.error; }
211
- return [7 /*endfinally*/];
212
- case 12: return [2 /*return*/, {
213
- markers: (_f = markerResult.deletedCount) !== null && _f !== void 0 ? _f : 0,
214
- tombstones: (_g = tombstoneResult.deletedCount) !== null && _g !== void 0 ? _g : 0,
215
- }];
46
+ const compactEntryTombstones = async (entry) => {
47
+ const cutoff = retentionCutoff(entry);
48
+ const model = mongoose_1.default.model(entry.modelName);
49
+ const scopeField = (0, streams_1.getScopeField)(entry.config.scope);
50
+ const tombstoneFilter = {
51
+ $or: [{ updated: { $lt: cutoff } }, { created: { $lt: cutoff }, updated: { $exists: false } }],
52
+ deleted: true,
53
+ };
54
+ const markerFilter = { collectionTag: entry.collectionTag, created: { $lt: cutoff } };
55
+ /** stream key -> highest seq being reaped on that stream. */
56
+ const watermarks = new Map();
57
+ const raiseWatermark = (stream, seq) => {
58
+ if (typeof seq !== "number" || seq <= 0) {
59
+ return;
216
60
  }
217
- });
218
- }); };
61
+ if (seq > (watermarks.get(stream) ?? 0)) {
62
+ watermarks.set(stream, seq);
63
+ }
64
+ };
65
+ // A custom scope resolver may read any field, so it needs whole documents; broadcast and
66
+ // field-based scopes only need the seq (plus the scope field) to resolve the stream.
67
+ const isCustomScope = typeof entry.config.scope === "function";
68
+ const projection = scopeField
69
+ ? { _id: 1, _syncSeq: 1, [scopeField]: 1 }
70
+ : isCustomScope
71
+ ? undefined
72
+ : { _id: 1, _syncSeq: 1 };
73
+ const doomedTombstones = await model.collection
74
+ .find(tombstoneFilter, projection ? { projection } : {})
75
+ .toArray();
76
+ for (const row of doomedTombstones) {
77
+ raiseWatermark((0, streams_1.resolveStreamForDoc)({
78
+ collectionTag: entry.collectionTag,
79
+ doc: row,
80
+ scope: entry.config.scope,
81
+ }), row._syncSeq);
82
+ }
83
+ const doomedMarkers = await models_1.SyncScopeMove.collection
84
+ .find(markerFilter, { projection: { _id: 1, fromStream: 1, seq: 1 } })
85
+ .toArray();
86
+ for (const marker of doomedMarkers) {
87
+ raiseWatermark(String(marker.fromStream), marker.seq);
88
+ }
89
+ // Hard delete soft-deleted docs older than the cutoff. deleteMany on the raw collection
90
+ // bypasses the syncPlugin guard (which blocks deleteMany on the model) — this is a
91
+ // deliberate maintenance-only escape hatch.
92
+ const tombstoneResult = await model.collection.deleteMany(tombstoneFilter);
93
+ const markerResult = await models_1.SyncScopeMove.collection.deleteMany(markerFilter);
94
+ // Raise the watermarks AFTER the deletes: a watermark that runs ahead of the actual
95
+ // deletion would force re-bootstraps for data still perfectly readable.
96
+ for (const [stream, seq] of watermarks) {
97
+ await (0, models_1.recordCompactedThroughSeq)({ seq, stream });
98
+ }
99
+ return {
100
+ markers: markerResult.deletedCount ?? 0,
101
+ tombstones: tombstoneResult.deletedCount ?? 0,
102
+ };
103
+ };
219
104
  exports.compactEntryTombstones = compactEntryTombstones;
220
105
  /** Compact tombstones across every registered sync model. */
221
- var compactTombstones = function () { return __awaiter(void 0, void 0, void 0, function () {
222
- var byCollection, totalTombstones, totalMarkers, _a, _b, entry, counts, e_4_1;
223
- var e_4, _c;
224
- return __generator(this, function (_d) {
225
- switch (_d.label) {
226
- case 0:
227
- byCollection = {};
228
- totalTombstones = 0;
229
- totalMarkers = 0;
230
- _d.label = 1;
231
- case 1:
232
- _d.trys.push([1, 6, 7, 8]);
233
- _a = __values((0, registry_1.getSyncRegistry)()), _b = _a.next();
234
- _d.label = 2;
235
- case 2:
236
- if (!!_b.done) return [3 /*break*/, 5];
237
- entry = _b.value;
238
- return [4 /*yield*/, (0, exports.compactEntryTombstones)(entry)];
239
- case 3:
240
- counts = _d.sent();
241
- byCollection[entry.collectionTag] = counts;
242
- totalTombstones += counts.tombstones;
243
- totalMarkers += counts.markers;
244
- logger_1.logger.info("[sync] Compacted tombstones", {
245
- collection: entry.collectionTag,
246
- markers: counts.markers,
247
- tombstones: counts.tombstones,
248
- });
249
- _d.label = 4;
250
- case 4:
251
- _b = _a.next();
252
- return [3 /*break*/, 2];
253
- case 5: return [3 /*break*/, 8];
254
- case 6:
255
- e_4_1 = _d.sent();
256
- e_4 = { error: e_4_1 };
257
- return [3 /*break*/, 8];
258
- case 7:
259
- try {
260
- if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
261
- }
262
- finally { if (e_4) throw e_4.error; }
263
- return [7 /*endfinally*/];
264
- case 8: return [2 /*return*/, { byCollection: byCollection, totalMarkers: totalMarkers, totalTombstones: totalTombstones }];
265
- }
266
- });
267
- }); };
106
+ const compactTombstones = async () => {
107
+ const byCollection = {};
108
+ let totalTombstones = 0;
109
+ let totalMarkers = 0;
110
+ for (const entry of (0, registry_1.getSyncRegistry)()) {
111
+ const counts = await (0, exports.compactEntryTombstones)(entry);
112
+ byCollection[entry.collectionTag] = counts;
113
+ totalTombstones += counts.tombstones;
114
+ totalMarkers += counts.markers;
115
+ logger_1.logger.info("[sync] Compacted tombstones", {
116
+ collection: entry.collectionTag,
117
+ markers: counts.markers,
118
+ tombstones: counts.tombstones,
119
+ });
120
+ }
121
+ return { byCollection, totalMarkers, totalTombstones };
122
+ };
268
123
  exports.compactTombstones = compactTombstones;
@@ -1,40 +1,4 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
37
- };
38
2
  Object.defineProperty(exports, "__esModule", { value: true });
39
3
  exports.serializeSyncPayload = void 0;
40
4
  /**
@@ -48,26 +12,22 @@ exports.serializeSyncPayload = void 0;
48
12
  * import cycle. Accepts hydrated Mongoose documents and the raw BSON objects change
49
13
  * streams deliver (which have neither `toObject` nor `toJSON`).
50
14
  */
51
- var serializeSyncPayload = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
52
- var maybeHydrated, plain;
53
- var entry = _b.entry, doc = _b.doc, _c = _b.method, method = _c === void 0 ? "update" : _c, req = _b.req;
54
- return __generator(this, function (_d) {
55
- maybeHydrated = doc;
56
- plain = typeof maybeHydrated.toObject === "function" ? maybeHydrated.toObject() : doc;
57
- if (entry.config.responseHandler) {
58
- return [2 /*return*/, entry.config.responseHandler(plain, method)];
59
- }
60
- if (entry.options.responseHandler) {
61
- // C8: sync serializes a SINGLE entity (snapshot row, conflict doc, or delta), so the
62
- // modelRouter responseHandler must run with single-entity `"read"` semantics — not
63
- // the hardcoded `"list"`, which can trigger list-only shaping (field trimming, array
64
- // wrapping) that corrupts a single-doc payload.
65
- return [2 /*return*/, entry.options.responseHandler(doc, "read", req, entry.options)];
66
- }
67
- if (typeof maybeHydrated.toJSON === "function") {
68
- return [2 /*return*/, maybeHydrated.toJSON()];
69
- }
70
- return [2 /*return*/, plain];
71
- });
72
- }); };
15
+ const serializeSyncPayload = async ({ entry, doc, method = "update", req, }) => {
16
+ const maybeHydrated = doc;
17
+ const plain = typeof maybeHydrated.toObject === "function" ? maybeHydrated.toObject() : doc;
18
+ if (entry.config.responseHandler) {
19
+ return entry.config.responseHandler(plain, method);
20
+ }
21
+ if (entry.options.responseHandler) {
22
+ // C8: sync serializes a SINGLE entity (snapshot row, conflict doc, or delta), so the
23
+ // modelRouter responseHandler must run with single-entity `"read"` semantics — not
24
+ // the hardcoded `"list"`, which can trigger list-only shaping (field trimming, array
25
+ // wrapping) that corrupts a single-doc payload.
26
+ return entry.options.responseHandler(doc, "read", req, entry.options);
27
+ }
28
+ if (typeof maybeHydrated.toJSON === "function") {
29
+ return maybeHydrated.toJSON();
30
+ }
31
+ return plain;
32
+ };
73
33
  exports.serializeSyncPayload = serializeSyncPayload;
@@ -4,17 +4,23 @@ import type { SyncAppOptions } from "./routes";
4
4
  /**
5
5
  * Socket handlers for the SyncDB local-first protocol:
6
6
  *
7
- * - `sync:subscribe {collections}` / `sync:unsubscribe {collections}` — resolves the
7
+ * - `sync:subscribe {collections, mode?}` / `sync:unsubscribe {collections}` — resolves the
8
8
  * caller's streams from the sync registry scope config and joins/leaves `sync:{stream}`
9
9
  * rooms. Owner scopes always use the socket's own userId (never a client-supplied one);
10
10
  * tenant and custom scopes resolve stream values via `SyncAppOptions.getUserScopes`.
11
+ * `mode: "window"` joins `{collection}|admin` only (requires `adminBroadcast` and
12
+ * admin panel access: `admin:access` when `SyncApp` has `accessControl`, else
13
+ * `user.admin`). When AdminApp has registered a broadcast scope, list
14
+ * permission for that model is required as well. Confirms with
15
+ * `sync:subscribed {mode: "window"}` without dumping snapshot pages.
11
16
  * Sync deltas fan out through these dedicated `sync:{stream}` rooms rather than the
12
17
  * legacy realtime rooms so the two event families never overlap.
13
18
  * - `sync:mutate` — applies a mutation through `applySyncMutation` and replies with
14
19
  * `sync:ack {mutationId, id, seq}` or `sync:nack {mutationId, code, ...}`; when the
15
20
  * client supplied a Socket.io ack callback it also receives `{ack}` / `{nack}`.
16
21
  * - `sync:error {collection, message}` — emitted for per-collection subscribe failures
17
- * (unknown collection, permission denied, missing scope resolver, cap exceeded).
22
+ * (unknown collection, permission denied, non-admin window subscribe, missing scope
23
+ * resolver, cap exceeded).
18
24
  *
19
25
  * ## Wiring
20
26
  *