seaverse-auth-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,903 @@
+import { AxiosRequestConfig, AxiosResponse } from 'axios';
+
+type AuthType = 'apiKey' | 'oauth2' | 'jwt' | 'basic' | 'custom';
+interface BaseCredentials {
+    type: AuthType;
+}
+interface ApiKeyCredentials extends BaseCredentials {
+    type: 'apiKey';
+    apiKey: string;
+    location: 'header' | 'query';
+    name: string;
+}
+interface OAuth2Credentials extends BaseCredentials {
+    type: 'oauth2';
+    clientId: string;
+    clientSecret: string;
+    tokenUrl: string;
+    accessToken?: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    scope?: string;
+}
+interface JWTCredentials extends BaseCredentials {
+    type: 'jwt';
+    token: string;
+    headerName?: string;
+}
+interface BasicAuthCredentials extends BaseCredentials {
+    type: 'basic';
+    username: string;
+    password: string;
+}
+interface CustomAuthCredentials extends BaseCredentials {
+    type: 'custom';
+    handler: (config: AxiosRequestConfig) => Promise<AxiosRequestConfig>;
+}
+type Credentials = ApiKeyCredentials | OAuth2Credentials | JWTCredentials | BasicAuthCredentials | CustomAuthCredentials;
+interface AuthConfig {
+    type: AuthType;
+    credentials: Credentials;
+}
+
+/**
+ * 认证提供者抽象基类
+ */
+declare abstract class AuthProvider {
+    protected credentials: Credentials;
+    constructor(credentials: Credentials);
+    /**
+     * 将认证信息附加到请求配置
+     * @param config Axios请求配置
+     * @returns 附加认证信息后的请求配置
+     */
+    abstract attachCredentials(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
+    /**
+     * 刷新凭证（如token）
+     */
+    abstract refreshCredentials(): Promise<void>;
+    /**
+     * 验证凭证是否有效
+     */
+    abstract isValid(): Promise<boolean>;
+    /**
+     * 获取当前凭证
+     */
+    getCredentials(): Credentials;
+    /**
+     * 更新凭证
+     */
+    updateCredentials(credentials: Partial<Credentials>): void;
+}
+
+/**
+ * 认证提供者工厂
+ */
+declare class AuthFactory {
+    /**
+     * 根据配置创建认证提供者
+     */
+    static create(config: AuthConfig): AuthProvider;
+    /**
+     * 根据凭证创建认证提供者
+     */
+    static createFromCredentials(credentials: Credentials): AuthProvider;
+    /**
+     * 从环境变量创建认证提供者
+     */
+    static fromEnv(): AuthProvider;
+    /**
+     * 从配置文件创建认证提供者
+     */
+    static fromFile(path: string): Promise<AuthProvider>;
+    /**
+     * 从profile创建认证提供者
+     */
+    static fromProfile(profileName?: string): Promise<AuthProvider>;
+}
+
+type HookType = 'beforeRequest' | 'afterResponse' | 'onError' | 'onRetry';
+interface HookContext {
+    operationId: string;
+    config: AxiosRequestConfig;
+    response?: AxiosResponse;
+    error?: any;
+    retryCount?: number;
+    metadata?: Record<string, any>;
+}
+type HookFunction = (context: HookContext) => Promise<void> | void;
+interface HookFilter {
+    operationIds?: string[];
+    methods?: string[];
+    pathPatterns?: RegExp[];
+}
+interface Hook {
+    type: HookType;
+    name: string;
+    priority: number;
+    handler: HookFunction;
+    filter?: HookFilter;
+}
+interface HookManagerOptions {
+    hooks?: Hook[];
+    enableBuiltInHooks?: {
+        logger?: boolean;
+        requestId?: boolean;
+        retry?: boolean;
+        rateLimit?: boolean;
+        cache?: boolean;
+        metrics?: boolean;
+    };
+    loggerOptions?: LoggerOptions;
+    retryOptions?: RetryOptions;
+    rateLimitOptions?: RateLimitOptions;
+    cacheOptions?: CacheOptions;
+    metricsOptions?: MetricsOptions;
+}
+interface LoggerOptions {
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    logRequestBody?: boolean;
+    logResponseBody?: boolean;
+    logHeaders?: boolean;
+}
+interface RetryOptions {
+    maxRetries?: number;
+    retryDelay?: number;
+    retryStatusCodes?: number[];
+    backoffMultiplier?: number;
+}
+interface RateLimitOptions {
+    requestsPerSecond?: number;
+    requestsPerMinute?: number;
+}
+interface CacheOptions {
+    ttl?: number;
+    maxSize?: number;
+    methods?: string[];
+}
+interface MetricsOptions {
+    enabled?: boolean;
+    collector?: (metrics: RequestMetrics) => void;
+}
+interface RequestMetrics {
+    operationId: string;
+    method: string;
+    path: string;
+    statusCode?: number;
+    duration: number;
+    timestamp: number;
+    error?: string;
+}
+
+/**
+ * 内置Hook集合
+ */
+declare class BuiltInHooks {
+    /**
+     * 创建日志记录Hook
+     */
+    static createLoggerHook(options?: LoggerOptions): Hook;
+    /**
+     * 创建请求ID Hook
+     */
+    static createRequestIdHook(): Hook;
+    /**
+     * 创建速率限制Hook
+     */
+    static createRateLimitHook(options?: RateLimitOptions): Hook;
+    /**
+     * 创建缓存Hook（简化版）
+     */
+    static createCacheHook(options?: CacheOptions): Hook;
+    /**
+     * 创建性能监控Hook
+     */
+    static createMetricsHook(options?: MetricsOptions): Hook;
+    /**
+     * 创建重试Hook（需要在interceptor中实现真正的重试逻辑）
+     */
+    static createRetryHook(maxRetries?: number, retryDelay?: number): Hook;
+}
+
+/**
+ * Type definitions for SeaVerse Dispatcher API
+ * Generated from auth.yaml OpenAPI specification
+ */
+/**
+ * User model
+ */
+interface User {
+    id?: string;
+    email?: string;
+    username?: string;
+    createdAt?: number;
+    emailVerified?: boolean;
+    googleId?: string;
+    discordId?: string;
+    githubId?: string;
+}
+/**
+ * Login request payload
+ */
+interface LoginRequest {
+    email: string;
+    password: string;
+}
+/**
+ * Login response
+ */
+interface LoginResponse {
+    token: string;
+    user: User;
+}
+/**
+ * Register request payload
+ */
+interface RegisterRequest {
+    email: string;
+    password: string;
+    invitationCode?: string;
+    fromShareAppId?: string;
+}
+/**
+ * Register response
+ */
+interface RegisterResponse {
+    success: boolean;
+    message: string;
+    userId: string;
+}
+/**
+ * Forgot password request
+ */
+interface ForgotPasswordRequest {
+    email: string;
+}
+/**
+ * Reset password request
+ */
+interface ResetPasswordRequest {
+    token: string;
+    newPassword: string;
+}
+/**
+ * OAuth code exchange request
+ */
+interface CodeToTokenRequest {
+    code: string;
+}
+/**
+ * OAuth code exchange response
+ */
+interface CodeToTokenResponse {
+    token: string;
+    user: User;
+}
+/**
+ * Health check response
+ */
+interface HealthResponse {
+    status: string;
+    service: string;
+    timestamp: number;
+}
+/**
+ * API service token response
+ */
+interface ApiServiceTokenResponse {
+    token: string;
+}
+/**
+ * Container model
+ */
+interface Container {
+    id: string;
+    status: 'healthy' | 'unhealthy' | 'disconnected';
+    backendUrl: string;
+    activeConnections: number;
+    maxConnections: number;
+    registeredAt: number;
+    lastHeartbeat: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Register container request
+ */
+interface RegisterContainerRequest {
+    id: string;
+    backendUrl: string;
+    maxConnections?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Register container response
+ */
+interface RegisterContainerResponse {
+    success: boolean;
+    container: Container;
+}
+/**
+ * Container list response
+ */
+interface ContainerListResponse {
+    containers: Container[];
+}
+/**
+ * Container detail response
+ */
+interface ContainerDetailResponse {
+    container: Container;
+}
+/**
+ * Container stats response
+ */
+interface ContainerStatsResponse {
+    totalContainers: number;
+    healthyContainers: number;
+    totalConnections: number;
+}
+/**
+ * Conversation status
+ */
+interface ConversationStatus {
+    conversation_id: string;
+    is_processing: boolean;
+    last_message_at: number | null;
+    last_stream_id: string | null;
+    backend_ws_id: string | null;
+}
+/**
+ * Invite code generate response
+ */
+interface InviteCodeGenerateResponse {
+    code: string;
+    expiresAt: number;
+}
+/**
+ * Invite code verify response
+ */
+interface InviteCodeVerifyResponse {
+    valid: boolean;
+    code: string;
+}
+/**
+ * Invite code bind request
+ */
+interface InviteCodeBindRequest {
+    code: string;
+    userId: string;
+}
+/**
+ * Invite application
+ */
+interface InviteApplication {
+    id: string;
+    email: string;
+    reason: string;
+    status: 'pending' | 'approved' | 'rejected';
+    createdAt: number;
+    reviewedAt: number | null;
+    inviteCode: string | null;
+}
+/**
+ * Submit invite application request
+ */
+interface SubmitInviteApplicationRequest {
+    email: string;
+    reason: string;
+}
+/**
+ * Invite application list response
+ */
+interface InviteApplicationListResponse {
+    applications: InviteApplication[];
+}
+/**
+ * Marketplace skill
+ */
+interface MarketplaceSkill {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    category: string;
+    tags: string[];
+    authorId: string;
+    version: string;
+    downloads: number;
+    stars: number;
+    status: 'draft' | 'published' | 'archived';
+    featured: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Create marketplace skill request
+ */
+interface CreateMarketplaceSkillRequest {
+    name: string;
+    title: string;
+    description: string;
+    category: string;
+    tags?: string[];
+    version?: string;
+    featured?: boolean;
+}
+/**
+ * Marketplace skills list response
+ */
+interface MarketplaceSkillsListResponse {
+    skills: MarketplaceSkill[];
+    lastKey?: string;
+}
+/**
+ * User installed skill
+ */
+interface UserInstalledSkill {
+    name: string;
+    marketplaceId: string;
+    version: string;
+    installedAt: number;
+}
+/**
+ * User installed skills list response
+ */
+interface UserInstalledSkillsListResponse {
+    skills: UserInstalledSkill[];
+}
+/**
+ * Publish skill to marketplace request
+ */
+interface PublishSkillRequest {
+    name: string;
+    title: string;
+    description: string;
+    category: string;
+    tags?: string[];
+    version?: string;
+}
+/**
+ * Hub project
+ */
+interface HubProject {
+    id: string;
+    name: string;
+    description: string;
+    appId: string;
+    authorId: string;
+    tags: string[];
+    coverUrl: string;
+    visibility: 'public' | 'private';
+    forkCount: number;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Publish project to hub request
+ */
+interface PublishProjectRequest {
+    appId: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    coverUrl?: string;
+    visibility?: 'public' | 'private';
+}
+/**
+ * Fork project request
+ */
+interface ForkProjectRequest {
+    projectId: string;
+}
+/**
+ * Fork project response
+ */
+interface ForkProjectResponse {
+    success: boolean;
+    appId: string;
+}
+/**
+ * Hub projects list response
+ */
+interface HubProjectsListResponse {
+    projects: HubProject[];
+    cursor?: string;
+}
+/**
+ * Track app type request
+ */
+interface TrackAppTypeRequest {
+    appId: string;
+    appType: string;
+}
+/**
+ * Social media link
+ */
+interface SocialMediaLink {
+    id: string;
+    name: string;
+    url: string;
+    icon: string;
+    enabled: boolean;
+    order: number;
+}
+/**
+ * Social media links response
+ */
+interface SocialMediaLinksResponse {
+    links: SocialMediaLink[];
+}
+/**
+ * Speech token response
+ */
+interface SpeechTokenResponse {
+    success: boolean;
+    authToken: string;
+    region: string;
+    autoDetectLanguage: boolean;
+    candidateLanguages: string[];
+    expiresIn: number;
+    maxDuration: number;
+    timestamp: number;
+}
+/**
+ * Create video share request
+ */
+interface CreateVideoShareRequest {
+    assetId: string;
+    title: string;
+    videoUrl: string;
+    thumbnailUrl?: string;
+    expiryDays?: number;
+}
+/**
+ * Create video share response
+ */
+interface CreateVideoShareResponse {
+    videoId: string;
+    shareUrl: string;
+}
+/**
+ * Video details
+ */
+interface VideoDetails {
+    videoId: string;
+    title: string;
+    videoUrl: string;
+    thumbnailUrl?: string;
+    createdAt: number;
+}
+/**
+ * API error response
+ */
+interface ApiError {
+    error: string;
+    code: string;
+    details?: Record<string, any>;
+}
+/**
+ * Standard success response
+ */
+interface SuccessResponse {
+    success: boolean;
+    message?: string;
+}
+
+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;
+type models_ContainerStatsResponse = ContainerStatsResponse;
+type models_ConversationStatus = ConversationStatus;
+type models_CreateMarketplaceSkillRequest = CreateMarketplaceSkillRequest;
+type models_CreateVideoShareRequest = CreateVideoShareRequest;
+type models_CreateVideoShareResponse = CreateVideoShareResponse;
+type models_ForgotPasswordRequest = ForgotPasswordRequest;
+type models_ForkProjectRequest = ForkProjectRequest;
+type models_ForkProjectResponse = ForkProjectResponse;
+type models_HealthResponse = HealthResponse;
+type models_HubProject = HubProject;
+type models_HubProjectsListResponse = HubProjectsListResponse;
+type models_InviteApplication = InviteApplication;
+type models_InviteApplicationListResponse = InviteApplicationListResponse;
+type models_InviteCodeBindRequest = InviteCodeBindRequest;
+type models_InviteCodeGenerateResponse = InviteCodeGenerateResponse;
+type models_InviteCodeVerifyResponse = InviteCodeVerifyResponse;
+type models_LoginRequest = LoginRequest;
+type models_LoginResponse = LoginResponse;
+type models_MarketplaceSkill = MarketplaceSkill;
+type models_MarketplaceSkillsListResponse = MarketplaceSkillsListResponse;
+type models_PublishProjectRequest = PublishProjectRequest;
+type models_PublishSkillRequest = PublishSkillRequest;
+type models_RegisterContainerRequest = RegisterContainerRequest;
+type models_RegisterContainerResponse = RegisterContainerResponse;
+type models_RegisterRequest = RegisterRequest;
+type models_RegisterResponse = RegisterResponse;
+type models_ResetPasswordRequest = ResetPasswordRequest;
+type models_SocialMediaLink = SocialMediaLink;
+type models_SocialMediaLinksResponse = SocialMediaLinksResponse;
+type models_SpeechTokenResponse = SpeechTokenResponse;
+type models_SubmitInviteApplicationRequest = SubmitInviteApplicationRequest;
+type models_SuccessResponse = SuccessResponse;
+type models_TrackAppTypeRequest = TrackAppTypeRequest;
+type models_User = User;
+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 };
+}
+
+interface SeaVerseBackendAPIClientOptions {
+    baseURL?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    auth?: AuthProvider;
+    hooks?: HookManagerOptions;
+}
+/**
+ * SeaVerse Backend API Client
+ * SeaVerse Dispatcher API - 云原生 AI Agent 平台的统一网关服务
+ * @version 2.0.0
+ */
+declare class SeaVerseBackendAPIClient {
+    private httpClient;
+    constructor(options?: SeaVerseBackendAPIClientOptions);
+    /**
+     * Get default authentication configuration
+     */
+    private getDefaultAuth;
+    /**
+     * Get default hooks configuration
+     */
+    private getDefaultHooks;
+    /**
+     * Health check
+     * Check if the service is healthy
+     */
+    getHealth(options?: AxiosRequestConfig): Promise<HealthResponse>;
+    /**
+     * User registration
+     * Register a new user with email verification
+     */
+    register(data: RegisterRequest, options?: AxiosRequestConfig): Promise<RegisterResponse>;
+    /**
+     * User login
+     * Login with email and password
+     */
+    login(data: LoginRequest, options?: AxiosRequestConfig): Promise<LoginResponse>;
+    /**
+     * Get current user
+     * Get the authenticated user's information
+     */
+    getCurrentUser(options?: AxiosRequestConfig): Promise<User>;
+    /**
+     * User logout
+     * Logout the current user
+     */
+    logout(options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * Request password reset
+     * Send password reset email
+     */
+    forgotPassword(data: ForgotPasswordRequest, options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * Reset password
+     * Reset password with token from email
+     */
+    resetPassword(data: ResetPasswordRequest, options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * Get api-service token
+     * Generate token for accessing api-service from sandbox
+     */
+    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>;
+    /**
+     * Unlink Google account
+     * Unlink the user's Google account
+     */
+    unlinkGoogle(options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * Exchange Discord code for token
+     */
+    discordCodeToToken(data: CodeToTokenRequest, options?: AxiosRequestConfig): Promise<CodeToTokenResponse>;
+    /**
+     * Unlink Discord account
+     */
+    unlinkDiscord(options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * Exchange GitHub code for token
+     */
+    githubCodeToToken(data: CodeToTokenRequest, options?: AxiosRequestConfig): Promise<CodeToTokenResponse>;
+    /**
+     * Unlink GitHub account
+     */
+    unlinkGithub(options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * List all containers
+     */
+    listContainers(options?: AxiosRequestConfig): Promise<ContainerListResponse>;
+    /**
+     * Register a container
+     * Internal service call to register a new container
+     */
+    registerContainer(data: RegisterContainerRequest, options?: AxiosRequestConfig): Promise<RegisterContainerResponse>;
+    /**
+     * Get container by ID
+     */
+    getContainer(id: string, options?: AxiosRequestConfig): Promise<ContainerDetailResponse>;
+    /**
+     * Unregister a container
+     * Internal service call to unregister a container
+     */
+    unregisterContainer(id: string, options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * Get container statistics
+     */
+    getContainerStats(options?: AxiosRequestConfig): Promise<ContainerStatsResponse>;
+    /**
+     * Container heartbeat
+     * Internal service call to update container heartbeat
+     */
+    containerHeartbeat(id: string, options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * Get conversation status
+     * Query conversation streaming status from Redis
+     */
+    getConversationStatus(conversationId: string, options?: AxiosRequestConfig): Promise<ConversationStatus>;
+    /**
+     * List marketplace skills
+     */
+    listMarketplaceSkills(params?: {
+        category?: string;
+        status?: 'draft' | 'published' | 'archived';
+        authorId?: string;
+        featured?: boolean;
+        limit?: number;
+        lastKey?: string;
+    }, options?: AxiosRequestConfig): Promise<MarketplaceSkillsListResponse>;
+    /**
+     * Get skill details
+     */
+    getMarketplaceSkill(skillId: string, options?: AxiosRequestConfig): Promise<MarketplaceSkill>;
+    /**
+     * Install skill from marketplace
+     */
+    installSkill(skillId: string, options?: AxiosRequestConfig): Promise<SuccessResponse>;
+    /**
+     * List user installed skills
+     */
+    listUserSkills(options?: AxiosRequestConfig): Promise<UserInstalledSkillsListResponse>;
+    /**
+     * Uninstall skill
+     */
+    uninstallSkill(localName: string, options?: AxiosRequestConfig): Promise<void>;
+    /**
+     * Get Azure Speech token
+     * Get temporary token for Azure Speech Service
+     */
+    getSpeechToken(options?: AxiosRequestConfig): Promise<SpeechTokenResponse>;
+    /**
+     * @deprecated Use register() instead
+     */
+    postapiauthregister(data: any, options?: AxiosRequestConfig): Promise<any>;
+    /**
+     * @deprecated Use login() instead
+     */
+    postapiauthlogin(data: any, options?: AxiosRequestConfig): Promise<any>;
+    /**
+     * @deprecated Use getHealth() instead
+     */
+    gethealth(options?: AxiosRequestConfig): Promise<any>;
+    /**
+     * @deprecated Use listContainers() instead
+     */
+    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;
+}
+interface AuthModalResult {
+    success: boolean;
+    token?: string;
+    user?: any;
+    error?: Error;
+}
+declare class AuthModal {
+    private client;
+    private options;
+    private modal;
+    private currentView;
+    constructor(options: AuthModalOptions);
+    /**
+     * Show the authentication modal
+     */
+    show(initialView?: 'login' | 'signup'): void;
+    /**
+     * Hide the authentication modal
+     */
+    hide(): void;
+    /**
+     * Destroy the modal and remove from DOM
+     */
+    destroy(): void;
+    private createModal;
+    private createLeftPanel;
+    private createRightPanel;
+    private createLoginForm;
+    private createSignupForm;
+    private createForgotPasswordForm;
+    private createSuccessMessage;
+    private createFormGroup;
+    private createPasswordInput;
+    private createSocialButton;
+    private bindEventListeners;
+    /**
+     * Bind click events to social login buttons
+     */
+    private bindSocialLoginButtons;
+    private switchView;
+    private handleLogin;
+    private handleSignup;
+    private handleForgotPassword;
+    private showMessage;
+    private showError;
+    /**
+     * Start OAuth flow for a given provider
+     */
+    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
+     */
+    static handleOAuthCallbackFromUrl(client: SeaVerseBackendAPIClient, options?: Omit<AuthModalOptions, 'client'>): Promise<AuthModalResult | null>;
+}
+/**
+ * Create and show auth modal
+ */
+declare function createAuthModal(options: AuthModalOptions): AuthModal;
+
+export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, SeaVerseBackendAPIClient, createAuthModal, models };
+export type { ApiError, ApiServiceTokenResponse, AuthModalOptions, AuthModalResult, CodeToTokenRequest, CodeToTokenResponse, Container, ContainerDetailResponse, ContainerListResponse, ContainerStatsResponse, ConversationStatus, CreateMarketplaceSkillRequest, CreateVideoShareRequest, CreateVideoShareResponse, 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 };