@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/tools/components/auth/adapters/better-auth-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"better-auth-adapter.js","names":["BetterAuthAdapter","client","options","error","data","resData","session","token","sessionData","organizationApi","setActive","result","isActive","callback","user","handleAuthChange","intervalId","res","email","password","_id","_email","_name","_image","_role","rest","metadata","betterAuthUser"],"sources":["../../../../../src/tools/components/auth/adapters/better-auth-adapter.ts"],"sourcesContent":["import { AuthAdapter, User } from '../types';\n\ntype BetterAuthError = { message?: string } | null;\ntype BetterAuthUser = {\n  id: string;\n  email?: string;\n  name?: string;\n  image?: string;\n  role?: string;\n} & Record<string, unknown>;\ntype BetterAuthSession = {\n  token?: string;\n  activeOrganizationId?: string;\n  activeTeamId?: string;\n} & Record<string, unknown>;\ntype BetterAuthSessionData = {\n  user: BetterAuthUser | null;\n  session: BetterAuthSession | null;\n} | null;\ntype BetterAuthResponse<T> = { data: T | null; error: BetterAuthError };\ntype BetterAuthTokenData = { token?: string } | string;\ntype BetterAuthOrganizationActionResponse =\n  | { error?: BetterAuthError }\n  | BetterAuthResponse<unknown>;\ntype BetterAuthOrganizationNamespace = {\n  setActive?: (params: { organizationId: string }) => Promise<BetterAuthOrganizationActionResponse>;\n  setActiveOrganization?: (params: {\n    organizationId: string;\n  }) => Promise<BetterAuthOrganizationActionResponse>;\n};\n\n// Define a type that matches the minimal client interface we need.\n// This avoids strict dependency on the exact generic types of the client.\ntype MinimalAuthClient = {\n  signIn: {\n    email: (\n      params: { email: string; password: string },\n      options?: Record<string, unknown>,\n    ) => Promise<BetterAuthResponse<{ user?: BetterAuthUser | null }>>;\n  };\n  signUp: {\n    email: (\n      params: { email: string; password: string; name?: string },\n      options?: Record<string, unknown>,\n    ) => Promise<BetterAuthResponse<{ user?: BetterAuthUser | null }>>;\n  };\n  signOut: () => Promise<{ error?: BetterAuthError }>;\n  getSession: () => Promise<BetterAuthResponse<BetterAuthSessionData>>;\n  token?: () => Promise<BetterAuthResponse<BetterAuthTokenData>>;\n  forgetPassword?: (params: {\n    email: string;\n    redirectTo?: string;\n  }) => Promise<{ error?: BetterAuthError }>;\n  changePassword?: (params: {\n    newPassword: string;\n    currentPassword?: string;\n    revokeOtherSessions?: boolean;\n  }) => Promise<{ error?: BetterAuthError }>;\n  changeEmail?: (params: {\n    newEmail: string;\n  }) => Promise<{ error?: BetterAuthError }>;\n  organization?: BetterAuthOrganizationNamespace;\n};\n\nexport interface BetterAuthAdapterOptions {\n  /**\n   * onAuthStateChanged で監視するカスタムイベント名\n   * @default \"better-auth:session-changed\"\n   */\n  sessionChangeEventName?: string;\n  /**\n   * セッションポーリング間隔(ms)。0以下で無効化\n   * @default 30000\n   */\n  pollIntervalMs?: number;\n}\n\n/**\n * Better Auth 用のアダプタークラス\n *\n * Better Auth クライアントをラップし、アプリケーション共通の AuthAdapter インターフェースを提供します。\n * これにより、UIコンポーネントは認証プロバイダーの実装詳細を気にすることなく利用できます。\n * Better Auth SDKはこのパッケージの依存ではありません。利用アプリでSDKを導入し、\n * 必要なメソッドを持つクライアントを渡してください。\n *\n * @example\n * ```tsx\n * import { createAuthClient } from 'better-auth/react'; // installed by the consuming application\n * const authClient = createAuthClient();\n * import { BetterAuthAdapter, AuthProvider } from \"@alneas/appkit-react/tools/auth\";\n *\n * const adapter = new BetterAuthAdapter(authClient);\n *\n * <AuthProvider adapter={adapter}>\n *   <App />\n * </AuthProvider>\n * ```\n */\nexport class BetterAuthAdapter implements AuthAdapter {\n  private client: MinimalAuthClient;\n  private eventName: string;\n  private pollIntervalMs: number;\n  private inFlightSession: Promise<User | null> | null = null;\n\n  /**\n   * @param client Better Auth クライアントインスタンス (createAuthClient で作成されたもの)\n   */\n  constructor(client: MinimalAuthClient, options: BetterAuthAdapterOptions = {}) {\n    this.client = client;\n    this.eventName = options.sessionChangeEventName ?? 'better-auth:session-changed';\n    this.pollIntervalMs = options.pollIntervalMs ?? 30000;\n  }\n\n  /**\n   * メールアドレスとパスワードでログインします。\n   *\n   * @param email ユーザーのメールアドレス\n   * @param password パスワード\n   * @returns ログインしたユーザー情報\n   * @throws ログインに失敗した場合にエラーを投げます\n   */\n  async login(email: string, password: string): Promise<User> {\n    const { data, error } = await this.client.signIn.email({\n      email,\n      password,\n    });\n\n    if (error) {\n      throw new Error(error.message || 'Login failed');\n    }\n\n    if (!data?.user) {\n      throw new Error('No user returned');\n    }\n    this.emitSessionChanged();\n    return this.mapUser(data.user);\n  }\n\n  /**\n   * 新規ユーザー登録を行います。\n   *\n   * @param email メールアドレス\n   * @param password パスワード\n   * @param data 追加データ (現在は name のみサポート)\n   * @returns 登録されたユーザー情報\n   * @throws 登録に失敗した場合にエラーを投げます\n   */\n  async register(email: string, password: string, data?: { name?: string }): Promise<User> {\n    const { data: resData, error } = await this.client.signUp.email({\n      email,\n      password,\n      name: data?.name || '',\n    });\n\n    if (error) {\n      throw new Error(error.message || 'Registration failed');\n    }\n\n    if (!resData?.user) {\n      throw new Error('No user returned');\n    }\n    this.emitSessionChanged();\n    return this.mapUser(resData.user);\n  }\n\n  /**\n   * ログアウトします。\n   *\n   * @returns 完了時の Promise\n   * @throws ログアウトに失敗した場合にエラーを投げます\n   */\n  async logout(): Promise<void> {\n    const { error } = await this.client.signOut();\n    if (error) {\n      throw new Error(error.message || 'Logout failed');\n    }\n    this.emitSessionChanged();\n  }\n\n  /**\n   * 現在のユーザーを取得します。\n   * Better Auth の getSession メソッドを使用してセッション情報を取得します。\n   */\n  async getCurrentUser(): Promise<User | null> {\n    if (this.inFlightSession) return this.inFlightSession;\n    this.inFlightSession = (async () => {\n      try {\n        const session = await this.getSessionData();\n        if (session?.user) {\n          return this.mapUser(session.user, session.session);\n        }\n        return null;\n      } catch {\n        return null;\n      } finally {\n        this.inFlightSession = null;\n      }\n    })();\n    return this.inFlightSession;\n  }\n\n  /**\n   * SupabaseTokenProvider 用に認証トークンを取得します。\n   *\n   * 優先順位:\n   * 1. Better Auth JWT plugin の `/token` エンドポイント\n   * 2. セッションの `session.token`\n   */\n  async getToken(): Promise<string | null> {\n    // 1) JWT plugin endpoint (/token) が利用可能なら優先\n    if (this.client.token) {\n      try {\n        const { data, error } = await this.client.token();\n        if (!error) {\n          const token = this.extractToken(data);\n          if (token) return token;\n        }\n      } catch {\n        // fallback to session token\n      }\n    }\n\n    // 2) セッションの token を使用\n    const sessionData = await this.getSessionData();\n    return this.extractSessionToken(sessionData);\n  }\n\n  /**\n   * organization plugin が有効な場合、アクティブな組織を切り替えます。\n   */\n  async setActiveOrganization(organizationId: string): Promise<void> {\n    const organizationApi = this.client.organization;\n    const setActive = organizationApi?.setActive ?? organizationApi?.setActiveOrganization;\n\n    if (!setActive) {\n      throw new Error('Organization plugin is not configured on Better Auth client.');\n    }\n\n    const result = await setActive({ organizationId });\n    const error = 'error' in result ? result.error : null;\n    if (error) {\n      throw new Error(error.message || 'Failed to set active organization');\n    }\n\n    this.emitSessionChanged();\n  }\n\n  /**\n   * 現在の organization / team コンテキストを取得します。\n   */\n  async getOrganizationContext(): Promise<{\n    activeOrganizationId: string | null;\n    activeTeamId: string | null;\n  }> {\n    const sessionData = await this.getSessionData();\n    return {\n      activeOrganizationId:\n        typeof sessionData?.session?.activeOrganizationId === 'string'\n          ? sessionData.session.activeOrganizationId\n          : null,\n      activeTeamId:\n        typeof sessionData?.session?.activeTeamId === 'string'\n          ? sessionData.session.activeTeamId\n          : null,\n    };\n  }\n\n  /**\n   * 認証状態の変更を監視します。\n   *\n   * Better Auth は内部的に nanostore (atom) を使用して状態管理を行いますが、\n   * window イベントは発火しません。このメソッドは以下の方法で状態変化を検出します：\n   *\n   * 1. 初回呼び出し時に現在のユーザーを取得\n   * 2. カスタムウィンドウイベントをリッスン (デフォルト: 'better-auth:session-changed')\n   * 3. 定期的なポーリング（フォールバック）\n   *\n   * @deprecated React コンポーネント内では useAuth() の使用を推奨します。\n   */\n  onAuthStateChanged(callback: (user: User | null) => void): () => void {\n    let isActive = true;\n\n    // 1. Initial call - get current user immediately\n    this.getCurrentUser().then((user) => {\n      if (isActive) callback(user);\n    });\n\n    if (typeof window === 'undefined') {\n      return () => {\n        isActive = false;\n      };\n    }\n\n    // 2. Listen for custom window events\n    const handleAuthChange = async () => {\n      if (!isActive) return;\n      const user = await this.getCurrentUser();\n      callback(user);\n    };\n\n    window.addEventListener(this.eventName, handleAuthChange);\n\n    // 3. Polling fallback\n    const intervalId =\n      this.pollIntervalMs > 0\n        ? setInterval(async () => {\n            if (!isActive) return;\n            const user = await this.getCurrentUser();\n            callback(user);\n          }, this.pollIntervalMs)\n        : null;\n\n    // Return cleanup function\n    return () => {\n      isActive = false;\n      window.removeEventListener(this.eventName, handleAuthChange);\n      if (intervalId) {\n        clearInterval(intervalId);\n      }\n    };\n  }\n\n  /**\n   * メールアドレスを更新します。\n   */\n  async updateEmail(email: string): Promise<void> {\n    if (!this.client.changeEmail) {\n      throw new Error('Update email is not available. Configure Better Auth changeEmail endpoint.');\n    }\n    const res = await this.client.changeEmail({ newEmail: email });\n    if (res.error) {\n      throw new Error(res.error.message || 'Failed to update email');\n    }\n  }\n\n  /**\n   * パスワードを更新します。\n   */\n  async updatePassword(password: string): Promise<void> {\n    if (!this.client.changePassword) {\n      throw new Error('Update password is not available. Configure Better Auth changePassword endpoint.');\n    }\n    const res = await this.client.changePassword({ newPassword: password });\n    if (res.error) {\n      throw new Error(res.error.message || 'Failed to update password');\n    }\n  }\n\n  /**\n   * パスワードリセットメールを送信します。\n   */\n  async resetPassword(email: string): Promise<void> {\n    if (!this.client.forgetPassword) {\n      throw new Error(\n        'Reset password is not available. Configure Better Auth email/password reset endpoint.',\n      );\n    }\n\n    const { error } = await this.client.forgetPassword({\n      email,\n      redirectTo: '/reset-password',\n    });\n\n    if (error) {\n      throw new Error(error.message || 'Failed to send reset password email');\n    }\n  }\n\n  private async getSessionData(): Promise<BetterAuthSessionData> {\n    const session = await this.client.getSession();\n    if (session?.error) {\n      return null;\n    }\n    return session?.data ?? null;\n  }\n\n  private extractSessionToken(sessionData: BetterAuthSessionData): string | null {\n    const token = sessionData?.session?.token;\n    return typeof token === 'string' && token.length > 0 ? token : null;\n  }\n\n  private extractToken(data: BetterAuthTokenData | null): string | null {\n    if (!data) return null;\n    if (typeof data === 'string') {\n      return data.length > 0 ? data : null;\n    }\n    const token = data.token;\n    return typeof token === 'string' && token.length > 0 ? token : null;\n  }\n\n  private buildMetadata(\n    user: BetterAuthUser,\n    session?: BetterAuthSession | null,\n  ): Record<string, unknown> {\n    const { id: _id, email: _email, name: _name, image: _image, role: _role, ...rest } = user;\n    const metadata: Record<string, unknown> = { ...rest };\n\n    if (session?.activeOrganizationId) {\n      metadata.activeOrganizationId = session.activeOrganizationId;\n    }\n    if (session?.activeTeamId) {\n      metadata.activeTeamId = session.activeTeamId;\n    }\n\n    return metadata;\n  }\n\n  private emitSessionChanged(): void {\n    if (typeof window === 'undefined') return;\n    window.dispatchEvent(new CustomEvent(this.eventName));\n  }\n\n  // Helper to map Better Auth user to our User type\n  private mapUser(betterAuthUser: BetterAuthUser, session?: BetterAuthSession | null): User {\n    if (!betterAuthUser) {\n      // throw error or return generic\n      throw new Error('User data missing');\n    }\n    return {\n      id: betterAuthUser.id,\n      email: betterAuthUser.email || '',\n      name: betterAuthUser.name,\n      avatarUrl: betterAuthUser.image,\n      role: betterAuthUser.role,\n      metadata: this.buildMetadata(betterAuthUser, session),\n    };\n  }\n}\n"],"mappings":";;AAkGA,IAAaA,IAAb,MAAsD;CACpD;CACA;CACA;CACA,kBAAuD;CAKvD,YAAY,GAA2B,IAAoC,CAAC,GAAG;EAG7E,AAFA,KAAK,SAASC,GACd,KAAK,YAAYC,EAAQ,0BAA0B,+BACnD,KAAK,iBAAiBA,EAAQ,kBAAkB;CAClD;CAUA,MAAM,MAAM,GAAe,GAAiC;EAC1D,IAAM,EAAE,SAAM,aAAU,MAAM,KAAK,OAAO,OAAO,MAAM;GACrD;GACA;EACF,CAAC;EAED,IAAIC,GACF,MAAU,MAAMA,EAAM,WAAW,cAAc;EAGjD,IAAI,CAACC,GAAM,MACT,MAAU,MAAM,kBAAkB;EAGpC,OADA,KAAK,mBAAmB,GACjB,KAAK,QAAQA,EAAK,IAAI;CAC/B;CAWA,MAAM,SAAS,GAAe,GAAkB,GAAyC;EACvF,IAAM,EAAE,MAAMC,GAAS,aAAU,MAAM,KAAK,OAAO,OAAO,MAAM;GAC9D;GACA;GACA,MAAMD,GAAM,QAAQ;EACtB,CAAC;EAED,IAAID,GACF,MAAU,MAAMA,EAAM,WAAW,qBAAqB;EAGxD,IAAI,CAACE,GAAS,MACZ,MAAU,MAAM,kBAAkB;EAGpC,OADA,KAAK,mBAAmB,GACjB,KAAK,QAAQA,EAAQ,IAAI;CAClC;CAQA,MAAM,SAAwB;EAC5B,IAAM,EAAE,aAAU,MAAM,KAAK,OAAO,QAAQ;EAC5C,IAAIF,GACF,MAAU,MAAMA,EAAM,WAAW,eAAe;EAElD,KAAK,mBAAmB;CAC1B;CAMA,MAAM,iBAAuC;EAe3C,OAdI,AACJ,KAAK,qBAAmB,YAAY;GAClC,IAAI;IACF,IAAMG,IAAU,MAAM,KAAK,eAAe;IAI1C,OAHIA,GAAS,OACJ,KAAK,QAAQA,EAAQ,MAAMA,EAAQ,OAAO,IAE5C;GACT,QAAQ;IACN,OAAO;GACT,UAAU;IACR,KAAK,kBAAkB;GACzB;EACF,EAAA,CAAG,GACI,KAAK;CACd;CASA,MAAM,WAAmC;EAEvC,IAAI,KAAK,OAAO,OACd,IAAI;GACF,IAAM,EAAE,SAAM,aAAU,MAAM,KAAK,OAAO,MAAM;GAChD,IAAI,CAACH,GAAO;IACV,IAAMI,IAAQ,KAAK,aAAaH,CAAI;IACpC,IAAIG,GAAO,OAAOA;GACpB;EACF,QAAQ,CAER;EAIF,IAAMC,IAAc,MAAM,KAAK,eAAe;EAC9C,OAAO,KAAK,oBAAoBA,CAAW;CAC7C;CAKA,MAAM,sBAAsB,GAAuC;EACjE,IAAMC,IAAkB,KAAK,OAAO,cAC9BC,IAAYD,GAAiB,aAAaA,GAAiB;EAEjE,IAAI,CAACC,GACH,MAAU,MAAM,8DAA8D;EAGhF,IAAMC,IAAS,MAAMD,EAAU,EAAE,kBAAe,CAAC,GAC3CP,IAAQ,WAAWQ,IAASA,EAAO,QAAQ;EACjD,IAAIR,GACF,MAAU,MAAMA,EAAM,WAAW,mCAAmC;EAGtE,KAAK,mBAAmB;CAC1B;CAKA,MAAM,yBAGH;EACD,IAAMK,IAAc,MAAM,KAAK,eAAe;EAC9C,OAAO;GACL,sBACE,OAAOA,GAAa,SAAS,wBAAyB,WAClDA,EAAY,QAAQ,uBACpB;GACN,cACE,OAAOA,GAAa,SAAS,gBAAiB,WAC1CA,EAAY,QAAQ,eACpB;EACR;CACF;CAcA,mBAAmB,GAAmD;EACpE,IAAII,IAAW;EAOf,IAJA,KAAK,eAAe,CAAC,CAAC,MAAM,MAAS;GACnC,AAAIA,KAAUC,EAASC,CAAI;EAC7B,CAAC,GAEG,OAAO,SAAW,KACpB,aAAa;GACX,IAAW;EACb;EAIF,IAAMC,IAAmB,YAAY;GACnC,AAAKH,KAELC,EAAS,MADU,KAAK,eAAe,CAC1B;EACf;EAEA,OAAO,iBAAiB,KAAK,WAAWE,CAAgB;EAGxD,IAAMC,IACJ,KAAK,iBAAiB,IAClB,YAAY,YAAY;GACtB,AAAKJ,KAELC,EAAS,MADU,KAAK,eAAe,CAC1B;EACf,GAAG,KAAK,cAAc,IACtB;EAGN,aAAa;GAGX,AAFA,IAAW,IACX,OAAO,oBAAoB,KAAK,WAAWE,CAAgB,GACvDC,KACF,cAAcA,CAAU;EAE5B;CACF;CAKA,MAAM,YAAY,GAA8B;EAC9C,IAAI,CAAC,KAAK,OAAO,aACf,MAAU,MAAM,4EAA4E;EAE9F,IAAMC,IAAM,MAAM,KAAK,OAAO,YAAY,EAAE,UAAUC,EAAM,CAAC;EAC7D,IAAID,EAAI,OACN,MAAU,MAAMA,EAAI,MAAM,WAAW,wBAAwB;CAEjE;CAKA,MAAM,eAAe,GAAiC;EACpD,IAAI,CAAC,KAAK,OAAO,gBACf,MAAU,MAAM,kFAAkF;EAEpG,IAAMA,IAAM,MAAM,KAAK,OAAO,eAAe,EAAE,aAAaE,EAAS,CAAC;EACtE,IAAIF,EAAI,OACN,MAAU,MAAMA,EAAI,MAAM,WAAW,2BAA2B;CAEpE;CAKA,MAAM,cAAc,GAA8B;EAChD,IAAI,CAAC,KAAK,OAAO,gBACf,MAAU,MACR,uFACF;EAGF,IAAM,EAAE,aAAU,MAAM,KAAK,OAAO,eAAe;GACjD;GACA,YAAY;EACd,CAAC;EAED,IAAId,GACF,MAAU,MAAMA,EAAM,WAAW,qCAAqC;CAE1E;CAEA,MAAc,iBAAiD;EAC7D,IAAMG,IAAU,MAAM,KAAK,OAAO,WAAW;EAI7C,OAHIA,GAAS,QACJ,OAEFA,GAAS,QAAQ;CAC1B;CAEA,oBAA4B,GAAmD;EAC7E,IAAMC,IAAQC,GAAa,SAAS;EACpC,OAAO,OAAOD,KAAU,YAAYA,EAAM,SAAS,IAAIA,IAAQ;CACjE;CAEA,aAAqB,GAAiD;EACpE,IAAI,CAACH,GAAM,OAAO;EAClB,IAAI,OAAOA,KAAS,UAClB,OAAOA,EAAK,SAAS,IAAIA,IAAO;EAElC,IAAMG,IAAQH,EAAK;EACnB,OAAO,OAAOG,KAAU,YAAYA,EAAM,SAAS,IAAIA,IAAQ;CACjE;CAEA,cACE,GACA,GACyB;EACzB,IAAM,EAAE,IAAIa,GAAK,OAAOC,GAAQ,MAAMC,GAAO,OAAOC,GAAQ,MAAMC,GAAO,GAAGC,MAASX,GAC/EY,IAAoC,EAAE,GAAGD,EAAK;EASpD,OAPInB,GAAS,yBACX,EAAS,uBAAuBA,EAAQ,uBAEtCA,GAAS,iBACX,EAAS,eAAeA,EAAQ,eAG3BoB;CACT;CAEA,qBAAmC;EACjC,AAAI,OAAO,SAAW,OACtB,OAAO,cAAc,IAAI,YAAY,KAAK,SAAS,CAAC;CACtD;CAGA,QAAgB,GAAgC,GAA0C;EACxF,IAAI,CAACC,GAEH,MAAU,MAAM,mBAAmB;EAErC,OAAO;GACL,IAAIA,EAAe;GACnB,OAAOA,EAAe,SAAS;GAC/B,MAAMA,EAAe;GACrB,WAAWA,EAAe;GAC1B,MAAMA,EAAe;GACrB,UAAU,KAAK,cAAcA,GAAgBrB,CAAO;EACtD;CACF;AACF"}
+{"version":3,"file":"better-auth-adapter.js","names":["BetterAuthAdapter","client","options","error","data","resData","session","token","sessionData","organizationApi","setActive","result","isActive","callback","user","handleAuthChange","intervalId","res","email","password","_id","_email","_name","_image","_role","rest","metadata","betterAuthUser"],"sources":["../../../../../src/tools/components/auth/adapters/better-auth-adapter.ts"],"sourcesContent":["import { AuthAdapter, User } from '../types';\n\n/**\n * Host endpoint error payload, or null when no endpoint error is present.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthError = {\n  /** Optional endpoint error text used in adapter Error messages. */\n  message?: string;\n} | null;\n/**\n * Minimal host user fields mapped to Appkit User; remaining keys become metadata.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthUser = {\n  /** Stable host user ID. */\n  id: string;\n  /** Optional host email; mapped to an empty string if absent. */\n  email?: string;\n  /** Optional host display name. */\n  name?: string;\n  /** Optional avatar URL mapped to avatarUrl. */\n  image?: string;\n  /** Optional host role copied without authorization checks. */\n  role?: string;\n} & Record<string, unknown>;\n/**\n * Minimal host session fields used for token and organization context lookup.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthSession = {\n  /** Optional session token; nonempty values are used by fallback lookup. */\n  token?: string;\n  /** Optional active organization copied into user metadata. */\n  activeOrganizationId?: string;\n  /** Optional active team copied into user metadata. */\n  activeTeamId?: string;\n} & Record<string, unknown>;\n/**\n * Nullable host session response; user and session may independently be null.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthSessionData = {\n  /** Host session user, or null for no user. */\n  user: BetterAuthUser | null;\n  /** Host session metadata, or null when unavailable. */\n  session: BetterAuthSession | null;\n} | null;\n/**\n * Host response envelope with nullable data and an endpoint error.\n *\n * @typeParam T - Successful response payload.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthResponse<T> = {\n  /** Successful payload, or null when unavailable. */\n  data: T | null;\n  /** Endpoint failure; null represents no endpoint error. */\n  error: BetterAuthError;\n};\n/**\n * Host token endpoint payload accepted as a string or optional token property.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthTokenData = {\n  /** Nonempty token is preferred; missing/empty values trigger fallback. */\n  token?: string;\n} | string;\n/**\n * Organization mutation response with an optional or envelope endpoint error.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthOrganizationActionResponse =\n  | {\n  /** Optional endpoint error; missing or null means no reported error. */\n  error?: BetterAuthError;\n}\n  | BetterAuthResponse<unknown>;\n/**\n * Optional host organization methods; setActive is preferred over setActiveOrganization.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype BetterAuthOrganizationNamespace = {\n  /**\n   * Optional preferred organization switch operation.\n   *\n   * @param params - Organization identifier.\n   *\n   * @returns Host completion response.\n   */\n  setActive?: (params: {\n    /** Target organization identifier. */\n    organizationId: string;\n  }) => Promise<BetterAuthOrganizationActionResponse>;\n  /**\n   * Optional legacy organization switch operation, used only without setActive.\n   *\n   * @param params - Organization identifier.\n   *\n   * @returns Host completion response.\n   */\n  setActiveOrganization?: (params: {\n    /** Target organization identifier. */\n    organizationId: string;\n  }) => Promise<BetterAuthOrganizationActionResponse>;\n};\n\n// Define a type that matches the minimal client interface we need.\n// This avoids strict dependency on the exact generic types of the client.\n/**\n * Structural host client accepted by BetterAuthAdapter without importing its SDK.\n *\n * @remarks Required email sign-in/up, sign-out and session methods may reject with client\n * errors. Optional account/plugin methods cause the matching adapter operation to reject\n * when absent, except token which falls back to session lookup.\n *\n * @see BetterAuthAdapter for the public host-input example.\n */\ntype MinimalAuthClient = {\n  /**\n   * Email sign-in namespace required by the adapter.\n   */\n  signIn: {\n        /**\n         * Submit email credentials through the host client.\n         *\n         * @param params - Account credentials and optional sign-up name.\n         *\n         * @param options - Optional SDK request options; the adapter does not supply them.\n         *\n         * @returns Host response whose user is required for adapter success.\n         */\n    email: (\n      params: {\n        /** Account email. */\n        email: string;\n        /** Account password. */\n        password: string;\n      },\n      options?: Record<string, unknown>,\n    ) => Promise<BetterAuthResponse<{\n      /** User returned by email sign-in/up; adapter rejects when absent. */\n      user?: BetterAuthUser | null;\n    }>>;\n  };\n  /**\n   * Email sign-up namespace required by the adapter.\n   */\n  signUp: {\n        /**\n         * Submit email credentials through the host client.\n         *\n         * @param params - Account credentials and optional sign-up name.\n         *\n         * @param options - Optional SDK request options; the adapter does not supply them.\n         *\n         * @returns Host response whose user is required for adapter success.\n         */\n    email: (\n      params: {\n        /** Account email. */\n        email: string;\n        /** Account password. */\n        password: string;\n        /** Optional display name. */\n        name?: string;\n      },\n      options?: Record<string, unknown>,\n    ) => Promise<BetterAuthResponse<{\n      /** User returned by email sign-in/up; adapter rejects when absent. */\n      user?: BetterAuthUser | null;\n    }>>;\n  };\n  /**\n   * End the host session.\n   *\n   * @returns Endpoint error payload after completion.\n   */\n  signOut: () => Promise<{\n  /** Optional endpoint error; missing or null means no reported error. */\n  error?: BetterAuthError;\n}>;\n  /**\n   * Read the host session.\n   *\n   * @returns Nullable user/session payload and endpoint error.\n   */\n  getSession: () => Promise<BetterAuthResponse<BetterAuthSessionData>>;\n    /**\n     * Optional JWT/token endpoint; adapter swallows endpoint failures before session fallback.\n     *\n     * @returns Token payload and endpoint error.\n     */\n  token?: () => Promise<BetterAuthResponse<BetterAuthTokenData>>;\n  /**\n   * Optional password-reset endpoint.\n   *\n   * @param params - Account email and optional redirect destination.\n   *\n   * @returns Completion response with optional endpoint error.\n   */\n  forgetPassword?: (params: {\n    /** Optional host email; mapped to an empty string if absent. */\n    email: string;\n    /** Optional reset redirect; adapter supplies /reset-password. */\n    redirectTo?: string;\n  }) => Promise<{\n  /** Optional endpoint error; missing or null means no reported error. */\n  error?: BetterAuthError;\n}>;\n  /**\n   * Optional password-change endpoint.\n   *\n   * @param params - New password and optional host-only verification/session switches.\n   *\n   * @returns Completion response with optional endpoint error.\n   */\n  changePassword?: (params: {\n    /** Replacement password sent by the adapter. */\n    newPassword: string;\n    /** Optional current password supported by the host; adapter does not supply it. */\n    currentPassword?: string;\n    /** Optional host session-revocation switch; adapter does not supply it. */\n    revokeOtherSessions?: boolean;\n  }) => Promise<{\n  /** Optional endpoint error; missing or null means no reported error. */\n  error?: BetterAuthError;\n}>;\n  /**\n   * Optional email-change endpoint.\n   *\n   * @param params - New email address.\n   *\n   * @returns Completion response with optional endpoint error.\n   */\n  changeEmail?: (params: {\n    /** Replacement account email. */\n    newEmail: string;\n  }) => Promise<{\n  /** Optional endpoint error; missing or null means no reported error. */\n  error?: BetterAuthError;\n}>;\n  /** Optional organization plugin namespace. */\n  organization?: BetterAuthOrganizationNamespace;\n};\n\n/**\n * Polling and browser event settings; see BetterAuthAdapter for host setup.\n * @see BetterAuthAdapter for the canonical usage example.\n */\nexport interface BetterAuthAdapterOptions {\n  /**\n   * Custom window event observed by onAuthStateChanged.\n   *\n   * @defaultValue \"better-auth:session-changed\"\n   */\n  sessionChangeEventName?: string;\n  /**\n   * Session polling interval in milliseconds; zero or negative disables polling.\n   *\n   * @defaultValue 30000\n   */\n  pollIntervalMs?: number;\n}\n\n/**\n * Adapts a host-supplied Better Auth client to Appkit authentication operations.\n *\n * @remarks The host installs/configures the Better Auth SDK and server and supplies a\n * structurally compatible client. No SDK or working backend is created by this class.\n * Subscriptions use an initial session read, custom window events and optional polling;\n * each returned cleanup stops its listener/timer. AuthProvider requires an outer\n * QueryClientProvider; this adapter alone requires neither CSS nor a React provider.\n *\n * @example\n * ```tsx\n * import type { ReactNode } from 'react';\n * import { useMemo } from 'react';\n * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\n * import { BetterAuthAdapter, AuthProvider } from '@alneas/appkit-react/tools/auth';\n * export function BetterAuthRoot({ authClient, queryClient, children }: {\n *   authClient: ConstructorParameters<typeof BetterAuthAdapter>[0];\n *   queryClient: QueryClient;\n *   children: ReactNode;\n * }) {\n *   const adapter = useMemo(() => new BetterAuthAdapter(authClient), [authClient]);\n *   return <QueryClientProvider client={queryClient}>\n *     <AuthProvider adapter={adapter}>{children}</AuthProvider>\n *   </QueryClientProvider>;\n * }\n * ```\n */\nexport class BetterAuthAdapter implements AuthAdapter {\n  private client: MinimalAuthClient;\n  private eventName: string;\n  private pollIntervalMs: number;\n  private inFlightSession: Promise<User | null> | null = null;\n\n  /**\n   * Creates an adapter around an already configured host client.\n   *\n   * @param client - Compatible Better Auth client with email sign-in/up, sign-out and getSession.\n   *\n   * @param options - Event name and polling interval; defaults to better-auth:session-changed and 30000 ms.\n   *\n   * @remarks Construction makes no requests and starts no listeners; see the class example.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export function adapt(client: ConstructorParameters<typeof BetterAuthAdapter>[0]) {\n   *   return new BetterAuthAdapter(client, { pollIntervalMs: 0 });\n   * }\n   * ```\n   */\n  constructor(client: MinimalAuthClient, options: BetterAuthAdapterOptions = {}) {\n    this.client = client;\n    this.eventName = options.sessionChangeEventName ?? 'better-auth:session-changed';\n    this.pollIntervalMs = options.pollIntervalMs ?? 30000;\n  }\n\n  /**\n   * Signs in with the client email/password endpoint.\n   *\n   * @param email - User email address.\n   *\n   * @param password - User password.\n   *\n   * @returns The mapped signed-in user; emits the session-change event on success.\n   *\n   * @throws Rejects on client failure, endpoint error or a response missing a user.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.login('person@example.com', password);\n   * }\n   * ```\n   */\n  async login(email: string, password: string): Promise<User> {\n    const { data, error } = await this.client.signIn.email({\n      email,\n      password,\n    });\n\n    if (error) {\n      throw new Error(error.message || 'Login failed');\n    }\n\n    if (!data?.user) {\n      throw new Error('No user returned');\n    }\n    this.emitSessionChanged();\n    return this.mapUser(data.user);\n  }\n\n  /**\n   * Creates an account through the client email sign-up endpoint.\n   *\n   * @param email - New account email.\n   *\n   * @param password - New account password.\n   *\n   * @param data - Optional name; omitted or empty names are sent as an empty string.\n   *\n   * @returns The mapped registered user; emits the session-change event on success.\n   *\n   * @throws Rejects on client failure, endpoint error or a response missing a user.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.register('person@example.com', password, { name: 'Reader' });\n   * }\n   * ```\n   */\n  async register(email: string, password: string, data?: {\n    /** Optional display name forwarded as an empty string when omitted. */\n    name?: string;\n  }): Promise<User> {\n    const { data: resData, error } = await this.client.signUp.email({\n      email,\n      password,\n      name: data?.name || '',\n    });\n\n    if (error) {\n      throw new Error(error.message || 'Registration failed');\n    }\n\n    if (!resData?.user) {\n      throw new Error('No user returned');\n    }\n    this.emitSessionChanged();\n    return this.mapUser(resData.user);\n  }\n\n  /**\n   * Signs out through the supplied client.\n   *\n   *\n   * @returns No value after sign-out succeeds and the session-change event is emitted.\n   *\n   * @throws Rejects on client failure or endpoint error.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.logout();\n   * }\n   * ```\n   */\n  async logout(): Promise<void> {\n    const { error } = await this.client.signOut();\n    if (error) {\n      throw new Error(error.message || 'Logout failed');\n    }\n    this.emitSessionChanged();\n  }\n\n  /**\n   * Reads the current user, coalescing concurrent reads on this adapter.\n   *\n   *\n   * @returns The mapped session user, or null for no session, endpoint errors or thrown read failures.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.getCurrentUser();\n   * }\n   * ```\n   */\n  async getCurrentUser(): Promise<User | null> {\n    if (this.inFlightSession) return this.inFlightSession;\n    this.inFlightSession = (async () => {\n      try {\n        const session = await this.getSessionData();\n        if (session?.user) {\n          return this.mapUser(session.user, session.session);\n        }\n        return null;\n      } catch {\n        return null;\n      } finally {\n        this.inFlightSession = null;\n      }\n    })();\n    return this.inFlightSession;\n  }\n\n  /**\n   * Reads a token, trying the optional token endpoint before the session token.\n   *\n   *\n   * @returns A nonempty token string or null if no token is available.\n   *\n   * @throws Rejects if the fallback session request throws; token-endpoint failures are swallowed.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.getToken();\n   * }\n   * ```\n   */\n  async getToken(): Promise<string | null> {\n    // 1) JWT plugin endpoint (/token) が利用可能なら優先\n    if (this.client.token) {\n      try {\n        const { data, error } = await this.client.token();\n        if (!error) {\n          const token = this.extractToken(data);\n          if (token) return token;\n        }\n      } catch {\n        // fallback to session token\n      }\n    }\n\n    // 2) セッションの token を使用\n    const sessionData = await this.getSessionData();\n    return this.extractSessionToken(sessionData);\n  }\n\n  /**\n   * Changes the active organization using the optional organization client namespace.\n   *\n   * @param organizationId - Organization identifier sent to setActive or setActiveOrganization.\n   *\n   * @returns No value after success; emits a session-change event.\n   *\n   * @throws Rejects if the plugin method is missing, the client rejects or an endpoint error is returned.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.setActiveOrganization('selected-organization');\n   * }\n   * ```\n   */\n  async setActiveOrganization(organizationId: string): Promise<void> {\n    const organizationApi = this.client.organization;\n    const setActive = organizationApi?.setActive ?? organizationApi?.setActiveOrganization;\n\n    if (!setActive) {\n      throw new Error('Organization plugin is not configured on Better Auth client.');\n    }\n\n    const result = await setActive({ organizationId });\n    const error = 'error' in result ? result.error : null;\n    if (error) {\n      throw new Error(error.message || 'Failed to set active organization');\n    }\n\n    this.emitSessionChanged();\n  }\n\n  /**\n   * Reads active organization/team identifiers from the current session.\n   *\n   *\n   * @returns An object whose two identifiers are strings when present and null otherwise.\n   *\n   * @throws Rejects if the session request throws; returned endpoint errors produce null identifiers.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.getOrganizationContext();\n   * }\n   * ```\n   */\n  async getOrganizationContext(): Promise<{\n    /** Active organization, or null when absent. */\n    activeOrganizationId: string | null;\n    /** Active team, or null when absent. */\n    activeTeamId: string | null;\n  }> {\n    const sessionData = await this.getSessionData();\n    return {\n      activeOrganizationId:\n        typeof sessionData?.session?.activeOrganizationId === 'string'\n          ? sessionData.session.activeOrganizationId\n          : null,\n      activeTeamId:\n        typeof sessionData?.session?.activeTeamId === 'string'\n          ? sessionData.session.activeTeamId\n          : null,\n    };\n  }\n\n  /**\n   * Observes session state using an initial read, browser events and optional polling.\n   *\n   * @param callback - Receives the mapped user or null after each read; callbacks can repeat unchanged values.\n   *\n   * @returns Cleanup that disables the initial callback and removes browser listeners/timers.\n   *\n   * @remarks On the server only the initial asynchronous read occurs. Browser polling defaults\n   * to 30000 ms and is disabled by nonpositive intervals. Callback errors are not caught.\n   * An already-running event/poll read may still invoke callback after cleanup.\n   *\n   * @deprecated React consumers should use useAuth under AuthProvider for managed lifecycle/state.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter, type User } from '@alneas/appkit-react/tools/auth';\n   * export function observe(adapter: BetterAuthAdapter, onUser: (user: User | null) => void) {\n   *   return adapter.onAuthStateChanged(onUser);\n   * }\n   * // The host calls the returned cleanup when observation ends.\n   * ```\n   */\n  onAuthStateChanged(callback: (user: User | null) => void): () => void {\n    let isActive = true;\n\n    // 1. Initial call - get current user immediately\n    this.getCurrentUser().then((user) => {\n      if (isActive) callback(user);\n    });\n\n    if (typeof window === 'undefined') {\n      return () => {\n        isActive = false;\n      };\n    }\n\n    // 2. Listen for custom window events\n    const handleAuthChange = async () => {\n      if (!isActive) return;\n      const user = await this.getCurrentUser();\n      callback(user);\n    };\n\n    window.addEventListener(this.eventName, handleAuthChange);\n\n    // 3. Polling fallback\n    const intervalId =\n      this.pollIntervalMs > 0\n        ? setInterval(async () => {\n            if (!isActive) return;\n            const user = await this.getCurrentUser();\n            callback(user);\n          }, this.pollIntervalMs)\n        : null;\n\n    // Return cleanup function\n    return () => {\n      isActive = false;\n      window.removeEventListener(this.eventName, handleAuthChange);\n      if (intervalId) {\n        clearInterval(intervalId);\n      }\n    };\n  }\n\n  /**\n   * Requests an email change through the optional changeEmail endpoint.\n   *\n   * @param email - New email address.\n   *\n   * @returns No value after the endpoint succeeds; this method emits no session-change event.\n   *\n   * @throws Rejects if changeEmail is absent, the client rejects or an endpoint error is returned.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.updateEmail('new@example.com');\n   * }\n   * ```\n   */\n  async updateEmail(email: string): Promise<void> {\n    if (!this.client.changeEmail) {\n      throw new Error('Update email is not available. Configure Better Auth changeEmail endpoint.');\n    }\n    const res = await this.client.changeEmail({ newEmail: email });\n    if (res.error) {\n      throw new Error(res.error.message || 'Failed to update email');\n    }\n  }\n\n  /**\n   * Requests a password change through the optional changePassword endpoint.\n   *\n   * @param password - New password; this method does not send a current password.\n   *\n   * @returns No value after the endpoint succeeds; this method emits no session-change event.\n   *\n   * @throws Rejects if changePassword is absent, the client rejects or an endpoint error is returned.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.updatePassword(password);\n   * }\n   * ```\n   */\n  async updatePassword(password: string): Promise<void> {\n    if (!this.client.changePassword) {\n      throw new Error('Update password is not available. Configure Better Auth changePassword endpoint.');\n    }\n    const res = await this.client.changePassword({ newPassword: password });\n    if (res.error) {\n      throw new Error(res.error.message || 'Failed to update password');\n    }\n  }\n\n  /**\n   * Requests a password-reset email with redirectTo set to /reset-password.\n   *\n   * @param email - Account email address.\n   *\n   * @returns No value after the endpoint succeeds; delivery is owned by the host backend.\n   *\n   * @throws Rejects if forgetPassword is absent, the client rejects or an endpoint error is returned.\n   *\n   * @example\n   * ```ts\n   * import { BetterAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * export async function run(adapter: BetterAuthAdapter, password: string) {\n   *   return adapter.resetPassword('person@example.com');\n   * }\n   * ```\n   */\n  async resetPassword(email: string): Promise<void> {\n    if (!this.client.forgetPassword) {\n      throw new Error(\n        'Reset password is not available. Configure Better Auth email/password reset endpoint.',\n      );\n    }\n\n    const { error } = await this.client.forgetPassword({\n      email,\n      redirectTo: '/reset-password',\n    });\n\n    if (error) {\n      throw new Error(error.message || 'Failed to send reset password email');\n    }\n  }\n\n  private async getSessionData(): Promise<BetterAuthSessionData> {\n    const session = await this.client.getSession();\n    if (session?.error) {\n      return null;\n    }\n    return session?.data ?? null;\n  }\n\n  private extractSessionToken(sessionData: BetterAuthSessionData): string | null {\n    const token = sessionData?.session?.token;\n    return typeof token === 'string' && token.length > 0 ? token : null;\n  }\n\n  private extractToken(data: BetterAuthTokenData | null): string | null {\n    if (!data) return null;\n    if (typeof data === 'string') {\n      return data.length > 0 ? data : null;\n    }\n    const token = data.token;\n    return typeof token === 'string' && token.length > 0 ? token : null;\n  }\n\n  private buildMetadata(\n    user: BetterAuthUser,\n    session?: BetterAuthSession | null,\n  ): Record<string, unknown> {\n    const { id: _id, email: _email, name: _name, image: _image, role: _role, ...rest } = user;\n    const metadata: Record<string, unknown> = { ...rest };\n\n    if (session?.activeOrganizationId) {\n      metadata.activeOrganizationId = session.activeOrganizationId;\n    }\n    if (session?.activeTeamId) {\n      metadata.activeTeamId = session.activeTeamId;\n    }\n\n    return metadata;\n  }\n\n  private emitSessionChanged(): void {\n    if (typeof window === 'undefined') return;\n    window.dispatchEvent(new CustomEvent(this.eventName));\n  }\n\n  // Helper to map Better Auth user to our User type\n  private mapUser(betterAuthUser: BetterAuthUser, session?: BetterAuthSession | null): User {\n    if (!betterAuthUser) {\n      // throw error or return generic\n      throw new Error('User data missing');\n    }\n    return {\n      id: betterAuthUser.id,\n      email: betterAuthUser.email || '',\n      name: betterAuthUser.name,\n      avatarUrl: betterAuthUser.image,\n      role: betterAuthUser.role,\n      metadata: this.buildMetadata(betterAuthUser, session),\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/tools/components/auth/adapters/mock-adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mock-adapter.cjs","names":["MockAuthAdapter","initialUser","password","data","email","provider","callback","l"],"sources":["../../../../../src/tools/components/auth/adapters/mock-adapter.ts"],"sourcesContent":["import { AuthAdapter, OAuthProvider, User } from '../types';\n\n/**\n * テストおよび開発用のモック認証アダプター\n * 認証プロバイダーと通信することなく、メモリ上の状態のみで認証機能をシミュレートします。\n */\nexport class MockAuthAdapter implements AuthAdapter {\n  private currentUser: User | null = null;\n  private listeners: ((user: User | null) => void)[] = [];\n\n  /**\n   * MockAuthAdapter インスタンスを初期化します。\n   * @param initialUser 初期状態のユーザー情報\n   */\n  constructor(initialUser: User | null = null) {\n    this.currentUser = initialUser;\n  }\n\n  /**\n   * メールアドレスとパスワードによるログイン処理をシミュレートします。\n   * @param email メールアドレス\n   * @param password パスワード（\"error\" の場合は失敗します）\n   * @returns ログインしたユーザー情報\n   */\n  async login(email: string, password: string): Promise<User> {\n    if (password === 'error') throw new Error('Invalid credentials');\n    this.currentUser = { id: '1', email, name: 'Mock User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * 新規ユーザー登録処理をシミュレートします。\n   * @param email メールアドレス\n   * @param _password パスワード\n   * @param data 追加のユーザー情報（氏名など）\n   * @returns 登録されたユーザー情報\n   */\n  async register(email: string, _password: string, data?: { name?: string }): Promise<User> {\n    this.currentUser = { id: '2', email, name: data?.name || 'New User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * ログアウト処理をシミュレートします。現在のユーザー状態をクリアします。\n   */\n  async logout(): Promise<void> {\n    this.currentUser = null;\n    this.notifyListeners();\n  }\n\n  /**\n   * パスワードリセット処理をシミュレートします。\n   * @param email メールアドレス\n   */\n  async resetPassword(email: string): Promise<void> {\n    console.log(`Reset password for ${email}`);\n  }\n\n  /**\n   * ユーザーのメールアドレス変更処理をシミュレートします。\n   * @param email 新しいメールアドレス\n   */\n  async updateEmail(email: string): Promise<void> {\n    if (this.currentUser) {\n      this.currentUser = { ...this.currentUser, email };\n      this.notifyListeners();\n    }\n  }\n\n  /**\n   * ユーザーのパスワード変更処理をシミュレートします。\n   * @param _password 新しいパスワード\n   */\n  async updatePassword(_password: string): Promise<void> {\n    console.log('Password updated');\n  }\n\n  /**\n   * 現在ログインしているユーザーを取得します。\n   * @returns ログインユーザー、または未ログインの場合は null\n   */\n  async getCurrentUser(): Promise<User | null> {\n    return this.currentUser;\n  }\n\n  /**\n   * OAuthプロバイダーを使用したログイン処理をシミュレートします。\n   * @param provider OAuthプロバイダー名\n   * @returns ログインしたユーザー情報\n   */\n  async loginWithProvider(provider: OAuthProvider): Promise<User> {\n    this.currentUser = {\n      id: `${provider}-1`,\n      email: `${provider}@example.com`,\n      name: `${provider} User`,\n    };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * 認証状態の変更イベントリスナーを登録します。\n   * @param callback 認証状態変更時に呼び出される関数\n   * @returns リスナーを解除するためのクリーンアップ関数\n   */\n  onAuthStateChanged(callback: (user: User | null) => void): () => void {\n    this.listeners.push(callback);\n    callback(this.currentUser);\n    return () => {\n      this.listeners = this.listeners.filter((l) => l !== callback);\n    };\n  }\n\n  private notifyListeners() {\n    this.listeners.forEach((l) => l(this.currentUser));\n  }\n}\n"],"mappings":"A,gFAMA,IAAaA,EAAb,KAAoD,CAClD,YAAmC,KACnC,UAAqD,CAAC,EAMtD,YAAY,EAA2B,KAAM,CAC3C,KAAK,YAAcC,CACrB,CAQA,MAAM,MAAM,EAAe,EAAiC,CAC1D,GAAIC,IAAa,QAAS,MAAU,MAAM,qBAAqB,EAG/D,MAFA,MAAK,YAAc,CAAE,GAAI,IAAK,QAAO,KAAM,WAAY,EACvD,KAAK,gBAAgB,EACd,KAAK,WACd,CASA,MAAM,SAAS,EAAe,EAAmB,EAAyC,CAGxF,MAFA,MAAK,YAAc,CAAE,GAAI,IAAK,QAAO,KAAMC,GAAM,MAAQ,UAAW,EACpE,KAAK,gBAAgB,EACd,KAAK,WACd,CAKA,MAAM,QAAwB,CAC5B,KAAK,YAAc,KACnB,KAAK,gBAAgB,CACvB,CAMA,MAAM,cAAc,EAA8B,CAChD,QAAQ,IAAI,sBAAsBC,GAAO,CAC3C,CAMA,MAAM,YAAY,EAA8B,CAC1C,KAAK,cACP,KAAK,YAAc,CAAE,GAAG,KAAK,YAAa,OAAM,EAChD,KAAK,gBAAgB,EAEzB,CAMA,MAAM,eAAe,EAAkC,CACrD,QAAQ,IAAI,kBAAkB,CAChC,CAMA,MAAM,gBAAuC,CAC3C,OAAO,KAAK,WACd,CAOA,MAAM,kBAAkB,EAAwC,CAO9D,MANA,MAAK,YAAc,CACjB,GAAI,GAAGC,EAAS,IAChB,MAAO,GAAGA,EAAS,cACnB,KAAM,GAAGA,EAAS,MACpB,EACA,KAAK,gBAAgB,EACd,KAAK,WACd,CAOA,mBAAmB,EAAmD,CAGpE,OAFA,KAAK,UAAU,KAAKC,CAAQ,EAC5BA,EAAS,KAAK,WAAW,MACZ,CACX,KAAK,UAAY,KAAK,UAAU,OAAQ,GAAMC,IAAMD,CAAQ,CAC9D,CACF,CAEA,iBAA0B,CACxB,KAAK,UAAU,QAAS,GAAMC,EAAE,KAAK,WAAW,CAAC,CACnD,CACF,E"}
+{"version":3,"file":"mock-adapter.cjs","names":["MockAuthAdapter","initialUser","password","data","email","provider","callback","l"],"sources":["../../../../../src/tools/components/auth/adapters/mock-adapter.ts"],"sourcesContent":["import { AuthAdapter, OAuthProvider, User } from '../types';\n\n/**\n * Simulates authentication in memory for tests and isolated development previews.\n *\n * @remarks Never authenticates a backend, verifies a password or persists state. Listener\n * callbacks run synchronously and may throw. Use a real host adapter for production.\n *\n * @example\n * ```ts\n * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n * const adapter = new MockAuthAdapter();\n * const user = await adapter.login('preview@example.com', 'preview-only');\n * await adapter.logout();\n * ```\n */\nexport class MockAuthAdapter implements AuthAdapter {\n  private currentUser: User | null = null;\n  private listeners: ((user: User | null) => void)[] = [];\n\n  /**\n   * Creates an isolated in-memory authentication fixture.\n   *\n   * @param initialUser - Initial display user, default null.\n   *\n   * @see MockAuthAdapter for a complete preview-only example.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter({ id: 'preview-1', email: 'preview@example.com' });\n   * ```\n   */\n  constructor(initialUser: User | null = null) {\n    this.currentUser = initialUser;\n  }\n\n  /**\n   * Simulates email login with a fixed user ID of 1.\n   *\n   * @param email - Display email.\n   *\n   * @param password - Only the literal error triggers invalid-credentials rejection.\n   *\n   * @returns Mock user after synchronous listener notification.\n   *\n   * @throws Rejects for password error or a throwing listener.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.login('preview@example.com', 'preview-only');\n   * ```\n   */\n  async login(email: string, password: string): Promise<User> {\n    if (password === 'error') throw new Error('Invalid credentials');\n    this.currentUser = { id: '1', email, name: 'Mock User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * Simulates registration with fixed user ID 2.\n   *\n   * @param email - Display email.\n   *\n   * @param _password - Ignored; no credentials are stored.\n   *\n   * @param data - Optional name; empty/omitted uses New User.\n   *\n   * @returns Mock user after synchronous listener notification.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.register('preview@example.com', 'preview-only', { name: 'Preview' });\n   * ```\n   */\n  async register(email: string, _password: string, data?: {\n    /** Optional display name; omission/empty uses New User. */\n    name?: string;\n  }): Promise<User> {\n    this.currentUser = { id: '2', email, name: data?.name || 'New User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * Clears the in-memory user and synchronously notifies listeners.\n   *\n   *\n   * @returns No value after notification.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.logout();\n   * ```\n   */\n  async logout(): Promise<void> {\n    this.currentUser = null;\n    this.notifyListeners();\n  }\n\n  /**\n   * Logs a reset request without sending email.\n   *\n   * @param email - Email included in console output.\n   *\n   * @returns No value; no reset token or email is created.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.resetPassword('preview@example.com');\n   * ```\n   */\n  async resetPassword(email: string): Promise<void> {\n    console.log(`Reset password for ${email}`);\n  }\n\n  /**\n   * Changes the current mock user email when a user exists.\n   *\n   * @param email - Replacement display email.\n   *\n   * @returns No value; without a current user the operation does nothing.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.updateEmail('new@example.com');\n   * ```\n   */\n  async updateEmail(email: string): Promise<void> {\n    if (this.currentUser) {\n      this.currentUser = { ...this.currentUser, email };\n      this.notifyListeners();\n    }\n  }\n\n  /**\n   * Logs a password update without checking or storing credentials.\n   *\n   * @param _password - Ignored new password.\n   *\n   * @returns No value after console output.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.updatePassword('preview-only');\n   * ```\n   */\n  async updatePassword(_password: string): Promise<void> {\n    console.log('Password updated');\n  }\n\n  /**\n   * Reads the current in-memory display user.\n   *\n   *\n   * @returns Current user or null, returned by reference.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.getCurrentUser();\n   * ```\n   */\n  async getCurrentUser(): Promise<User | null> {\n    return this.currentUser;\n  }\n\n  /**\n   * Creates a synthetic display user for an OAuth provider without contacting it.\n   *\n   * @param provider - Used in the synthetic ID, email and name.\n   *\n   * @returns Synthetic user after synchronous listener notification.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.loginWithProvider('google');\n   * ```\n   */\n  async loginWithProvider(provider: OAuthProvider): Promise<User> {\n    this.currentUser = {\n      id: `${provider}-1`,\n      email: `${provider}@example.com`,\n      name: `${provider} User`,\n    };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * Registers a synchronous listener and immediately calls it with the current user.\n   *\n   * @param callback - Receives the current user or null on registration and each mutation.\n   *\n   * @returns Cleanup removing this callback from the listener list.\n   *\n   * @throws Callback errors propagate; a failed initial callback is already registered.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * const stop = adapter.onAuthStateChanged(user => { console.log(user?.id); });\n   * stop();\n   * ```\n   */\n  onAuthStateChanged(callback: (user: User | null) => void): () => void {\n    this.listeners.push(callback);\n    callback(this.currentUser);\n    return () => {\n      this.listeners = this.listeners.filter((l) => l !== callback);\n    };\n  }\n\n  private notifyListeners() {\n    this.listeners.forEach((l) => l(this.currentUser));\n  }\n}\n"],"mappings":"A,gFAgBA,IAAaA,EAAb,KAAoD,CAClD,YAAmC,KACnC,UAAqD,CAAC,EAetD,YAAY,EAA2B,KAAM,CAC3C,KAAK,YAAcC,CACrB,CAoBA,MAAM,MAAM,EAAe,EAAiC,CAC1D,GAAIC,IAAa,QAAS,MAAU,MAAM,qBAAqB,EAG/D,MAFA,MAAK,YAAc,CAAE,GAAI,IAAK,QAAO,KAAM,WAAY,EACvD,KAAK,gBAAgB,EACd,KAAK,WACd,CAsBA,MAAM,SAAS,EAAe,EAAmB,EAG/B,CAGhB,MAFA,MAAK,YAAc,CAAE,GAAI,IAAK,QAAO,KAAMC,GAAM,MAAQ,UAAW,EACpE,KAAK,gBAAgB,EACd,KAAK,WACd,CAiBA,MAAM,QAAwB,CAC5B,KAAK,YAAc,KACnB,KAAK,gBAAgB,CACvB,CAgBA,MAAM,cAAc,EAA8B,CAChD,QAAQ,IAAI,sBAAsBC,GAAO,CAC3C,CAkBA,MAAM,YAAY,EAA8B,CAC1C,KAAK,cACP,KAAK,YAAc,CAAE,GAAG,KAAK,YAAa,OAAM,EAChD,KAAK,gBAAgB,EAEzB,CAgBA,MAAM,eAAe,EAAkC,CACrD,QAAQ,IAAI,kBAAkB,CAChC,CAeA,MAAM,gBAAuC,CAC3C,OAAO,KAAK,WACd,CAkBA,MAAM,kBAAkB,EAAwC,CAO9D,MANA,MAAK,YAAc,CACjB,GAAI,GAAGC,EAAS,IAChB,MAAO,GAAGA,EAAS,cACnB,KAAM,GAAGA,EAAS,MACpB,EACA,KAAK,gBAAgB,EACd,KAAK,WACd,CAmBA,mBAAmB,EAAmD,CAGpE,OAFA,KAAK,UAAU,KAAKC,CAAQ,EAC5BA,EAAS,KAAK,WAAW,MACZ,CACX,KAAK,UAAY,KAAK,UAAU,OAAQ,GAAMC,IAAMD,CAAQ,CAC9D,CACF,CAEA,iBAA0B,CACxB,KAAK,UAAU,QAAS,GAAMC,EAAE,KAAK,WAAW,CAAC,CACnD,CACF,E"}

package/dist/tools/components/auth/adapters/mock-adapter.d.cts

@@ -1,67 +1,188 @@
 import { AuthAdapter, OAuthProvider, User } from '../types.cjs';
 /**
- * テストおよび開発用のモック認証アダプター
- * 認証プロバイダーと通信することなく、メモリ上の状態のみで認証機能をシミュレートします。
+ * Simulates authentication in memory for tests and isolated development previews.
+ *
+ * @remarks Never authenticates a backend, verifies a password or persists state. Listener
+ * callbacks run synchronously and may throw. Use a real host adapter for production.
+ *
+ * @example
+ * ```ts
+ * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+ * const adapter = new MockAuthAdapter();
+ * const user = await adapter.login('preview@example.com', 'preview-only');
+ * await adapter.logout();
+ * ```
  */
 export declare class MockAuthAdapter implements AuthAdapter {
     private currentUser;
     private listeners;
     /**
-     * MockAuthAdapter インスタンスを初期化します。
-     * @param initialUser 初期状態のユーザー情報
+     * Creates an isolated in-memory authentication fixture.
+     *
+     * @param initialUser - Initial display user, default null.
+     *
+     * @see MockAuthAdapter for a complete preview-only example.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter({ id: 'preview-1', email: 'preview@example.com' });
+     * ```
      */
     constructor(initialUser?: User | null);
     /**
-     * メールアドレスとパスワードによるログイン処理をシミュレートします。
-     * @param email メールアドレス
-     * @param password パスワード（"error" の場合は失敗します）
-     * @returns ログインしたユーザー情報
+     * Simulates email login with a fixed user ID of 1.
+     *
+     * @param email - Display email.
+     *
+     * @param password - Only the literal error triggers invalid-credentials rejection.
+     *
+     * @returns Mock user after synchronous listener notification.
+     *
+     * @throws Rejects for password error or a throwing listener.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.login('preview@example.com', 'preview-only');
+     * ```
      */
     login(email: string, password: string): Promise<User>;
     /**
-     * 新規ユーザー登録処理をシミュレートします。
-     * @param email メールアドレス
-     * @param _password パスワード
-     * @param data 追加のユーザー情報（氏名など）
-     * @returns 登録されたユーザー情報
+     * Simulates registration with fixed user ID 2.
+     *
+     * @param email - Display email.
+     *
+     * @param _password - Ignored; no credentials are stored.
+     *
+     * @param data - Optional name; empty/omitted uses New User.
+     *
+     * @returns Mock user after synchronous listener notification.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.register('preview@example.com', 'preview-only', { name: 'Preview' });
+     * ```
      */
     register(email: string, _password: string, data?: {
+        /** Optional display name; omission/empty uses New User. */
         name?: string;
     }): Promise<User>;
     /**
-     * ログアウト処理をシミュレートします。現在のユーザー状態をクリアします。
+     * Clears the in-memory user and synchronously notifies listeners.
+     *
+     *
+     * @returns No value after notification.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.logout();
+     * ```
      */
     logout(): Promise<void>;
     /**
-     * パスワードリセット処理をシミュレートします。
-     * @param email メールアドレス
+     * Logs a reset request without sending email.
+     *
+     * @param email - Email included in console output.
+     *
+     * @returns No value; no reset token or email is created.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.resetPassword('preview@example.com');
+     * ```
      */
     resetPassword(email: string): Promise<void>;
     /**
-     * ユーザーのメールアドレス変更処理をシミュレートします。
-     * @param email 新しいメールアドレス
+     * Changes the current mock user email when a user exists.
+     *
+     * @param email - Replacement display email.
+     *
+     * @returns No value; without a current user the operation does nothing.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.updateEmail('new@example.com');
+     * ```
      */
     updateEmail(email: string): Promise<void>;
     /**
-     * ユーザーのパスワード変更処理をシミュレートします。
-     * @param _password 新しいパスワード
+     * Logs a password update without checking or storing credentials.
+     *
+     * @param _password - Ignored new password.
+     *
+     * @returns No value after console output.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.updatePassword('preview-only');
+     * ```
      */
     updatePassword(_password: string): Promise<void>;
     /**
-     * 現在ログインしているユーザーを取得します。
-     * @returns ログインユーザー、または未ログインの場合は null
+     * Reads the current in-memory display user.
+     *
+     *
+     * @returns Current user or null, returned by reference.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.getCurrentUser();
+     * ```
      */
     getCurrentUser(): Promise<User | null>;
     /**
-     * OAuthプロバイダーを使用したログイン処理をシミュレートします。
-     * @param provider OAuthプロバイダー名
-     * @returns ログインしたユーザー情報
+     * Creates a synthetic display user for an OAuth provider without contacting it.
+     *
+     * @param provider - Used in the synthetic ID, email and name.
+     *
+     * @returns Synthetic user after synchronous listener notification.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.loginWithProvider('google');
+     * ```
      */
     loginWithProvider(provider: OAuthProvider): Promise<User>;
     /**
-     * 認証状態の変更イベントリスナーを登録します。
-     * @param callback 認証状態変更時に呼び出される関数
-     * @returns リスナーを解除するためのクリーンアップ関数
+     * Registers a synchronous listener and immediately calls it with the current user.
+     *
+     * @param callback - Receives the current user or null on registration and each mutation.
+     *
+     * @returns Cleanup removing this callback from the listener list.
+     *
+     * @throws Callback errors propagate; a failed initial callback is already registered.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * const stop = adapter.onAuthStateChanged(user => { console.log(user?.id); });
+     * stop();
+     * ```
      */
     onAuthStateChanged(callback: (user: User | null) => void): () => void;
     private notifyListeners;

package/dist/tools/components/auth/adapters/mock-adapter.d.ts

@@ -1,67 +1,188 @@
 import { AuthAdapter, OAuthProvider, User } from '../types.js';
 /**
- * テストおよび開発用のモック認証アダプター
- * 認証プロバイダーと通信することなく、メモリ上の状態のみで認証機能をシミュレートします。
+ * Simulates authentication in memory for tests and isolated development previews.
+ *
+ * @remarks Never authenticates a backend, verifies a password or persists state. Listener
+ * callbacks run synchronously and may throw. Use a real host adapter for production.
+ *
+ * @example
+ * ```ts
+ * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+ * const adapter = new MockAuthAdapter();
+ * const user = await adapter.login('preview@example.com', 'preview-only');
+ * await adapter.logout();
+ * ```
  */
 export declare class MockAuthAdapter implements AuthAdapter {
     private currentUser;
     private listeners;
     /**
-     * MockAuthAdapter インスタンスを初期化します。
-     * @param initialUser 初期状態のユーザー情報
+     * Creates an isolated in-memory authentication fixture.
+     *
+     * @param initialUser - Initial display user, default null.
+     *
+     * @see MockAuthAdapter for a complete preview-only example.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter({ id: 'preview-1', email: 'preview@example.com' });
+     * ```
      */
     constructor(initialUser?: User | null);
     /**
-     * メールアドレスとパスワードによるログイン処理をシミュレートします。
-     * @param email メールアドレス
-     * @param password パスワード（"error" の場合は失敗します）
-     * @returns ログインしたユーザー情報
+     * Simulates email login with a fixed user ID of 1.
+     *
+     * @param email - Display email.
+     *
+     * @param password - Only the literal error triggers invalid-credentials rejection.
+     *
+     * @returns Mock user after synchronous listener notification.
+     *
+     * @throws Rejects for password error or a throwing listener.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.login('preview@example.com', 'preview-only');
+     * ```
      */
     login(email: string, password: string): Promise<User>;
     /**
-     * 新規ユーザー登録処理をシミュレートします。
-     * @param email メールアドレス
-     * @param _password パスワード
-     * @param data 追加のユーザー情報（氏名など）
-     * @returns 登録されたユーザー情報
+     * Simulates registration with fixed user ID 2.
+     *
+     * @param email - Display email.
+     *
+     * @param _password - Ignored; no credentials are stored.
+     *
+     * @param data - Optional name; empty/omitted uses New User.
+     *
+     * @returns Mock user after synchronous listener notification.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.register('preview@example.com', 'preview-only', { name: 'Preview' });
+     * ```
      */
     register(email: string, _password: string, data?: {
+        /** Optional display name; omission/empty uses New User. */
         name?: string;
     }): Promise<User>;
     /**
-     * ログアウト処理をシミュレートします。現在のユーザー状態をクリアします。
+     * Clears the in-memory user and synchronously notifies listeners.
+     *
+     *
+     * @returns No value after notification.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.logout();
+     * ```
      */
     logout(): Promise<void>;
     /**
-     * パスワードリセット処理をシミュレートします。
-     * @param email メールアドレス
+     * Logs a reset request without sending email.
+     *
+     * @param email - Email included in console output.
+     *
+     * @returns No value; no reset token or email is created.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.resetPassword('preview@example.com');
+     * ```
      */
     resetPassword(email: string): Promise<void>;
     /**
-     * ユーザーのメールアドレス変更処理をシミュレートします。
-     * @param email 新しいメールアドレス
+     * Changes the current mock user email when a user exists.
+     *
+     * @param email - Replacement display email.
+     *
+     * @returns No value; without a current user the operation does nothing.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.updateEmail('new@example.com');
+     * ```
      */
     updateEmail(email: string): Promise<void>;
     /**
-     * ユーザーのパスワード変更処理をシミュレートします。
-     * @param _password 新しいパスワード
+     * Logs a password update without checking or storing credentials.
+     *
+     * @param _password - Ignored new password.
+     *
+     * @returns No value after console output.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.updatePassword('preview-only');
+     * ```
      */
     updatePassword(_password: string): Promise<void>;
     /**
-     * 現在ログインしているユーザーを取得します。
-     * @returns ログインユーザー、または未ログインの場合は null
+     * Reads the current in-memory display user.
+     *
+     *
+     * @returns Current user or null, returned by reference.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.getCurrentUser();
+     * ```
      */
     getCurrentUser(): Promise<User | null>;
     /**
-     * OAuthプロバイダーを使用したログイン処理をシミュレートします。
-     * @param provider OAuthプロバイダー名
-     * @returns ログインしたユーザー情報
+     * Creates a synthetic display user for an OAuth provider without contacting it.
+     *
+     * @param provider - Used in the synthetic ID, email and name.
+     *
+     * @returns Synthetic user after synchronous listener notification.
+     *
+     * @throws Rejects if a listener throws.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * await adapter.loginWithProvider('google');
+     * ```
      */
     loginWithProvider(provider: OAuthProvider): Promise<User>;
     /**
-     * 認証状態の変更イベントリスナーを登録します。
-     * @param callback 認証状態変更時に呼び出される関数
-     * @returns リスナーを解除するためのクリーンアップ関数
+     * Registers a synchronous listener and immediately calls it with the current user.
+     *
+     * @param callback - Receives the current user or null on registration and each mutation.
+     *
+     * @returns Cleanup removing this callback from the listener list.
+     *
+     * @throws Callback errors propagate; a failed initial callback is already registered.
+     *
+     * @example
+     * ```ts
+     * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';
+     * const adapter = new MockAuthAdapter();
+     * const stop = adapter.onAuthStateChanged(user => { console.log(user?.id); });
+     * stop();
+     * ```
      */
     onAuthStateChanged(callback: (user: User | null) => void): () => void;
     private notifyListeners;

package/dist/tools/components/auth/adapters/mock-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock-adapter.js","names":["MockAuthAdapter","initialUser","password","data","email","provider","callback","l"],"sources":["../../../../../src/tools/components/auth/adapters/mock-adapter.ts"],"sourcesContent":["import { AuthAdapter, OAuthProvider, User } from '../types';\n\n/**\n * テストおよび開発用のモック認証アダプター\n * 認証プロバイダーと通信することなく、メモリ上の状態のみで認証機能をシミュレートします。\n */\nexport class MockAuthAdapter implements AuthAdapter {\n  private currentUser: User | null = null;\n  private listeners: ((user: User | null) => void)[] = [];\n\n  /**\n   * MockAuthAdapter インスタンスを初期化します。\n   * @param initialUser 初期状態のユーザー情報\n   */\n  constructor(initialUser: User | null = null) {\n    this.currentUser = initialUser;\n  }\n\n  /**\n   * メールアドレスとパスワードによるログイン処理をシミュレートします。\n   * @param email メールアドレス\n   * @param password パスワード（\"error\" の場合は失敗します）\n   * @returns ログインしたユーザー情報\n   */\n  async login(email: string, password: string): Promise<User> {\n    if (password === 'error') throw new Error('Invalid credentials');\n    this.currentUser = { id: '1', email, name: 'Mock User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * 新規ユーザー登録処理をシミュレートします。\n   * @param email メールアドレス\n   * @param _password パスワード\n   * @param data 追加のユーザー情報（氏名など）\n   * @returns 登録されたユーザー情報\n   */\n  async register(email: string, _password: string, data?: { name?: string }): Promise<User> {\n    this.currentUser = { id: '2', email, name: data?.name || 'New User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * ログアウト処理をシミュレートします。現在のユーザー状態をクリアします。\n   */\n  async logout(): Promise<void> {\n    this.currentUser = null;\n    this.notifyListeners();\n  }\n\n  /**\n   * パスワードリセット処理をシミュレートします。\n   * @param email メールアドレス\n   */\n  async resetPassword(email: string): Promise<void> {\n    console.log(`Reset password for ${email}`);\n  }\n\n  /**\n   * ユーザーのメールアドレス変更処理をシミュレートします。\n   * @param email 新しいメールアドレス\n   */\n  async updateEmail(email: string): Promise<void> {\n    if (this.currentUser) {\n      this.currentUser = { ...this.currentUser, email };\n      this.notifyListeners();\n    }\n  }\n\n  /**\n   * ユーザーのパスワード変更処理をシミュレートします。\n   * @param _password 新しいパスワード\n   */\n  async updatePassword(_password: string): Promise<void> {\n    console.log('Password updated');\n  }\n\n  /**\n   * 現在ログインしているユーザーを取得します。\n   * @returns ログインユーザー、または未ログインの場合は null\n   */\n  async getCurrentUser(): Promise<User | null> {\n    return this.currentUser;\n  }\n\n  /**\n   * OAuthプロバイダーを使用したログイン処理をシミュレートします。\n   * @param provider OAuthプロバイダー名\n   * @returns ログインしたユーザー情報\n   */\n  async loginWithProvider(provider: OAuthProvider): Promise<User> {\n    this.currentUser = {\n      id: `${provider}-1`,\n      email: `${provider}@example.com`,\n      name: `${provider} User`,\n    };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * 認証状態の変更イベントリスナーを登録します。\n   * @param callback 認証状態変更時に呼び出される関数\n   * @returns リスナーを解除するためのクリーンアップ関数\n   */\n  onAuthStateChanged(callback: (user: User | null) => void): () => void {\n    this.listeners.push(callback);\n    callback(this.currentUser);\n    return () => {\n      this.listeners = this.listeners.filter((l) => l !== callback);\n    };\n  }\n\n  private notifyListeners() {\n    this.listeners.forEach((l) => l(this.currentUser));\n  }\n}\n"],"mappings":";;AAMA,IAAaA,IAAb,MAAoD;CAClD,cAAmC;CACnC,YAAqD,CAAC;CAMtD,YAAY,IAA2B,MAAM;EAC3C,KAAK,cAAcC;CACrB;CAQA,MAAM,MAAM,GAAe,GAAiC;EAC1D,IAAIC,MAAa,SAAS,MAAU,MAAM,qBAAqB;EAG/D,OAFA,KAAK,cAAc;GAAE,IAAI;GAAK;GAAO,MAAM;EAAY,GACvD,KAAK,gBAAgB,GACd,KAAK;CACd;CASA,MAAM,SAAS,GAAe,GAAmB,GAAyC;EAGxF,OAFA,KAAK,cAAc;GAAE,IAAI;GAAK;GAAO,MAAMC,GAAM,QAAQ;EAAW,GACpE,KAAK,gBAAgB,GACd,KAAK;CACd;CAKA,MAAM,SAAwB;EAE5B,AADA,KAAK,cAAc,MACnB,KAAK,gBAAgB;CACvB;CAMA,MAAM,cAAc,GAA8B;EAChD,QAAQ,IAAI,sBAAsBC,GAAO;CAC3C;CAMA,MAAM,YAAY,GAA8B;EAC9C,AAAI,KAAK,gBACP,KAAK,cAAc;GAAE,GAAG,KAAK;GAAa;EAAM,GAChD,KAAK,gBAAgB;CAEzB;CAMA,MAAM,eAAe,GAAkC;EACrD,QAAQ,IAAI,kBAAkB;CAChC;CAMA,MAAM,iBAAuC;EAC3C,OAAO,KAAK;CACd;CAOA,MAAM,kBAAkB,GAAwC;EAO9D,OANA,KAAK,cAAc;GACjB,IAAI,GAAGC,EAAS;GAChB,OAAO,GAAGA,EAAS;GACnB,MAAM,GAAGA,EAAS;EACpB,GACA,KAAK,gBAAgB,GACd,KAAK;CACd;CAOA,mBAAmB,GAAmD;EAGpE,OAFA,KAAK,UAAU,KAAKC,CAAQ,GAC5BA,EAAS,KAAK,WAAW,SACZ;GACX,KAAK,YAAY,KAAK,UAAU,QAAQ,MAAMC,MAAMD,CAAQ;EAC9D;CACF;CAEA,kBAA0B;EACxB,KAAK,UAAU,SAAS,MAAMC,EAAE,KAAK,WAAW,CAAC;CACnD;AACF"}
+{"version":3,"file":"mock-adapter.js","names":["MockAuthAdapter","initialUser","password","data","email","provider","callback","l"],"sources":["../../../../../src/tools/components/auth/adapters/mock-adapter.ts"],"sourcesContent":["import { AuthAdapter, OAuthProvider, User } from '../types';\n\n/**\n * Simulates authentication in memory for tests and isolated development previews.\n *\n * @remarks Never authenticates a backend, verifies a password or persists state. Listener\n * callbacks run synchronously and may throw. Use a real host adapter for production.\n *\n * @example\n * ```ts\n * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n * const adapter = new MockAuthAdapter();\n * const user = await adapter.login('preview@example.com', 'preview-only');\n * await adapter.logout();\n * ```\n */\nexport class MockAuthAdapter implements AuthAdapter {\n  private currentUser: User | null = null;\n  private listeners: ((user: User | null) => void)[] = [];\n\n  /**\n   * Creates an isolated in-memory authentication fixture.\n   *\n   * @param initialUser - Initial display user, default null.\n   *\n   * @see MockAuthAdapter for a complete preview-only example.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter({ id: 'preview-1', email: 'preview@example.com' });\n   * ```\n   */\n  constructor(initialUser: User | null = null) {\n    this.currentUser = initialUser;\n  }\n\n  /**\n   * Simulates email login with a fixed user ID of 1.\n   *\n   * @param email - Display email.\n   *\n   * @param password - Only the literal error triggers invalid-credentials rejection.\n   *\n   * @returns Mock user after synchronous listener notification.\n   *\n   * @throws Rejects for password error or a throwing listener.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.login('preview@example.com', 'preview-only');\n   * ```\n   */\n  async login(email: string, password: string): Promise<User> {\n    if (password === 'error') throw new Error('Invalid credentials');\n    this.currentUser = { id: '1', email, name: 'Mock User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * Simulates registration with fixed user ID 2.\n   *\n   * @param email - Display email.\n   *\n   * @param _password - Ignored; no credentials are stored.\n   *\n   * @param data - Optional name; empty/omitted uses New User.\n   *\n   * @returns Mock user after synchronous listener notification.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.register('preview@example.com', 'preview-only', { name: 'Preview' });\n   * ```\n   */\n  async register(email: string, _password: string, data?: {\n    /** Optional display name; omission/empty uses New User. */\n    name?: string;\n  }): Promise<User> {\n    this.currentUser = { id: '2', email, name: data?.name || 'New User' };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * Clears the in-memory user and synchronously notifies listeners.\n   *\n   *\n   * @returns No value after notification.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.logout();\n   * ```\n   */\n  async logout(): Promise<void> {\n    this.currentUser = null;\n    this.notifyListeners();\n  }\n\n  /**\n   * Logs a reset request without sending email.\n   *\n   * @param email - Email included in console output.\n   *\n   * @returns No value; no reset token or email is created.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.resetPassword('preview@example.com');\n   * ```\n   */\n  async resetPassword(email: string): Promise<void> {\n    console.log(`Reset password for ${email}`);\n  }\n\n  /**\n   * Changes the current mock user email when a user exists.\n   *\n   * @param email - Replacement display email.\n   *\n   * @returns No value; without a current user the operation does nothing.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.updateEmail('new@example.com');\n   * ```\n   */\n  async updateEmail(email: string): Promise<void> {\n    if (this.currentUser) {\n      this.currentUser = { ...this.currentUser, email };\n      this.notifyListeners();\n    }\n  }\n\n  /**\n   * Logs a password update without checking or storing credentials.\n   *\n   * @param _password - Ignored new password.\n   *\n   * @returns No value after console output.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.updatePassword('preview-only');\n   * ```\n   */\n  async updatePassword(_password: string): Promise<void> {\n    console.log('Password updated');\n  }\n\n  /**\n   * Reads the current in-memory display user.\n   *\n   *\n   * @returns Current user or null, returned by reference.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.getCurrentUser();\n   * ```\n   */\n  async getCurrentUser(): Promise<User | null> {\n    return this.currentUser;\n  }\n\n  /**\n   * Creates a synthetic display user for an OAuth provider without contacting it.\n   *\n   * @param provider - Used in the synthetic ID, email and name.\n   *\n   * @returns Synthetic user after synchronous listener notification.\n   *\n   * @throws Rejects if a listener throws.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * await adapter.loginWithProvider('google');\n   * ```\n   */\n  async loginWithProvider(provider: OAuthProvider): Promise<User> {\n    this.currentUser = {\n      id: `${provider}-1`,\n      email: `${provider}@example.com`,\n      name: `${provider} User`,\n    };\n    this.notifyListeners();\n    return this.currentUser;\n  }\n\n  /**\n   * Registers a synchronous listener and immediately calls it with the current user.\n   *\n   * @param callback - Receives the current user or null on registration and each mutation.\n   *\n   * @returns Cleanup removing this callback from the listener list.\n   *\n   * @throws Callback errors propagate; a failed initial callback is already registered.\n   *\n   * @example\n   * ```ts\n   * import { MockAuthAdapter } from '@alneas/appkit-react/tools/auth';\n   * const adapter = new MockAuthAdapter();\n   * const stop = adapter.onAuthStateChanged(user => { console.log(user?.id); });\n   * stop();\n   * ```\n   */\n  onAuthStateChanged(callback: (user: User | null) => void): () => void {\n    this.listeners.push(callback);\n    callback(this.currentUser);\n    return () => {\n      this.listeners = this.listeners.filter((l) => l !== callback);\n    };\n  }\n\n  private notifyListeners() {\n    this.listeners.forEach((l) => l(this.currentUser));\n  }\n}\n"],"mappings":";;AAgBA,IAAaA,IAAb,MAAoD;CAClD,cAAmC;CACnC,YAAqD,CAAC;CAetD,YAAY,IAA2B,MAAM;EAC3C,KAAK,cAAcC;CACrB;CAoBA,MAAM,MAAM,GAAe,GAAiC;EAC1D,IAAIC,MAAa,SAAS,MAAU,MAAM,qBAAqB;EAG/D,OAFA,KAAK,cAAc;GAAE,IAAI;GAAK;GAAO,MAAM;EAAY,GACvD,KAAK,gBAAgB,GACd,KAAK;CACd;CAsBA,MAAM,SAAS,GAAe,GAAmB,GAG/B;EAGhB,OAFA,KAAK,cAAc;GAAE,IAAI;GAAK;GAAO,MAAMC,GAAM,QAAQ;EAAW,GACpE,KAAK,gBAAgB,GACd,KAAK;CACd;CAiBA,MAAM,SAAwB;EAE5B,AADA,KAAK,cAAc,MACnB,KAAK,gBAAgB;CACvB;CAgBA,MAAM,cAAc,GAA8B;EAChD,QAAQ,IAAI,sBAAsBC,GAAO;CAC3C;CAkBA,MAAM,YAAY,GAA8B;EAC9C,AAAI,KAAK,gBACP,KAAK,cAAc;GAAE,GAAG,KAAK;GAAa;EAAM,GAChD,KAAK,gBAAgB;CAEzB;CAgBA,MAAM,eAAe,GAAkC;EACrD,QAAQ,IAAI,kBAAkB;CAChC;CAeA,MAAM,iBAAuC;EAC3C,OAAO,KAAK;CACd;CAkBA,MAAM,kBAAkB,GAAwC;EAO9D,OANA,KAAK,cAAc;GACjB,IAAI,GAAGC,EAAS;GAChB,OAAO,GAAGA,EAAS;GACnB,MAAM,GAAGA,EAAS;EACpB,GACA,KAAK,gBAAgB,GACd,KAAK;CACd;CAmBA,mBAAmB,GAAmD;EAGpE,OAFA,KAAK,UAAU,KAAKC,CAAQ,GAC5BA,EAAS,KAAK,WAAW,SACZ;GACX,KAAK,YAAY,KAAK,UAAU,QAAQ,MAAMC,MAAMD,CAAQ;EAC9D;CACF;CAEA,kBAA0B;EACxB,KAAK,UAAU,SAAS,MAAMC,EAAE,KAAK,WAAW,CAAC;CACnD;AACF"}