@terreno/api 57.2.0 → 57.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,5 +1,3 @@
1
- // noExplicitAny: Socket.io handler signatures require dynamic args
2
- // biome-ignore-all lint/suspicious/noExplicitAny: Socket.io handler signatures require dynamic args
3
1
  import type http from "node:http";
4
2
  import * as Sentry from "@sentry/bun";
5
3
  import type express from "express";
@@ -45,6 +43,7 @@ export const MAX_QUERY_SUBSCRIPTIONS = 100;
45
43
  *
46
44
  * Exported for testing.
47
45
  */
46
+ /** @internal */
48
47
  export const redactCredentials = (url: string): string => {
49
48
  try {
50
49
  const parsed = new URL(url);
@@ -323,7 +322,7 @@ export const installRealtimeSocketHandlers = (
323
322
  * TerrenoPlugin that provides real-time sync via Socket.io and MongoDB change streams.
324
323
  *
325
324
  * Attaches a Socket.io server to the HTTP server created by TerrenoApp.start(),
326
- * sets up JWT authentication for socket connections, manages room subscriptions
325
+ * sets up JWT and/or Better Auth authentication for socket connections, manages room subscriptions
327
326
  * (model, document, and query rooms), and starts a change stream watcher that
328
327
  * emits events to connected clients.
329
328
  *
@@ -394,14 +393,14 @@ export class RealtimeApp implements TerrenoPlugin {
394
393
  },
395
394
  });
396
395
 
397
- // Authentication middleware: legacy JWT first, optionally Better Auth sessions.
396
+ // Authentication middleware: legacy JWT first when configured, optionally Better Auth sessions.
398
397
  const tokenSecret = this.config.tokenSecret ?? process.env.TOKEN_SECRET;
399
- if (!tokenSecret) {
398
+ if (!tokenSecret && !this.config.betterAuth) {
400
399
  throw new APIError({
401
400
  status: 500,
402
401
  title:
403
- "[realtime] TOKEN_SECRET is required for socket authentication. " +
404
- "Set process.env.TOKEN_SECRET or pass tokenSecret in RealtimeAppOptions.",
402
+ "[realtime] Socket authentication requires TOKEN_SECRET or Better Auth. " +
403
+ "Set process.env.TOKEN_SECRET, pass tokenSecret, or configure betterAuth.",
405
404
  });
406
405
  }
407
406
 
@@ -418,13 +417,14 @@ export class RealtimeApp implements TerrenoPlugin {
418
417
  createSocketAuthMiddleware({
419
418
  betterAuth: this.config.betterAuth,
420
419
  issuer: resolveTokenIssuer,
421
- tokenSecret,
420
+ ...(tokenSecret ? {tokenSecret} : {}),
422
421
  })
423
422
  );
424
423
 
425
- logInfo(
426
- `[realtime] Socket auth middleware added (JWT${this.config.betterAuth ? " + Better Auth" : ""})`
427
- );
424
+ const authKinds = [tokenSecret ? "JWT" : null, this.config.betterAuth ? "Better Auth" : null]
425
+ .filter(Boolean)
426
+ .join(" + ");
427
+ logInfo(`[realtime] Socket auth middleware added (${authKinds})`);
428
428
 
429
429
  // Task 9.21: tenant/custom sync scopes can only be resolved from the full user
430
430
  // document, so warn loudly here (once, at startup) rather than silently serving
@@ -5,8 +5,8 @@
5
5
  * are process-wide and would break later files that need the real implementations).
6
6
  */
7
7
  import {afterEach, beforeEach, describe, expect, it} from "bun:test";
8
-
9
8
  import type http from "node:http";
9
+ import {assert} from "chai";
10
10
 
11
11
  import {RealtimeApp} from "./realtimeApp";
12
12
 
@@ -100,7 +100,7 @@ describe("RealtimeApp.onServerCreated", () => {
100
100
  });
101
101
 
102
102
  afterEach(() => {
103
- delete process.env.TOKEN_SECRET;
103
+ Reflect.deleteProperty(process.env, "TOKEN_SECRET");
104
104
  });
105
105
 
106
106
  it("wires up auth middleware, connection handlers, and the change-stream watcher", () => {
@@ -151,9 +151,36 @@ describe("RealtimeApp.onServerCreated", () => {
151
151
  expect(lastIo().handlers.has("connection")).toBe(true);
152
152
  });
153
153
 
154
- it("throws when no token secret is available", () => {
155
- delete process.env.TOKEN_SECRET;
154
+ it("starts with Better Auth when no token secret is available", () => {
155
+ Reflect.deleteProperty(process.env, "TOKEN_SECRET");
156
+ const app = new RealtimeApp(
157
+ testRealtimeOptions({
158
+ betterAuth: {
159
+ auth: {
160
+ api: {
161
+ getSession: async () => ({
162
+ session: {id: "session-1"},
163
+ user: {id: "better-auth-user"},
164
+ }),
165
+ },
166
+ },
167
+ } as unknown as NonNullable<
168
+ NonNullable<ConstructorParameters<typeof RealtimeApp>[0]>["betterAuth"]
169
+ >,
170
+ })
171
+ );
172
+
173
+ assert.doesNotThrow(() => app.onServerCreated(fakeServer));
174
+ assert.lengthOf(lastIo().middleware, 1);
175
+ assert.isTrue(lastIo().handlers.has("connection"));
176
+ });
177
+
178
+ it("throws when no socket authentication method is available", () => {
179
+ Reflect.deleteProperty(process.env, "TOKEN_SECRET");
156
180
  const app = new RealtimeApp(testRealtimeOptions());
157
- expect(() => app.onServerCreated(fakeServer)).toThrow(/TOKEN_SECRET is required/);
181
+ assert.throws(
182
+ () => app.onServerCreated(fakeServer),
183
+ "Socket authentication requires TOKEN_SECRET or Better Auth"
184
+ );
158
185
  });
159
186
  });
@@ -1,78 +1,84 @@
1
+ import type {Model} from "mongoose";
2
+
1
3
  import type {ModelRouterOptions} from "../api";
4
+ import {
5
+ clearCollectionRegistry,
6
+ listCollections,
7
+ registerCollection,
8
+ replaceCollectionOptions,
9
+ } from "../collectionRegistry";
2
10
  import type {RealtimeConfig} from "./types";
3
11
 
4
- /**
5
- * A registered model with real-time sync configuration.
6
- */
7
12
  export interface RealtimeRegistryEntry {
8
- /** Mongoose model name (e.g. "Todo") */
9
13
  modelName: string;
10
- /** Route path (e.g. "/todos") */
11
14
  routePath: string;
12
- /** Collection name in MongoDB (e.g. "todos") */
13
15
  collectionName: string;
14
- /** Real-time configuration from modelRouter options */
15
16
  config: RealtimeConfig;
16
- /**
17
- * Full modelRouter options (for responseHandler, permissions, etc.), erased to
18
- * `unknown` since the registry holds entries for every model.
19
- */
20
17
  options: ModelRouterOptions<unknown>;
21
18
  }
22
19
 
23
- const realtimeRegistry: RealtimeRegistryEntry[] = [];
20
+ const toRealtimeEntry = (record: {
21
+ model: Model<unknown>;
22
+ options: ModelRouterOptions<unknown>;
23
+ routePath: string;
24
+ }): RealtimeRegistryEntry => ({
25
+ collectionName: record.model.collection.collectionName,
26
+ config: record.options.realtime as RealtimeConfig,
27
+ modelName: record.model.modelName,
28
+ options: record.options,
29
+ routePath: record.routePath,
30
+ });
31
+
32
+ const realtimeModelForEntry = (entry: RealtimeRegistryEntry): Model<unknown> => {
33
+ const registered = listCollections().find(
34
+ (record) => record.routePath === entry.routePath
35
+ )?.model;
36
+ if (registered) {
37
+ return registered;
38
+ }
39
+ return {
40
+ collection: {collectionName: entry.collectionName},
41
+ modelName: entry.modelName,
42
+ } as Model<unknown>;
43
+ };
24
44
 
25
- /**
26
- * Register a model for real-time sync. Called automatically by modelRouter
27
- * when the `realtime` option is provided.
28
- */
29
45
  export const registerRealtime = (entry: RealtimeRegistryEntry): void => {
30
- realtimeRegistry.push(entry);
46
+ registerCollection({
47
+ model: realtimeModelForEntry(entry),
48
+ options: {
49
+ ...entry.options,
50
+ realtime: entry.config,
51
+ } as ModelRouterOptions<unknown>,
52
+ routePath: entry.routePath,
53
+ });
31
54
  };
32
55
 
33
- /**
34
- * Replace options on an existing registry entry (e.g. after TerrenoApp injects accessControl).
35
- * Matches by routePath; no-op if the route was never registered.
36
- */
37
56
  export const updateRealtimeRegistryOptions = (
38
57
  routePath: string,
39
58
  options: ModelRouterOptions<unknown>
40
59
  ): void => {
41
- const existing = realtimeRegistry.find((entry) => entry.routePath === routePath);
42
- if (!existing) {
43
- return;
44
- }
45
- existing.options = options;
60
+ replaceCollectionOptions(routePath, options);
46
61
  };
47
62
 
48
- /**
49
- * Get all registered real-time models.
50
- */
51
- export const getRealtimeRegistry = (): RealtimeRegistryEntry[] => realtimeRegistry;
63
+ export const getRealtimeRegistry = (): RealtimeRegistryEntry[] =>
64
+ listCollections()
65
+ .filter((record) => record.surfaces.realtime)
66
+ .map(toRealtimeEntry);
52
67
 
53
- /**
54
- * Find a registry entry by MongoDB collection name.
55
- */
56
68
  export const findRegistryEntryByCollection = (
57
69
  collectionName: string
58
70
  ): RealtimeRegistryEntry | undefined => {
59
- return realtimeRegistry.find((entry) => entry.collectionName === collectionName);
71
+ return getRealtimeRegistry().find((entry) => entry.collectionName === collectionName);
60
72
  };
61
73
 
62
- /**
63
- * Find a registry entry by route path / collection tag (e.g. "todos").
64
- */
65
74
  export const findRegistryEntryByRoutePath = (
66
75
  collection: string
67
76
  ): RealtimeRegistryEntry | undefined => {
68
- return realtimeRegistry.find(
77
+ return getRealtimeRegistry().find(
69
78
  (entry) => entry.routePath === `/${collection}` || entry.routePath === collection
70
79
  );
71
80
  };
72
81
 
73
- /**
74
- * Clear the registry (for testing).
75
- */
76
82
  export const clearRealtimeRegistry = (): void => {
77
- realtimeRegistry.length = 0;
83
+ clearCollectionRegistry();
78
84
  };
@@ -1,5 +1,3 @@
1
- // noExplicitAny: test mocks use dynamic shapes for sockets, io, and models
2
- // biome-ignore-all lint/suspicious/noExplicitAny: test mocks use dynamic shapes for sockets, io, and models
3
1
  /**
4
2
  * D1: socket session re-validation sweep.
5
3
  * - revalidateSocketSession: expired/disabled/invalid-session detection per auth kind
@@ -10,7 +8,10 @@
10
8
  import {afterEach, describe, expect, it, mock} from "bun:test";
11
9
  import {DateTime} from "luxon";
12
10
  import mongoose, {model, Schema} from "mongoose";
13
-
11
+ import type {Server} from "socket.io";
12
+ import type {ModelRouterOptions} from "../api";
13
+ import type {UserModel} from "../auth";
14
+ import type {BetterAuthInstance} from "../betterAuthSetup";
14
15
  import {createdUpdatedPlugin, isDeletedPlugin} from "../plugins";
15
16
  import {clearSyncRegistry, registerSync} from "../sync/registry";
16
17
  import {syncPlugin} from "../sync/syncSeqPlugin";
@@ -24,12 +25,24 @@ import {
24
25
  } from "./sessionRevalidation";
25
26
 
26
27
  /** Minimal fake Mongoose model: findOneOrNoneFor falls back to `.find()` without the plugin. */
27
- const fakeUserModel = (users: Record<string, unknown>): any => ({
28
- find: async (query: {_id: string}) => {
29
- const user = users[query._id];
30
- return user ? [user] : [];
31
- },
32
- });
28
+ const fakeUserModel = (users: Record<string, unknown>): UserModel =>
29
+ ({
30
+ find: async (query: {_id: string}) => {
31
+ const user = users[query._id];
32
+ return user ? [user] : [];
33
+ },
34
+ }) as unknown as UserModel;
35
+
36
+ const fakeIo = (sockets: Map<string, RevalidatableSocket>): Server =>
37
+ ({sockets: {sockets}}) as unknown as Server;
38
+
39
+ type LoadableSocket = Parameters<typeof loadFullUserForSocket>[0];
40
+ const asLoadable = (socket: RevalidatableSocket): LoadableSocket =>
41
+ socket as unknown as LoadableSocket;
42
+
43
+ const openPermissions = {
44
+ permissions: {create: [], delete: [], list: [], read: [], update: []},
45
+ } as unknown as ModelRouterOptions<unknown>;
33
46
 
34
47
  /**
35
48
  * Real (but never persisted — no test DB round-trip needed) Mongoose models satisfying
@@ -44,7 +57,7 @@ revalTenantSchema.plugin(isDeletedPlugin);
44
57
  revalTenantSchema.plugin(createdUpdatedPlugin);
45
58
  revalTenantSchema.plugin(syncPlugin);
46
59
  const RevalTenantModel =
47
- (mongoose.models.RevalSessionProject as mongoose.Model<any>) ||
60
+ (mongoose.models.RevalSessionProject as mongoose.Model<unknown>) ||
48
61
  model("RevalSessionProject", revalTenantSchema);
49
62
 
50
63
  const revalOwnerSchema = new Schema({
@@ -55,7 +68,7 @@ revalOwnerSchema.plugin(isDeletedPlugin);
55
68
  revalOwnerSchema.plugin(createdUpdatedPlugin);
56
69
  revalOwnerSchema.plugin(syncPlugin);
57
70
  const RevalOwnerModel =
58
- (mongoose.models.RevalSessionTodo as mongoose.Model<any>) ||
71
+ (mongoose.models.RevalSessionTodo as mongoose.Model<unknown>) ||
59
72
  model("RevalSessionTodo", revalOwnerSchema);
60
73
 
61
74
  const makeSocket = (overrides: Partial<RevalidatableSocket> = {}): RevalidatableSocket => ({
@@ -106,7 +119,9 @@ describe("revalidateSocketSession", () => {
106
119
  });
107
120
  const outcome = await revalidateSocketSession(socket, {
108
121
  betterAuth: {
109
- auth: {api: {getSession: async () => ({user: {id: "u1"}})}} as any,
122
+ auth: {
123
+ api: {getSession: async () => ({user: {id: "u1"}})},
124
+ } as unknown as BetterAuthInstance,
110
125
  },
111
126
  });
112
127
  expect(outcome).toBe("valid");
@@ -118,7 +133,7 @@ describe("revalidateSocketSession", () => {
118
133
  encodedToken: "revoked-session-token",
119
134
  });
120
135
  const outcome = await revalidateSocketSession(socket, {
121
- betterAuth: {auth: {api: {getSession: async () => null}} as any},
136
+ betterAuth: {auth: {api: {getSession: async () => null}} as unknown as BetterAuthInstance},
122
137
  });
123
138
  expect(outcome).toBe("invalid-session");
124
139
  });
@@ -170,7 +185,7 @@ describe("reresolveSyncRoomsForSocket (D4)", () => {
170
185
  registerSync({
171
186
  config: {scope: {field: "organizationId", type: "tenant"}},
172
187
  model: RevalTenantModel,
173
- options: {permissions: {create: [], delete: [], list: [], read: [], update: []}} as any,
188
+ options: openPermissions,
174
189
  routePath: "/projects",
175
190
  });
176
191
 
@@ -202,7 +217,7 @@ describe("reresolveSyncRoomsForSocket (D4)", () => {
202
217
  registerSync({
203
218
  config: {scope: {field: "organizationId", type: "tenant"}},
204
219
  model: RevalTenantModel,
205
- options: {permissions: {create: [], delete: [], list: [], read: [], update: []}} as any,
220
+ options: openPermissions,
206
221
  routePath: "/projects",
207
222
  });
208
223
  const subscriptions = new Map<string, Set<string>>([
@@ -224,7 +239,7 @@ describe("reresolveSyncRoomsForSocket (D4)", () => {
224
239
  registerSync({
225
240
  config: {scope: {type: "owner"}},
226
241
  model: RevalOwnerModel,
227
- options: {permissions: {create: [], delete: [], list: [], read: [], update: []}} as any,
242
+ options: openPermissions,
228
243
  routePath: "/todos",
229
244
  });
230
245
  const subscriptions = new Map<string, Set<string>>([
@@ -251,7 +266,7 @@ describe("runSessionRevalidationSweep", () => {
251
266
  id: "u1",
252
267
  },
253
268
  });
254
- const io = {sockets: {sockets: new Map([["socket-1", socket]])}} as any;
269
+ const io = fakeIo(new Map([["socket-1", socket]]));
255
270
 
256
271
  await runSessionRevalidationSweep(io, {});
257
272
 
@@ -261,7 +276,7 @@ describe("runSessionRevalidationSweep", () => {
261
276
 
262
277
  it("disconnects a disabled user's socket", async () => {
263
278
  const socket = makeSocket({decodedToken: {authKind: "jwt", id: "u1"}});
264
- const io = {sockets: {sockets: new Map([["socket-1", socket]])}} as any;
279
+ const io = fakeIo(new Map([["socket-1", socket]]));
265
280
 
266
281
  await runSessionRevalidationSweep(io, {
267
282
  userModel: fakeUserModel({u1: {_id: "u1", disabled: true}}),
@@ -279,7 +294,7 @@ describe("runSessionRevalidationSweep", () => {
279
294
  id: "u1",
280
295
  },
281
296
  });
282
- const io = {sockets: {sockets: new Map([["socket-1", socket]])}} as any;
297
+ const io = fakeIo(new Map([["socket-1", socket]]));
283
298
 
284
299
  await runSessionRevalidationSweep(io, {});
285
300
 
@@ -305,16 +320,14 @@ describe("runSessionRevalidationSweep", () => {
305
320
  throw new Error("db unavailable");
306
321
  },
307
322
  };
308
- const io = {
309
- sockets: {
310
- sockets: new Map([
311
- ["socket-throws", throwing],
312
- ["socket-expired", expired],
313
- ]),
314
- },
315
- } as any;
323
+ const io = fakeIo(
324
+ new Map([
325
+ ["socket-throws", throwing],
326
+ ["socket-expired", expired],
327
+ ])
328
+ );
316
329
 
317
- await runSessionRevalidationSweep(io, {userModel: throwingUserModel as any});
330
+ await runSessionRevalidationSweep(io, {userModel: throwingUserModel as unknown as UserModel});
318
331
 
319
332
  // The throwing socket's error is caught and logged; it is left connected rather
320
333
  // than disconnected on an ambiguous internal failure.
@@ -325,7 +338,7 @@ describe("runSessionRevalidationSweep", () => {
325
338
 
326
339
  describe("startSessionRevalidationSweep", () => {
327
340
  it("does not arm a timer when intervalMs is 0", () => {
328
- const io = {sockets: {sockets: new Map()}} as any;
341
+ const io = fakeIo(new Map());
329
342
  const handle = startSessionRevalidationSweep(io, {intervalMs: 0});
330
343
  // No assertion beyond "does not throw" is possible without reaching into timer
331
344
  // internals; stop() must be a safe no-op either way.
@@ -333,7 +346,7 @@ describe("startSessionRevalidationSweep", () => {
333
346
  });
334
347
 
335
348
  it("returns a handle whose stop() clears the interval", () => {
336
- const io = {sockets: {sockets: new Map()}} as any;
349
+ const io = fakeIo(new Map());
337
350
  const handle = startSessionRevalidationSweep(io, {intervalMs: 60_000});
338
351
  expect(() => handle.stop()).not.toThrow();
339
352
  // Calling stop() twice must also be safe.
@@ -348,7 +361,7 @@ describe("startSessionRevalidationSweep", () => {
348
361
  registerSync({
349
362
  config: {scope: {field: "organizationId", type: "tenant"}},
350
363
  model: RevalTenantModel,
351
- options: {permissions: {create: [], delete: [], list: [], read: [], update: []}} as any,
364
+ options: openPermissions,
352
365
  routePath: "/projects",
353
366
  });
354
367
  const user = {_id: "u1", disabled: false};
@@ -360,7 +373,7 @@ describe("startSessionRevalidationSweep", () => {
360
373
  },
361
374
  decodedToken: {authKind: "jwt", id: "u1"},
362
375
  });
363
- const io = {sockets: {sockets: new Map([["socket-1", socket]])}} as any;
376
+ const io = fakeIo(new Map([["socket-1", socket]]));
364
377
  let currentScopes = ["org-v1"];
365
378
 
366
379
  const handle = startSessionRevalidationSweep(io, () => ({
@@ -391,23 +404,23 @@ const settleFor = (ms: number): Promise<void> => new Promise((resolve) => setTim
391
404
  describe("loadFullUserForSocket (D2)", () => {
392
405
  it("populates socket.data.fullUser from the decoded token's id", async () => {
393
406
  const user = {_id: "u1", organizationIds: ["org-a"]};
394
- const socket: any = {data: {}, decodedToken: {id: "u1"}, id: "socket-1"};
407
+ const socket = makeSocket({decodedToken: {id: "u1"}});
395
408
 
396
- await loadFullUserForSocket(socket, fakeUserModel({u1: user}));
409
+ await loadFullUserForSocket(asLoadable(socket), fakeUserModel({u1: user}));
397
410
 
398
- expect(socket.data.fullUser).toEqual(user);
411
+ expect(socket.data?.fullUser).toEqual(user);
399
412
  });
400
413
 
401
414
  it("is a no-op when no userModel is configured", async () => {
402
- const socket: any = {data: {}, decodedToken: {id: "u1"}, id: "socket-1"};
403
- await loadFullUserForSocket(socket, undefined);
404
- expect(socket.data.fullUser).toBeUndefined();
415
+ const socket = makeSocket({decodedToken: {id: "u1"}});
416
+ await loadFullUserForSocket(asLoadable(socket), undefined);
417
+ expect(socket.data?.fullUser).toBeUndefined();
405
418
  });
406
419
 
407
420
  it("is a no-op when the decoded token has no id", async () => {
408
- const socket: any = {data: {}, decodedToken: {}, id: "socket-1"};
409
- await loadFullUserForSocket(socket, fakeUserModel({u1: {_id: "u1"}}));
410
- expect(socket.data.fullUser).toBeUndefined();
421
+ const socket = makeSocket({decodedToken: {}});
422
+ await loadFullUserForSocket(asLoadable(socket), fakeUserModel({u1: {_id: "u1"}}));
423
+ expect(socket.data?.fullUser).toBeUndefined();
411
424
  });
412
425
 
413
426
  it("swallows a lookup error and leaves fullUser unset", async () => {
@@ -416,8 +429,8 @@ describe("loadFullUserForSocket (D2)", () => {
416
429
  throw new Error("db down");
417
430
  },
418
431
  };
419
- const socket: any = {data: {}, decodedToken: {id: "u1"}, id: "socket-1"};
420
- await loadFullUserForSocket(socket, throwingModel as any);
421
- expect(socket.data.fullUser).toBeUndefined();
432
+ const socket = makeSocket({decodedToken: {id: "u1"}});
433
+ await loadFullUserForSocket(asLoadable(socket), throwingModel as unknown as UserModel);
434
+ expect(socket.data?.fullUser).toBeUndefined();
422
435
  });
423
436
  });