@flatbiz/device

增强 H5 设备信息采集能力：deviceInfo 支持自定义/自动获取 IP、屏幕分辨率字符串，并合并 UA 解析结果；补充 Vitest 单测与 Vite 本地演示。

Breaking Changes

• deviceInfo 改为异步 API：由同步函数改为 async，返回 Promise<FlatbizDevice>，调用方需使用 await deviceInfo() 或 .then()
• 移除 utils 模块：getDeviceId 统一从 helper-get-deviceId 导出，不再通过 src/utils.ts

Features

• 新增 DeviceInfoOptions 可选参数：
  • ip：传入服务端下发的 IP，优先于自动获取
  • autoGetIp：为 true 时通过 https://api.ipify.org?format=json 拉取公网 IP（默认 false）
  • isDebug：为 true 时在控制台输出非浏览器环境或解析失败等错误信息（默认 false）
• 新增返回字段 ip、screenSize（格式 {width}x{height}，如 390x844）
• 非浏览器环境（typeof window === 'undefined'）安全返回 {}，避免 SSR/Node 直接调用抛错
• 新增 helpers：getIp、getWindowSize；getDeviceId 独立为 helper-get-deviceId
• 开发体验：补充 Vitest 单元测试；yarn demo（Vite）可本地预览 public/index.html

deviceInfo() 返回字段

H5 终端（FlatbizDeviceInfo）

• ip、deviceId、language
• screenWidth、screenHeight、screenSize、screenDensity
• networkType、timezone、timezoneOffset、systemDate、systemTime
• colorDepth、touchSupport、plugins、pluginNum、cookiesEnable

UA 解析（FlatbizUaParserResult）

• userAgent、browserName、browserVersion
• engineName、engineVersion
• osName、osVersion、cpuModel
• deviceType、deviceVendor、deviceModel

Usage

import { deviceInfo } from '@flatbiz/device';

// 自定义 IP（推荐由服务端下发）
const info = await deviceInfo({ ip: '203.0.113.1' });

// 自动获取公网 IP
const info2 = await deviceInfo({ autoGetIp: true });

// 调试模式
const info3 = await deviceInfo({ isDebug: true });