@choiceform/shared-auth 0.1.1 → 0.1.3

package/README.md

@@ -14,6 +14,7 @@
 - ✅ 预配置的 API 客户端（自动添加认证头）
 - ✅ 用户管理器工具
 - ✅ 响应式状态管理（基于 Legend State）
+- ✅ 自动伴生团队设置（登录时自动获取并设置活动组织和团队）
 
 ## 安装
 
@@ -32,6 +33,15 @@ VITE_AUTH_API_URL=http://localhost:4320
 
 **注意：** 如果你的项目仍在使用 `VITE_CORE_AI_API_URL`，代码会自动向后兼容，但建议迁移到新的 `VITE_AUTH_API_URL`。
 
+### 伴生团队功能
+
+`AuthSync` 组件会在用户登录成功后自动：
+1. 从 OneAuth API 获取用户的组织信息
+2. 设置活动组织
+3. 设置活动团队（如果存在）
+
+此功能需要 `VITE_AUTH_API_URL` 环境变量已配置。如果未配置，功能会静默跳过，不影响登录流程。
+
 ## 快速开始
 
 ### 1. 初始化认证系统
@@ -155,6 +165,21 @@ function LoginPage() {
 - `apiClient`: 预配置的 API 客户端（包含 get/post/put/delete 方法）
 - `userManager`: 用户管理器（包含 getUser/getUserId 方法）
 
+### `AuthSync`
+
+Better Auth 认证状态同步组件。
+
+**功能：**
+- 同步 better-auth 的 session 状态到应用 store
+- 在用户登录成功后自动设置伴生团队（活动组织和团队）
+- 使用响应式状态监听，确保状态同步的实时性
+
+**Props：**
+
+- `auth`: AuthInstance
+
+**注意：** 此组件需要在应用的根组件中渲染，通常与 `ProtectedRoute` 一起使用。
+
 ### `ProtectedRoute`
 
 路由保护组件。
@@ -447,6 +472,32 @@ A: `apiClient` 会自动处理 401 响应，当检测到未授权时会调用 `h
 
 A: 可以使用 `createAuth` 替代 `initAuth`，它提供更多配置选项，包括自定义回调 URL 构建函数等。
 
+### Q: 伴生团队功能是什么？
+
+A: 在用户登录成功后，`AuthSync` 组件会自动：
+- 从 OneAuth API (`/v1/organizations/me`) 获取用户的组织信息
+- 调用 better-auth API 设置活动组织 (`/v1/auth/organization/set-active`)
+- 调用 better-auth API 设置活动团队 (`/v1/auth/organization/set-active-team`)
+
+这确保了用户在登录后拥有正确的权限上下文。如果此功能失败，不会影响登录流程，只会在控制台记录错误信息。
+
+### Q: 如何禁用伴生团队功能？
+
+A: 不配置 `VITE_AUTH_API_URL` 环境变量即可。功能会静默跳过。
+
+## 更新日志
+
+### v0.1.2
+
+- ✨ 新增：登录时自动获取并设置伴生团队功能
+- 🔧 改进：优化错误处理和边缘情况处理
+- 📝 改进：完善代码文档和注释
+- 🐛 修复：修复 token 编码问题，确保 API 调用正常工作
+
+### v0.1.1
+
+- 初始版本
+
 ## 许可证
 
 MIT

package/dist/components/auth-sync.d.ts

@@ -1,7 +1,23 @@
 import type { AuthInstance } from "../core";
 /**
  * Better Auth 认证状态同步组件
- * 使用官方的 useSession hook 同步认证状态
+ *
+ * 功能说明：
+ * - 使用 better-auth 的 useSession hook 同步认证状态到 Legend State
+ * - 监听 authStore 状态，在用户登录成功后自动设置组织/团队上下文
+ * - 确保登录流程的完整性和权限上下文的正确性
+ *
+ * 技术实现：
+ * - 使用 Legend State 的 use$ hook 响应式监听状态变化
+ * - 使用 useRef 确保组织/团队设置只执行一次
+ * - 使用 useCallback 缓存映射函数，避免不必要的重渲染
+ * - 分离 session 同步和团队设置的逻辑，保持代码清晰
+ *
+ * 边缘情况处理：
+ * - Session 加载中：设置 loading 状态
+ * - Session 错误：清空用户信息，重置团队设置状态
+ * - 无 Session 但有用户：保持用户信息（可能从 token 加载）
+ * - 用户登出：重置团队设置状态，允许下次登录时重新设置
  */
 export declare function AuthSync({ auth }: {
     auth: AuthInstance;

package/dist/components/auth-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-sync.d.ts","sourceRoot":"","sources":["../../src/components/auth-sync.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AA8C3C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,QA8BxD"}
+{"version":3,"file":"auth-sync.d.ts","sourceRoot":"","sources":["../../src/components/auth-sync.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAuS3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,QA0FxD"}

package/dist/components/auth-sync.js

@@ -1,4 +1,5 @@
-import { useEffect } from "react";
+import { useEffect, useRef, useCallback } from "react";
+import { use$ } from "@legendapp/state/react";
 /**
  * 将日期转换为 ISO 字符串
  */
@@ -10,7 +11,7 @@ function toISOString(date) {
 /**
  * 将 Better Auth session 用户数据映射为 SessionUser
  */
-function mapSessionUserToSessionUser(sessionUser, sessionCreatedAt) {
+function mapSessionUserToSessionUser(sessionUser, sessionData) {
     return {
         banExpires: sessionUser.banExpires,
         banReason: sessionUser.banReason,
@@ -20,41 +21,328 @@ function mapSessionUserToSessionUser(sessionUser, sessionCreatedAt) {
         emailVerified: sessionUser.emailVerified,
         id: sessionUser.id,
         image: sessionUser.image || undefined,
-        lastLoginAt: toISOString(sessionCreatedAt),
+        lastLoginAt: toISOString(sessionData?.createdAt),
         name: sessionUser.name,
         role: sessionUser.role,
         updatedAt: toISOString(sessionUser.updatedAt) ?? "",
+        activeOrganizationId: sessionData?.activeOrganizationId,
+        activeTeamId: sessionData?.activeTeamId,
     };
 }
+/**
+ * 检查是否为开发环境
+ */
+const isDev = import.meta.env?.DEV ?? false;
+/**
+ * 安全获取环境变量
+ */
+function getEnvVar(key) {
+    return import.meta.env?.[key];
+}
+/**
+ * 解析 API 错误响应
+ */
+async function parseErrorResponse(response) {
+    try {
+        const text = await response.text();
+        if (text) {
+            try {
+                const json = JSON.parse(text);
+                if (typeof json === "object" && json !== null) {
+                    const data = json;
+                    if (typeof data.error === "object" && data.error !== null) {
+                        const errorObj = data.error;
+                        if (typeof errorObj.message === "string") {
+                            return errorObj.message;
+                        }
+                    }
+                    else if (typeof data.message === "string") {
+                        return data.message;
+                    }
+                }
+            }
+            catch {
+                // 如果不是 JSON，返回原始文本（限制长度）
+                return text.length < 200 ? text : `${text.substring(0, 200)}...`;
+            }
+        }
+    }
+    catch {
+        // 忽略解析错误
+    }
+    return `HTTP ${response.status}: ${response.statusText}`;
+}
+/**
+ * 获取或创建伴生团队
+ *
+ * 功能说明：
+ * - 在用户登录成功后自动获取组织信息
+ * - 设置活动组织和团队，确保用户拥有正确的权限上下文
+ * - 使用 fetch API 直接调用 oneauth 和 better-auth 的 API
+ * - 所有错误都会被捕获，不会影响登录流程
+ *
+ * 边缘情况处理：
+ * - 环境变量未配置：静默跳过
+ * - Token 缺失：静默跳过
+ * - 网络错误：记录错误但不抛出
+ * - API 返回错误：记录详细错误信息
+ * - 无效响应数据：记录错误但不影响登录
+ */
+async function setupCompanionTeam(auth, token, refetchSession) {
+    try {
+        // 1. 验证环境变量配置
+        const oneAuthBaseUrl = getEnvVar("VITE_AUTH_API_URL") || getEnvVar("VITE_CORE_AI_API_URL");
+        if (!oneAuthBaseUrl) {
+            if (isDev) {
+                console.warn("[AuthSync] VITE_AUTH_API_URL is not configured, skipping companion team setup");
+            }
+            return;
+        }
+        // 2. 验证 token
+        if (!token || typeof token !== "string" || token.trim().length === 0) {
+            if (isDev) {
+                console.warn("[AuthSync] Token is missing or invalid, skipping companion team setup");
+            }
+            return;
+        }
+        // 3. 获取 token（优先使用 oneauth_token，如果没有则使用传入的 token）
+        const oneAuthTokenFromStorage = localStorage.getItem("oneauth_token");
+        const oneAuthToken = oneAuthTokenFromStorage ?? token;
+        if (!oneAuthToken || oneAuthToken.trim().length === 0) {
+            if (isDev) {
+                console.warn("[AuthSync] No valid token available, skipping companion team setup");
+            }
+            return;
+        }
+        // 4. Token 编码（与 fetchSessionWithToken 保持一致）
+        const encodedToken = encodeURIComponent(oneAuthToken);
+        // 5. 获取组织信息
+        const myOrganizationUrl = `${oneAuthBaseUrl}/v1/organizations/me`;
+        if (isDev) {
+            console.log("[AuthSync] Fetching organization from:", myOrganizationUrl);
+        }
+        const orgResponse = await fetch(myOrganizationUrl, {
+            headers: {
+                Authorization: `Bearer ${encodedToken}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!orgResponse.ok) {
+            const errorMessage = await parseErrorResponse(orgResponse);
+            throw new Error(`Failed to fetch organization: ${errorMessage}`);
+        }
+        // 6. 解析组织数据
+        let orgResponseData;
+        try {
+            orgResponseData = await orgResponse.json();
+        }
+        catch (parseError) {
+            throw new Error(`Failed to parse organization response: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+        }
+        // 7. 提取组织对象（支持 {data: {...}} 或直接是组织对象）
+        const organization = orgResponseData?.data ||
+            orgResponseData;
+        // 8. 验证组织数据
+        if (!organization || typeof organization !== "object" || !organization.id || typeof organization.id !== "string") {
+            throw new Error(`Invalid organization data received: missing or invalid organization ID`);
+        }
+        // 9. 获取 auth baseURL
+        const authBaseURL = getEnvVar("VITE_AUTH_API_URL") ||
+            getEnvVar("VITE_CORE_AI_API_URL") ||
+            "http://localhost:4320";
+        // 10. 设置活动组织
+        const setActiveOrgUrl = `${authBaseURL}/v1/auth/organization/set-active`;
+        if (isDev) {
+            console.log("[AuthSync] Setting active organization:", { organizationId: organization.id });
+        }
+        const setActiveOrgResponse = await fetch(setActiveOrgUrl, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${encodedToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ organizationId: organization.id }),
+        });
+        if (!setActiveOrgResponse.ok) {
+            const errorMessage = await parseErrorResponse(setActiveOrgResponse);
+            throw new Error(`Failed to set active organization: ${errorMessage}`);
+        }
+        // 11. 设置活动团队（如果有团队）
+        if (organization.teams && Array.isArray(organization.teams) && organization.teams.length > 0) {
+            const firstTeam = organization.teams[0];
+            if (firstTeam && firstTeam.id && typeof firstTeam.id === "string") {
+                const setActiveTeamUrl = `${authBaseURL}/v1/auth/organization/set-active-team`;
+                if (isDev) {
+                    console.log("[AuthSync] Setting active team:", { teamId: firstTeam.id });
+                }
+                const setActiveTeamResponse = await fetch(setActiveTeamUrl, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${encodedToken}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({ teamId: firstTeam.id }),
+                });
+                if (!setActiveTeamResponse.ok) {
+                    const errorMessage = await parseErrorResponse(setActiveTeamResponse);
+                    throw new Error(`Failed to set active team: ${errorMessage}`);
+                }
+                if (isDev) {
+                    console.log("[AuthSync] Successfully set active team");
+                }
+                // 刷新 session 并更新 authStore
+                if (refetchSession) {
+                    refetchSession();
+                }
+                // 使用 fetch 直接调用 get-session 获取最新数据
+                try {
+                    const getSessionUrl = `${authBaseURL}/v1/auth/get-session`;
+                    const sessionResponse = await fetch(getSessionUrl, {
+                        headers: {
+                            Authorization: `Bearer ${encodedToken}`,
+                            "Content-Type": "application/json",
+                        },
+                    });
+                    if (sessionResponse.ok) {
+                        const sessionData = await sessionResponse.json();
+                        const data = sessionData;
+                        if (data.user && data.session) {
+                            const currentUser = auth.authStore.user.get();
+                            if (currentUser) {
+                                auth.authStore.user.set({
+                                    ...currentUser,
+                                    activeOrganizationId: data.session.activeOrganizationId,
+                                    activeTeamId: data.session.activeTeamId,
+                                });
+                                if (isDev) {
+                                    console.log("[AuthSync] Updated authStore with activeOrganizationId and activeTeamId");
+                                }
+                            }
+                        }
+                    }
+                }
+                catch (err) {
+                    if (isDev) {
+                        console.error("[AuthSync] Failed to refresh session:", err);
+                    }
+                }
+            }
+            else if (isDev) {
+                console.warn("[AuthSync] First team has invalid ID, skipping team setup");
+            }
+        }
+        else if (isDev) {
+            console.log("[AuthSync] No teams found in organization");
+        }
+    }
+    catch (error) {
+        // 记录错误但不抛出，避免影响登录流程
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error("[AuthSync] Failed to setup companion team:", errorMessage);
+        // 在开发环境下输出更详细的错误信息
+        if (isDev && error instanceof Error) {
+            console.error("[AuthSync] Error details:", {
+                message: error.message,
+                stack: error.stack,
+            });
+        }
+    }
+}
 /**
  * Better Auth 认证状态同步组件
- * 使用官方的 useSession hook 同步认证状态
+ *
+ * 功能说明：
+ * - 使用 better-auth 的 useSession hook 同步认证状态到 Legend State
+ * - 监听 authStore 状态，在用户登录成功后自动设置组织/团队上下文
+ * - 确保登录流程的完整性和权限上下文的正确性
+ *
+ * 技术实现：
+ * - 使用 Legend State 的 use$ hook 响应式监听状态变化
+ * - 使用 useRef 确保组织/团队设置只执行一次
+ * - 使用 useCallback 缓存映射函数，避免不必要的重渲染
+ * - 分离 session 同步和团队设置的逻辑，保持代码清晰
+ *
+ * 边缘情况处理：
+ * - Session 加载中：设置 loading 状态
+ * - Session 错误：清空用户信息，重置团队设置状态
+ * - 无 Session 但有用户：保持用户信息（可能从 token 加载）
+ * - 用户登出：重置团队设置状态，允许下次登录时重新设置
  */
 export function AuthSync({ auth }) {
-    const { authClient, authActions } = auth;
-    const { data: session, isPending, error } = authClient.useSession();
+    const { authClient, authActions, tokenStorage, authStore } = auth;
+    // 监听 authStore 中的用户状态（响应式）
+    const user = use$(authStore.user);
+    const isAuthenticated = use$(authStore.isAuthenticated);
+    const isLoaded = use$(authStore.isLoaded);
+    // 监听 better-auth 的 session（用于同步到 store）
+    const sessionResult = authClient.useSession();
+    const { data: session, isPending, error, refetch } = sessionResult || {
+        data: null,
+        isPending: false,
+        error: null,
+        refetch: undefined,
+    };
+    // 使用 ref 确保组织/团队设置只执行一次
+    const teamSetupRef = useRef(false);
+    // 使用 useCallback 缓存 session 映射逻辑，避免不必要的重计算
+    const handleSessionUpdate = useCallback((sessionData) => {
+        if (sessionData?.user) {
+            try {
+                const mappedUser = mapSessionUserToSessionUser(sessionData.user, sessionData.session);
+                authActions.initialize(mappedUser, true);
+            }
+            catch (mappingError) {
+                console.error("[AuthSync] Failed to map session user:", mappingError);
+                // 映射失败时不清空用户信息，可能已有有效的用户数据
+            }
+        }
+    }, [authActions]);
+    // Effect 1: 同步 better-auth session 到 store
     useEffect(() => {
-        // 根据 session 状态更新 store
+        // 加载中状态
         if (isPending) {
             authActions.setLoading(true);
+            return;
         }
-        else {
-            authActions.setLoading(false);
-            if (error) {
-                authActions.setError(error.message || "Authentication error");
-                authActions.initialize(null, true);
-            }
-            else if (session) {
-                // 映射用户数据：使用 session 的创建时间作为最后登录时间
-                const user = mapSessionUserToSessionUser(session.user, session.session?.createdAt);
-                authActions.initialize(user, true);
+        authActions.setLoading(false);
+        // 错误处理
+        if (error) {
+            const errorMessage = error instanceof Error ? error.message : typeof error === "string" ? error : "Authentication error";
+            authActions.setError(errorMessage);
+            authActions.initialize(null, true);
+            teamSetupRef.current = false;
+            return;
+        }
+        // Session 存在：映射用户数据并更新 store
+        if (session) {
+            handleSessionUpdate(session);
+        }
+        // 注意：没有 session 时不主动清空用户信息，因为可能已经从 token 加载了
+    }, [session, isPending, error, authActions, handleSessionUpdate]);
+    // Effect 2: 监听 authStore 状态，设置伴生团队
+    useEffect(() => {
+        // 条件检查：只有在用户已认证且已加载完成时才设置伴生团队
+        if (isLoaded && isAuthenticated && user?.id && !teamSetupRef.current) {
+            teamSetupRef.current = true;
+            const token = tokenStorage.get();
+            // 验证 token 存在
+            if (token && typeof token === "string" && token.trim().length > 0) {
+                setupCompanionTeam(auth, token, refetch).catch((error) => {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    console.error("[AuthSync] Failed to setup companion team:", errorMessage);
+                    // 失败后重置 ref，允许在特定条件下重试（如 token 更新后）
+                    teamSetupRef.current = false;
+                });
             }
-            else {
-                // 没有 session，清空用户信息
-                authActions.initialize(null, true);
+            else if (isDev) {
+                console.warn("[AuthSync] Token not found or invalid, cannot setup companion team");
             }
         }
-    }, [session, isPending, error, authActions]);
+        // 用户登出：重置 ref，允许下次登录时重新设置
+        if (isLoaded && !isAuthenticated) {
+            teamSetupRef.current = false;
+        }
+    }, [user, isAuthenticated, isLoaded, auth, tokenStorage, refetch]);
     // 这是一个隐形组件，不渲染任何内容
     return null;
 }

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}

package/dist/core.js

@@ -7,7 +7,7 @@ import { createBoundAuthUtils } from "./store/utils";
  * 创建认证系统实例
  */
 export function createAuth(config) {
-    // 创建 auth client
+    // 创建 auth client (传递 tokenStorageKey 以支持 bearer token 认证)
     const authClient = createAuthClientFromConfig(config);
     // 创建 store
     const { authStore, tokenStorage } = createAuthStore({

package/dist/lib/auth-client.d.ts

@@ -1,6 +1,14 @@
 import type { AuthConfig } from "../config";
 /**
  * 创建 Better Auth 客户端
+ *
+ * 配置说明：
+ * - 使用 Bearer Token 认证模式
+ * - Token 从 localStorage 中动态读取
+ * - 支持服务器端 Bearer Plugin 的 session 管理
+ *
+ * @param config - 认证配置对象
+ * @returns Better Auth 客户端实例
  */
 export declare function createAuthClientFromConfig(config: AuthConfig): {
     signIn: {

package/dist/lib/auth-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../src/lib/auth-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;6BAS+xgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAwz0W,CAAC;+BAAyD,CAAC;gCAA0D,CAAC;6BAAuD,CAAC;;;;;;;;;;;;;;;;;;;;;;;qBAA9K,CAAC;2BAAyD,CAAC;4BAA0D,CAAC;yBAAuD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAv+0W,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;qBAAoh0e,CAAC;2BAAyD,CAAC;4BAA0D,CAAC;sBAAoD,CAAC;;;;;;;;;;;;;;;;;;;;;iBAA3K,CAAC;uBAAyD,CAAC;wBAA0D,CAAC;kBAAoD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAhs0e,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAjjb,CAAC;iBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAAogD,CAAC;;eAAsE,CAAC;;;;;aAAqW,CAAC;mBAA+C,CAAC;iBAAuC,CAAC;iBAAuC,CAAC;YAAmC,CAAC;gBAA2C,CAAC;gBAA+C,CAAC;sBAA4C,CAAC;cAA4C,CAAC;cAAkD,CAAC;eAAmC,CAAC;mBAA4G,CAAC;yBAA6B,CAAC;;eAAiD,CAAC;;;aAAqH,CAAC;YAAmC,CAAC;;;;;;;;;;;;YAA+iB,CAAC;aAAoB,CAAC;cAAqB,CAAC;cAAqB,CAAC;;aAAsG,CAAC;oBAAoE,CAAC;cAAoC,CAAC;mBAAqG,CAAC;yBAA6E,CAAC;;;uBAA0F,CAAC;+GAA6K,CAAC;;;;;;EAF3vN"}
+{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../src/lib/auth-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/auth-client.js

@@ -1,11 +1,39 @@
 import { createAuthClient } from "better-auth/react";
 /**
  * 创建 Better Auth 客户端
+ *
+ * 配置说明：
+ * - 使用 Bearer Token 认证模式
+ * - Token 从 localStorage 中动态读取
+ * - 支持服务器端 Bearer Plugin 的 session 管理
+ *
+ * @param config - 认证配置对象
+ * @returns Better Auth 客户端实例
  */
 export function createAuthClientFromConfig(config) {
-    const { baseURL, plugins = [] } = config;
+    const { baseURL, plugins = [], tokenStorageKey = "auth-token" } = config;
     return createAuthClient({
         baseURL: `${baseURL}/v1/auth`,
         plugins,
+        fetchOptions: {
+            auth: {
+                type: "Bearer",
+                token: () => {
+                    // 从 localStorage 获取存储的 bearer token
+                    // SSR 环境下 localStorage 不存在，返回空字符串
+                    if (typeof window === "undefined" || typeof localStorage === "undefined") {
+                        return "";
+                    }
+                    try {
+                        const token = localStorage.getItem(tokenStorageKey);
+                        return token || "";
+                    }
+                    catch {
+                        // localStorage 访问失败（如隐私模式），返回空字符串
+                        return "";
+                    }
+                }
+            }
+        }
     });
 }

package/dist/store/actions.d.ts

@@ -19,7 +19,15 @@ export declare function createAuthActions(authStore: Observable<AuthState>, toke
      */
     initialize(user: SessionUser | null, isLoaded: boolean): Promise<void>;
     /**
-     * 使用 token 获取 session
+     * 使用 Bearer Token 获取 session
+     *
+     * 流程：
+     * 1. 保存 token 到 localStorage
+     * 2. 使用 Bearer Token 请求 session endpoint
+     * 3. 解析响应数据并提取用户信息
+     * 4. 更新 authStore 状态
+     *
+     * @param token - Bearer Token
      */
     fetchSessionWithToken(token: string): Promise<void>;
     /**

package/dist/store/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/store/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAoD3C;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,EAChC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE;IACV,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KACjF,CAAA;IACD,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC;IAeC;;OAEG;qBACoB,WAAW,GAAG,IAAI,YAAY,OAAO;IAe5D;;OAEG;iCACgC,MAAM;IAuDzC;;;OAGG;;IAOH;;OAEG;wBACiB,OAAO;IAI3B;;OAEG;oBACa,MAAM,GAAG,IAAI;IAI7B;;;;;;OAMG;sBACoB,MAAM,eAA0B,MAAM;IAmC7D;;OAEG;;IAgCH;;OAEG;qBACc,WAAW,GAAG,IAAI;IAUnC;;OAEG;eACQ,WAAW,GAAG,IAAI;EAIhC;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/store/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAgE3C;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,EAChC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE;IACV,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KACjF,CAAA;IACD,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC;IAeC;;OAEG;qBACoB,WAAW,GAAG,IAAI,YAAY,OAAO;IAe5D;;;;;;;;;;OAUG;iCACgC,MAAM;IAuDzC;;;OAGG;;IAOH;;OAEG;wBACiB,OAAO;IAI3B;;OAEG;oBACa,MAAM,GAAG,IAAI;IAI7B;;;;;;OAMG;sBACoB,MAAM,eAA0B,MAAM;IAmC7D;;OAEG;;IAgCH;;OAEG;qBACc,WAAW,GAAG,IAAI;IAUnC;;OAEG;eACQ,WAAW,GAAG,IAAI;EAIhC;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA"}

package/dist/store/actions.js

@@ -8,14 +8,21 @@ function toISOString(date) {
 }
 /**
  * 从服务器响应中提取用户数据
- * 支持多种数据结构格式
+ *
+ * 支持多种数据结构格式以提供更好的兼容性：
+ * - 标准格式: { user: {...}, session: {...} }
+ * - 嵌套格式: { session: { user: {...} } }
+ * - 包装格式: { data: { user: {...} } }
+ * - 扁平格式: { id, email, ... }
+ *
+ * @param sessionData - 服务器返回的 session 数据
+ * @returns 映射后的 SessionUser 对象，失败返回 null
  */
 function extractUserData(sessionData) {
     if (!sessionData || typeof sessionData !== "object")
         return null;
     const data = sessionData;
     // 尝试从不同的数据结构中提取用户信息
-    // 优先使用标准格式：{session: {...}, user: {...}}
     const rawUserData = data.user || // 标准格式
         data.session?.user || // 嵌套格式
         data.data?.user || // 包装格式
@@ -23,10 +30,13 @@ function extractUserData(sessionData) {
     if (!rawUserData || typeof rawUserData !== "object")
         return null;
     const user = rawUserData;
-    // 提取 session 创建时间作为最后登录时间
-    const sessionCreatedAt = data.session?.createdAt
-        ? toISOString(data.session.createdAt)
+    // 提取 session 相关数据（activeOrganizationId 和 activeTeamId 存储在 session 中）
+    const sessionInfo = data.session;
+    const sessionCreatedAt = sessionInfo?.createdAt
+        ? toISOString(sessionInfo.createdAt)
         : undefined;
+    const activeOrganizationId = sessionInfo?.activeOrganizationId;
+    const activeTeamId = sessionInfo?.activeTeamId;
     return {
         banExpires: user.banExpires,
         banReason: user.banReason,
@@ -40,6 +50,8 @@ function extractUserData(sessionData) {
         name: user.name,
         role: user.role,
         updatedAt: toISOString(user.updatedAt) ?? "",
+        activeOrganizationId,
+        activeTeamId,
     };
 }
 /**
@@ -71,14 +83,22 @@ export function createAuthActions(authStore, tokenStorage, config, authClient) {
             authStore.loading.set(!isLoaded);
         },
         /**
-         * 使用 token 获取 session
+         * 使用 Bearer Token 获取 session
+         *
+         * 流程：
+         * 1. 保存 token 到 localStorage
+         * 2. 使用 Bearer Token 请求 session endpoint
+         * 3. 解析响应数据并提取用户信息
+         * 4. 更新 authStore 状态
+         *
+         * @param token - Bearer Token
          */
         async fetchSessionWithToken(token) {
             try {
                 if (!token) {
                     throw new Error("Token is required");
                 }
-                // 保存 token 到 localStorage
+                // 保存 token 到 localStorage（供 authClient 使用）
                 tokenStorage.save(token);
                 const endpoint = `${baseURL}${getSessionEndpoint}`;
                 const response = await fetch(endpoint, {
@@ -88,10 +108,10 @@ export function createAuthActions(authStore, tokenStorage, config, authClient) {
                         "Content-Type": "application/json",
                     },
                 });
-                const responseText = await response.text();
                 if (!response.ok) {
                     throw new Error(`Failed to fetch session: ${response.status}`);
                 }
+                const responseText = await response.text();
                 // 解析响应数据
                 let sessionData = null;
                 try {
@@ -100,7 +120,7 @@ export function createAuthActions(authStore, tokenStorage, config, authClient) {
                     }
                 }
                 catch (error) {
-                    console.error("Failed to parse session response:", error);
+                    console.error("[fetchSessionWithToken] Failed to parse session response:", error);
                     this.handleUnauthorized();
                     return;
                 }
@@ -113,12 +133,12 @@ export function createAuthActions(authStore, tokenStorage, config, authClient) {
                     authStore.loading.set(false);
                 }
                 else {
-                    console.error("Invalid session data received");
+                    console.error("[fetchSessionWithToken] Invalid session data received");
                     this.handleUnauthorized();
                 }
             }
             catch (error) {
-                console.error("Failed to fetch session:", error);
+                console.error("[fetchSessionWithToken] Failed to fetch session:", error);
                 this.handleUnauthorized();
             }
         },

package/dist/types.d.ts

@@ -1,37 +1,87 @@
 /**
  * 认证相关的类型定义
  */
+/**
+ * 会话用户信息
+ *
+ * 包含用户基本信息和当前活动的组织/团队上下文
+ */
 export type SessionUser = {
+    /** 当前活动的组织 ID */
+    activeOrganizationId?: string;
+    /** 当前活动的团队 ID */
+    activeTeamId?: string;
+    /** 禁用到期时间 */
     banExpires?: string;
+    /** 禁用原因 */
     banReason?: string;
+    /** 是否被禁用 */
     banned?: boolean;
+    /** 用户创建时间 */
     createdAt: string;
+    /** 用户邮箱 */
     email: string;
+    /** 邮箱是否已验证 */
     emailVerified: boolean;
+    /** 用户 ID */
     id: string;
+    /** 用户头像 URL */
     image?: string;
+    /** 最后登录时间 */
     lastLoginAt?: string;
+    /** 用户名称 */
     name: string;
+    /** 用户角色 */
     role?: string;
+    /** 用户信息更新时间 */
     updatedAt: string;
 };
+/**
+ * Better Auth Session 对象
+ *
+ * 包含会话信息和关联的用户数据
+ */
 export type Session = {
+    /** 当前活动的组织 ID（存储在 session 中） */
+    activeOrganizationId?: string;
+    /** 当前活动的团队 ID（存储在 session 中） */
+    activeTeamId?: string;
+    /** 会话创建时间 */
     createdAt: string;
+    /** 会话过期时间 */
     expiresAt: string;
+    /** 会话 ID */
     id: string;
+    /** 客户端 IP 地址 */
     ipAddress?: string;
+    /** 会话 Token */
     token: string;
+    /** 会话更新时间 */
     updatedAt: string;
+    /** 关联的用户信息 */
     user: SessionUser;
+    /** 客户端 User-Agent */
     userAgent?: string;
+    /** 用户 ID */
     userId: string;
 };
+/**
+ * 认证状态
+ *
+ * 存储在 Legend State 中的认证状态数据
+ */
 export interface AuthState {
+    /** 错误信息 */
     error: string | null;
+    /** 是否已认证 */
     isAuthenticated: boolean;
+    /** 是否已加载完成 */
     isLoaded: boolean;
+    /** 是否正在加载 */
     loading: boolean;
+    /** 认证 Token */
     token: string | null;
+    /** 当前用户信息 */
     user: SessionUser | null;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,OAAO,CAAA;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,iBAAiB;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,gCAAgC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,YAAY;IACZ,eAAe,EAAE,OAAO,CAAA;IACxB,cAAc;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,aAAa;IACb,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;CACzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@choiceform/shared-auth",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Shared authentication package for Choiceform projects",
   "type": "module",
   "main": "./dist/index.js",