@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
package/dist/auth.js CHANGED
@@ -107,8 +107,11 @@ var passport_1 = __importDefault(require("passport"));
107
107
  var passport_anonymous_1 = require("passport-anonymous");
108
108
  var passport_jwt_1 = require("passport-jwt");
109
109
  var passport_local_1 = require("passport-local");
110
+ var authRecovery_1 = require("./authRecovery");
111
+ var authTokens_1 = require("./authTokens");
110
112
  var errors_1 = require("./errors");
111
113
  var logger_1 = require("./logger");
114
+ var policies_1 = require("./rateLimit/policies");
112
115
  var requestContext_1 = require("./requestContext");
113
116
  var authenticateMiddleware = function (anonymous) {
114
117
  if (anonymous === void 0) { anonymous = false; }
@@ -145,11 +148,18 @@ var authenticateMiddleware = function (anonymous) {
145
148
  };
146
149
  exports.authenticateMiddleware = authenticateMiddleware;
147
150
  /**
148
- * User fields that confer authority. Self-service requests (anonymous signup, `PATCH /me`)
149
- * must never set them, or any caller could grant themselves admin or an RBAC role. Elevate
150
- * users through the admin API or `access.roles.assign` instead.
151
+ * User fields that confer authority or skip security gates. Self-service requests
152
+ * (anonymous signup, `PATCH /me`) must never set them, or any caller could grant
153
+ * themselves admin, an RBAC role, a verified email, or a reset epoch. Elevate users
154
+ * through the admin API or `access.roles.assign` instead.
151
155
  */
152
- exports.PRIVILEGED_USER_FIELDS = ["admin", "roles", "organizationIds"];
156
+ exports.PRIVILEGED_USER_FIELDS = [
157
+ "admin",
158
+ "roles",
159
+ "organizationIds",
160
+ "emailVerified",
161
+ "tokenEpoch",
162
+ ];
153
163
  /**
154
164
  * Removes {@link PRIVILEGED_USER_FIELDS} from a self-service body. Fields are dropped rather
155
165
  * than rejected so clients that echo a whole user object back still succeed.
@@ -181,6 +191,12 @@ var stripPrivilegedUserFields = function (body, context) {
181
191
  return sanitized;
182
192
  };
183
193
  exports.stripPrivilegedUserFields = stripPrivilegedUserFields;
194
+ var isEmailUpdateChangingMailbox = function (currentEmail, nextEmail) {
195
+ if (typeof currentEmail !== "string" || typeof nextEmail !== "string") {
196
+ return false;
197
+ }
198
+ return currentEmail.trim().toLowerCase() !== nextEmail.trim().toLowerCase();
199
+ };
184
200
  var omitPrivilegedFieldsFromObject = function (item, allowAdminWrite) {
185
201
  var e_2, _a;
186
202
  if (!item || typeof item !== "object" || Array.isArray(item)) {
@@ -225,7 +241,7 @@ var omitUserRolesFromWriteBody = function (modelName, accessControl, body, allow
225
241
  };
226
242
  exports.omitUserRolesFromWriteBody = omitUserRolesFromWriteBody;
227
243
  var signupUser = function (userModel, email, password, body) { return __awaiter(void 0, void 0, void 0, function () {
228
- var _a, _email, _password, rawBody, bodyRest, user, error_1, error_2, message;
244
+ var _a, _email, _password, rawBody, bodyRest, registrableModel, user, error_1, error_2, message;
229
245
  return __generator(this, function (_b) {
230
246
  switch (_b.label) {
231
247
  case 0:
@@ -234,7 +250,8 @@ var signupUser = function (userModel, email, password, body) { return __awaiter(
234
250
  _b.label = 1;
235
251
  case 1:
236
252
  _b.trys.push([1, 8, , 9]);
237
- return [4 /*yield*/, userModel.register(__assign({ email: email }, bodyRest), password)];
253
+ registrableModel = userModel;
254
+ return [4 /*yield*/, registrableModel.register(__assign({ email: email }, bodyRest), password)];
238
255
  case 2:
239
256
  user = _b.sent();
240
257
  if (!user.postCreate) return [3 /*break*/, 6];
@@ -382,10 +399,10 @@ var generateTokens = function (user_1, authOptions_1) {
382
399
  args_1[_i - 2] = arguments[_i];
383
400
  }
384
401
  return __awaiter(void 0, __spreadArray([user_1, authOptions_1], __read(args_1), false), void 0, function (user, authOptions, options) {
385
- var tokenSecretOrKey, tokenUser, sessionId, payload, tokenOptions, expiresIn, token, refreshTokenSecretOrKey, refreshToken, refreshTokenOptions, expiresIn;
386
- var _a;
402
+ var tokenSecretOrKey, tokenUser, sessionId, authUser, payload, tokenOptions, expiresIn, token, refreshTokenSecretOrKey, refreshToken, refreshTokenOptions, expiresIn;
403
+ var _a, _b;
387
404
  if (options === void 0) { options = {}; }
388
- return __generator(this, function (_b) {
405
+ return __generator(this, function (_c) {
389
406
  tokenSecretOrKey = process.env.TOKEN_SECRET;
390
407
  if (!tokenSecretOrKey) {
391
408
  throw new errors_1.APIError({ status: 500, title: "TOKEN_SECRET must be set in env." });
@@ -396,15 +413,20 @@ var generateTokens = function (user_1, authOptions_1) {
396
413
  return [2 /*return*/, { refreshToken: null, token: null }];
397
414
  }
398
415
  sessionId = (_a = options.sessionId) !== null && _a !== void 0 ? _a : (0, node_crypto_1.randomUUID)();
399
- payload = { id: String(tokenUser._id), sid: sessionId };
416
+ authUser = user;
417
+ payload = {
418
+ id: String(tokenUser._id),
419
+ sid: sessionId,
420
+ te: (_b = authUser.tokenEpoch) !== null && _b !== void 0 ? _b : 0,
421
+ };
400
422
  if (authOptions === null || authOptions === void 0 ? void 0 : authOptions.generateJWTPayload) {
401
- payload = __assign(__assign({}, authOptions.generateJWTPayload(user)), payload);
423
+ payload = __assign(__assign({}, authOptions.generateJWTPayload(authUser)), payload);
402
424
  }
403
425
  tokenOptions = {
404
426
  expiresIn: "15m",
405
427
  };
406
428
  if (authOptions === null || authOptions === void 0 ? void 0 : authOptions.generateTokenExpiration) {
407
- tokenOptions.expiresIn = authOptions.generateTokenExpiration(user);
429
+ tokenOptions.expiresIn = authOptions.generateTokenExpiration(authUser);
408
430
  }
409
431
  else if (process.env.TOKEN_EXPIRES_IN) {
410
432
  expiresIn = validateDuration("TOKEN_EXPIRES_IN", process.env.TOKEN_EXPIRES_IN);
@@ -422,7 +444,7 @@ var generateTokens = function (user_1, authOptions_1) {
422
444
  expiresIn: "30d",
423
445
  };
424
446
  if (authOptions === null || authOptions === void 0 ? void 0 : authOptions.generateRefreshTokenExpiration) {
425
- refreshTokenOptions.expiresIn = authOptions.generateRefreshTokenExpiration(user);
447
+ refreshTokenOptions.expiresIn = authOptions.generateRefreshTokenExpiration(authUser);
426
448
  }
427
449
  else if (process.env.REFRESH_TOKEN_EXPIRES_IN) {
428
450
  expiresIn = validateDuration("REFRESH_TOKEN_EXPIRES_IN", process.env.REFRESH_TOKEN_EXPIRES_IN);
@@ -538,6 +560,11 @@ var setupAuth = function (app, userModel) {
538
560
  if (!process.env.TOKEN_SECRET) {
539
561
  return [2 /*return*/, next()];
540
562
  }
563
+ // Login, signup, and refresh exchange credentials. A stale access JWT in
564
+ // Authorization / the jwt cookie must not 401 before those handlers run.
565
+ if ((0, policies_1.isJwtCredentialExchangePath)(req)) {
566
+ return [2 /*return*/, next()];
567
+ }
541
568
  // Allow requests with a "Secret" prefix to pass through since this is a string value,
542
569
  // not a jwt that needs to be decoded
543
570
  if (((_b = (_a = req === null || req === void 0 ? void 0 : req.headers) === null || _a === void 0 ? void 0 : _a.authorization) === null || _b === void 0 ? void 0 : _b.split(" ")[0]) === "Secret") {
@@ -606,8 +633,7 @@ var setupAuth = function (app, userModel) {
606
633
  });
607
634
  }); };
608
635
  app.use(decodeJWTMiddleware);
609
- // noExplicitAny: express 5 type for urlencoded doesn't match RequestHandler
610
- // biome-ignore lint/suspicious/noExplicitAny: express 5 type for urlencoded doesn't match RequestHandler
636
+ // express 5's urlencoded() handler type doesn't match RequestHandler directly
611
637
  app.use(express_1.default.urlencoded({ extended: false }));
612
638
  };
613
639
  exports.setupAuth = setupAuth;
@@ -628,6 +654,13 @@ var addAuthRoutes = function (app, userModel, authOptions) {
628
654
  logger_1.logger.warn("Invalid login: ".concat(info));
629
655
  return [2 /*return*/, res.status(401).json({ message: info === null || info === void 0 ? void 0 : info.message })];
630
656
  }
657
+ if ((authOptions === null || authOptions === void 0 ? void 0 : authOptions.requireEmailVerification) && user.emailVerified !== true) {
658
+ return [2 /*return*/, next(new errors_1.APIError({
659
+ code: "email-not-verified",
660
+ status: 403,
661
+ title: "Email is not verified",
662
+ }))];
663
+ }
631
664
  if (process.env.NODE_ENV !== "test") {
632
665
  logger_1.logger.info("User logged in: ".concat(user._id, ", type: ").concat(user.type || "N/A"));
633
666
  }
@@ -648,10 +681,10 @@ var addAuthRoutes = function (app, userModel, authOptions) {
648
681
  });
649
682
  }); });
650
683
  router.post("/refresh_token", function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
651
- var refreshTokenSecretOrKey, decoded, message, user, sessionId, tokens;
652
- var _a, _b, _c, _d;
653
- return __generator(this, function (_e) {
654
- switch (_e.label) {
684
+ var refreshTokenSecretOrKey, decoded, message, user, tokenEpoch, userEpoch, sessionId, tokens;
685
+ var _a, _b, _c, _d, _e, _f;
686
+ return __generator(this, function (_g) {
687
+ switch (_g.label) {
655
688
  case 0:
656
689
  if (!req.body.refreshToken) {
657
690
  logger_1.logger.error("No refresh token provided, must provide refreshToken in body, user id: ".concat((_a = req.user) === null || _a === void 0 ? void 0 : _a.id));
@@ -675,11 +708,17 @@ var addAuthRoutes = function (app, userModel, authOptions) {
675
708
  if (!(decoded === null || decoded === void 0 ? void 0 : decoded.id)) return [3 /*break*/, 3];
676
709
  return [4 /*yield*/, userModel.findById(decoded.id)];
677
710
  case 1:
678
- user = _e.sent();
711
+ user = _g.sent();
712
+ tokenEpoch = typeof decoded.te === "number" ? decoded.te : 0;
713
+ userEpoch = (_d = user === null || user === void 0 ? void 0 : user.tokenEpoch) !== null && _d !== void 0 ? _d : 0;
714
+ if (!user || tokenEpoch !== userEpoch) {
715
+ logger_1.logger.error("Invalid refresh token, user id: ".concat((_e = req.user) === null || _e === void 0 ? void 0 : _e.id));
716
+ return [2 /*return*/, res.status(401).json({ message: "Invalid refresh token" })];
717
+ }
679
718
  sessionId = (0, requestContext_1.getSessionIdFromJwtPayload)(decoded);
680
719
  return [4 /*yield*/, (0, exports.generateTokens)(user, authOptions, { sessionId: sessionId })];
681
720
  case 2:
682
- tokens = _e.sent();
721
+ tokens = _g.sent();
683
722
  if (tokens.sessionId) {
684
723
  (0, requestContext_1.setRequestContext)({
685
724
  sessionId: tokens.sessionId,
@@ -690,7 +729,7 @@ var addAuthRoutes = function (app, userModel, authOptions) {
690
729
  logger_1.logger.debug("Refreshed token for ".concat(user === null || user === void 0 ? void 0 : user.id));
691
730
  return [2 /*return*/, res.json({ data: { refreshToken: tokens.refreshToken, token: tokens.token } })];
692
731
  case 3:
693
- logger_1.logger.error("Invalid refresh token, user id: ".concat((_d = req.user) === null || _d === void 0 ? void 0 : _d.id));
732
+ logger_1.logger.error("Invalid refresh token, user id: ".concat((_f = req.user) === null || _f === void 0 ? void 0 : _f.id));
694
733
  return [2 /*return*/, res.status(401).json({ message: "Invalid refresh token" })];
695
734
  }
696
735
  });
@@ -714,12 +753,25 @@ var addAuthRoutes = function (app, userModel, authOptions) {
714
753
  return next();
715
754
  })(req, res, next);
716
755
  }, function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
717
- var tokens;
756
+ var error_6, tokens;
718
757
  var _a, _b;
719
758
  return __generator(this, function (_c) {
720
759
  switch (_c.label) {
721
- case 0: return [4 /*yield*/, (0, exports.generateTokens)(req.user, authOptions)];
760
+ case 0:
761
+ if (!req.user) return [3 /*break*/, 4];
762
+ _c.label = 1;
722
763
  case 1:
764
+ _c.trys.push([1, 3, , 4]);
765
+ return [4 /*yield*/, (0, authRecovery_1.sendVerificationEmail)(req.user, authOptions)];
766
+ case 2:
767
+ _c.sent();
768
+ return [3 /*break*/, 4];
769
+ case 3:
770
+ error_6 = _c.sent();
771
+ logger_1.logger.error("[auth] Failed to send verification mail after signup", { error: error_6 });
772
+ return [3 /*break*/, 4];
773
+ case 4: return [4 /*yield*/, (0, exports.generateTokens)(req.user, authOptions)];
774
+ case 5:
723
775
  tokens = _c.sent();
724
776
  if (tokens.sessionId) {
725
777
  (0, requestContext_1.setRequestContext)({
@@ -737,6 +789,7 @@ var addAuthRoutes = function (app, userModel, authOptions) {
737
789
  }
738
790
  app.set("etag", false);
739
791
  app.use("/auth", router);
792
+ (0, authRecovery_1.addAuthRecoveryRoutes)(app, userModel, authOptions);
740
793
  };
741
794
  exports.addAuthRoutes = addAuthRoutes;
742
795
  var addMeRoutes = function (app, userModel, _authOptions, accessControl) {
@@ -775,7 +828,7 @@ var addMeRoutes = function (app, userModel, _authOptions, accessControl) {
775
828
  });
776
829
  }); });
777
830
  router.patch("/me", (0, exports.authenticateMiddleware)(), function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
778
- var doc, dataObject, error_6, message;
831
+ var doc, update, isMailboxChange, dataObject, error_7, message;
779
832
  var _a, _b;
780
833
  return __generator(this, function (_c) {
781
834
  switch (_c.label) {
@@ -791,19 +844,31 @@ var addMeRoutes = function (app, userModel, _authOptions, accessControl) {
791
844
  }
792
845
  _c.label = 2;
793
846
  case 2:
794
- _c.trys.push([2, 4, , 5]);
795
- Object.assign(doc, (0, exports.stripPrivilegedUserFields)((_b = req.body) !== null && _b !== void 0 ? _b : {}, "PATCH /auth/me"));
796
- return [4 /*yield*/, doc.save()];
847
+ _c.trys.push([2, 7, , 8]);
848
+ update = (0, exports.stripPrivilegedUserFields)((_b = req.body) !== null && _b !== void 0 ? _b : {}, "PATCH /auth/me");
849
+ isMailboxChange = isEmailUpdateChangingMailbox(doc.email, update.email);
850
+ Object.assign(doc, update);
851
+ if (!isMailboxChange) return [3 /*break*/, 5];
852
+ return [4 /*yield*/, authTokens_1.AuthToken.invalidateUnusedFor({ _id: String(doc._id) }, "passwordReset")];
797
853
  case 3:
854
+ _c.sent();
855
+ if (!(userModel.schema.path("emailVerified") !== undefined)) return [3 /*break*/, 5];
856
+ doc.emailVerified = false;
857
+ return [4 /*yield*/, authTokens_1.AuthToken.invalidateUnusedFor({ _id: String(doc._id) }, "emailVerification")];
858
+ case 4:
859
+ _c.sent();
860
+ _c.label = 5;
861
+ case 5: return [4 /*yield*/, doc.save()];
862
+ case 6:
798
863
  _c.sent();
799
864
  dataObject = doc.toObject();
800
865
  dataObject.id = doc._id;
801
866
  return [2 /*return*/, res.json({ data: dataObject })];
802
- case 4:
803
- error_6 = _c.sent();
804
- message = (0, errors_1.errorMessage)(error_6);
867
+ case 7:
868
+ error_7 = _c.sent();
869
+ message = (0, errors_1.errorMessage)(error_7);
805
870
  return [2 /*return*/, res.status(403).send({ message: message })];
806
- case 5: return [2 /*return*/];
871
+ case 8: return [2 /*return*/];
807
872
  }
808
873
  });
809
874
  }); });
@@ -0,0 +1,5 @@
1
+ import express from "express";
2
+ import { type User, type UserModel } from "./auth";
3
+ import type { AuthOptions } from "./expressServer";
4
+ export declare const sendVerificationEmail: (user: User, authOptions?: AuthOptions) => Promise<void>;
5
+ export declare const addAuthRecoveryRoutes: (app: express.Application, userModel: UserModel, authOptions?: AuthOptions) => void;
@@ -0,0 +1,350 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __generator = (this && this.__generator) || function (thisArg, body) {
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
+ function verb(n) { return function (v) { return step([n, v]); }; }
15
+ function step(op) {
16
+ if (f) throw new TypeError("Generator is already executing.");
17
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
+ if (y = 0, t) op = [op[0] & 2, t.value];
20
+ switch (op[0]) {
21
+ case 0: case 1: t = op; break;
22
+ case 4: _.label++; return { value: op[1], done: false };
23
+ case 5: _.label++; y = op[1]; op = [0]; continue;
24
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
+ default:
26
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
+ if (t[2]) _.ops.pop();
31
+ _.trys.pop(); continue;
32
+ }
33
+ op = body.call(thisArg, _);
34
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
+ }
37
+ };
38
+ var __importDefault = (this && this.__importDefault) || function (mod) {
39
+ return (mod && mod.__esModule) ? mod : { "default": mod };
40
+ };
41
+ Object.defineProperty(exports, "__esModule", { value: true });
42
+ exports.addAuthRecoveryRoutes = exports.sendVerificationEmail = void 0;
43
+ var express_1 = __importDefault(require("express"));
44
+ var api_1 = require("./api");
45
+ var auth_1 = require("./auth");
46
+ var authTokens_1 = require("./authTokens");
47
+ var errors_1 = require("./errors");
48
+ var logger_1 = require("./logger");
49
+ var openApiBuilder_1 = require("./openApiBuilder");
50
+ var plugins_1 = require("./plugins");
51
+ var RESET_PASSWORD_SUBJECT = "Reset your password";
52
+ var VERIFY_EMAIL_SUBJECT = "Verify your email";
53
+ var resetPasswordText = function (resetUrl) {
54
+ return "Reset your password using this link: ".concat(resetUrl);
55
+ };
56
+ var resetPasswordHtml = function (resetUrl) {
57
+ return "<p><a href=\"".concat(resetUrl, "\">Reset your password</a></p>");
58
+ };
59
+ var verifyEmailText = function (verifyUrl) {
60
+ return "Verify your email using this link: ".concat(verifyUrl);
61
+ };
62
+ var verifyEmailHtml = function (verifyUrl) {
63
+ return "<p><a href=\"".concat(verifyUrl, "\">Verify your email</a></p>");
64
+ };
65
+ var normalizeEmail = function (value) {
66
+ if (typeof value !== "string") {
67
+ return "";
68
+ }
69
+ return value.trim().toLowerCase();
70
+ };
71
+ var escapeRegularExpression = function (value) {
72
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
73
+ };
74
+ var findUserByEmail = function (userModel, email) { return __awaiter(void 0, void 0, void 0, function () {
75
+ return __generator(this, function (_a) {
76
+ return [2 /*return*/, (0, plugins_1.findOneOrNoneFor)(userModel, {
77
+ email: { $options: "i", $regex: "^".concat(escapeRegularExpression(email), "$") },
78
+ })];
79
+ });
80
+ }); };
81
+ var passwordFromBody = function (body) {
82
+ if (typeof body.password === "string" && body.password.length > 0) {
83
+ return body.password;
84
+ }
85
+ if (typeof body.newPassword === "string" && body.newPassword.length > 0) {
86
+ return body.newPassword;
87
+ }
88
+ return "";
89
+ };
90
+ var tokenFromBody = function (body) {
91
+ if (typeof body.token === "string") {
92
+ return body.token;
93
+ }
94
+ return "";
95
+ };
96
+ var buildAppUrl = function (publicAppUrl, path, token) {
97
+ var base = (publicAppUrl !== null && publicAppUrl !== void 0 ? publicAppUrl : "").replace(/\/$/, "");
98
+ return "".concat(base).concat(path, "?token=").concat(encodeURIComponent(token));
99
+ };
100
+ var buildResetUrl = function (publicAppUrl, token) {
101
+ return buildAppUrl(publicAppUrl, "/resetPassword", token);
102
+ };
103
+ var buildVerifyUrl = function (publicAppUrl, token) {
104
+ return buildAppUrl(publicAppUrl, "/verifyEmail", token);
105
+ };
106
+ var userEmail = function (user, fallback) {
107
+ if (fallback === void 0) { fallback = ""; }
108
+ if (typeof user.email === "string") {
109
+ return user.email;
110
+ }
111
+ return fallback;
112
+ };
113
+ var isEmailVerified = function (user) {
114
+ return user.emailVerified === true;
115
+ };
116
+ var markEmailVerified = function (user) {
117
+ user.emailVerified = true;
118
+ };
119
+ var sendVerificationEmail = function (user, authOptions) { return __awaiter(void 0, void 0, void 0, function () {
120
+ var issued, verifyUrl;
121
+ return __generator(this, function (_a) {
122
+ switch (_a.label) {
123
+ case 0:
124
+ if (!(authOptions === null || authOptions === void 0 ? void 0 : authOptions.publicAppUrl)) {
125
+ logger_1.logger.error("[auth] publicAppUrl is required to send verification mail");
126
+ throw new errors_1.APIError({
127
+ status: 501,
128
+ title: "publicAppUrl is required to send verification mail",
129
+ });
130
+ }
131
+ if (isEmailVerified(user)) {
132
+ return [2 /*return*/];
133
+ }
134
+ return [4 /*yield*/, authTokens_1.AuthToken.issueFor({ _id: String(user._id) }, "emailVerification")];
135
+ case 1:
136
+ issued = _a.sent();
137
+ verifyUrl = buildVerifyUrl(authOptions.publicAppUrl, issued.token);
138
+ return [4 /*yield*/, deliverRecoveryMail(authOptions, {
139
+ html: verifyEmailHtml(verifyUrl),
140
+ subject: VERIFY_EMAIL_SUBJECT,
141
+ text: verifyEmailText(verifyUrl),
142
+ to: userEmail(user),
143
+ })];
144
+ case 2:
145
+ _a.sent();
146
+ return [2 /*return*/];
147
+ }
148
+ });
149
+ }); };
150
+ exports.sendVerificationEmail = sendVerificationEmail;
151
+ var deliverRecoveryMail = function (authOptions, message) { return __awaiter(void 0, void 0, void 0, function () {
152
+ return __generator(this, function (_a) {
153
+ switch (_a.label) {
154
+ case 0:
155
+ if (!(authOptions === null || authOptions === void 0 ? void 0 : authOptions.sendMail)) return [3 /*break*/, 2];
156
+ return [4 /*yield*/, authOptions.sendMail(message)];
157
+ case 1:
158
+ _a.sent();
159
+ return [2 /*return*/];
160
+ case 2:
161
+ if (process.env.NODE_ENV === "production") {
162
+ throw new errors_1.APIError({ status: 501, title: "Mail is not configured" });
163
+ }
164
+ logger_1.logger.info("[auth] Console recovery mail subject=".concat(message.subject, " textLength=").concat(message.text.length));
165
+ return [2 /*return*/];
166
+ }
167
+ });
168
+ }); };
169
+ var incrementTokenEpoch = function (user) {
170
+ var _a;
171
+ user.tokenEpoch = ((_a = user.tokenEpoch) !== null && _a !== void 0 ? _a : 0) + 1;
172
+ };
173
+ var addAuthRecoveryRoutes = function (app, userModel, authOptions) {
174
+ var forgotPassword = (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
175
+ var email, user, issued, resetUrl, error_1;
176
+ var _a;
177
+ return __generator(this, function (_b) {
178
+ switch (_b.label) {
179
+ case 0:
180
+ email = normalizeEmail((_a = req.body) === null || _a === void 0 ? void 0 : _a.email);
181
+ if (!email) return [3 /*break*/, 8];
182
+ _b.label = 1;
183
+ case 1:
184
+ _b.trys.push([1, 7, , 8]);
185
+ return [4 /*yield*/, findUserByEmail(userModel, email)];
186
+ case 2:
187
+ user = _b.sent();
188
+ if (!user) return [3 /*break*/, 6];
189
+ if (!!(authOptions === null || authOptions === void 0 ? void 0 : authOptions.publicAppUrl)) return [3 /*break*/, 3];
190
+ logger_1.logger.error("[auth] publicAppUrl is required to send password reset mail");
191
+ return [3 /*break*/, 6];
192
+ case 3: return [4 /*yield*/, authTokens_1.AuthToken.issueFor({ _id: String(user._id) }, "passwordReset")];
193
+ case 4:
194
+ issued = _b.sent();
195
+ resetUrl = buildResetUrl(authOptions.publicAppUrl, issued.token);
196
+ return [4 /*yield*/, deliverRecoveryMail(authOptions, {
197
+ html: resetPasswordHtml(resetUrl),
198
+ subject: RESET_PASSWORD_SUBJECT,
199
+ text: resetPasswordText(resetUrl),
200
+ to: userEmail(user, email),
201
+ })];
202
+ case 5:
203
+ _b.sent();
204
+ _b.label = 6;
205
+ case 6: return [3 /*break*/, 8];
206
+ case 7:
207
+ error_1 = _b.sent();
208
+ logger_1.logger.error("[auth] Failed to send password reset mail", { error: error_1 });
209
+ return [3 /*break*/, 8];
210
+ case 8: return [2 /*return*/, res.status(202).json({ data: { ok: true } })];
211
+ }
212
+ });
213
+ }); });
214
+ var resetPassword = (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
215
+ var body, token, password, consumed, user, tokens;
216
+ var _a;
217
+ return __generator(this, function (_b) {
218
+ switch (_b.label) {
219
+ case 0:
220
+ body = ((_a = req.body) !== null && _a !== void 0 ? _a : {});
221
+ token = tokenFromBody(body);
222
+ password = passwordFromBody(body);
223
+ if (!token || !password) {
224
+ throw new errors_1.APIError({ status: 400, title: "token and password are required" });
225
+ }
226
+ if (password.length > auth_1.MAX_PASSWORD_LENGTH) {
227
+ throw new errors_1.APIError({
228
+ status: 400,
229
+ title: "Password must be at most ".concat(auth_1.MAX_PASSWORD_LENGTH, " characters"),
230
+ });
231
+ }
232
+ return [4 /*yield*/, authTokens_1.AuthToken.consume(token, "passwordReset")];
233
+ case 1:
234
+ consumed = _b.sent();
235
+ if (!consumed) {
236
+ throw new errors_1.APIError({ status: 400, title: "Invalid or expired reset token" });
237
+ }
238
+ return [4 /*yield*/, userModel.findById(consumed.userId)];
239
+ case 2:
240
+ user = _b.sent();
241
+ if (!user) {
242
+ throw new errors_1.APIError({ status: 400, title: "Invalid or expired reset token" });
243
+ }
244
+ return [4 /*yield*/, (0, auth_1.setPasswordForUser)(user, password)];
245
+ case 3:
246
+ _b.sent();
247
+ incrementTokenEpoch(user);
248
+ return [4 /*yield*/, user.save()];
249
+ case 4:
250
+ _b.sent();
251
+ if (!(authOptions === null || authOptions === void 0 ? void 0 : authOptions.syncPasswordResetToBetterAuth)) return [3 /*break*/, 6];
252
+ return [4 /*yield*/, authOptions.syncPasswordResetToBetterAuth(user, password)];
253
+ case 5:
254
+ _b.sent();
255
+ _b.label = 6;
256
+ case 6: return [4 /*yield*/, (0, auth_1.generateTokens)(user, authOptions)];
257
+ case 7:
258
+ tokens = _b.sent();
259
+ return [2 /*return*/, res.json({
260
+ data: { refreshToken: tokens.refreshToken, token: tokens.token, userId: user._id },
261
+ })];
262
+ }
263
+ });
264
+ }); });
265
+ var forgotOpenApi = (0, openApiBuilder_1.createOpenApiBuilder)({})
266
+ .withTags(["auth"])
267
+ .withSummary("Request a password reset email")
268
+ .withRequestBody({ email: { type: "string" } })
269
+ .withResponse(202, { ok: { type: "boolean" } })
270
+ .build();
271
+ var resetOpenApi = (0, openApiBuilder_1.createOpenApiBuilder)({})
272
+ .withTags(["auth"])
273
+ .withSummary("Reset password with a one-time token")
274
+ .withRequestBody({
275
+ newPassword: { type: "string" },
276
+ password: { type: "string" },
277
+ token: { type: "string" },
278
+ })
279
+ .withResponse(200, {
280
+ refreshToken: { type: "string" },
281
+ token: { type: "string" },
282
+ userId: { type: "string" },
283
+ })
284
+ .build();
285
+ var sendVerification = (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
286
+ var user;
287
+ return __generator(this, function (_a) {
288
+ switch (_a.label) {
289
+ case 0:
290
+ user = req.user;
291
+ if (!user) {
292
+ throw new errors_1.APIError({ status: 401, title: "Unauthorized" });
293
+ }
294
+ return [4 /*yield*/, (0, exports.sendVerificationEmail)(user, authOptions)];
295
+ case 1:
296
+ _a.sent();
297
+ return [2 /*return*/, res.status(202).json({ data: { ok: true } })];
298
+ }
299
+ });
300
+ }); });
301
+ var verifyEmail = (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
302
+ var token, consumed, user;
303
+ var _a;
304
+ return __generator(this, function (_b) {
305
+ switch (_b.label) {
306
+ case 0:
307
+ token = tokenFromBody(((_a = req.body) !== null && _a !== void 0 ? _a : {}));
308
+ if (!token) {
309
+ throw new errors_1.APIError({ status: 400, title: "token is required" });
310
+ }
311
+ return [4 /*yield*/, authTokens_1.AuthToken.consume(token, "emailVerification")];
312
+ case 1:
313
+ consumed = _b.sent();
314
+ if (!consumed) {
315
+ throw new errors_1.APIError({ status: 400, title: "Invalid or expired verification token" });
316
+ }
317
+ return [4 /*yield*/, userModel.findById(consumed.userId)];
318
+ case 2:
319
+ user = _b.sent();
320
+ if (!user) {
321
+ throw new errors_1.APIError({ status: 400, title: "Invalid or expired verification token" });
322
+ }
323
+ markEmailVerified(user);
324
+ return [4 /*yield*/, user.save()];
325
+ case 3:
326
+ _b.sent();
327
+ return [2 /*return*/, res.json({ data: { ok: true } })];
328
+ }
329
+ });
330
+ }); });
331
+ var sendVerificationOpenApi = (0, openApiBuilder_1.createOpenApiBuilder)({})
332
+ .withTags(["auth"])
333
+ .withSummary("Send or resend an email verification link")
334
+ .withResponse(202, { ok: { type: "boolean" } })
335
+ .build();
336
+ var verifyEmailOpenApi = (0, openApiBuilder_1.createOpenApiBuilder)({})
337
+ .withTags(["auth"])
338
+ .withSummary("Verify email with a one-time token")
339
+ .withRequestBody({ token: { type: "string" } })
340
+ .withResponse(200, { ok: { type: "boolean" } })
341
+ .build();
342
+ var router = express_1.default.Router();
343
+ router.post("/forgotPassword", forgotOpenApi, forgotPassword);
344
+ router.post("/resetPassword", resetOpenApi, resetPassword);
345
+ router.post("/sendVerification", (0, auth_1.authenticateMiddleware)(), sendVerificationOpenApi, sendVerification);
346
+ router.post("/verifyEmail", verifyEmailOpenApi, verifyEmail);
347
+ app.use("/auth", router);
348
+ app.post("/resetPassword", resetOpenApi, resetPassword);
349
+ };
350
+ exports.addAuthRecoveryRoutes = addAuthRecoveryRoutes;
@@ -0,0 +1,8 @@
1
+ import { Duration } from "luxon";
2
+ import type { AuthTokenModel } from "./types/authToken";
3
+ export type { AuthTokenDocument, AuthTokenModel, AuthTokenType } from "./types/authToken";
4
+ export declare const AUTH_TOKEN_TTL: {
5
+ readonly emailVerification: Duration<true>;
6
+ readonly passwordReset: Duration<true>;
7
+ };
8
+ export declare const AuthToken: AuthTokenModel;