# @xuqm/rn-bugcollect

JS 错误、业务日志、API 异常和漏斗采集模块。它依赖 `@xuqm/rn-common` 获取远程配置和当前会话，不提供独立初始化或登录入口。

## 安装

```bash
pnpm add @xuqm/rn-common @xuqm/rn-bugcollect \
  @react-native-async-storage/async-storage
```

## 使用

```ts
import { BugCollect } from '@xuqm/rn-bugcollect'

BugCollect.setEnvironment(__DEV__ ? 'development' : 'production')
BugCollect.event('page_view', { page: 'home' })

try {
  // business
} catch (error) {
  BugCollect.captureError(error)
}
```

初始化只由 common 自动完成，登录只由 `XuqmSDK.login()` 完成。宿主通过
`XuqmSDK.setPrivacyConsent(true)` 同步已取得的隐私同意；只有平台启用、用户同意且
非 Debug 三个条件同时满足时，SDK 才自动注册采集。不存在宿主手工启动入口。
`BugCollect.flush()` 可在 App 转入后台前主动刷新队列；Debug 开发页使用
`BugCollect.sendTestErrorAndFlush()` 做一次性真实上报验证。

错误指纹使用 common 的统一 SHA-256 实现，事件里的 SDK 版本直接读取当前发布包版本，不再维护第二份硬编码版本号。

SourceMap 上传使用独立打包后处理流程；不要再叠加基于 Metro `customSerializer` 的旧插件方案，以免破坏新版 Metro 的 exports 与序列化流程。

fatal/error 持久队列复用 common 的 AES-GCM 沙箱加密能力；没有签发密钥时不降级写入
包含堆栈和设备信息的明文。Issue 只有在错误堆栈能唯一匹配当前原生 Bundle
state/manifest 时才携带 `buildId/moduleId/moduleVersion/bundleHash` 并标记
`symbolicationStatus=exact`；无法归属时明确为 `unavailable`，服务端不得猜测 latest
Source Map。