@magicpixel/rn-mp-client-sdk 1.13.0 → 1.13.21

package/lib/module/processors/visit-id.processor.js.map

@@ -1 +1 @@
-{"version":3,"names":["Logger","DataStore","Constants","Reporter","NetworkService","Utils","VisitIdProcessor","init","orgId","initDebugId","setOrResetVisitorId","setOrResetVisitInfo","isFirstOpenAfterInstall","firstOpenFlag","getDataFromStorage","KEY_FIRST_OPEN","storeData","err","logError","getFacebookFBP","fbp","KEY_FBP","Date","now","addCommonCookie","debugId","KEY_MP_DEBUG_ID","indexOf","undefined","getSimpleDebugId","setDebugId","incrementDepth","visitInfo","KEY_MP_IDL_VISIT_ID_INFO","visitId","getUniqueID","visitCt","visitDepth","visitTs","visitVer","_visitInfo","setVisitInfo","visitInfoToString","reportError","incrementVisitDepth","_visitorInfoData","visitorInfoData","KEY_MP_IDL_VISITOR_ID_INFO","mId","logDbg","fetchIdlInfo","getIdlUrl","setVisitorInfo","cookieValue","encodeURIComponent","JSON","stringify","dId"],"sources":["visit-id.processor.ts"],"sourcesContent":["import { Logger } from '../common/logger';\nimport { DataStore } from '../common/data-store';\nimport { Constants } from '../common/constants';\nimport { Reporter } from '../common/reporter';\nimport { NetworkService } from '../common/network-service';\nimport type { VisitInfo, VisitorInfo } from '../common/app-types';\nimport { Utils } from '../common/utils';\n\nexport class VisitIdProcessor {\n  static async init(orgId: string): Promise<void> {\n    await this.initDebugId(orgId);\n    await this.setOrResetVisitorId();\n    await this.setOrResetVisitInfo(false);\n  }\n\n  static async isFirstOpenAfterInstall(): Promise<boolean> {\n    try {\n      const firstOpenFlag = await DataStore.getDataFromStorage<string>(\n        Constants.KEY_FIRST_OPEN\n      );\n\n      if (!firstOpenFlag) {\n        await DataStore.storeData(Constants.KEY_FIRST_OPEN, 'No');\n        return true;\n      }\n    } catch (err) {\n      Logger.logError('Unable to determine first open after install flag', err);\n    }\n    return false;\n  }\n\n  static async getFacebookFBP(): Promise<string> {\n    try {\n      let fbp = await DataStore.getDataFromStorage<string>(Constants.KEY_FBP);\n\n      if (!fbp) {\n        fbp = `fb.1.${Date.now()}.${Date.now()}`;\n      }\n\n      await DataStore.storeData(Constants.KEY_FBP, fbp);\n\n      DataStore.addCommonCookie('x-fbp', fbp);\n\n      return fbp;\n    } catch (err) {\n      Logger.logError('Error initializing debug id.', err);\n    }\n    return '';\n  }\n\n  static async initDebugId(orgId: string): Promise<void> {\n    try {\n      let debugId = await DataStore.getDataFromStorage<string>(\n        Constants.KEY_MP_DEBUG_ID\n      );\n\n      if (debugId && debugId.indexOf(orgId) !== 0) {\n        // re-generate debug id if it is not of the simple variety\n        debugId = undefined;\n      }\n\n      if (!debugId) {\n        debugId = Utils.getSimpleDebugId(orgId);\n      }\n\n      await DataStore.storeData(Constants.KEY_MP_DEBUG_ID, debugId);\n      DataStore.setDebugId(debugId);\n    } catch (err) {\n      Logger.logError('Error initializing debug id.', err);\n    }\n  }\n\n  static async setOrResetVisitInfo(incrementDepth: boolean): Promise<void> {\n    try {\n      let visitInfo: VisitInfo = await DataStore.getDataFromStorage(\n        Constants.KEY_MP_IDL_VISIT_ID_INFO\n      );\n\n      if (!visitInfo) {\n        // may be first time visit, set up a new visit info object and return\n        visitInfo = {\n          visitId: Utils.getUniqueID(),\n          visitCt: 1,\n          visitDepth: 0,\n          visitTs: Date.now(),\n          visitVer: 1,\n        };\n      } else {\n        // reset visit id anyway, but retain the visitCt and depth setting\n        visitInfo.visitId = Utils.getUniqueID();\n        if (incrementDepth) {\n          visitInfo.visitDepth = (visitInfo?.visitDepth ?? 0) + 1;\n        } else {\n          visitInfo.visitCt = visitInfo.visitCt + 1;\n          visitInfo.visitDepth = 0;\n        }\n        visitInfo.visitTs = Date.now();\n        visitInfo.visitVer = 1;\n      }\n\n      DataStore.setVisitInfo(visitInfo);\n      await DataStore.storeData(Constants.KEY_MP_IDL_VISIT_ID_INFO, visitInfo);\n      DataStore.addCommonCookie('x-mp-vid', DataStore.visitInfoToString());\n    } catch (err) {\n      Logger.logError(err);\n      DataStore.setVisitInfo(null);\n      Reporter.reportError('setOrResetVisitInfo', err);\n    }\n  }\n\n  static async incrementVisitDepth(): Promise<void> {\n    return this.setOrResetVisitInfo(true);\n  }\n\n  static async setOrResetVisitorId(): Promise<void> {\n    try {\n      let visitorInfoData: VisitorInfo = await DataStore.getDataFromStorage(\n        Constants.KEY_MP_IDL_VISITOR_ID_INFO\n      );\n\n      if (\n        !visitorInfoData ||\n        (visitorInfoData && visitorInfoData?.mId.indexOf('-') === -1)\n      ) {\n        Logger.logDbg('VisitorInfo not found. Refreshing from server');\n        // get a new visit id and device id from server and store it in storage\n        visitorInfoData = await NetworkService.fetchIdlInfo(\n          DataStore.getIdlUrl()\n        );\n      }\n\n      if (!visitorInfoData) {\n        return;\n      } else {\n        DataStore.setVisitorInfo(visitorInfoData);\n        // store to db as well\n        await DataStore.storeData(\n          Constants.KEY_MP_IDL_VISITOR_ID_INFO,\n          visitorInfoData\n        );\n\n        const cookieValue = encodeURIComponent(JSON.stringify(visitorInfoData));\n        DataStore.addCommonCookie('x-mplidl', cookieValue);\n        DataStore.addCommonCookie('x-mpidl', cookieValue);\n        DataStore.addCommonCookie('x-lmid', visitorInfoData.mId);\n        DataStore.addCommonCookie('x-ldid', visitorInfoData.dId);\n      }\n    } catch (err) {\n      Logger.logError(err);\n      DataStore.setVisitorInfo(null);\n      Reporter.reportError('setOrResetVisitorId', err);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Logger","DataStore","Constants","Reporter","NetworkService","Utils","VisitIdProcessor","init","orgId","initDebugId","setOrResetVisitorId","setOrResetVisitInfo","retryVisitorIdIfNeeded","visitorIdFetchFailed","logDbg","hasVisitorId","getVisitorInfo","isFirstOpenAfterInstall","firstOpenFlag","getDataFromStorage","KEY_FIRST_OPEN","storeData","err","logError","getFacebookFBP","fbp","KEY_FBP","Date","now","addCommonCookie","debugId","KEY_MP_DEBUG_ID","indexOf","undefined","getSimpleDebugId","setDebugId","incrementDepth","visitInfo","KEY_MP_IDL_VISIT_ID_INFO","visitId","getUniqueID","visitCt","visitDepth","visitTs","visitVer","_visitInfo","setVisitInfo","visitInfoToString","reportError","incrementVisitDepth","getVisitInfo","catch","_visitorInfoData","visitorInfoData","KEY_MP_IDL_VISITOR_ID_INFO","mId","fetchIdlInfoWithRetry","getIdlUrl","setVisitorInfo","cookieValue","encodeURIComponent","JSON","stringify","dId","_defineProperty"],"sources":["visit-id.processor.ts"],"sourcesContent":["import { Logger } from '../common/logger';\nimport { DataStore } from '../common/data-store';\nimport { Constants } from '../common/constants';\nimport { Reporter } from '../common/reporter';\nimport { NetworkService } from '../common/network-service';\nimport type { VisitInfo, VisitorInfo } from '../common/app-types';\nimport { Utils } from '../common/utils';\n\nexport class VisitIdProcessor {\n  // Track if visitor ID fetch failed so we can retry on page_load\n  private static visitorIdFetchFailed = false;\n\n  static async init(orgId: string): Promise<void> {\n    await this.initDebugId(orgId);\n    await this.setOrResetVisitorId();\n    await this.setOrResetVisitInfo(false);\n  }\n\n  /**\n   * Check if visitor ID needs to be retried\n   * Called on each page_load to retry if initial fetch failed\n   */\n  static async retryVisitorIdIfNeeded(): Promise<void> {\n    if (!this.visitorIdFetchFailed) {\n      return; // No retry needed\n    }\n\n    Logger.logDbg('Retrying visitor ID fetch on page_load...');\n    await this.setOrResetVisitorId();\n  }\n\n  /**\n   * Check if visitor ID is available\n   */\n  static hasVisitorId(): boolean {\n    return !this.visitorIdFetchFailed && DataStore.getVisitorInfo() !== null;\n  }\n\n  static async isFirstOpenAfterInstall(): Promise<boolean> {\n    try {\n      const firstOpenFlag = await DataStore.getDataFromStorage<string>(\n        Constants.KEY_FIRST_OPEN\n      );\n\n      if (!firstOpenFlag) {\n        await DataStore.storeData(Constants.KEY_FIRST_OPEN, 'No');\n        return true;\n      }\n    } catch (err) {\n      Logger.logError('Unable to determine first open after install flag', err);\n    }\n    return false;\n  }\n\n  static async getFacebookFBP(): Promise<string> {\n    try {\n      let fbp = await DataStore.getDataFromStorage<string>(Constants.KEY_FBP);\n\n      if (!fbp) {\n        fbp = `fb.1.${Date.now()}.${Date.now()}`;\n      }\n\n      await DataStore.storeData(Constants.KEY_FBP, fbp);\n\n      DataStore.addCommonCookie('x-fbp', fbp);\n\n      return fbp;\n    } catch (err) {\n      Logger.logError('Error initializing debug id.', err);\n    }\n    return '';\n  }\n\n  static async initDebugId(orgId: string): Promise<void> {\n    try {\n      let debugId = await DataStore.getDataFromStorage<string>(\n        Constants.KEY_MP_DEBUG_ID\n      );\n\n      if (debugId && debugId.indexOf(orgId) !== 0) {\n        // re-generate debug id if it is not of the simple variety\n        debugId = undefined;\n      }\n\n      if (!debugId) {\n        debugId = Utils.getSimpleDebugId(orgId);\n      }\n\n      await DataStore.storeData(Constants.KEY_MP_DEBUG_ID, debugId);\n      DataStore.setDebugId(debugId);\n    } catch (err) {\n      Logger.logError('Error initializing debug id.', err);\n    }\n  }\n\n  static async setOrResetVisitInfo(incrementDepth: boolean): Promise<void> {\n    try {\n      let visitInfo: VisitInfo = await DataStore.getDataFromStorage(\n        Constants.KEY_MP_IDL_VISIT_ID_INFO\n      );\n\n      if (!visitInfo) {\n        // may be first time visit, set up a new visit info object and return\n        // Initialize visitDepth to 0, will be incremented to 1 on first page_load\n        visitInfo = {\n          visitId: Utils.getUniqueID(),\n          visitCt: 1,\n          visitDepth: 0,\n          visitTs: Date.now(),\n          visitVer: 1,\n        };\n      } else {\n        // reset visit id anyway, but retain the visitCt and depth setting\n        visitInfo.visitId = Utils.getUniqueID();\n        if (incrementDepth) {\n          visitInfo.visitDepth = (visitInfo?.visitDepth ?? 0) + 1;\n        } else {\n          visitInfo.visitCt = visitInfo.visitCt + 1;\n          visitInfo.visitDepth = 0; // Reset to 0, will be incremented to 1 on first page_load of new session\n        }\n        visitInfo.visitTs = Date.now();\n        visitInfo.visitVer = 1;\n      }\n\n      DataStore.setVisitInfo(visitInfo);\n      await DataStore.storeData(Constants.KEY_MP_IDL_VISIT_ID_INFO, visitInfo);\n      DataStore.addCommonCookie('x-mp-vid', DataStore.visitInfoToString());\n    } catch (err) {\n      Logger.logError(err);\n      DataStore.setVisitInfo(null);\n      Reporter.reportError('setOrResetVisitInfo', err);\n    }\n  }\n\n  /**\n   * Synchronously increment visit depth in memory, persist to storage in background\n   * This prevents race conditions when multiple page_load events fire quickly\n   */\n  static incrementVisitDepth(): void {\n    try {\n      // Read from in-memory cache (synchronous)\n      const visitInfo: VisitInfo = DataStore.getVisitInfo();\n\n      if (!visitInfo) {\n        Logger.logError('Visit info not initialized. Cannot increment depth.');\n        return;\n      }\n\n      // Increment depth synchronously in memory\n      visitInfo.visitDepth = (visitInfo.visitDepth ?? 0) + 1;\n      visitInfo.visitTs = Date.now();\n\n      // Update in-memory cache immediately (synchronous)\n      DataStore.setVisitInfo(visitInfo);\n      DataStore.addCommonCookie('x-mp-vid', DataStore.visitInfoToString());\n\n      Logger.logDbg('Visit depth incremented to:', visitInfo.visitDepth);\n\n      // Persist to AsyncStorage in background (fire and forget)\n      DataStore.storeData(Constants.KEY_MP_IDL_VISIT_ID_INFO, visitInfo).catch(\n        (err) => {\n          Logger.logError('Error persisting visit depth to storage:', err);\n          Reporter.reportError('incrementVisitDepth::persist', err);\n        }\n      );\n    } catch (err) {\n      Logger.logError('Error incrementing visit depth:', err);\n      Reporter.reportError('incrementVisitDepth', err);\n    }\n  }\n\n  static async setOrResetVisitorId(): Promise<void> {\n    try {\n      let visitorInfoData: VisitorInfo | null =\n        await DataStore.getDataFromStorage(\n          Constants.KEY_MP_IDL_VISITOR_ID_INFO\n        );\n\n      if (\n        !visitorInfoData ||\n        (visitorInfoData && visitorInfoData?.mId.indexOf('-') === -1)\n      ) {\n        Logger.logDbg('VisitorInfo not found. Fetching from server with retry');\n        // get a new visit id and device id from server and store it in storage\n        // Use retry method for better reliability\n        visitorInfoData = await NetworkService.fetchIdlInfoWithRetry(\n          DataStore.getIdlUrl()\n        );\n      }\n\n      if (!visitorInfoData) {\n        // Mark as failed so we can retry on page_load\n        this.visitorIdFetchFailed = true;\n        Logger.logError(\n          'Failed to fetch visitor ID after retries. Will retry on next page_load.'\n        );\n        return;\n      }\n\n      // Success - clear the failure flag\n      this.visitorIdFetchFailed = false;\n\n      DataStore.setVisitorInfo(visitorInfoData);\n      // store to db as well\n      await DataStore.storeData(\n        Constants.KEY_MP_IDL_VISITOR_ID_INFO,\n        visitorInfoData\n      );\n\n      const cookieValue = encodeURIComponent(JSON.stringify(visitorInfoData));\n      DataStore.addCommonCookie('x-mplidl', cookieValue);\n      DataStore.addCommonCookie('x-mpidl', cookieValue);\n      DataStore.addCommonCookie('x-lmid', visitorInfoData.mId);\n      DataStore.addCommonCookie('x-ldid', visitorInfoData.dId);\n\n      Logger.logDbg('Visitor ID set successfully:', visitorInfoData.mId);\n    } catch (err) {\n      Logger.logError('Error in setOrResetVisitorId:', err);\n      this.visitorIdFetchFailed = true;\n      DataStore.setVisitorInfo(null);\n      Reporter.reportError('setOrResetVisitorId', err);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/typescript/{common → src/common}/app-types.d.ts

@@ -2,13 +2,6 @@ import type { Logger } from './logger';
 export interface MapLike<T = any> {
     [key: string]: T;
 }
-export interface RunQueueModel {
-    sseOnly: boolean;
-    name: string;
-    dcrName: string;
-    eventId: string;
-    dcrPayload?: Record<string, any>;
-}
 export declare type TypedAny = Record<string, string | number | boolean | string[] | boolean[] | number[] | Record<string, string | number | boolean | string[] | boolean[] | number[]>>;
 export declare type EventProcessorFn = (payload: TypedAny) => void;
 export interface AppCustomerInfo {
@@ -23,6 +16,7 @@ export interface AppCustomerInfo {
 }
 export interface AppPageLoad {
     page_name: string;
+    page_url?: string;
     is_entry?: number;
     deep_link_url?: string;
     app_version?: string;
@@ -72,6 +66,7 @@ export interface Report {
     tagCt: number;
     dws: 'j' | 'n';
     v: string;
+    devPayload?: string;
 }
 export interface UrlInfo {
     tfUrl: string;
@@ -103,16 +98,42 @@ export interface SdkInitOptions {
     projectId: string;
     baseUrl: string;
     logLevel: string;
+    /**
+     * @deprecated device_type is now auto-detected and cannot be overridden
+     * This field is ignored. The SDK uses Expo/react-native-device-info for reliable detection.
+     */
     device_type?: string;
+    /**
+     * @deprecated app_version is now auto-detected and cannot be overridden
+     * This field is ignored. The SDK will always use the actual app version from the device.
+     */
     app_version?: string;
+    /**
+     * @deprecated os_version is now auto-detected and cannot be overridden
+     * This field is ignored. The SDK will always use the actual OS version from the device.
+     */
     os_version?: string;
+    /**
+     * Event deduplication window in milliseconds
+     * If the same event (name + payload) fires within this window, it will be skipped
+     * Purchase events are deduplicated by transaction_id regardless of other fields
+     * Default: 5000ms (5 seconds)
+     * Set to 0 to disable deduplication
+     */
+    eventDeduplicationWindowMs?: number;
+    /**
+     * Callback invoked when SDK initialization fails after all retries
+     * Use this to handle initialization failures gracefully in your app
+     * @param error The error that caused the failure
+     */
+    onInitFailure?: (error: Error) => void;
 }
 export interface MpDeviceInfo {
     package_name?: string;
     short_version?: string;
     long_version?: string;
-    os_version: string;
-    device_model_name: string;
+    os_version?: string;
+    device_model_name?: string;
     locale?: string;
     timezone_abbreviation?: string;
     carrier?: string;

package/lib/typescript/{common → src/common}/constants.d.ts

@@ -1,7 +1,6 @@
 import type { BaseResourceParamType } from '../models/mp-client-sdk';
 export declare class Constants {
     static PLACEHOLDER_REGEX: RegExp;
-    static LARGE_RANDOM_POOL: (size?: number) => string;
     static MP_DL_EVT: string;
     static CUST_EVT: string;
     static ST_OK: number;

package/lib/typescript/{common → src/common}/data-store.d.ts

@@ -1,4 +1,4 @@
-import type { DeJsvHelper, MapLike, MpDeviceInfo, QcInfoItem, RunQueueModel, SdkInitOptions, UrlInfo, VisitInfo, VisitorInfo } from './app-types';
+import type { DeJsvHelper, MapLike, MpDeviceInfo, QcInfoItem, SdkInitOptions, UrlInfo, VisitInfo, VisitorInfo } from './app-types';
 import type { GeoResponse } from '../models/geo-api-response';
 import type { ClientSdkDeItem, ClientSdkPrItem, ClientSdkQcItem, ClientSdkTagItem, MpClientSdk } from '../models/mp-client-sdk';
 export declare class DataStore {
@@ -17,8 +17,6 @@ export declare class DataStore {
     private static mpEnvShort;
     private static devicePlatform;
     private static deviceType;
-    private static runQueue;
-    private static isProcessing;
     private static sdkInitOptions;
     private static deviceInfo;
     private static geoInfo;
@@ -28,7 +26,6 @@ export declare class DataStore {
     private static commonCookies;
     static init(clientSdk: MpClientSdk): Promise<void>;
     static resetCollectorUrl(baseCollectorUrl: string, sdkEnv: string, vendorId: string, projectId: string): boolean;
-    static enQueueTMFire(sseOnly: boolean, name: string, dcrName: string, eventId: string, dcrPayload?: Record<string, any>): void;
     static isDataStoreReady(): boolean;
     static shouldExecuteTMForEvent(eventName: string): boolean;
     static shouldExecuteSST(eventName: string): boolean;
@@ -38,9 +35,6 @@ export declare class DataStore {
     static setDeviceInfo(info: MpDeviceInfo): void;
     static getDeviceInfo(): MpDeviceInfo;
     static setSdkInitOptions(options: SdkInitOptions): void;
-    static deQueueTMFire(): RunQueueModel;
-    static isTagManagerProcessing(): boolean;
-    static setTagManagerProcessing(status: boolean): void;
     static getSdkDataElements(): MapLike<ClientSdkDeItem>;
     static getSdkQC(): ClientSdkQcItem[];
     static hasOneSSTTag(): boolean;
@@ -51,7 +45,8 @@ export declare class DataStore {
     static getAttrInfoUrl(): string;
     static setVisitInfo(visitInfo: VisitInfo): void;
     static visitInfoToString(): string;
-    static setVisitorInfo(visitorInfo: VisitorInfo): void;
+    static setVisitorInfo(visitorInfo: VisitorInfo | null): void;
+    static getVisitorInfo(): VisitorInfo | null;
     static getDebugId(): string;
     static getErrorReportUrl(): string;
     static getIdlUrl(): string;

package/lib/typescript/src/common/deeplink-helper.d.ts

@@ -0,0 +1,60 @@
+export declare enum DeepLinkType {
+    CUSTOM_SCHEME = "custom_scheme",
+    UNIVERSAL_LINK = "universal_link",
+    APP_LINK = "app_link",
+    HTTP_LINK = "http_link"
+}
+/**
+ * Helper class to automatically detect and handle deeplinks
+ *
+ * Supports multiple link types:
+ * 1. Custom URL Schemes: myapp://product/123
+ * 2. Universal Links (iOS): https://my-site.com/product/123
+ * 3. App Links (Android): https://my-site.com/product/123
+ * 4. HTTP Links: http://my-site.com/product/123
+ *
+ * Common use cases:
+ * - Ad clicks (Facebook, Google, TikTok ads with http/https URLs)
+ * - Push notification deep links
+ * - Email marketing links
+ * - SMS campaign links
+ * - QR codes
+ */
+export declare class DeepLinkHelper {
+    private static listener;
+    private static onDeepLinkCallback;
+    /**
+     * Determine the type of deeplink
+     * @param url The URL to analyze
+     * @returns The type of deeplink
+     */
+    static getLinkType(url: string): DeepLinkType;
+    /**
+     * Initialize deeplink detection
+     * - Checks if app was opened with initial URL (custom scheme, universal link, or HTTP link)
+     * - Sets up listener for deeplinks while app is running
+     * @param callback Optional callback to be notified when deeplink is detected
+     * @returns The initial URL if app was opened with deeplink, null otherwise
+     */
+    static initialize(callback?: (url: string, linkType: DeepLinkType) => void): Promise<string | null>;
+    /**
+     * Set up listener for deeplinks received while app is running
+     * Works for all link types: custom schemes, universal links, app links, HTTP links
+     */
+    private static setupListener;
+    /**
+     * Handle deeplink URL - notify callback if registered
+     * @param url The deeplink URL
+     */
+    private static handleDeepLink;
+    /**
+     * Remove deeplink listener and clear callback
+     */
+    static cleanup(): void;
+    /**
+     * Parse UTM parameters and other campaign data from URL
+     * @param url The deeplink URL
+     * @returns Object containing campaign parameters
+     */
+    static parseCampaignParams(url: string): Record<string, string>;
+}

package/lib/typescript/src/common/device-info-helper.d.ts

@@ -0,0 +1,54 @@
+interface DeviceAppInfo {
+    app_version: string;
+    build_number: string;
+    package_name: string;
+    device_model_name: string;
+    device_manufacturer: string;
+    device_id: string;
+    os_name: string;
+    os_version: string;
+    is_tablet: boolean;
+    is_emulator: boolean;
+}
+/**
+ * Helper class to automatically detect device and app information
+ * Supports both Expo and bare React Native:
+ * 1. Tries Expo modules first (works in Expo Go)
+ * 2. Falls back to react-native-device-info (for bare RN)
+ * 3. Returns safe defaults if neither is available
+ */
+export declare class DeviceInfoHelper {
+    private static expoApplication;
+    private static expoDevice;
+    private static expoConstants;
+    private static deviceInfo;
+    private static initialized;
+    /**
+     * Try to load Expo modules and react-native-device-info
+     * This uses dynamic imports to avoid errors when modules aren't available
+     */
+    private static initialize;
+    /**
+     * Get comprehensive app and device information
+     * All methods are async-safe and handle errors gracefully
+     */
+    static getAppInfo(): Promise<DeviceAppInfo>;
+    /**
+     * Get device info using Expo modules (works in Expo Go)
+     */
+    private static getAppInfoFromExpo;
+    /**
+     * Get device info using react-native-device-info (for bare RN)
+     */
+    private static getAppInfoFromDeviceInfo;
+    /**
+     * Safe default values when no device info library is available
+     */
+    private static getSafeDefaults;
+    /**
+     * Get app version in format: "1.0.0 (123)"
+     * Combines version and build number for better tracking
+     */
+    static getFormattedAppVersion(): Promise<string>;
+}
+export {};

package/lib/typescript/src/common/event-bus.d.ts

@@ -0,0 +1,21 @@
+import type { EventBusCallback } from './app-types';
+export declare class EventBus {
+    private static eventRegister;
+    static on(eventName: string, callback: EventBusCallback): void;
+    /**
+     * Remove a specific callback for an event
+     * @param eventName Event name to remove callback from
+     * @param callback The callback function to remove
+     */
+    static off(eventName: string, callback: EventBusCallback): void;
+    /**
+     * Remove all callbacks for a specific event
+     * @param eventName Event name to clear all listeners for
+     */
+    static clearEvent(eventName: string): void;
+    /**
+     * Remove all event listeners (used during SDK shutdown)
+     */
+    static clearAll(): void;
+    static triggerEvent(eventName: string, payload: any): void;
+}

package/lib/typescript/src/common/network-service.d.ts

@@ -0,0 +1,32 @@
+import type { MapLike, SdkInitOptions, VisitorInfo } from './app-types';
+export declare class NetworkService {
+    /**
+     * Sleep for a specified duration
+     */
+    private static sleep;
+    /**
+     * Fetch with timeout wrapper
+     */
+    private static fetchWithTimeout;
+    /**
+     * Fetch visitor/identity info from server
+     * Returns null if fetch fails (caller should handle retry logic)
+     */
+    static fetchIdlInfo(url: string): Promise<VisitorInfo | null>;
+    /**
+     * Fetch visitor/identity info with retry logic
+     * @param url The IDL URL
+     * @param retries Number of retries (default: 3)
+     * @returns VisitorInfo or null if all retries fail
+     */
+    static fetchIdlInfoWithRetry(url: string, retries?: number): Promise<VisitorInfo | null>;
+    /**
+     * Refresh client SDK JSON configuration with retry logic
+     * @param sdkInitOptions SDK initialization options
+     * @returns true if successful, throws Error if all retries fail
+     */
+    static refreshClientSdkJson(sdkInitOptions: SdkInitOptions): Promise<void>;
+    static sendPostRequest(url: string, body: MapLike): void;
+    static sendGetRequest(url: string): void;
+    private static sendNetworkRequest;
+}

package/lib/typescript/{common → src/common}/reporter.d.ts

@@ -4,9 +4,10 @@ export declare class Reporter {
     static initReporter(envName: string, envId: string, deviceType: string, language: string, deviceOs: string, // device os is being used as a browser proxy
     pageName: string, evtName: string, evtId: string, clientTagsDownStream: 'j' | 'n', clientSdkVersion: string, initialItems?: ReportTagItem[]): void;
     static setExpectedTagCount(ct: number, evtId: string): void;
+    static reportDevPayload(devPayload: Record<string, any>, evtId: string): void;
     static reportItem(item: ReportTagItem, evtId: string): void;
     static publishReport(evtId: string): void;
     static reportError(methodMetaData: string, err: any): void;
-    static postSST(data: MapLike, envName: string, envId: string, serverTagDownStream: 'j' | 'n', eventName: string, evtId: string): Promise<void>;
+    static postSST(data: MapLike, envName: string, envId: string, serverTagDownStream: 'j' | 'n', eventName: string, evtId: string, eventData?: Record<string, any>): Promise<void>;
     static postAttrInfo(payload: MapLike): void;
 }

package/lib/typescript/src/common/storage-helper.d.ts

@@ -0,0 +1,47 @@
+import { DeStorageDuration } from '../models/mp-client-sdk';
+export declare class StorageHelper {
+    private static sessionStore;
+    private static visitorStoreCache;
+    private static isInitialized;
+    /**
+     * Initialize the storage helper
+     * Loads visitor store from AsyncStorage and cleans expired values
+     * Should be called once during SDK initialization
+     */
+    static initialize(): Promise<void>;
+    /**
+     * Clear visitor-scoped values older than 30 days
+     */
+    static clearExpiredVisitorData(): Promise<void>;
+    /**
+     * Persist the visitor store cache to AsyncStorage
+     */
+    private static persistVisitorStore;
+    /**
+     * Check if a value is defined (not null, undefined, or empty string)
+     */
+    private static isDefined;
+    /**
+     * Store a data element value based on storage duration
+     * @param deKey - The data element key
+     * @param value - The value to store
+     * @param storageDuration - The storage duration type
+     */
+    static deStorageDurationSet(deKey: string, value: any, storageDuration: DeStorageDuration): void;
+    /**
+     * Retrieve a data element value based on storage duration
+     * @param deKey - The data element key
+     * @param defaultValue - Default value if not found
+     * @param storageDuration - The storage duration type
+     * @returns The stored value or default value
+     */
+    static deStorageDurationGet(deKey: string, defaultValue: any, storageDuration: DeStorageDuration): any;
+    /**
+     * Clear all session-scoped values (called on new session if needed)
+     */
+    static clearSessionStore(): void;
+    /**
+     * Clear all visitor-scoped values
+     */
+    static clearVisitorStore(): Promise<void>;
+}

package/lib/typescript/{common → src/common}/utils.d.ts

@@ -33,6 +33,31 @@ export declare class Utils {
     static regExpEscape(input: string): string;
     static convertToRegex(input: string, ignoreCase: boolean, fullMatch: boolean): RegExp;
     static safeExecute(fn: (payload: any) => any, payload: any): any;
+    /**
+     * Encode string to Base64 - React Native compatible
+     * Works with both ASCII and UTF-8 strings
+     * @param str String to encode
+     * @returns Base64 encoded string
+     */
+    static toBase64(str: string): string;
+    /**
+     * Encode an object payload to Base64 string
+     * @param payload Object to encode
+     * @returns Base64 encoded string, or empty string on error
+     */
+    static encodeToBase64(payload: Record<string, any>): string;
+    /**
+     * Get the size of a payload in bytes
+     * @param payload Object to measure
+     * @returns Size in bytes
+     */
+    static getPayloadSizeBytes(payload: Record<string, any>): number;
+    /**
+     * Check if payload exceeds the maximum allowed size (250KB)
+     * @param payload Object to check
+     * @returns True if payload is oversized
+     */
+    static isPayloadOversized(payload: Record<string, any>): boolean;
     static getUniqueID(): string;
     /**
      * Make HTTP GET request - React Native implementation

package/lib/typescript/{eedl → src/eedl}/eedl.d.ts

@@ -11,9 +11,43 @@ export declare class MpDataLayerHelper {
     dlInitEvent: string;
     receivedInitialEvent: boolean;
     eventQueue: Array<any>;
+    private isProcessing;
     private isEntryPoint;
+    private eventDedupWindowMs;
+    private eventDeduplicationCache;
+    private purchaseTransactionCache;
     constructor(dlEventName: string, dlInitMode: string, dlInitEvent: string, storageKeyName?: string);
     init(globalEventListeners: Record<string, EventProcessorFn>): Promise<void>;
+    /**
+     * Set the event deduplication window
+     * @param windowMs Window in milliseconds (0 to disable)
+     */
+    setDeduplicationWindow(windowMs: number): void;
+    /**
+     * Generate a unique fingerprint for an event
+     * @param eventName Event name
+     * @param payload Event payload
+     * @returns Fingerprint string
+     */
+    private getEventFingerprint;
+    /**
+     * Extract transaction_id from purchase event payload
+     * @param payload Event payload
+     * @returns transaction_id or null
+     */
+    private extractTransactionId;
+    /**
+     * Check if event is a duplicate within the deduplication window
+     * @param eventName Event name
+     * @param payload Event payload
+     * @returns true if duplicate, false otherwise
+     */
+    private isDuplicateEvent;
+    /**
+     * Remove expired entries from deduplication caches
+     * @param now Current timestamp
+     */
+    private cleanupDeduplicationCache;
     pushEvent(eventName: string, payload: MapLike): void;
     processQItems(eventName: string, payload: MapLike): Promise<void>;
     /**
@@ -50,8 +84,16 @@ export declare class MpDataLayerHelper {
     getState(): TypedAny[];
     hasEventHappened(key: string): boolean;
     reset(): boolean;
+    /**
+     * Full shutdown - clears all state and allows reinitialization
+     */
+    shutdown(): void;
     ready(): void;
-    drainQueue(): Promise<void>;
+    /**
+     * Process next event in queue with atomic check-and-set
+     * Ensures only one event processes at a time, eliminating race conditions
+     */
+    processNext(): void;
     getIsEntryPointValue(): number;
     resetEntryPointInfo(): void;
 }

package/lib/typescript/{index.d.ts → src/index.d.ts}

@@ -1,26 +1,60 @@
-import type { AppCustomerInfo, AppPageLoad, MapLike, MpDeviceInfo, SdkInitOptions } from './common/app-types';
+import 'react-native-get-random-values';
+import type { AppCustomerInfo, AppPageLoad, MapLike, SdkInitOptions } from './common/app-types';
 import { EventBus } from './common/event-bus';
 declare class MagicPixelImpl {
     private static dl;
     private static customerInfo;
     private static customerIdentifiers;
     private static deepLinkUrl;
+    private static orgId;
     private static firstAppLaunch;
-    static init(options: SdkInitOptions): Promise<void>;
+    private static isReady;
+    private static isInitializing;
+    private static eventBuffer;
+    private static onInitFailureCallback;
+    /**
+     * Initialize the MagicPixel SDK
+     * This method is synchronous - it stores config immediately and runs async setup in background
+     * Events called before async setup completes are buffered and processed once ready
+     * @param options SDK initialization options
+     */
+    static init(options: SdkInitOptions): void;
+    /**
+     * Shutdown the SDK and release all resources
+     * Call this when the app is closing or when you need to reinitialize the SDK
+     * After shutdown, you must call init() again to use the SDK
+     */
+    static shutdown(): void;
+    /**
+     * Async initialization - runs in background
+     */
+    private static initAsync;
     static recordEvent(eventName: string, payload: MapLike): void;
+    private static processRecordEvent;
     static ready(): void;
+    /**
+     * Flush buffered events after SDK is ready
+     * Events are processed in the order they were received
+     */
+    private static flushEventBuffer;
     static getDebugId(): string;
-    private static checkAndFireTM;
     private static runTM;
     private static _fireTM;
     private static _fireTMPrivate;
     static setCustomerInfo(customerInfo: AppCustomerInfo): void;
     static setFirebaseAppInstanceId(instanceId: string): void;
     static setDeepLinkUrl(deepLinkUrl: string): void;
-    static setDeviceInfo(deviceInfo: MpDeviceInfo): void;
+    /**
+     * Set device info with auto-detected values
+     * Standard fields (os_version, device_model_name, package_name) are always auto-detected
+     * Optional customFields parameter allows adding custom tracking fields only
+     * @param customFields Optional custom fields to add (cannot override standard fields)
+     */
+    static setDeviceInfo(customFields?: Record<string, any>): Promise<void>;
     static setFacebookClientId(fbp: string): void;
     private static setAppVersion;
     static recordPageLoad(pageLoadInfo: AppPageLoad): void;
+    private static processRecordPageLoad;
     /**
      * Set user information for tracking
      * @param userInfo User information object
@@ -77,4 +111,4 @@ declare class MagicPixelImpl {
 }
 export declare const MagicPixelEventBus: typeof EventBus;
 export declare const MagicPixel: typeof MagicPixelImpl;
-export {};
+export { DeepLinkHelper, DeepLinkType } from './common/deeplink-helper';

package/lib/typescript/{models → src/models}/mp-client-sdk.d.ts

@@ -9,6 +9,13 @@ export interface ClientSdkDeItem {
     fn?: (deHelper: any, input: any) => any;
     isAsync?: boolean;
     fnTOut?: number;
+    stDur?: DeStorageDuration;
+}
+export declare enum DeStorageDuration {
+    NONE = "NONE",
+    EVENT = "EVENT",
+    SESSION = "SESSION",
+    VISITOR = "VISITOR"
 }
 export declare enum ParamResourceEncodingType {
     URL_ENC = "URL_ENC",

package/lib/typescript/src/processors/visit-id.processor.d.ts

@@ -0,0 +1,23 @@
+export declare class VisitIdProcessor {
+    private static visitorIdFetchFailed;
+    static init(orgId: string): Promise<void>;
+    /**
+     * Check if visitor ID needs to be retried
+     * Called on each page_load to retry if initial fetch failed
+     */
+    static retryVisitorIdIfNeeded(): Promise<void>;
+    /**
+     * Check if visitor ID is available
+     */
+    static hasVisitorId(): boolean;
+    static isFirstOpenAfterInstall(): Promise<boolean>;
+    static getFacebookFBP(): Promise<string>;
+    static initDebugId(orgId: string): Promise<void>;
+    static setOrResetVisitInfo(incrementDepth: boolean): Promise<void>;
+    /**
+     * Synchronously increment visit depth in memory, persist to storage in background
+     * This prevents race conditions when multiple page_load events fire quickly
+     */
+    static incrementVisitDepth(): void;
+    static setOrResetVisitorId(): Promise<void>;
+}