sa2kit 2.0.3 → 3.0.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.3`（**common API 稳定**；business 实验田模块逐步迁出，见 [COMMON_API_FREEZE.md](./docs/COMMON_API_FREEZE.md)）
+> 当前版本：`2.0.4`（**common API 稳定**；business 实验田模块逐步迁出，见 [COMMON_API_FREEZE.md](./docs/COMMON_API_FREEZE.md)）
 
 ### 2.0 推荐 import（common）
 

package/dist/{UniversalFileService-GsP6D3Rc.d.ts → UniversalFileService-CC4d3wkc.d.ts}

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'events';
-import { a as UploadFileInfo, S as StorageType, c as UploadProgress, F as FileMetadata, d as FileQueryOptions, e as PaginatedResult, B as BatchOperationResult, f as FileEventListener } from './types-DyG3ZV9V.js';
-import { U as UniversalFileServiceConfig, I as IStorageProvider, a as ICDNProvider, b as IFileProcessor } from './types-ERmJyjx8.js';
+import { U as UploadFileInfo, S as StorageType, a as UploadProgress, F as FileMetadata, b as FileQueryOptions, P as PaginatedResult, B as BatchOperationResult, c as FileEventListener } from './types-B6B210gX.js';
+import { U as UniversalFileServiceConfig, I as IStorageProvider, a as ICDNProvider, b as IFileProcessor } from './types-_rFX1atk.js';
 
 /**
  * 通用文件服务核心实现

package/dist/{UniversalFileService-BpvbZitV.d.mts → UniversalFileService-CzAE_G4V.d.mts}

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'events';
-import { a as UploadFileInfo, S as StorageType, c as UploadProgress, F as FileMetadata, d as FileQueryOptions, e as PaginatedResult, B as BatchOperationResult, f as FileEventListener } from './types-DyG3ZV9V.mjs';
-import { U as UniversalFileServiceConfig, I as IStorageProvider, a as ICDNProvider, b as IFileProcessor } from './types-BTiaMsBz.mjs';
+import { U as UploadFileInfo, S as StorageType, a as UploadProgress, F as FileMetadata, b as FileQueryOptions, P as PaginatedResult, B as BatchOperationResult, c as FileEventListener } from './types-B6B210gX.mjs';
+import { U as UniversalFileServiceConfig, I as IStorageProvider, a as ICDNProvider, b as IFileProcessor } from './types-Bdnte5EN.mjs';
 
 /**
  * 通用文件服务核心实现

package/dist/auth/client/index.d.mts

@@ -1,32 +1,13 @@
-export { B as BaseApiClient } from '../../base-api-client-DrL35Ea2.mjs';
+export { API_ROUTES, STORAGE_KEYS, Sa2kitAuthClient, Sa2kitAuthClientOptions, createSa2kitAuthClient } from '../../common/auth/client/index.mjs';
+export { B as BaseApiClient } from '../../base-api-client-DXLsq2yz.mjs';
 export { b as ApiResponse, c as AuthResponse, U as User } from '../../types-DCRvasyH.mjs';
+import 'zod/v4/core';
+import 'zod';
+import 'better-auth/plugins/email-otp';
+import 'better-auth/plugins/phone-number';
+import 'better-auth/client';
+import 'better-auth';
 import '../../types-BaZccpvk.mjs';
 import '../../types-CbTsi9CZ.mjs';
 import '../../enums-Dume-V5Y.mjs';
 import 'drizzle-orm/pg-core';
-
-/**
- * Auth Client - Types
- * API 客户端类型定义
- */
-
-/**
- * 存储键名
- */
-declare const STORAGE_KEYS: {
-    readonly AUTH_TOKEN: "auth_token";
-    readonly USER_DATA: "user_data";
-};
-/**
- * API 路由
- */
-declare const API_ROUTES: {
-    readonly AUTH: {
-        readonly LOGIN: "/auth/login";
-        readonly REGISTER: "/auth/register";
-        readonly LOGOUT: "/auth/logout";
-        readonly ME: "/auth/me";
-    };
-};
-
-export { API_ROUTES, STORAGE_KEYS };

package/dist/auth/client/index.d.ts

@@ -1,32 +1,13 @@
-export { B as BaseApiClient } from '../../base-api-client-B3wZZoaH.js';
+export { API_ROUTES, STORAGE_KEYS, Sa2kitAuthClient, Sa2kitAuthClientOptions, createSa2kitAuthClient } from '../../common/auth/client/index.js';
+export { B as BaseApiClient } from '../../base-api-client-BpmcQt4Q.js';
 export { b as ApiResponse, c as AuthResponse, U as User } from '../../types-C_W_CoUD.js';
+import 'zod/v4/core';
+import 'zod';
+import 'better-auth/plugins/email-otp';
+import 'better-auth/plugins/phone-number';
+import 'better-auth/client';
+import 'better-auth';
 import '../../types-BaZccpvk.js';
 import '../../types-CbTsi9CZ.js';
 import '../../enums-Dume-V5Y.js';
 import 'drizzle-orm/pg-core';
-
-/**
- * Auth Client - Types
- * API 客户端类型定义
- */
-
-/**
- * 存储键名
- */
-declare const STORAGE_KEYS: {
-    readonly AUTH_TOKEN: "auth_token";
-    readonly USER_DATA: "user_data";
-};
-/**
- * API 路由
- */
-declare const API_ROUTES: {
-    readonly AUTH: {
-        readonly LOGIN: "/auth/login";
-        readonly REGISTER: "/auth/register";
-        readonly LOGOUT: "/auth/logout";
-        readonly ME: "/auth/me";
-    };
-};
-
-export { API_ROUTES, STORAGE_KEYS };

package/dist/auth/client/index.js

@@ -1,21 +1,26 @@
 'use strict';
 
-var chunkVQ54PUQV_js = require('../../chunk-VQ54PUQV.js');
+var chunkS3PUP7N4_js = require('../../chunk-S3PUP7N4.js');
+var chunkS37OK2QG_js = require('../../chunk-S37OK2QG.js');
 require('../../chunk-NSBPE2FW.js');
 
 
 
+Object.defineProperty(exports, "createSa2kitAuthClient", {
+  enumerable: true,
+  get: function () { return chunkS3PUP7N4_js.createSa2kitAuthClient; }
+});
 Object.defineProperty(exports, "API_ROUTES", {
   enumerable: true,
-  get: function () { return chunkVQ54PUQV_js.API_ROUTES; }
+  get: function () { return chunkS37OK2QG_js.API_ROUTES; }
 });
 Object.defineProperty(exports, "BaseApiClient", {
   enumerable: true,
-  get: function () { return chunkVQ54PUQV_js.BaseApiClient; }
+  get: function () { return chunkS37OK2QG_js.BaseApiClient; }
 });
 Object.defineProperty(exports, "STORAGE_KEYS", {
   enumerable: true,
-  get: function () { return chunkVQ54PUQV_js.STORAGE_KEYS; }
+  get: function () { return chunkS37OK2QG_js.STORAGE_KEYS; }
 });
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/auth/client/index.mjs

@@ -1,4 +1,5 @@
-export { API_ROUTES, BaseApiClient, STORAGE_KEYS } from '../../chunk-YGI7UU2D.mjs';
+export { createSa2kitAuthClient } from '../../chunk-LHJKLUM7.mjs';
+export { API_ROUTES, BaseApiClient, STORAGE_KEYS } from '../../chunk-G4NFB2QA.mjs';
 import '../../chunk-MAI35PU6.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/auth/components/index.d.mts

@@ -1,227 +1,10 @@
-import React__default from 'react';
-import { H as HeadlessLoginFormProps, a as HeadlessRegisterFormProps } from '../../types-IYCqCk2g.mjs';
-export { B as BaseFormProps, L as LoginFormState, R as RegisterFormState } from '../../types-IYCqCk2g.mjs';
-import { B as BaseApiClient } from '../../base-api-client-DrL35Ea2.mjs';
-import { U as User } from '../../types-DCRvasyH.mjs';
-import '../../types-BaZccpvk.mjs';
-import '../../types-CbTsi9CZ.mjs';
+export { AdminLoginPage, AdminLoginPageProps, AuthGuard, AuthGuardProps, BaseFormProps, ForgotPasswordModal, ForgotPasswordModalProps, HeadlessLoginFormProps, HeadlessRegisterFormProps, HeadlessRegisterFormPropsLegacy, HeadlessSignInFormProps, HeadlessVerifyOtpFormProps, LoginForm, LoginModal, LoginModalProps, OtpChannel, RegisterForm, RegisterFormHeadless, RegisterFormHeadlessState, RegisterModal, RegisterModalProps, SignInForm, SignInFormState, SignInMode, UserMenu, UserMenuProps, VerifyOtpForm, VerifyOtpFormState, validateEmail, validatePassword, validatePhoneNumber } from '../../common/auth/components/index.mjs';
+export { L as LoginFormState, R as RegisterFormState } from '../../types.legacy-J-j-_ig_.mjs';
+import 'react';
+import '../../types-DCRvasyH.mjs';
 import '../../enums-Dume-V5Y.mjs';
 import 'drizzle-orm/pg-core';
-
-/**
- * Auth Components - LoginForm (Headless)
- * 无样式的登录表单组件
- */
-
-/**
- * Headless 登录表单组件
- *
- * 提供登录逻辑但不包含任何 UI 样式，
- * 使用 render props 模式让用户完全控制 UI
- *
- * @example
- * ```tsx
- * <LoginForm apiClient={apiClient}>
- *   {({ email, password, loading, error, handleEmailChange, handlePasswordChange, handleSubmit }) => (
- *     <form onSubmit={handleSubmit}>
- *       <input
- *         value={email}
- *         onChange={(e) => handleEmailChange(e.target.value)}
- *       />
- *       <input
- *         type="password"
- *         value={password}
- *         onChange={(e) => handlePasswordChange(e.target.value)}
- *       />
- *       {error && <div>{error}</div>}
- *       <button disabled={loading}>
- *         {loading ? '登录中...' : '登录'}
- *       </button>
- *     </form>
- *   )}
- * </LoginForm>
- * ```
- */
-declare function LoginForm({ apiClient, onSuccess, onError, children }: HeadlessLoginFormProps): React__default.JSX.Element;
-
-/**
- * Auth Components - RegisterForm (Headless)
- * 无样式的注册表单组件
- */
-
-/**
- * Headless 注册表单组件
- *
- * 提供注册逻辑但不包含任何 UI 样式，
- * 使用 render props 模式让用户完全控制 UI
- *
- * @example
- * ```tsx
- * <RegisterForm apiClient={apiClient}>
- *   {({ email, password, username, loading, error, handleEmailChange, handlePasswordChange, handleUsernameChange, handleSubmit }) => (
- *     <form onSubmit={handleSubmit}>
- *       <input
- *         value={email}
- *         onChange={(e) => handleEmailChange(e.target.value)}
- *       />
- *       <input
- *         value={username}
- *         onChange={(e) => handleUsernameChange(e.target.value)}
- *       />
- *       <input
- *         type="password"
- *         value={password}
- *         onChange={(e) => handlePasswordChange(e.target.value)}
- *       />
- *       {error && <div>{error}</div>}
- *       <button disabled={loading}>
- *         {loading ? '注册中...' : '注册'}
- *       </button>
- *     </form>
- *   )}
- * </RegisterForm>
- * ```
- */
-declare function RegisterForm({ apiClient, onSuccess, onError, children, }: HeadlessRegisterFormProps): React__default.JSX.Element;
-
-/**
- * Admin Login Page Component
- * 完整的管理后台登录页面组件
- *
- * 功能：
- * - 邮箱密码登录
- * - 开发环境测试账户自动填充
- * - Analytics 埋点集成
- * - 角色权限检查
- * - 响应式设计
- */
-
-interface AdminLoginPageProps {
-    /**
-     * API 客户端实例
-     */
-    apiClient: BaseApiClient;
-    /**
-     * 登录成功后的回调
-     */
-    onLoginSuccess?: (user: User) => void;
-    /**
-     * 登录失败的回调
-     */
-    onLoginError?: (error: string) => void;
-    /**
-     * 权限检查函数（可选）
-     * 返回 true 表示有权限，false 表示无权限
-     */
-    checkPermission?: (user: User) => boolean;
-    /**
-     * 权限不足时的错误消息
-     */
-    permissionDeniedMessage?: string;
-    /**
-     * 开发环境配置
-     */
-    devConfig?: {
-        /**
-         * 是否启用开发模式功能（自动填充等）
-         */
-        enabled?: boolean;
-        /**
-         * 测试账户邮箱
-         */
-        testEmail?: string;
-        /**
-         * 测试账户密码
-         */
-        testPassword?: string;
-        /**
-         * 自动填充延迟（毫秒）
-         */
-        autoFillDelay?: number;
-    };
-    /**
-     * 页面文本配置
-     */
-    texts?: {
-        appName?: string;
-        appDescription?: string;
-        pageTitle?: string;
-        pageSubtitle?: string;
-        emailLabel?: string;
-        emailPlaceholder?: string;
-        passwordLabel?: string;
-        passwordPlaceholder?: string;
-        loginButton?: string;
-        loggingInButton?: string;
-        fillTestAccount?: string;
-        copyCredentials?: string;
-        devModeLabel?: string;
-        testAccountInfo?: string;
-        testAccountFilled?: string;
-        footer?: string;
-    };
-    /**
-     * Analytics 集成（可选）
-     */
-    analytics?: {
-        /**
-         * 页面访问埋点
-         */
-        trackPageView?: (data: Record<string, any>) => void;
-        /**
-         * 登录成功埋点
-         */
-        trackLoginSuccess?: (user: User) => void;
-        /**
-         * 登录失败埋点
-         */
-        trackLoginFailed?: (error: string, email: string) => void;
-        /**
-         * 权限拒绝埋点
-         */
-        trackPermissionDenied?: (user: User) => void;
-        /**
-         * 设置用户信息
-         */
-        setUser?: (user: {
-            userId: string;
-            email: string;
-            role: string;
-        }) => void;
-    };
-    /**
-     * UI 组件（可选，用于自定义样式）
-     */
-    components?: {
-        Container?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-        }>;
-        Card?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-        }>;
-        Input?: React__default.ComponentType<any>;
-        Button?: React__default.ComponentType<any>;
-        Alert?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-        }>;
-        Badge?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-            variant?: string;
-        }>;
-    };
-    /**
-     * className 配置（用于 Tailwind CSS）
-     */
-    classNames?: {
-        container?: string;
-        card?: string;
-        header?: string;
-        form?: string;
-        input?: string;
-        button?: string;
-        alert?: string;
-    };
-}
-declare function AdminLoginPage(props: AdminLoginPageProps): React__default.JSX.Element;
-
-export { AdminLoginPage, type AdminLoginPageProps, HeadlessLoginFormProps, HeadlessRegisterFormProps, LoginForm, RegisterForm };
+import '../../useAuthActions-7S5dL7Oh.mjs';
+import '../../base-api-client-DXLsq2yz.mjs';
+import '../../types-BaZccpvk.mjs';
+import '../../types-CbTsi9CZ.mjs';

package/dist/auth/components/index.d.ts

@@ -1,227 +1,10 @@
-import React__default from 'react';
-import { H as HeadlessLoginFormProps, a as HeadlessRegisterFormProps } from '../../types-C5vUWf9u.js';
-export { B as BaseFormProps, L as LoginFormState, R as RegisterFormState } from '../../types-C5vUWf9u.js';
-import { B as BaseApiClient } from '../../base-api-client-B3wZZoaH.js';
-import { U as User } from '../../types-C_W_CoUD.js';
-import '../../types-BaZccpvk.js';
-import '../../types-CbTsi9CZ.js';
+export { AdminLoginPage, AdminLoginPageProps, AuthGuard, AuthGuardProps, BaseFormProps, ForgotPasswordModal, ForgotPasswordModalProps, HeadlessLoginFormProps, HeadlessRegisterFormProps, HeadlessRegisterFormPropsLegacy, HeadlessSignInFormProps, HeadlessVerifyOtpFormProps, LoginForm, LoginModal, LoginModalProps, OtpChannel, RegisterForm, RegisterFormHeadless, RegisterFormHeadlessState, RegisterModal, RegisterModalProps, SignInForm, SignInFormState, SignInMode, UserMenu, UserMenuProps, VerifyOtpForm, VerifyOtpFormState, validateEmail, validatePassword, validatePhoneNumber } from '../../common/auth/components/index.js';
+export { L as LoginFormState, R as RegisterFormState } from '../../types.legacy-J-j-_ig_.js';
+import 'react';
+import '../../types-C_W_CoUD.js';
 import '../../enums-Dume-V5Y.js';
 import 'drizzle-orm/pg-core';
-
-/**
- * Auth Components - LoginForm (Headless)
- * 无样式的登录表单组件
- */
-
-/**
- * Headless 登录表单组件
- *
- * 提供登录逻辑但不包含任何 UI 样式，
- * 使用 render props 模式让用户完全控制 UI
- *
- * @example
- * ```tsx
- * <LoginForm apiClient={apiClient}>
- *   {({ email, password, loading, error, handleEmailChange, handlePasswordChange, handleSubmit }) => (
- *     <form onSubmit={handleSubmit}>
- *       <input
- *         value={email}
- *         onChange={(e) => handleEmailChange(e.target.value)}
- *       />
- *       <input
- *         type="password"
- *         value={password}
- *         onChange={(e) => handlePasswordChange(e.target.value)}
- *       />
- *       {error && <div>{error}</div>}
- *       <button disabled={loading}>
- *         {loading ? '登录中...' : '登录'}
- *       </button>
- *     </form>
- *   )}
- * </LoginForm>
- * ```
- */
-declare function LoginForm({ apiClient, onSuccess, onError, children }: HeadlessLoginFormProps): React__default.JSX.Element;
-
-/**
- * Auth Components - RegisterForm (Headless)
- * 无样式的注册表单组件
- */
-
-/**
- * Headless 注册表单组件
- *
- * 提供注册逻辑但不包含任何 UI 样式，
- * 使用 render props 模式让用户完全控制 UI
- *
- * @example
- * ```tsx
- * <RegisterForm apiClient={apiClient}>
- *   {({ email, password, username, loading, error, handleEmailChange, handlePasswordChange, handleUsernameChange, handleSubmit }) => (
- *     <form onSubmit={handleSubmit}>
- *       <input
- *         value={email}
- *         onChange={(e) => handleEmailChange(e.target.value)}
- *       />
- *       <input
- *         value={username}
- *         onChange={(e) => handleUsernameChange(e.target.value)}
- *       />
- *       <input
- *         type="password"
- *         value={password}
- *         onChange={(e) => handlePasswordChange(e.target.value)}
- *       />
- *       {error && <div>{error}</div>}
- *       <button disabled={loading}>
- *         {loading ? '注册中...' : '注册'}
- *       </button>
- *     </form>
- *   )}
- * </RegisterForm>
- * ```
- */
-declare function RegisterForm({ apiClient, onSuccess, onError, children, }: HeadlessRegisterFormProps): React__default.JSX.Element;
-
-/**
- * Admin Login Page Component
- * 完整的管理后台登录页面组件
- *
- * 功能：
- * - 邮箱密码登录
- * - 开发环境测试账户自动填充
- * - Analytics 埋点集成
- * - 角色权限检查
- * - 响应式设计
- */
-
-interface AdminLoginPageProps {
-    /**
-     * API 客户端实例
-     */
-    apiClient: BaseApiClient;
-    /**
-     * 登录成功后的回调
-     */
-    onLoginSuccess?: (user: User) => void;
-    /**
-     * 登录失败的回调
-     */
-    onLoginError?: (error: string) => void;
-    /**
-     * 权限检查函数（可选）
-     * 返回 true 表示有权限，false 表示无权限
-     */
-    checkPermission?: (user: User) => boolean;
-    /**
-     * 权限不足时的错误消息
-     */
-    permissionDeniedMessage?: string;
-    /**
-     * 开发环境配置
-     */
-    devConfig?: {
-        /**
-         * 是否启用开发模式功能（自动填充等）
-         */
-        enabled?: boolean;
-        /**
-         * 测试账户邮箱
-         */
-        testEmail?: string;
-        /**
-         * 测试账户密码
-         */
-        testPassword?: string;
-        /**
-         * 自动填充延迟（毫秒）
-         */
-        autoFillDelay?: number;
-    };
-    /**
-     * 页面文本配置
-     */
-    texts?: {
-        appName?: string;
-        appDescription?: string;
-        pageTitle?: string;
-        pageSubtitle?: string;
-        emailLabel?: string;
-        emailPlaceholder?: string;
-        passwordLabel?: string;
-        passwordPlaceholder?: string;
-        loginButton?: string;
-        loggingInButton?: string;
-        fillTestAccount?: string;
-        copyCredentials?: string;
-        devModeLabel?: string;
-        testAccountInfo?: string;
-        testAccountFilled?: string;
-        footer?: string;
-    };
-    /**
-     * Analytics 集成（可选）
-     */
-    analytics?: {
-        /**
-         * 页面访问埋点
-         */
-        trackPageView?: (data: Record<string, any>) => void;
-        /**
-         * 登录成功埋点
-         */
-        trackLoginSuccess?: (user: User) => void;
-        /**
-         * 登录失败埋点
-         */
-        trackLoginFailed?: (error: string, email: string) => void;
-        /**
-         * 权限拒绝埋点
-         */
-        trackPermissionDenied?: (user: User) => void;
-        /**
-         * 设置用户信息
-         */
-        setUser?: (user: {
-            userId: string;
-            email: string;
-            role: string;
-        }) => void;
-    };
-    /**
-     * UI 组件（可选，用于自定义样式）
-     */
-    components?: {
-        Container?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-        }>;
-        Card?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-        }>;
-        Input?: React__default.ComponentType<any>;
-        Button?: React__default.ComponentType<any>;
-        Alert?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-        }>;
-        Badge?: React__default.ComponentType<{
-            children: React__default.ReactNode;
-            variant?: string;
-        }>;
-    };
-    /**
-     * className 配置（用于 Tailwind CSS）
-     */
-    classNames?: {
-        container?: string;
-        card?: string;
-        header?: string;
-        form?: string;
-        input?: string;
-        button?: string;
-        alert?: string;
-    };
-}
-declare function AdminLoginPage(props: AdminLoginPageProps): React__default.JSX.Element;
-
-export { AdminLoginPage, type AdminLoginPageProps, HeadlessLoginFormProps, HeadlessRegisterFormProps, LoginForm, RegisterForm };
+import '../../useAuthActions-7S5dL7Oh.js';
+import '../../base-api-client-BpmcQt4Q.js';
+import '../../types-BaZccpvk.js';
+import '../../types-CbTsi9CZ.js';