better-auth-core

Better Auth Core（TypeScript）

目標

• 環境変数とデータレイヤーの接続を設定して、Better Auth インスタンスを構成します。
• サーバーハンドラーとクライアントインスタンスを接続します。
• セッションとサーバーサイド API メソッドを安全に使用します。
• データレイヤーの選択肢をプラグイン可能に保ちます（ドライバーまたはアダプター）。

クイックスタート

1. better-auth をインストールします。
2. BETTER_AUTH_SECRET（32 文字以上）と BETTER_AUTH_URL を設定します。
3. auth.ts を作成し、auth をエクスポートします。
4. database（ドライバーまたはアダプター）を指定するか、ステートレスセッションを使用する場合は省略します。
5. ハンドラー（auth.handler またはフレームワークのヘルパー）をマウントします。
6. createAuthClient でクライアントを作成します。

import { betterAuth } from "better-auth";

export const auth = betterAuth({
  database: myDatabaseOrAdapter, // driver or adapter; omit for stateless mode
  emailAndPassword: { enabled: true },
  socialProviders: {
    github: {
      clientId: process.env.GITHUB_CLIENT_ID as string,
      clientSecret: process.env.GITHUB_CLIENT_SECRET as string,
    },
  },
});

コア設定チェックリスト

• ヘルパーが見つけられるように、インスタンスを auth としてエクスポートするか、デフォルトエクスポートにします。
• BETTER_AUTH_URL を公開ベース URL と同期させます。
• /api/auth のベースパスを変更する場合は、クライアントに完全なベース URL を渡します。
• テーブルを必要とするプラグインを有効にする前に、データベースのマイグレーションを追加します。

サーバー API の使用

• { body, headers, query } を指定して、auth.api.* 経由でサーバーエンドポイントを呼び出します。
• Response オブジェクトが必要な場合は、asResponse: true を使用します。
• Set-Cookie ヘッダーにアクセスするには、returnHeaders: true を使用します。

import { auth } from "./auth";

const session = await auth.api.getSession({
  headers: request.headers,
});

const response = await auth.api.signInEmail({
  body: { email, password },
  asResponse: true,
});

セッションへのアクセス

• クライアント：authClient.useSession() または authClient.getSession()。
• サーバー：auth.api.getSession({ headers })。

TypeScript のヒント

• auth.$Infer と authClient.$Infer で型を推論します。
• ユーザースキーマを拡張する場合は、クライアントで inferAdditionalFields を使用します。

参考資料

• toolchains/platforms/auth/better-auth/better-auth-core/references/setup-database.md
• toolchains/platforms/auth/better-auth/better-auth-core/references/client-server.md
• toolchains/platforms/auth/better-auth/better-auth-core/references/typescript.md