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

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/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,13 @@ 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;
     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>;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@magicpixel/rn-mp-client-sdk",
-  "version": "1.13.0",
-  "description": "test",
+  "version": "1.13.20",
+  "description": "React Native SDK for MagicPixel analytics and tag management",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
   "types": "lib/typescript/index.d.ts",
@@ -10,40 +10,36 @@
   "files": [
     "src",
     "lib",
-    "android",
-    "ios",
-    "cpp",
-    "rn-mp-client-sdk.podspec",
     "!lib/typescript/example",
-    "!android/build",
-    "!ios/build",
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__"
   ],
   "scripts": {
-    "test": "jest",
+    "test": "echo 'No tests configured'",
     "typescript": "tsc --noEmit",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "prepare": "bob build",
     "release": "release-it",
     "example": "yarn --cwd example",
     "bootstrap": "yarn example && yarn && yarn example pods",
-    "postpublish": "node quick-version-increment.js",
-    "localpublish": "npm publish --@magicpixel:registry=http://localhost:4873 && npm run postpublish"
+    "localpublish": "npm publish --@magicpixel:registry=http://localhost:4873"
   },
   "keywords": [
     "react-native",
     "ios",
     "android"
   ],
-  "repository": "https://github.com/mp",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:digital-madtech/mp-rn-client-sdk.git"
+  },
   "author": "MP Engineering <engineering@magicpixel.io> (https://magicpixel.io)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/mp/issues"
+    "url": "https://github.com/digital-madtech/mp-rn-client-sdk/issues"
   },
-  "homepage": "https://github.com/mp#readme",
+  "homepage": "https://github.com/digital-madtech/mp-rn-client-sdk#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -53,38 +49,34 @@
     "@babel/eslint-parser": "7.19.1",
     "@babel/runtime": "7.26.10",
     "@commitlint/config-conventional": "17.1.0",
+    "@octokit/plugin-paginate-rest": "9.2.2",
+    "@octokit/request": "8.4.1",
+    "@octokit/request-error": "5.1.1",
     "@react-native-community/eslint-config": "3.1.0",
     "@release-it/conventional-changelog": "8.0.1",
     "@types/flat": "5.0.2",
-    "@types/jest": "29.0.3",
-    "@types/react": "~17.0.21",
+    "@types/react": "17.0.50",
     "@types/react-native": "0.72.8",
     "@types/uuid": "9.0.0",
+    "braces": "3.0.3",
     "commitlint": "17.1.2",
+    "cross-spawn": "7.0.5",
     "eslint": "8.23.1",
     "eslint-config-prettier": "8.5.0",
     "eslint-plugin-prettier": "4.2.1",
-    "jest": "29.1.1",
+    "micromatch": "4.0.8",
     "pod-install": "0.1.38",
     "prettier": "2.7.1",
     "react": "18.2.0",
     "react-native": "0.72.17",
     "react-native-builder-bob": "0.18.3",
     "release-it": "17.1.1",
-    "ts-jest": "29.0.2",
     "tsconfig-paths": "4.1.0",
     "typescript": "4.8.3",
-    "ts-node": "10.9.1",
-    "@octokit/plugin-paginate-rest": "9.2.2",
-    "@octokit/request": "8.4.1",
-    "@octokit/request-error": "5.1.1",
-    "braces": "3.0.3",
-    "cross-spawn": "7.0.5",
-    "micromatch": "4.0.8",
     "ws": "7.5.10"
   },
   "resolutions": {
-    "@types/react": "17.0.21",
+    "@types/react": "17.0.50",
     "ip": "2.0.2",
     "pac-resolver": "7.0.1",
     "socks": "2.7.3",
@@ -93,20 +85,14 @@
     "socks-proxy-agent": "8.0.2",
     "agent-base": "7.1.0"
   },
+  "overrides": {
+    "diff": "8.0.3",
+    "tmp": "0.2.4"
+  },
   "peerDependencies": {
     "react": "*",
     "react-native": "*"
   },
-  "jest": {
-    "preset": "react-native",
-    "transform": {
-      ".+\\.(t|j)s$": "ts-jest"
-    },
-    "modulePathIgnorePatterns": [
-      "<rootDir>/example/node_modules",
-      "<rootDir>/lib/"
-    ]
-  },
   "commitlint": {
     "extends": [
       "@commitlint/config-conventional"
@@ -174,7 +160,10 @@
     "flat": "5.0.2",
     "nanoid": "5.1.5",
     "performant-array-to-tree": "1.11.0",
+    "react-native-device-info": "15.0.1",
+    "react-native-get-random-values": "1.11.0",
     "react-native-url-polyfill": "1.3.0",
+    "ulid": "3.0.1",
     "uuid": "9.0.0"
   }
-}
+}

package/src/common/app-types.ts

@@ -4,14 +4,6 @@ export interface MapLike<T = any> {
   [key: string]: T;
 }
 
-export interface RunQueueModel {
-  sseOnly: boolean;
-  name: string;
-  dcrName: string;
-  eventId: string;
-  dcrPayload?: Record<string, any>;
-}
-
 export type TypedAny = Record<
   string,
   | string
@@ -38,6 +30,7 @@ export interface AppCustomerInfo {
 
 export interface AppPageLoad {
   page_name: string;
+  page_url?: string;
   is_entry?: number;
   deep_link_url?: string;
   app_version?: string;
@@ -130,18 +123,47 @@ export interface SdkInitOptions {
   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; // app package name like com.company.starter
   short_version?: string;
   long_version?: string;
-  os_version: string;
-  device_model_name: string;
+  os_version?: string; // Will be auto-detected if not provided
+  device_model_name?: string; // Will be auto-detected if not provided
   locale?: string;
   timezone_abbreviation?: string;
   carrier?: string;

package/src/common/constants.ts

@@ -1,14 +1,8 @@
-import { customAlphabet } from 'nanoid/non-secure';
 import type { BaseResourceParamType } from '../models/mp-client-sdk';
 
 export class Constants {
   static PLACEHOLDER_REGEX = new RegExp(/({{)([A-Z_0-9 -]+)(}})/gi);
 
-  static LARGE_RANDOM_POOL = customAlphabet(
-    '1234567090abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ',
-    21
-  );
-
   static MP_DL_EVT = 'mp_dl_event';
   static CUST_EVT = 'custom_event';