@seaverse/auth-sdk 0.1.1 → 0.1.3

package/README.md

@@ -14,6 +14,7 @@ SeaVerse 认证 SDK - 提供完整的用户认证功能和精美的登录注册
 - 🎭 **主题支持** - 暗色/亮色主题切换
 - ⚡ **TypeScript** - 完整的类型定义
 - 🔒 **安全** - 内置 CSRF 保护
+- 🌍 **多环境支持** - 一键切换生产/测试/开发环境
 
 ## 安装
 
@@ -25,13 +26,30 @@ npm install @seaverseai/auth-sdk
 
 ### 1. API 客户端使用
 
+#### 方式 A：指定环境（推荐）
+
 ```typescript
 import { SeaVerseBackendAPIClient } from '@seaverseai/auth-sdk';
 
+// 正式环境
 const client = new SeaVerseBackendAPIClient({
-  baseURL: 'https://web.seaverse.dev',
+  environment: 'production',  // 'production' | 'staging' | 'development' | 'local'
 });
 
+// 或者测试环境
+const client = new SeaVerseBackendAPIClient({
+  environment: 'staging',
+});
+```
+
+#### 方式 B：自动检测环境
+
+```typescript
+import { SeaVerseBackendAPIClient } from '@seaverseai/auth-sdk';
+
+// SDK 会根据当前域名自动选择环境
+const client = new SeaVerseBackendAPIClient();
+
 // 注册
 const registerResult = await client.register({
   email: 'user@example.com',
@@ -61,7 +79,7 @@ import { SeaVerseBackendAPIClient, createAuthModal } from '@seaverseai/auth-sdk'
 import '@seaverseai/auth-sdk/src/auth-modal.css';
 
 const client = new SeaVerseBackendAPIClient({
-  baseURL: 'https://web.seaverse.dev',
+  baseURL: 'https://account-hub.sg.seaverse.dev',
 });
 
 const authModal = createAuthModal({
@@ -129,7 +147,7 @@ authModal.show('login');
 import { SeaVerseBackendAPIClient, AuthModal } from '@seaverseai/auth-sdk';
 
 const client = new SeaVerseBackendAPIClient({
-  baseURL: 'https://web.seaverse.dev',
+  baseURL: 'https://account-hub.sg.seaverse.dev',
 });
 
 // 自动处理 OAuth 回调
@@ -275,7 +293,7 @@ interface OAuthConfig {
     import { SeaVerseBackendAPIClient, createAuthModal } from '@seaverseai/auth-sdk';
 
     const client = new SeaVerseBackendAPIClient({
-      baseURL: 'https://web.seaverse.dev',
+      baseURL: 'https://account-hub.sg.seaverse.dev',
     });
 
     const authModal = createAuthModal({
@@ -315,7 +333,7 @@ function App() {
 
   useEffect(() => {
     const client = new SeaVerseBackendAPIClient({
-      baseURL: 'https://web.seaverse.dev',
+      baseURL: 'https://account-hub.sg.seaverse.dev',
     });
 
     const modal = createAuthModal({
@@ -349,7 +367,7 @@ function App() {
 import { AuthFactory } from '@seaverseai/auth-sdk';
 
 const client = new SeaVerseBackendAPIClient({
-  baseURL: 'https://web.seaverse.dev',
+  baseURL: 'https://account-hub.sg.seaverse.dev',
   auth: AuthFactory.create({
     type: 'jwt',
     credentials: {

package/dist/index.cjs

@@ -1026,6 +1026,112 @@ class AuthFactory {
     }
 }
 
+/**
+ * Environment Configuration for SeaVerse SDK
+ * 环境配置模块 - 支持多环境部署
+ */
+/**
+ * 预定义的环境配置
+ *
+ * 使用说明：
+ * - production: 正式生产环境
+ * - staging: 预发布环境（当前默认）
+ * - development: 开发测试环境
+ * - local: 本地开发环境
+ */
+const ENVIRONMENT_CONFIGS = {
+    production: {
+        name: 'production',
+        baseURL: 'https://api.seaverse.com',
+        wsURL: 'wss://api.seaverse.com',
+        isProduction: true,
+    },
+    staging: {
+        name: 'staging',
+        baseURL: 'https://account-hub.sg.seaverse.dev',
+        wsURL: 'wss://account-hub.sg.seaverse.dev',
+        isProduction: false,
+    },
+    development: {
+        name: 'development',
+        baseURL: 'https://api-dev.seaverse.dev',
+        wsURL: 'wss://api-dev.seaverse.dev',
+        isProduction: false,
+    },
+    local: {
+        name: 'local',
+        baseURL: 'http://localhost:8001',
+        wsURL: 'ws://localhost:8000',
+        isProduction: false,
+    },
+};
+/**
+ * 根据当前运行环境自动检测应该使用的环境配置
+ *
+ * 检测规则：
+ * 1. localhost/127.0.0.1 → local
+ * 2. 包含 -dev 或 .dev → development
+ * 3. 包含 staging → staging
+ * 4. 其他 → production (默认)
+ *
+ * @returns 检测到的环境类型
+ */
+function detectEnvironment() {
+    // Node.js 环境或非浏览器环境，默认返回 staging（安全起见）
+    if (typeof window === 'undefined' || typeof window.location === 'undefined') {
+        return 'staging';
+    }
+    const hostname = window.location.hostname.toLowerCase();
+    // 本地开发环境
+    if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '0.0.0.0') {
+        return 'local';
+    }
+    // 开发环境 (包含 -dev 或 .dev)
+    if (hostname.includes('-dev.') || hostname.includes('.dev') || hostname.endsWith('.dev')) {
+        return 'development';
+    }
+    // Staging 环境
+    if (hostname.includes('-staging.') || hostname.includes('staging.')) {
+        return 'staging';
+    }
+    // 默认使用 production
+    return 'production';
+}
+/**
+ * 获取环境配置
+ *
+ * @param env 环境类型，如果不提供则自动检测
+ * @returns 环境配置对象
+ */
+function getEnvironmentConfig(env) {
+    const targetEnv = env || detectEnvironment();
+    return ENVIRONMENT_CONFIGS[targetEnv];
+}
+/**
+ * 解析用户配置，返回最终的 baseURL
+ *
+ * 优先级：
+ * 1. 显式传入的 baseURL（最高优先级）
+ * 2. environment 参数指定的环境
+ * 3. 自动检测环境（最低优先级）
+ *
+ * @param options 用户配置选项
+ * @returns 最终使用的 baseURL
+ */
+function resolveBaseURL(options) {
+    // 优先级 1: 显式传入的 baseURL
+    if (options.baseURL) {
+        return options.baseURL;
+    }
+    // 优先级 2: environment 参数
+    if (options.environment) {
+        return ENVIRONMENT_CONFIGS[options.environment].baseURL;
+    }
+    // 优先级 3: 自动检测
+    const detectedEnv = detectEnvironment();
+    return ENVIRONMENT_CONFIGS[detectedEnv].baseURL;
+}
+
 /**
  * Type definitions for SeaVerse Dispatcher API
  * Generated from auth.yaml OpenAPI specification
@@ -1038,12 +1144,37 @@ var models = /*#__PURE__*/Object.freeze({
 /**
  * SeaVerse Backend API Client
  * SeaVerse Dispatcher API - 云原生 AI Agent 平台的统一网关服务
+ *
  * @version 2.0.0
+ *
+ * @example
+ * // 方式 1: 自动检测环境（推荐本地开发）
+ * const client = new SeaVerseBackendAPIClient();
+ *
+ * @example
+ * // 方式 2: 指定环境（推荐生产部署）
+ * const client = new SeaVerseBackendAPIClient({
+ *   environment: 'production',
+ * });
+ *
+ * @example
+ * // 方式 3: 自定义 URL（特殊需求）
+ * const client = new SeaVerseBackendAPIClient({
+ *   baseURL: 'https://custom-api.example.com',
+ * });
  */
 class SeaVerseBackendAPIClient {
     constructor(options = {}) {
+        // 使用智能配置解析，支持三种优先级：
+        // 1. 显式 baseURL（最高）
+        // 2. environment 参数
+        // 3. 自动检测（默认）
+        const finalBaseURL = resolveBaseURL({
+            baseURL: options.baseURL,
+            environment: options.environment,
+        });
         const httpOptions = {
-            baseURL: options.baseURL || 'https://web.seaverse.dev',
+            baseURL: finalBaseURL,
             timeout: options.timeout,
             headers: options.headers,
             auth: options.auth || this.getDefaultAuth(),
@@ -2296,9 +2427,10 @@ class AuthModal {
             return;
         }
         // Store the current state (to verify callback)
+        // ✅ 使用 localStorage 而不是 sessionStorage，避免跨页面跳转时丢失
         const state = this.generateRandomState();
-        sessionStorage.setItem('oauth_state', state);
-        sessionStorage.setItem('oauth_provider', provider);
+        localStorage.setItem('oauth_state', state);
+        localStorage.setItem('oauth_provider', provider);
         // Build authorization URL
         const authUrl = this.buildAuthUrl(provider, config, state);
         // Redirect to OAuth provider
@@ -2346,8 +2478,9 @@ class AuthModal {
     async handleOAuthCallback(code, state) {
         try {
             // Verify state
-            const storedState = sessionStorage.getItem('oauth_state');
-            const provider = sessionStorage.getItem('oauth_provider');
+            // ✅ 使用 localStorage 而不是 sessionStorage
+            const storedState = localStorage.getItem('oauth_state');
+            const provider = localStorage.getItem('oauth_provider');
             if (!storedState || storedState !== state) {
                 throw new Error('Invalid state parameter - possible CSRF attack');
             }
@@ -2355,8 +2488,8 @@ class AuthModal {
                 throw new Error('No provider stored in session');
             }
             // Clear stored state
-            sessionStorage.removeItem('oauth_state');
-            sessionStorage.removeItem('oauth_provider');
+            localStorage.removeItem('oauth_state');
+            localStorage.removeItem('oauth_provider');
             // Exchange code for token using the appropriate SDK method
             let response;
             switch (provider) {
@@ -2426,7 +2559,10 @@ exports.AuthFactory = AuthFactory;
 exports.AuthModal = AuthModal;
 exports.AuthProvider = AuthProvider;
 exports.BuiltInHooks = BuiltInHooks;
+exports.ENVIRONMENT_CONFIGS = ENVIRONMENT_CONFIGS;
 exports.SeaVerseBackendAPIClient = SeaVerseBackendAPIClient;
 exports.createAuthModal = createAuthModal;
+exports.detectEnvironment = detectEnvironment;
+exports.getEnvironmentConfig = getEnvironmentConfig;
 exports.models = models;
 //# sourceMappingURL=index.cjs.map