@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/src/auth.ts CHANGED
@@ -2,7 +2,7 @@ import {randomUUID} from "node:crypto";
2
2
  import express from "express";
3
3
  import jwt, {type JwtPayload} from "jsonwebtoken";
4
4
  import {DateTime} from "luxon";
5
- import type {Model, ObjectId} from "mongoose";
5
+ import type {Model, ObjectId, Query} from "mongoose";
6
6
  import ms, {type StringValue} from "ms";
7
7
  import passport from "passport";
8
8
  import {Strategy as AnonymousStrategy} from "passport-anonymous";
@@ -12,10 +12,12 @@ import {
12
12
  type StrategyOptions,
13
13
  } from "passport-jwt";
14
14
  import {Strategy as LocalStrategy} from "passport-local";
15
-
15
+ import {addAuthRecoveryRoutes, sendVerificationEmail} from "./authRecovery";
16
+ import {AuthToken} from "./authTokens";
16
17
  import {APIError, apiErrorMiddleware, errorMessage} from "./errors";
17
18
  import type {AuthOptions} from "./expressServer";
18
19
  import {logger} from "./logger";
20
+ import {isJwtCredentialExchangePath} from "./rateLimit/policies";
19
21
  import {
20
22
  getSessionIdFromJwtPayload,
21
23
  type JwtSessionPayload,
@@ -34,6 +36,12 @@ export interface User {
34
36
  * This can be helpful for pre-signup users.
35
37
  */
36
38
  isAnonymous?: boolean;
39
+ /** Login identifier; present on passport-local and Better Auth app users. */
40
+ email?: string;
41
+ /** Incremented on password reset so outstanding refresh tokens fail. */
42
+ tokenEpoch?: number;
43
+ /** Set by emailVerificationPlugin; login may require this when requireEmailVerification is on. */
44
+ emailVerified?: boolean;
37
45
  }
38
46
 
39
47
  export interface UserModel extends Model<User> {
@@ -41,18 +49,14 @@ export interface UserModel extends Model<User> {
41
49
  // Allows additional setup during signup. This will be passed the rest of req.body from the signup
42
50
  postCreate?: (body: Record<string, unknown>) => Promise<void>;
43
51
 
44
- // noExplicitAny: passport-local-mongoose return types are untyped
45
- // biome-ignore lint/suspicious/noExplicitAny: passport-local-mongoose return types are untyped
46
- createStrategy(): any;
47
- // noExplicitAny: passport-local-mongoose return types are untyped
48
- // biome-ignore lint/suspicious/noExplicitAny: passport-local-mongoose return types are untyped
49
- serializeUser(): any;
50
- // noExplicitAny: passport-local-mongoose return types are untyped
51
- // biome-ignore lint/suspicious/noExplicitAny: passport-local-mongoose return types are untyped
52
- deserializeUser(): any;
53
- // noExplicitAny: passport-local-mongoose return types are untyped
54
- // biome-ignore lint/suspicious/noExplicitAny: passport-local-mongoose return types are untyped
55
- findByUsername(username: string, findOpts: any): any;
52
+ // Provided by passport-local-mongoose:
53
+ createStrategy(): passport.Strategy;
54
+ serializeUser(): (user: User, cb: (err: unknown, id?: unknown) => void) => void;
55
+ deserializeUser(): (username: string, cb: (err: unknown, user?: User | null) => void) => void;
56
+ findByUsername(
57
+ username: string,
58
+ findOpts: boolean | {selectHashSaltFields?: boolean}
59
+ ): Query<User | null, User>;
56
60
  }
57
61
 
58
62
  export interface GenerateTokensOptions {
@@ -101,11 +105,18 @@ export const authenticateMiddleware = (anonymous = false) => {
101
105
  };
102
106
 
103
107
  /**
104
- * User fields that confer authority. Self-service requests (anonymous signup, `PATCH /me`)
105
- * must never set them, or any caller could grant themselves admin or an RBAC role. Elevate
106
- * users through the admin API or `access.roles.assign` instead.
108
+ * User fields that confer authority or skip security gates. Self-service requests
109
+ * (anonymous signup, `PATCH /me`) must never set them, or any caller could grant
110
+ * themselves admin, an RBAC role, a verified email, or a reset epoch. Elevate users
111
+ * through the admin API or `access.roles.assign` instead.
107
112
  */
108
- export const PRIVILEGED_USER_FIELDS = ["admin", "roles", "organizationIds"] as const;
113
+ export const PRIVILEGED_USER_FIELDS = [
114
+ "admin",
115
+ "roles",
116
+ "organizationIds",
117
+ "emailVerified",
118
+ "tokenEpoch",
119
+ ] as const;
109
120
 
110
121
  /**
111
122
  * Removes {@link PRIVILEGED_USER_FIELDS} from a self-service body. Fields are dropped rather
@@ -130,6 +141,13 @@ export const stripPrivilegedUserFields = (
130
141
  return sanitized;
131
142
  };
132
143
 
144
+ const isEmailUpdateChangingMailbox = (currentEmail: unknown, nextEmail: unknown): boolean => {
145
+ if (typeof currentEmail !== "string" || typeof nextEmail !== "string") {
146
+ return false;
147
+ }
148
+ return currentEmail.trim().toLowerCase() !== nextEmail.trim().toLowerCase();
149
+ };
150
+
133
151
  const omitPrivilegedFieldsFromObject = (item: unknown, allowAdminWrite: boolean): unknown => {
134
152
  if (!item || typeof item !== "object" || Array.isArray(item)) {
135
153
  return item;
@@ -181,9 +199,18 @@ export const signupUser = async (
181
199
  const bodyRest = stripPrivilegedUserFields(rawBody, "signup");
182
200
 
183
201
  try {
184
- // noExplicitAny: passport-local-mongoose's register() is untyped
185
- // biome-ignore lint/suspicious/noExplicitAny: passport-local-mongoose's register() is untyped
186
- const user = await (userModel as any).register({email, ...bodyRest}, password);
202
+ const registrableModel = userModel as UserModel & {
203
+ register(
204
+ user: Record<string, unknown>,
205
+ password: string
206
+ ): Promise<
207
+ User & {
208
+ postCreate?: (body: Record<string, unknown>) => Promise<void>;
209
+ save: () => Promise<unknown>;
210
+ }
211
+ >;
212
+ };
213
+ const user = await registrableModel.register({email, ...bodyRest}, password);
187
214
 
188
215
  if (user.postCreate) {
189
216
  try {
@@ -341,15 +368,20 @@ export const generateTokens = async (
341
368
  return {refreshToken: null, token: null};
342
369
  }
343
370
  const sessionId = options.sessionId ?? randomUUID();
344
- let payload: Record<string, unknown> = {id: String(tokenUser._id), sid: sessionId};
371
+ const authUser = user as User;
372
+ let payload: Record<string, unknown> = {
373
+ id: String(tokenUser._id),
374
+ sid: sessionId,
375
+ te: authUser.tokenEpoch ?? 0,
376
+ };
345
377
  if (authOptions?.generateJWTPayload) {
346
- payload = {...authOptions.generateJWTPayload(user), ...payload};
378
+ payload = {...authOptions.generateJWTPayload(authUser), ...payload};
347
379
  }
348
380
  const tokenOptions: jwt.SignOptions = {
349
381
  expiresIn: "15m",
350
382
  };
351
383
  if (authOptions?.generateTokenExpiration) {
352
- tokenOptions.expiresIn = authOptions.generateTokenExpiration(user);
384
+ tokenOptions.expiresIn = authOptions.generateTokenExpiration(authUser);
353
385
  } else if (process.env.TOKEN_EXPIRES_IN) {
354
386
  const expiresIn = validateDuration("TOKEN_EXPIRES_IN", process.env.TOKEN_EXPIRES_IN);
355
387
  if (expiresIn) {
@@ -368,7 +400,7 @@ export const generateTokens = async (
368
400
  expiresIn: "30d",
369
401
  };
370
402
  if (authOptions?.generateRefreshTokenExpiration) {
371
- refreshTokenOptions.expiresIn = authOptions.generateRefreshTokenExpiration(user);
403
+ refreshTokenOptions.expiresIn = authOptions.generateRefreshTokenExpiration(authUser);
372
404
  } else if (process.env.REFRESH_TOKEN_EXPIRES_IN) {
373
405
  const expiresIn = validateDuration(
374
406
  "REFRESH_TOKEN_EXPIRES_IN",
@@ -469,6 +501,12 @@ export const setupAuth = (app: express.Application, userModel: UserModel): void
469
501
  return next();
470
502
  }
471
503
 
504
+ // Login, signup, and refresh exchange credentials. A stale access JWT in
505
+ // Authorization / the jwt cookie must not 401 before those handlers run.
506
+ if (isJwtCredentialExchangePath(req)) {
507
+ return next();
508
+ }
509
+
472
510
  // Allow requests with a "Secret" prefix to pass through since this is a string value,
473
511
  // not a jwt that needs to be decoded
474
512
  if (req?.headers?.authorization?.split(" ")[0] === "Secret") {
@@ -535,9 +573,8 @@ export const setupAuth = (app: express.Application, userModel: UserModel): void
535
573
  return next();
536
574
  };
537
575
  app.use(decodeJWTMiddleware);
538
- // noExplicitAny: express 5 type for urlencoded doesn't match RequestHandler
539
- // biome-ignore lint/suspicious/noExplicitAny: express 5 type for urlencoded doesn't match RequestHandler
540
- app.use(express.urlencoded({extended: false}) as any);
576
+ // express 5's urlencoded() handler type doesn't match RequestHandler directly
577
+ app.use(express.urlencoded({extended: false}) as unknown as express.RequestHandler);
541
578
  };
542
579
 
543
580
  export const addAuthRoutes = (
@@ -563,6 +600,15 @@ export const addAuthRoutes = (
563
600
  logger.warn(`Invalid login: ${info}`);
564
601
  return res.status(401).json({message: info?.message});
565
602
  }
603
+ if (authOptions?.requireEmailVerification && user.emailVerified !== true) {
604
+ return next(
605
+ new APIError({
606
+ code: "email-not-verified",
607
+ status: 403,
608
+ title: "Email is not verified",
609
+ })
610
+ );
611
+ }
566
612
  if (process.env.NODE_ENV !== "test") {
567
613
  logger.info(`User logged in: ${user._id}, type: ${user.type || "N/A"}`);
568
614
  }
@@ -602,6 +648,12 @@ export const addAuthRoutes = (
602
648
  }
603
649
  if (decoded?.id) {
604
650
  const user = await userModel.findById(decoded.id);
651
+ const tokenEpoch = typeof decoded.te === "number" ? decoded.te : 0;
652
+ const userEpoch = (user as User | null)?.tokenEpoch ?? 0;
653
+ if (!user || tokenEpoch !== userEpoch) {
654
+ logger.error(`Invalid refresh token, user id: ${req.user?.id}`);
655
+ return res.status(401).json({message: "Invalid refresh token"});
656
+ }
605
657
  const sessionId = getSessionIdFromJwtPayload(decoded as JwtSessionPayload);
606
658
  const tokens = await generateTokens(user, authOptions, {sessionId});
607
659
  if (tokens.sessionId) {
@@ -643,6 +695,13 @@ export const addAuthRoutes = (
643
695
  )(req, res, next);
644
696
  },
645
697
  async (req: express.Request, res: express.Response) => {
698
+ if (req.user) {
699
+ try {
700
+ await sendVerificationEmail(req.user, authOptions);
701
+ } catch (error: unknown) {
702
+ logger.error("[auth] Failed to send verification mail after signup", {error});
703
+ }
704
+ }
646
705
  const tokens = await generateTokens(req.user, authOptions);
647
706
  if (tokens.sessionId) {
648
707
  setRequestContext({
@@ -659,6 +718,7 @@ export const addAuthRoutes = (
659
718
  }
660
719
  app.set("etag", false);
661
720
  app.use("/auth", router);
721
+ addAuthRecoveryRoutes(app, userModel, authOptions);
662
722
  };
663
723
 
664
724
  export const addMeRoutes = (
@@ -705,7 +765,16 @@ export const addMeRoutes = (
705
765
  // return res.status(403).send({message: (e as Error).message});
706
766
  // }
707
767
  try {
708
- Object.assign(doc, stripPrivilegedUserFields(req.body ?? {}, "PATCH /auth/me"));
768
+ const update = stripPrivilegedUserFields(req.body ?? {}, "PATCH /auth/me");
769
+ const isMailboxChange = isEmailUpdateChangingMailbox(doc.email, update.email);
770
+ Object.assign(doc, update);
771
+ if (isMailboxChange) {
772
+ await AuthToken.invalidateUnusedFor({_id: String(doc._id)}, "passwordReset");
773
+ if (userModel.schema.path("emailVerified") !== undefined) {
774
+ doc.emailVerified = false;
775
+ await AuthToken.invalidateUnusedFor({_id: String(doc._id)}, "emailVerification");
776
+ }
777
+ }
709
778
  await doc.save();
710
779
 
711
780
  const dataObject = doc.toObject() as unknown as Record<string, unknown>;
@@ -0,0 +1,281 @@
1
+ import {beforeEach, describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+ import type express from "express";
4
+ import mongoose from "mongoose";
5
+ import supertest from "supertest";
6
+
7
+ import {MAX_PASSWORD_LENGTH} from "./auth";
8
+ import {AuthToken} from "./authTokens";
9
+ import {TerrenoApp} from "./terrenoApp";
10
+ import {setupDb, UserModel} from "./tests";
11
+
12
+ interface CapturedMail {
13
+ html?: string;
14
+ subject: string;
15
+ text: string;
16
+ to: string;
17
+ }
18
+
19
+ const tokenFromResetUrl = (text: string): string => {
20
+ const match = text.match(/token=([0-9a-f]+)/i);
21
+ assert.isNotNull(match);
22
+ return match?.[1] ?? "";
23
+ };
24
+
25
+ describe("password reset routes", () => {
26
+ let app: express.Application;
27
+ let sentMail: CapturedMail[];
28
+
29
+ beforeEach(async () => {
30
+ await setupDb();
31
+ await AuthToken.deleteMany({});
32
+ sentMail = [];
33
+
34
+ app = new TerrenoApp({
35
+ authOptions: {
36
+ publicAppUrl: "https://app.example.com",
37
+ sendMail: async (message) => {
38
+ sentMail.push(message);
39
+ },
40
+ },
41
+ skipListen: true,
42
+ userModel: UserModel,
43
+ }).build();
44
+ });
45
+
46
+ it("returns 202 for existing and missing emails and only mails existing users", async () => {
47
+ const existing = await supertest(app)
48
+ .post("/auth/forgotPassword")
49
+ .send({email: "notAdmin@example.com"})
50
+ .expect(202);
51
+ const missing = await supertest(app)
52
+ .post("/auth/forgotPassword")
53
+ .send({email: "nobody@example.com"})
54
+ .expect(202);
55
+
56
+ assert.deepEqual(existing.body, missing.body);
57
+ assert.equal(sentMail.length, 1);
58
+ assert.equal(sentMail[0]?.to, "notAdmin@example.com");
59
+ assert.include(sentMail[0]?.text ?? "", "https://app.example.com/resetPassword?token=");
60
+ });
61
+
62
+ it("finds an existing user email case-insensitively", async () => {
63
+ const users = await UserModel.find({email: "notAdmin@example.com"});
64
+ const user = users[0];
65
+ assert.isDefined(user);
66
+ if (!user) {
67
+ return;
68
+ }
69
+ user.email = "Mixed.Case@Example.com";
70
+ await user.save();
71
+
72
+ await supertest(app)
73
+ .post("/auth/forgotPassword")
74
+ .send({email: "mixed.case@example.com"})
75
+ .expect(202);
76
+
77
+ assert.equal(sentMail.length, 1);
78
+ assert.equal(sentMail[0]?.to, "Mixed.Case@Example.com");
79
+ });
80
+
81
+ it("resets the password once, then rejects the token and old refresh tokens", async () => {
82
+ const login = await supertest(app)
83
+ .post("/auth/login")
84
+ .send({email: "notAdmin@example.com", password: "password"})
85
+ .expect(200);
86
+ const oldRefresh = login.body.data.refreshToken as string;
87
+
88
+ await supertest(app)
89
+ .post("/auth/forgotPassword")
90
+ .send({email: "notAdmin@example.com"})
91
+ .expect(202);
92
+ const token = tokenFromResetUrl(sentMail[0]?.text ?? "");
93
+
94
+ const reset = await supertest(app)
95
+ .post("/auth/resetPassword")
96
+ .send({password: "new-password-123", token})
97
+ .expect(200);
98
+ assert.isString(reset.body.data.token);
99
+
100
+ await supertest(app)
101
+ .post("/auth/resetPassword")
102
+ .send({password: "another-password", token})
103
+ .expect(400);
104
+
105
+ await supertest(app)
106
+ .post("/auth/login")
107
+ .send({email: "notAdmin@example.com", password: "password"})
108
+ .expect(401);
109
+ await supertest(app)
110
+ .post("/auth/login")
111
+ .send({email: "notAdmin@example.com", password: "new-password-123"})
112
+ .expect(200);
113
+
114
+ const refresh = await supertest(app)
115
+ .post("/auth/refresh_token")
116
+ .send({refreshToken: oldRefresh})
117
+ .expect(401);
118
+ assert.equal(refresh.body.message, "Invalid refresh token");
119
+ });
120
+
121
+ it("honors the RTK client POST /resetPassword path and body shape", async () => {
122
+ await supertest(app)
123
+ .post("/auth/forgotPassword")
124
+ .send({email: "notAdmin@example.com"})
125
+ .expect(202);
126
+ const token = tokenFromResetUrl(sentMail[0]?.text ?? "");
127
+
128
+ await supertest(app)
129
+ .post("/resetPassword")
130
+ .send({
131
+ _id: "unused",
132
+ email: "notAdmin@example.com",
133
+ newPassword: "rtk-new-password",
134
+ oldPassword: "password",
135
+ password: "rtk-new-password",
136
+ token,
137
+ })
138
+ .expect(200);
139
+
140
+ await supertest(app)
141
+ .post("/auth/login")
142
+ .send({email: "notAdmin@example.com", password: "rtk-new-password"})
143
+ .expect(200);
144
+ });
145
+
146
+ it("syncs a successful JWT reset to Better Auth when a bridge is configured", async () => {
147
+ const synced: Array<{email?: string; password: string}> = [];
148
+ const bridgedApp = new TerrenoApp({
149
+ authOptions: {
150
+ publicAppUrl: "https://app.example.com",
151
+ sendMail: async (message) => {
152
+ sentMail.push(message);
153
+ },
154
+ syncPasswordResetToBetterAuth: async (user, password) => {
155
+ synced.push({email: (user as {email?: string}).email, password});
156
+ },
157
+ },
158
+ skipListen: true,
159
+ userModel: UserModel,
160
+ }).build();
161
+
162
+ await supertest(bridgedApp)
163
+ .post("/auth/forgotPassword")
164
+ .send({email: "notAdmin@example.com"})
165
+ .expect(202);
166
+ const token = tokenFromResetUrl(sentMail[sentMail.length - 1]?.text ?? "");
167
+
168
+ await supertest(bridgedApp)
169
+ .post("/auth/resetPassword")
170
+ .send({password: "bridged-password-123", token})
171
+ .expect(200);
172
+
173
+ assert.equal(synced.length, 1);
174
+ assert.equal(synced[0]?.email, "notAdmin@example.com");
175
+ assert.equal(synced[0]?.password, "bridged-password-123");
176
+ });
177
+
178
+ it("does not consume a reset token when the new password is too long", async () => {
179
+ await supertest(app)
180
+ .post("/auth/forgotPassword")
181
+ .send({email: "notAdmin@example.com"})
182
+ .expect(202);
183
+ const token = tokenFromResetUrl(sentMail[0]?.text ?? "");
184
+
185
+ await supertest(app)
186
+ .post("/auth/resetPassword")
187
+ .send({password: "x".repeat(MAX_PASSWORD_LENGTH + 1), token})
188
+ .expect(400);
189
+
190
+ await supertest(app)
191
+ .post("/auth/resetPassword")
192
+ .send({password: "valid-after-too-long", token})
193
+ .expect(200);
194
+ });
195
+
196
+ it("accepts newPassword when password is omitted", async () => {
197
+ await supertest(app)
198
+ .post("/auth/forgotPassword")
199
+ .send({email: "notAdmin@example.com"})
200
+ .expect(202);
201
+ const token = tokenFromResetUrl(sentMail[0]?.text ?? "");
202
+
203
+ await supertest(app)
204
+ .post("/auth/resetPassword")
205
+ .send({newPassword: "only-new-password", token})
206
+ .expect(200);
207
+ });
208
+
209
+ it("returns 202 without issuing a token when publicAppUrl is missing", async () => {
210
+ const noUrlApp = new TerrenoApp({
211
+ authOptions: {
212
+ sendMail: async (message) => {
213
+ sentMail.push(message);
214
+ },
215
+ },
216
+ skipListen: true,
217
+ userModel: UserModel,
218
+ }).build();
219
+ const before = await AuthToken.countDocuments({});
220
+ await supertest(noUrlApp)
221
+ .post("/auth/forgotPassword")
222
+ .send({email: "notAdmin@example.com"})
223
+ .expect(202);
224
+ assert.equal(sentMail.length, 0);
225
+ assert.equal(await AuthToken.countDocuments({}), before);
226
+ });
227
+
228
+ it("returns 202 for a non-string email and for a missing body", async () => {
229
+ await supertest(app).post("/auth/forgotPassword").send({email: 12}).expect(202);
230
+ await supertest(app).post("/auth/forgotPassword").send({}).expect(202);
231
+ assert.equal(sentMail.length, 0);
232
+ });
233
+
234
+ it("rejects reset without a token or password", async () => {
235
+ await supertest(app).post("/auth/resetPassword").send({password: "enough-chars"}).expect(400);
236
+ await supertest(app).post("/auth/resetPassword").send({token: "deadbeef"}).expect(400);
237
+ });
238
+
239
+ it("returns 400 when the consumed reset token has no user", async () => {
240
+ const orphanId = new mongoose.Types.ObjectId();
241
+ const issued = await AuthToken.issueFor({_id: orphanId}, "passwordReset");
242
+ await supertest(app)
243
+ .post("/auth/resetPassword")
244
+ .send({password: "valid-password", token: issued.token})
245
+ .expect(400);
246
+ });
247
+
248
+ it("logs recovery mail to the console when sendMail is unset outside production", async () => {
249
+ const consoleApp = new TerrenoApp({
250
+ authOptions: {
251
+ publicAppUrl: "https://app.example.com",
252
+ },
253
+ skipListen: true,
254
+ userModel: UserModel,
255
+ }).build();
256
+ await supertest(consoleApp)
257
+ .post("/auth/forgotPassword")
258
+ .send({email: "notAdmin@example.com"})
259
+ .expect(202);
260
+ });
261
+
262
+ it("still returns 202 when production mail is unset", async () => {
263
+ const previous = process.env.NODE_ENV;
264
+ process.env.NODE_ENV = "production";
265
+ try {
266
+ const consoleApp = new TerrenoApp({
267
+ authOptions: {
268
+ publicAppUrl: "https://app.example.com",
269
+ },
270
+ skipListen: true,
271
+ userModel: UserModel,
272
+ }).build();
273
+ await supertest(consoleApp)
274
+ .post("/auth/forgotPassword")
275
+ .send({email: "notAdmin@example.com"})
276
+ .expect(202);
277
+ } finally {
278
+ process.env.NODE_ENV = previous;
279
+ }
280
+ });
281
+ });