# @worlfirst/worldfirst-js

WorldFirst 嵌入式金融前端 SDK，为第三方商户提供入驻、支付保管等能力的集成方案。

## 安装

```bash
npm install @worlfirst/worldfirst-js
```

## 使用说明

### 基础用法

```typescript
import { loadWorldFirst } from '@worlfirst/worldfirst-js';

// 初始化 SDK
const sdk = await loadWorldFirst({
  env: 'SANDBOX', // 环境：'LOCAL' | 'SANDBOX' | 'PROD'
  debug: true, // 开启调试日志
});

// 创建入驻元素
const element = sdk.createElement('Onboard', {
  token: 'your-token',
  sdkClientId: 'your-client-id',
});

// 挂载到页面
element.mount('container-id');

// 监听事件
element.on('submit', (result) => {
  console.log('提交结果:', result);
});
```

### 环境配置

| 环境      | 说明         |
| --------- | ------------ |
| `SANDBOX` | 沙箱测试环境 |
| `PROD`    | 生产环境     |

### 预加载优化

如需优化首屏加载性能，可在初始化时配置预加载：

```typescript
const sdk = await loadWorldFirst({
  env: 'PROD',
  elements: ['Onboard'], // 预加载指定元素资源
});
```

## 许可证

详见 [LEGAL.md](./LEGAL.md)