@bytem/bytem-tracker-app 0.0.3 → 0.0.6

package/README.md

@@ -1,41 +1,154 @@
-# @bytem/bytem-tracker
+# Bytem Tracker SDK (React Native)
 
-ByteM 埋点 SDK（React Native / Expo）
+This is the official Bytem Tracker SDK for React Native applications.
 
-> 本 SDK 为 Flutter `bytem_tracker.dart` 的 **1:1 行为迁移版本**  
-> 字段、默认值、payload 结构完全一致，后端无需任何改动
+## Installation
+
+Install the package and its peer dependencies using Yarn:
 
-### 此项目运行起来
 ```bash
-rm -rf dist
-yarn install
-yarn build
+yarn add @bytem/bytem-tracker-app @react-native-async-storage/async-storage react-native-device-info uuid
 ```
 
----
+### iOS Setup
+Don't forget to install pods for iOS:
+```bash
+cd ios && pod install
+```
 
-## ✨ 特性
+## Development
 
-- ✅ React Native / Expo 通用
-- ✅ 行为 100% 对齐 Flutter SDK
-- ✅ 单例模式
-- ✅ 自动 deviceId / visitorId 管理
-- ✅ TypeScript 支持
-- ❌ 不支持 Web（刻意限制，避免误用）
+This project uses **Yarn** for dependency management.
 
----
+### Setup
 
-## 📦 安装
+```bash
+yarn install
+```
 
-### React Native CLI
+### Running Tests
 
 ```bash
-yarn add @bytem/bytem-tracker
-yarn add @react-native-async-storage/async-storage
+yarn test
 ```
 
-### Expo
+### Build
+
 ```bash
-expo install @react-native-async-storage/async-storage
-yarn add @bytem/bytem-tracker
-```
+yarn build
+```
+
+## Release & Publish
+
+Automate version bump and publish via npm scripts:
+
+```bash
+# Patch release (1.0.0 -> 1.0.1)
+npm run release:patch
+
+# Minor release (1.0.0 -> 1.1.0)
+npm run release:minor
+
+# Major release (1.0.0 -> 2.0.0)
+npm run release:major
+
+# Beta prerelease (1.0.0 -> 1.0.1-beta.0)
+npm run release:beta
+```
+
+Notes:
+- These scripts bump package.json version and publish to npm.
+- `prepublishOnly` builds the package before publishing.
+- Configure auth via user-level `~/.npmrc`. Do not commit tokens in the repo.
+## Usage
+
+### Initialization
+Initialize the tracker in your app entry point (e.g., `App.tsx` or `index.js`). Note that `init` is asynchronous.
+
+```typescript
+import React, { useEffect } from 'react';
+import BytemTracker from '@bytem/bytem-tracker-app';
+
+const App = () => {
+  useEffect(() => {
+    const initTracker = async () => {
+      await BytemTracker.init({
+        appId: 'your-app-id',
+        endpoint: 'https://api.bytem.com/track',
+        debug: __DEV__, // Enable debug logs in development
+      });
+    };
+
+    initTracker();
+  }, []);
+
+  return <YourApp />;
+};
+```
+
+### Tracking Events
+
+#### Identify User
+Track user identification when a user logs in or updates their profile.
+
+```typescript
+// Signature: trackUser(userId: string, traits?: object)
+BytemTracker.trackUser('user_12345', {
+  email: 'user@example.com',
+  age: 25,
+  membership: 'gold'
+});
+```
+
+#### View Product
+Track when a user views a product details page.
+
+```typescript
+BytemTracker.trackViewProduct({
+  productId: 'prod_001',
+  name: 'Awesome Gadget',
+  price: 99.99,
+  currency: 'USD',
+  category: 'Electronics'
+});
+```
+
+#### Checkout Order
+Track when a user initiates checkout.
+
+```typescript
+BytemTracker.trackCheckOutOrder({
+  orderId: 'order_abc123',
+  total: 150.00,
+  currency: 'USD',
+  products: [
+    { productId: 'prod_001', price: 99.99, quantity: 1 },
+    { productId: 'prod_002', price: 50.01, quantity: 1 }
+  ]
+});
+```
+
+#### Pay Order
+Track when a user completes a payment.
+
+```typescript
+BytemTracker.trackPayOrder({
+  orderId: 'order_abc123',
+  total: 150.00,
+  currency: 'USD',
+  products: [
+    { productId: 'prod_001', price: 99.99, quantity: 1 },
+    { productId: 'prod_002', price: 50.01, quantity: 1 }
+  ]
+});
+```
+
+## Platform Compatibility
+
+This SDK is designed for **React Native** and supports:
+- iOS
+- Android
+
+It relies on:
+- `@react-native-async-storage/async-storage`: For persisting session and visitor IDs.
+- `react-native-device-info`: For capturing device metrics (model, OS version, etc.).

package/dist/src/BytemTracker.d.ts

@@ -0,0 +1,18 @@
+import { TrackerConfig, Product, Order, UserTraits } from './types';
+declare class BytemTracker {
+    private static instance;
+    private config;
+    private isInitialized;
+    private visitorId;
+    private readonly DEFAULT_ENDPOINT;
+    private constructor();
+    static getInstance(): BytemTracker;
+    init(config: TrackerConfig): Promise<void>;
+    private track;
+    trackViewProduct(product: Product): void;
+    trackCheckOutOrder(order: Order): void;
+    trackPayOrder(order: Order): void;
+    trackUser(userId: string, traits?: UserTraits): void;
+}
+declare const _default: BytemTracker;
+export default _default;

package/dist/src/BytemTracker.js

@@ -0,0 +1,135 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_1 = require("./core/base");
+const request_1 = require("./core/request");
+const Business = __importStar(require("./business"));
+const session_1 = require("./core/session");
+const storage_1 = require("./core/storage");
+const device_1 = require("./core/device");
+class BytemTracker {
+    constructor() {
+        this.config = null;
+        this.isInitialized = false;
+        this.visitorId = null;
+        this.DEFAULT_ENDPOINT = 'https://tracking.server.bytecon.com/i';
+    }
+    static getInstance() {
+        if (!BytemTracker.instance) {
+            BytemTracker.instance = new BytemTracker();
+        }
+        return BytemTracker.instance;
+    }
+    async init(config) {
+        if (this.isInitialized) {
+            console.warn('[BytemTracker] Already initialized');
+            return;
+        }
+        this.config = config;
+        this.isInitialized = true;
+        // Initialize Visitor ID
+        if (config.visitorId) {
+            this.visitorId = config.visitorId;
+            await (0, storage_1.setItem)(storage_1.StorageKeys.VISITOR_ID, this.visitorId);
+        }
+        else {
+            this.visitorId = await (0, storage_1.getItem)(storage_1.StorageKeys.VISITOR_ID);
+            if (!this.visitorId) {
+                this.visitorId = (0, device_1.generateUUID)();
+                await (0, storage_1.setItem)(storage_1.StorageKeys.VISITOR_ID, this.visitorId);
+            }
+        }
+        // Initialize Session
+        await (0, session_1.initSession)();
+        if (!this.config.endpoint) {
+            this.config.endpoint = this.DEFAULT_ENDPOINT;
+        }
+        if (config.debug) {
+            console.log('[BytemTracker] Initialized with config:', this.config);
+            console.log('[BytemTracker] Visitor ID:', this.visitorId);
+        }
+    }
+    async track(payload) {
+        if (!this.isInitialized || !this.config || !this.visitorId) {
+            console.error('[BytemTracker] Not initialized. Call await init() first.');
+            return;
+        }
+        const baseParams = await (0, base_1.buildBaseRequestParams)(this.config.appId, this.visitorId);
+        const finalData = Object.assign(Object.assign({}, baseParams), payload);
+        if (this.config.debug) {
+            console.log('[BytemTracker] Tracking event:', finalData);
+        }
+        if (this.config.endpoint) {
+            let requestUrl = this.config.endpoint;
+            try {
+                const urlObj = new URL(this.config.endpoint);
+                const hasEndpointPath = urlObj.pathname && urlObj.pathname !== '/';
+                const pathToUse = this.config.path;
+                if (pathToUse) {
+                    urlObj.pathname = pathToUse.startsWith('/') ? pathToUse : '/' + pathToUse;
+                    requestUrl = urlObj.toString();
+                }
+                else if (!hasEndpointPath) {
+                    urlObj.pathname = '/i';
+                    requestUrl = urlObj.toString();
+                }
+                else {
+                    requestUrl = this.config.endpoint;
+                }
+            }
+            catch (_a) {
+                requestUrl = this.config.endpoint;
+            }
+            await (0, request_1.sendRequest)(requestUrl, finalData);
+        }
+    }
+    trackViewProduct(product) {
+        const payload = Business.trackViewProduct(product);
+        this.track(payload);
+    }
+    trackCheckOutOrder(order) {
+        const payload = Business.trackCheckOutOrder(order);
+        this.track(payload);
+    }
+    trackPayOrder(order) {
+        const payload = Business.trackPayOrder(order);
+        this.track(payload);
+    }
+    trackUser(userId, traits) {
+        const payload = Business.trackUser(userId, traits);
+        this.track(payload);
+    }
+}
+exports.default = BytemTracker.getInstance();

package/dist/src/business/index.d.ts

@@ -0,0 +1,4 @@
+export * from './trackViewProduct';
+export * from './trackCheckOutOrder';
+export * from './trackPayOrder';
+export * from './trackUser';

package/dist/src/business/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./trackViewProduct"), exports);
+__exportStar(require("./trackCheckOutOrder"), exports);
+__exportStar(require("./trackPayOrder"), exports);
+__exportStar(require("./trackUser"), exports);

package/dist/src/business/trackCheckOutOrder.d.ts

@@ -0,0 +1,2 @@
+import { EventPayload, Order } from '../types';
+export declare const trackCheckOutOrder: (order: Order) => EventPayload;

package/dist/src/business/trackCheckOutOrder.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackCheckOutOrder = void 0;
+const trackCheckOutOrder = (order) => {
+    return {
+        event: 'checkout_order',
+        params: {
+            order_id: order.orderId,
+            total: order.total,
+            currency: order.currency,
+            products: order.products.map((p) => ({
+                product_id: p.productId,
+                name: p.name,
+                price: p.price,
+                quantity: p.quantity,
+            })),
+        },
+    };
+};
+exports.trackCheckOutOrder = trackCheckOutOrder;

package/dist/src/business/trackPayOrder.d.ts

@@ -0,0 +1,2 @@
+import { EventPayload, Order } from '../types';
+export declare const trackPayOrder: (order: Order) => EventPayload;

package/dist/src/business/trackPayOrder.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackPayOrder = void 0;
+const trackPayOrder = (order) => {
+    return {
+        event: 'pay_order',
+        params: {
+            order_id: order.orderId,
+            total: order.total,
+            currency: order.currency,
+            products: order.products.map((p) => ({
+                product_id: p.productId,
+                name: p.name,
+                price: p.price,
+                quantity: p.quantity,
+            })),
+            status: 'success',
+        },
+    };
+};
+exports.trackPayOrder = trackPayOrder;

package/dist/src/business/trackUser.d.ts

@@ -0,0 +1,2 @@
+import { EventPayload, UserTraits } from '../types';
+export declare const trackUser: (userId: string, traits?: UserTraits) => EventPayload;

package/dist/src/business/trackUser.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackUser = void 0;
+const trackUser = (userId, traits = {}) => {
+    return {
+        event: 'identify',
+        params: {
+            user_id: userId,
+            traits: traits,
+        },
+    };
+};
+exports.trackUser = trackUser;

package/dist/src/business/trackViewProduct.d.ts

@@ -0,0 +1,2 @@
+import { EventPayload, Product } from '../types';
+export declare const trackViewProduct: (product: Product) => EventPayload;

package/dist/src/business/trackViewProduct.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackViewProduct = void 0;
+const trackViewProduct = (product) => {
+    return {
+        event: 'view_product',
+        params: {
+            product_id: product.productId,
+            name: product.name,
+            price: product.price,
+            currency: product.currency,
+            category: product.category,
+        },
+    };
+};
+exports.trackViewProduct = trackViewProduct;

package/dist/src/core/base.d.ts

@@ -0,0 +1,2 @@
+import { BaseParams } from '../types';
+export declare const buildBaseRequestParams: (appId: string, visitorId: string) => Promise<BaseParams>;

package/dist/src/core/base.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBaseRequestParams = void 0;
+const device_1 = require("./device");
+const session_1 = require("./session");
+const buildBaseRequestParams = async (appId, visitorId) => {
+    const deviceInfo = await (0, device_1.getDeviceInfo)();
+    const sessionInfo = (0, session_1.getSessionInfo)();
+    return {
+        app_id: appId,
+        device_id: visitorId,
+        session_id: sessionInfo ? sessionInfo.sessionId : '',
+        timestamp: Date.now(),
+        platform: deviceInfo.platform,
+        os: deviceInfo.os,
+        os_version: deviceInfo.osVersion,
+        model: deviceInfo.model,
+        language: deviceInfo.language,
+        screen_width: deviceInfo.screenWidth,
+        screen_height: deviceInfo.screenHeight,
+        user_agent: deviceInfo.userAgent,
+    };
+};
+exports.buildBaseRequestParams = buildBaseRequestParams;

package/dist/src/core/device.d.ts

@@ -0,0 +1,3 @@
+import { DeviceInfo } from '../types';
+export declare const getDeviceInfo: () => Promise<DeviceInfo>;
+export declare const generateUUID: () => string;

package/dist/src/core/device.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUUID = exports.getDeviceInfo = void 0;
+const react_native_1 = require("react-native");
+const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
+const getDeviceInfo = async () => {
+    var _a, _b, _c;
+    const os = react_native_device_info_1.default.getSystemName();
+    const osVersion = react_native_device_info_1.default.getSystemVersion();
+    const model = react_native_device_info_1.default.getModel();
+    const userAgent = await react_native_device_info_1.default.getUserAgent();
+    // Try to get language
+    let language = 'en';
+    if (react_native_1.Platform.OS === 'ios') {
+        const settings = (_a = react_native_1.NativeModules.SettingsManager) === null || _a === void 0 ? void 0 : _a.settings;
+        language = (settings === null || settings === void 0 ? void 0 : settings.AppleLocale) || ((_b = settings === null || settings === void 0 ? void 0 : settings.AppleLanguages) === null || _b === void 0 ? void 0 : _b[0]) || 'en';
+    }
+    else if (react_native_1.Platform.OS === 'android') {
+        language = ((_c = react_native_1.NativeModules.I18nManager) === null || _c === void 0 ? void 0 : _c.localeIdentifier) || 'en';
+    }
+    const { width, height } = react_native_1.Dimensions.get('window');
+    return {
+        platform: react_native_1.Platform.OS,
+        os,
+        osVersion,
+        model,
+        screenWidth: width,
+        screenHeight: height,
+        language,
+        userAgent,
+    };
+};
+exports.getDeviceInfo = getDeviceInfo;
+const generateUUID = () => {
+    // Simple UUID v4 generator that doesn't require crypto polyfills
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+};
+exports.generateUUID = generateUUID;

package/dist/src/core/request.d.ts

@@ -0,0 +1,2 @@
+import { EventPayload } from '../types';
+export declare const sendRequest: (endpoint: string, data: EventPayload) => Promise<void>;

package/dist/src/core/request.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendRequest = void 0;
+const sendRequest = async (endpoint, data) => {
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            console.error(`[BytemTracker] Request failed: ${response.statusText}`);
+        }
+    }
+    catch (error) {
+        console.error('[BytemTracker] Network error:', error);
+    }
+};
+exports.sendRequest = sendRequest;

package/dist/src/core/session.d.ts

@@ -0,0 +1,17 @@
+import { SessionInfo } from '../types';
+/**
+ * Initialize session. Must be called before tracking events.
+ * 1. Checks memory (fastest)
+ * 2. Checks storage
+ * 3. Creates new if none exists
+ */
+export declare const initSession: () => Promise<SessionInfo>;
+/**
+ * Force start a new session
+ */
+export declare const refreshSession: () => Promise<SessionInfo>;
+/**
+ * Get current session info.
+ * WARNING: Returns null if initSession() hasn't been called/awaited.
+ */
+export declare const getSessionInfo: () => SessionInfo | null;

package/dist/src/core/session.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionInfo = exports.refreshSession = exports.initSession = void 0;
+const device_1 = require("./device");
+const storage_1 = require("./storage");
+let currentSession = null;
+/**
+ * Initialize session. Must be called before tracking events.
+ * 1. Checks memory (fastest)
+ * 2. Checks storage
+ * 3. Creates new if none exists
+ */
+const initSession = async () => {
+    if (currentSession) {
+        return currentSession;
+    }
+    try {
+        const storedId = await (0, storage_1.getItem)(storage_1.StorageKeys.SESSION_ID);
+        const storedStart = await (0, storage_1.getItem)(storage_1.StorageKeys.SESSION_START);
+        if (storedId && storedStart) {
+            currentSession = {
+                sessionId: storedId,
+                startTime: parseInt(storedStart, 10),
+            };
+        }
+        else {
+            await (0, exports.refreshSession)();
+        }
+    }
+    catch (e) {
+        // If error, generate new
+        await (0, exports.refreshSession)();
+    }
+    return currentSession;
+};
+exports.initSession = initSession;
+/**
+ * Force start a new session
+ */
+const refreshSession = async () => {
+    const newId = (0, device_1.generateUUID)();
+    const newStart = Date.now();
+    currentSession = {
+        sessionId: newId,
+        startTime: newStart,
+    };
+    await (0, storage_1.setItem)(storage_1.StorageKeys.SESSION_ID, newId);
+    await (0, storage_1.setItem)(storage_1.StorageKeys.SESSION_START, newStart.toString());
+    return currentSession;
+};
+exports.refreshSession = refreshSession;
+/**
+ * Get current session info.
+ * WARNING: Returns null if initSession() hasn't been called/awaited.
+ */
+const getSessionInfo = () => {
+    return currentSession;
+};
+exports.getSessionInfo = getSessionInfo;

package/dist/src/core/storage.d.ts

@@ -0,0 +1,9 @@
+export declare const StorageKeys: {
+    VISITOR_ID: string;
+    DEVICE_ID: string;
+    SESSION_ID: string;
+    SESSION_START: string;
+};
+export declare const getItem: (key: string) => Promise<string | null>;
+export declare const setItem: (key: string, value: string) => Promise<void>;
+export declare const removeItem: (key: string) => Promise<void>;

package/dist/src/core/storage.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeItem = exports.setItem = exports.getItem = exports.StorageKeys = void 0;
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+exports.StorageKeys = {
+    VISITOR_ID: 'bytem_visitor_id',
+    DEVICE_ID: 'bytem_device_id',
+    SESSION_ID: 'bytem_session_id',
+    SESSION_START: 'bytem_session_start',
+};
+const getItem = async (key) => {
+    try {
+        return await async_storage_1.default.getItem(key);
+    }
+    catch (e) {
+        console.warn('[BytemTracker] Storage get error:', e);
+        return null;
+    }
+};
+exports.getItem = getItem;
+const setItem = async (key, value) => {
+    try {
+        await async_storage_1.default.setItem(key, value);
+    }
+    catch (e) {
+        console.warn('[BytemTracker] Storage set error:', e);
+    }
+};
+exports.setItem = setItem;
+const removeItem = async (key) => {
+    try {
+        await async_storage_1.default.removeItem(key);
+    }
+    catch (e) {
+        console.warn('[BytemTracker] Storage remove error:', e);
+    }
+};
+exports.removeItem = removeItem;

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+import BytemTracker from './BytemTracker';
+export * from './types';
+export default BytemTracker;

package/dist/src/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BytemTracker_1 = __importDefault(require("./BytemTracker"));
+__exportStar(require("./types"), exports);
+exports.default = BytemTracker_1.default;

package/dist/src/types.d.ts

@@ -0,0 +1,56 @@
+export interface TrackerConfig {
+    appId: string;
+    endpoint?: string;
+    path?: string;
+    debug?: boolean;
+    visitorId?: string;
+}
+export interface DeviceInfo {
+    platform: string;
+    os: string;
+    osVersion: string;
+    model: string;
+    screenWidth: number;
+    screenHeight: number;
+    language: string;
+    userAgent: string;
+}
+export interface SessionInfo {
+    sessionId: string;
+    startTime: number;
+}
+export interface BaseParams {
+    app_id: string;
+    device_id: string;
+    session_id: string;
+    timestamp: number;
+    platform: string;
+    os: string;
+    os_version: string;
+    model: string;
+    language: string;
+    screen_width: number;
+    screen_height: number;
+    user_agent: string;
+}
+export interface UserTraits {
+    [key: string]: any;
+}
+export interface Product {
+    productId: string;
+    name?: string;
+    price?: number;
+    currency?: string;
+    category?: string;
+    quantity?: number;
+}
+export interface Order {
+    orderId: string;
+    total: number;
+    currency: string;
+    products: Product[];
+}
+export interface EventPayload {
+    event: string;
+    params: Record<string, any>;
+}

package/dist/test/BytemTracker.test.d.ts

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

package/dist/test/BytemTracker.test.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BytemTracker_1 = __importDefault(require("../src/BytemTracker"));
+const storage_1 = require("../src/core/storage");
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+describe('BytemTracker SDK', () => {
+    const mockConfig = {
+        appId: 'test-app-id',
+        endpoint: 'https://api.example.com/track',
+        debug: true,
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Reset singleton instance manually
+        // @ts-ignore
+        BytemTracker_1.default.instance = undefined;
+        // @ts-ignore
+        BytemTracker_1.default.isInitialized = false;
+        // @ts-ignore
+        BytemTracker_1.default.config = null;
+        // @ts-ignore
+        BytemTracker_1.default.visitorId = null;
+    });
+    it('should initialize correctly', async () => {
+        await BytemTracker_1.default.init(mockConfig);
+        // Verify Storage was checked for Visitor ID
+        expect(async_storage_1.default.getItem).toHaveBeenCalledWith(storage_1.StorageKeys.VISITOR_ID);
+        // Verify Session was initialized (checks storage)
+        expect(async_storage_1.default.getItem).toHaveBeenCalledWith(storage_1.StorageKeys.SESSION_ID);
+    });
+    it('should track an event', async () => {
+        // Ensure initialized (singleton persists)
+        await BytemTracker_1.default.init(mockConfig);
+        const eventName = 'test_event';
+        const eventParams = { foo: 'bar' };
+        // @ts-ignore - Accessing private method for testing or just use public track methods
+        // Since track is private, we'll use a public method like trackUser or just trust the public API
+        // Let's use trackUser as a proxy for generic tracking
+        BytemTracker_1.default.trackUser('user-123', { age: 25 });
+        // Wait for async operations if any (track is async but void return in public API might hide it)
+        // In BytemTracker.ts, trackUser calls track, which is async but not awaited by caller.
+        // We need to wait for promises to resolve.
+        await new Promise(resolve => setTimeout(resolve, 0));
+        expect(global.fetch).toHaveBeenCalledTimes(1);
+        const fetchCall = global.fetch.mock.calls[0];
+        const url = fetchCall[0];
+        const options = fetchCall[1];
+        expect(url).toBe(mockConfig.endpoint);
+        expect(options.method).toBe('POST');
+        const body = JSON.parse(options.body);
+        expect(body.app_id).toBe(mockConfig.appId);
+        // expect(body.event).toBe('identify'); 
+    });
+    it('should use default endpoint when not provided', async () => {
+        await BytemTracker_1.default.init({
+            appId: 'test-app-id',
+            // endpoint is omitted
+            debug: true,
+        });
+        BytemTracker_1.default.trackUser('user-123', { age: 25 });
+        await new Promise(resolve => setTimeout(resolve, 0));
+        expect(global.fetch).toHaveBeenCalledTimes(1);
+        const fetchCall = global.fetch.mock.calls[0];
+        const url = fetchCall[0];
+        expect(url).toBe('https://tracking.server.bytecon.com/i');
+    });
+    it('should override endpoint path when path is configured', async () => {
+        await BytemTracker_1.default.init({
+            appId: 'test-app-id-2',
+            endpoint: 'https://api.example.com/track',
+            path: '/collect',
+            debug: true,
+        });
+        BytemTracker_1.default.trackUser('user-456', { age: 30 });
+        await new Promise(resolve => setTimeout(resolve, 0));
+        expect(global.fetch).toHaveBeenCalledTimes(1);
+        const fetchCall = global.fetch.mock.calls[0];
+        const url = fetchCall[0];
+        expect(url).toBe('https://api.example.com/collect');
+    });
+});

package/dist/test/debug.test.d.ts

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

package/dist/test/debug.test.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BytemTracker_1 = __importDefault(require("../src/BytemTracker"));
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+describe('Debug Scenarios', () => {
+    const mockConfig = {
+        appId: 'debug-app-id',
+        endpoint: 'https://debug-api.bytem.com/track',
+        debug: true,
+    };
+    beforeEach(async () => {
+        jest.clearAllMocks();
+        // Simulate fresh start
+        async_storage_1.default.getItem.mockResolvedValue(null);
+        await BytemTracker_1.default.init(mockConfig);
+    });
+    it('Scenario: User Journey - View Product -> Add to Cart -> Checkout', async () => {
+        // 1. View Product
+        console.log('>>> Step 1: Tracking View Product');
+        BytemTracker_1.default.trackViewProduct({
+            productId: 'p_1001',
+            name: 'Debug Smartphone',
+            price: 699.00,
+            currency: 'USD',
+            category: 'Electronics'
+        });
+        // Wait for async track
+        await new Promise(resolve => setTimeout(resolve, 0));
+        // 2. Identify User (Simulate Login)
+        console.log('>>> Step 2: User Login');
+        BytemTracker_1.default.trackUser('user_debug_001', {
+            plan: 'premium',
+            login_method: 'email'
+        });
+        await new Promise(resolve => setTimeout(resolve, 0));
+        // 3. Checkout
+        console.log('>>> Step 3: Checkout');
+        BytemTracker_1.default.trackCheckOutOrder({
+            orderId: 'order_999',
+            total: 699.00,
+            currency: 'USD',
+            products: [
+                { productId: 'p_1001', price: 699.00, quantity: 1 }
+            ]
+        });
+        await new Promise(resolve => setTimeout(resolve, 0));
+        // Assertions to verify flow
+        expect(global.fetch).toHaveBeenCalledTimes(3);
+        const calls = global.fetch.mock.calls;
+        // Check Event Types
+        const events = calls.map((call) => JSON.parse(call[1].body).event);
+        console.log('>>> Captured Events:', events);
+        expect(events).toEqual(['view_product', 'identify', 'checkout_order']);
+    });
+});

package/dist/test/setup.d.ts

@@ -0,0 +1 @@
+declare const mockStorage: Record<string, string>;

package/dist/test/setup.js

@@ -0,0 +1,56 @@
+"use strict";
+// Mock AsyncStorage
+const mockStorage = {};
+jest.mock('@react-native-async-storage/async-storage', () => ({
+    setItem: jest.fn((key, value) => {
+        mockStorage[key] = value;
+        return Promise.resolve(null);
+    }),
+    getItem: jest.fn((key) => {
+        return Promise.resolve(mockStorage[key] || null);
+    }),
+    removeItem: jest.fn((key) => {
+        delete mockStorage[key];
+        return Promise.resolve(null);
+    }),
+    clear: jest.fn(() => {
+        for (const key in mockStorage)
+            delete mockStorage[key];
+        return Promise.resolve(null);
+    }),
+}));
+// Mock React Native Device Info
+jest.mock('react-native-device-info', () => ({
+    getSystemName: jest.fn(() => 'iOS'),
+    getSystemVersion: jest.fn(() => '14.0'),
+    getModel: jest.fn(() => 'iPhone 11'),
+    getUserAgent: jest.fn(() => Promise.resolve('Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)')),
+}));
+// Mock React Native
+jest.mock('react-native', () => ({
+    Platform: {
+        OS: 'ios',
+        select: jest.fn(),
+    },
+    Dimensions: {
+        get: jest.fn(() => ({ width: 375, height: 812 })),
+    },
+    NativeModules: {
+        SettingsManager: {
+            settings: {
+                AppleLocale: 'en_US',
+                AppleLanguages: ['en-US'],
+            },
+        },
+        I18nManager: {
+            localeIdentifier: 'en_US',
+        },
+    },
+}));
+// Mock global fetch
+global.fetch = jest.fn(() => Promise.resolve({
+    ok: true,
+    status: 200,
+    statusText: 'OK',
+    json: () => Promise.resolve({}),
+}));

package/package.json

@@ -1,31 +1,50 @@
 {
   "name": "@bytem/bytem-tracker-app",
-  "version": "0.0.3",
+  "version": "0.0.6",
+  "description": "Bytem Tracker SDK for React Native",
   "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"
+    "test": "jest",
+    "prepublishOnly": "npm run build",
+    "release:patch": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish",
+    "release:beta": "npm version prerelease --preid=beta && npm publish --tag beta"
   },
+  "keywords": [
+    "tracker",
+    "sdk",
+    "analytics",
+    "react-native"
+  ],
+  "author": "Barry",
+  "license": "ISC",
   "peerDependencies": {
-    "react-native": ">=0.60.0"
+    "@react-native-async-storage/async-storage": "^1.0.0",
+    "react": ">=16.8.0",
+    "react-native": ">=0.60.0",
+    "react-native-device-info": "^10.0.0"
   },
   "dependencies": {
-    "@react-native-async-storage/async-storage": "^1.21.0",
     "uuid": "^9.0.0"
   },
   "devDependencies": {
-    "@types/react-native": "^0.73.0",
+    "@react-native-async-storage/async-storage": "^1.19.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-native": "^0.72.0",
     "@types/uuid": "^9.0.0",
-    "eslint": "^9.39.2",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "eslint-plugin-import": "^2.32.0",
+    "jest": "^30.2.0",
+    "react": "18.2.0",
+    "react-native": "0.72.0",
+    "react-native-device-info": "^10.8.0",
+    "ts-jest": "^29.4.6",
     "typescript": "^5.0.0"
   },
   "publishConfig": {

package/dist/env.d.ts

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

package/dist/env.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isExpoRuntime = isExpoRuntime;
-function isExpoRuntime() {
-    return typeof globalThis !== 'undefined' && !!globalThis.__expo;
-}

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BytemTracker = void 0;
-const tracker_1 = require("./tracker");
-Object.defineProperty(exports, "BytemTracker", { enumerable: true, get: function () { return tracker_1.BytemTracker; } });
-exports.default = tracker_1.BytemTracker.instance;

package/dist/tracker.d.ts

@@ -1,26 +0,0 @@
-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

@@ -1,120 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BytemTracker = void 0;
-const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
-const react_native_1 = require("react-native");
-const uuid_1 = require("./uuid");
-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;
-    }
-    init(options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            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;
-                yield async_storage_1.default.setItem(BytemTracker._storageDeviceIdKey, this._deviceId);
-            }
-            else {
-                yield this._loadOrCreateDeviceId();
-            }
-            yield this._loadOrCreateVisitorId();
-            this._log('init', {
-                deviceId: this._deviceId,
-                visitorId: this._visitorId,
-            });
-        });
-    }
-    track(eventKey_1) {
-        return __awaiter(this, arguments, void 0, function* (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: react_native_1.Platform.OS,
-                timestamp: Date.now(),
-                screen: this._getScreenInfo(),
-            };
-            this._log('track', payload);
-            try {
-                yield fetch(`${this._baseUrl}/track`, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify(payload),
-                });
-            }
-            catch (e) {
-                this._log('track error', e);
-            }
-        });
-    }
-    _loadOrCreateDeviceId() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stored = yield async_storage_1.default.getItem(BytemTracker._storageDeviceIdKey);
-            this._deviceId = stored !== null && stored !== void 0 ? stored : (0, uuid_1.generateUUID)();
-            if (!stored && this._deviceId) {
-                yield async_storage_1.default.setItem(BytemTracker._storageDeviceIdKey, this._deviceId);
-            }
-        });
-    }
-    _loadOrCreateVisitorId() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stored = yield async_storage_1.default.getItem(BytemTracker._storageVisitorIdKey);
-            this._visitorId = stored !== null && stored !== void 0 ? stored : (0, uuid_1.generateUUID)();
-            if (!stored && this._visitorId) {
-                yield async_storage_1.default.setItem(BytemTracker._storageVisitorIdKey, this._visitorId);
-            }
-        });
-    }
-    _getScreenInfo() {
-        const { width, height } = react_native_1.Dimensions.get('window');
-        return { width, height };
-    }
-    _log(...args) {
-        if (this._debug) {
-            console.log('[BytemTracker]', ...args);
-        }
-    }
-}
-exports.BytemTracker = BytemTracker;
-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

@@ -1,24 +0,0 @@
-/** 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/uuid.d.ts

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

package/dist/uuid.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateUUID = generateUUID;
-const uuid_1 = require("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);
-    });
-}
-function generateUUID() {
-    try {
-        return (0, uuid_1.v4)();
-    }
-    catch (_a) {
-        return jsUUIDv4();
-    }
-}