sa2kit 2.0.4 → 3.0.0

package/dist/common/auth/client/index.js

@@ -0,0 +1,26 @@
+'use strict';
+
+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 chunkS37OK2QG_js.API_ROUTES; }
+});
+Object.defineProperty(exports, "BaseApiClient", {
+  enumerable: true,
+  get: function () { return chunkS37OK2QG_js.BaseApiClient; }
+});
+Object.defineProperty(exports, "STORAGE_KEYS", {
+  enumerable: true,
+  get: function () { return chunkS37OK2QG_js.STORAGE_KEYS; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/common/auth/client/index.mjs

@@ -0,0 +1,5 @@
+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/common/auth/components/index.d.mts

@@ -0,0 +1,374 @@
+import React__default from 'react';
+import { L as LoginFormState, R as RegisterFormState } from '../../../types.legacy-J-j-_ig_.mjs';
+import { I as IAuthClient, U as User } from '../../../types-DCRvasyH.mjs';
+import { A as AuthActionsClient } from '../../../useAuthActions-7S5dL7Oh.mjs';
+import { B as BaseApiClient } from '../../../base-api-client-DXLsq2yz.mjs';
+import '../../../enums-Dume-V5Y.mjs';
+import 'drizzle-orm/pg-core';
+import '../../../types-BaZccpvk.mjs';
+import '../../../types-CbTsi9CZ.mjs';
+
+type SignInMode = 'email-password' | 'phone-password' | 'phone-otp' | 'email-otp';
+type OtpChannel = 'phone' | 'email';
+interface SignInFormState {
+    mode: SignInMode;
+    step: 'credentials' | 'otp';
+    email: string;
+    phone: string;
+    password: string;
+    otp: string;
+    loading: boolean;
+    error: string | null;
+    setMode: (mode: SignInMode) => void;
+    setEmail: (value: string) => void;
+    setPhone: (value: string) => void;
+    setPassword: (value: string) => void;
+    setOtp: (value: string) => void;
+    sendOtp: () => Promise<void>;
+    handleSubmit: (e?: React.FormEvent) => Promise<void>;
+}
+interface RegisterFormHeadlessState {
+    channel: 'email' | 'phone';
+    step: 'credentials' | 'otp';
+    email: string;
+    phone: string;
+    password: string;
+    confirmPassword: string;
+    name: string;
+    otp: string;
+    loading: boolean;
+    error: string | null;
+    setChannel: (channel: 'email' | 'phone') => void;
+    setEmail: (value: string) => void;
+    setPhone: (value: string) => void;
+    setPassword: (value: string) => void;
+    setConfirmPassword: (value: string) => void;
+    setName: (value: string) => void;
+    setOtp: (value: string) => void;
+    sendOtp: () => Promise<void>;
+    handleSubmit: (e?: React.FormEvent) => Promise<void>;
+}
+interface VerifyOtpFormState {
+    channel: OtpChannel;
+    target: string;
+    otp: string;
+    loading: boolean;
+    error: string | null;
+    setOtp: (value: string) => void;
+    resendOtp: () => Promise<void>;
+    handleSubmit: (e?: React.FormEvent) => Promise<void>;
+}
+interface HeadlessSignInFormProps {
+    authClient: AuthActionsClient;
+    initialMode?: SignInMode;
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+    children: (state: SignInFormState) => React.ReactNode;
+}
+interface HeadlessRegisterFormProps {
+    authClient: AuthActionsClient;
+    initialChannel?: 'email' | 'phone';
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+    children: (state: RegisterFormHeadlessState) => React.ReactNode;
+}
+interface HeadlessVerifyOtpFormProps {
+    authClient: AuthActionsClient;
+    channel: OtpChannel;
+    target: string;
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+    children: (state: VerifyOtpFormState) => React.ReactNode;
+}
+/** @deprecated 2.x */
+interface BaseFormProps {
+    apiClient: IAuthClient;
+    onSuccess?: (user: unknown) => void;
+    onError?: (error: string) => void;
+}
+/** @deprecated 使用 HeadlessSignInFormProps */
+interface HeadlessLoginFormProps extends BaseFormProps {
+    children: (state: LoginFormState) => React.ReactNode;
+}
+/** @deprecated */
+interface HeadlessRegisterFormPropsLegacy extends BaseFormProps {
+    children: (state: RegisterFormState) => React.ReactNode;
+}
+
+interface LoginModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSuccess?: () => void;
+    onSwitchToRegister?: () => void;
+    defaultMode?: SignInMode;
+}
+interface RegisterModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSuccess?: () => void;
+    onSwitchToLogin?: () => void;
+}
+interface ForgotPasswordModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSuccess?: () => void;
+}
+interface AuthGuardProps {
+    children: React.ReactNode;
+    fallback?: React.ReactNode;
+    requireAuth?: boolean;
+}
+interface UserMenuProps {
+    customMenuItems?: Array<{
+        id: string;
+        label: string;
+        icon?: React.ComponentType<{
+            size?: number;
+        }>;
+        onClick: () => void;
+        requireAuth?: boolean;
+    }>;
+    className?: string;
+}
+
+declare function SignInForm({ authClient, initialMode, onSuccess, onError, children, }: HeadlessSignInFormProps): React__default.JSX.Element;
+
+declare function RegisterFormHeadless({ authClient, initialChannel, onSuccess, onError, children, }: HeadlessRegisterFormProps): React__default.JSX.Element;
+
+declare function VerifyOtpForm({ authClient, channel, target, onSuccess, onError, children, }: HeadlessVerifyOtpFormProps): React__default.JSX.Element;
+
+declare function LoginModal({ isOpen, onClose, onSuccess, onSwitchToRegister, defaultMode, }: LoginModalProps): React__default.JSX.Element | null;
+
+declare function RegisterModal({ isOpen, onClose, onSuccess, onSwitchToLogin }: RegisterModalProps): React__default.JSX.Element | null;
+
+declare function ForgotPasswordModal({ isOpen, onClose, onSuccess }: ForgotPasswordModalProps): React__default.JSX.Element | null;
+
+declare function AuthGuard({ children, fallback, requireAuth }: AuthGuardProps): React__default.JSX.Element;
+
+declare function UserMenu({ customMenuItems, className }: UserMenuProps): React__default.JSX.Element;
+
+/**
+ * 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, }: HeadlessRegisterFormPropsLegacy): 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;
+
+/** 中国大陆手机号 */
+declare function validatePhoneNumber(phone: string): boolean;
+declare function validatePassword(password: string): {
+    valid: boolean;
+    message?: string;
+};
+declare function validateEmail(email: string): boolean;
+
+export { AdminLoginPage, type AdminLoginPageProps, AuthGuard, type AuthGuardProps, type BaseFormProps, ForgotPasswordModal, type ForgotPasswordModalProps, type HeadlessLoginFormProps, type HeadlessRegisterFormProps, type HeadlessRegisterFormPropsLegacy, type HeadlessSignInFormProps, type HeadlessVerifyOtpFormProps, LoginForm, LoginFormState, LoginModal, type LoginModalProps, type OtpChannel, RegisterForm, RegisterFormHeadless, type RegisterFormHeadlessState, RegisterFormState, RegisterModal, type RegisterModalProps, SignInForm, type SignInFormState, type SignInMode, UserMenu, type UserMenuProps, VerifyOtpForm, type VerifyOtpFormState, validateEmail, validatePassword, validatePhoneNumber };