@bytem/bytem-tracker-app 0.0.17 → 0.0.19

package/README.md

@@ -7,7 +7,10 @@ This is the official Bytem Tracker SDK for React Native applications.
 Install the package using Yarn:
 
 ```bash
-yarn add @bytem/bytem-tracker-app @react-native-async-storage/async-storage
+# need
+yarn add @bytem/bytem-tracker-app
+# if not
+yarn add @react-native-async-storage/async-storage
 ```
 
 ### iOS Setup
@@ -31,7 +34,7 @@ const App = () => {
       await BytemTracker.init({
         appKey: 'your-app-key',
         endpoint: 'https://api.bytem.com/track',
-        debug: __DEV__, // Enable debug logs in development
+        debug: false, // Enable debug logs in development
       });
     };
 
@@ -69,6 +72,9 @@ await BytemTracker.trackViewProduct({
   currency: 'USD',
   category: 'Electronics',
   url: 'https://example.com/products/prod-001'
+}, {
+  source: 'Home Page',
+  position: 'Recommended'
 });
 ```
 
@@ -84,6 +90,9 @@ await BytemTracker.trackAddToCart({
   category: 'Electronics',
   url: 'https://example.com/products/prod-001',
   quantity: 1
+}, {
+  source: 'Product Detail',
+  position: 'Bottom Bar'
 });
 ```
 
@@ -98,6 +107,9 @@ await BytemTracker.trackAddWishlist({
   currency: 'USD',
   category: 'Electronics',
   url: 'https://example.com/products/prod-001'
+}, {
+  source: 'Product Detail',
+  position: 'Top Right'
 });
 ```
 
@@ -112,8 +124,10 @@ const products = [
 
 await BytemTracker.trackGoodsImpression(
   products,
-  'Home Page', // Source
-  'Recommended For You' // Position (optional)
+  {
+    source: 'Home Page',
+    position: 'Recommended For You'
+  }
 );
 ```
 
@@ -123,7 +137,7 @@ Track when a user clicks on a product.
 ```typescript
 await BytemTracker.trackGoodsClick({
   gid: 'prod_001', // Product ID
-  url: 'https://example.com/p/1',
+  // url: 'https://example.com/p/1', // Optional
   source: 'Home Page',
   position: '1'
 });
@@ -141,6 +155,9 @@ await BytemTracker.trackCheckOutOrder({
     { productId: 'prod_001', price: 99.99, quantity: 1 },
     { productId: 'prod_002', price: 50.01, quantity: 1 }
   ]
+}, {
+  source: 'Cart',
+  position: 'Checkout Button'
 });
 ```
 
@@ -156,6 +173,9 @@ await BytemTracker.trackPayOrder({
     { productId: 'prod_001', price: 99.99, quantity: 1 },
     { productId: 'prod_002', price: 50.01, quantity: 1 }
   ]
+}, {
+  source: 'Checkout',
+  position: 'Pay Now'
 });
 ```
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bytem/bytem-tracker-app",
-    "version": "0.0.17",
+    "version": "0.0.19",
     "description": "Bytem Tracker SDK for React Native",
     "main": "dist/src/index.js",
     "types": "dist/src/index.d.ts",

package/dist/src/BytemTracker.d.ts

@@ -1,4 +1,4 @@
-import { TrackerConfig, Product, Order, UserTraits } from './types';
+import { TrackerConfig, Product, Order, UserTraits, GoodsClickParams, TrackingParams } from './types';
 declare class BytemTracker {
     private static instance;
     private readonly SDK_NAME;
@@ -89,15 +89,7 @@ declare class BytemTracker {
      *
      * @param params - The parameters for the goods click event.
      */
-    trackGoodsClick(params: {
-        gid?: string;
-        skuid?: string;
-        url: string;
-        source?: string;
-        position?: string;
-        current?: string;
-        referrer?: string;
-    }): Promise<void>;
+    trackGoodsClick(params: GoodsClickParams, customParams?: Record<string, any>): Promise<void>;
     private reportViewDuration;
     private getRealDeviceId;
     private getMetrics;
@@ -110,42 +102,43 @@ declare class BytemTracker {
      *
      * @param product - The product object to track.
      */
-    trackViewProduct(product: Product): Promise<void>;
+    trackViewProduct(product: Product, params: TrackingParams): Promise<void>;
     /**
      * Tracks an add-to-cart event.
      *
      * @param product - The product added to cart.
+     * @param params - Additional parameters (current, source, position, etc.) or overrides.
      */
-    trackAddToCart(product: Product): Promise<void>;
+    trackAddToCart(product: Product, params: TrackingParams): Promise<void>;
     /**
      * Track goods impression (e.g. collection page view)
      * @param products List of products displayed
-     * @param source Source page/section
-     * @param position Position in the list/page
+     * @param params Additional parameters (source, position, etc.) or overrides.
      */
-    trackGoodsImpression(products: Product[], source?: string, position?: string): Promise<void>;
+    trackGoodsImpression(products: Product[], params: TrackingParams): Promise<void>;
     /**
      * Tracks an add-to-wishlist event.
      * @param product - The product added to wishlist.
+     * @param params - Additional parameters or overrides.
      */
-    trackAddWishlist(product: Product): Promise<void>;
+    trackAddWishlist(product: Product, params: TrackingParams): Promise<void>;
     /**
      * Tracks a checkout order event.
      * Automatically splits product lists into parallel arrays (gid, price, quantity)
      * to match the backend requirement.
      *
      * @param order - The order object containing products to checkout.
-     * @param source - Source page/section
-     * @param position - Position info
+     * @param params - Additional parameters (source, position, etc.) or overrides.
      */
-    trackCheckOutOrder(order: Order, source?: string, position?: string): Promise<void>;
+    trackCheckOutOrder(order: Order, params: TrackingParams): Promise<void>;
     /**
      * Tracks a payment order event.
      * Maps product list to a 'goods' array structure expected by the backend.
      *
      * @param order - The order object that was paid for.
+     * @param params - Additional parameters or overrides.
      */
-    trackPayOrder(order: Order): Promise<void>;
+    trackPayOrder(order: Order, params: TrackingParams): Promise<void>;
     /**
      * Tracks user details/profile updates.
      *

package/dist/src/BytemTracker.js

@@ -431,25 +431,19 @@ class BytemTracker {
      *
      * @param params - The parameters for the goods click event.
      */
-    async trackGoodsClick(params) {
+    async trackGoodsClick(params, customParams) {
         try {
             if (!this.checkInitialized())
                 return;
-            const segmentation = {
-                gid: params.gid || '',
-                skuid: params.skuid || '',
-                url: params.url,
-                current: params.current || '',
-                referrer: params.referrer || '',
-                visitor_id: this.visitorId || '',
-            };
-            if (this.appScheme)
-                segmentation.domain = this.appScheme;
-            if (params.source)
-                segmentation.source = params.source;
-            if (params.position)
-                segmentation.position = params.position;
-            await this.trackEvent('goods_click', segmentation); // Using string literal as Dart does in implementation
+            const finalParams = Object.assign({}, customParams);
+            if (this.appScheme && !finalParams.domain) {
+                finalParams.domain = this.appScheme;
+            }
+            if (this.visitorId && !finalParams.visitor_id) {
+                finalParams.visitor_id = this.visitorId;
+            }
+            const payload = Business.trackGoodsClick(params, finalParams);
+            await this.trackEvent(payload.event, payload.params);
         }
         catch (e) {
             if (this.debug)
@@ -588,20 +582,19 @@ class BytemTracker {
      *
      * @param product - The product object to track.
      */
-    async trackViewProduct(product) {
+    async trackViewProduct(product, params) {
         try {
             if (!this.checkInitialized())
                 return;
-            // Map Product to segmentation
-            const segmentation = {
-                product_id: product.productId,
-                name: product.name,
-                price: product.price,
-                currency: product.currency,
-                category: product.category,
-            };
-            // In Dart, trackViewProduct sends "view_product" event.
-            await this.trackEvent('view_product', segmentation);
+            const finalParams = Object.assign({}, params);
+            if (this.appScheme && !finalParams.domain) {
+                finalParams.domain = this.appScheme;
+            }
+            if (this.visitorId && !finalParams.visitor_id) {
+                finalParams.visitor_id = this.visitorId;
+            }
+            const payload = Business.trackViewProduct(product, finalParams);
+            await this.trackEvent(payload.event, payload.params);
         }
         catch (e) {
             if (this.debug)
@@ -612,21 +605,21 @@ class BytemTracker {
      * Tracks an add-to-cart event.
      *
      * @param product - The product added to cart.
+     * @param params - Additional parameters (current, source, position, etc.) or overrides.
      */
-    async trackAddToCart(product) {
+    async trackAddToCart(product, params) {
         try {
             if (!this.checkInitialized())
                 return;
-            const segmentation = {
-                gid: product.productId,
-                name: product.name,
-                price: product.price,
-                currency: product.currency,
-                category: product.category,
-                quantity: product.quantity || 1,
-                url: product.url,
-            };
-            await this.trackEvent('add_to_cart', segmentation);
+            const finalParams = Object.assign({}, params);
+            if (this.appScheme && !finalParams.domain) {
+                finalParams.domain = this.appScheme;
+            }
+            if (this.visitorId && !finalParams.visitor_id) {
+                finalParams.visitor_id = this.visitorId;
+            }
+            const payload = Business.trackAddToCart(product, finalParams);
+            await this.trackEvent(payload.event, payload.params);
         }
         catch (e) {
             if (this.debug)
@@ -636,14 +629,17 @@ class BytemTracker {
     /**
      * Track goods impression (e.g. collection page view)
      * @param products List of products displayed
-     * @param source Source page/section
-     * @param position Position in the list/page
+     * @param params Additional parameters (source, position, etc.) or overrides.
      */
-    async trackGoodsImpression(products, source, position) {
+    async trackGoodsImpression(products, params) {
         try {
             if (!this.checkInitialized())
                 return;
-            const payload = Business.trackGoodsImpression(products, source, position);
+            const finalParams = Object.assign({}, params);
+            if (this.appScheme && !finalParams.domain) {
+                finalParams.domain = this.appScheme;
+            }
+            const payload = Business.trackGoodsImpression(products, finalParams);
             await this.trackEvent(payload.event, payload.params);
         }
         catch (e) {
@@ -654,12 +650,17 @@ class BytemTracker {
     /**
      * Tracks an add-to-wishlist event.
      * @param product - The product added to wishlist.
+     * @param params - Additional parameters or overrides.
      */
-    async trackAddWishlist(product) {
+    async trackAddWishlist(product, params) {
         try {
             if (!this.checkInitialized())
                 return;
-            const payload = Business.trackAddWishlist(product);
+            const finalParams = Object.assign({}, params);
+            if (this.appScheme && !finalParams.domain) {
+                finalParams.domain = this.appScheme;
+            }
+            const payload = Business.trackAddWishlist(product, finalParams);
             await this.trackEvent(payload.event, payload.params);
         }
         catch (e) {
@@ -673,14 +674,17 @@ class BytemTracker {
      * to match the backend requirement.
      *
      * @param order - The order object containing products to checkout.
-     * @param source - Source page/section
-     * @param position - Position info
+     * @param params - Additional parameters (source, position, etc.) or overrides.
      */
-    async trackCheckOutOrder(order, source, position) {
+    async trackCheckOutOrder(order, params) {
         try {
             if (!this.checkInitialized())
                 return;
-            const payload = Business.trackCheckOutOrder(order, source, position);
+            const finalParams = Object.assign({}, params);
+            if (this.appScheme && !finalParams.domain) {
+                finalParams.domain = this.appScheme;
+            }
+            const payload = Business.trackCheckOutOrder(order, finalParams);
             await this.trackEvent(payload.event, payload.params);
         }
         catch (e) {
@@ -693,26 +697,18 @@ class BytemTracker {
      * Maps product list to a 'goods' array structure expected by the backend.
      *
      * @param order - The order object that was paid for.
+     * @param params - Additional parameters or overrides.
      */
-    async trackPayOrder(order) {
+    async trackPayOrder(order, params) {
         try {
             if (!this.checkInitialized())
                 return;
-            const segmentation = {
-                order_id: order.orderId,
-                total: order.total,
-                currency: order.currency,
-            };
-            if (order.products && order.products.length > 0) {
-                // Dart maps this to a list of maps called "goods"
-                segmentation.goods = order.products.map(p => ({
-                    gid: p.productId,
-                    name: p.name,
-                    price: p.price,
-                    quantity: p.quantity || 1,
-                }));
-            }
-            await this.trackEvent('pay_order', segmentation);
+            const finalParams = Object.assign({}, params);
+            if (this.appScheme && !finalParams.domain) {
+                finalParams.domain = this.appScheme;
+            }
+            const payload = Business.trackPayOrder(order, finalParams);
+            await this.trackEvent(payload.event, payload.params);
         }
         catch (e) {
             if (this.debug)

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

@@ -4,3 +4,4 @@ export * from './trackCheckOutOrder';
 export * from './trackPayOrder';
 export * from './trackGoodsImpression';
 export * from './trackAddWishlist';
+export * from './trackGoodsClick';

package/dist/src/business/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./trackCheckOutOrder"), exports);
 __exportStar(require("./trackPayOrder"), exports);
 __exportStar(require("./trackGoodsImpression"), exports);
 __exportStar(require("./trackAddWishlist"), exports);
+__exportStar(require("./trackGoodsClick"), exports);

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

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

package/dist/src/business/trackAddToCart.js

@@ -1,18 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackAddToCart = void 0;
-const trackAddToCart = (product) => {
+const trackAddToCart = (product, params) => {
+    const defaultParams = {
+        gid: product.productId,
+        name: product.name,
+        price: product.price,
+        currency: product.currency,
+        category: product.category,
+        quantity: product.quantity || 1,
+        url: product.url || '',
+    };
     return {
         event: 'add_to_cart',
-        params: {
-            gid: product.productId,
-            name: product.name,
-            price: product.price,
-            currency: product.currency,
-            category: product.category,
-            quantity: product.quantity || 1,
-            url: product.url,
-        },
+        params: Object.assign(Object.assign({}, defaultParams), params),
     };
 };
 exports.trackAddToCart = trackAddToCart;

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

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

package/dist/src/business/trackAddWishlist.js

@@ -1,18 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackAddWishlist = void 0;
-const trackAddWishlist = (product) => {
+const trackAddWishlist = (product, params) => {
+    const defaultParams = {
+        gid: product.productId,
+        name: product.name,
+        price: product.price,
+        currency: product.currency,
+        category: product.category,
+        quantity: product.quantity || 1,
+        url: product.url || '',
+    };
     return {
         event: 'add_wishlist',
-        params: {
-            gid: product.productId,
-            name: product.name,
-            price: product.price,
-            currency: product.currency,
-            category: product.category,
-            quantity: product.quantity || 1,
-            url: product.url,
-        },
+        params: Object.assign(Object.assign({}, defaultParams), params),
     };
 };
 exports.trackAddWishlist = trackAddWishlist;

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

@@ -1,2 +1,2 @@
-import { EventPayload, Order } from '../types';
-export declare const trackCheckOutOrder: (order: Order, source?: string, position?: string) => EventPayload;
+import { EventPayload, Order, TrackingParams } from '../types';
+export declare const trackCheckOutOrder: (order: Order, params: TrackingParams) => EventPayload;

package/dist/src/business/trackCheckOutOrder.js

@@ -1,19 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackCheckOutOrder = void 0;
-const trackCheckOutOrder = (order, source, position) => {
+const trackCheckOutOrder = (order, params) => {
+    const defaultParams = {
+        gid: order.products.map(p => p.productId),
+        url: order.products.map(p => p.url || ''),
+        price: order.products.map(p => p.price || 0),
+        quantity: order.products.map(p => p.quantity || 1),
+        amount: order.total,
+        currency: order.currency,
+    };
     return {
         event: 'check_out_order',
-        params: {
-            gid: order.products.map(p => p.productId),
-            url: order.products.map(p => p.url || ''),
-            price: order.products.map(p => p.price || 0),
-            quantity: order.products.map(p => p.quantity || 1),
-            amount: order.total,
-            currency: order.currency,
-            source: source || 'Other Page',
-            position: position || ''
-        },
+        params: Object.assign(Object.assign({}, defaultParams), params),
     };
 };
 exports.trackCheckOutOrder = trackCheckOutOrder;

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

@@ -0,0 +1,2 @@
+import { EventPayload, GoodsClickParams } from '../types';
+export declare const trackGoodsClick: (goodsParams: GoodsClickParams, params?: Record<string, any>) => EventPayload;

package/dist/src/business/trackGoodsClick.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackGoodsClick = void 0;
+const trackGoodsClick = (goodsParams, params) => {
+    const defaultParams = {
+        gid: goodsParams.gid,
+        skuid: goodsParams.skuid || '',
+        url: goodsParams.url || '',
+        current: goodsParams.current || '',
+        referrer: goodsParams.referrer || '',
+        source: goodsParams.source,
+        position: goodsParams.position,
+    };
+    return {
+        event: 'goods_click',
+        params: Object.assign(Object.assign({}, defaultParams), params),
+    };
+};
+exports.trackGoodsClick = trackGoodsClick;

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

@@ -1,2 +1,2 @@
-import { EventPayload, Product } from '../types';
-export declare const trackGoodsImpression: (products: Product[], source?: string, position?: string) => EventPayload;
+import { EventPayload, Product, TrackingParams } from '../types';
+export declare const trackGoodsImpression: (products: Product[], params: TrackingParams) => EventPayload;

package/dist/src/business/trackGoodsImpression.js

@@ -1,22 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackGoodsImpression = void 0;
-const trackGoodsImpression = (products, source, position) => {
+const trackGoodsImpression = (products, params) => {
     const gids = products.map(p => p.productId);
     const urls = products.map(p => p.url || '');
-    // Currently Product doesn't have skuid, so we leave it empty or undefined?
-    // dart/main.js: "skuid": skuids != null ? skuids : [],
+    const defaultParams = {
+        gid: gids,
+        skuid: [], // Empty for now as not in Product interface
+        urls: urls,
+    };
     return {
         event: 'goods_impression',
-        params: {
-            gid: gids,
-            skuid: [], // Empty for now as not in Product interface
-            urls: urls,
-            source: source || 'Other Page', // Default from dart/main.js? line 7: source= 'Other Page'
-            position: position || '',
-            // visitor_id, ab, realab are handled by BytemTracker automatically or need to be passed?
-            // BytemTracker usually handles common params like visitor_id.
-        },
+        params: Object.assign(Object.assign({}, defaultParams), params),
     };
 };
 exports.trackGoodsImpression = trackGoodsImpression;

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

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

package/dist/src/business/trackPayOrder.js

@@ -1,21 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackPayOrder = void 0;
-const trackPayOrder = (order) => {
+const trackPayOrder = (order, params) => {
+    const defaultParams = {
+        order_id: order.orderId,
+        total: order.total,
+        currency: order.currency,
+    };
+    if (order.products && order.products.length > 0) {
+        // Maps to a list of maps called "goods" to match backend requirement
+        defaultParams.goods = order.products.map(p => ({
+            gid: p.productId,
+            name: p.name,
+            price: p.price,
+            quantity: p.quantity || 1,
+        }));
+    }
     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',
-        },
+        params: Object.assign(Object.assign({}, defaultParams), params),
     };
 };
 exports.trackPayOrder = trackPayOrder;

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

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

package/dist/src/business/trackViewProduct.js

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

package/dist/src/types.d.ts

@@ -87,6 +87,21 @@ export interface Order {
     currency: string;
     products: Product[];
 }
+export interface GoodsClickParams {
+    gid: string;
+    skuid?: string;
+    url?: string;
+    source: string;
+    position: string;
+    current?: string;
+    referrer?: string;
+}
+export interface TrackingParams {
+    current?: string;
+    source: string;
+    position: string;
+    [key: string]: any;
+}
 export interface EventPayload {
     event: string;
     params: Record<string, any>;

package/dist/test/BytemTracker.test.js

@@ -210,6 +210,38 @@ describe('BytemTracker SDK', () => {
         beforeEach(async () => {
             await BytemTracker_1.default.init(mockConfig);
         });
+        it('should track add to cart with custom params and appScheme', async () => {
+            // Manually set appScheme since re-init is blocked by singleton check
+            // @ts-ignore
+            BytemTracker_1.default.appScheme = 'bytem.com';
+            const product = {
+                productId: 'prod_123',
+                name: 'Test Product',
+                price: 99.99,
+                currency: 'USD',
+                category: 'Electronics',
+                url: 'http://example.com/p/1'
+            };
+            const params = {
+                current: 'Product Detail Page',
+                source: 'Detail Page',
+                position: 'Add To Cart',
+                extra_key: 'extra_value'
+            };
+            await BytemTracker_1.default.trackAddToCart(product, params);
+            const calls = global.fetch.mock.calls;
+            const eventCall = calls.find(call => call[1].body && call[1].body.includes('events='));
+            const events = JSON.parse(new URLSearchParams(eventCall[1].body).get('events') || '[]');
+            expect(events[0].key).toBe('add_to_cart');
+            expect(events[0].segmentation).toMatchObject({
+                gid: 'prod_123',
+                name: 'Test Product',
+                current: 'Product Detail Page',
+                source: 'Detail Page',
+                position: 'Add To Cart',
+                extra_key: 'extra_value'
+            });
+        });
         it('should track checkout order', async () => {
             const order = {
                 orderId: 'order_123',
@@ -220,7 +252,7 @@ describe('BytemTracker SDK', () => {
                     { productId: 'prod_2', price: 49.99, quantity: 1 }
                 ]
             };
-            await BytemTracker_1.default.trackCheckOutOrder(order);
+            await BytemTracker_1.default.trackCheckOutOrder(order, { current: 'Checkout Page', source: 'Cart', position: 'Checkout' });
             const calls = global.fetch.mock.calls;
             const eventCall = calls.find(call => call[1].body && call[1].body.includes('events='));
             const events = JSON.parse(new URLSearchParams(eventCall[1].body).get('events') || '[]');
@@ -231,7 +263,8 @@ describe('BytemTracker SDK', () => {
                 quantity: [1, 1],
                 amount: 99.99,
                 currency: 'USD',
-                url: ['', '']
+                url: ['', ''],
+                current: 'Checkout Page'
             });
         });
         it('should track view product', async () => {
@@ -242,7 +275,7 @@ describe('BytemTracker SDK', () => {
                 currency: 'USD',
                 category: 'Electronics'
             };
-            await BytemTracker_1.default.trackViewProduct(product);
+            await BytemTracker_1.default.trackViewProduct(product, { current: 'Product Page', source: 'List', position: 'Item' });
             const calls = global.fetch.mock.calls;
             const eventCall = calls.find(call => call[1].body && call[1].body.includes('events='));
             const events = JSON.parse(new URLSearchParams(eventCall[1].body).get('events') || '[]');
@@ -252,16 +285,26 @@ describe('BytemTracker SDK', () => {
                 name: 'Test Product',
                 price: 99.99,
                 currency: 'USD',
-                category: 'Electronics'
+                category: 'Electronics',
+                current: 'Product Page'
             });
         });
-        it('should track goods click', async () => {
+        it('should track goods click with custom params', async () => {
+            // Manually set appScheme
+            // @ts-ignore
+            BytemTracker_1.default.appScheme = 'bytem.com';
             const params = {
                 gid: 'goods_123',
                 url: 'https://example.com/product/123',
-                source: 'recommendation'
+                current: 'Product Page',
+                source: 'recommendation',
+                position: 'default_position'
             };
-            await BytemTracker_1.default.trackGoodsClick(params);
+            const customParams = {
+                extra_key: 'extra_value',
+                position: 'custom_position'
+            };
+            await BytemTracker_1.default.trackGoodsClick(params, customParams);
             const calls = global.fetch.mock.calls;
             const eventCall = calls.find(call => call[1].body && call[1].body.includes('events='));
             const events = JSON.parse(new URLSearchParams(eventCall[1].body).get('events') || '[]');
@@ -269,7 +312,36 @@ describe('BytemTracker SDK', () => {
             expect(events[0].segmentation).toMatchObject({
                 gid: 'goods_123',
                 url: 'https://example.com/product/123',
-                source: 'recommendation'
+                source: 'recommendation',
+                current: 'Product Page',
+                extra_key: 'extra_value',
+                position: 'custom_position'
+            });
+            // Verify visitor_id is present (in segmentation or base params, here it is in segmentation because of legacy logic)
+            expect(events[0].segmentation.visitor_id).toBeDefined();
+        });
+        it('should track goods click without url', async () => {
+            // Manually set appScheme
+            // @ts-ignore
+            BytemTracker_1.default.appScheme = 'bytem.com';
+            const params = {
+                gid: 'goods_123',
+                // url is omitted
+                current: 'Product Page',
+                source: 'recommendation',
+                position: 'default_position'
+            };
+            await BytemTracker_1.default.trackGoodsClick(params);
+            const calls = global.fetch.mock.calls;
+            const eventCall = calls.find(call => call[1].body && call[1].body.includes('events='));
+            const events = JSON.parse(new URLSearchParams(eventCall[1].body).get('events') || '[]');
+            expect(events[0].key).toBe('goods_click');
+            expect(events[0].segmentation).toMatchObject({
+                gid: 'goods_123',
+                url: '', // Should default to empty string
+                source: 'recommendation',
+                current: 'Product Page',
+                position: 'default_position'
             });
         });
         it('should track pay order', async () => {
@@ -282,7 +354,7 @@ describe('BytemTracker SDK', () => {
                     { productId: 'prod_2', name: 'Product 2', price: 49.99, quantity: 2 }
                 ]
             };
-            await BytemTracker_1.default.trackPayOrder(order);
+            await BytemTracker_1.default.trackPayOrder(order, { current: 'Payment Page', source: 'Checkout', position: 'Pay Button' });
             const calls = global.fetch.mock.calls;
             const eventCall = calls.find(call => call[1].body && call[1].body.includes('events='));
             const events = JSON.parse(new URLSearchParams(eventCall[1].body).get('events') || '[]');
@@ -291,6 +363,7 @@ describe('BytemTracker SDK', () => {
                 order_id: 'order_123',
                 total: 99.99,
                 currency: 'USD',
+                current: 'Payment Page',
                 goods: [
                     { gid: 'prod_1', name: 'Product 1', price: 50, quantity: 1 },
                     { gid: 'prod_2', name: 'Product 2', price: 49.99, quantity: 2 }

package/dist/test/addToCart.test.js

@@ -30,7 +30,11 @@ describe('BytemTracker Add To Cart', () => {
             quantity: 2,
             url: 'https://example.com/product/p_1001'
         };
-        await BytemTracker_1.default.trackAddToCart(product);
+        await BytemTracker_1.default.trackAddToCart(product, {
+            current: 'Product Detail Page',
+            source: 'Detail Page',
+            position: 'Add To Cart'
+        });
         expect(global.fetch).toHaveBeenCalled();
         const calls = global.fetch.mock.calls;
         const body = calls[calls.length - 1][1].body;
@@ -39,14 +43,17 @@ describe('BytemTracker Add To Cart', () => {
         const eventsJson = params.get('events');
         const events = JSON.parse(eventsJson);
         expect(events[0].key).toBe('add_to_cart');
-        expect(events[0].segmentation).toEqual({
+        expect(events[0].segmentation).toMatchObject({
             gid: 'p_1001',
             name: 'Test Product',
             price: 99.99,
             currency: 'USD',
             category: 'Electronics',
             quantity: 2,
-            url: 'https://example.com/product/p_1001'
+            url: 'https://example.com/product/p_1001',
+            current: 'Product Detail Page',
+            source: 'Detail Page',
+            position: 'Add To Cart'
         });
     });
     it('should use default quantity of 1 if not provided', async () => {
@@ -55,7 +62,11 @@ describe('BytemTracker Add To Cart', () => {
             name: 'Single Product',
             price: 10.00,
         };
-        await BytemTracker_1.default.trackAddToCart(product);
+        await BytemTracker_1.default.trackAddToCart(product, {
+            current: 'Quick View',
+            source: 'Quick View',
+            position: 'Add Button'
+        });
         const calls = global.fetch.mock.calls;
         const body = calls[calls.length - 1][1].body;
         const params = new URLSearchParams(body);

package/dist/test/additionalMethods.test.js

@@ -9,6 +9,7 @@ global.fetch = jest.fn(() => Promise.resolve({
     ok: true,
     status: 200,
     json: () => Promise.resolve({ status: 'success' }),
+    text: () => Promise.resolve('{"status":"success"}'),
 }));
 describe('BytemTracker Additional Methods', () => {
     const mockConfig = {
@@ -27,7 +28,11 @@ describe('BytemTracker Additional Methods', () => {
             price: 50.00,
             url: 'https://example.com/wish'
         };
-        await BytemTracker_1.default.trackAddWishlist(product);
+        await BytemTracker_1.default.trackAddWishlist(product, {
+            current: 'Product Detail Page',
+            source: 'Detail Page',
+            position: 'Wishlist Button'
+        });
         expect(global.fetch).toHaveBeenCalled();
         const calls = global.fetch.mock.calls;
         const body = calls[calls.length - 1][1].body;
@@ -51,7 +56,11 @@ describe('BytemTracker Additional Methods', () => {
                 { productId: 'p_2', price: 50.00, quantity: 1, url: 'https://example.com/p2' }
             ]
         };
-        await BytemTracker_1.default.trackCheckOutOrder(order, 'Cart Page', 'Checkout Button');
+        await BytemTracker_1.default.trackCheckOutOrder(order, {
+            current: 'Cart Page',
+            source: 'Cart Page',
+            position: 'Checkout Button'
+        });
         expect(global.fetch).toHaveBeenCalled();
         const calls = global.fetch.mock.calls;
         const body = calls[calls.length - 1][1].body;

package/dist/test/debug.test.js

@@ -41,6 +41,10 @@ describe('Debug Scenarios', () => {
             price: 699.00,
             currency: 'USD',
             category: 'Electronics'
+        }, {
+            current: 'Debug Page',
+            source: 'Debug List',
+            position: 'Item 1'
         });
         // Wait for async track
         await new Promise(resolve => setTimeout(resolve, 0));
@@ -60,6 +64,10 @@ describe('Debug Scenarios', () => {
             products: [
                 { productId: 'p_1001', price: 699.00, quantity: 1 }
             ]
+        }, {
+            current: 'Checkout Page',
+            source: 'Cart Page',
+            position: 'Checkout Button'
         });
         await new Promise(resolve => setTimeout(resolve, 0));
         // Assertions to verify flow

package/dist/test/goodsImpression.test.js

@@ -32,7 +32,11 @@ describe('BytemTracker Goods Impression', () => {
                 url: 'https://example.com/p2'
             }
         ];
-        await BytemTracker_1.default.trackGoodsImpression(products, 'Collection Page', 'Top List');
+        await BytemTracker_1.default.trackGoodsImpression(products, {
+            current: 'Collection Page',
+            source: 'Collection Page',
+            position: 'Top List'
+        });
         expect(global.fetch).toHaveBeenCalled();
         const calls = global.fetch.mock.calls;
         const body = calls[calls.length - 1][1].body;
@@ -52,7 +56,11 @@ describe('BytemTracker Goods Impression', () => {
         const products = [
             { productId: 'p_3' }
         ];
-        await BytemTracker_1.default.trackGoodsImpression(products);
+        await BytemTracker_1.default.trackGoodsImpression(products, {
+            current: 'Other Page',
+            source: 'Other Page',
+            position: 'List'
+        });
         expect(global.fetch).toHaveBeenCalled();
         const calls = global.fetch.mock.calls;
         const body = calls[calls.length - 1][1].body;
@@ -63,8 +71,8 @@ describe('BytemTracker Goods Impression', () => {
         expect(events[0].segmentation).toMatchObject({
             gid: ['p_3'],
             urls: [''], // Should default to empty string
-            source: 'Other Page', // Default value
-            position: '' // Default value
+            source: 'Other Page',
+            position: 'List'
         });
     });
 });

package/dist/test/setup.js

@@ -19,13 +19,6 @@ jest.mock('@react-native-async-storage/async-storage', () => ({
         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)')),
-}), { virtual: true });
 // Mock React Native
 jest.mock('react-native', () => ({
     Platform: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytem/bytem-tracker-app",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "Bytem Tracker SDK for React Native",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

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

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

package/dist/src/business/trackUser.js

@@ -1,13 +0,0 @@
-"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;