@bytem/bytem-tracker-app 0.0.1

package/README.md

@@ -0,0 +1,41 @@
+# @bytem/bytem-tracker
+
+ByteM 埋点 SDK（React Native / Expo）
+
+> 本 SDK 为 Flutter `bytem_tracker.dart` 的 **1:1 行为迁移版本**  
+> 字段、默认值、payload 结构完全一致，后端无需任何改动
+
+### 此项目运行起来
+```bash
+rm -rf dist
+yarn install
+yarn build
+```
+
+---
+
+## ✨ 特性
+
+- ✅ React Native / Expo 通用
+- ✅ 行为 100% 对齐 Flutter SDK
+- ✅ 单例模式
+- ✅ 自动 deviceId / visitorId 管理
+- ✅ TypeScript 支持
+- ❌ 不支持 Web（刻意限制，避免误用）
+
+---
+
+## 📦 安装
+
+### React Native CLI
+
+```bash
+yarn add @bytem/bytem-tracker
+yarn add @react-native-async-storage/async-storage
+```
+
+### Expo
+```bash
+expo install @react-native-async-storage/async-storage
+yarn add @bytem/bytem-tracker
+```

package/dist/env.d.ts

@@ -0,0 +1 @@
+export declare function isExpoRuntime(): boolean;

package/dist/env.js

@@ -0,0 +1,3 @@
+export function isExpoRuntime() {
+    return typeof globalThis !== 'undefined' && !!globalThis.__expo;
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { BytemTracker } from './tracker';
+declare const _default: BytemTracker;
+export default _default;
+export { BytemTracker };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { BytemTracker } from './tracker';
+export default BytemTracker.instance;
+export { BytemTracker };

package/dist/tracker.d.ts

@@ -0,0 +1,26 @@
+export declare class BytemTracker {
+    private static _instance;
+    static get instance(): BytemTracker;
+    private static readonly _sdkName;
+    private static readonly _sdkVersion;
+    private static readonly _defaultBaseUrl;
+    private static readonly _storageDeviceIdKey;
+    private static readonly _storageVisitorIdKey;
+    private _appKey;
+    private _baseUrl;
+    private _debug;
+    private _deviceId;
+    private _visitorId;
+    private constructor();
+    init(options: {
+        appKey: string;
+        baseUrl?: string;
+        debug?: boolean;
+        deviceId?: string;
+    }): Promise<void>;
+    track(eventKey: string, params?: Record<string, any>): Promise<void>;
+    private _loadOrCreateDeviceId;
+    private _loadOrCreateVisitorId;
+    private _getScreenInfo;
+    private _log;
+}

package/dist/tracker.js

@@ -0,0 +1,96 @@
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { Dimensions, Platform } from 'react-native';
+import { generateUUID } from './uuid';
+export class BytemTracker {
+    static get instance() {
+        if (!this._instance) {
+            this._instance = new BytemTracker();
+        }
+        return this._instance;
+    }
+    constructor() {
+        this._appKey = null;
+        this._baseUrl = BytemTracker._defaultBaseUrl;
+        this._debug = false;
+        this._deviceId = null;
+        this._visitorId = null;
+    }
+    async init(options) {
+        var _a;
+        this._appKey = options.appKey;
+        this._debug = (_a = options.debug) !== null && _a !== void 0 ? _a : false;
+        if (options.baseUrl) {
+            this._baseUrl = options.baseUrl;
+        }
+        if (options.deviceId) {
+            this._deviceId = options.deviceId;
+            await AsyncStorage.setItem(BytemTracker._storageDeviceIdKey, this._deviceId);
+        }
+        else {
+            await this._loadOrCreateDeviceId();
+        }
+        await this._loadOrCreateVisitorId();
+        this._log('init', {
+            deviceId: this._deviceId,
+            visitorId: this._visitorId,
+        });
+    }
+    async track(eventKey, params = {}) {
+        if (!this._appKey || !this._deviceId || !this._visitorId) {
+            this._log('track skipped: not initialized');
+            return;
+        }
+        const payload = {
+            app_key: this._appKey,
+            device_id: this._deviceId,
+            visitor_id: this._visitorId,
+            event_key: eventKey,
+            params,
+            sdk: BytemTracker._sdkName,
+            sdk_version: BytemTracker._sdkVersion,
+            platform: Platform.OS,
+            timestamp: Date.now(),
+            screen: this._getScreenInfo(),
+        };
+        this._log('track', payload);
+        try {
+            await fetch(`${this._baseUrl}/track`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload),
+            });
+        }
+        catch (e) {
+            this._log('track error', e);
+        }
+    }
+    async _loadOrCreateDeviceId() {
+        const stored = await AsyncStorage.getItem(BytemTracker._storageDeviceIdKey);
+        this._deviceId = stored !== null && stored !== void 0 ? stored : generateUUID();
+        if (!stored && this._deviceId) {
+            await AsyncStorage.setItem(BytemTracker._storageDeviceIdKey, this._deviceId);
+        }
+    }
+    async _loadOrCreateVisitorId() {
+        const stored = await AsyncStorage.getItem(BytemTracker._storageVisitorIdKey);
+        this._visitorId = stored !== null && stored !== void 0 ? stored : generateUUID();
+        if (!stored && this._visitorId) {
+            await AsyncStorage.setItem(BytemTracker._storageVisitorIdKey, this._visitorId);
+        }
+    }
+    _getScreenInfo() {
+        const { width, height } = Dimensions.get('window');
+        return { width, height };
+    }
+    _log(...args) {
+        if (this._debug) {
+            console.log('[BytemTracker]', ...args);
+        }
+    }
+}
+BytemTracker._instance = null;
+BytemTracker._sdkName = 'bytemTrackerReact';
+BytemTracker._sdkVersion = '0.0.1';
+BytemTracker._defaultBaseUrl = 'https://tracking.server.bytecon.com';
+BytemTracker._storageDeviceIdKey = 'bytem_fp';
+BytemTracker._storageVisitorIdKey = 'bytem_visitor_id';

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+/** SDK 初始化配置 */
+export interface BytemConfig {
+    appKey: string;
+    baseUrl?: string;
+    debug?: boolean;
+    visitorId?: string;
+    appScheme?: string;
+}
+/** 基础事件可选参数 */
+export interface BytemEventOptions {
+    count?: number;
+    sum?: number;
+    duration?: number;
+}
+/** 用户资料参数 */
+export interface BytemUserParams {
+    userId?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    gender?: "M" | "F";
+    birthYear?: number;
+    custom?: Record<string, any>;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/uuid.d.ts

@@ -0,0 +1 @@
+export declare function generateUUID(): string;

package/dist/uuid.js

@@ -0,0 +1,16 @@
+import { v4 as uuidv4 } from 'uuid';
+function jsUUIDv4() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+export function generateUUID() {
+    try {
+        return uuidv4();
+    }
+    catch {
+        return jsUUIDv4();
+    }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@bytem/bytem-tracker-app",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "description": "bytem SDK for React Native",
+  "license": "ISC",
+  "author": "Barry",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "publish": "npm publish"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.60.0"
+  },
+  "dependencies": {
+    "@react-native-async-storage/async-storage": "^1.21.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/react-native": "^0.73.0",
+    "@types/uuid": "^9.0.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "volta": {
+    "node": "22.12.0",
+    "yarn": "1.22.21"
+  }
+}