# @xuqm/rn-common

XuqmGroup RN SDK 核心模块。负责 SDK 初始化、HTTP 请求、Token 管理、设备信息、XWebView Bridge、API hooks。

## 安装

```bash
yarn add @xuqm/rn-common @react-native-async-storage/async-storage
```

Peer dependencies：`react >= 18`，`react-native >= 0.76`，`axios >= 1.0.0`

## 初始化

### 方式 A — 配置文件自动初始化（推荐）

在宿主项目中配置 Babel alias `@xuqm/autoinit-config` → 加密配置文件：

```js
// metro.config.js
config.resolver.extraNodeModules = {
  '@xuqm/autoinit-config': './path/to/your.xuqmconfig',
};
```

SDK 在 import 时自动调用 `initWithConfigFile()`，App 无需任何 init 代码。

### 方式 B — 手动初始化

```ts
import { XuqmSDK } from '@xuqm/rn-common'

await XuqmSDK.initialize({ appKey: 'xxx' })               // 公有平台
await XuqmSDK.initialize({ appKey: 'xxx', platformUrl: 'https://xxx' })  // 私有化
await XuqmSDK.awaitInitialization()                        // 等待配置拉取
```

## API

### 初始化

| API | 说明 |
|-----|------|
| `XuqmSDK.initialize(opts)` | 初始化，拉取平台配置 |
| `XuqmSDK.awaitInitialization()` | 等待异步初始化完成 |
| `isInitialized()` | 检查 SDK 是否就绪 |
| `getConfig()` | 获取已解析的平台配置 |

### 用户信息

| API | 说明 |
|-----|------|
| `XuqmSDK.setUserInfo(info)` | 设置用户信息，触发所有子 SDK 登录 |
| `XuqmSDK.setUserInfo(null)` | 登出，触发全局登出 |
| `getUserId()` | 获取当前 userId |
| `getUserInfo()` | 获取当前用户信息 |
| `setUserId(id)` | 直接设置 userId（内部用） |

### HTTP

| API | 说明 |
|-----|------|
| `apiRequest(url, options?)` | 带 Bearer token 的 HTTP 请求 |
| `configureHttp(opts)` | 覆盖 HTTP 基础配置 |
| `_getToken()` | 获取当前 token（内部用） |
| `_saveToken(token)` | 保存 token（内部用） |
| `_clearToken()` | 清除 token（内部用） |

### 设备

| API | 说明 |
|-----|------|
| `getDeviceId()` | 获取设备稳定 UUID |
| `getDeviceInfo()` | 获取设备品牌/型号/系统信息 |
| `detectPushVendor()` | 检测设备推送厂商 |

### XWebView Bridge

| API | 说明 |
|-----|------|
| `openXWebView(url, options?)` | 打开 WebView |
| `setXWebViewController(controller)` | 设置全局 WebView 控制器 |
| `getXWebViewConfig()` | 获取当前 WebView 配置 |
| `XWebViewControl` | WebView 控制器类 |

### API Hooks

| API | 说明 |
|-----|------|
| `useApi(method, url, opts?)` | React hook：带 loading/error 的 API 调用 |
| `usePageApi(method, url, opts?)` | React hook：分页 API |
| `useRequest(opts?)` | React hook：通用请求 |
| `setGlobalApiErrorHandler(handler)` | 设置全局 API 错误处理 |

### UI

| API | 说明 |
|-----|------|
| `showToast(msg)` | 显示 toast |
| `showAlert(title, msg)` | 显示 alert |
| `showConfirm(title, msg)` | 显示确认对话框 |
| `ScaledImage` | 等比缩放图片组件 |

### 常量

| 常量 | 说明 |
|------|------|
| `DEFAULT_TENANT_PLATFORM_URL` | 默认公有平台地址 |
| `DEFAULT_IM_WS_URL` | 默认 IM WebSocket 地址 |