@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,20 +1,24 @@
1
- // noExplicitAny: test model typing
2
- // biome-ignore-all lint/suspicious/noExplicitAny: test model typing
3
1
  import {beforeAll, beforeEach, describe, expect, it} from "bun:test";
2
+ import {assert} from "chai";
4
3
  import type express from "express";
5
- import {model, Schema, Types} from "mongoose";
4
+ import {type Model, model, Schema, Types} from "mongoose";
6
5
  import supertest from "supertest";
7
6
  import type TestAgent from "supertest/lib/agent";
8
7
  import {type ModelRouterOptions, modelRouter} from "../api";
9
- import {addAuthRoutes, setupAuth} from "../auth";
8
+ import {type UserModel as AuthUserModel, addAuthRoutes, setupAuth} from "../auth";
10
9
  import {APIError} from "../errors";
11
10
  import {OwnerQueryFilter, Permissions} from "../permissions";
12
11
  import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
13
12
  import {authAsUser, getBaseServer, setupDb, UserModel} from "../tests";
13
+ import {registerAdminBroadcastScope} from "./adminBroadcastScope";
14
14
  import {SyncCounter, SyncKey, SyncMutation} from "./models";
15
15
  import {MAX_SYNC_MUTATIONS_PER_BATCH} from "./mutationHandler";
16
- import {clearSyncRegistry, registerSync} from "./registry";
17
- import {MAX_ENTITY_FETCH, MAX_SYNC_HTTP_MUTATIONS_PER_SECOND} from "./routes";
16
+ import {clearSyncRegistry, getSyncRegistry, registerSync, type SyncRegistryEntry} from "./registry";
17
+ import {
18
+ buildSnapshotScopeFilter,
19
+ MAX_ENTITY_FETCH,
20
+ MAX_SYNC_HTTP_MUTATIONS_PER_SECOND,
21
+ } from "./routes";
18
22
  import {SyncApp} from "./syncApp";
19
23
  import {syncPlugin} from "./syncSeqPlugin";
20
24
 
@@ -69,6 +73,41 @@ routeBannerSchema.plugin(createdUpdatedPlugin);
69
73
  routeBannerSchema.plugin(syncPlugin);
70
74
  const RouteBannerModel = model<RouteBanner>("SyncRouteBanner", routeBannerSchema);
71
75
 
76
+ interface RouteNote extends IsDeleted {
77
+ _id: string;
78
+ body: string;
79
+ ownerId: string;
80
+ _syncSeq?: number;
81
+ }
82
+
83
+ // Client-minted string `_id`s (the syncdb default): entity ids are passed through uncast.
84
+ const routeNoteSchema = new Schema<RouteNote>({
85
+ _id: {description: "Client-minted note id", type: String},
86
+ body: {description: "The note body", required: true, type: String},
87
+ ownerId: {description: "The user who owns this note", type: String},
88
+ });
89
+ routeNoteSchema.plugin(isDeletedPlugin);
90
+ routeNoteSchema.plugin(createdUpdatedPlugin);
91
+ routeNoteSchema.plugin(syncPlugin);
92
+ const RouteNoteModel = model<RouteNote>("SyncRouteNote", routeNoteSchema);
93
+
94
+ interface SnapshotEntity {
95
+ id: string;
96
+ seq: number;
97
+ deleted: boolean;
98
+ data: {name: string} | null;
99
+ }
100
+
101
+ interface StreamInfo {
102
+ collection: string;
103
+ stream: string;
104
+ }
105
+
106
+ interface MutationResult {
107
+ type: string;
108
+ ack: {seq: number};
109
+ }
110
+
72
111
  const authedOptions = {
73
112
  permissions: {
74
113
  create: [Permissions.IsAuthenticated],
@@ -77,7 +116,7 @@ const authedOptions = {
77
116
  read: [Permissions.IsAuthenticated],
78
117
  update: [Permissions.IsAuthenticated],
79
118
  },
80
- } as unknown as ModelRouterOptions<any>;
119
+ } as unknown as ModelRouterOptions<unknown>;
81
120
 
82
121
  const adminOnlyOptions = {
83
122
  permissions: {
@@ -87,7 +126,7 @@ const adminOnlyOptions = {
87
126
  read: [Permissions.IsAdmin],
88
127
  update: [Permissions.IsAdmin],
89
128
  },
90
- } as unknown as ModelRouterOptions<any>;
129
+ } as unknown as ModelRouterOptions<unknown>;
91
130
 
92
131
  // The shared test database can be dropped by another test file mid-suite
93
132
  // (configurationPlugin.test.ts drops it in an afterAll); rebuild the unique indexes the
@@ -116,13 +155,13 @@ describe("sync routes", () => {
116
155
  clearSyncRegistry();
117
156
  registerSync({
118
157
  config: {scope: {type: "owner"}},
119
- model: RouteStuffModel as any,
158
+ model: RouteStuffModel as unknown as Model<unknown>,
120
159
  options: authedOptions,
121
160
  routePath: "/routeStuff",
122
161
  });
123
162
  registerSync({
124
163
  config: {scope: {field: "orgId", type: "tenant"}},
125
- model: RouteProjectModel as any,
164
+ model: RouteProjectModel as unknown as Model<unknown>,
126
165
  options: authedOptions,
127
166
  routePath: "/routeProjects",
128
167
  });
@@ -136,8 +175,8 @@ describe("sync routes", () => {
136
175
  ]);
137
176
 
138
177
  app = getBaseServer();
139
- setupAuth(app as any, UserModel as any);
140
- addAuthRoutes(app as any, UserModel as any);
178
+ setupAuth(app, UserModel as unknown as AuthUserModel);
179
+ addAuthRoutes(app, UserModel as unknown as AuthUserModel);
141
180
  new SyncApp({
142
181
  getUserScopes: () => ["org1"],
143
182
  }).register(app);
@@ -189,11 +228,42 @@ describe("sync routes", () => {
189
228
  await agent.get(`/sync/snapshot?stream=${s}&limit=1e9`).expect(400);
190
229
  });
191
230
 
231
+ it("400s for an all-digit cursor that is not a safe integer", async () => {
232
+ const s = encodeURIComponent(ownerStream());
233
+ const res = await agent
234
+ .get(`/sync/snapshot?stream=${s}&cursor=99999999999999999999`)
235
+ .expect(400);
236
+ expect(res.body.title).toMatch(/Invalid cursor/);
237
+ });
238
+
239
+ it("surfaces scope-move markers as tombstones on the old stream (C4)", async () => {
240
+ const doc = await RouteStuffModel.create({name: "moving", ownerId: notAdminId});
241
+ const initial = await agent
242
+ .get(`/sync/snapshot?stream=${encodeURIComponent(ownerStream())}`)
243
+ .expect(200);
244
+ expect(initial.body.entities.map((e: SnapshotEntity) => e.id)).toEqual([String(doc._id)]);
245
+
246
+ doc.ownerId = "someoneElse";
247
+ await doc.save();
248
+
249
+ const res = await agent
250
+ .get(
251
+ `/sync/snapshot?stream=${encodeURIComponent(ownerStream())}&cursor=${initial.body.cursor}`
252
+ )
253
+ .expect(200);
254
+ const tombstone = res.body.entities.find((e: SnapshotEntity) => e.id === String(doc._id));
255
+ expect(tombstone).toBeDefined();
256
+ expect(tombstone.deleted).toBe(true);
257
+ expect(tombstone.data).toBeNull();
258
+ expect(tombstone.seq).toBeGreaterThan(initial.body.cursor);
259
+ expect(res.body.hasMore).toBe(false);
260
+ });
261
+
192
262
  it("enforces the model's list permissions", async () => {
193
263
  clearSyncRegistry();
194
264
  registerSync({
195
265
  config: {scope: {type: "owner"}},
196
- model: RouteStuffModel as any,
266
+ model: RouteStuffModel as unknown as Model<unknown>,
197
267
  options: adminOnlyOptions,
198
268
  routePath: "/routeStuff",
199
269
  });
@@ -217,8 +287,11 @@ describe("sync routes", () => {
217
287
  .expect(200);
218
288
  expect(res.body.stream).toBe(ownerStream());
219
289
  expect(res.body.entities).toHaveLength(2);
220
- expect(res.body.entities.map((e: any) => e.data.name)).toEqual(["mine 1", "mine 2"]);
221
- expect(res.body.entities.map((e: any) => e.seq)).toEqual([1, 2]);
290
+ expect(res.body.entities.map((e: SnapshotEntity) => e.data.name)).toEqual([
291
+ "mine 1",
292
+ "mine 2",
293
+ ]);
294
+ expect(res.body.entities.map((e: SnapshotEntity) => e.seq)).toEqual([1, 2]);
222
295
  expect(res.body.cursor).toBe(2);
223
296
  expect(res.body.hasMore).toBe(false);
224
297
  // C1/C7 response fields present.
@@ -244,8 +317,8 @@ describe("sync routes", () => {
244
317
  .get(`/sync/snapshot?stream=${encodeURIComponent(ownerStream())}&cursor=${cursor}`)
245
318
  .expect(200);
246
319
  expect(res.body.entities).toHaveLength(2);
247
- const updated = res.body.entities.find((e: any) => e.id === String(doc1._id));
248
- const tombstone = res.body.entities.find((e: any) => e.id === String(doc2._id));
320
+ const updated = res.body.entities.find((e: SnapshotEntity) => e.id === String(doc1._id));
321
+ const tombstone = res.body.entities.find((e: SnapshotEntity) => e.id === String(doc2._id));
249
322
  expect(updated.data.name).toBe("first updated");
250
323
  expect(updated.deleted).toBe(false);
251
324
  expect(tombstone.deleted).toBe(true);
@@ -276,7 +349,7 @@ describe("sync routes", () => {
276
349
  expect(page3.body.hasMore).toBe(false);
277
350
 
278
351
  const names = [...page1.body.entities, ...page2.body.entities, ...page3.body.entities].map(
279
- (e: any) => e.data.name
352
+ (e: SnapshotEntity) => e.data.name
280
353
  );
281
354
  expect(names).toEqual(["item 1", "item 2", "item 3", "item 4", "item 5"]);
282
355
  });
@@ -304,8 +377,8 @@ describe("sync routes", () => {
304
377
 
305
378
  it("500s for tenant collections when no getUserScopes resolver is configured", async () => {
306
379
  const bareApp = getBaseServer();
307
- setupAuth(bareApp as any, UserModel as any);
308
- addAuthRoutes(bareApp as any, UserModel as any);
380
+ setupAuth(bareApp, UserModel as unknown as AuthUserModel);
381
+ addAuthRoutes(bareApp, UserModel as unknown as AuthUserModel);
309
382
  new SyncApp().register(bareApp);
310
383
  const bareAgent = await authAsUser(bareApp, "notAdmin");
311
384
  await bareAgent.get("/sync/snapshot?stream=routeProjects%7Ctenant%3Aorg1").expect(500);
@@ -315,10 +388,10 @@ describe("sync routes", () => {
315
388
  clearSyncRegistry();
316
389
  registerSync({
317
390
  config: {
318
- responseHandler: (doc) => ({redactedName: `x-${(doc as any).name}`}),
391
+ responseHandler: (doc) => ({redactedName: `x-${(doc as RouteStuff).name}`}),
319
392
  scope: {type: "owner"},
320
393
  },
321
- model: RouteStuffModel as any,
394
+ model: RouteStuffModel as unknown as Model<unknown>,
322
395
  options: authedOptions,
323
396
  routePath: "/routeStuff",
324
397
  });
@@ -330,6 +403,132 @@ describe("sync routes", () => {
330
403
  });
331
404
  });
332
405
 
406
+ describe("buildSnapshotScopeFilter", () => {
407
+ it("500s for a custom scope entry that has no snapshotFilter result", () => {
408
+ // Registration rejects this shape up front, so build the entry directly.
409
+ const entry: SyncRegistryEntry = {
410
+ collectionName: "syncroutestuffs",
411
+ collectionTag: "routeStuff",
412
+ config: {scope: () => "custom"},
413
+ modelName: RouteStuffModel.modelName,
414
+ options: authedOptions,
415
+ routePath: "/routeStuff",
416
+ };
417
+ expect(() => buildSnapshotScopeFilter({entry, scopeValue: "custom"})).toThrow(
418
+ expect.objectContaining({status: 500, title: expect.stringMatching(/snapshotFilter/)})
419
+ );
420
+ });
421
+
422
+ it("returns the snapshotFilter result for a custom scope", () => {
423
+ clearSyncRegistry();
424
+ registerSync({
425
+ config: {
426
+ scope: () => "custom",
427
+ snapshotFilter: () => ({name: "keep"}),
428
+ },
429
+ model: RouteStuffModel as unknown as Model<unknown>,
430
+ options: authedOptions,
431
+ routePath: "/routeStuff",
432
+ });
433
+ const [entry] = getSyncRegistry();
434
+ expect(
435
+ buildSnapshotScopeFilter({
436
+ entry,
437
+ scopeValue: "custom",
438
+ snapshotFilterResult: {name: "keep"},
439
+ })
440
+ ).toEqual({name: "keep"});
441
+ });
442
+ });
443
+
444
+ describe("GET /sync/streams", () => {
445
+ it("requires authentication", async () => {
446
+ await server.get("/sync/streams").expect(401);
447
+ });
448
+
449
+ it("omits collections the caller is not allowed to list", async () => {
450
+ registerSync({
451
+ config: {scope: {type: "broadcast"}},
452
+ model: RouteBannerModel as unknown as Model<unknown>,
453
+ options: adminOnlyOptions,
454
+ routePath: "/routeBanners",
455
+ });
456
+
457
+ const res = await agent.get("/sync/streams").expect(200);
458
+ const collections = res.body.streams.map((s: StreamInfo) => s.collection);
459
+ expect(collections).toContain("routeStuff");
460
+ expect(collections).not.toContain("routeBanners");
461
+
462
+ const adminRes = await adminAgent.get("/sync/streams").expect(200);
463
+ expect(adminRes.body.streams).toContainEqual({
464
+ collection: "routeBanners",
465
+ stream: "routeBanners|all",
466
+ });
467
+ });
468
+
469
+ it("500s when a tenant collection has no getUserScopes resolver", async () => {
470
+ const bareApp = getBaseServer();
471
+ setupAuth(bareApp, UserModel as unknown as AuthUserModel);
472
+ addAuthRoutes(bareApp, UserModel as unknown as AuthUserModel);
473
+ new SyncApp().register(bareApp);
474
+ const bareAgent = await authAsUser(bareApp, "notAdmin");
475
+
476
+ const res = await bareAgent.get("/sync/streams").expect(500);
477
+ expect(res.body.title).toMatch(/Failed to resolve streams for routeProjects/);
478
+ });
479
+ });
480
+
481
+ describe("GET /sync/entities", () => {
482
+ it("requires authentication", async () => {
483
+ await server.get("/sync/entities?collection=routeStuff&ids=abc").expect(401);
484
+ });
485
+
486
+ it("400s when the collection parameter is missing", async () => {
487
+ const res = await agent.get("/sync/entities?ids=abc").expect(400);
488
+ expect(res.body.title).toMatch(/collection/);
489
+ });
490
+
491
+ it("400s when no ids are supplied", async () => {
492
+ const res = await agent.get("/sync/entities?collection=routeStuff&ids=,").expect(400);
493
+ expect(res.body.title).toMatch(/ids/);
494
+ });
495
+
496
+ it("404s for an unknown collection", async () => {
497
+ const res = await agent.get("/sync/entities?collection=nope&ids=abc").expect(404);
498
+ expect(res.body.title).toMatch(/Unknown sync collection: nope/);
499
+ });
500
+
501
+ it("403s when the caller may not list the collection", async () => {
502
+ registerSync({
503
+ config: {scope: {type: "broadcast"}},
504
+ model: RouteBannerModel as unknown as Model<unknown>,
505
+ options: adminOnlyOptions,
506
+ routePath: "/routeBanners",
507
+ });
508
+ const doc = await RouteBannerModel.create({name: "secret", ownerId: adminId});
509
+ const res = await agent
510
+ .get(`/sync/entities?collection=routeBanners&ids=${doc._id}`)
511
+ .expect(403);
512
+ expect(res.body.title).toMatch(/denied/);
513
+ });
514
+
515
+ it("passes string ids through uncast for models with string _ids", async () => {
516
+ registerSync({
517
+ config: {scope: {type: "owner"}},
518
+ model: RouteNoteModel as unknown as Model<unknown>,
519
+ options: authedOptions,
520
+ routePath: "/routeNotes",
521
+ });
522
+ await RouteNoteModel.collection.deleteMany({});
523
+ await RouteNoteModel.create({_id: "note-1", body: "hello", ownerId: notAdminId});
524
+
525
+ const res = await agent
526
+ .get("/sync/entities?collection=routeNotes&ids=note-1,not-an-object-id")
527
+ .expect(200);
528
+ expect(res.body.entities.map((e: SnapshotEntity) => e.id)).toEqual(["note-1"]);
529
+ });
530
+ });
531
+
333
532
  describe("POST /sync/mutate", () => {
334
533
  it("requires authentication", async () => {
335
534
  await server
@@ -500,7 +699,7 @@ describe("sync routes", () => {
500
699
  clearSyncRegistry();
501
700
  registerSync({
502
701
  config: {scope: {type: "owner"}},
503
- model: RouteStuffModel as any,
702
+ model: RouteStuffModel as unknown as Model<unknown>,
504
703
  options: adminOnlyOptions,
505
704
  routePath: "/routeStuff",
506
705
  });
@@ -556,13 +755,13 @@ describe("sync routes", () => {
556
755
  clearSyncRegistry();
557
756
  registerSync({
558
757
  config: {scope: {type: "owner"}},
559
- model: RouteStuffModel as any,
758
+ model: RouteStuffModel as unknown as Model<unknown>,
560
759
  options: {
561
760
  ...authedOptions,
562
761
  preCreate: () => {
563
762
  throw new APIError({status: 500, title: "database exploded"});
564
763
  },
565
- } as unknown as ModelRouterOptions<any>,
764
+ } as unknown as ModelRouterOptions<unknown>,
566
765
  routePath: "/routeStuff",
567
766
  });
568
767
  const res = await agent
@@ -624,8 +823,8 @@ describe("sync routes", () => {
624
823
  const mutations = Array.from({length: 5}, (_v, i) => create(`batch-http-${i}`, `item ${i}`));
625
824
  const res = await agent.post("/sync/mutate/batch").send({mutations}).expect(200);
626
825
  expect(res.body.results).toHaveLength(5);
627
- expect(res.body.results.every((r: any) => r.type === "ack")).toBe(true);
628
- const seqs = res.body.results.map((r: any) => r.ack.seq);
826
+ expect(res.body.results.every((r: MutationResult) => r.type === "ack")).toBe(true);
827
+ const seqs = res.body.results.map((r: MutationResult) => r.ack.seq);
629
828
  expect(seqs).toEqual([1, 2, 3, 4, 5]);
630
829
  });
631
830
 
@@ -737,7 +936,114 @@ describe("sync routes", () => {
737
936
  const atCap = await agent
738
937
  .get(`/sync/entities?collection=routeStuff&ids=${ids.slice(0, MAX_ENTITY_FETCH).join(",")}`)
739
938
  .expect(200);
740
- expect(atCap.body.entities.map((e: any) => e.id)).toEqual([String(doc._id)]);
939
+ expect(atCap.body.entities.map((e: SnapshotEntity) => e.id)).toEqual([String(doc._id)]);
940
+ });
941
+ });
942
+
943
+ describe("GET /sync/entities admin window (Task 3.4)", () => {
944
+ it("returns another owner's ids for an admin when adminBroadcast is true", async () => {
945
+ clearSyncRegistry();
946
+ registerSync({
947
+ config: {adminBroadcast: true, scope: {type: "owner"}},
948
+ model: RouteStuffModel as unknown as Model<unknown>,
949
+ options: authedOptions,
950
+ routePath: "/routeStuff",
951
+ });
952
+ const mine = await RouteStuffModel.create({name: "theirs", ownerId: notAdminId});
953
+ const missingId = new Types.ObjectId().toString();
954
+
955
+ const res = await adminAgent
956
+ .get(`/sync/entities?collection=routeStuff&ids=${mine._id},${missingId}`)
957
+ .expect(200);
958
+ assert.equal(res.body.entities.length, 1);
959
+ assert.equal(res.body.entities[0].id, String(mine._id));
960
+ });
961
+
962
+ it("still scopes a non-admin to streams they belong to when adminBroadcast is true", async () => {
963
+ clearSyncRegistry();
964
+ registerSync({
965
+ config: {adminBroadcast: true, scope: {type: "owner"}},
966
+ model: RouteStuffModel as unknown as Model<unknown>,
967
+ options: authedOptions,
968
+ routePath: "/routeStuff",
969
+ });
970
+ const theirs = await RouteStuffModel.create({name: "admin-owned", ownerId: adminId});
971
+
972
+ const res = await agent
973
+ .get(`/sync/entities?collection=routeStuff&ids=${theirs._id}`)
974
+ .expect(200);
975
+ assert.deepEqual(res.body.entities, []);
976
+ });
977
+
978
+ it("does not cross-owner hydrate when accessControl denies admin:access", async () => {
979
+ clearSyncRegistry();
980
+ registerSync({
981
+ config: {adminBroadcast: true, scope: {type: "owner"}},
982
+ model: RouteStuffModel as unknown as Model<unknown>,
983
+ options: authedOptions,
984
+ routePath: "/routeStuff",
985
+ });
986
+ const theirs = await RouteStuffModel.create({name: "flag-admin-owned", ownerId: notAdminId});
987
+ const gatedApp = getBaseServer();
988
+ setupAuth(gatedApp, UserModel as unknown as AuthUserModel);
989
+ addAuthRoutes(gatedApp, UserModel as unknown as AuthUserModel);
990
+ new SyncApp({
991
+ accessControl: {
992
+ can: async () => ({allowed: false}),
993
+ } as never,
994
+ getUserScopes: () => ["org1"],
995
+ }).register(gatedApp);
996
+ const gatedAdmin = await authAsUser(gatedApp, "admin");
997
+
998
+ const res = await gatedAdmin
999
+ .get(`/sync/entities?collection=routeStuff&ids=${theirs._id}`)
1000
+ .expect(200);
1001
+ assert.deepEqual(res.body.entities, []);
1002
+ });
1003
+
1004
+ it("omits ids excluded by a registered AdminApp queryFilter", async () => {
1005
+ clearSyncRegistry();
1006
+ registerSync({
1007
+ config: {adminBroadcast: true, scope: {type: "owner"}},
1008
+ model: RouteStuffModel as unknown as Model<unknown>,
1009
+ options: authedOptions,
1010
+ routePath: "/routeStuff",
1011
+ });
1012
+ registerAdminBroadcastScope("SyncRouteStuff", {
1013
+ listPermissions: [() => true],
1014
+ queryFilter: () => ({ownerId: adminId}),
1015
+ readPermissions: [() => true],
1016
+ });
1017
+ const inScope = await RouteStuffModel.create({name: "in-tenant", ownerId: adminId});
1018
+ const outOfScope = await RouteStuffModel.create({name: "other-tenant", ownerId: notAdminId});
1019
+
1020
+ const res = await adminAgent
1021
+ .get(`/sync/entities?collection=routeStuff&ids=${inScope._id},${outOfScope._id}`)
1022
+ .expect(200);
1023
+ assert.deepEqual(
1024
+ res.body.entities.map((entity: SnapshotEntity) => entity.id),
1025
+ [String(inScope._id)]
1026
+ );
1027
+ });
1028
+
1029
+ it("returns no entities when AdminApp list permission is denied", async () => {
1030
+ clearSyncRegistry();
1031
+ registerSync({
1032
+ config: {adminBroadcast: true, scope: {type: "owner"}},
1033
+ model: RouteStuffModel as unknown as Model<unknown>,
1034
+ options: authedOptions,
1035
+ routePath: "/routeStuff",
1036
+ });
1037
+ registerAdminBroadcastScope("SyncRouteStuff", {
1038
+ listPermissions: [() => false],
1039
+ readPermissions: [() => true],
1040
+ });
1041
+ const theirs = await RouteStuffModel.create({name: "hidden-model", ownerId: notAdminId});
1042
+
1043
+ const res = await adminAgent
1044
+ .get(`/sync/entities?collection=routeStuff&ids=${theirs._id}`)
1045
+ .expect(200);
1046
+ assert.deepEqual(res.body.entities, []);
741
1047
  });
742
1048
  });
743
1049
 
@@ -768,20 +1074,23 @@ describe("sync routes", () => {
768
1074
 
769
1075
  /** Register the banner model for sync + REST with the given queryFilter and re-auth. */
770
1076
  const setupBanners = async (
771
- queryFilter: ModelRouterOptions<any>["queryFilter"]
1077
+ queryFilter: ModelRouterOptions<unknown>["queryFilter"]
772
1078
  ): Promise<{bannerAgent: TestAgent}> => {
773
- const bannerOptions = {...authedOptions, queryFilter} as ModelRouterOptions<any>;
1079
+ const bannerOptions = {...authedOptions, queryFilter} as ModelRouterOptions<unknown>;
774
1080
  clearSyncRegistry();
775
1081
  registerSync({
776
1082
  config: {scope: {type: "broadcast"}},
777
- model: RouteBannerModel as any,
1083
+ model: RouteBannerModel as unknown as Model<unknown>,
778
1084
  options: bannerOptions,
779
1085
  routePath: "/routeBanners",
780
1086
  });
781
1087
  const bannerApp = getBaseServer();
782
- setupAuth(bannerApp as any, UserModel as any);
783
- addAuthRoutes(bannerApp as any, UserModel as any);
784
- bannerApp.use("/routeBanners", modelRouter(RouteBannerModel as any, bannerOptions));
1088
+ setupAuth(bannerApp, UserModel as unknown as AuthUserModel);
1089
+ addAuthRoutes(bannerApp, UserModel as unknown as AuthUserModel);
1090
+ bannerApp.use(
1091
+ "/routeBanners",
1092
+ modelRouter(RouteBannerModel as unknown as Model<unknown>, bannerOptions)
1093
+ );
785
1094
  new SyncApp().register(bannerApp);
786
1095
  return {bannerAgent: await authAsUser(bannerApp, "notAdmin")};
787
1096
  };
@@ -796,13 +1105,13 @@ describe("sync routes", () => {
796
1105
  await RouteBannerModel.create({name: "theirs", ownerId: "someoneElse"});
797
1106
 
798
1107
  const rest = await bannerAgent.get("/routeBanners").expect(200);
799
- const restIds = rest.body.data.map((d: any) => String(d._id));
1108
+ const restIds = rest.body.data.map((d: RouteBanner) => String(d._id));
800
1109
  expect(restIds).toEqual([String(mine._id)]);
801
1110
 
802
1111
  const snapshot = await bannerAgent
803
1112
  .get(`/sync/snapshot?stream=${encodeURIComponent(bannerStream)}`)
804
1113
  .expect(200);
805
- expect(snapshot.body.entities.map((e: any) => e.id)).toEqual(restIds);
1114
+ expect(snapshot.body.entities.map((e: SnapshotEntity) => e.id)).toEqual(restIds);
806
1115
  });
807
1116
 
808
1117
  it("filters GET /sync/entities by the queryFilter", async () => {
@@ -852,7 +1161,7 @@ describe("sync routes", () => {
852
1161
  scope: {type: "owner"},
853
1162
  snapshotFilter: () => ({name: "keep"}),
854
1163
  },
855
- model: RouteStuffModel as any,
1164
+ model: RouteStuffModel as unknown as Model<unknown>,
856
1165
  options: authedOptions,
857
1166
  routePath: "/routeStuff",
858
1167
  });
@@ -862,7 +1171,7 @@ describe("sync routes", () => {
862
1171
  const res = await agent
863
1172
  .get(`/sync/snapshot?stream=${encodeURIComponent(`routeStuff|owner:${notAdminId}`)}`)
864
1173
  .expect(200);
865
- expect(res.body.entities.map((e: any) => e.data.name)).toEqual(["keep"]);
1174
+ expect(res.body.entities.map((e: SnapshotEntity) => e.data.name)).toEqual(["keep"]);
866
1175
  });
867
1176
  });
868
1177
  });