@seaverse/auth-sdk 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -258,8 +258,11 @@ interface RegisterRequest {
  */
 interface RegisterResponse {
     success: boolean;
-    message: string;
-    userId: string;
+    message?: string;
+    userId?: string;
+    error?: string;
+    code?: string;
+    details?: Record<string, any>;
 }
 /**
  * Forgot password request
@@ -277,17 +280,16 @@ interface ResetPasswordRequest {
     newPassword?: string;
 }
 /**
- * OAuth code exchange request
+ * OAuth authorize request (Backend Proxy Mode)
  */
-interface CodeToTokenRequest {
-    code: string;
+interface OAuthAuthorizeRequest {
+    return_url?: string;
 }
 /**
- * OAuth code exchange response
+ * OAuth authorize response (Backend Proxy Mode)
  */
-interface CodeToTokenResponse {
-    token: string;
-    user: User;
+interface OAuthAuthorizeResponse {
+    authorize_url: string;
 }
 /**
  * Health check response
@@ -583,14 +585,40 @@ interface VideoDetails {
     thumbnailUrl?: string;
     createdAt: number;
 }
+/**
+ * Error codes for authentication system
+ */
+declare enum ErrorCode {
+    ACCOUNT_EXISTS = "ACCOUNT_EXISTS",
+    ACCOUNT_NOT_FOUND = "ACCOUNT_NOT_FOUND",
+    ACCOUNT_SUSPENDED = "ACCOUNT_SUSPENDED",
+    INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
+    EMAIL_NOT_VERIFIED = "EMAIL_NOT_VERIFIED",
+    INVALID_EMAIL = "INVALID_EMAIL",
+    INVALID_PASSWORD = "INVALID_PASSWORD",
+    PASSWORD_TOO_WEAK = "PASSWORD_TOO_WEAK",
+    INVALID_INVITATION_CODE = "INVALID_INVITATION_CODE",
+    INVITATION_REQUIRED = "INVITATION_REQUIRED",
+    INVALID_TOKEN = "INVALID_TOKEN",
+    TOKEN_EXPIRED = "TOKEN_EXPIRED",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
 /**
  * API error response
  */
 interface ApiError {
+    success: false;
     error: string;
-    code: string;
+    code?: string;
     details?: Record<string, any>;
 }
+/**
+ * Account exists error details
+ */
+interface AccountExistsErrorDetails {
+    email: string;
+    app_id?: string;
+}
 /**
  * Standard success response
  */
@@ -599,10 +627,9 @@ interface SuccessResponse {
     message?: string;
 }
 
+type models_AccountExistsErrorDetails = AccountExistsErrorDetails;
 type models_ApiError = ApiError;
 type models_ApiServiceTokenResponse = ApiServiceTokenResponse;
-type models_CodeToTokenRequest = CodeToTokenRequest;
-type models_CodeToTokenResponse = CodeToTokenResponse;
 type models_Container = Container;
 type models_ContainerDetailResponse = ContainerDetailResponse;
 type models_ContainerListResponse = ContainerListResponse;
@@ -611,6 +638,8 @@ type models_ConversationStatus = ConversationStatus;
 type models_CreateMarketplaceSkillRequest = CreateMarketplaceSkillRequest;
 type models_CreateVideoShareRequest = CreateVideoShareRequest;
 type models_CreateVideoShareResponse = CreateVideoShareResponse;
+type models_ErrorCode = ErrorCode;
+declare const models_ErrorCode: typeof ErrorCode;
 type models_ForgotPasswordRequest = ForgotPasswordRequest;
 type models_ForkProjectRequest = ForkProjectRequest;
 type models_ForkProjectResponse = ForkProjectResponse;
@@ -626,6 +655,8 @@ type models_LoginRequest = LoginRequest;
 type models_LoginResponse = LoginResponse;
 type models_MarketplaceSkill = MarketplaceSkill;
 type models_MarketplaceSkillsListResponse = MarketplaceSkillsListResponse;
+type models_OAuthAuthorizeRequest = OAuthAuthorizeRequest;
+type models_OAuthAuthorizeResponse = OAuthAuthorizeResponse;
 type models_PublishProjectRequest = PublishProjectRequest;
 type models_PublishSkillRequest = PublishSkillRequest;
 type models_RegisterContainerRequest = RegisterContainerRequest;
@@ -644,7 +675,8 @@ type models_UserInstalledSkill = UserInstalledSkill;
 type models_UserInstalledSkillsListResponse = UserInstalledSkillsListResponse;
 type models_VideoDetails = VideoDetails;
 declare namespace models {
-  export type { models_ApiError as ApiError, models_ApiServiceTokenResponse as ApiServiceTokenResponse, models_CodeToTokenRequest as CodeToTokenRequest, models_CodeToTokenResponse as CodeToTokenResponse, models_Container as Container, models_ContainerDetailResponse as ContainerDetailResponse, models_ContainerListResponse as ContainerListResponse, models_ContainerStatsResponse as ContainerStatsResponse, models_ConversationStatus as ConversationStatus, models_CreateMarketplaceSkillRequest as CreateMarketplaceSkillRequest, models_CreateVideoShareRequest as CreateVideoShareRequest, models_CreateVideoShareResponse as CreateVideoShareResponse, models_ForgotPasswordRequest as ForgotPasswordRequest, models_ForkProjectRequest as ForkProjectRequest, models_ForkProjectResponse as ForkProjectResponse, models_HealthResponse as HealthResponse, models_HubProject as HubProject, models_HubProjectsListResponse as HubProjectsListResponse, models_InviteApplication as InviteApplication, models_InviteApplicationListResponse as InviteApplicationListResponse, models_InviteCodeBindRequest as InviteCodeBindRequest, models_InviteCodeGenerateResponse as InviteCodeGenerateResponse, models_InviteCodeVerifyResponse as InviteCodeVerifyResponse, models_LoginRequest as LoginRequest, models_LoginResponse as LoginResponse, models_MarketplaceSkill as MarketplaceSkill, models_MarketplaceSkillsListResponse as MarketplaceSkillsListResponse, models_PublishProjectRequest as PublishProjectRequest, models_PublishSkillRequest as PublishSkillRequest, models_RegisterContainerRequest as RegisterContainerRequest, models_RegisterContainerResponse as RegisterContainerResponse, models_RegisterRequest as RegisterRequest, models_RegisterResponse as RegisterResponse, models_ResetPasswordRequest as ResetPasswordRequest, models_SocialMediaLink as SocialMediaLink, models_SocialMediaLinksResponse as SocialMediaLinksResponse, models_SpeechTokenResponse as SpeechTokenResponse, models_SubmitInviteApplicationRequest as SubmitInviteApplicationRequest, models_SuccessResponse as SuccessResponse, models_TrackAppTypeRequest as TrackAppTypeRequest, models_User as User, models_UserInstalledSkill as UserInstalledSkill, models_UserInstalledSkillsListResponse as UserInstalledSkillsListResponse, models_VideoDetails as VideoDetails };
+  export { models_ErrorCode as ErrorCode };
+  export type { models_AccountExistsErrorDetails as AccountExistsErrorDetails, models_ApiError as ApiError, models_ApiServiceTokenResponse as ApiServiceTokenResponse, models_Container as Container, models_ContainerDetailResponse as ContainerDetailResponse, models_ContainerListResponse as ContainerListResponse, models_ContainerStatsResponse as ContainerStatsResponse, models_ConversationStatus as ConversationStatus, models_CreateMarketplaceSkillRequest as CreateMarketplaceSkillRequest, models_CreateVideoShareRequest as CreateVideoShareRequest, models_CreateVideoShareResponse as CreateVideoShareResponse, models_ForgotPasswordRequest as ForgotPasswordRequest, models_ForkProjectRequest as ForkProjectRequest, models_ForkProjectResponse as ForkProjectResponse, models_HealthResponse as HealthResponse, models_HubProject as HubProject, models_HubProjectsListResponse as HubProjectsListResponse, models_InviteApplication as InviteApplication, models_InviteApplicationListResponse as InviteApplicationListResponse, models_InviteCodeBindRequest as InviteCodeBindRequest, models_InviteCodeGenerateResponse as InviteCodeGenerateResponse, models_InviteCodeVerifyResponse as InviteCodeVerifyResponse, models_LoginRequest as LoginRequest, models_LoginResponse as LoginResponse, models_MarketplaceSkill as MarketplaceSkill, models_MarketplaceSkillsListResponse as MarketplaceSkillsListResponse, models_OAuthAuthorizeRequest as OAuthAuthorizeRequest, models_OAuthAuthorizeResponse as OAuthAuthorizeResponse, models_PublishProjectRequest as PublishProjectRequest, models_PublishSkillRequest as PublishSkillRequest, models_RegisterContainerRequest as RegisterContainerRequest, models_RegisterContainerResponse as RegisterContainerResponse, models_RegisterRequest as RegisterRequest, models_RegisterResponse as RegisterResponse, models_ResetPasswordRequest as ResetPasswordRequest, models_SocialMediaLink as SocialMediaLink, models_SocialMediaLinksResponse as SocialMediaLinksResponse, models_SpeechTokenResponse as SpeechTokenResponse, models_SubmitInviteApplicationRequest as SubmitInviteApplicationRequest, models_SuccessResponse as SuccessResponse, models_TrackAppTypeRequest as TrackAppTypeRequest, models_User as User, models_UserInstalledSkill as UserInstalledSkill, models_UserInstalledSkillsListResponse as UserInstalledSkillsListResponse, models_VideoDetails as VideoDetails };
 }
 
 /**
@@ -778,6 +810,21 @@ declare class SeaVerseBackendAPIClient {
      * Get default hooks configuration
      */
     private getDefaultHooks;
+    /**
+     * Set authentication token
+     * Update the client's authentication token (useful after OAuth login)
+     *
+     * @param token - JWT token to set
+     *
+     * @example
+     * // After OAuth login
+     * const token = new URLSearchParams(window.location.search).get('token');
+     * if (token) {
+     *   client.setToken(token);
+     *   localStorage.setItem('token', token);
+     * }
+     */
+    setToken(token: string): void;
     /**
      * Health check
      * Check if the service is healthy
@@ -819,27 +866,50 @@ declare class SeaVerseBackendAPIClient {
      */
     getApiServiceToken(options?: AxiosRequestConfig): Promise<ApiServiceTokenResponse>;
     /**
-     * Exchange Google code for token
-     * Exchange Google authorization code for JWT token (for app)
-     */
-    googleCodeToToken(data: CodeToTokenRequest, options?: AxiosRequestConfig): Promise<CodeToTokenResponse>;
+     * Google OAuth authorization (Backend Proxy Mode)
+     * Generate OAuth authorization URL for Google login
+     *
+     * @param data - OAuth authorize request (return_url is optional, defaults to window.location.origin)
+     * @param options - Additional axios request options
+     *
+     * @example
+     * // 使用默认 return_url (当前页面)
+     * const { authorize_url } = await client.googleAuthorize();
+     * window.location.href = authorize_url;
+     *
+     * @example
+     * // 自定义 return_url
+     * const { authorize_url } = await client.googleAuthorize({
+     *   return_url: 'https://mygame.com/dashboard'
+     * });
+     * window.location.href = authorize_url;
+     */
+    googleAuthorize(data?: OAuthAuthorizeRequest, options?: AxiosRequestConfig): Promise<OAuthAuthorizeResponse>;
     /**
      * Unlink Google account
      * Unlink the user's Google account
      */
     unlinkGoogle(options?: AxiosRequestConfig): Promise<SuccessResponse>;
     /**
-     * Exchange Discord code for token
+     * Discord OAuth authorization (Backend Proxy Mode)
+     * Generate OAuth authorization URL for Discord login
+     *
+     * @param data - OAuth authorize request (return_url is optional, defaults to window.location.origin)
+     * @param options - Additional axios request options
      */
-    discordCodeToToken(data: CodeToTokenRequest, options?: AxiosRequestConfig): Promise<CodeToTokenResponse>;
+    discordAuthorize(data?: OAuthAuthorizeRequest, options?: AxiosRequestConfig): Promise<OAuthAuthorizeResponse>;
     /**
      * Unlink Discord account
      */
     unlinkDiscord(options?: AxiosRequestConfig): Promise<SuccessResponse>;
     /**
-     * Exchange GitHub code for token
+     * GitHub OAuth authorization (Backend Proxy Mode)
+     * Generate OAuth authorization URL for GitHub login
+     *
+     * @param data - OAuth authorize request (return_url is optional, defaults to window.location.origin)
+     * @param options - Additional axios request options
      */
-    githubCodeToToken(data: CodeToTokenRequest, options?: AxiosRequestConfig): Promise<CodeToTokenResponse>;
+    githubAuthorize(data?: OAuthAuthorizeRequest, options?: AxiosRequestConfig): Promise<OAuthAuthorizeResponse>;
     /**
      * Unlink GitHub account
      */
@@ -926,30 +996,18 @@ declare class SeaVerseBackendAPIClient {
     getapicontainers(options?: AxiosRequestConfig): Promise<any>;
 }
 
-interface OAuthConfig {
-    google?: {
-        clientId: string;
-        redirectUri?: string;
-        scope?: string;
-    };
-    discord?: {
-        clientId: string;
-        redirectUri?: string;
-        scope?: string;
-    };
-    github?: {
-        clientId: string;
-        redirectUri?: string;
-        scope?: string;
-    };
-}
 interface AuthModalOptions {
     client: SeaVerseBackendAPIClient;
     onLoginSuccess?: (token: string, user: any) => void;
     onSignupSuccess?: (token: string, user: any) => void;
     onError?: (error: Error) => void;
     theme?: 'dark' | 'light';
-    oauthConfig?: OAuthConfig;
+    returnUrl?: string;
+    enableOAuth?: {
+        google?: boolean;
+        discord?: boolean;
+        github?: boolean;
+    };
 }
 interface AuthModalResult {
     success: boolean;
@@ -997,31 +1055,28 @@ declare class AuthModal {
     private showMessage;
     private showError;
     /**
-     * Start OAuth flow for a given provider
+     * Start OAuth flow for a given provider (Backend Proxy Mode)
+     *
+     * This method calls the backend /authorize endpoint to get the OAuth URL,
+     * then redirects the user. The backend handles:
+     * - State token generation and storage
+     * - OAuth callback processing
+     * - JWT token generation
+     * - Redirecting back to returnUrl with token
      */
     private startOAuthFlow;
     /**
-     * Generate random state for CSRF protection
-     */
-    private generateRandomState;
-    /**
-     * Build authorization URL for each provider
-     */
-    private buildAuthUrl;
-    /**
-     * Handle OAuth callback
-     * Call this method from your redirect page with the code and state from URL
-     */
-    handleOAuthCallback(code: string, state: string): Promise<AuthModalResult>;
-    /**
-     * Check if current page is an OAuth callback and handle it automatically
+     * Handle OAuth callback (Backend Proxy Mode)
+     *
+     * In Backend Proxy Mode, the backend redirects to returnUrl with token in query param.
+     * This static method checks if current URL has a token and processes it.
      */
-    static handleOAuthCallbackFromUrl(client: SeaVerseBackendAPIClient, options?: Omit<AuthModalOptions, 'client'>): Promise<AuthModalResult | null>;
+    static handleOAuthCallback(options: AuthModalOptions): AuthModalResult | null;
 }
 /**
  * Create and show auth modal
  */
 declare function createAuthModal(options: AuthModalOptions): AuthModal;
 
-export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, SeaVerseBackendAPIClient, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
-export type { ApiError, ApiServiceTokenResponse, AuthModalOptions, AuthModalResult, CodeToTokenRequest, CodeToTokenResponse, Container, ContainerDetailResponse, ContainerListResponse, ContainerStatsResponse, ConversationStatus, CreateMarketplaceSkillRequest, CreateVideoShareRequest, CreateVideoShareResponse, Environment, EnvironmentConfig, ForgotPasswordRequest, ForkProjectRequest, ForkProjectResponse, HealthResponse, HubProject, HubProjectsListResponse, InviteApplication, InviteApplicationListResponse, InviteCodeBindRequest, InviteCodeGenerateResponse, InviteCodeVerifyResponse, LoginRequest, LoginResponse, MarketplaceSkill, MarketplaceSkillsListResponse, OAuthConfig, PublishProjectRequest, PublishSkillRequest, RegisterContainerRequest, RegisterContainerResponse, RegisterRequest, RegisterResponse, ResetPasswordRequest, SeaVerseBackendAPIClientOptions, SocialMediaLink, SocialMediaLinksResponse, SpeechTokenResponse, SubmitInviteApplicationRequest, SuccessResponse, TrackAppTypeRequest, User, UserInstalledSkill, UserInstalledSkillsListResponse, VideoDetails };
+export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, ErrorCode, SeaVerseBackendAPIClient, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
+export type { AccountExistsErrorDetails, ApiError, ApiServiceTokenResponse, AuthModalOptions, AuthModalResult, Container, ContainerDetailResponse, ContainerListResponse, ContainerStatsResponse, ConversationStatus, CreateMarketplaceSkillRequest, CreateVideoShareRequest, CreateVideoShareResponse, Environment, EnvironmentConfig, ForgotPasswordRequest, ForkProjectRequest, ForkProjectResponse, HealthResponse, HubProject, HubProjectsListResponse, InviteApplication, InviteApplicationListResponse, InviteCodeBindRequest, InviteCodeGenerateResponse, InviteCodeVerifyResponse, LoginRequest, LoginResponse, MarketplaceSkill, MarketplaceSkillsListResponse, OAuthAuthorizeRequest, OAuthAuthorizeResponse, PublishProjectRequest, PublishSkillRequest, RegisterContainerRequest, RegisterContainerResponse, RegisterRequest, RegisterResponse, ResetPasswordRequest, SeaVerseBackendAPIClientOptions, SocialMediaLink, SocialMediaLinksResponse, SpeechTokenResponse, SubmitInviteApplicationRequest, SuccessResponse, TrackAppTypeRequest, User, UserInstalledSkill, UserInstalledSkillsListResponse, VideoDetails };