用途:在 TypeScript 项目中把 Better Auth 认证处理器接入 Web 框架,将处理器挂载到 /api/auth/*(或自定义基础路径),并确保 SSR 与服务端操作中的 Cookie 与 Header 正确流转。
主要能力:提供框架辅助函数或 auth.handler 返回 Response;覆盖 Next.js App Router、Next.js Pages Router、SvelteKit、Remix、Express、Hono 等框架的接入方式;说明 Next.js 服务端操作中的 Cookie 处理。
使用方式:先创建 auth 实例(参见 better-auth-core);为 /api/auth/* 添加 catch-all 路由;使用框架辅助函数或 auth.handler 返回 Response。例如 App Router 用 toNextJsHandler(auth) 导出 GET、POST;Pages Router 用 toNodeHandler 并禁用 bodyParser;服务端操作可引入 nextCookies 插件。
限制与注意事项:服务端与客户端的基础路径需保持一致;有框架辅助函数时优先使用;不要在认证处理器之前运行自定义 body parser。详细参考见 references/nextjs.md 与 references/frameworks.md。