@terreno/api 57.2.0 → 57.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,27 +1,42 @@
1
- // noExplicitAny: test mock typing
2
- // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
3
1
  import {afterAll, afterEach, describe, expect, it, mock} from "bun:test";
4
2
  import {assert} from "chai";
5
- import express from "express";
3
+ import express, {type Request, type Response} from "express";
6
4
  import {MongoMemoryServer} from "mongodb-memory-server";
7
5
  import mongoose, {Schema} from "mongoose";
6
+ import passportLocalMongoose from "passport-local-mongoose";
8
7
  import type {UserModel} from "./auth";
9
- import type {BetterAuthConfig, BetterAuthUser} from "./betterAuth";
8
+ import type {BetterAuthConfig, BetterAuthSessionData, BetterAuthUser} from "./betterAuth";
10
9
  import {
10
+ applyBetterAuthPasswordResetToJwt,
11
+ applyJwtPasswordResetToBetterAuth,
12
+ type BetterAuthInstance,
11
13
  createBetterAuth,
14
+ createBetterAuthEmailHooks,
12
15
  createBetterAuthSessionMiddleware,
13
16
  getBetterAuthSession,
14
17
  getMongoClientFromMongoose,
15
18
  hasBetterAuthSession,
19
+ type MongoClientLike,
16
20
  mountBetterAuthRoutes,
21
+ readPasswordFromBetterAuthResetRequest,
17
22
  setupBetterAuthUserSync,
18
23
  syncBetterAuthUser,
19
24
  } from "./betterAuthSetup";
20
25
 
26
+ type SessionRequest = Request & {betterAuthSession?: BetterAuthSessionData};
27
+ const makeReq = (overrides: Partial<SessionRequest> = {}): SessionRequest =>
28
+ ({headers: {}, ...overrides}) as SessionRequest;
29
+ const makeRes = (): Response => ({}) as Response;
30
+ const setGetSession = (auth: BetterAuthInstance, getSession: () => unknown): void => {
31
+ (auth.api as unknown as {getSession: () => unknown}).getSession = getSession;
32
+ };
33
+
21
34
  // Use a separate connection to avoid conflict with bunSetup.ts preload
22
35
  let conn: mongoose.Connection;
23
36
  let mongod: MongoMemoryServer;
24
- let TestUser: any;
37
+ let TestUser: UserModel;
38
+ let StrictUser: UserModel;
39
+ let DualAuthUser: UserModel;
25
40
 
26
41
  // Simple user schema for testing
27
42
  const testUserSchema = new Schema({
@@ -32,16 +47,43 @@ const testUserSchema = new Schema({
32
47
  oauthProvider: {type: String},
33
48
  });
34
49
 
50
+ const dualAuthUserSchema = new Schema({
51
+ admin: {default: false, type: Boolean},
52
+ betterAuthId: {type: String},
53
+ email: {required: true, type: String},
54
+ name: {type: String},
55
+ tokenEpoch: {default: 0, type: Number},
56
+ });
57
+ dualAuthUserSchema.plugin(
58
+ passportLocalMongoose as unknown as (schema: Schema, options?: Record<string, unknown>) => void,
59
+ {
60
+ usernameCaseInsensitive: true,
61
+ usernameField: "email",
62
+ }
63
+ );
64
+
65
+ const strictUserSchema = new Schema(
66
+ {
67
+ admin: {default: false, type: Boolean},
68
+ betterAuthId: {type: String},
69
+ email: {required: true, type: String},
70
+ name: {type: String},
71
+ },
72
+ {strict: "throw"}
73
+ );
74
+
35
75
  // Start memory server and create connection before tests run
36
76
  const setup = (async () => {
37
77
  mongod = await MongoMemoryServer.create();
38
78
  conn = mongoose.createConnection(mongod.getUri());
39
79
  await conn.asPromise();
40
- TestUser = conn.model("BetterAuthTestUser", testUserSchema);
80
+ TestUser = conn.model("BetterAuthTestUser", testUserSchema) as UserModel;
81
+ StrictUser = conn.model("BetterAuthStrictUser", strictUserSchema) as UserModel;
82
+ DualAuthUser = conn.model("BetterAuthDualUser", dualAuthUserSchema) as UserModel;
41
83
  })();
42
84
 
43
85
  // Helper to get the mongo client from our separate connection
44
- const getClient = () => (conn as any).client;
86
+ const getClient = (): MongoClientLike => conn.getClient();
45
87
 
46
88
  afterAll(async () => {
47
89
  await conn?.close();
@@ -51,6 +93,8 @@ afterAll(async () => {
51
93
  afterEach(async () => {
52
94
  await setup;
53
95
  await TestUser.deleteMany({});
96
+ await StrictUser.deleteMany({});
97
+ await DualAuthUser.deleteMany({});
54
98
  });
55
99
 
56
100
  describe("createBetterAuth", () => {
@@ -102,6 +146,33 @@ describe("createBetterAuth", () => {
102
146
  expect(auth.api).toBeDefined();
103
147
  });
104
148
 
149
+ it("does not 429 a burst of email sign-ups when disableRateLimit is set", async () => {
150
+ await setup;
151
+ const config: BetterAuthConfig = {
152
+ baseURL: "http://localhost:3000",
153
+ disableRateLimit: true,
154
+ enabled: true,
155
+ secret: "test-secret-at-least-32-characters-long",
156
+ };
157
+ const auth = createBetterAuth({config, mongoClient: getClient()});
158
+
159
+ for (let index = 0; index < 6; index += 1) {
160
+ const response = await auth.handler(
161
+ new globalThis.Request("https://localhost:3000/api/auth/sign-up/email", {
162
+ body: JSON.stringify({
163
+ email: `seed-burst-${index}@example.com`,
164
+ name: `Seed Burst ${index}`,
165
+ password: "testpassword123",
166
+ }),
167
+ headers: {"Content-Type": "application/json"},
168
+ method: "POST",
169
+ })
170
+ );
171
+ assert.notEqual(response.status, 429, `sign-up ${index} was rate-limited`);
172
+ assert.isTrue(response.ok, `sign-up ${index} failed: ${response.status}`);
173
+ }
174
+ });
175
+
105
176
  it("sets cross-site session cookies when crossDomainCookies is enabled", async () => {
106
177
  await setup;
107
178
  const origin = "https://frontend.example.com";
@@ -115,7 +186,7 @@ describe("createBetterAuth", () => {
115
186
  const auth = createBetterAuth({config, mongoClient: getClient()});
116
187
 
117
188
  const response = await auth.handler(
118
- new Request("https://api.example.com/api/auth/sign-up/email", {
189
+ new globalThis.Request("https://api.example.com/api/auth/sign-up/email", {
119
190
  body: JSON.stringify({
120
191
  email: "cross-domain-cookie@example.com",
121
192
  name: "Cross Domain",
@@ -177,6 +248,468 @@ describe("createBetterAuth", () => {
177
248
  const auth = createBetterAuth({config, mongoClient: getClient()});
178
249
  expect(auth).toBeDefined();
179
250
  });
251
+
252
+ it("revokes Better Auth sessions on password reset", async () => {
253
+ await setup;
254
+ const config: BetterAuthConfig = {
255
+ baseURL: "http://localhost:3000",
256
+ enabled: true,
257
+ secret: "test-secret-at-least-32-characters-long",
258
+ };
259
+ const auth = createBetterAuth({config, mongoClient: getClient()});
260
+ const options = (
261
+ auth as {
262
+ options?: {emailAndPassword?: {revokeSessionsOnPasswordReset?: boolean}};
263
+ }
264
+ ).options;
265
+ assert.isTrue(options?.emailAndPassword?.revokeSessionsOnPasswordReset);
266
+ });
267
+
268
+ it("wires JWT password sync when a user model is provided", async () => {
269
+ await setup;
270
+ const config: BetterAuthConfig = {
271
+ baseURL: "http://localhost:3000",
272
+ enabled: true,
273
+ secret: "test-secret-at-least-32-characters-long",
274
+ };
275
+ const auth = createBetterAuth({
276
+ config,
277
+ mongoClient: getClient(),
278
+ userModel: DualAuthUser,
279
+ });
280
+ const options = (
281
+ auth as {
282
+ options?: {emailAndPassword?: {onPasswordReset?: unknown}};
283
+ }
284
+ ).options;
285
+ assert.isFunction(options?.emailAndPassword?.onPasswordReset);
286
+ });
287
+
288
+ it("sends reset and verification mail through the injected renderer", async () => {
289
+ await setup;
290
+ const renderedCalls: Array<{templateId: string; token: string}> = [];
291
+ const sent: Array<{subject: string; text?: string; to: string}> = [];
292
+ const hooks = createBetterAuthEmailHooks({
293
+ enabled: true,
294
+ publicAppUrl: "https://app.example.com",
295
+ renderAuthMail: ({templateId, token}) => {
296
+ renderedCalls.push({templateId, token});
297
+ return {subject: templateId, text: `link-${token}`};
298
+ },
299
+ sendMail: async (message) => {
300
+ sent.push({subject: message.subject, text: message.text, to: message.to});
301
+ },
302
+ });
303
+ assert.isDefined(hooks);
304
+ await hooks?.sendResetPassword({
305
+ token: "reset-token",
306
+ url: "https://better-auth.example/ignored",
307
+ user: {email: "reset@example.com"},
308
+ });
309
+ await hooks?.sendVerificationEmail({
310
+ token: "verify-token",
311
+ url: "https://better-auth.example/ignored",
312
+ user: {email: "verify@example.com"},
313
+ });
314
+ assert.deepEqual(renderedCalls, [
315
+ {templateId: "resetPassword", token: "reset-token"},
316
+ {templateId: "verifyEmail", token: "verify-token"},
317
+ ]);
318
+ assert.deepEqual(sent, [
319
+ {subject: "resetPassword", text: "link-reset-token", to: "reset@example.com"},
320
+ {subject: "verifyEmail", text: "link-verify-token", to: "verify@example.com"},
321
+ ]);
322
+ });
323
+
324
+ it("does not send Better Auth recovery mail when publicAppUrl is missing", async () => {
325
+ await setup;
326
+ const sent: Array<{subject: string; to: string}> = [];
327
+ const hooks = createBetterAuthEmailHooks({
328
+ enabled: true,
329
+ sendMail: async (message) => {
330
+ sent.push({subject: message.subject, to: message.to});
331
+ },
332
+ });
333
+ assert.isDefined(hooks);
334
+ await expect(
335
+ hooks?.sendResetPassword({
336
+ token: "reset-token",
337
+ url: "https://better-auth.example/ignored",
338
+ user: {email: "reset@example.com"},
339
+ })
340
+ ).rejects.toThrow("publicAppUrl is required to send recovery mail");
341
+ await expect(
342
+ hooks?.sendVerificationEmail({
343
+ token: "verify-token",
344
+ url: "https://better-auth.example/ignored",
345
+ user: {email: "verify@example.com"},
346
+ })
347
+ ).rejects.toThrow("publicAppUrl is required to send recovery mail");
348
+ assert.deepEqual(sent, []);
349
+ });
350
+ });
351
+
352
+ describe("applyJwtPasswordResetToBetterAuth", () => {
353
+ it("updates the Better Auth credential hash and drops sessions", async () => {
354
+ await setup;
355
+ const auth = createBetterAuth({
356
+ config: {
357
+ baseURL: "http://localhost:3000",
358
+ enabled: true,
359
+ secret: "test-secret-at-least-32-characters-long",
360
+ },
361
+ mongoClient: getClient(),
362
+ });
363
+ const created = await auth.api.signUpEmail({
364
+ body: {
365
+ email: "dual@example.com",
366
+ name: "Dual User",
367
+ password: "old-password-123",
368
+ },
369
+ });
370
+ const betterAuthId = created.user.id;
371
+ await applyJwtPasswordResetToBetterAuth(
372
+ auth,
373
+ {betterAuthId, email: "dual@example.com"},
374
+ "new-password-123"
375
+ );
376
+ await expect(
377
+ auth.api.signInEmail({
378
+ body: {email: "dual@example.com", password: "old-password-123"},
379
+ })
380
+ ).rejects.toThrow();
381
+ const signedIn = await auth.api.signInEmail({
382
+ body: {email: "dual@example.com", password: "new-password-123"},
383
+ });
384
+ assert.isDefined(signedIn.user);
385
+ });
386
+ });
387
+
388
+ describe("readPasswordFromBetterAuthResetRequest", () => {
389
+ it("reads newPassword from a JSON request body", async () => {
390
+ const request = new globalThis.Request("http://localhost/api/auth/reset-password", {
391
+ body: JSON.stringify({newPassword: "synced-password-123", token: "reset-token"}),
392
+ headers: {"Content-Type": "application/json"},
393
+ method: "POST",
394
+ });
395
+ const password = await readPasswordFromBetterAuthResetRequest(request);
396
+ assert.equal(password, "synced-password-123");
397
+ });
398
+ });
399
+
400
+ describe("applyBetterAuthPasswordResetToJwt", () => {
401
+ it("updates the JWT password and tokenEpoch", async () => {
402
+ await setup;
403
+ const registerable = DualAuthUser as unknown as {
404
+ authenticate: () => (
405
+ email: string,
406
+ password: string
407
+ ) => Promise<{user: unknown; error?: Error}>;
408
+ register: (
409
+ user: {betterAuthId: string; email: string},
410
+ password: string
411
+ ) => Promise<{tokenEpoch?: number}>;
412
+ };
413
+ await registerable.register(
414
+ {betterAuthId: "ba-dual-1", email: "dual-jwt@example.com"},
415
+ "old-password-123"
416
+ );
417
+ const request = new globalThis.Request("http://localhost/api/auth/reset-password", {
418
+ body: JSON.stringify({newPassword: "new-password-123"}),
419
+ headers: {"Content-Type": "application/json"},
420
+ method: "POST",
421
+ });
422
+ await applyBetterAuthPasswordResetToJwt(
423
+ DualAuthUser,
424
+ {email: "dual-jwt@example.com", id: "ba-dual-1"},
425
+ request
426
+ );
427
+ const authenticate = registerable.authenticate();
428
+ const oldPassword = await authenticate("dual-jwt@example.com", "old-password-123");
429
+ assert.isNotOk(oldPassword.user);
430
+ const newPassword = await authenticate("dual-jwt@example.com", "new-password-123");
431
+ assert.isDefined(newPassword.user);
432
+ const reloaded = await DualAuthUser.findOne({email: "dual-jwt@example.com"});
433
+ assert.equal(reloaded?.tokenEpoch, 1);
434
+ });
435
+
436
+ it("skips JWT sync when no app user exists", async () => {
437
+ await setup;
438
+ const request = new globalThis.Request("http://localhost/api/auth/reset-password", {
439
+ body: JSON.stringify({newPassword: "new-password-123"}),
440
+ headers: {"Content-Type": "application/json"},
441
+ method: "POST",
442
+ });
443
+ await applyBetterAuthPasswordResetToJwt(
444
+ DualAuthUser,
445
+ {email: "missing-jwt@example.com", id: "ba-missing"},
446
+ request
447
+ );
448
+ const missing = await DualAuthUser.findOne({email: "missing-jwt@example.com"});
449
+ assert.isNull(missing);
450
+ });
451
+
452
+ it("throws when the reset request does not carry a password", async () => {
453
+ await setup;
454
+ await DualAuthUser.create({
455
+ betterAuthId: "ba-dual-nopw",
456
+ email: "nopw-jwt@example.com",
457
+ });
458
+ const request = new globalThis.Request("http://localhost/api/auth/reset-password", {
459
+ body: JSON.stringify({token: "reset-token"}),
460
+ headers: {"Content-Type": "application/json"},
461
+ method: "POST",
462
+ });
463
+ await expect(
464
+ applyBetterAuthPasswordResetToJwt(
465
+ DualAuthUser,
466
+ {email: "nopw-jwt@example.com", id: "ba-dual-nopw"},
467
+ request
468
+ )
469
+ ).rejects.toThrow("Password reset could not sync to JWT credentials");
470
+ });
471
+ });
472
+
473
+ describe("readPasswordFromBetterAuthResetRequest edge cases", () => {
474
+ it("returns an empty string when there is no request", async () => {
475
+ assert.equal(await readPasswordFromBetterAuthResetRequest(undefined), "");
476
+ });
477
+
478
+ it("reads password from an already-parsed body", async () => {
479
+ assert.equal(
480
+ await readPasswordFromBetterAuthResetRequest({body: {password: "attached-pw"}}),
481
+ "attached-pw"
482
+ );
483
+ });
484
+
485
+ it("returns an empty string when the body is not an object and clone is unavailable", async () => {
486
+ assert.equal(await readPasswordFromBetterAuthResetRequest({body: "raw"}), "");
487
+ });
488
+
489
+ it("returns an empty string when the body has no string password", async () => {
490
+ assert.equal(await readPasswordFromBetterAuthResetRequest({body: {newPassword: 42}}), "");
491
+ });
492
+
493
+ it("returns an empty string when cloning the request fails to parse JSON", async () => {
494
+ const request = {
495
+ clone: () => ({
496
+ json: async (): Promise<unknown> => {
497
+ throw new Error("bad json");
498
+ },
499
+ }),
500
+ };
501
+ assert.equal(await readPasswordFromBetterAuthResetRequest(request), "");
502
+ });
503
+ });
504
+
505
+ describe("createBetterAuthEmailHooks fallback rendering", () => {
506
+ it("renders the built-in templates with interpolated links", async () => {
507
+ const sent: Array<{html?: string; subject: string; text: string; to: string}> = [];
508
+ const hooks = createBetterAuthEmailHooks({
509
+ enabled: true,
510
+ publicAppUrl: "https://app.example.com/",
511
+ sendMail: async (message) => {
512
+ sent.push(message);
513
+ },
514
+ });
515
+ assert.isDefined(hooks);
516
+ await hooks?.sendResetPassword({
517
+ token: "a b",
518
+ url: "ignored",
519
+ user: {email: "reset@example.com"},
520
+ });
521
+ await hooks?.sendVerificationEmail({
522
+ token: "v",
523
+ url: "ignored",
524
+ user: {email: "verify@example.com"},
525
+ });
526
+ assert.lengthOf(sent, 2);
527
+ assert.equal(sent[0].subject, "Reset your password");
528
+ assert.equal(sent[0].to, "reset@example.com");
529
+ assert.include(sent[0].text, "https://app.example.com/resetPassword?token=a%20b");
530
+ assert.include(sent[0].html ?? "", 'href="https://app.example.com/resetPassword?token=a%20b"');
531
+ assert.equal(sent[1].subject, "Verify your email");
532
+ assert.include(sent[1].text, "https://app.example.com/verifyEmail?token=v");
533
+ });
534
+
535
+ it("uses custom templates and tolerates missing html/text and unknown keys", async () => {
536
+ const sent: Array<{html?: string; subject: string; text: string; to: string}> = [];
537
+ const hooks = createBetterAuthEmailHooks({
538
+ authMailTemplates: {
539
+ resetPassword: {subject: "Reset for {{ publicAppUrl }} {{unknownKey}}"},
540
+ },
541
+ enabled: true,
542
+ publicAppUrl: "https://app.example.com",
543
+ sendMail: async (message) => {
544
+ sent.push(message);
545
+ },
546
+ });
547
+ await hooks?.sendResetPassword({
548
+ token: "t",
549
+ url: "ignored",
550
+ user: {email: "reset@example.com"},
551
+ });
552
+ assert.lengthOf(sent, 1);
553
+ assert.equal(sent[0].subject, "Reset for https://app.example.com ");
554
+ assert.isUndefined(sent[0].html);
555
+ assert.equal(sent[0].text, "");
556
+ });
557
+
558
+ it("returns undefined when sendMail is not configured", () => {
559
+ assert.isUndefined(createBetterAuthEmailHooks({enabled: true}));
560
+ });
561
+ });
562
+
563
+ describe("createBetterAuth email and password-reset wiring", () => {
564
+ const baseConfig: BetterAuthConfig = {
565
+ baseURL: "http://localhost:3000",
566
+ enabled: true,
567
+ secret: "test-secret-at-least-32-characters-long",
568
+ };
569
+
570
+ it("enables email verification when mail hooks are configured", async () => {
571
+ await setup;
572
+ const auth = createBetterAuth({
573
+ config: {
574
+ ...baseConfig,
575
+ publicAppUrl: "https://app.example.com",
576
+ sendMail: async () => {},
577
+ },
578
+ mongoClient: getClient(),
579
+ });
580
+ const options = (
581
+ auth as {
582
+ options?: {
583
+ emailAndPassword?: {sendResetPassword?: unknown};
584
+ emailVerification?: {sendOnSignUp?: boolean; sendVerificationEmail?: unknown};
585
+ };
586
+ }
587
+ ).options;
588
+ assert.isTrue(options?.emailVerification?.sendOnSignUp);
589
+ assert.isFunction(options?.emailVerification?.sendVerificationEmail);
590
+ assert.isFunction(options?.emailAndPassword?.sendResetPassword);
591
+ });
592
+
593
+ it("syncs the JWT password through the onPasswordReset hook", async () => {
594
+ await setup;
595
+ const auth = createBetterAuth({
596
+ config: baseConfig,
597
+ mongoClient: getClient(),
598
+ userModel: DualAuthUser,
599
+ });
600
+ const registerable = DualAuthUser as unknown as {
601
+ register: (user: {betterAuthId: string; email: string}, password: string) => Promise<unknown>;
602
+ };
603
+ await registerable.register(
604
+ {betterAuthId: "ba-hook-1", email: "hook@example.com"},
605
+ "old-password-123"
606
+ );
607
+ const options = (
608
+ auth as {
609
+ options?: {
610
+ emailAndPassword?: {
611
+ onPasswordReset?: (
612
+ data: {user: {email?: string; id?: string}},
613
+ request?: Request
614
+ ) => Promise<void>;
615
+ };
616
+ };
617
+ }
618
+ ).options;
619
+ const request = new globalThis.Request("http://localhost/api/auth/reset-password", {
620
+ body: JSON.stringify({newPassword: "hooked-password-123"}),
621
+ headers: {"Content-Type": "application/json"},
622
+ method: "POST",
623
+ });
624
+ await options?.emailAndPassword?.onPasswordReset?.(
625
+ {user: {email: "hook@example.com", id: "ba-hook-1"}},
626
+ request as unknown as Request
627
+ );
628
+ const reloaded = await DualAuthUser.findOne({email: "hook@example.com"});
629
+ assert.equal(reloaded?.tokenEpoch, 1);
630
+ });
631
+ });
632
+
633
+ describe("applyJwtPasswordResetToBetterAuth lookups", () => {
634
+ const makeAuth = (): BetterAuthInstance =>
635
+ createBetterAuth({
636
+ config: {
637
+ baseURL: "http://localhost:3000",
638
+ enabled: true,
639
+ secret: "test-secret-at-least-32-characters-long",
640
+ },
641
+ mongoClient: getClient(),
642
+ });
643
+
644
+ it("finds the Better Auth user by email when betterAuthId is missing", async () => {
645
+ await setup;
646
+ const auth = makeAuth();
647
+ await auth.api.signUpEmail({
648
+ body: {email: "by-email@example.com", name: "By Email", password: "old-password-123"},
649
+ });
650
+ await applyJwtPasswordResetToBetterAuth(
651
+ auth,
652
+ {email: "by-email@example.com"},
653
+ "new-password-123"
654
+ );
655
+ const signedIn = await auth.api.signInEmail({
656
+ body: {email: "by-email@example.com", password: "new-password-123"},
657
+ });
658
+ assert.isDefined(signedIn.user);
659
+ });
660
+
661
+ it("falls back to findUserById and no-ops when the user does not exist", async () => {
662
+ await setup;
663
+ const auth = makeAuth();
664
+ const ctx = (await auth.$context) as {
665
+ internalAdapter: {
666
+ findUserByEmail: (email: string) => Promise<unknown>;
667
+ findUserById: (id: string) => Promise<unknown>;
668
+ };
669
+ };
670
+ const emailCalls: string[] = [];
671
+ const idCalls: string[] = [];
672
+ ctx.internalAdapter.findUserByEmail = async (email: string): Promise<null> => {
673
+ emailCalls.push(email);
674
+ return null;
675
+ };
676
+ ctx.internalAdapter.findUserById = async (id: string): Promise<null> => {
677
+ idCalls.push(id);
678
+ return null;
679
+ };
680
+ await applyJwtPasswordResetToBetterAuth(
681
+ auth,
682
+ {betterAuthId: "", email: "ghost@example.com"},
683
+ "new-password-123"
684
+ );
685
+ assert.deepEqual(emailCalls, ["ghost@example.com"]);
686
+ assert.deepEqual(idCalls, []);
687
+ });
688
+
689
+ it("creates a credential account when the user only has a social account", async () => {
690
+ await setup;
691
+ const auth = makeAuth();
692
+ const ctx = (await auth.$context) as {
693
+ internalAdapter: {
694
+ createUser: (user: {email: string; emailVerified: boolean; name: string}) => Promise<{
695
+ id: string;
696
+ }>;
697
+ findAccounts: (userId: string) => Promise<Array<{providerId?: string}>>;
698
+ };
699
+ };
700
+ const created = await ctx.internalAdapter.createUser({
701
+ email: "social@example.com",
702
+ emailVerified: true,
703
+ name: "Social",
704
+ });
705
+ await applyJwtPasswordResetToBetterAuth(auth, {betterAuthId: created.id}, "new-password-123");
706
+ const accounts = await ctx.internalAdapter.findAccounts(created.id);
707
+ assert.isTrue(accounts.some((account) => account.providerId === "credential"));
708
+ const signedIn = await auth.api.signInEmail({
709
+ body: {email: "social@example.com", password: "new-password-123"},
710
+ });
711
+ assert.isDefined(signedIn.user);
712
+ });
180
713
  });
181
714
 
182
715
  describe("syncBetterAuthUser", () => {
@@ -194,7 +727,7 @@ describe("syncBetterAuthUser", () => {
194
727
  it("creates a new user when none exists", async () => {
195
728
  await setup;
196
729
  const baUser = makeBetterAuthUser();
197
- const result = await syncBetterAuthUser(TestUser as UserModel, baUser);
730
+ const result = await syncBetterAuthUser(TestUser, baUser);
198
731
 
199
732
  expect(result).toBeDefined();
200
733
  expect(result.email).toBe("test@example.com");
@@ -203,6 +736,28 @@ describe("syncBetterAuthUser", () => {
203
736
  expect(result.admin).toBe(false);
204
737
  });
205
738
 
739
+ it("creates a user on a strict-throw schema that omits oauthProvider", async () => {
740
+ await setup;
741
+ const baUser = makeBetterAuthUser({email: "strict@example.com"});
742
+ const result = await syncBetterAuthUser(StrictUser, baUser);
743
+
744
+ assert.equal(result.email, "strict@example.com");
745
+ assert.equal(result.betterAuthId, "ba-user-123");
746
+ const saved = await StrictUser.findOne({email: "strict@example.com"}).lean();
747
+ assert.isOk(saved);
748
+ assert.notProperty(saved, "oauthProvider");
749
+ });
750
+
751
+ it("sets oauthProvider on create when a provider is passed", async () => {
752
+ await setup;
753
+ const baUser = makeBetterAuthUser({email: "oauth-create@example.com"});
754
+ const result = await syncBetterAuthUser(TestUser, baUser, "google");
755
+
756
+ assert.equal(result.oauthProvider, "google");
757
+ const saved = await TestUser.findOne({email: "oauth-create@example.com"}).lean();
758
+ assert.equal(saved.oauthProvider, "google");
759
+ });
760
+
206
761
  it("updates an existing user matched by betterAuthId", async () => {
207
762
  await setup;
208
763
  await TestUser.create({
@@ -212,7 +767,7 @@ describe("syncBetterAuthUser", () => {
212
767
  });
213
768
 
214
769
  const baUser = makeBetterAuthUser({email: "new@example.com", name: "New Name"});
215
- const result = await syncBetterAuthUser(TestUser as UserModel, baUser);
770
+ const result = await syncBetterAuthUser(TestUser, baUser);
216
771
 
217
772
  expect(result.email).toBe("new@example.com");
218
773
  expect(result.name).toBe("New Name");
@@ -230,7 +785,7 @@ describe("syncBetterAuthUser", () => {
230
785
  });
231
786
 
232
787
  const baUser = makeBetterAuthUser();
233
- const result = await syncBetterAuthUser(TestUser as UserModel, baUser);
788
+ const result = await syncBetterAuthUser(TestUser, baUser);
234
789
 
235
790
  expect(result.betterAuthId).toBe("ba-user-123");
236
791
  expect(result.email).toBe("test@example.com");
@@ -247,7 +802,7 @@ describe("syncBetterAuthUser", () => {
247
802
  });
248
803
 
249
804
  const baUser = makeBetterAuthUser();
250
- const result = await syncBetterAuthUser(TestUser as UserModel, baUser, "google");
805
+ const result = await syncBetterAuthUser(TestUser, baUser, "google");
251
806
 
252
807
  expect(result.oauthProvider).toBe("google");
253
808
  });
@@ -255,7 +810,7 @@ describe("syncBetterAuthUser", () => {
255
810
  it("uses email prefix as name when name is null", async () => {
256
811
  await setup;
257
812
  const baUser = makeBetterAuthUser({name: null});
258
- const result = await syncBetterAuthUser(TestUser as UserModel, baUser);
813
+ const result = await syncBetterAuthUser(TestUser, baUser);
259
814
 
260
815
  expect(result.name).toBe("test");
261
816
  });
@@ -269,7 +824,7 @@ describe("syncBetterAuthUser", () => {
269
824
  });
270
825
 
271
826
  const baUser = makeBetterAuthUser({name: null});
272
- const result = await syncBetterAuthUser(TestUser as UserModel, baUser);
827
+ const result = await syncBetterAuthUser(TestUser, baUser);
273
828
 
274
829
  expect(result.name).toBe("Keep This Name");
275
830
  });
@@ -299,8 +854,8 @@ describe("createBetterAuthSessionMiddleware", () => {
299
854
 
300
855
  const auth = createBetterAuth({config, mongoClient: getClient()});
301
856
  const middleware = createBetterAuthSessionMiddleware(auth);
302
- const req = {headers: {}} as any;
303
- const res = {} as any;
857
+ const req = makeReq();
858
+ const res = makeRes();
304
859
  const next = mock(() => {});
305
860
 
306
861
  await middleware(req, res, next);
@@ -321,13 +876,13 @@ describe("createBetterAuthSessionMiddleware", () => {
321
876
 
322
877
  // Override getSession to throw
323
878
  const origGetSession = auth.api.getSession;
324
- (auth.api as any).getSession = () => {
879
+ setGetSession(auth, () => {
325
880
  throw new Error("Session error");
326
- };
881
+ });
327
882
 
328
883
  const middleware = createBetterAuthSessionMiddleware(auth);
329
- const req = {headers: {}} as any;
330
- const res = {} as any;
884
+ const req = makeReq();
885
+ const res = makeRes();
331
886
  const next = mock(() => {});
332
887
 
333
888
  await middleware(req, res, next);
@@ -335,7 +890,7 @@ describe("createBetterAuthSessionMiddleware", () => {
335
890
  expect(next).toHaveBeenCalledTimes(1);
336
891
  expect(req.user).toBeUndefined();
337
892
 
338
- (auth.api as any).getSession = origGetSession;
893
+ setGetSession(auth, origGetSession);
339
894
  });
340
895
 
341
896
  it("attaches basic user data when no userModel is provided", async () => {
@@ -358,11 +913,11 @@ describe("createBetterAuthSessionMiddleware", () => {
358
913
  };
359
914
 
360
915
  // Override getSession to return mock session
361
- (auth.api as any).getSession = async () => mockSession;
916
+ setGetSession(auth, async () => mockSession);
362
917
 
363
918
  const middleware = createBetterAuthSessionMiddleware(auth);
364
- const req = {headers: {}} as any;
365
- const res = {} as any;
919
+ const req = makeReq();
920
+ const res = makeRes();
366
921
  const next = mock(() => {});
367
922
 
368
923
  await middleware(req, res, next);
@@ -401,11 +956,11 @@ describe("createBetterAuthSessionMiddleware", () => {
401
956
  },
402
957
  };
403
958
 
404
- (auth.api as any).getSession = async () => mockSession;
959
+ setGetSession(auth, async () => mockSession);
405
960
 
406
- const middleware = createBetterAuthSessionMiddleware(auth, TestUser as UserModel);
407
- const req = {headers: {}} as any;
408
- const res = {} as any;
961
+ const middleware = createBetterAuthSessionMiddleware(auth, TestUser);
962
+ const req = makeReq();
963
+ const res = makeRes();
409
964
  const next = mock(() => {});
410
965
 
411
966
  await middleware(req, res, next);
@@ -435,11 +990,11 @@ describe("createBetterAuthSessionMiddleware", () => {
435
990
  },
436
991
  };
437
992
 
438
- (auth.api as any).getSession = async () => mockSession;
993
+ setGetSession(auth, async () => mockSession);
439
994
 
440
- const middleware = createBetterAuthSessionMiddleware(auth, TestUser as UserModel);
441
- const req = {headers: {}} as any;
442
- const res = {} as any;
995
+ const middleware = createBetterAuthSessionMiddleware(auth, TestUser);
996
+ const req = makeReq();
997
+ const res = makeRes();
443
998
  const next = mock(() => {});
444
999
 
445
1000
  await middleware(req, res, next);
@@ -547,25 +1102,27 @@ describe("getMongoClientFromMongoose", () => {
547
1102
 
548
1103
  describe("getBetterAuthSession", () => {
549
1104
  it("returns null when no session is set", () => {
550
- const req = {} as any;
1105
+ const req = makeReq();
551
1106
  expect(getBetterAuthSession(req)).toBeNull();
552
1107
  });
553
1108
 
554
1109
  it("returns session data when set", () => {
555
- const sessionData = {session: {id: "s1"}, user: {id: "u1"}} as any;
556
- const req = {betterAuthSession: sessionData} as any;
1110
+ const sessionData = {session: {id: "s1"}, user: {id: "u1"}} as unknown as BetterAuthSessionData;
1111
+ const req = makeReq({betterAuthSession: sessionData});
557
1112
  expect(getBetterAuthSession(req)).toBe(sessionData);
558
1113
  });
559
1114
  });
560
1115
 
561
1116
  describe("hasBetterAuthSession", () => {
562
1117
  it("returns false when no session is set", () => {
563
- const req = {} as any;
1118
+ const req = makeReq();
564
1119
  expect(hasBetterAuthSession(req)).toBe(false);
565
1120
  });
566
1121
 
567
1122
  it("returns true when session is set", () => {
568
- const req = {betterAuthSession: {session: {}, user: {}}} as any;
1123
+ const req = makeReq({
1124
+ betterAuthSession: {session: {}, user: {}} as unknown as BetterAuthSessionData,
1125
+ });
569
1126
  expect(hasBetterAuthSession(req)).toBe(true);
570
1127
  });
571
1128
  });
@@ -581,6 +1138,6 @@ describe("setupBetterAuthUserSync", () => {
581
1138
 
582
1139
  const auth = createBetterAuth({config, mongoClient: getClient()});
583
1140
 
584
- expect(() => setupBetterAuthUserSync(auth, TestUser as UserModel)).not.toThrow();
1141
+ expect(() => setupBetterAuthUserSync(auth, TestUser)).not.toThrow();
585
1142
  });
586
1143
  });