@gup-fe/js-sdk 2.0.0 → 2.1.0

package/README.md

@@ -27,10 +27,18 @@ pnpm add @gup-fe/js-sdk
 ```javascript
 import { login } from '@gup-fe/js-sdk';
 
-// 一键调出登录弹窗
-login({
+// 一键调出登录弹窗并获取其控制句柄
+const { close } = login({
   gameId: '5242',
-  // loginTypes: ['phone', 'uid'] // 可选：指定开启哪些登录方式
+  // loginTypes: ['phone', 'uid'], // 可选：指定开启哪些登录方式
+  onLoginSuccess: (data) => {
+    console.log('🎉 登录成功！获取到的数据：', data)
+    // 成功后主动关闭登录弹窗
+    close()
+  },
+  onLoginError: (error) => {
+    console.error('❌ 登录失败：', error)
+  }
 });
 ```
 
@@ -103,6 +111,8 @@ function App() {
 | ------------ | -------------- | ---- | ------ | ---------------------------------------- |
 | `gameId`     | `string`       | **是** | -      | 当前业务/游戏的唯一标识 ID               |
 | `loginTypes` | `LoginTypes[]` | 否   | -      | 支持的登录方式列表，例如 `['phone', 'uid']` |
+| `onLoginSuccess` | `(data: any) => void` | 否 | - | 无论哪种登录方式，**登录成功**后触发的回调，并返回登录信息 |
+| `onLoginError`   | `(error: any) => void`| 否 | - | 无论哪种登录方式，**登录失败**后触发的回调，并返回错误信息 |
 
 ### 导出的核心组件与配置
 对于有高度定制化需求的业务方，SDK 同样暴露了以下底层组件：

package/dist/index.d.ts

@@ -19,6 +19,8 @@ declare interface ConfigContextType {
     onUidLoginSuccess?: (data: any) => void;
     onPhoneLoginSuccess?: ((data: PhoneLoginResponse) => void) | ((data: PhoneLoginResponse) => Promise<void>);
     onAccountLoginSuccess?: (data: PhoneLoginResponse) => void;
+    onLoginSuccess?: (data: any) => void;
+    onLoginError?: (error: any) => void;
     closeable?: boolean;
     uidLoginConfig?: {
         uidGetterImageClassName?: string;
@@ -43,12 +45,16 @@ declare interface ConfigProviderProps {
     };
 }
 
-export declare function Login({ open, onOpenChange, sceneId, onPhoneLoginSuccess, onAccountLoginSuccess, onUidLoginSuccess, closeable, mountToaster, toastConfigs, ...props }: Props): JSX.Element;
+export declare function Login({ open, onOpenChange, sceneId, onPhoneLoginSuccess, onAccountLoginSuccess, onUidLoginSuccess, onLoginSuccess, onLoginError, closeable, mountToaster, toastConfigs, ...props }: Props): JSX.Element;
 
-export declare function login({ loginTypes, gameId }: {
+export declare function login({ loginTypes, gameId, onLoginSuccess, onLoginError, }: {
     loginTypes?: LoginTypes[];
     gameId: string;
-}): void;
+    onLoginSuccess?: (data: any) => void;
+    onLoginError?: (error: any) => void;
+}): {
+    close: () => void;
+};
 
 export declare const LOGIN_TYPES: {
     readonly ROLE_ID: "roleid";
@@ -122,6 +128,8 @@ declare interface Props extends Omit<ConfigContextType, 'setCurrentLoginType' |
     onAccountLoginSuccess?: (data: PhoneLoginResponse) => void;
     sceneId?: number;
     onUidLoginSuccess?: (data: any) => void;
+    onLoginSuccess?: (data: any) => void;
+    onLoginError?: (error: any) => void;
     autoLoginConfig?: AutoLoginConfig;
     closeable?: boolean;
     mountToaster?: boolean;