@terreno/api 57.2.0 → 57.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,5 +1,3 @@
1
- // noExplicitAny: test mocks use dynamic shapes for sockets, io, and documents
2
- // biome-ignore-all lint/suspicious/noExplicitAny: test mocks use dynamic shapes for sockets, io, and documents
3
1
  /**
4
2
  * Tests for the sync socket layer (Tasks 2.3–2.5):
5
3
  * - socketHandlers.ts (sync:subscribe / sync:unsubscribe / sync:mutate, caps, rate limit)
@@ -11,7 +9,9 @@
11
9
  */
12
10
 
13
11
  import {afterEach, beforeAll, beforeEach, describe, expect, it} from "bun:test";
14
- import mongoose, {model, Schema} from "mongoose";
12
+ import {assert} from "chai";
13
+ import mongoose, {type Model, model, Schema} from "mongoose";
14
+ import type {Server} from "socket.io";
15
15
 
16
16
  import type {ModelRouterOptions} from "../api";
17
17
  import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
@@ -23,6 +23,7 @@ import {
23
23
  import {clearRealtimeRegistry, registerRealtime} from "../realtime/registry";
24
24
  import {setupDb} from "../tests";
25
25
  import {defaultResponseHandler} from "../transformers";
26
+ import {registerAdminBroadcastScope} from "./adminBroadcastScope";
26
27
  import {SyncCounter, SyncMutation, SyncScopeMove} from "./models";
27
28
  import {MAX_SYNC_MUTATIONS_PER_BATCH} from "./mutationHandler";
28
29
  import {
@@ -108,7 +109,7 @@ const permissiveOptions = {
108
109
  read: [() => true],
109
110
  update: [() => true],
110
111
  },
111
- } as unknown as ModelRouterOptions<any>;
112
+ } as unknown as ModelRouterOptions<unknown>;
112
113
 
113
114
  const adminOnlyOptions = {
114
115
  permissions: {
@@ -118,7 +119,7 @@ const adminOnlyOptions = {
118
119
  read: [(_m: string, user?: {admin?: boolean}) => user?.admin === true],
119
120
  update: [(_m: string, user?: {admin?: boolean}) => user?.admin === true],
120
121
  },
121
- } as unknown as ModelRouterOptions<any>;
122
+ } as unknown as ModelRouterOptions<unknown>;
122
123
 
123
124
  const ownerReadOptions = {
124
125
  permissions: {
@@ -131,31 +132,32 @@ const ownerReadOptions = {
131
132
  ],
132
133
  update: [() => true],
133
134
  },
134
- } as unknown as ModelRouterOptions<any>;
135
+ } as unknown as ModelRouterOptions<unknown>;
135
136
 
136
137
  /**
137
138
  * A minimal fake Mongoose model satisfying registerSync's schema/collection checks, for
138
139
  * tests that need many registrations (each real registration requires a distinct
139
140
  * compiled model).
140
141
  */
141
- const makeFakeSyncModel = (name: string): any => ({
142
- collection: {
143
- collectionName: name.toLowerCase(),
144
- createIndex: async () => {},
145
- },
146
- modelName: name,
147
- schema: {
148
- path: (p: string) => {
149
- if (p === "deleted") {
150
- return {instance: "Boolean"};
151
- }
152
- if (p === "_syncSeq") {
153
- return {instance: "Number"};
154
- }
155
- return undefined;
142
+ const makeFakeSyncModel = (name: string): Model<unknown> =>
143
+ ({
144
+ collection: {
145
+ collectionName: name.toLowerCase(),
146
+ createIndex: async () => {},
156
147
  },
157
- },
158
- });
148
+ modelName: name,
149
+ schema: {
150
+ path: (p: string) => {
151
+ if (p === "deleted") {
152
+ return {instance: "Boolean"};
153
+ }
154
+ if (p === "_syncSeq") {
155
+ return {instance: "Number"};
156
+ }
157
+ return undefined;
158
+ },
159
+ },
160
+ }) as unknown as Model<unknown>;
159
161
 
160
162
  // The shared test database can be dropped by another test file mid-suite
161
163
  // (configurationPlugin.test.ts drops it in an afterAll); rebuild the unique indexes the
@@ -168,19 +170,19 @@ const registerAll = (): void => {
168
170
  clearSyncRegistry();
169
171
  registerSync({
170
172
  config: {scope: {type: "owner"}},
171
- model: SockStuffModel as any,
173
+ model: SockStuffModel as unknown as Model<unknown>,
172
174
  options: permissiveOptions,
173
175
  routePath: "/sockStuff",
174
176
  });
175
177
  registerSync({
176
178
  config: {scope: {field: "orgId", type: "tenant"}},
177
- model: SockProjectModel as any,
179
+ model: SockProjectModel as unknown as Model<unknown>,
178
180
  options: permissiveOptions,
179
181
  routePath: "/sockProjects",
180
182
  });
181
183
  registerSync({
182
184
  config: {scope: {type: "broadcast"}},
183
- model: SockNewsModel as any,
185
+ model: SockNewsModel as unknown as Model<unknown>,
184
186
  options: permissiveOptions,
185
187
  routePath: "/sockNews",
186
188
  });
@@ -190,17 +192,19 @@ const registerAll = (): void => {
190
192
  // Mock socket (realtime.test.ts conventions)
191
193
  // ─────────────────────────────────────────────────────────────────────────────
192
194
 
195
+ type SyncSocketListener = (...args: never[]) => void | Promise<void>;
196
+
193
197
  interface MockSocket extends SyncSocketLike {
194
198
  rooms: Set<string>;
195
199
  emitted: {event: string; payload: unknown}[];
196
- listeners: Map<string, (...args: any[]) => any>;
197
- trigger: (event: string, ...args: any[]) => Promise<void>;
200
+ listeners: Map<string, SyncSocketListener>;
201
+ trigger: (event: string, ...args: unknown[]) => Promise<void>;
198
202
  }
199
203
 
200
204
  const createMockSocket = (decodedToken?: {id?: string; admin?: boolean}): MockSocket => {
201
205
  const rooms = new Set<string>();
202
206
  const emitted: {event: string; payload: unknown}[] = [];
203
- const listeners = new Map<string, (...args: any[]) => any>();
207
+ const listeners = new Map<string, SyncSocketListener>();
204
208
 
205
209
  const socket: MockSocket = {
206
210
  decodedToken,
@@ -223,7 +227,7 @@ const createMockSocket = (decodedToken?: {id?: string; admin?: boolean}): MockSo
223
227
  trigger: async (event, ...args) => {
224
228
  const handler = listeners.get(event);
225
229
  if (handler) {
226
- await handler(...args);
230
+ await (handler as (...handlerArgs: unknown[]) => void | Promise<void>)(...args);
227
231
  }
228
232
  },
229
233
  };
@@ -232,7 +236,9 @@ const createMockSocket = (decodedToken?: {id?: string; admin?: boolean}): MockSo
232
236
  };
233
237
 
234
238
  const syncErrors = (socket: MockSocket): Array<{collection: string; message: string}> =>
235
- socket.emitted.filter((e) => e.event === "sync:error").map((e) => e.payload as any);
239
+ socket.emitted
240
+ .filter((e) => e.event === "sync:error")
241
+ .map((e) => e.payload as {collection: string; message: string});
236
242
 
237
243
  const install = (socket: MockSocket, options: SyncAppOptions = {}): void => {
238
244
  installSyncSocketHandlers(null, socket, options);
@@ -267,11 +273,107 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
267
273
  });
268
274
  });
269
275
 
276
+ it("window mode joins {collection}|admin and does not emit snapshot pages", async () => {
277
+ clearSyncRegistry();
278
+ registerSync({
279
+ config: {adminBroadcast: true, scope: {type: "owner"}},
280
+ model: SockStuffModel as unknown as Model<unknown>,
281
+ options: ownerReadOptions,
282
+ routePath: "/sockStuff",
283
+ });
284
+ const socket = createMockSocket({admin: true, id: "user1"});
285
+ install(socket);
286
+ await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
287
+
288
+ assert.isTrue(socket.rooms.has("sync:sockStuff|admin"));
289
+ assert.isFalse(socket.rooms.has("sync:sockStuff|owner:user1"));
290
+ const subscribed = socket.emitted.filter((e) => e.event === "sync:subscribed");
291
+ assert.deepEqual(
292
+ subscribed.map((e) => e.payload),
293
+ [{collection: "sockStuff", mode: "window", streams: ["sockStuff|admin"]}]
294
+ );
295
+ const snapshotLike = socket.emitted.filter(
296
+ (e) => e.event.includes("snapshot") || (e.payload as {entities?: unknown})?.entities
297
+ );
298
+ assert.deepEqual(snapshotLike, []);
299
+ });
300
+
301
+ it("nacks window subscribe when the caller is not admin", async () => {
302
+ clearSyncRegistry();
303
+ registerSync({
304
+ config: {adminBroadcast: true, scope: {type: "owner"}},
305
+ model: SockStuffModel as unknown as Model<unknown>,
306
+ options: ownerReadOptions,
307
+ routePath: "/sockStuff",
308
+ });
309
+ const socket = createMockSocket({admin: false, id: "user1"});
310
+ install(socket);
311
+ await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
312
+
313
+ assert.isFalse(socket.rooms.has("sync:sockStuff|admin"));
314
+ assert.deepEqual(
315
+ socket.emitted.filter((e) => e.event === "sync:subscribed"),
316
+ []
317
+ );
318
+ const errors = syncErrors(socket);
319
+ assert.equal(errors.length, 1);
320
+ assert.equal(errors[0].collection, "sockStuff");
321
+ assert.match(errors[0].message, /admin/i);
322
+ });
323
+
324
+ it("nacks window subscribe when accessControl denies admin:access", async () => {
325
+ clearSyncRegistry();
326
+ registerSync({
327
+ config: {adminBroadcast: true, scope: {type: "owner"}},
328
+ model: SockStuffModel as unknown as Model<unknown>,
329
+ options: ownerReadOptions,
330
+ routePath: "/sockStuff",
331
+ });
332
+ const socket = createMockSocket({admin: true, id: "user1"});
333
+ install(socket, {
334
+ accessControl: {
335
+ can: async () => ({allowed: false}),
336
+ } as never,
337
+ });
338
+ await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
339
+
340
+ assert.isFalse(socket.rooms.has("sync:sockStuff|admin"));
341
+ assert.deepEqual(
342
+ socket.emitted.filter((e) => e.event === "sync:subscribed"),
343
+ []
344
+ );
345
+ const errors = syncErrors(socket);
346
+ assert.equal(errors.length, 1);
347
+ assert.match(errors[0].message, /admin panel access/i);
348
+ });
349
+
350
+ it("nacks window subscribe when AdminApp list permission is denied", async () => {
351
+ clearSyncRegistry();
352
+ registerSync({
353
+ config: {adminBroadcast: true, scope: {type: "owner"}},
354
+ model: SockStuffModel as unknown as Model<unknown>,
355
+ options: ownerReadOptions,
356
+ routePath: "/sockStuff",
357
+ });
358
+ registerAdminBroadcastScope("SockStuff", {
359
+ listPermissions: [() => false],
360
+ readPermissions: [() => true],
361
+ });
362
+ const socket = createMockSocket({admin: true, id: "user1"});
363
+ install(socket);
364
+ await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
365
+
366
+ assert.isFalse(socket.rooms.has("sync:sockStuff|admin"));
367
+ const errors = syncErrors(socket);
368
+ assert.equal(errors.length, 1);
369
+ assert.match(errors[0].message, /admin collection access/i);
370
+ });
371
+
270
372
  it("owner scope never uses a client-supplied user id", async () => {
271
373
  const socket = createMockSocket({id: "user1"});
272
374
  install(socket);
273
375
  // The payload has no place for a user id — assert the room is keyed by the token id.
274
- await socket.trigger("sync:subscribe", {collections: ["sockStuff"], userId: "victim"} as any);
376
+ await socket.trigger("sync:subscribe", {collections: ["sockStuff"], userId: "victim"});
275
377
  expect(socket.rooms.has("sync:sockStuff|owner:user1")).toBe(true);
276
378
  expect(Array.from(socket.rooms).some((r) => r.includes("victim"))).toBe(false);
277
379
  });
@@ -375,7 +477,7 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
375
477
  clearSyncRegistry();
376
478
  registerSync({
377
479
  config: {scope: {type: "owner"}},
378
- model: SockStuffModel as any,
480
+ model: SockStuffModel as unknown as Model<unknown>,
379
481
  options: adminOnlyOptions,
380
482
  routePath: "/sockStuff",
381
483
  });
@@ -390,7 +492,7 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
390
492
  clearSyncRegistry();
391
493
  registerSync({
392
494
  config: {scope: {type: "owner"}},
393
- model: SockStuffModel as any,
495
+ model: SockStuffModel as unknown as Model<unknown>,
394
496
  options: adminOnlyOptions,
395
497
  routePath: "/sockStuff",
396
498
  });
@@ -481,7 +583,9 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
481
583
  // Re-subscribing after unsubscribe emits a fresh sync:subscribed.
482
584
  await socket.trigger("sync:subscribe", {collections: ["sockProjects"]});
483
585
  const subscribedEvents = socket.emitted.filter(
484
- (e) => e.event === "sync:subscribed" && (e.payload as any).collection === "sockProjects"
586
+ (e) =>
587
+ e.event === "sync:subscribed" &&
588
+ (e.payload as {collection?: string}).collection === "sockProjects"
485
589
  );
486
590
  expect(subscribedEvents).toHaveLength(2);
487
591
  });
@@ -593,7 +697,7 @@ describe("installSyncSocketHandlers — sync:mutate", () => {
593
697
  const nack = lastNack(socket);
594
698
  expect(nack?.code).toBe("conflict");
595
699
  expect(nack?.serverSeq).toBe(2);
596
- expect((nack?.serverDoc as any)?.name).toBe("v2");
700
+ expect((nack?.serverDoc as {name?: string} | undefined)?.name).toBe("v2");
597
701
  });
598
702
 
599
703
  it("duplicate mutationId over the socket returns the recorded outcome without re-applying", async () => {
@@ -701,10 +805,13 @@ describe("installSyncSocketHandlers — sync:mutateBatch", () => {
701
805
  socket: MockSocket,
702
806
  mutations: unknown[]
703
807
  ): Promise<{results: Array<{type: string; ack?: SyncAck; nack?: SyncNack}>}> => {
704
- let response: any;
808
+ let response: {results: Array<{type: string; ack?: SyncAck; nack?: SyncNack}>} | undefined;
705
809
  await socket.trigger("sync:mutateBatch", {mutations}, (res: unknown) => {
706
- response = res;
810
+ response = res as {results: Array<{type: string; ack?: SyncAck; nack?: SyncNack}>};
707
811
  });
812
+ if (!response) {
813
+ throw new Error("sync:mutateBatch did not invoke the ack callback");
814
+ }
708
815
  return response;
709
816
  };
710
817
 
@@ -896,10 +1003,29 @@ describe("SyncAppOptions context", () => {
896
1003
  // sync:delta emission — mock io helpers
897
1004
  // ─────────────────────────────────────────────────────────────────────────────
898
1005
 
899
- const makeTrackedIo = (): any => {
900
- const emissions: Array<{event: string; payload: any; room: string; socketId: string}> = [];
1006
+ interface TrackedEmission {
1007
+ event: string;
1008
+ payload: unknown;
1009
+ room: string;
1010
+ socketId: string;
1011
+ }
1012
+
1013
+ interface TrackedSocket {
1014
+ decodedToken?: {id?: string; admin?: boolean};
1015
+ emit: (event: string, payload: unknown) => void;
1016
+ id: string;
1017
+ }
1018
+
1019
+ /** A Socket.io server stand-in that records every emission it receives. */
1020
+ type TrackedIo = Server & {
1021
+ addSocketToRoom: (room: string, decodedToken?: {id?: string; admin?: boolean}) => void;
1022
+ emissions: TrackedEmission[];
1023
+ };
1024
+
1025
+ const makeTrackedIo = (): TrackedIo => {
1026
+ const emissions: TrackedEmission[] = [];
901
1027
  const rooms = new Map<string, Set<string>>();
902
- const sockets = new Map<string, any>();
1028
+ const sockets = new Map<string, TrackedSocket>();
903
1029
 
904
1030
  const addSocketToRoom = (
905
1031
  room: string,
@@ -931,15 +1057,18 @@ const makeTrackedIo = (): any => {
931
1057
  emissions.push({event, payload, room, socketId: "broadcast"});
932
1058
  },
933
1059
  }),
934
- };
1060
+ } as unknown as TrackedIo;
935
1061
  };
936
1062
 
937
- const makeChange = (overrides: Record<string, unknown>): any => ({
938
- documentKey: {_id: "doc-1"},
939
- ns: {coll: "sockstuffs"},
940
- operationType: "insert",
941
- ...overrides,
942
- });
1063
+ type WatchedChange = Parameters<typeof emitSyncDeltaForChange>[0]["change"];
1064
+
1065
+ const makeChange = (overrides: Record<string, unknown>): WatchedChange =>
1066
+ ({
1067
+ documentKey: {_id: "doc-1"},
1068
+ ns: {coll: "sockstuffs"},
1069
+ operationType: "insert",
1070
+ ...overrides,
1071
+ }) as unknown as WatchedChange;
943
1072
 
944
1073
  // ─────────────────────────────────────────────────────────────────────────────
945
1074
  // emitSyncDeltaForChange — unit tests with synthetic changes
@@ -962,7 +1091,7 @@ describe("emitSyncDeltaForChange", () => {
962
1091
  clearSyncRegistry();
963
1092
  registerSync({
964
1093
  config: {scope: {type: "owner"}},
965
- model: SockStuffModel as any,
1094
+ model: SockStuffModel as unknown as Model<unknown>,
966
1095
  options: ownerReadOptions,
967
1096
  routePath: "/sockStuff",
968
1097
  });
@@ -985,15 +1114,109 @@ describe("emitSyncDeltaForChange", () => {
985
1114
  logDebug: () => {},
986
1115
  });
987
1116
 
988
- const deltas = io.emissions.filter((e: any) => e.event === "sync:delta");
1117
+ const deltas = io.emissions.filter((e) => e.event === "sync:delta");
989
1118
  expect(deltas).toHaveLength(1);
990
1119
  const delta = deltas[0].payload as SyncDelta;
991
1120
  expect(delta.method).toBe("create");
992
1121
  expect(delta.seq).toBe(7);
993
1122
  expect(delta.stream).toBe("sockStuff|owner:user1");
994
1123
  expect(delta.collection).toBe("sockStuff");
995
- expect((delta.data as any).name).toBe("hello");
996
- expect((delta.data as any).id).toBe("doc-1");
1124
+ expect((delta.data as Record<string, unknown>).name).toBe("hello");
1125
+ expect((delta.data as Record<string, unknown>).id).toBe("doc-1");
1126
+ });
1127
+
1128
+ it("adminBroadcast true: create also emits to {collection}|admin", async () => {
1129
+ clearSyncRegistry();
1130
+ registerSync({
1131
+ config: {adminBroadcast: true, scope: {type: "owner"}},
1132
+ model: SockStuffModel as unknown as Model<unknown>,
1133
+ options: ownerReadOptions,
1134
+ routePath: "/sockStuff",
1135
+ });
1136
+ const entry = findSyncEntryByCollectionTag("sockStuff") as SyncRegistryEntry;
1137
+ const io = makeTrackedIo();
1138
+ io.addSocketToRoom(syncRoomForStream("sockStuff|owner:user1"), {admin: false, id: "user1"});
1139
+ io.addSocketToRoom(syncRoomForStream("sockStuff|admin"), {admin: true, id: "admin1"});
1140
+
1141
+ await emitSyncDeltaForChange({
1142
+ change: makeChange({
1143
+ fullDocument: {_id: "doc-admin-fan", _syncSeq: 11, name: "hello", ownerId: "user1"},
1144
+ operationType: "insert",
1145
+ }),
1146
+ docId: "doc-admin-fan",
1147
+ entry,
1148
+ io,
1149
+ logDebug: () => {},
1150
+ });
1151
+
1152
+ const deltas = io.emissions
1153
+ .filter((e) => e.event === "sync:delta")
1154
+ .map((e) => e.payload as SyncDelta);
1155
+ const streams = deltas.map((d) => d.stream).sort();
1156
+ assert.deepEqual(streams, ["sockStuff|admin", "sockStuff|owner:user1"]);
1157
+ const adminDelta = deltas.find((d) => d.stream === "sockStuff|admin");
1158
+ const ownerDelta = deltas.find((d) => d.stream === "sockStuff|owner:user1");
1159
+ assert.strictEqual(adminDelta?.method, "create");
1160
+ assert.strictEqual(adminDelta?.seq, 11);
1161
+ assert.strictEqual(ownerDelta?.method, "create");
1162
+ assert.strictEqual(ownerDelta?.seq, 11);
1163
+ });
1164
+
1165
+ it("adminBroadcast room skips sockets excluded by AdminApp queryFilter", async () => {
1166
+ clearSyncRegistry();
1167
+ registerSync({
1168
+ config: {adminBroadcast: true, scope: {type: "owner"}},
1169
+ model: SockStuffModel as unknown as Model<unknown>,
1170
+ options: ownerReadOptions,
1171
+ routePath: "/sockStuff",
1172
+ });
1173
+ registerAdminBroadcastScope("SockStuff", {
1174
+ listPermissions: [() => true],
1175
+ queryFilter: () => ({ownerId: "acme"}),
1176
+ readPermissions: [() => true],
1177
+ });
1178
+ const entry = findSyncEntryByCollectionTag("sockStuff") as SyncRegistryEntry;
1179
+ const io = makeTrackedIo();
1180
+ io.addSocketToRoom(syncRoomForStream("sockStuff|admin"), {admin: true, id: "admin1"});
1181
+
1182
+ await emitSyncDeltaForChange({
1183
+ change: makeChange({
1184
+ fullDocument: {_id: "doc-other-tenant", _syncSeq: 12, name: "hello", ownerId: "user1"},
1185
+ operationType: "insert",
1186
+ }),
1187
+ docId: "doc-other-tenant",
1188
+ entry,
1189
+ io,
1190
+ logDebug: () => {},
1191
+ });
1192
+
1193
+ const adminDeltas = io.emissions.filter(
1194
+ (e) => e.event === "sync:delta" && (e.payload as SyncDelta).stream === "sockStuff|admin"
1195
+ );
1196
+ assert.deepEqual(adminDeltas, []);
1197
+ });
1198
+
1199
+ it("adminBroadcast false: create emits only the owner stream", async () => {
1200
+ const entry = ownerEntry();
1201
+ const io = makeTrackedIo();
1202
+ io.addSocketToRoom(syncRoomForStream("sockStuff|owner:user1"), {admin: false, id: "user1"});
1203
+ io.addSocketToRoom(syncRoomForStream("sockStuff|admin"), {admin: true, id: "admin1"});
1204
+
1205
+ await emitSyncDeltaForChange({
1206
+ change: makeChange({
1207
+ fullDocument: {_id: "doc-no-fan", _syncSeq: 2, name: "hello", ownerId: "user1"},
1208
+ operationType: "insert",
1209
+ }),
1210
+ docId: "doc-no-fan",
1211
+ entry,
1212
+ io,
1213
+ logDebug: () => {},
1214
+ });
1215
+
1216
+ const streams = io.emissions
1217
+ .filter((e) => e.event === "sync:delta")
1218
+ .map((e) => (e.payload as SyncDelta).stream);
1219
+ assert.deepEqual(streams, ["sockStuff|owner:user1"]);
997
1220
  });
998
1221
 
999
1222
  it("emits a delta when the REST responseHandler serializes a BSON post-image", async () => {
@@ -1040,7 +1263,7 @@ describe("emitSyncDeltaForChange", () => {
1040
1263
  logDebug: () => {},
1041
1264
  });
1042
1265
 
1043
- const deltas = io.emissions.filter((e: any) => e.event === "sync:delta");
1266
+ const deltas = io.emissions.filter((e) => e.event === "sync:delta");
1044
1267
  expect(deltas).toHaveLength(1);
1045
1268
  const receiver = io.sockets.sockets.get(deltas[0].socketId);
1046
1269
  expect(receiver.decodedToken.id).toBe("user1");
@@ -1063,7 +1286,7 @@ describe("emitSyncDeltaForChange", () => {
1063
1286
  logDebug: () => {},
1064
1287
  });
1065
1288
 
1066
- const deltas = io.emissions.filter((e: any) => e.event === "sync:delta");
1289
+ const deltas = io.emissions.filter((e) => e.event === "sync:delta");
1067
1290
  expect(deltas).toHaveLength(1);
1068
1291
  const delta = deltas[0].payload as SyncDelta;
1069
1292
  expect(delta.method).toBe("delete");
@@ -1107,20 +1330,20 @@ describe("emitSyncDeltaForChange", () => {
1107
1330
  logDebug: () => {},
1108
1331
  });
1109
1332
 
1110
- const deltas = io.emissions.filter((e: any) => e.event === "sync:delta");
1333
+ const deltas = io.emissions.filter((e) => e.event === "sync:delta");
1111
1334
  expect(deltas).toHaveLength(2);
1112
1335
 
1113
- const tombstone = deltas.find((e: any) => e.room === oldRoom)?.payload as SyncDelta;
1336
+ const tombstone = deltas.find((e) => e.room === oldRoom)?.payload as SyncDelta;
1114
1337
  expect(tombstone.method).toBe("delete");
1115
1338
  expect(tombstone.deleted).toBe(true);
1116
1339
  expect(tombstone.stream).toBe("sockStuff|owner:user1");
1117
1340
  expect(tombstone.seq).toBe(9);
1118
1341
  expect(tombstone.data).toBeUndefined();
1119
1342
 
1120
- const create = deltas.find((e: any) => e.room === newRoom)?.payload as SyncDelta;
1343
+ const create = deltas.find((e) => e.room === newRoom)?.payload as SyncDelta;
1121
1344
  expect(create.method).toBe("create");
1122
1345
  expect(create.stream).toBe("sockStuff|owner:user2");
1123
- expect((create.data as any).name).toBe("moved");
1346
+ expect((create.data as Record<string, unknown>).name).toBe("moved");
1124
1347
  await SyncScopeMove.deleteMany({});
1125
1348
  });
1126
1349
 
@@ -1161,8 +1384,8 @@ describe("emitSyncDeltaForChange", () => {
1161
1384
  logDebug: () => {},
1162
1385
  });
1163
1386
 
1164
- const deltas = io.emissions.filter((e: any) => e.event === "sync:delta");
1165
- const tombstone = deltas.find((e: any) => e.room === oldRoom)?.payload as SyncDelta;
1387
+ const deltas = io.emissions.filter((e) => e.event === "sync:delta");
1388
+ const tombstone = deltas.find((e) => e.room === oldRoom)?.payload as SyncDelta;
1166
1389
  expect(tombstone).toBeDefined();
1167
1390
  expect(tombstone.method).toBe("delete");
1168
1391
  expect(tombstone.stream).toBe("sockStuff|owner:user1");
@@ -1193,7 +1416,7 @@ describe("emitSyncDeltaForChange", () => {
1193
1416
  logDebug: () => {},
1194
1417
  });
1195
1418
 
1196
- const deltas = io.emissions.filter((e: any) => e.event === "sync:delta");
1419
+ const deltas = io.emissions.filter((e) => e.event === "sync:delta");
1197
1420
  expect(deltas).toHaveLength(1);
1198
1421
  expect((deltas[0].payload as SyncDelta).method).toBe("update");
1199
1422
  });
@@ -1211,7 +1434,44 @@ describe("emitSyncDeltaForChange", () => {
1211
1434
  logDebug: () => {},
1212
1435
  });
1213
1436
 
1214
- expect(io.emissions.filter((e: any) => e.event === "sync:delta")).toHaveLength(0);
1437
+ expect(io.emissions.filter((e) => e.event === "sync:delta")).toHaveLength(0);
1438
+ });
1439
+
1440
+ it("logs and skips changes without a full document", async () => {
1441
+ const entry = ownerEntry();
1442
+ const io = makeTrackedIo();
1443
+ const logs: string[] = [];
1444
+
1445
+ await emitSyncDeltaForChange({
1446
+ change: makeChange({operationType: "update"}),
1447
+ docId: "doc-no-image",
1448
+ entry,
1449
+ io,
1450
+ logDebug: (message) => logs.push(message),
1451
+ });
1452
+
1453
+ assert.deepEqual(logs, ["[sync] Skipping sockStuff/doc-no-image: change has no fullDocument"]);
1454
+ assert.isEmpty(io.emissions);
1455
+ });
1456
+
1457
+ it("skips changes whose operation type does not map to a sync method", async () => {
1458
+ const entry = ownerEntry();
1459
+ const io = makeTrackedIo();
1460
+ const logs: string[] = [];
1461
+
1462
+ await emitSyncDeltaForChange({
1463
+ change: makeChange({
1464
+ fullDocument: {_id: "doc-invalid", _syncSeq: 1, ownerId: "user1"},
1465
+ operationType: "invalidate",
1466
+ }),
1467
+ docId: "doc-invalid",
1468
+ entry,
1469
+ io,
1470
+ logDebug: (message) => logs.push(message),
1471
+ });
1472
+
1473
+ assert.isEmpty(logs);
1474
+ assert.isEmpty(io.emissions);
1215
1475
  });
1216
1476
 
1217
1477
  it("applies the sync responseHandler to delta data", async () => {
@@ -1221,7 +1481,7 @@ describe("emitSyncDeltaForChange", () => {
1221
1481
  responseHandler: (doc: Record<string, unknown>) => ({onlyName: doc.name}),
1222
1482
  scope: {type: "owner"},
1223
1483
  },
1224
- model: SockStuffModel as any,
1484
+ model: SockStuffModel as unknown as Model<unknown>,
1225
1485
  options: permissiveOptions,
1226
1486
  routePath: "/sockStuff",
1227
1487
  });
@@ -1239,7 +1499,7 @@ describe("emitSyncDeltaForChange", () => {
1239
1499
  logDebug: () => {},
1240
1500
  });
1241
1501
 
1242
- const delta = io.emissions.find((e: any) => e.event === "sync:delta")?.payload as SyncDelta;
1502
+ const delta = io.emissions.find((e) => e.event === "sync:delta")?.payload as SyncDelta;
1243
1503
  expect(delta.data).toEqual({onlyName: "shaped"});
1244
1504
  });
1245
1505
  });
@@ -1263,20 +1523,20 @@ const hasReplicaSet = async (): Promise<boolean> => {
1263
1523
  * Start the watcher and give the change-stream cursor a moment to open so writes made
1264
1524
  * immediately afterwards are not missed (change streams only deliver post-open events).
1265
1525
  */
1266
- const startWatcherAndSettle = async (io: any): Promise<void> => {
1526
+ const startWatcherAndSettle = async (io: TrackedIo): Promise<void> => {
1267
1527
  startChangeStreamWatcher(io, {}, true);
1268
1528
  await new Promise((resolve) => setTimeout(resolve, 300));
1269
1529
  };
1270
1530
 
1271
1531
  const waitForDelta = async (
1272
- io: any,
1273
- predicate: (delta: SyncDelta, emission: any) => boolean,
1532
+ io: TrackedIo,
1533
+ predicate: (delta: SyncDelta, emission: TrackedEmission) => boolean,
1274
1534
  timeoutMs = 5000
1275
1535
  ): Promise<void> => {
1276
1536
  const start = Date.now();
1277
1537
  while (Date.now() - start < timeoutMs) {
1278
1538
  const match = io.emissions.some(
1279
- (e: any) => e.event === "sync:delta" && predicate(e.payload as SyncDelta, e)
1539
+ (e) => e.event === "sync:delta" && predicate(e.payload as SyncDelta, e)
1280
1540
  );
1281
1541
  if (match) {
1282
1542
  return;
@@ -1330,8 +1590,8 @@ describe("sync:delta — change stream integration", () => {
1330
1590
  await waitForDelta(io, (d) => d.id === docId && d.method === "delete");
1331
1591
 
1332
1592
  const deltas = io.emissions
1333
- .filter((e: any) => e.event === "sync:delta")
1334
- .map((e: any) => e.payload as SyncDelta);
1593
+ .filter((e) => e.event === "sync:delta")
1594
+ .map((e) => e.payload as SyncDelta);
1335
1595
 
1336
1596
  const creates = deltas.filter((d) => d.method === "create");
1337
1597
  const updates = deltas.filter((d) => d.method === "update");
@@ -1348,7 +1608,7 @@ describe("sync:delta — change stream integration", () => {
1348
1608
  expect(delta.collection).toBe("sockStuff");
1349
1609
  }
1350
1610
  expect(deletes[0].deleted).toBe(true);
1351
- expect((deletes[0].data as any).name).toBe("cs-updated");
1611
+ expect((deletes[0].data as Record<string, unknown>).name).toBe("cs-updated");
1352
1612
  });
1353
1613
 
1354
1614
  it("a socket subscribed to tenant org1 never receives org2's delta", async () => {
@@ -1366,8 +1626,8 @@ describe("sync:delta — change stream integration", () => {
1366
1626
  await new Promise((resolve) => setTimeout(resolve, 500));
1367
1627
 
1368
1628
  const deltas = io.emissions
1369
- .filter((e: any) => e.event === "sync:delta")
1370
- .map((e: any) => e.payload as SyncDelta);
1629
+ .filter((e) => e.event === "sync:delta")
1630
+ .map((e) => e.payload as SyncDelta);
1371
1631
  expect(deltas.some((d) => d.id === String(org1Doc._id))).toBe(true);
1372
1632
  expect(deltas.some((d) => d.id === String(org2Doc._id))).toBe(false);
1373
1633
  expect(deltas.every((d) => d.stream === "sockProjects|tenant:org1")).toBe(true);
@@ -1393,10 +1653,10 @@ describe("sync:delta — change stream integration", () => {
1393
1653
  await waitForDelta(io, (d, e) => d.id === docId && e.room === oldRoom);
1394
1654
 
1395
1655
  const deltas = io.emissions.filter(
1396
- (e: any) => e.event === "sync:delta" && (e.payload as SyncDelta).id === docId
1656
+ (e) => e.event === "sync:delta" && (e.payload as SyncDelta).id === docId
1397
1657
  );
1398
- const tombstones = deltas.filter((e: any) => e.room === oldRoom);
1399
- const creates = deltas.filter((e: any) => e.room === newRoom);
1658
+ const tombstones = deltas.filter((e) => e.room === oldRoom);
1659
+ const creates = deltas.filter((e) => e.room === newRoom);
1400
1660
  expect(tombstones).toHaveLength(1);
1401
1661
  expect(creates).toHaveLength(1);
1402
1662
 
@@ -1409,7 +1669,7 @@ describe("sync:delta — change stream integration", () => {
1409
1669
  const create = creates[0].payload as SyncDelta;
1410
1670
  expect(create.method).toBe("create");
1411
1671
  expect(create.stream).toBe("sockProjects|tenant:org2");
1412
- expect((create.data as any).orgId).toBe("org2");
1672
+ expect((create.data as Record<string, unknown>).orgId).toBe("org2");
1413
1673
  });
1414
1674
 
1415
1675
  it("a model with both realtime and sync configs emits both event types", async () => {
@@ -1437,10 +1697,10 @@ describe("sync:delta — change stream integration", () => {
1437
1697
  await waitForDelta(io, (d) => d.id === docId);
1438
1698
 
1439
1699
  const legacy = io.emissions.filter(
1440
- (e: any) => e.event === "sync" && e.payload?.id === docId && e.payload?.method === "create"
1700
+ (e) => e.event === "sync" && e.payload?.id === docId && e.payload?.method === "create"
1441
1701
  );
1442
1702
  const deltas = io.emissions.filter(
1443
- (e: any) => e.event === "sync:delta" && (e.payload as SyncDelta).id === docId
1703
+ (e) => e.event === "sync:delta" && (e.payload as SyncDelta).id === docId
1444
1704
  );
1445
1705
  expect(legacy.length).toBeGreaterThanOrEqual(1);
1446
1706
  expect(deltas).toHaveLength(1);
@@ -1461,8 +1721,8 @@ describe("sync:delta — change stream integration", () => {
1461
1721
  const doc = await SockStuffModel.create({name: "sync only", ownerId: "only-user"});
1462
1722
  await waitForDelta(io, (d) => d.id === String(doc._id));
1463
1723
 
1464
- const deltas = io.emissions.filter((e: any) => e.event === "sync:delta");
1724
+ const deltas = io.emissions.filter((e) => e.event === "sync:delta");
1465
1725
  expect(deltas).toHaveLength(1);
1466
- expect(io.emissions.filter((e: any) => e.event === "sync")).toHaveLength(0);
1726
+ expect(io.emissions.filter((e) => e.event === "sync")).toHaveLength(0);
1467
1727
  });
1468
1728
  });