@terreno/api 57.3.0 → 57.6.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 (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -5,69 +5,22 @@
5
5
  * This module provides functions to initialize Better Auth with MongoDB,
6
6
  * create session middleware, and sync users with the application User model.
7
7
  */
8
- var __assign = (this && this.__assign) || function () {
9
- __assign = Object.assign || function(t) {
10
- for (var s, i = 1, n = arguments.length; i < n; i++) {
11
- s = arguments[i];
12
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
13
- t[p] = s[p];
14
- }
15
- return t;
16
- };
17
- return __assign.apply(this, arguments);
18
- };
19
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
20
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
21
- return new (P || (P = Promise))(function (resolve, reject) {
22
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
23
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
24
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
25
- step((generator = generator.apply(thisArg, _arguments || [])).next());
26
- });
27
- };
28
- var __generator = (this && this.__generator) || function (thisArg, body) {
29
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
30
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
31
- function verb(n) { return function (v) { return step([n, v]); }; }
32
- function step(op) {
33
- if (f) throw new TypeError("Generator is already executing.");
34
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
35
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
36
- if (y = 0, t) op = [op[0] & 2, t.value];
37
- switch (op[0]) {
38
- case 0: case 1: t = op; break;
39
- case 4: _.label++; return { value: op[1], done: false };
40
- case 5: _.label++; y = op[1]; op = [0]; continue;
41
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
42
- default:
43
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
44
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
45
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
46
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
47
- if (t[2]) _.ops.pop();
48
- _.trys.pop(); continue;
49
- }
50
- op = body.call(thisArg, _);
51
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
52
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
53
- }
54
- };
55
8
  var __importDefault = (this && this.__importDefault) || function (mod) {
56
9
  return (mod && mod.__esModule) ? mod : { "default": mod };
57
10
  };
58
11
  Object.defineProperty(exports, "__esModule", { value: true });
59
12
  exports.hasBetterAuthSession = exports.getBetterAuthSession = exports.setupBetterAuthUserSync = exports.getMongoClientFromMongoose = exports.mountBetterAuthRoutes = exports.syncBetterAuthUser = exports.createBetterAuthSessionMiddleware = exports.applyBetterAuthPasswordResetToJwt = exports.readPasswordFromBetterAuthResetRequest = exports.applyJwtPasswordResetToBetterAuth = exports.createBetterAuth = exports.createBetterAuthEmailHooks = void 0;
60
- var better_auth_1 = require("better-auth");
61
- var mongodb_1 = require("better-auth/adapters/mongodb");
62
- var node_1 = require("better-auth/node");
63
- var plugins_1 = require("better-auth/plugins");
64
- var mongoose_1 = __importDefault(require("mongoose"));
65
- var auth_1 = require("./auth");
66
- var errors_1 = require("./errors");
67
- var logger_1 = require("./logger");
68
- var plugins_2 = require("./plugins");
69
- var requestContext_1 = require("./requestContext");
70
- var FALLBACK_AUTH_MAIL = {
13
+ const better_auth_1 = require("better-auth");
14
+ const mongodb_1 = require("better-auth/adapters/mongodb");
15
+ const node_1 = require("better-auth/node");
16
+ const plugins_1 = require("better-auth/plugins");
17
+ const mongoose_1 = __importDefault(require("mongoose"));
18
+ const auth_1 = require("./auth");
19
+ const errors_1 = require("./errors");
20
+ const logger_1 = require("./logger");
21
+ const plugins_2 = require("./plugins");
22
+ const requestContext_1 = require("./requestContext");
23
+ const FALLBACK_AUTH_MAIL = {
71
24
  resetPassword: {
72
25
  html: '<p><a href="{{resetUrl}}">Reset your password</a></p>',
73
26
  subject: "Reset your password",
@@ -79,112 +32,80 @@ var FALLBACK_AUTH_MAIL = {
79
32
  text: "Verify your email using this link: {{verifyUrl}}",
80
33
  },
81
34
  };
82
- var interpolateMail = function (value, data) {
83
- return value.replace(/{{\s*([A-Za-z0-9_]+)\s*}}/g, function (_match, key) {
84
- var _a;
85
- return (_a = data[key]) !== null && _a !== void 0 ? _a : "";
86
- });
87
- };
88
- var fallbackRenderAuthMail = function (_a) {
89
- var _b;
90
- var publicAppUrl = _a.publicAppUrl, templateId = _a.templateId, token = _a.token, templates = _a.templates;
91
- var template = (_b = templates === null || templates === void 0 ? void 0 : templates[templateId]) !== null && _b !== void 0 ? _b : FALLBACK_AUTH_MAIL[templateId];
92
- var base = publicAppUrl.replace(/\/$/, "");
93
- var resetUrl = "".concat(base, "/resetPassword?token=").concat(encodeURIComponent(token));
94
- var verifyUrl = "".concat(base, "/verifyEmail?token=").concat(encodeURIComponent(token));
95
- var data = { publicAppUrl: base, resetUrl: resetUrl, token: token, verifyUrl: verifyUrl };
35
+ const interpolateMail = (value, data) => value.replace(/{{\s*([A-Za-z0-9_]+)\s*}}/g, (_match, key) => {
36
+ return data[key] ?? "";
37
+ });
38
+ const fallbackRenderAuthMail = ({ publicAppUrl, templateId, token, templates, }) => {
39
+ const template = templates?.[templateId] ?? FALLBACK_AUTH_MAIL[templateId];
40
+ const base = publicAppUrl.replace(/\/$/, "");
41
+ const resetUrl = `${base}/resetPassword?token=${encodeURIComponent(token)}`;
42
+ const verifyUrl = `${base}/verifyEmail?token=${encodeURIComponent(token)}`;
43
+ const data = { publicAppUrl: base, resetUrl, token, verifyUrl };
96
44
  return {
97
45
  html: template.html === undefined ? undefined : interpolateMail(template.html, data),
98
46
  subject: interpolateMail(template.subject, data),
99
47
  text: template.text === undefined ? undefined : interpolateMail(template.text, data),
100
48
  };
101
49
  };
102
- var createBetterAuthEmailHooks = function (config) {
50
+ const createBetterAuthEmailHooks = (config) => {
103
51
  if (!config.sendMail) {
104
52
  return undefined;
105
53
  }
106
- var sendMail = config.sendMail;
107
- var deliver = function (templateId, user, token) { return __awaiter(void 0, void 0, void 0, function () {
108
- var publicAppUrl, rendered, message;
109
- var _a, _b, _c;
110
- return __generator(this, function (_d) {
111
- switch (_d.label) {
112
- case 0:
113
- publicAppUrl = (_a = config.publicAppUrl) !== null && _a !== void 0 ? _a : "";
114
- if (!publicAppUrl) {
115
- logger_1.logger.error("[auth] publicAppUrl is required to send Better Auth recovery mail");
116
- throw new errors_1.APIError({
117
- status: 501,
118
- title: "publicAppUrl is required to send recovery mail",
119
- });
120
- }
121
- rendered = ((_b = config.renderAuthMail) !== null && _b !== void 0 ? _b : fallbackRenderAuthMail)({
122
- publicAppUrl: publicAppUrl,
123
- templateId: templateId,
124
- templates: config.authMailTemplates,
125
- token: token,
126
- });
127
- message = {
128
- html: rendered.html,
129
- subject: rendered.subject,
130
- text: (_c = rendered.text) !== null && _c !== void 0 ? _c : "",
131
- to: user.email,
132
- };
133
- return [4 /*yield*/, sendMail(message)];
134
- case 1:
135
- _d.sent();
136
- return [2 /*return*/];
137
- }
54
+ const sendMail = config.sendMail;
55
+ const deliver = async (templateId, user, token) => {
56
+ const publicAppUrl = config.publicAppUrl ?? "";
57
+ if (!publicAppUrl) {
58
+ logger_1.logger.error("[auth] publicAppUrl is required to send Better Auth recovery mail");
59
+ throw new errors_1.APIError({
60
+ status: 501,
61
+ title: "publicAppUrl is required to send recovery mail",
62
+ });
63
+ }
64
+ const rendered = (config.renderAuthMail ?? fallbackRenderAuthMail)({
65
+ publicAppUrl,
66
+ templateId,
67
+ templates: config.authMailTemplates,
68
+ token,
138
69
  });
139
- }); };
70
+ const message = {
71
+ html: rendered.html,
72
+ subject: rendered.subject,
73
+ text: rendered.text ?? "",
74
+ to: user.email,
75
+ };
76
+ await sendMail(message);
77
+ };
140
78
  return {
141
- sendResetPassword: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
142
- var token = _b.token, user = _b.user;
143
- return __generator(this, function (_c) {
144
- switch (_c.label) {
145
- case 0: return [4 /*yield*/, deliver("resetPassword", user, token)];
146
- case 1:
147
- _c.sent();
148
- return [2 /*return*/];
149
- }
150
- });
151
- }); },
152
- sendVerificationEmail: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
153
- var token = _b.token, user = _b.user;
154
- return __generator(this, function (_c) {
155
- switch (_c.label) {
156
- case 0: return [4 /*yield*/, deliver("verifyEmail", user, token)];
157
- case 1:
158
- _c.sent();
159
- return [2 /*return*/];
160
- }
161
- });
162
- }); },
79
+ sendResetPassword: async ({ token, user, }) => {
80
+ await deliver("resetPassword", user, token);
81
+ },
82
+ sendVerificationEmail: async ({ token, user, }) => {
83
+ await deliver("verifyEmail", user, token);
84
+ },
163
85
  };
164
86
  };
165
87
  exports.createBetterAuthEmailHooks = createBetterAuthEmailHooks;
166
88
  /**
167
89
  * Creates a Better Auth instance with MongoDB adapter.
168
90
  */
169
- var createBetterAuth = function (options) {
170
- var _a, _b;
171
- var config = options.config, mongoClient = options.mongoClient;
172
- var secret = config.secret || process.env.BETTER_AUTH_SECRET;
91
+ const createBetterAuth = (options) => {
92
+ const { config, mongoClient } = options;
93
+ const secret = config.secret || process.env.BETTER_AUTH_SECRET;
173
94
  if (!secret) {
174
95
  throw new errors_1.APIError({
175
96
  status: 500,
176
97
  title: "BETTER_AUTH_SECRET must be set in env or config.secret must be provided.",
177
98
  });
178
99
  }
179
- var baseURL = config.baseURL || process.env.BETTER_AUTH_URL;
100
+ const baseURL = config.baseURL || process.env.BETTER_AUTH_URL;
180
101
  if (!baseURL) {
181
102
  throw new errors_1.APIError({
182
103
  status: 500,
183
104
  title: "BETTER_AUTH_URL must be set in env or config.baseURL must be provided.",
184
105
  });
185
106
  }
186
- var basePath = (_a = config.basePath) !== null && _a !== void 0 ? _a : "/api/auth";
187
- var socialProviders = {};
107
+ const basePath = config.basePath ?? "/api/auth";
108
+ const socialProviders = {};
188
109
  if (config.googleOAuth) {
189
110
  socialProviders.google = {
190
111
  clientId: config.googleOAuth.clientId,
@@ -203,9 +124,10 @@ var createBetterAuth = function (options) {
203
124
  clientSecret: config.githubOAuth.clientSecret,
204
125
  };
205
126
  }
206
- var emailHooks = (0, exports.createBetterAuthEmailHooks)(config);
207
- var userModel = options.userModel;
208
- var auth = (0, better_auth_1.betterAuth)(__assign(__assign({ advanced: config.crossDomainCookies
127
+ const emailHooks = (0, exports.createBetterAuthEmailHooks)(config);
128
+ const userModel = options.userModel;
129
+ const auth = (0, better_auth_1.betterAuth)({
130
+ advanced: config.crossDomainCookies
209
131
  ? {
210
132
  defaultCookieAttributes: {
211
133
  httpOnly: true,
@@ -213,39 +135,47 @@ var createBetterAuth = function (options) {
213
135
  secure: true,
214
136
  },
215
137
  }
216
- : undefined, basePath: basePath, baseURL: baseURL, database: (0, mongodb_1.mongodbAdapter)(mongoClient.db()), emailAndPassword: __assign(__assign({ enabled: true, revokeSessionsOnPasswordReset: true }, (emailHooks ? { sendResetPassword: emailHooks.sendResetPassword } : {})), (userModel
138
+ : undefined,
139
+ basePath,
140
+ baseURL,
141
+ database: (0, mongodb_1.mongodbAdapter)(mongoClient.db()),
142
+ emailAndPassword: {
143
+ enabled: true,
144
+ revokeSessionsOnPasswordReset: true,
145
+ ...(emailHooks ? { sendResetPassword: emailHooks.sendResetPassword } : {}),
146
+ ...(userModel
147
+ ? {
148
+ onPasswordReset: async ({ user }, request) => {
149
+ await (0, exports.applyBetterAuthPasswordResetToJwt)(userModel, user, request);
150
+ },
151
+ }
152
+ : {}),
153
+ },
154
+ ...(emailHooks
217
155
  ? {
218
- onPasswordReset: function (_a, request_1) { return __awaiter(void 0, [_a, request_1], void 0, function (_b, request) {
219
- var user = _b.user;
220
- return __generator(this, function (_c) {
221
- switch (_c.label) {
222
- case 0: return [4 /*yield*/, (0, exports.applyBetterAuthPasswordResetToJwt)(userModel, user, request)];
223
- case 1:
224
- _c.sent();
225
- return [2 /*return*/];
226
- }
227
- });
228
- }); },
156
+ emailVerification: {
157
+ sendOnSignUp: true,
158
+ sendVerificationEmail: emailHooks.sendVerificationEmail,
159
+ },
229
160
  }
230
- : {})) }, (emailHooks
231
- ? {
232
- emailVerification: {
233
- sendOnSignUp: true,
234
- sendVerificationEmail: emailHooks.sendVerificationEmail,
235
- },
236
- }
237
- : {})), {
161
+ : {}),
238
162
  // The bearer plugin lets clients authenticate with `Authorization: Bearer <sessionToken>`
239
163
  // instead of the signed session cookie. Required for cross-origin/native clients and for
240
164
  // websocket handshakes (RealtimeApp's Better Auth socket validator forwards the handshake
241
165
  // token as a bearer header) — without it, a raw session token cannot be validated and
242
166
  // socket auth silently fails (the sync client shows perpetually "offline").
243
- plugins: [(0, plugins_1.bearer)()], secret: secret, session: {
167
+ plugins: [(0, plugins_1.bearer)()],
168
+ rateLimit: config.disableRateLimit ? { enabled: false } : undefined,
169
+ secret,
170
+ session: {
244
171
  cookieCache: {
245
172
  enabled: true,
246
173
  maxAge: 5 * 60, // 5 minutes
247
174
  },
248
- }, socialProviders: Object.keys(socialProviders).length > 0 ? socialProviders : undefined, trustedOrigins: (_b = config.trustedOrigins) !== null && _b !== void 0 ? _b : [] }));
175
+ },
176
+ socialProviders: Object.keys(socialProviders).length > 0 ? socialProviders : undefined,
177
+ trustedOrigins: config.trustedOrigins ?? [],
178
+ });
249
179
  // Cast through unknown: enabling the bearer plugin narrows betterAuth()'s inferred
250
180
  // return type to a plugin-specific tuple that no longer matches the plugin-agnostic
251
181
  // BetterAuthInstance alias, though the runtime instance is a valid better-auth instance.
@@ -257,202 +187,129 @@ exports.createBetterAuth = createBetterAuth;
257
187
  * (when that user exists) and delete Better Auth sessions so a dual-enrolled
258
188
  * account cannot keep the old password or stolen sessions.
259
189
  */
260
- var applyJwtPasswordResetToBetterAuth = function (auth, user, password) { return __awaiter(void 0, void 0, void 0, function () {
261
- var ctx, betterAuthUserId, found, byId, _a, hashedPassword, accounts, hasCredential;
262
- var _b, _c, _d;
263
- return __generator(this, function (_e) {
264
- switch (_e.label) {
265
- case 0: return [4 /*yield*/, auth.$context];
266
- case 1:
267
- ctx = (_e.sent());
268
- betterAuthUserId = typeof user.betterAuthId === "string" ? user.betterAuthId : "";
269
- if (!(!betterAuthUserId && typeof user.email === "string" && user.email.length > 0)) return [3 /*break*/, 3];
270
- return [4 /*yield*/, ctx.internalAdapter.findUserByEmail(user.email)];
271
- case 2:
272
- found = _e.sent();
273
- betterAuthUserId = (_c = (_b = found === null || found === void 0 ? void 0 : found.user) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : "";
274
- _e.label = 3;
275
- case 3:
276
- if (!!betterAuthUserId) return [3 /*break*/, 7];
277
- if (!user.betterAuthId) return [3 /*break*/, 5];
278
- return [4 /*yield*/, ctx.internalAdapter.findUserById(user.betterAuthId)];
279
- case 4:
280
- _a = _e.sent();
281
- return [3 /*break*/, 6];
282
- case 5:
283
- _a = null;
284
- _e.label = 6;
285
- case 6:
286
- byId = _a;
287
- betterAuthUserId = (_d = byId === null || byId === void 0 ? void 0 : byId.id) !== null && _d !== void 0 ? _d : "";
288
- _e.label = 7;
289
- case 7:
290
- if (!betterAuthUserId) {
291
- return [2 /*return*/];
292
- }
293
- return [4 /*yield*/, ctx.password.hash(password)];
294
- case 8:
295
- hashedPassword = _e.sent();
296
- return [4 /*yield*/, ctx.internalAdapter.findAccounts(betterAuthUserId)];
297
- case 9:
298
- accounts = _e.sent();
299
- hasCredential = accounts.some(function (account) { return account.providerId === "credential"; });
300
- if (!hasCredential) return [3 /*break*/, 11];
301
- return [4 /*yield*/, ctx.internalAdapter.updatePassword(betterAuthUserId, hashedPassword)];
302
- case 10:
303
- _e.sent();
304
- return [3 /*break*/, 13];
305
- case 11: return [4 /*yield*/, ctx.internalAdapter.createAccount({
306
- accountId: betterAuthUserId,
307
- password: hashedPassword,
308
- providerId: "credential",
309
- userId: betterAuthUserId,
310
- })];
311
- case 12:
312
- _e.sent();
313
- _e.label = 13;
314
- case 13: return [4 /*yield*/, ctx.internalAdapter.deleteUserSessions(betterAuthUserId)];
315
- case 14:
316
- _e.sent();
317
- return [2 /*return*/];
318
- }
319
- });
320
- }); };
190
+ const applyJwtPasswordResetToBetterAuth = async (auth, user, password) => {
191
+ const ctx = (await auth.$context);
192
+ let betterAuthUserId = typeof user.betterAuthId === "string" ? user.betterAuthId : "";
193
+ if (!betterAuthUserId && typeof user.email === "string" && user.email.length > 0) {
194
+ const found = await ctx.internalAdapter.findUserByEmail(user.email);
195
+ betterAuthUserId = found?.user?.id ?? "";
196
+ }
197
+ if (!betterAuthUserId) {
198
+ const byId = user.betterAuthId
199
+ ? await ctx.internalAdapter.findUserById(user.betterAuthId)
200
+ : null;
201
+ betterAuthUserId = byId?.id ?? "";
202
+ }
203
+ if (!betterAuthUserId) {
204
+ return;
205
+ }
206
+ const hashedPassword = await ctx.password.hash(password);
207
+ const accounts = await ctx.internalAdapter.findAccounts(betterAuthUserId);
208
+ const hasCredential = accounts.some((account) => account.providerId === "credential");
209
+ if (hasCredential) {
210
+ await ctx.internalAdapter.updatePassword(betterAuthUserId, hashedPassword);
211
+ }
212
+ else {
213
+ await ctx.internalAdapter.createAccount({
214
+ accountId: betterAuthUserId,
215
+ password: hashedPassword,
216
+ providerId: "credential",
217
+ userId: betterAuthUserId,
218
+ });
219
+ }
220
+ await ctx.internalAdapter.deleteUserSessions(betterAuthUserId);
221
+ };
321
222
  exports.applyJwtPasswordResetToBetterAuth = applyJwtPasswordResetToBetterAuth;
322
- var passwordFromUnknown = function (value) {
323
- var _a;
223
+ const passwordFromUnknown = (value) => {
324
224
  if (!value || typeof value !== "object") {
325
225
  return "";
326
226
  }
327
- var record = value;
328
- var candidate = (_a = record.newPassword) !== null && _a !== void 0 ? _a : record.password;
227
+ const record = value;
228
+ const candidate = record.newPassword ?? record.password;
329
229
  if (typeof candidate !== "string") {
330
230
  return "";
331
231
  }
332
232
  return candidate;
333
233
  };
334
- var readPasswordFromBetterAuthResetRequest = function (request) { return __awaiter(void 0, void 0, void 0, function () {
335
- var attached, _a, _b;
336
- return __generator(this, function (_c) {
337
- switch (_c.label) {
338
- case 0:
339
- if (!request) {
340
- return [2 /*return*/, ""];
341
- }
342
- attached = passwordFromUnknown(request.body);
343
- if (attached.length > 0) {
344
- return [2 /*return*/, attached];
345
- }
346
- if (typeof request.clone !== "function") {
347
- return [2 /*return*/, ""];
348
- }
349
- _c.label = 1;
350
- case 1:
351
- _c.trys.push([1, 3, , 4]);
352
- _a = passwordFromUnknown;
353
- return [4 /*yield*/, request.clone().json()];
354
- case 2: return [2 /*return*/, _a.apply(void 0, [_c.sent()])];
355
- case 3:
356
- _b = _c.sent();
357
- return [2 /*return*/, ""];
358
- case 4: return [2 /*return*/];
359
- }
360
- });
361
- }); };
234
+ const readPasswordFromBetterAuthResetRequest = async (request) => {
235
+ if (!request) {
236
+ return "";
237
+ }
238
+ const attached = passwordFromUnknown(request.body);
239
+ if (attached.length > 0) {
240
+ return attached;
241
+ }
242
+ if (typeof request.clone !== "function") {
243
+ return "";
244
+ }
245
+ try {
246
+ return passwordFromUnknown(await request.clone().json());
247
+ }
248
+ catch {
249
+ return "";
250
+ }
251
+ };
362
252
  exports.readPasswordFromBetterAuthResetRequest = readPasswordFromBetterAuthResetRequest;
363
253
  /**
364
254
  * After Better Auth password reset, update the JWT/passport hash and bump
365
255
  * `tokenEpoch` so a dual-enrolled account cannot keep the old password or
366
256
  * outstanding refresh tokens.
367
257
  */
368
- var applyBetterAuthPasswordResetToJwt = function (userModel, betterAuthUser, request) { return __awaiter(void 0, void 0, void 0, function () {
369
- var betterAuthId, email, appUser, _a, password;
370
- var _b;
371
- return __generator(this, function (_c) {
372
- switch (_c.label) {
373
- case 0:
374
- betterAuthId = typeof betterAuthUser.id === "string" ? betterAuthUser.id : "";
375
- email = typeof betterAuthUser.email === "string" ? betterAuthUser.email : "";
376
- if (!betterAuthId) return [3 /*break*/, 2];
377
- return [4 /*yield*/, (0, plugins_2.findOneOrNoneFor)(userModel, { betterAuthId: betterAuthId })];
378
- case 1:
379
- _a = _c.sent();
380
- return [3 /*break*/, 3];
381
- case 2:
382
- _a = null;
383
- _c.label = 3;
384
- case 3:
385
- appUser = _a;
386
- if (!(!appUser && email.length > 0)) return [3 /*break*/, 5];
387
- return [4 /*yield*/, (0, plugins_2.findOneOrNoneFor)(userModel, { email: email })];
388
- case 4:
389
- appUser = _c.sent();
390
- _c.label = 5;
391
- case 5:
392
- if (!appUser) {
393
- return [2 /*return*/];
394
- }
395
- return [4 /*yield*/, (0, exports.readPasswordFromBetterAuthResetRequest)(request)];
396
- case 6:
397
- password = _c.sent();
398
- if (!password) {
399
- logger_1.logger.error("[auth] Better Auth password reset did not include a password to sync to JWT");
400
- throw new errors_1.APIError({
401
- status: 500,
402
- title: "Password reset could not sync to JWT credentials",
403
- });
404
- }
405
- return [4 /*yield*/, (0, auth_1.setPasswordForUser)(appUser, password)];
406
- case 7:
407
- _c.sent();
408
- appUser.tokenEpoch = ((_b = appUser.tokenEpoch) !== null && _b !== void 0 ? _b : 0) + 1;
409
- return [4 /*yield*/, appUser.save()];
410
- case 8:
411
- _c.sent();
412
- return [2 /*return*/];
413
- }
414
- });
415
- }); };
258
+ const applyBetterAuthPasswordResetToJwt = async (userModel, betterAuthUser, request) => {
259
+ const betterAuthId = typeof betterAuthUser.id === "string" ? betterAuthUser.id : "";
260
+ const email = typeof betterAuthUser.email === "string" ? betterAuthUser.email : "";
261
+ let appUser = betterAuthId ? await (0, plugins_2.findOneOrNoneFor)(userModel, { betterAuthId }) : null;
262
+ if (!appUser && email.length > 0) {
263
+ appUser = await (0, plugins_2.findOneOrNoneFor)(userModel, { email });
264
+ }
265
+ if (!appUser) {
266
+ return;
267
+ }
268
+ const password = await (0, exports.readPasswordFromBetterAuthResetRequest)(request);
269
+ if (!password) {
270
+ logger_1.logger.error("[auth] Better Auth password reset did not include a password to sync to JWT");
271
+ throw new errors_1.APIError({
272
+ status: 500,
273
+ title: "Password reset could not sync to JWT credentials",
274
+ });
275
+ }
276
+ await (0, auth_1.setPasswordForUser)(appUser, password);
277
+ appUser.tokenEpoch = (appUser.tokenEpoch ?? 0) + 1;
278
+ await appUser.save();
279
+ };
416
280
  exports.applyBetterAuthPasswordResetToJwt = applyBetterAuthPasswordResetToJwt;
417
281
  /**
418
282
  * Creates Express middleware that extracts the Better Auth session
419
283
  * and populates req.user with the application User model.
420
284
  */
421
- var createBetterAuthSessionMiddleware = function (auth, userModel) {
422
- return function (req, _res, next) { return __awaiter(void 0, void 0, void 0, function () {
423
- var session, betterAuthUser, reqWithSession, appUser, newUser, error_1;
424
- return __generator(this, function (_a) {
425
- switch (_a.label) {
426
- case 0:
427
- _a.trys.push([0, 8, , 9]);
428
- return [4 /*yield*/, auth.api.getSession({
429
- headers: req.headers,
430
- })];
431
- case 1:
432
- session = _a.sent();
433
- if (!((session === null || session === void 0 ? void 0 : session.user) && (session === null || session === void 0 ? void 0 : session.session))) return [3 /*break*/, 7];
434
- betterAuthUser = session.user;
435
- reqWithSession = req;
436
- if (!userModel) return [3 /*break*/, 6];
437
- return [4 /*yield*/, (0, plugins_2.findOneOrNoneFor)(userModel, {
438
- betterAuthId: betterAuthUser.id,
439
- })];
440
- case 2:
441
- appUser = _a.sent();
442
- if (!appUser) return [3 /*break*/, 3];
443
- reqWithSession.user = appUser;
444
- reqWithSession.betterAuthSession = session;
445
- (0, requestContext_1.updateRequestContextFromRequest)(req);
446
- return [3 /*break*/, 5];
447
- case 3: return [4 /*yield*/, (0, exports.syncBetterAuthUser)(userModel, betterAuthUser)];
448
- case 4:
449
- newUser = _a.sent();
450
- reqWithSession.user = newUser;
451
- reqWithSession.betterAuthSession = session;
452
- (0, requestContext_1.updateRequestContextFromRequest)(req);
453
- _a.label = 5;
454
- case 5: return [3 /*break*/, 7];
455
- case 6:
285
+ const createBetterAuthSessionMiddleware = (auth, userModel) => {
286
+ return async (req, _res, next) => {
287
+ try {
288
+ const session = await auth.api.getSession({
289
+ headers: req.headers,
290
+ });
291
+ if (session?.user && session?.session) {
292
+ const betterAuthUser = session.user;
293
+ const reqWithSession = req;
294
+ if (userModel) {
295
+ // Look up the application user by betterAuthId
296
+ const appUser = await (0, plugins_2.findOneOrNoneFor)(userModel, {
297
+ betterAuthId: betterAuthUser.id,
298
+ });
299
+ if (appUser) {
300
+ reqWithSession.user = appUser;
301
+ reqWithSession.betterAuthSession = session;
302
+ (0, requestContext_1.updateRequestContextFromRequest)(req);
303
+ }
304
+ else {
305
+ // User exists in Better Auth but not synced yet - create them
306
+ const newUser = await (0, exports.syncBetterAuthUser)(userModel, betterAuthUser);
307
+ reqWithSession.user = newUser;
308
+ reqWithSession.betterAuthSession = session;
309
+ (0, requestContext_1.updateRequestContextFromRequest)(req);
310
+ }
311
+ }
312
+ else {
456
313
  // No user model - just attach the Better Auth user directly
457
314
  reqWithSession.user = {
458
315
  _id: betterAuthUser.id,
@@ -464,94 +321,83 @@ var createBetterAuthSessionMiddleware = function (auth, userModel) {
464
321
  };
465
322
  reqWithSession.betterAuthSession = session;
466
323
  (0, requestContext_1.updateRequestContextFromRequest)(req);
467
- _a.label = 7;
468
- case 7:
469
- next();
470
- return [3 /*break*/, 9];
471
- case 8:
472
- error_1 = _a.sent();
473
- logger_1.logger.debug("Better Auth session extraction error: ".concat(error_1));
474
- next();
475
- return [3 /*break*/, 9];
476
- case 9: return [2 /*return*/];
324
+ }
477
325
  }
478
- });
479
- }); };
326
+ next();
327
+ }
328
+ catch (error) {
329
+ logger_1.logger.debug(`Better Auth session extraction error: ${error}`);
330
+ next();
331
+ }
332
+ };
480
333
  };
481
334
  exports.createBetterAuthSessionMiddleware = createBetterAuthSessionMiddleware;
482
- var syncBetterAuthUser = function (userModel, betterAuthUser, oauthProvider) { return __awaiter(void 0, void 0, void 0, function () {
483
- var existingUser, userByEmail, useAsId, UserDocumentConstructor, newUser, error_2;
484
- return __generator(this, function (_a) {
485
- switch (_a.label) {
486
- case 0:
487
- _a.trys.push([0, 8, , 9]);
488
- return [4 /*yield*/, (0, plugins_2.findOneOrNoneFor)(userModel, {
489
- betterAuthId: betterAuthUser.id,
490
- })];
491
- case 1:
492
- existingUser = (_a.sent());
493
- if (!existingUser) return [3 /*break*/, 3];
494
- // Update existing user if needed
495
- existingUser.email = betterAuthUser.email;
496
- if (betterAuthUser.name) {
497
- existingUser.name = betterAuthUser.name;
498
- }
499
- return [4 /*yield*/, existingUser.save()];
500
- case 2:
501
- _a.sent();
502
- return [2 /*return*/, existingUser];
503
- case 3: return [4 /*yield*/, (0, plugins_2.findOneOrNoneFor)(userModel, {
504
- email: betterAuthUser.email,
505
- })];
506
- case 4:
507
- userByEmail = (_a.sent());
508
- if (!userByEmail) return [3 /*break*/, 6];
509
- // Link existing user to Better Auth
510
- userByEmail.betterAuthId = betterAuthUser.id;
511
- if (oauthProvider) {
512
- userByEmail.oauthProvider = oauthProvider;
513
- }
514
- return [4 /*yield*/, userByEmail.save()];
515
- case 5:
516
- _a.sent();
517
- return [2 /*return*/, userByEmail];
518
- case 6:
519
- useAsId = mongoose_1.default.isValidObjectId(betterAuthUser.id) ? { _id: betterAuthUser.id } : {};
520
- UserDocumentConstructor = userModel;
521
- newUser = new UserDocumentConstructor(__assign(__assign(__assign({}, useAsId), { admin: false, betterAuthId: betterAuthUser.id, email: betterAuthUser.email, name: betterAuthUser.name || betterAuthUser.email.split("@")[0] }), (oauthProvider ? { oauthProvider: oauthProvider } : {})));
522
- return [4 /*yield*/, newUser.save()];
523
- case 7:
524
- _a.sent();
525
- logger_1.logger.info("Created new user from Better Auth: ".concat(newUser.id));
526
- return [2 /*return*/, newUser];
527
- case 8:
528
- error_2 = _a.sent();
529
- logger_1.logger.error("Error syncing Better Auth user: ".concat(error_2));
530
- throw error_2;
531
- case 9: return [2 /*return*/];
335
+ const syncBetterAuthUser = async (userModel, betterAuthUser, oauthProvider) => {
336
+ try {
337
+ const existingUser = (await (0, plugins_2.findOneOrNoneFor)(userModel, {
338
+ betterAuthId: betterAuthUser.id,
339
+ }));
340
+ if (existingUser) {
341
+ // Update existing user if needed
342
+ existingUser.email = betterAuthUser.email;
343
+ if (betterAuthUser.name) {
344
+ existingUser.name = betterAuthUser.name;
345
+ }
346
+ await existingUser.save();
347
+ return existingUser;
532
348
  }
533
- });
534
- }); };
349
+ // Check if user exists by email (migration case)
350
+ const userByEmail = (await (0, plugins_2.findOneOrNoneFor)(userModel, {
351
+ email: betterAuthUser.email,
352
+ }));
353
+ if (userByEmail) {
354
+ // Link existing user to Better Auth
355
+ userByEmail.betterAuthId = betterAuthUser.id;
356
+ if (oauthProvider) {
357
+ userByEmail.oauthProvider = oauthProvider;
358
+ }
359
+ await userByEmail.save();
360
+ return userByEmail;
361
+ }
362
+ // Use Better Auth ID as _id when it's a valid ObjectId (MongoDB adapter) so frontend IDs match
363
+ const useAsId = mongoose_1.default.isValidObjectId(betterAuthUser.id) ? { _id: betterAuthUser.id } : {};
364
+ const UserDocumentConstructor = userModel;
365
+ const newUser = new UserDocumentConstructor({
366
+ ...useAsId,
367
+ admin: false,
368
+ betterAuthId: betterAuthUser.id,
369
+ email: betterAuthUser.email,
370
+ name: betterAuthUser.name || betterAuthUser.email.split("@")[0],
371
+ ...(oauthProvider ? { oauthProvider } : {}),
372
+ });
373
+ await newUser.save();
374
+ logger_1.logger.info(`Created new user from Better Auth: ${newUser.id}`);
375
+ return newUser;
376
+ }
377
+ catch (error) {
378
+ logger_1.logger.error(`Error syncing Better Auth user: ${error}`);
379
+ throw error;
380
+ }
381
+ };
535
382
  exports.syncBetterAuthUser = syncBetterAuthUser;
536
383
  /**
537
384
  * Mounts Better Auth routes on the Express app.
538
385
  */
539
- var mountBetterAuthRoutes = function (app, auth, basePath) {
540
- if (basePath === void 0) { basePath = "/api/auth"; }
541
- var handler = (0, node_1.toNodeHandler)(auth);
386
+ const mountBetterAuthRoutes = (app, auth, basePath = "/api/auth") => {
387
+ const handler = (0, node_1.toNodeHandler)(auth);
542
388
  // Mount at the base path with wildcard
543
- app.all("".concat(basePath, "/*path"), function (req, res) {
389
+ app.all(`${basePath}/*path`, (req, res) => {
544
390
  return handler(req, res);
545
391
  });
546
- logger_1.logger.info("Better Auth routes mounted at ".concat(basePath, "/*"));
392
+ logger_1.logger.info(`Better Auth routes mounted at ${basePath}/*`);
547
393
  };
548
394
  exports.mountBetterAuthRoutes = mountBetterAuthRoutes;
549
395
  /**
550
396
  * Gets the MongoDB client from the mongoose connection.
551
397
  */
552
- var getMongoClientFromMongoose = function () {
553
- var connection = mongoose_1.default.connection;
554
- var client = connection.client;
398
+ const getMongoClientFromMongoose = () => {
399
+ const connection = mongoose_1.default.connection;
400
+ const client = connection.client;
555
401
  if (!client) {
556
402
  throw new errors_1.APIError({
557
403
  status: 500,
@@ -568,7 +414,7 @@ exports.getMongoClientFromMongoose = getMongoClientFromMongoose;
568
414
  * Note: Better Auth doesn't have built-in event hooks, so we rely on the session middleware
569
415
  * to create users on first session access.
570
416
  */
571
- var setupBetterAuthUserSync = function (_auth, _userModel) {
417
+ const setupBetterAuthUserSync = (_auth, _userModel) => {
572
418
  // Better Auth v1.x doesn't expose event hooks for user creation.
573
419
  // User sync is handled in createBetterAuthSessionMiddleware when a session is accessed.
574
420
  // This function is a placeholder for future versions that may support hooks.
@@ -578,15 +424,14 @@ exports.setupBetterAuthUserSync = setupBetterAuthUserSync;
578
424
  /**
579
425
  * Extracts Better Auth session data from the request.
580
426
  */
581
- var getBetterAuthSession = function (req) {
582
- var _a;
583
- return (_a = req.betterAuthSession) !== null && _a !== void 0 ? _a : null;
427
+ const getBetterAuthSession = (req) => {
428
+ return req.betterAuthSession ?? null;
584
429
  };
585
430
  exports.getBetterAuthSession = getBetterAuthSession;
586
431
  /**
587
432
  * Checks if the request has a valid Better Auth session.
588
433
  */
589
- var hasBetterAuthSession = function (req) {
434
+ const hasBetterAuthSession = (req) => {
590
435
  return Boolean(req.betterAuthSession);
591
436
  };
592
437
  exports.hasBetterAuthSession = hasBetterAuthSession;