@seaverse/auth-sdk 0.4.5 → 0.4.6

package/dist/index.d.ts

@@ -1651,5 +1651,238 @@ declare class Toast {
     private static injectCSS;
 }
 
-export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, ErrorCode, SeaVerseBackendAPIClient, Toast, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
-export type { AccountExistsErrorDetails, ApiError, ApiServiceTokenResponse, ApplyInviteResponse, AuthModalOptions, AuthModalResult, BindInviteCodeRequest, BindInviteCodeResponse, Container, ContainerDetailResponse, ContainerListResponse, ContainerStatsResponse, ConversationStatus, CreateMarketplaceSkillRequest, CreateVideoShareRequest, CreateVideoShareResponse, EmailVerificationResponse, Environment, EnvironmentConfig, ForgotPasswordRequest, ForkProjectRequest, ForkProjectResponse, HealthResponse, HubProject, HubProjectsListResponse, IframeTokenErrorMessage, IframeTokenRequestMessage, IframeTokenResponseMessage, InviteApplication, InviteApplicationListResponse, InviteCode, InviteCodeBindRequest, InviteCodeDetailResponse, InviteCodeGenerateResponse, InviteCodeRequiredErrorData, InviteCodeVerifyResponse, InviteStats, InviteStatsResponse, InviteUsage, ListInviteUsagesRequest, ListInviteUsagesResponse, ListInvitesRequest, ListInvitesResponse, LoginRequest, LoginResponse, MarketplaceSkill, MarketplaceSkillsListResponse, OAuthAuthorizeRequest, OAuthAuthorizeResponse, PublishProjectRequest, PublishSkillRequest, RegisterContainerRequest, RegisterContainerResponse, RegisterRequest, RegisterResponse, ResetPasswordRequest, RetryOptions, SeaVerseBackendAPIClientOptions, SocialMediaLink, SocialMediaLinksResponse, SpeechTokenResponse, SubmitInviteApplicationRequest, SuccessResponse, ToastOptions, ToastType, TrackAppTypeRequest, User, UserInstalledSkill, UserInstalledSkillsListResponse, VideoDetails };
+/**
+ * Google One-Tap Sign-In SDK
+ *
+ * 用于在用户未登录 SeaVerse 但已登录 Google 的情况下，
+ * 自动显示 Google One-Tap 快速登录界面
+ */
+declare global {
+    interface Window {
+        google?: {
+            accounts: {
+                id: {
+                    initialize(config: GoogleIdConfiguration): void;
+                    prompt(momentListener?: (notification: PromptMomentNotification) => void): void;
+                    cancel(): void;
+                    renderButton(parent: HTMLElement, options: GsiButtonConfiguration): void;
+                    disableAutoSelect(): void;
+                };
+            };
+        };
+    }
+}
+interface GoogleIdConfiguration {
+    client_id: string;
+    callback: (response: CredentialResponse) => void;
+    auto_select?: boolean;
+    cancel_on_tap_outside?: boolean;
+    context?: 'signin' | 'signup' | 'use';
+    use_fedcm_for_prompt?: boolean;
+}
+interface CredentialResponse {
+    credential: string;
+    select_by?: string;
+}
+interface PromptMomentNotification {
+    isDisplayMoment(): boolean;
+    isDisplayed(): boolean;
+    isNotDisplayed(): boolean;
+    getNotDisplayedReason(): string;
+    isSkippedMoment(): boolean;
+    getSkippedReason(): string;
+    isDismissedMoment(): boolean;
+    getDismissedReason(): string;
+}
+interface GsiButtonConfiguration {
+    type?: 'standard' | 'icon';
+    theme?: 'outline' | 'filled_blue' | 'filled_black';
+    size?: 'large' | 'medium' | 'small';
+    text?: 'signin_with' | 'signup_with' | 'continue_with' | 'signin';
+    shape?: 'rectangular' | 'pill' | 'circle' | 'square';
+    logo_alignment?: 'left' | 'center';
+    width?: number;
+    locale?: string;
+}
+/**
+ * Google One-Tap 配置选项
+ */
+interface GoogleOneTapOptions {
+    /**
+     * Google OAuth Client ID（必需）
+     * 从 Google Cloud Console 获取
+     *
+     * @example '827924048330-xxxxxx.apps.googleusercontent.com'
+     */
+    clientId: string;
+    /**
+     * 检查用户是否已登录 SeaVerse（必需）
+     * SDK 会在初始化时和显示 One-Tap 前调用此函数
+     * 只有返回 false 时才会显示 Google One-Tap
+     *
+     * @returns true - 已登录，SDK 不显示 One-Tap
+     *          false - 未登录，SDK 显示 One-Tap
+     *
+     * @example
+     * isLoggedIn: () => !!localStorage.getItem('seaverse_token')
+     *
+     * @example
+     * isLoggedIn: () => document.cookie.includes('auth_token')
+     */
+    isLoggedIn: () => boolean;
+    /**
+     * 获取到 Google credential 后的回调（必需）
+     * SDK 获取到 Google 返回的 JWT credential 后会调用此函数
+     * 前端在此函数中决定如何处理 credential（调用后端验证、保存 token 等）
+     *
+     * @param credential - Google 返回的 JWT token
+     *
+     * @example
+     * onCredentialReceived: async (credential) => {
+     *   const res = await fetch('/api/auth/google/verify', {
+     *     method: 'POST',
+     *     body: JSON.stringify({ credential })
+     *   });
+     *   const data = await res.json();
+     *   localStorage.setItem('token', data.token);
+     *   window.location.href = '/dashboard';
+     * }
+     */
+    onCredentialReceived: (credential: string) => void | Promise<void>;
+    /**
+     * 错误回调（可选）
+     *
+     * @param error - 错误对象
+     */
+    onError?: (error: Error) => void;
+    /**
+     * 是否自动显示 One-Tap 提示（可选，默认 true）
+     * 注意：即使设置为 true，也只在 isLoggedIn() 返回 false 时才显示
+     */
+    autoPrompt?: boolean;
+    /**
+     * 点击 One-Tap 弹窗外部时是否取消（可选，默认 true）
+     */
+    cancelOnTapOutside?: boolean;
+    /**
+     * 登录上下文（可选，默认 'signin'）
+     */
+    context?: 'signin' | 'signup' | 'use';
+    /**
+     * 自定义按钮配置（可选）
+     * 用于 renderButton() 方法
+     */
+    button?: {
+        type?: 'standard' | 'icon';
+        theme?: 'outline' | 'filled_blue' | 'filled_black';
+        size?: 'large' | 'medium' | 'small';
+        text?: 'signin_with' | 'signup_with' | 'continue_with' | 'signin';
+        shape?: 'rectangular' | 'pill' | 'circle' | 'square';
+        logoAlignment?: 'left' | 'center';
+        width?: number;
+        locale?: string;
+    };
+    /**
+     * 是否启用调试日志（可选，默认 false）
+     */
+    debug?: boolean;
+    /**
+     * 是否使用 FedCM (Federated Credential Management) 进行提示（可选，默认 false）
+     *
+     * FedCM 是 Chrome 的新 API，用于替代第三方 Cookie。
+     * 如果遇到 CORS 错误或 FedCM 请求失败，可以设置为 false 使用传统的 iframe 方式。
+     *
+     * @default false
+     *
+     * @example
+     * useFedcmForPrompt: false  // 禁用 FedCM，使用传统方式
+     */
+    useFedcmForPrompt?: boolean;
+}
+/**
+ * Google One-Tap 快速登录
+ *
+ * 用法示例：
+ * ```typescript
+ * const googleLogin = new GoogleOneTap({
+ *   clientId: 'YOUR_GOOGLE_CLIENT_ID',
+ *   isLoggedIn: () => !!localStorage.getItem('token'),
+ *   onCredentialReceived: async (credential) => {
+ *     // 调用后端验证
+ *     const res = await fetch('/api/auth/google', {
+ *       method: 'POST',
+ *       body: JSON.stringify({ credential })
+ *     });
+ *     const data = await res.json();
+ *     localStorage.setItem('token', data.token);
+ *     window.location.reload();
+ *   }
+ * });
+ * ```
+ */
+declare class GoogleOneTap {
+    private options;
+    private isInitialized;
+    private scriptLoaded;
+    private static scriptLoadPromise;
+    constructor(options: GoogleOneTapOptions);
+    /**
+     * 检查登录状态并初始化
+     */
+    private checkAndInit;
+    /**
+     * 初始化 Google One-Tap API
+     */
+    private init;
+    /**
+     * 处理 Google 返回的 credential
+     */
+    private handleCredentialResponse;
+    /**
+     * 显示 Google One-Tap 提示
+     * 会先检查登录状态
+     */
+    prompt(): void;
+    /**
+     * 取消 Google One-Tap 提示
+     */
+    cancel(): void;
+    /**
+     * 渲染 Google 登录按钮到指定元素
+     *
+     * @param element - 要渲染按钮的 HTML 元素
+     *
+     * @example
+     * const container = document.getElementById('google-btn');
+     * googleLogin.renderButton(container);
+     */
+    renderButton(element: HTMLElement): void;
+    /**
+     * 禁用自动选择
+     * 用户关闭 One-Tap 后，下次不会自动选择账号
+     */
+    disableAutoSelect(): void;
+    /**
+     * 等待 Google API 完全就绪
+     */
+    private waitForGoogleAPI;
+    /**
+     * 加载 Google One-Tap 脚本
+     */
+    private loadGoogleScript;
+    /**
+     * 处理错误
+     */
+    private handleError;
+    /**
+     * 调试日志
+     */
+    private log;
+    /**
+     * 检查 Google One-Tap 是否可用
+     */
+    static isAvailable(): boolean;
+}
+
+export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, ErrorCode, GoogleOneTap, SeaVerseBackendAPIClient, Toast, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
+export type { AccountExistsErrorDetails, ApiError, ApiServiceTokenResponse, ApplyInviteResponse, AuthModalOptions, AuthModalResult, BindInviteCodeRequest, BindInviteCodeResponse, Container, ContainerDetailResponse, ContainerListResponse, ContainerStatsResponse, ConversationStatus, CreateMarketplaceSkillRequest, CreateVideoShareRequest, CreateVideoShareResponse, EmailVerificationResponse, Environment, EnvironmentConfig, ForgotPasswordRequest, ForkProjectRequest, ForkProjectResponse, GoogleOneTapOptions, HealthResponse, HubProject, HubProjectsListResponse, IframeTokenErrorMessage, IframeTokenRequestMessage, IframeTokenResponseMessage, InviteApplication, InviteApplicationListResponse, InviteCode, InviteCodeBindRequest, InviteCodeDetailResponse, InviteCodeGenerateResponse, InviteCodeRequiredErrorData, InviteCodeVerifyResponse, InviteStats, InviteStatsResponse, InviteUsage, ListInviteUsagesRequest, ListInviteUsagesResponse, ListInvitesRequest, ListInvitesResponse, LoginRequest, LoginResponse, MarketplaceSkill, MarketplaceSkillsListResponse, OAuthAuthorizeRequest, OAuthAuthorizeResponse, PublishProjectRequest, PublishSkillRequest, RegisterContainerRequest, RegisterContainerResponse, RegisterRequest, RegisterResponse, ResetPasswordRequest, RetryOptions, SeaVerseBackendAPIClientOptions, SocialMediaLink, SocialMediaLinksResponse, SpeechTokenResponse, SubmitInviteApplicationRequest, SuccessResponse, ToastOptions, ToastType, TrackAppTypeRequest, User, UserInstalledSkill, UserInstalledSkillsListResponse, VideoDetails };

package/dist/index.js

@@ -4322,5 +4322,366 @@ function createAuthModal(options) {
     return new AuthModal(options);
 }
 
-export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, ErrorCode, SeaVerseBackendAPIClient, Toast, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
+/**
+ * Google One-Tap Sign-In SDK
+ *
+ * 用于在用户未登录 SeaVerse 但已登录 Google 的情况下，
+ * 自动显示 Google One-Tap 快速登录界面
+ */
+/**
+ * Google One-Tap 快速登录
+ *
+ * 用法示例：
+ * ```typescript
+ * const googleLogin = new GoogleOneTap({
+ *   clientId: 'YOUR_GOOGLE_CLIENT_ID',
+ *   isLoggedIn: () => !!localStorage.getItem('token'),
+ *   onCredentialReceived: async (credential) => {
+ *     // 调用后端验证
+ *     const res = await fetch('/api/auth/google', {
+ *       method: 'POST',
+ *       body: JSON.stringify({ credential })
+ *     });
+ *     const data = await res.json();
+ *     localStorage.setItem('token', data.token);
+ *     window.location.reload();
+ *   }
+ * });
+ * ```
+ */
+class GoogleOneTap {
+    constructor(options) {
+        this.isInitialized = false;
+        this.scriptLoaded = false;
+        this.options = options;
+        this.log('GoogleOneTap initialized with options:', options);
+        // 立即检查登录状态并初始化
+        this.checkAndInit();
+    }
+    /**
+     * 检查登录状态并初始化
+     */
+    checkAndInit() {
+        // 检查用户是否已登录 SeaVerse
+        if (this.options.isLoggedIn()) {
+            this.log('User already logged in, skipping Google One-Tap initialization');
+            return;
+        }
+        this.log('User not logged in, initializing Google One-Tap');
+        // 未登录，加载并初始化 Google One-Tap
+        this.loadGoogleScript()
+            .then(() => {
+            this.init();
+        })
+            .catch((error) => {
+            this.handleError(new Error(`Failed to load Google One-Tap script: ${error.message}`));
+        });
+    }
+    /**
+     * 初始化 Google One-Tap API
+     */
+    init() {
+        if (!window.google?.accounts?.id) {
+            this.handleError(new Error('Google One-Tap API not available'));
+            return;
+        }
+        try {
+            // 初始化 Google One-Tap
+            window.google.accounts.id.initialize({
+                client_id: this.options.clientId,
+                callback: (response) => {
+                    this.handleCredentialResponse(response);
+                },
+                auto_select: false,
+                cancel_on_tap_outside: this.options.cancelOnTapOutside ?? true,
+                context: this.options.context || 'signin',
+                use_fedcm_for_prompt: this.options.useFedcmForPrompt ?? false
+            });
+            this.isInitialized = true;
+            this.log('Google One-Tap initialized successfully');
+            // 如果启用自动提示，显示 One-Tap
+            if (this.options.autoPrompt !== false) {
+                this.prompt();
+            }
+        }
+        catch (error) {
+            this.handleError(new Error(`Failed to initialize Google One-Tap: ${error.message}`));
+        }
+    }
+    /**
+     * 处理 Google 返回的 credential
+     */
+    async handleCredentialResponse(response) {
+        this.log('Received credential from Google', {
+            select_by: response.select_by,
+            credential_length: response.credential?.length
+        });
+        // 验证 credential 是否存在
+        if (!response.credential) {
+            const error = new Error('No credential received from Google');
+            this.log('Error: No credential in response', response);
+            this.handleError(error);
+            return;
+        }
+        try {
+            await this.options.onCredentialReceived(response.credential);
+            this.log('Credential processed successfully');
+        }
+        catch (error) {
+            this.log('Error processing credential:', error);
+            this.handleError(error);
+        }
+    }
+    /**
+     * 显示 Google One-Tap 提示
+     * 会先检查登录状态
+     */
+    prompt() {
+        // 再次检查登录状态（可能在初始化后用户已登录）
+        if (this.options.isLoggedIn()) {
+            this.log('User already logged in, skipping prompt');
+            return;
+        }
+        if (!this.isInitialized) {
+            this.log('Google One-Tap not initialized yet, skipping prompt');
+            return;
+        }
+        if (!window.google?.accounts?.id) {
+            this.handleError(new Error('Google One-Tap API not available'));
+            return;
+        }
+        try {
+            this.log('Displaying Google One-Tap prompt');
+            window.google.accounts.id.prompt((notification) => {
+                if (notification.isNotDisplayed()) {
+                    const reason = notification.getNotDisplayedReason();
+                    this.log('One-Tap not displayed:', reason);
+                }
+                else if (notification.isSkippedMoment()) {
+                    const reason = notification.getSkippedReason();
+                    this.log('One-Tap skipped:', reason);
+                }
+                else if (notification.isDismissedMoment()) {
+                    const reason = notification.getDismissedReason();
+                    this.log('One-Tap dismissed:', reason);
+                }
+                else if (notification.isDisplayed()) {
+                    this.log('One-Tap displayed successfully');
+                }
+            });
+        }
+        catch (error) {
+            this.handleError(new Error(`Failed to show Google One-Tap: ${error.message}`));
+        }
+    }
+    /**
+     * 取消 Google One-Tap 提示
+     */
+    cancel() {
+        if (!this.isInitialized) {
+            this.log('Google One-Tap not initialized, nothing to cancel');
+            return;
+        }
+        if (!window.google?.accounts?.id) {
+            return;
+        }
+        try {
+            window.google.accounts.id.cancel();
+            this.log('Google One-Tap canceled');
+        }
+        catch (error) {
+            this.log('Error canceling Google One-Tap:', error);
+        }
+    }
+    /**
+     * 渲染 Google 登录按钮到指定元素
+     *
+     * @param element - 要渲染按钮的 HTML 元素
+     *
+     * @example
+     * const container = document.getElementById('google-btn');
+     * googleLogin.renderButton(container);
+     */
+    renderButton(element) {
+        // 检查登录状态
+        if (this.options.isLoggedIn()) {
+            this.log('User already logged in, not rendering button');
+            return;
+        }
+        if (!this.isInitialized) {
+            this.log('Google One-Tap not initialized yet, waiting...');
+            // 等待初始化完成后再渲染
+            setTimeout(() => this.renderButton(element), 100);
+            return;
+        }
+        if (!window.google?.accounts?.id) {
+            this.handleError(new Error('Google One-Tap API not available'));
+            return;
+        }
+        try {
+            const buttonConfig = {
+                type: this.options.button?.type || 'standard',
+                theme: this.options.button?.theme || 'outline',
+                size: this.options.button?.size || 'large',
+                text: this.options.button?.text || 'signin_with',
+                shape: this.options.button?.shape || 'rectangular',
+                logo_alignment: this.options.button?.logoAlignment || 'left',
+                width: this.options.button?.width,
+                locale: this.options.button?.locale
+            };
+            window.google.accounts.id.renderButton(element, buttonConfig);
+            this.log('Google login button rendered', buttonConfig);
+        }
+        catch (error) {
+            this.handleError(new Error(`Failed to render Google button: ${error.message}`));
+        }
+    }
+    /**
+     * 禁用自动选择
+     * 用户关闭 One-Tap 后，下次不会自动选择账号
+     */
+    disableAutoSelect() {
+        if (!window.google?.accounts?.id) {
+            return;
+        }
+        try {
+            window.google.accounts.id.disableAutoSelect();
+            this.log('Auto select disabled');
+        }
+        catch (error) {
+            this.log('Error disabling auto select:', error);
+        }
+    }
+    /**
+     * 等待 Google API 完全就绪
+     */
+    waitForGoogleAPI(maxAttempts = 50, interval = 100) {
+        return new Promise((resolve, reject) => {
+            let attempts = 0;
+            const checkAPI = () => {
+                if (window.google?.accounts?.id) {
+                    resolve();
+                    return;
+                }
+                attempts++;
+                if (attempts >= maxAttempts) {
+                    reject(new Error('Google One-Tap API not available after timeout'));
+                    return;
+                }
+                setTimeout(checkAPI, interval);
+            };
+            checkAPI();
+        });
+    }
+    /**
+     * 加载 Google One-Tap 脚本
+     */
+    loadGoogleScript() {
+        // 如果已经有加载中的 Promise，直接返回
+        if (GoogleOneTap.scriptLoadPromise) {
+            return GoogleOneTap.scriptLoadPromise;
+        }
+        // 如果脚本已加载完成且 API 可用，创建已 resolve 的 Promise
+        if (this.scriptLoaded && window.google?.accounts?.id) {
+            return Promise.resolve();
+        }
+        // 检查脚本标签是否已存在
+        const existingScript = document.getElementById('google-one-tap-script');
+        if (existingScript) {
+            // 如果脚本标签存在，等待其加载完成
+            GoogleOneTap.scriptLoadPromise = new Promise((resolve, reject) => {
+                if (window.google?.accounts?.id) {
+                    this.scriptLoaded = true;
+                    resolve();
+                    return;
+                }
+                // 等待脚本加载
+                const onLoad = () => {
+                    // 等待 Google API 就绪
+                    this.waitForGoogleAPI()
+                        .then(() => {
+                        this.scriptLoaded = true;
+                        resolve();
+                    })
+                        .catch(reject);
+                };
+                // 检查脚本是否已经加载完成（通过检查 API 是否可用）
+                // 如果 API 已经可用，直接调用 onLoad
+                if (window.google?.accounts?.id) {
+                    onLoad();
+                }
+                else {
+                    // 否则等待脚本加载事件
+                    existingScript.addEventListener('load', onLoad);
+                    existingScript.addEventListener('error', () => {
+                        GoogleOneTap.scriptLoadPromise = null;
+                        reject(new Error('Failed to load Google One-Tap script'));
+                    });
+                }
+            });
+            return GoogleOneTap.scriptLoadPromise;
+        }
+        // 创建新的脚本加载 Promise
+        GoogleOneTap.scriptLoadPromise = new Promise((resolve, reject) => {
+            this.log('Loading Google One-Tap script');
+            const script = document.createElement('script');
+            script.id = 'google-one-tap-script';
+            script.src = 'https://accounts.google.com/gsi/client';
+            script.async = true;
+            script.defer = true;
+            script.onload = () => {
+                this.log('Google One-Tap script loaded successfully');
+                // 等待 Google API 完全就绪
+                this.waitForGoogleAPI()
+                    .then(() => {
+                    this.scriptLoaded = true;
+                    resolve();
+                })
+                    .catch((error) => {
+                    GoogleOneTap.scriptLoadPromise = null;
+                    reject(error);
+                });
+            };
+            script.onerror = (error) => {
+                this.log('Failed to load Google One-Tap script:', error);
+                GoogleOneTap.scriptLoadPromise = null;
+                reject(new Error('Failed to load Google One-Tap script'));
+            };
+            document.head.appendChild(script);
+        });
+        return GoogleOneTap.scriptLoadPromise;
+    }
+    /**
+     * 处理错误
+     */
+    handleError(error) {
+        this.log('Error:', error);
+        if (this.options.onError) {
+            try {
+                this.options.onError(error);
+            }
+            catch (callbackError) {
+                console.error('[GoogleOneTap] Error in onError callback:', callbackError);
+            }
+        }
+    }
+    /**
+     * 调试日志
+     */
+    log(message, ...args) {
+        if (this.options.debug) {
+            console.log(`[GoogleOneTap] ${message}`, ...args);
+        }
+    }
+    /**
+     * 检查 Google One-Tap 是否可用
+     */
+    static isAvailable() {
+        return typeof window !== 'undefined' && 'google' in window;
+    }
+}
+// 静态 Promise，用于避免多个实例重复加载脚本
+GoogleOneTap.scriptLoadPromise = null;
+
+export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, ErrorCode, GoogleOneTap, SeaVerseBackendAPIClient, Toast, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
 //# sourceMappingURL=index.js.map