@choiceform/shared-auth 0.1.0

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+import { createAuthClient } from "better-auth/react";
+/**
+ * 创建 Better Auth 客户端
+ */
+export function createAuthClientFromConfig(config) {
+    const { baseURL, plugins = [] } = config;
+    return createAuthClient({
+        baseURL: `${baseURL}/v1/auth`,
+        plugins,
+    });
+}

package/dist/store/actions.d.ts

@@ -0,0 +1,60 @@
+import type { Observable } from "@legendapp/state";
+import type { AuthState, SessionUser } from "../types";
+import type { AuthConfig } from "../config";
+import type { TokenStorage } from "./state";
+/**
+ * 创建认证 actions
+ */
+export declare function createAuthActions(authStore: Observable<AuthState>, tokenStorage: TokenStorage, config: AuthConfig, authClient: {
+    signIn: {
+        social: (options: {
+            callbackURL: string;
+            provider: string;
+        }) => Promise<unknown>;
+    };
+    signOut: () => Promise<unknown>;
+}): {
+    /**
+     * 初始化认证状态
+     */
+    initialize(user: SessionUser | null, isLoaded: boolean): Promise<void>;
+    /**
+     * 使用 token 获取 session
+     */
+    fetchSessionWithToken(token: string): Promise<void>;
+    /**
+     * 处理未授权错误（401 或其他认证失败）
+     * 清理所有认证状态和本地存储
+     */
+    handleUnauthorized(): void;
+    /**
+     * 设置加载状态
+     */
+    setLoading(loading: boolean): void;
+    /**
+     * 设置错误信息
+     */
+    setError(error: string | null): void;
+    /**
+     * 登录 - 使用 OAuth（默认 GitHub）
+     *
+     * @param provider OAuth 提供商，默认为 'github'
+     * @param redirectTo 登录成功后的重定向地址（完整 URL 或相对路径）
+     *                   如果未提供，将使用 defaultRedirectAfterLogin 配置
+     */
+    signIn(provider?: string, redirectTo?: string): Promise<void>;
+    /**
+     * 登出
+     */
+    signOut(): Promise<void>;
+    /**
+     * 更新用户信息
+     */
+    updateUser(user: SessionUser | null): void;
+    /**
+     * 获取当前用户
+     */
+    getUser(): SessionUser | null;
+};
+export type AuthActions = ReturnType<typeof createAuthActions>;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +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"}

package/dist/store/actions.js

@@ -0,0 +1,234 @@
+/**
+ * 将日期转换为 ISO 字符串
+ */
+function toISOString(date) {
+    if (!date)
+        return undefined;
+    return typeof date === "string" ? date : new Date(date).toISOString();
+}
+/**
+ * 从服务器响应中提取用户数据
+ * 支持多种数据结构格式
+ */
+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 || // 包装格式
+        (data.id && data.email ? data : null); // 扁平格式
+    if (!rawUserData || typeof rawUserData !== "object")
+        return null;
+    const user = rawUserData;
+    // 提取 session 创建时间作为最后登录时间
+    const sessionCreatedAt = data.session?.createdAt
+        ? toISOString(data.session.createdAt)
+        : undefined;
+    return {
+        banExpires: user.banExpires,
+        banReason: user.banReason,
+        banned: user.banned,
+        createdAt: toISOString(user.createdAt) ?? "",
+        email: user.email,
+        emailVerified: user.emailVerified ?? false,
+        id: user.id,
+        image: user.image || undefined,
+        lastLoginAt: sessionCreatedAt,
+        name: user.name,
+        role: user.role,
+        updatedAt: toISOString(user.updatedAt) ?? "",
+    };
+}
+/**
+ * 创建认证 actions
+ */
+export function createAuthActions(authStore, tokenStorage, config, authClient) {
+    const { baseURL, defaultRedirectAfterLogin = "/explore", signInPath = "/sign-in", getSessionEndpoint = "/v1/auth/get-session", callbackURLBuilder, } = config;
+    const buildCallbackURL = callbackURLBuilder || ((redirectTo, baseURL) => {
+        return `${baseURL}/v1/auth/redirect?to=${encodeURIComponent(redirectTo)}`;
+    });
+    return {
+        /**
+         * 初始化认证状态
+         */
+        async initialize(user, isLoaded) {
+            const storedToken = tokenStorage.get();
+            if (!user && storedToken) {
+                await this.fetchSessionWithToken(storedToken);
+            }
+            else if (user) {
+                authStore.user.set(user);
+                authStore.isAuthenticated.set(true);
+            }
+            else {
+                authStore.user.set(null);
+                authStore.isAuthenticated.set(false);
+            }
+            authStore.isLoaded.set(isLoaded);
+            authStore.loading.set(!isLoaded);
+        },
+        /**
+         * 使用 token 获取 session
+         */
+        async fetchSessionWithToken(token) {
+            try {
+                if (!token) {
+                    throw new Error("Token is required");
+                }
+                // 保存 token 到 localStorage
+                tokenStorage.save(token);
+                const endpoint = `${baseURL}${getSessionEndpoint}`;
+                const response = await fetch(endpoint, {
+                    method: "GET",
+                    headers: {
+                        Authorization: `Bearer ${encodeURIComponent(token)}`,
+                        "Content-Type": "application/json",
+                    },
+                });
+                const responseText = await response.text();
+                if (!response.ok) {
+                    throw new Error(`Failed to fetch session: ${response.status}`);
+                }
+                // 解析响应数据
+                let sessionData = null;
+                try {
+                    if (responseText && responseText !== "null" && responseText !== "") {
+                        sessionData = JSON.parse(responseText);
+                    }
+                }
+                catch (error) {
+                    console.error("Failed to parse session response:", error);
+                    this.handleUnauthorized();
+                    return;
+                }
+                // 提取并映射用户数据
+                const userData = extractUserData(sessionData);
+                if (userData) {
+                    authStore.user.set(userData);
+                    authStore.isAuthenticated.set(true);
+                    authStore.isLoaded.set(true);
+                    authStore.loading.set(false);
+                }
+                else {
+                    console.error("Invalid session data received");
+                    this.handleUnauthorized();
+                }
+            }
+            catch (error) {
+                console.error("Failed to fetch session:", error);
+                this.handleUnauthorized();
+            }
+        },
+        /**
+         * 处理未授权错误（401 或其他认证失败）
+         * 清理所有认证状态和本地存储
+         */
+        handleUnauthorized() {
+            authStore.user.set(null);
+            authStore.isAuthenticated.set(false);
+            tokenStorage.clear();
+        },
+        /**
+         * 设置加载状态
+         */
+        setLoading(loading) {
+            authStore.loading.set(loading);
+        },
+        /**
+         * 设置错误信息
+         */
+        setError(error) {
+            authStore.error.set(error);
+        },
+        /**
+         * 登录 - 使用 OAuth（默认 GitHub）
+         *
+         * @param provider OAuth 提供商，默认为 'github'
+         * @param redirectTo 登录成功后的重定向地址（完整 URL 或相对路径）
+         *                   如果未提供，将使用 defaultRedirectAfterLogin 配置
+         */
+        async signIn(provider = "github", redirectTo) {
+            // 防止重复点击
+            if (authStore.loading.get()) {
+                return;
+            }
+            try {
+                authStore.loading.set(true);
+                authStore.error.set(null);
+                if (!baseURL) {
+                    throw new Error("Auth baseURL is not configured");
+                }
+                // 构建重定向地址：相对路径自动添加 origin
+                const finalRedirectTo = redirectTo
+                    ? redirectTo.startsWith("http")
+                        ? redirectTo
+                        : `${window.location.origin}${redirectTo}`
+                    : `${window.location.origin}${defaultRedirectAfterLogin}`;
+                const callbackURL = buildCallbackURL(finalRedirectTo, baseURL);
+                await authClient.signIn.social({
+                    provider,
+                    callbackURL,
+                });
+                // 注意：OAuth 重定向后，loading 状态会在页面刷新时重置
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "Sign in failed";
+                authStore.error.set(message);
+                authStore.loading.set(false);
+            }
+        },
+        /**
+         * 登出
+         */
+        async signOut() {
+            // 防止重复调用
+            if (authStore.loading.get()) {
+                return;
+            }
+            try {
+                authStore.loading.set(true);
+                authStore.error.set(null);
+                await authClient.signOut();
+                // 清理本地状态
+                authStore.user.set(null);
+                authStore.isAuthenticated.set(false);
+                tokenStorage.clear();
+                // 重定向到登录页
+                window.location.href = signInPath;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "Sign out failed";
+                authStore.error.set(message);
+                // 即使出错，也尝试清理本地状态
+                authStore.user.set(null);
+                authStore.isAuthenticated.set(false);
+                tokenStorage.clear();
+            }
+            finally {
+                authStore.loading.set(false);
+            }
+        },
+        /**
+         * 更新用户信息
+         */
+        updateUser(user) {
+            if (user) {
+                authStore.user.set(user);
+                authStore.isAuthenticated.set(true);
+            }
+            else {
+                authStore.user.set(null);
+                authStore.isAuthenticated.set(false);
+            }
+        },
+        /**
+         * 获取当前用户
+         */
+        getUser() {
+            return authStore.user.get();
+        },
+    };
+}

package/dist/store/computed.d.ts

@@ -0,0 +1,12 @@
+import type { Observable } from "@legendapp/state";
+import type { AuthState } from "../types";
+/**
+ * 创建认证 computed
+ */
+export declare function createAuthComputed(authStore: Observable<AuthState>): {
+    /**
+     * 是否正在初始化
+     */
+    isInitializing: import("@legendapp/state").ObservableBoolean;
+};
+//# sourceMappingURL=computed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../src/store/computed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC;IAE/D;;OAEG;;EAKN"}

package/dist/store/computed.js

@@ -0,0 +1,14 @@
+import { computed } from "@legendapp/state";
+/**
+ * 创建认证 computed
+ */
+export function createAuthComputed(authStore) {
+    return {
+        /**
+         * 是否正在初始化
+         */
+        isInitializing: computed(() => {
+            return !authStore.isLoaded.get();
+        }),
+    };
+}

package/dist/store/state.d.ts

@@ -0,0 +1,16 @@
+import type { AuthState } from "../types";
+/**
+ * 创建认证状态 store
+ */
+export declare function createAuthStore(config: {
+    tokenStorageKey: string;
+}): {
+    authStore: import("@legendapp/state").Observable<AuthState>;
+    tokenStorage: {
+        save(token: string | null): void;
+        get(): string | null;
+        clear(): void;
+    };
+};
+export type TokenStorage = ReturnType<typeof createAuthStore>["tokenStorage"];
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/store/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE;;;oBAuBnD,MAAM,GAAG,IAAI;eAclB,MAAM,GAAG,IAAI;;;EAavB;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,cAAc,CAAC,CAAA"}

package/dist/store/state.js

@@ -0,0 +1,52 @@
+import { observable } from "@legendapp/state";
+/**
+ * 创建认证状态 store
+ */
+export function createAuthStore(config) {
+    const { tokenStorageKey } = config;
+    // 从 localStorage 读取初始 token
+    const getStoredToken = () => {
+        try {
+            return localStorage.getItem(tokenStorageKey);
+        }
+        catch {
+            return null;
+        }
+    };
+    const authStore = observable({
+        user: null,
+        isAuthenticated: false,
+        isLoaded: false,
+        loading: true,
+        error: null,
+        token: getStoredToken(),
+    });
+    // 手动管理 token 的 localStorage 存储
+    const tokenStorage = {
+        save(token) {
+            try {
+                if (token) {
+                    localStorage.setItem(tokenStorageKey, token);
+                    authStore.token.set(token);
+                }
+                else {
+                    localStorage.removeItem(tokenStorageKey);
+                    authStore.token.set(null);
+                }
+            }
+            catch (error) {
+                console.error("Failed to save token to localStorage:", error);
+            }
+        },
+        get() {
+            return getStoredToken();
+        },
+        clear() {
+            this.save(null);
+        },
+    };
+    return {
+        authStore,
+        tokenStorage,
+    };
+}

package/dist/store/utils.d.ts

@@ -0,0 +1,103 @@
+import type { Observable } from "@legendapp/state";
+import type { AuthState, SessionUser } from "../types";
+import type { TokenStorage } from "./state";
+import type { AuthActions } from "./actions";
+/**
+ * 获取当前用户
+ */
+export declare function getCurrentUser(authStore: Observable<AuthState>): SessionUser | null;
+/**
+ * 获取当前用户ID
+ */
+export declare function getCurrentUserId(authStore: Observable<AuthState>): string | null;
+/**
+ * 安全获取当前用户ID
+ */
+export declare function getCurrentUserIdSafe(authStore: Observable<AuthState>): string | null;
+/**
+ * 检查是否已认证
+ */
+export declare function isAuthenticated(authStore: Observable<AuthState>): boolean;
+/**
+ * 检查是否正在加载
+ */
+export declare function isLoading(authStore: Observable<AuthState>): boolean;
+/**
+ * 检查是否已加载
+ */
+export declare function isLoaded(authStore: Observable<AuthState>): boolean;
+/**
+ * 等待认证完成
+ * 使用轮询方式检查认证状态（简单但有效）
+ *
+ * 注意：如果长时间未加载，Promise 不会自动 reject
+ * 建议在外层添加超时处理
+ */
+export declare function waitForAuth(authStore: Observable<AuthState>): Promise<void>;
+/**
+ * 获取认证令牌
+ */
+export declare function getAuthToken(authStore: Observable<AuthState>, tokenStorage: TokenStorage, authActions: AuthActions, authClient: {
+    getSession: () => Promise<unknown>;
+}): Promise<string | null>;
+/**
+ * 获取认证头
+ */
+export declare function getAuthHeaders(authStore: Observable<AuthState>, tokenStorage: TokenStorage, authActions: AuthActions, authClient: {
+    getSession: () => Promise<unknown>;
+}): Promise<Record<string, string>>;
+/**
+ * 处理 401 响应
+ */
+export declare function handle401Response(response: Response, authActions: AuthActions): Response;
+/**
+ * API 客户端工具
+ */
+export declare function createApiClient(authStore: Observable<AuthState>, tokenStorage: TokenStorage, authActions: AuthActions, authClient: {
+    getSession: () => Promise<unknown>;
+}): {
+    get(url: string, options?: RequestInit): Promise<Response>;
+    post(url: string, body?: unknown, options?: RequestInit): Promise<Response>;
+    put(url: string, body?: unknown, options?: RequestInit): Promise<Response>;
+    delete(url: string, options?: RequestInit): Promise<Response>;
+};
+/**
+ * 用户管理器
+ */
+export declare function createUserManager(authStore: Observable<AuthState>): {
+    getUser(): SessionUser | null;
+    getUserId(): string | null;
+};
+/**
+ * 从 AuthInstance 创建绑定好的工具函数集合
+ * 这样就不需要在每个项目中重复包装工具函数
+ */
+export declare function createBoundAuthUtils(instance: {
+    authStore: Observable<AuthState>;
+    tokenStorage: TokenStorage;
+    authActions: AuthActions;
+    authClient: {
+        getSession: () => Promise<unknown>;
+    };
+}): {
+    getCurrentUser: () => SessionUser | null;
+    getCurrentUserId: () => string | null;
+    getCurrentUserIdSafe: () => string | null;
+    isAuthenticated: () => boolean;
+    isLoading: () => boolean;
+    isLoaded: () => boolean;
+    waitForAuth: () => Promise<void>;
+    getAuthToken: () => Promise<string | null>;
+    getAuthHeaders: () => Promise<Record<string, string>>;
+    apiClient: {
+        get(url: string, options?: RequestInit): Promise<Response>;
+        post(url: string, body?: unknown, options?: RequestInit): Promise<Response>;
+        put(url: string, body?: unknown, options?: RequestInit): Promise<Response>;
+        delete(url: string, options?: RequestInit): Promise<Response>;
+    };
+    userManager: {
+        getUser(): SessionUser | null;
+        getUserId(): string | null;
+    };
+};
+//# sourceMappingURL=utils.d.ts.map

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

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