sa2kit 3.0.0 → 3.2.0

package/README.md

@@ -3,7 +3,7 @@
 一个现代的、类型安全的跨平台工具库。**2.0 重构进行中**：拆分为 `common`（通用逻辑，供 Web / Taro / Electron / Hono 等多项目接入）与 `business`（业务逻辑，逐步迁回 profile-v1）。
 
 > 📋 **重构任务 SSOT**：[docs/REFACTOR_2.0_BACKLOG.md](./docs/REFACTOR_2.0_BACKLOG.md)  
-> 当前版本：`2.0.4`（**common API 稳定**；business 实验田模块逐步迁出，见 [COMMON_API_FREEZE.md](./docs/COMMON_API_FREEZE.md)）
+> 当前版本：`3.2.0`（**common API 稳定**；business 实验田模块逐步迁出，见 [COMMON_API_FREEZE.md](./docs/COMMON_API_FREEZE.md)）
 
 ### 2.0 推荐 import（common）
 
@@ -13,14 +13,14 @@ import { uploadModuleFile } from 'sa2kit/common/file';
 import { createOssFileConfigManagerFromEnv } from 'sa2kit/common/file/server';
 ```
 
-旧路径（`sa2kit/logger`、`sa2kit/ossFile`）在 2.x 仍可用，后续标记 deprecated。
+npm 子路径仅保留 `sa2kit/common/*` 与 `sa2kit/business/*`（3.x 起已移除 `sa2kit/logger`、`sa2kit/mmd` 等旧 alias）。
 
 ## 2.0 目标架构（摘要）
 
 | 层级 | 入口 | 职责 |
 |------|------|------|
 | **common** | `sa2kit/common/*` | logger、utils、storage、request、ossFile、auth 内核等 |
-| **business** | `sa2kit/business/*` 及 legacy subpath | mikuContest、huarongdao 等；逐步迁回 profile-v1 |
+| **business** | `sa2kit/business/*` | mikuContest、calendar、mmd 等；逐步迁回 profile-v1 |
 
 ## 特性
 
@@ -64,7 +64,7 @@ pnpm add @qhr123/sa2kit
 ### 日志 (Logger)
 
 ```typescript
-import { logger, createLogger, LogLevel } from '@qhr123/sa2kit/logger';
+import { logger, createLogger, LogLevel } from '@qhr123/sa2kit/common/logger';
 
 // 使用默认日志记录器
 logger.info('应用程序已启动');
@@ -83,7 +83,7 @@ apiLogger.info('API 请求已完成');
 ### 工具函数 (Utility Functions)
 
 ```typescript
-import { stringUtils, arrayUtils, fileUtils } from '@qhr123/sa2kit/utils';
+import { stringUtils, arrayUtils, fileUtils } from '@qhr123/sa2kit/common/utils';
 
 // 字符串工具
 const capitalized = stringUtils.capitalize('hello world');

package/dist/AliyunOSSProvider-7IOT5U6M.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkZOP7YIVX_js = require('./chunk-ZOP7YIVX.js');
+require('./chunk-Z2SNB5LJ.js');
+require('./chunk-F2BZIU67.js');
+require('./chunk-NSBPE2FW.js');
+
+
+
+Object.defineProperty(exports, "AliyunOSSProvider", {
+  enumerable: true,
+  get: function () { return chunkZOP7YIVX_js.AliyunOSSProvider; }
+});
+//# sourceMappingURL=AliyunOSSProvider-7IOT5U6M.js.map
+//# sourceMappingURL=AliyunOSSProvider-7IOT5U6M.js.map

package/dist/AliyunOSSProvider-7IOT5U6M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AliyunOSSProvider-7IOT5U6M.js"}

package/dist/AliyunOSSProvider-ZXZM7OQA.mjs

@@ -0,0 +1,6 @@
+export { AliyunOSSProvider } from './chunk-HG34SGMN.mjs';
+import './chunk-BTW3SWQN.mjs';
+import './chunk-VYK4M2D6.mjs';
+import './chunk-MAI35PU6.mjs';
+//# sourceMappingURL=AliyunOSSProvider-ZXZM7OQA.mjs.map
+//# sourceMappingURL=AliyunOSSProvider-ZXZM7OQA.mjs.map

package/dist/AliyunOSSProvider-ZXZM7OQA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AliyunOSSProvider-ZXZM7OQA.mjs"}

package/dist/LocalStorageProvider-KJKRCKBS.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunk6HL54I2B_js = require('./chunk-6HL54I2B.js');
+require('./chunk-Z2SNB5LJ.js');
+require('./chunk-F2BZIU67.js');
+require('./chunk-NSBPE2FW.js');
+
+
+
+Object.defineProperty(exports, "LocalStorageProvider", {
+  enumerable: true,
+  get: function () { return chunk6HL54I2B_js.LocalStorageProvider; }
+});
+//# sourceMappingURL=LocalStorageProvider-KJKRCKBS.js.map
+//# sourceMappingURL=LocalStorageProvider-KJKRCKBS.js.map

package/dist/LocalStorageProvider-KJKRCKBS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"LocalStorageProvider-KJKRCKBS.js"}

package/dist/LocalStorageProvider-O22465NY.mjs

@@ -0,0 +1,6 @@
+export { LocalStorageProvider } from './chunk-RHHTZTIN.mjs';
+import './chunk-BTW3SWQN.mjs';
+import './chunk-VYK4M2D6.mjs';
+import './chunk-MAI35PU6.mjs';
+//# sourceMappingURL=LocalStorageProvider-O22465NY.mjs.map
+//# sourceMappingURL=LocalStorageProvider-O22465NY.mjs.map

package/dist/LocalStorageProvider-O22465NY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"LocalStorageProvider-O22465NY.mjs"}

package/dist/chunk-2234T4A6.js

@@ -0,0 +1,303 @@
+'use strict';
+
+var chunkNSBPE2FW_js = require('./chunk-NSBPE2FW.js');
+
+// src/common/api/index.ts
+var api_exports = {};
+chunkNSBPE2FW_js.__export(api_exports, {
+  BaseApiClient: () => BaseApiClient,
+  DEFAULT_API_ROUTES: () => DEFAULT_API_ROUTES,
+  DEFAULT_STORAGE_KEYS: () => DEFAULT_STORAGE_KEYS
+});
+
+// src/common/api/types.ts
+var DEFAULT_STORAGE_KEYS = {
+  AUTH_TOKEN: "auth_token",
+  USER_DATA: "user_data",
+  REFRESH_TOKEN: "refresh_token"
+};
+var DEFAULT_API_ROUTES = {
+  auth: {
+    login: "/auth/login",
+    logout: "/auth/logout",
+    register: "/auth/register",
+    me: "/auth/me"
+  },
+  users: {
+    list: "/users",
+    detail: (id) => "/users/" + id,
+    update: (id) => "/users/" + id,
+    delete: (id) => "/users/" + id
+  }
+};
+
+// src/common/api/BaseApiClient.ts
+var BaseApiClient = class {
+  constructor(config) {
+    this.token = null;
+    this.user = null;
+    this.baseUrl = config.baseUrl;
+    this.storage = config.storage;
+    this.request = config.request;
+    this.storageKeys = {
+      ...DEFAULT_STORAGE_KEYS,
+      ...config.storageKeys || {}
+    };
+    this.routes = {
+      ...DEFAULT_API_ROUTES,
+      ...config.routes || {},
+      auth: {
+        ...DEFAULT_API_ROUTES.auth,
+        ...config.routes?.auth || {}
+      },
+      users: {
+        ...DEFAULT_API_ROUTES.users,
+        ...config.routes?.users || {}
+      }
+    };
+  }
+  /**
+   * 初始化 - 从存储中加载 token 和用户信息
+   */
+  async init() {
+    try {
+      this.token = await this.storage.getItem(this.storageKeys.AUTH_TOKEN);
+      const userData = await this.storage.getItem(this.storageKeys.USER_DATA);
+      if (userData) {
+        this.user = JSON.parse(userData);
+      }
+    } catch (error) {
+      console.error("Failed to load auth data:", error);
+    }
+  }
+  /**
+   * 设置认证 token
+   */
+  async setToken(token) {
+    this.token = token;
+    if (token) {
+      await this.storage.setItem(this.storageKeys.AUTH_TOKEN, token);
+    } else {
+      await this.storage.removeItem(this.storageKeys.AUTH_TOKEN);
+    }
+  }
+  /**
+   * 设置用户信息
+   */
+  async setUser(user) {
+    this.user = user;
+    if (user) {
+      await this.storage.setItem(this.storageKeys.USER_DATA, JSON.stringify(user));
+    } else {
+      await this.storage.removeItem(this.storageKeys.USER_DATA);
+    }
+  }
+  /**
+   * 获取当前 token
+   */
+  getToken() {
+    return this.token;
+  }
+  /**
+   * 获取当前用户
+   */
+  getUser() {
+    return this.user;
+  }
+  /**
+   * 检查是否已登录
+   */
+  async isAuthenticated() {
+    return !!this.token;
+  }
+  /**
+   * 清除用户数据
+   */
+  async clearUserData() {
+    await this.storage.removeItem(this.storageKeys.AUTH_TOKEN);
+    await this.storage.removeItem(this.storageKeys.USER_DATA);
+    if (this.storageKeys.REFRESH_TOKEN) {
+      await this.storage.removeItem(this.storageKeys.REFRESH_TOKEN);
+    }
+    this.token = null;
+    this.user = null;
+  }
+  /**
+   * 发送请求的通用方法
+   */
+  async sendRequest(config) {
+    try {
+      const headers = {
+        "Content-Type": "application/json",
+        ...config.headers || {}
+      };
+      if (this.token) {
+        headers["Authorization"] = "Bearer " + this.token;
+      }
+      const response = await this.request.request({
+        ...config,
+        url: this.baseUrl + config.url,
+        headers
+      });
+      return response;
+    } catch (error) {
+      console.error("API request error:", error);
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "\u7F51\u7EDC\u9519\u8BEF\uFF0C\u8BF7\u91CD\u8BD5"
+      };
+    }
+  }
+  /**
+   * 发送 GET 请求
+   */
+  async get(url, params) {
+    return this.sendRequest({ url, method: "GET", params });
+  }
+  /**
+   * 发送 POST 请求
+   */
+  async post(url, body) {
+    return this.sendRequest({ url, method: "POST", body });
+  }
+  /**
+   * 发送 PUT 请求
+   */
+  async put(url, body) {
+    return this.sendRequest({ url, method: "PUT", body });
+  }
+  /**
+   * 发送 PATCH 请求
+   */
+  async patch(url, body) {
+    return this.sendRequest({ url, method: "PATCH", body });
+  }
+  /**
+   * 发送 DELETE 请求
+   */
+  async delete(url) {
+    return this.sendRequest({ url, method: "DELETE" });
+  }
+  // ==================== 默认认证方法（子类可重写） ====================
+  /**
+   * 用户注册
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async register(email, password, username) {
+    if (!this.routes.auth?.register) {
+      throw new Error("Register route is not configured");
+    }
+    const response = await this.post(this.routes.auth.register, {
+      email,
+      password,
+      username
+    });
+    if (response.success && response.data) {
+      await this.setToken(response.data.token);
+      await this.setUser(response.data.user);
+      await this.onAuthSuccess?.(response.data.user, response.data.token);
+    } else if (!response.success) {
+      await this.onAuthError?.(response.error || "Registration failed");
+    }
+    return response;
+  }
+  /**
+   * 用户登录
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async login(email, password) {
+    if (!this.routes.auth?.login) {
+      throw new Error("Login route is not configured");
+    }
+    const response = await this.post(this.routes.auth.login, {
+      email,
+      password
+    });
+    if (response.success && response.data) {
+      await this.setToken(response.data.token);
+      await this.setUser(response.data.user);
+      await this.onAuthSuccess?.(response.data.user, response.data.token);
+    } else if (!response.success) {
+      await this.onAuthError?.(response.error || "Login failed");
+    }
+    return response;
+  }
+  /**
+   * 用户退出登录
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async logout() {
+    if (this.routes.auth?.logout) {
+      await this.post(this.routes.auth.logout);
+    }
+    await this.clearUserData();
+    await this.onLogout?.();
+  }
+  /**
+   * 获取当前用户信息
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async getCurrentUser() {
+    if (!this.routes.auth?.me) {
+      throw new Error("Current user route is not configured");
+    }
+    const response = await this.get(this.routes.auth.me);
+    if (response.success && response.data) {
+      const userData = response.data.user || response.data;
+      await this.setUser(userData);
+      return {
+        ...response,
+        data: userData
+      };
+    }
+    return response;
+  }
+  // ==================== 默认用户管理方法（子类可重写） ====================
+  /**
+   * 获取用户列表
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async getUsers(params) {
+    if (!this.routes.users?.list) {
+      throw new Error("Users list route is not configured");
+    }
+    return this.get(this.routes.users.list, params);
+  }
+  /**
+   * 获取用户详情
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async getUserById(userId) {
+    if (!this.routes.users?.detail) {
+      throw new Error("User detail route is not configured");
+    }
+    return this.get(this.routes.users.detail(userId));
+  }
+  /**
+   * 更新用户信息
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async updateUser(userId, data) {
+    if (!this.routes.users?.update) {
+      throw new Error("User update route is not configured");
+    }
+    return this.put(this.routes.users.update(userId), data);
+  }
+  /**
+   * 删除用户
+   * 默认实现，子类可重写以添加自定义逻辑
+   */
+  async deleteUser(userId) {
+    if (!this.routes.users?.delete) {
+      throw new Error("User delete route is not configured");
+    }
+    return this.delete(this.routes.users.delete(userId));
+  }
+};
+
+exports.BaseApiClient = BaseApiClient;
+exports.DEFAULT_API_ROUTES = DEFAULT_API_ROUTES;
+exports.DEFAULT_STORAGE_KEYS = DEFAULT_STORAGE_KEYS;
+exports.api_exports = api_exports;
+//# sourceMappingURL=chunk-2234T4A6.js.map
+//# sourceMappingURL=chunk-2234T4A6.js.map

package/dist/chunk-2234T4A6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/api/index.ts","../src/common/api/types.ts","../src/common/api/BaseApiClient.ts"],"names":["__export"],"mappings":"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","file":"chunk-2234T4A6.js","sourcesContent":["/**\n * API 模块\n * API Module\n *\n * 提供通用的 API 客户端基类和类型定义\n */\n\nexport * from './types';\nexport * from './BaseApiClient';\n\n// 重新导出依赖的适配器类型，方便使用\nexport type { StorageAdapter } from '../storage';\nexport type { RequestAdapter, RequestConfig } from '../request';\n\n// 导出常用的默认配置\nexport { DEFAULT_STORAGE_KEYS, DEFAULT_API_ROUTES } from './types';\n\n","/**\n * API 通用类型定义\n * Common API Types\n */\n\n/**\n * API 响应类型\n * Generic API Response Format\n */\nexport interface ApiResponse<T = any> {\n  success: boolean;\n  data?: T;\n  error?: string;\n  message?: string;\n  meta?: {\n    pagination?: {\n      page: number;\n      limit: number;\n      total: number;\n      pages: number;\n    };\n    [key: string]: any;\n  };\n}\n\n/**\n * 分页参数类型\n * Pagination Parameters\n */\nexport interface PaginationParams {\n  page?: number;\n  limit?: number;\n  search?: string;\n  sortBy?: string;\n  sortOrder?: 'asc' | 'desc';\n}\n\n/**\n * 认证响应类型（泛型）\n * Generic Auth Response\n */\nexport interface AuthResponse<TUser = any> {\n  user: TUser;\n  token: string;\n}\n\n/**\n * 默认存储键常量\n * Default Storage Keys\n */\nexport const DEFAULT_STORAGE_KEYS = {\n  AUTH_TOKEN: 'auth_token',\n  USER_DATA: 'user_data',\n  REFRESH_TOKEN: 'refresh_token',\n} as const;\n\n/**\n * 存储键类型（可扩展）\n * Storage Keys Type\n */\nexport type StorageKeys = typeof DEFAULT_STORAGE_KEYS;\n\n/**\n * API 路由配置\n * API Routes Configuration\n */\nexport interface ApiRoutes {\n  /** 认证相关路由 */\n  auth?: {\n    login?: string;\n    logout?: string;\n    register?: string;\n    me?: string;\n  };\n  /** 用户相关路由 */\n  users?: {\n    list?: string;\n    detail?: (id: string) => string;\n    update?: (id: string) => string;\n    delete?: (id: string) => string;\n  };\n  /** 自定义路由 */\n  [key: string]: any;\n}\n\n/**\n * 默认 API 路由\n */\nexport const DEFAULT_API_ROUTES: ApiRoutes = {\n  auth: {\n    login: '/auth/login',\n    logout: '/auth/logout',\n    register: '/auth/register',\n    me: '/auth/me',\n  },\n  users: {\n    list: '/users',\n    detail: (id: string) => '/users/' + (id),\n    update: (id: string) => '/users/' + (id),\n    delete: (id: string) => '/users/' + (id),\n  },\n};\n","/**\n * 基础 API 客户端（泛型）\n * Base API Client (Generic)\n *\n * 提供统一的 API 调用逻辑，通过适配器模式支持多平台\n * 使用泛型 TUser 支持不同项目的用户类型\n */\n\nimport type { StorageAdapter } from '../storage';\nimport type { RequestAdapter, RequestConfig } from '../request';\nimport type { ApiResponse, AuthResponse, StorageKeys, ApiRoutes } from './types';\nimport { DEFAULT_STORAGE_KEYS, DEFAULT_API_ROUTES } from './types';\n\n/**\n * 基础 API 客户端配置\n */\nexport interface BaseApiClientConfig {\n  /** 基础 URL */\n  baseUrl: string;\n  /** 存储适配器 */\n  storage: StorageAdapter;\n  /** 请求适配器 */\n  request: RequestAdapter;\n  /** 自定义存储键（可选） */\n  storageKeys?: Partial<StorageKeys>;\n  /** API 路由配置（可选） */\n  routes?: ApiRoutes;\n}\n\n/**\n * 基础 API 客户端\n * @template TUser 用户类型（泛型）\n */\nexport class BaseApiClient<TUser = any> {\n  protected token: string | null = null;\n  protected user: TUser | null = null;\n  protected baseUrl: string;\n  protected storage: StorageAdapter;\n  protected request: RequestAdapter;\n  protected storageKeys: StorageKeys;\n  protected routes: ApiRoutes;\n\n  constructor(config: BaseApiClientConfig) {\n    this.baseUrl = config.baseUrl;\n    this.storage = config.storage;\n    this.request = config.request;\n    this.storageKeys = {\n      ...DEFAULT_STORAGE_KEYS,\n      ...(config.storageKeys || {}),\n    };\n    this.routes = {\n      ...DEFAULT_API_ROUTES,\n      ...(config.routes || {}),\n      auth: {\n        ...DEFAULT_API_ROUTES.auth,\n        ...(config.routes?.auth || {}),\n      },\n      users: {\n        ...DEFAULT_API_ROUTES.users,\n        ...(config.routes?.users || {}),\n      },\n    };\n  }\n\n  /**\n   * 初始化 - 从存储中加载 token 和用户信息\n   */\n  async init(): Promise<void> {\n    try {\n      this.token = await this.storage.getItem(this.storageKeys.AUTH_TOKEN);\n      const userData = await this.storage.getItem(this.storageKeys.USER_DATA);\n      if (userData) {\n        this.user = JSON.parse(userData) as TUser;\n      }\n    } catch (error) {\n      console.error('Failed to load auth data:', error);\n    }\n  }\n\n  /**\n   * 设置认证 token\n   */\n  async setToken(token: string | null): Promise<void> {\n    this.token = token;\n    if (token) {\n      await this.storage.setItem(this.storageKeys.AUTH_TOKEN, token);\n    } else {\n      await this.storage.removeItem(this.storageKeys.AUTH_TOKEN);\n    }\n  }\n\n  /**\n   * 设置用户信息\n   */\n  async setUser(user: TUser | null): Promise<void> {\n    this.user = user;\n    if (user) {\n      await this.storage.setItem(this.storageKeys.USER_DATA, JSON.stringify(user));\n    } else {\n      await this.storage.removeItem(this.storageKeys.USER_DATA);\n    }\n  }\n\n  /**\n   * 获取当前 token\n   */\n  getToken(): string | null {\n    return this.token;\n  }\n\n  /**\n   * 获取当前用户\n   */\n  getUser(): TUser | null {\n    return this.user;\n  }\n\n  /**\n   * 检查是否已登录\n   */\n  async isAuthenticated(): Promise<boolean> {\n    return !!this.token;\n  }\n\n  /**\n   * 清除用户数据\n   */\n  async clearUserData(): Promise<void> {\n    await this.storage.removeItem(this.storageKeys.AUTH_TOKEN);\n    await this.storage.removeItem(this.storageKeys.USER_DATA);\n    if (this.storageKeys.REFRESH_TOKEN) {\n      await this.storage.removeItem(this.storageKeys.REFRESH_TOKEN);\n    }\n    this.token = null;\n    this.user = null;\n  }\n\n  /**\n   * 发送请求的通用方法\n   */\n  protected async sendRequest<T = any>(config: RequestConfig): Promise<ApiResponse<T>> {\n    try {\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n        ...(config.headers || {}),\n      };\n\n      // 添加认证 token\n      if (this.token) {\n        headers['Authorization'] = 'Bearer ' + (this.token);\n      }\n\n      const response = await this.request.request<ApiResponse<T>>({\n        ...config,\n        url: (this.baseUrl) + (config.url),\n        headers,\n      });\n\n      return response;\n    } catch (error) {\n      console.error('API request error:', error);\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : '网络错误，请重试',\n      };\n    }\n  }\n\n  /**\n   * 发送 GET 请求\n   */\n  async get<T = any>(url: string, params?: Record<string, any>): Promise<ApiResponse<T>> {\n    return this.sendRequest({ url, method: 'GET', params });\n  }\n\n  /**\n   * 发送 POST 请求\n   */\n  async post<T = any>(url: string, body?: any): Promise<ApiResponse<T>> {\n    return this.sendRequest({ url, method: 'POST', body });\n  }\n\n  /**\n   * 发送 PUT 请求\n   */\n  async put<T = any>(url: string, body?: any): Promise<ApiResponse<T>> {\n    return this.sendRequest({ url, method: 'PUT', body });\n  }\n\n  /**\n   * 发送 PATCH 请求\n   */\n  async patch<T = any>(url: string, body?: any): Promise<ApiResponse<T>> {\n    return this.sendRequest({ url, method: 'PATCH', body });\n  }\n\n  /**\n   * 发送 DELETE 请求\n   */\n  async delete<T = any>(url: string): Promise<ApiResponse<T>> {\n    return this.sendRequest({ url, method: 'DELETE' });\n  }\n\n  // ==================== 默认认证方法（子类可重写） ====================\n\n  /**\n   * 用户注册\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async register(\n    email: string,\n    password: string,\n    username: string\n  ): Promise<ApiResponse<AuthResponse<TUser>>> {\n    if (!this.routes.auth?.register) {\n      throw new Error('Register route is not configured');\n    }\n\n    const response = await this.post<AuthResponse<TUser>>(this.routes.auth.register, {\n      email,\n      password,\n      username,\n    });\n\n    if (response.success && response.data) {\n      await this.setToken(response.data.token);\n      await this.setUser(response.data.user);\n      await this.onAuthSuccess?.(response.data.user, response.data.token);\n    } else if (!response.success) {\n      await this.onAuthError?.(response.error || 'Registration failed');\n    }\n\n    return response;\n  }\n\n  /**\n   * 用户登录\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async login(email: string, password: string): Promise<ApiResponse<AuthResponse<TUser>>> {\n    if (!this.routes.auth?.login) {\n      throw new Error('Login route is not configured');\n    }\n\n    const response = await this.post<AuthResponse<TUser>>(this.routes.auth.login, {\n      email,\n      password,\n    });\n\n    if (response.success && response.data) {\n      await this.setToken(response.data.token);\n      await this.setUser(response.data.user);\n      await this.onAuthSuccess?.(response.data.user, response.data.token);\n    } else if (!response.success) {\n      await this.onAuthError?.(response.error || 'Login failed');\n    }\n\n    return response;\n  }\n\n  /**\n   * 用户退出登录\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async logout(): Promise<void> {\n    if (this.routes.auth?.logout) {\n      await this.post<void>(this.routes.auth.logout);\n    }\n\n    // 无论请求成功与否，都清除本地数据\n    await this.clearUserData();\n    await this.onLogout?.();\n  }\n\n  /**\n   * 获取当前用户信息\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async getCurrentUser(): Promise<ApiResponse<TUser>> {\n    if (!this.routes.auth?.me) {\n      throw new Error('Current user route is not configured');\n    }\n\n    const response = await this.get<any>(this.routes.auth.me);\n\n    // 统一处理响应格式：自动展开 response.data.user 为 response.data\n    if (response.success && response.data) {\n      // 如果 data 是嵌套的 {user: {...}, session: {...}} 格式，提取 user\n      const userData = response.data.user || response.data;\n\n      await this.setUser(userData);\n\n      return {\n        ...response,\n        data: userData,\n      };\n    }\n\n    return response;\n  }\n\n  // ==================== 默认用户管理方法（子类可重写） ====================\n\n  /**\n   * 获取用户列表\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async getUsers(params?: {\n    page?: number;\n    limit?: number;\n    search?: string;\n  }): Promise<ApiResponse<{ users: TUser[]; total: number }>> {\n    if (!this.routes.users?.list) {\n      throw new Error('Users list route is not configured');\n    }\n\n    return this.get(this.routes.users.list, params);\n  }\n\n  /**\n   * 获取用户详情\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async getUserById(userId: string): Promise<ApiResponse<TUser>> {\n    if (!this.routes.users?.detail) {\n      throw new Error('User detail route is not configured');\n    }\n\n    return this.get(this.routes.users.detail(userId));\n  }\n\n  /**\n   * 更新用户信息\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async updateUser(userId: string, data: Partial<TUser>): Promise<ApiResponse<TUser>> {\n    if (!this.routes.users?.update) {\n      throw new Error('User update route is not configured');\n    }\n\n    return this.put(this.routes.users.update(userId), data);\n  }\n\n  /**\n   * 删除用户\n   * 默认实现，子类可重写以添加自定义逻辑\n   */\n  async deleteUser(userId: string): Promise<ApiResponse<void>> {\n    if (!this.routes.users?.delete) {\n      throw new Error('User delete route is not configured');\n    }\n\n    return this.delete(this.routes.users.delete(userId));\n  }\n\n  // ==================== 子类可重写的钩子方法 ====================\n\n  /**\n   * 请求前钩子（子类可重写）\n   */\n  protected async onBeforeRequest?(config: RequestConfig): Promise<RequestConfig>;\n\n  /**\n   * 请求后钩子（子类可重写）\n   */\n  protected async onAfterRequest?<T>(response: ApiResponse<T>): Promise<ApiResponse<T>>;\n\n  /**\n   * 请求错误钩子（子类可重写）\n   */\n  protected async onRequestError?(error: Error): Promise<void>;\n\n  /**\n   * 认证成功钩子（子类可重写）\n   */\n  protected async onAuthSuccess?(user: TUser, token: string): Promise<void>;\n\n  /**\n   * 认证失败钩子（子类可重写）\n   */\n  protected async onAuthError?(error: string): Promise<void>;\n\n  /**\n   * 登出钩子（子类可重写）\n   */\n  protected async onLogout?(): Promise<void>;\n}\n\n"]}

package/dist/chunk-36KGNXKW.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunkPA4ELVGI_js = require('./chunk-PA4ELVGI.js');
+var chunkYTGUIRRH_js = require('./chunk-YTGUIRRH.js');
+var chunkNSBPE2FW_js = require('./chunk-NSBPE2FW.js');
+
+// src/common/auth/index.ts
+var auth_exports = {};
+chunkNSBPE2FW_js.__export(auth_exports, {
+  createSa2kitAuthClient: () => chunkPA4ELVGI_js.createSa2kitAuthClient,
+  useSession: () => chunkYTGUIRRH_js.useSession
+});
+
+exports.auth_exports = auth_exports;
+//# sourceMappingURL=chunk-36KGNXKW.js.map
+//# sourceMappingURL=chunk-36KGNXKW.js.map

package/dist/chunk-36KGNXKW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/auth/index.ts"],"names":["__export","createSa2kitAuthClient","useSession"],"mappings":";;;;;;;AAAA,IAAA,YAAA,GAAA;AAAAA,yBAAA,CAAA,YAAA,EAAA;AAAA,EAAA,sBAAA,EAAA,MAAAC,uCAAA;AAAA,EAAA,UAAA,EAAA,MAAAC;AAAA,CAAA,CAAA","file":"chunk-36KGNXKW.js","sourcesContent":["/**\n * @package sa2kit/common/auth\n *\n * Browser / client 安全入口（Better Auth 3.0）\n */\nexport {\n  createSa2kitAuthClient,\n  type Sa2kitAuthClient,\n  type Sa2kitAuthClientOptions,\n} from './client';\nexport { useSession, type UseSessionReturn } from './hooks/useSession';\n\nexport * from './types';\n"]}