@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,60 +1,51 @@
1
1
  import type {Model} from "mongoose";
2
+
2
3
  import type {ModelRouterOptions} from "../api";
4
+ import {
5
+ clearCollectionRegistry,
6
+ listCollections,
7
+ registerCollection,
8
+ replaceCollectionOptions,
9
+ } from "../collectionRegistry";
3
10
  import {logger} from "../logger";
4
- import {getScopeField} from "./streams";
11
+ import {clearAdminBroadcastScopes} from "./adminBroadcastScope";
12
+ import {clearAdminWindowMutationScopes} from "./adminWindowMutation";
13
+ import {
14
+ clearSyncIndexCreationTasks,
15
+ ensureSyncIndexes,
16
+ trackSyncIndexCreation,
17
+ } from "./registrationSideEffects";
5
18
  import type {SyncConfig} from "./types";
6
19
 
7
- /**
8
- * A registered model with SyncDB local-first sync configuration.
9
- */
10
20
  export interface SyncRegistryEntry {
11
- /** Mongoose model name (e.g. "Todo") */
12
21
  modelName: string;
13
- /** Route path (e.g. "/todos") */
14
22
  routePath: string;
15
- /** Collection tag used in the sync protocol (route path without the leading slash) */
16
23
  collectionTag: string;
17
- /** MongoDB collection name (e.g. "todos") */
18
24
  collectionName: string;
19
- /** Sync configuration from modelRouter options */
20
25
  config: SyncConfig;
21
- /** Full modelRouter options (for responseHandler, permissions, etc.) */
22
26
  options: ModelRouterOptions<unknown>;
23
27
  }
24
28
 
25
- const syncRegistry: SyncRegistryEntry[] = [];
26
-
27
- /**
28
- * C8: index creation is kicked off (fire-and-forget) at registration, but its failure must
29
- * be a STARTUP error, not a swallowed warning (a missing index table-scans the snapshot
30
- * query under load, and a missing unique index breaks mutation idempotency). Each
31
- * registration records its index promise here; `ensureSyncIndexes()` awaits them and
32
- * throws on any failure so server startup can fail loudly. A detached failure is also
33
- * logged so it is never silent even if startup never calls `ensureSyncIndexes`.
34
- */
35
- const indexCreationPromises: Promise<void>[] = [];
36
-
37
- /**
38
- * Enqueue an index-creation promise for `ensureSyncIndexes()` to await at startup. Used by
39
- * `SyncApp.register` for the bookkeeping-model indexes (`SyncCounter`, `SyncMutation`,
40
- * `SyncScopeMove`, `SyncKey`), which are correctness-critical and must not depend on
41
- * Mongoose `autoIndex` being enabled.
42
- */
43
- export const trackSyncIndexCreation = (promise: Promise<void>): void => {
44
- indexCreationPromises.push(promise);
45
- // Swallow the detached rejection (the failure is logged where it happens and rethrown
46
- // by `ensureSyncIndexes()` via the retained promise above).
47
- promise.catch(() => {});
48
- };
29
+ const toSyncEntry = (record: {
30
+ model: Model<unknown>;
31
+ options: ModelRouterOptions<unknown>;
32
+ routePath: string;
33
+ }): SyncRegistryEntry => ({
34
+ collectionName: record.model.collection.collectionName,
35
+ collectionTag: record.routePath.replace(/^\//, ""),
36
+ config: record.options.sync as SyncConfig,
37
+ modelName: record.model.modelName,
38
+ options: record.options,
39
+ routePath: record.routePath,
40
+ });
41
+
42
+ const syncCollections = () =>
43
+ listCollections()
44
+ .filter((record) => record.surfaces.sync)
45
+ .map(toSyncEntry);
46
+
47
+ export {ensureSyncIndexes, trackSyncIndexCreation};
49
48
 
50
- /**
51
- * Register a model for local-first sync. Called automatically by modelRouter when the
52
- * `sync` option is provided. Validates the schema contract at startup and throws with
53
- * an actionable message when it is not met:
54
- * - soft delete (`isDeletedPlugin`) is required so deletes remain queryable tombstones;
55
- * - `syncPlugin` is required so every write stamps a per-stream `_syncSeq`;
56
- * - owner/tenant scope fields must exist on the schema.
57
- */
58
49
  export const registerSync = <T>({
59
50
  model,
60
51
  routePath,
@@ -66,143 +57,32 @@ export const registerSync = <T>({
66
57
  config: SyncConfig;
67
58
  options: ModelRouterOptions<T>;
68
59
  }): void => {
69
- const name = model.modelName;
70
- const deletedPath = model.schema.path("deleted");
71
- if (deletedPath?.instance !== "Boolean") {
72
- throw new Error(
73
- `Model ${name} has a sync config but no soft delete support. ` +
74
- "Apply isDeletedPlugin to the schema — sync catch-up requires delete tombstones."
75
- );
76
- }
77
- if (!model.schema.path("_syncSeq")) {
78
- throw new Error(
79
- `Model ${name} has a sync config but syncPlugin is not applied to its schema. ` +
80
- "Apply syncPlugin so every write stamps a per-stream _syncSeq."
81
- );
82
- }
83
- const scopeField = getScopeField(config.scope);
84
- if (scopeField && !model.schema.path(scopeField)) {
85
- throw new Error(
86
- `Model ${name} has a sync scope on field "${scopeField}" but the schema has no such path.`
87
- );
88
- }
89
- if (typeof config.scope === "function" && !config.snapshotFilter) {
90
- throw new Error(
91
- `Model ${name} uses a custom sync scope resolver, which requires a snapshotFilter ` +
92
- "so the snapshot endpoint can restrict queries to the caller's documents."
93
- );
94
- }
95
- if (syncRegistry.some((entry) => entry.modelName === name)) {
96
- throw new Error(`Model ${name} is already registered for sync.`);
97
- }
98
- // C8: a duplicate collectionTag would make two models share sync streams and route
99
- // snapshots/deltas ambiguously — reject it loudly at registration.
100
- const collectionTag = routePath.replace(/^\//, "");
101
- if (syncRegistry.some((entry) => entry.collectionTag === collectionTag)) {
102
- throw new Error(
103
- `Sync collection tag "${collectionTag}" is already registered (routePath ${routePath}). ` +
104
- "Each synced model must have a unique route path."
105
- );
106
- }
107
-
108
- syncRegistry.push({
109
- collectionName: model.collection.collectionName,
110
- collectionTag,
111
- config,
112
- modelName: name,
113
- options: options as unknown as ModelRouterOptions<unknown>,
60
+ registerCollection({
61
+ model,
62
+ options: {
63
+ ...options,
64
+ sync: config,
65
+ } as ModelRouterOptions<T>,
114
66
  routePath,
115
67
  });
116
-
117
- // `Model.bulkWrite` bypasses Mongoose middleware entirely, so `syncPlugin`'s query
118
- // guards never see it: writes land with no `_syncSeq`, invisible to both delta emission
119
- // and snapshot catch-up, and clients silently never learn about them. The restriction
120
- // used to be documentation only — replace the static so it throws the same way the
121
- // guarded multi-document paths do. Idempotent: the replacement never delegates, so a
122
- // re-registration (tests clearing the registry) re-patching it is harmless.
123
- (model as unknown as {bulkWrite: () => never}).bulkWrite = (): never => {
124
- throw new Error(
125
- `bulkWrite is not supported on sync-enabled model ${name}: it bypasses Mongoose ` +
126
- "middleware, so writes are never stamped with a per-stream _syncSeq and become " +
127
- "invisible to sync delta emission and snapshot catch-up. Loop per document instead."
128
- );
129
- };
130
-
131
- // Compound index for snapshot/catch-up queries: {scopeField, _syncSeq}. Created
132
- // directly on the collection because the model is already compiled at registration.
133
- // C8: track the promise so `ensureSyncIndexes()` (server startup) can fail loudly on a
134
- // createIndex error — a missing index table-scans the snapshot query under load. The
135
- // detached path only logs (never throws into an orphaned promise).
136
- const indexSpec: Record<string, 1> = scopeField ? {[scopeField]: 1, _syncSeq: 1} : {_syncSeq: 1};
137
- const indexPromise = model.collection
138
- .createIndex(indexSpec)
139
- .then(() => {})
140
- .catch((error: unknown) => {
141
- logger.error(`[sync] Failed to create sync index for ${name}`, {error: String(error)});
142
- throw new Error(
143
- `Failed to create sync snapshot index for ${name}: ${String(error)}. ` +
144
- "The snapshot/catch-up query requires this index; fix the schema/DB and restart."
145
- );
146
- });
147
- indexCreationPromises.push(indexPromise);
148
- // Swallow the detached rejection (already logged) so it is not an unhandled rejection;
149
- // `ensureSyncIndexes()` still observes it via the retained promise above.
150
- indexPromise.catch(() => {});
151
68
  };
152
69
 
153
- /**
154
- * Replace options on an existing sync registry entry after TerrenoApp injects
155
- * accessControl and modelRouter resolves RBAC permissions.
156
- */
157
70
  export const updateSyncRegistryOptions = (
158
71
  routePath: string,
159
72
  options: ModelRouterOptions<unknown>
160
73
  ): void => {
161
- const existing = syncRegistry.find((entry) => entry.routePath === routePath);
162
- if (!existing) {
163
- return;
164
- }
165
- existing.options = options;
166
- };
167
-
168
- /**
169
- * C8: await every enqueued sync index creation — per-model snapshot indexes from
170
- * `registerSync` plus the bookkeeping-model indexes from `SyncApp.register` — throwing on
171
- * the first failure. Called at server startup by `TerrenoApp.start()` (after all models
172
- * and plugins register) so a missing index fails the boot loudly rather than silently
173
- * degrading the snapshot query to a table scan or breaking mutation idempotency.
174
- */
175
- export const ensureSyncIndexes = async (): Promise<void> => {
176
- await Promise.all(indexCreationPromises);
74
+ replaceCollectionOptions(routePath, options);
177
75
  };
178
76
 
179
- /** Get all registered sync models. */
180
- export const getSyncRegistry = (): SyncRegistryEntry[] => syncRegistry;
77
+ export const getSyncRegistry = (): SyncRegistryEntry[] => syncCollections();
181
78
 
182
- /**
183
- * Collection tags whose scope can only be resolved from the FULL user document —
184
- * tenant scopes read `organizationIds` (or whatever `getUserScopes` looks at) and custom
185
- * resolvers may read anything. The synthetic `{_id, admin, id}` user built from JWT claims
186
- * carries none of that.
187
- */
188
79
  const scopesRequiringFullUser = (): string[] =>
189
- syncRegistry
80
+ syncCollections()
190
81
  .filter(
191
82
  (entry) => typeof entry.config.scope === "function" || entry.config.scope.type === "tenant"
192
83
  )
193
84
  .map((entry) => entry.collectionTag);
194
85
 
195
- /**
196
- * Task 9.21: warn loudly at startup when a tenant/custom-scoped collection is registered
197
- * but no `userModel` is configured for socket handshakes.
198
- *
199
- * Without one, `getSocketUser` falls back to the synthetic decoded-token user: `admin`
200
- * comes from a JWT claim rather than the database, and `getUserScopes` sees no
201
- * `organizationIds`, so tenant subscriptions silently resolve to no streams (a client that
202
- * appears connected but never receives data). This warns rather than throws so an existing
203
- * deployment cannot be bricked by an upgrade; the message names the collections and the
204
- * fix. Returns the offending collection tags for tests and callers that want to escalate.
205
- */
206
86
  export const warnOnSyncScopesWithoutUserModel = ({userModel}: {userModel?: unknown}): string[] => {
207
87
  if (userModel) {
208
88
  return [];
@@ -222,24 +102,22 @@ export const warnOnSyncScopesWithoutUserModel = ({userModel}: {userModel?: unkno
222
102
  return collections;
223
103
  };
224
104
 
225
- /** Find a sync registry entry by Mongoose model name. */
226
105
  export const findSyncEntryByModelName = (modelName: string): SyncRegistryEntry | undefined =>
227
- syncRegistry.find((entry) => entry.modelName === modelName);
106
+ syncCollections().find((entry) => entry.modelName === modelName);
228
107
 
229
- /** Find a sync registry entry by collection tag (e.g. "todos"). */
230
108
  export const findSyncEntryByCollectionTag = (
231
109
  collectionTag: string
232
110
  ): SyncRegistryEntry | undefined =>
233
- syncRegistry.find((entry) => entry.collectionTag === collectionTag);
111
+ syncCollections().find((entry) => entry.collectionTag === collectionTag);
234
112
 
235
- /** Find a sync registry entry by MongoDB collection name. */
236
113
  export const findSyncEntryByCollectionName = (
237
114
  collectionName: string
238
115
  ): SyncRegistryEntry | undefined =>
239
- syncRegistry.find((entry) => entry.collectionName === collectionName);
116
+ syncCollections().find((entry) => entry.collectionName === collectionName);
240
117
 
241
- /** Clear the registry (for testing). */
242
118
  export const clearSyncRegistry = (): void => {
243
- syncRegistry.length = 0;
244
- indexCreationPromises.length = 0;
119
+ clearCollectionRegistry();
120
+ clearSyncIndexCreationTasks();
121
+ clearAdminBroadcastScopes();
122
+ clearAdminWindowMutationScopes();
245
123
  };
@@ -5,6 +5,14 @@ import {authenticateMiddleware, type User} from "../auth";
5
5
  import {APIError, apiErrorMiddleware, apiUnauthorizedMiddleware} from "../errors";
6
6
  import {logger} from "../logger";
7
7
  import {checkPermissions} from "../permissions";
8
+ import {findOneOrNoneFor} from "../plugins";
9
+ import type {AnyTerrenoAccess} from "../rbac/types";
10
+ import {
11
+ canListAdminBroadcastScope,
12
+ getAdminBroadcastScope,
13
+ resolveAdminBroadcastQueryFilter,
14
+ } from "./adminBroadcastScope";
15
+ import {canUseAdminBroadcastWindow} from "./adminWindowAccess";
8
16
  import {
9
17
  computeStableFrontier,
10
18
  getCompactedThroughSeq,
@@ -53,6 +61,18 @@ export interface SyncAppOptions {
53
61
  getUserScopes?: (user: User, entry: SyncRegistryEntry) => Promise<string[]> | string[];
54
62
  /** Default page size for snapshots (default 100, max 100). */
55
63
  defaultSnapshotLimit?: number;
64
+ /**
65
+ * When set, `{collection}|admin` window subscribe and cross-owner entity
66
+ * hydrate require `admin:access` instead of the legacy `user.admin` flag.
67
+ * AdminApp also registers per-model list/read/`queryFilter` so hydrate and
68
+ * `|admin` deltas match `/admin` REST, not product `IsOwner`.
69
+ */
70
+ accessControl?: AnyTerrenoAccess;
71
+ /**
72
+ * Override the admin-window gate. Defaults to `admin:access` when
73
+ * `accessControl` is set, otherwise `Permissions.IsAdmin`.
74
+ */
75
+ canOpenAdminWindow?: (user: User) => boolean | Promise<boolean>;
56
76
  }
57
77
 
58
78
  const MAX_SNAPSHOT_LIMIT = 100;
@@ -316,8 +336,8 @@ const frontierBelowStreamHead = async (
316
336
  streamKey: string,
317
337
  frontierSeq: number
318
338
  ): Promise<boolean> => {
319
- const counter = await SyncCounter.findOne({stream: streamKey}).select({seq: 1}).lean();
320
- const head = counter ? ((counter as {seq?: number}).seq ?? 0) : 0;
339
+ const counter = await findOneOrNoneFor(SyncCounter, {stream: streamKey});
340
+ const head = counter?.seq ?? 0;
321
341
  return head > frontierSeq;
322
342
  };
323
343
 
@@ -695,17 +715,38 @@ export const addSyncRoutes = (app: express.Application, options: SyncAppOptions
695
715
  });
696
716
  }
697
717
 
698
- const memberStreams = await resolveUserStreamsForEntry({
699
- entry,
700
- getUserScopes: options.getUserScopes,
701
- user,
702
- });
718
+ const isAdminWindow =
719
+ entry.config.adminBroadcast === true &&
720
+ (await canUseAdminBroadcastWindow({
721
+ accessControl: options.accessControl,
722
+ canOpenAdminWindow: options.canOpenAdminWindow,
723
+ user,
724
+ }));
725
+ const adminScope = isAdminWindow ? getAdminBroadcastScope(entry.modelName) : undefined;
726
+ if (adminScope && !(await canListAdminBroadcastScope({scope: adminScope, user}))) {
727
+ const deniedResponse: SyncEntitiesResponse = {entities: []};
728
+ return res.json(deniedResponse);
729
+ }
730
+
731
+ const memberStreams = isAdminWindow
732
+ ? []
733
+ : await resolveUserStreamsForEntry({
734
+ entry,
735
+ getUserScopes: options.getUserScopes,
736
+ user,
737
+ });
703
738
  const memberSet = new Set(memberStreams);
704
739
 
705
740
  // Task 9.19: mirror the REST list endpoint's row-level scoping. Without this, a
706
741
  // collection that relies on `queryFilter` (rather than a per-doc read permission)
707
742
  // served every requested id here, whatever the caller was allowed to list.
708
- const queryFilterResult = await resolveSyncQueryFilter({entry, user});
743
+ // Admin window hydrate skips the *product* filter so REST-selected ids can load
744
+ // across owners, then applies AdminApp list/read/`queryFilter` when registered.
745
+ const queryFilterResult = adminScope
746
+ ? await resolveAdminBroadcastQueryFilter({scope: adminScope, user})
747
+ : isAdminWindow
748
+ ? {denied: false as const, filter: undefined}
749
+ : await resolveSyncQueryFilter({entry, user});
709
750
  if (queryFilterResult.denied) {
710
751
  const deniedResponse: SyncEntitiesResponse = {entities: []};
711
752
  return res.json(deniedResponse);
@@ -725,7 +766,9 @@ export const addSyncRoutes = (app: express.Application, options: SyncAppOptions
725
766
 
726
767
  const entities: SyncEntityPayload[] = [];
727
768
  for (const doc of docs as mongoose.Document[]) {
728
- const allowed = await checkPermissions("read", entry.options.permissions.read, user, doc);
769
+ const allowed = adminScope
770
+ ? await checkPermissions("read", adminScope.readPermissions, user, doc)
771
+ : await checkPermissions("read", entry.options.permissions.read, user, doc);
729
772
  if (!allowed) {
730
773
  continue;
731
774
  }
@@ -735,7 +778,7 @@ export const addSyncRoutes = (app: express.Application, options: SyncAppOptions
735
778
  doc: docObj,
736
779
  scope: entry.config.scope,
737
780
  });
738
- if (!memberSet.has(stream)) {
781
+ if (!isAdminWindow && !memberSet.has(stream)) {
739
782
  continue;
740
783
  }
741
784
  const isTombstone = Boolean(docObj.deleted);
@@ -766,6 +809,7 @@ export const addSyncRoutes = (app: express.Application, options: SyncAppOptions
766
809
  mutation: req.body as SyncMutateRequest,
767
810
  req,
768
811
  scopeResolver: options.getUserScopes,
812
+ syncOptions: options,
769
813
  user,
770
814
  });
771
815
  if (outcome.type === "ack") {
@@ -793,6 +837,7 @@ export const addSyncRoutes = (app: express.Application, options: SyncAppOptions
793
837
  mutations,
794
838
  req,
795
839
  scopeResolver: options.getUserScopes,
840
+ syncOptions: options,
796
841
  user,
797
842
  });
798
843
  if (stage === "validation") {
@@ -1,5 +1,3 @@
1
- // noExplicitAny: operates generically across registered sync models
2
- // biome-ignore-all lint/suspicious/noExplicitAny: operates generically across registered sync models
3
1
  import {DateTime} from "luxon";
4
2
  import mongoose from "mongoose";
5
3
  import {logger} from "../../logger";
@@ -1,5 +1,3 @@
1
- // noExplicitAny: the rig bridges generic model/router/test types
2
- // biome-ignore-all lint/suspicious/noExplicitAny: the rig bridges generic model/router/test types
3
1
  /**
4
2
  * Integration coverage for D1 (socket session re-validation sweep) and D4
5
3
  * (membership revocation vs socket rooms), using a REAL @terreno/syncdb client
@@ -32,7 +30,7 @@ import {
32
30
  import mongoose, {model, Schema} from "mongoose";
33
31
 
34
32
  import {modelRouter} from "../api";
35
- import {addAuthRoutes, generateTokens, setupAuth} from "../auth";
33
+ import {type UserModel as AuthUserModel, addAuthRoutes, generateTokens, setupAuth} from "../auth";
36
34
  import {createdUpdatedPlugin, findOneOrNoneFor, type IsDeleted, isDeletedPlugin} from "../plugins";
37
35
  import {RealtimeApp} from "../realtime/realtimeApp";
38
36
  import {getBaseServer, setupDb, UserModel} from "../tests";
@@ -155,8 +153,8 @@ describe("session re-validation sweep integration (D1/D4)", () => {
155
153
  });
156
154
 
157
155
  const app = getBaseServer();
158
- setupAuth(app as any, UserModel as any);
159
- addAuthRoutes(app as any, UserModel as any);
156
+ setupAuth(app, UserModel as unknown as AuthUserModel);
157
+ addAuthRoutes(app, UserModel as unknown as AuthUserModel);
160
158
  new SyncApp({
161
159
  getUserScopes: (user) => memberships.get(String(user.id)) ?? [],
162
160
  }).register(app);
@@ -165,7 +163,7 @@ describe("session re-validation sweep integration (D1/D4)", () => {
165
163
  realtimeApp = new RealtimeApp({
166
164
  // D1: a short sweep interval so the tests don't wait a full 60s default.
167
165
  sessionRevalidationIntervalMs: SESSION_REVALIDATION_INTERVAL_MS,
168
- userModel: UserModel as any,
166
+ userModel: UserModel as unknown as AuthUserModel,
169
167
  });
170
168
  realtimeApp.register(app);
171
169
 
@@ -208,9 +206,12 @@ describe("session re-validation sweep integration (D1/D4)", () => {
208
206
  // for the socket-specific signal (isOnline flipping false) first — the only
209
207
  // thing that can disconnect this socket mid-test is the sweep, since nothing
210
208
  // else in this scenario touches the transport.
211
- const fullUser = await findOneOrNoneFor(UserModel as any, {_id: userDoc._id});
212
- (fullUser as any).disabled = true;
213
- await (fullUser as any).save();
209
+ const fullUser = await findOneOrNoneFor(UserModel, {_id: userDoc._id});
210
+ if (!fullUser) {
211
+ throw new Error("the seeded test user is missing");
212
+ }
213
+ fullUser.disabled = true;
214
+ await fullUser.save();
214
215
 
215
216
  await waitFor(() => !client.getSyncStatus().isOnline, {
216
217
  label: "socket disconnected by the sweep after being disabled",
@@ -234,8 +235,8 @@ describe("session re-validation sweep integration (D1/D4)", () => {
234
235
 
235
236
  // Re-enable so afterAll's client.stop() and any later scenario aren't left
236
237
  // fighting a disabled user; also proves recovery is possible.
237
- (fullUser as any).disabled = false;
238
- await (fullUser as any).save();
238
+ fullUser.disabled = false;
239
+ await fullUser.save();
239
240
  }, 15_000);
240
241
 
241
242
  it("D4: revoking the user's only organization membership stops further deltas for that tenant on the live socket", async () => {