From 4587a427695468890e99b70cd583df5ea29937ba Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 24 Jan 2026 21:39:14 +0000
Subject: [PATCH] feat(utils): move generateEmail to user-accessible utils

- Moved generateEmail from test-utils to utils folder
- Added './utils' export to package.json for public access
- Users can now import from 'better-auth/utils'
- Test-utils re-exports from the new location for backwards compat

This allows users to use generateEmail when they need to generate
temporary emails (e.g., similar to anonymous plugin's needs).

Co-authored-by: taesu <taesu@better-auth.com>
---
 packages/better-auth/package.json                       | 5 +++++
 packages/better-auth/src/test-utils/index.ts            | 2 +-
 packages/better-auth/src/test-utils/test-instance.ts    | 2 +-
 packages/better-auth/src/{test-utils => utils}/email.ts | 0
 packages/better-auth/src/utils/index.ts                 | 1 +
 5 files changed, 8 insertions(+), 2 deletions(-)
 rename packages/better-auth/src/{test-utils => utils}/email.ts (100%)

diff --git a/packages/better-auth/package.json b/packages/better-auth/package.json
index 4a37b02a41..bc74607de0 100644
--- a/packages/better-auth/package.json
+++ b/packages/better-auth/package.json
@@ -115,6 +115,11 @@
       "types": "./dist/db/index.d.mts",
       "default": "./dist/db/index.mjs"
     },
+    "./utils": {
+      "dev-source": "./src/utils/index.ts",
+      "types": "./dist/utils/index.d.mts",
+      "default": "./dist/utils/index.mjs"
+    },
     "./vue": {
       "dev-source": "./src/client/vue/index.ts",
       "types": "./dist/client/vue/index.d.mts",
diff --git a/packages/better-auth/src/test-utils/index.ts b/packages/better-auth/src/test-utils/index.ts
index 489ca0c8b3..a8d90f50e5 100644
--- a/packages/better-auth/src/test-utils/index.ts
+++ b/packages/better-auth/src/test-utils/index.ts
@@ -1,3 +1,3 @@
-export { type GenerateEmailOptions, generateEmail } from "./email";
+export { type GenerateEmailOptions, generateEmail } from "../utils/email";
 export { convertSetCookieToCookie } from "./headers";
 export { getTestInstance } from "./test-instance";
diff --git a/packages/better-auth/src/test-utils/test-instance.ts b/packages/better-auth/src/test-utils/test-instance.ts
index 231dd173e4..182298f3b9 100644
--- a/packages/better-auth/src/test-utils/test-instance.ts
+++ b/packages/better-auth/src/test-utils/test-instance.ts
@@ -16,7 +16,7 @@ import { bearer } from "../plugins";
 import type { Session, User } from "../types";
 import { getBaseURL } from "../utils/url";
 
-export { type GenerateEmailOptions, generateEmail } from "./email";
+export { type GenerateEmailOptions, generateEmail } from "../utils/email";
 
 const cleanupSet = new Set<Function>();
 
diff --git a/packages/better-auth/src/test-utils/email.ts b/packages/better-auth/src/utils/email.ts
similarity index 100%
rename from packages/better-auth/src/test-utils/email.ts
rename to packages/better-auth/src/utils/email.ts
diff --git a/packages/better-auth/src/utils/index.ts b/packages/better-auth/src/utils/index.ts
index ac4f86af76..8692063b5f 100644
--- a/packages/better-auth/src/utils/index.ts
+++ b/packages/better-auth/src/utils/index.ts
@@ -1,4 +1,5 @@
 export * from "../oauth2/state";
 export type { StateData } from "../state";
 export { generateGenericState, parseGenericState } from "../state";
+export * from "./email";
 export * from "./hide-metadata";