@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
@@ -0,0 +1,279 @@
1
+ import express from "express";
2
+
3
+ import {asyncHandler} from "./api";
4
+ import {
5
+ authenticateMiddleware,
6
+ generateTokens,
7
+ type HasSetPassword,
8
+ MAX_PASSWORD_LENGTH,
9
+ setPasswordForUser,
10
+ type User,
11
+ type UserModel,
12
+ } from "./auth";
13
+ import {AuthToken} from "./authTokens";
14
+ import {APIError} from "./errors";
15
+ import type {AuthOptions, AuthRecoveryMail} from "./expressServer";
16
+ import {logger} from "./logger";
17
+ import {createOpenApiBuilder} from "./openApiBuilder";
18
+ import {findOneOrNoneFor} from "./plugins";
19
+
20
+ const RESET_PASSWORD_SUBJECT = "Reset your password";
21
+ const VERIFY_EMAIL_SUBJECT = "Verify your email";
22
+
23
+ const resetPasswordText = (resetUrl: string): string =>
24
+ `Reset your password using this link: ${resetUrl}`;
25
+
26
+ const resetPasswordHtml = (resetUrl: string): string =>
27
+ `<p><a href="${resetUrl}">Reset your password</a></p>`;
28
+
29
+ const verifyEmailText = (verifyUrl: string): string =>
30
+ `Verify your email using this link: ${verifyUrl}`;
31
+
32
+ const verifyEmailHtml = (verifyUrl: string): string =>
33
+ `<p><a href="${verifyUrl}">Verify your email</a></p>`;
34
+
35
+ const normalizeEmail = (value: unknown): string => {
36
+ if (typeof value !== "string") {
37
+ return "";
38
+ }
39
+ return value.trim().toLowerCase();
40
+ };
41
+
42
+ const escapeRegularExpression = (value: string): string => {
43
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
44
+ };
45
+
46
+ const findUserByEmail = async (userModel: UserModel, email: string): Promise<User | null> => {
47
+ return findOneOrNoneFor(userModel, {
48
+ email: {$options: "i", $regex: `^${escapeRegularExpression(email)}$`},
49
+ } as never);
50
+ };
51
+
52
+ const passwordFromBody = (body: Record<string, unknown>): string => {
53
+ if (typeof body.password === "string" && body.password.length > 0) {
54
+ return body.password;
55
+ }
56
+ if (typeof body.newPassword === "string" && body.newPassword.length > 0) {
57
+ return body.newPassword;
58
+ }
59
+ return "";
60
+ };
61
+
62
+ const tokenFromBody = (body: Record<string, unknown>): string => {
63
+ if (typeof body.token === "string") {
64
+ return body.token;
65
+ }
66
+ return "";
67
+ };
68
+
69
+ const buildAppUrl = (publicAppUrl: string | undefined, path: string, token: string): string => {
70
+ const base = (publicAppUrl ?? "").replace(/\/$/, "");
71
+ return `${base}${path}?token=${encodeURIComponent(token)}`;
72
+ };
73
+
74
+ const buildResetUrl = (publicAppUrl: string | undefined, token: string): string => {
75
+ return buildAppUrl(publicAppUrl, "/resetPassword", token);
76
+ };
77
+
78
+ const buildVerifyUrl = (publicAppUrl: string | undefined, token: string): string => {
79
+ return buildAppUrl(publicAppUrl, "/verifyEmail", token);
80
+ };
81
+
82
+ const userEmail = (user: User, fallback = ""): string => {
83
+ if (typeof (user as User & {email?: string}).email === "string") {
84
+ return (user as User & {email: string}).email;
85
+ }
86
+ return fallback;
87
+ };
88
+
89
+ const isEmailVerified = (user: User): boolean => {
90
+ return (user as User & {emailVerified?: boolean}).emailVerified === true;
91
+ };
92
+
93
+ const markEmailVerified = (user: User): void => {
94
+ (user as User & {emailVerified?: boolean}).emailVerified = true;
95
+ };
96
+
97
+ export const sendVerificationEmail = async (
98
+ user: User,
99
+ authOptions?: AuthOptions
100
+ ): Promise<void> => {
101
+ if (!authOptions?.publicAppUrl) {
102
+ logger.error("[auth] publicAppUrl is required to send verification mail");
103
+ throw new APIError({
104
+ status: 501,
105
+ title: "publicAppUrl is required to send verification mail",
106
+ });
107
+ }
108
+ if (isEmailVerified(user)) {
109
+ return;
110
+ }
111
+ const issued = await AuthToken.issueFor({_id: String(user._id)}, "emailVerification");
112
+ const verifyUrl = buildVerifyUrl(authOptions.publicAppUrl, issued.token);
113
+ await deliverRecoveryMail(authOptions, {
114
+ html: verifyEmailHtml(verifyUrl),
115
+ subject: VERIFY_EMAIL_SUBJECT,
116
+ text: verifyEmailText(verifyUrl),
117
+ to: userEmail(user),
118
+ });
119
+ };
120
+
121
+ const deliverRecoveryMail = async (
122
+ authOptions: AuthOptions | undefined,
123
+ message: AuthRecoveryMail
124
+ ): Promise<void> => {
125
+ if (authOptions?.sendMail) {
126
+ await authOptions.sendMail(message);
127
+ return;
128
+ }
129
+ if (process.env.NODE_ENV === "production") {
130
+ throw new APIError({status: 501, title: "Mail is not configured"});
131
+ }
132
+ logger.info(
133
+ `[auth] Console recovery mail subject=${message.subject} textLength=${message.text.length}`
134
+ );
135
+ };
136
+
137
+ const incrementTokenEpoch = (user: User): void => {
138
+ user.tokenEpoch = (user.tokenEpoch ?? 0) + 1;
139
+ };
140
+
141
+ export const addAuthRecoveryRoutes = (
142
+ app: express.Application,
143
+ userModel: UserModel,
144
+ authOptions?: AuthOptions
145
+ ): void => {
146
+ const forgotPassword = asyncHandler(async (req: express.Request, res: express.Response) => {
147
+ const email = normalizeEmail(req.body?.email);
148
+ if (email) {
149
+ try {
150
+ const user = await findUserByEmail(userModel, email);
151
+ if (user) {
152
+ if (!authOptions?.publicAppUrl) {
153
+ logger.error("[auth] publicAppUrl is required to send password reset mail");
154
+ } else {
155
+ const issued = await AuthToken.issueFor({_id: String(user._id)}, "passwordReset");
156
+ const resetUrl = buildResetUrl(authOptions.publicAppUrl, issued.token);
157
+ await deliverRecoveryMail(authOptions, {
158
+ html: resetPasswordHtml(resetUrl),
159
+ subject: RESET_PASSWORD_SUBJECT,
160
+ text: resetPasswordText(resetUrl),
161
+ to: userEmail(user, email),
162
+ });
163
+ }
164
+ }
165
+ } catch (error: unknown) {
166
+ logger.error("[auth] Failed to send password reset mail", {error});
167
+ }
168
+ }
169
+ return res.status(202).json({data: {ok: true}});
170
+ });
171
+
172
+ const resetPassword = asyncHandler(async (req: express.Request, res: express.Response) => {
173
+ const body = (req.body ?? {}) as Record<string, unknown>;
174
+ const token = tokenFromBody(body);
175
+ const password = passwordFromBody(body);
176
+ if (!token || !password) {
177
+ throw new APIError({status: 400, title: "token and password are required"});
178
+ }
179
+ if (password.length > MAX_PASSWORD_LENGTH) {
180
+ throw new APIError({
181
+ status: 400,
182
+ title: `Password must be at most ${MAX_PASSWORD_LENGTH} characters`,
183
+ });
184
+ }
185
+ const consumed = await AuthToken.consume(token, "passwordReset");
186
+ if (!consumed) {
187
+ throw new APIError({status: 400, title: "Invalid or expired reset token"});
188
+ }
189
+ const user = await userModel.findById(consumed.userId);
190
+ if (!user) {
191
+ throw new APIError({status: 400, title: "Invalid or expired reset token"});
192
+ }
193
+ await setPasswordForUser(user as unknown as HasSetPassword, password);
194
+ incrementTokenEpoch(user);
195
+ await (user as unknown as {save: () => Promise<unknown>}).save();
196
+ if (authOptions?.syncPasswordResetToBetterAuth) {
197
+ await authOptions.syncPasswordResetToBetterAuth(user, password);
198
+ }
199
+ const tokens = await generateTokens(user, authOptions);
200
+ return res.json({
201
+ data: {refreshToken: tokens.refreshToken, token: tokens.token, userId: user._id},
202
+ });
203
+ });
204
+
205
+ const forgotOpenApi = createOpenApiBuilder({})
206
+ .withTags(["auth"])
207
+ .withSummary("Request a password reset email")
208
+ .withRequestBody({email: {type: "string"}})
209
+ .withResponse(202, {ok: {type: "boolean"}})
210
+ .build();
211
+
212
+ const resetOpenApi = createOpenApiBuilder({})
213
+ .withTags(["auth"])
214
+ .withSummary("Reset password with a one-time token")
215
+ .withRequestBody({
216
+ newPassword: {type: "string"},
217
+ password: {type: "string"},
218
+ token: {type: "string"},
219
+ })
220
+ .withResponse(200, {
221
+ refreshToken: {type: "string"},
222
+ token: {type: "string"},
223
+ userId: {type: "string"},
224
+ })
225
+ .build();
226
+
227
+ const sendVerification = asyncHandler(async (req: express.Request, res: express.Response) => {
228
+ const user = req.user as User | undefined;
229
+ if (!user) {
230
+ throw new APIError({status: 401, title: "Unauthorized"});
231
+ }
232
+ await sendVerificationEmail(user, authOptions);
233
+ return res.status(202).json({data: {ok: true}});
234
+ });
235
+
236
+ const verifyEmail = asyncHandler(async (req: express.Request, res: express.Response) => {
237
+ const token = tokenFromBody((req.body ?? {}) as Record<string, unknown>);
238
+ if (!token) {
239
+ throw new APIError({status: 400, title: "token is required"});
240
+ }
241
+ const consumed = await AuthToken.consume(token, "emailVerification");
242
+ if (!consumed) {
243
+ throw new APIError({status: 400, title: "Invalid or expired verification token"});
244
+ }
245
+ const user = await userModel.findById(consumed.userId);
246
+ if (!user) {
247
+ throw new APIError({status: 400, title: "Invalid or expired verification token"});
248
+ }
249
+ markEmailVerified(user);
250
+ await (user as unknown as {save: () => Promise<unknown>}).save();
251
+ return res.json({data: {ok: true}});
252
+ });
253
+
254
+ const sendVerificationOpenApi = createOpenApiBuilder({})
255
+ .withTags(["auth"])
256
+ .withSummary("Send or resend an email verification link")
257
+ .withResponse(202, {ok: {type: "boolean"}})
258
+ .build();
259
+
260
+ const verifyEmailOpenApi = createOpenApiBuilder({})
261
+ .withTags(["auth"])
262
+ .withSummary("Verify email with a one-time token")
263
+ .withRequestBody({token: {type: "string"}})
264
+ .withResponse(200, {ok: {type: "boolean"}})
265
+ .build();
266
+
267
+ const router = express.Router();
268
+ router.post("/forgotPassword", forgotOpenApi, forgotPassword);
269
+ router.post("/resetPassword", resetOpenApi, resetPassword);
270
+ router.post(
271
+ "/sendVerification",
272
+ authenticateMiddleware(),
273
+ sendVerificationOpenApi,
274
+ sendVerification
275
+ );
276
+ router.post("/verifyEmail", verifyEmailOpenApi, verifyEmail);
277
+ app.use("/auth", router);
278
+ app.post("/resetPassword", resetOpenApi, resetPassword);
279
+ };
@@ -0,0 +1,94 @@
1
+ import {beforeEach, describe, it} from "bun:test";
2
+ import {createHash} from "node:crypto";
3
+ import {assert} from "chai";
4
+ import {DateTime} from "luxon";
5
+ import mongoose from "mongoose";
6
+
7
+ import {AUTH_TOKEN_TTL, AuthToken} from "./authTokens";
8
+
9
+ const hashToken = (token: string): string => createHash("sha256").update(token).digest("hex");
10
+
11
+ describe("AuthToken", () => {
12
+ beforeEach(async () => {
13
+ await AuthToken.deleteMany({});
14
+ });
15
+
16
+ it("issues a hashed single-use token with type-specific TTL and never stores plaintext", async () => {
17
+ const userId = new mongoose.Types.ObjectId();
18
+ const issued = await AuthToken.issueFor({_id: userId}, "passwordReset");
19
+
20
+ assert.match(issued.token, /^[0-9a-f]{64}$/);
21
+ assert.equal(issued.authToken.tokenHash, hashToken(issued.token));
22
+ assert.notInclude(JSON.stringify(issued.authToken.toJSON()), issued.token);
23
+ assert.isUndefined(issued.authToken.consumedAt);
24
+
25
+ const ttlMs = issued.authToken.expiresAt.getTime() - issued.authToken.created.getTime();
26
+ const expectedMs = AUTH_TOKEN_TTL.passwordReset.as("milliseconds");
27
+ assert.approximately(ttlMs, expectedMs, 5_000);
28
+
29
+ const verifyIssued = await AuthToken.issueFor({_id: userId}, "emailVerification");
30
+ const verifyTtlMs =
31
+ verifyIssued.authToken.expiresAt.getTime() - verifyIssued.authToken.created.getTime();
32
+ assert.approximately(verifyTtlMs, AUTH_TOKEN_TTL.emailVerification.as("milliseconds"), 5_000);
33
+ });
34
+
35
+ it("consumes a token exactly once under parallel callers", async () => {
36
+ const userId = new mongoose.Types.ObjectId();
37
+ const {token} = await AuthToken.issueFor({_id: userId}, "passwordReset");
38
+
39
+ const results = await Promise.all(
40
+ Array.from({length: 20}, () => AuthToken.consume(token, "passwordReset"))
41
+ );
42
+ const winners = results.filter((doc) => doc !== null);
43
+
44
+ assert.equal(winners.length, 1);
45
+ assert.equal(String(winners[0]?.userId), String(userId));
46
+ assert.isDefined(winners[0]?.consumedAt);
47
+
48
+ const secondPass = await AuthToken.consume(token, "passwordReset");
49
+ assert.isNull(secondPass);
50
+ });
51
+
52
+ it("does not consume an expired token", async () => {
53
+ const userId = new mongoose.Types.ObjectId();
54
+ const {token, authToken} = await AuthToken.issueFor({_id: userId}, "passwordReset");
55
+ authToken.expiresAt = DateTime.fromMillis(0).toJSDate();
56
+ await authToken.save();
57
+
58
+ const consumed = await AuthToken.consume(token, "passwordReset");
59
+ assert.isNull(consumed);
60
+ });
61
+
62
+ it("does not consume a token of a different type", async () => {
63
+ const userId = new mongoose.Types.ObjectId();
64
+ const {token} = await AuthToken.issueFor({_id: userId}, "passwordReset");
65
+
66
+ const consumed = await AuthToken.consume(token, "emailVerification");
67
+ assert.isNull(consumed);
68
+ });
69
+
70
+ it("invalidates earlier unused tokens of the same type when issuing a new one", async () => {
71
+ const userId = new mongoose.Types.ObjectId();
72
+ const firstReset = await AuthToken.issueFor({_id: userId}, "passwordReset");
73
+ const firstVerify = await AuthToken.issueFor({_id: userId}, "emailVerification");
74
+ const secondReset = await AuthToken.issueFor({_id: userId}, "passwordReset");
75
+
76
+ assert.isNull(await AuthToken.consume(firstReset.token, "passwordReset"));
77
+ const stillValidVerify = await AuthToken.consume(firstVerify.token, "emailVerification");
78
+ assert.isNotNull(stillValidVerify);
79
+ const consumedSecond = await AuthToken.consume(secondReset.token, "passwordReset");
80
+ assert.isNotNull(consumedSecond);
81
+ });
82
+
83
+ it("invalidates unused tokens of a type without issuing a replacement", async () => {
84
+ const userId = new mongoose.Types.ObjectId();
85
+ const issued = await AuthToken.issueFor({_id: userId}, "emailVerification");
86
+ const resetIssued = await AuthToken.issueFor({_id: userId}, "passwordReset");
87
+
88
+ await AuthToken.invalidateUnusedFor({_id: userId}, "emailVerification");
89
+
90
+ assert.isNull(await AuthToken.consume(issued.token, "emailVerification"));
91
+ const stillValidReset = await AuthToken.consume(resetIssued.token, "passwordReset");
92
+ assert.isNotNull(stillValidReset);
93
+ });
94
+ });
@@ -0,0 +1,118 @@
1
+ import {createHash, randomBytes} from "node:crypto";
2
+ import {DateTime, Duration} from "luxon";
3
+ import mongoose from "mongoose";
4
+
5
+ import {createdUpdatedPlugin, findExactlyOne, findOneOrNone} from "./plugins";
6
+ import type {AuthTokenDocument, AuthTokenModel, AuthTokenType} from "./types/authToken";
7
+
8
+ export type {AuthTokenDocument, AuthTokenModel, AuthTokenType} from "./types/authToken";
9
+
10
+ export const AUTH_TOKEN_TTL = {
11
+ emailVerification: Duration.fromObject({hours: 24}),
12
+ passwordReset: Duration.fromObject({hours: 1}),
13
+ } as const;
14
+
15
+ const AUTH_TOKEN_TYPES: AuthTokenType[] = ["passwordReset", "emailVerification"];
16
+
17
+ const hashToken = (token: string): string => createHash("sha256").update(token).digest("hex");
18
+
19
+ const authTokenSchema = new mongoose.Schema<AuthTokenDocument, AuthTokenModel>(
20
+ {
21
+ consumedAt: {
22
+ description: "When this token was consumed; unset until first successful consume",
23
+ type: Date,
24
+ },
25
+ expiresAt: {
26
+ description: "When this token expires and can no longer be consumed",
27
+ required: true,
28
+ type: Date,
29
+ },
30
+ tokenHash: {
31
+ description: "SHA-256 hash of the one-time token plaintext",
32
+ required: true,
33
+ type: String,
34
+ unique: true,
35
+ },
36
+ type: {
37
+ description: "Whether this token is for password reset or email verification",
38
+ enum: AUTH_TOKEN_TYPES,
39
+ required: true,
40
+ type: String,
41
+ },
42
+ userId: {
43
+ description: "The user this token was issued for",
44
+ index: true,
45
+ ref: "User",
46
+ required: true,
47
+ type: mongoose.Schema.Types.ObjectId,
48
+ },
49
+ },
50
+ {strict: "throw", toJSON: {virtuals: true}, toObject: {virtuals: true}}
51
+ );
52
+
53
+ authTokenSchema.index({expiresAt: 1}, {expireAfterSeconds: 0});
54
+
55
+ authTokenSchema.plugin(createdUpdatedPlugin);
56
+ authTokenSchema.plugin(findOneOrNone);
57
+ authTokenSchema.plugin(findExactlyOne);
58
+
59
+ authTokenSchema.statics = {
60
+ ...authTokenSchema.statics,
61
+ async consume(
62
+ this: AuthTokenModel,
63
+ token: string,
64
+ type: AuthTokenType
65
+ ): Promise<AuthTokenDocument | null> {
66
+ const now = DateTime.now().toJSDate();
67
+ const consumed = await this.findOneAndUpdate(
68
+ {
69
+ consumedAt: {$exists: false},
70
+ expiresAt: {$gt: now},
71
+ tokenHash: hashToken(token),
72
+ type,
73
+ },
74
+ {$set: {consumedAt: now}},
75
+ {returnDocument: "after"}
76
+ );
77
+ return consumed;
78
+ },
79
+
80
+ async invalidateUnusedFor(
81
+ this: AuthTokenModel,
82
+ user: {_id: {toString(): string}},
83
+ type: AuthTokenType
84
+ ): Promise<void> {
85
+ const userId = new mongoose.Types.ObjectId(String(user._id));
86
+ await this.updateMany(
87
+ {
88
+ consumedAt: {$exists: false},
89
+ type,
90
+ userId,
91
+ },
92
+ {$set: {consumedAt: DateTime.now().toJSDate()}}
93
+ );
94
+ },
95
+
96
+ async issueFor(
97
+ this: AuthTokenModel,
98
+ user: {_id: {toString(): string}},
99
+ type: AuthTokenType
100
+ ): Promise<{authToken: AuthTokenDocument; token: string}> {
101
+ const token = randomBytes(32).toString("hex");
102
+ const ttl = AUTH_TOKEN_TTL[type];
103
+ const now = DateTime.now();
104
+ const userId = new mongoose.Types.ObjectId(String(user._id));
105
+ await this.invalidateUnusedFor(user, type);
106
+ const authToken = await this.create({
107
+ expiresAt: now.plus(ttl).toJSDate(),
108
+ tokenHash: hashToken(token),
109
+ type,
110
+ userId,
111
+ });
112
+ return {authToken, token};
113
+ },
114
+ };
115
+
116
+ export const AuthToken =
117
+ (mongoose.models.AuthToken as AuthTokenModel | undefined) ??
118
+ mongoose.model<AuthTokenDocument, AuthTokenModel>("AuthToken", authTokenSchema);