@magicpixel/rn-mp-client-sdk 0.2.0

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

@@ -0,0 +1,144 @@
+import { Logger } from '../common/logger';
+import { DataStore } from '../common/data-store';
+import { Constants } from '../common/constants';
+import { Reporter } from '../common/reporter';
+import { NetworkService } from '../common/network-service';
+import { Utils } from '../common/utils';
+import { EventBus } from '../common/event-bus';
+export class VisitIdProcessor {
+  static async init() {
+    await this.initIdlEventListener();
+    await this.initDebugId();
+    await this.setOrResetVisitorId();
+    await this.setOrResetVisitInfo();
+  }
+
+  static async initIdlEventListener() {
+    EventBus.on('mp_idl_app_event', (channelName, eventPayload) => {
+      try {
+        if (!channelName || !eventPayload) {
+          Logger.logError('Both event name and event payload is mandatory for processing idl events');
+          return;
+        }
+
+        const eventName = eventPayload.client_ev_name;
+        const attrInfoPayload = eventPayload.client_ev_payload ?? {};
+        const deepPayload = (attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.payload) ?? {}; // is_entry, app_type,
+
+        try {
+          deepPayload['org_id'] = eventPayload === null || eventPayload === void 0 ? void 0 : eventPayload.org_id;
+          deepPayload['event_id'] = eventPayload === null || eventPayload === void 0 ? void 0 : eventPayload.event_id;
+          deepPayload['event_ts'] = eventPayload === null || eventPayload === void 0 ? void 0 : eventPayload.event_ts;
+        } catch (e) {
+          Logger.logError('Error enhancing internal attr payload');
+        }
+
+        const attrPayload = {
+          pu: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.page_url,
+          ru: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.campaign_ref,
+          pt: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.page_title,
+          en: attrInfoPayload.event_name,
+          cid: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.campaign_id,
+          rs: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.report_suite,
+          v: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.client_sdk_version,
+          vidl: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.idl_version,
+          ev: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.event_val,
+          ep: deepPayload,
+          at: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.app_type,
+          evId: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.event_id,
+          evTs: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.event_ts,
+          orgId: attrInfoPayload === null || attrInfoPayload === void 0 ? void 0 : attrInfoPayload.org_id,
+          _mp_vid: DataStore.visitInfoToString(),
+          _lmid: DataStore.getMpId(),
+          _ldid: DataStore.getDeviceId(),
+          _mpidl: JSON.stringify(DataStore.getVisitorInfoAsString()),
+          is_entry: attrInfoPayload.is_entry ?? 0,
+          app_type: attrInfoPayload.app_type
+        };
+
+        if (eventName === 'al') {
+          attrPayload.pid = eventPayload === null || eventPayload === void 0 ? void 0 : eventPayload.profile_id;
+        }
+
+        Reporter.postAttrInfo(attrPayload);
+      } catch (err) {
+        Logger.logError('Error processing idl event: ', err);
+      }
+    });
+  }
+
+  static async initDebugId() {
+    try {
+      let debugId = await DataStore.getDataFromStorage(Constants.KEY_MP_DEBUG_ID);
+
+      if (!debugId) {
+        debugId = Utils.getUniqueID();
+      }
+
+      await DataStore.storeData(Constants.KEY_MP_DEBUG_ID, debugId);
+      DataStore.setDebugId(debugId);
+    } catch (err) {
+      Logger.logError('Error initializing debug id.', err);
+    }
+  }
+
+  static async setOrResetVisitInfo() {
+    try {
+      const visitInfo = await DataStore.getDataFromStorage(Constants.KEY_MP_IDL_VISIT_ID_INFO);
+
+      if (!visitInfo) {
+        // may be first time visit, setup a new visit info object and return
+        const newVisitInfo = {
+          visitId: Utils.getUniqueID(),
+          visitCt: 1,
+          visitDepth: 1,
+          visitTs: Date.now(),
+          visitVer: 1
+        };
+        DataStore.setVisitInfo(newVisitInfo);
+        await DataStore.storeData(Constants.KEY_MP_IDL_VISIT_ID_INFO, newVisitInfo);
+      } else {
+        // reset visit id anyway, but retain the visitCt and depth setting
+        visitInfo.visitId = Utils.getUniqueID();
+        visitInfo.visitCt = visitInfo.visitCt + 1;
+        visitInfo.visitDepth = 1;
+        visitInfo.visitTs = Date.now();
+        visitInfo.visitVer = 1;
+        DataStore.setVisitInfo(visitInfo);
+        await DataStore.storeData(Constants.KEY_MP_IDL_VISIT_ID_INFO, visitInfo);
+      }
+    } catch (err) {
+      Logger.logError(err);
+      DataStore.setVisitInfo(null);
+      Reporter.reportError('setOrResetVisitInfo', err);
+    }
+  }
+
+  static async setOrResetVisitorId() {
+    try {
+      const visitorInfoData = await DataStore.getDataFromStorage(Constants.KEY_MP_IDL_VISITOR_ID_INFO);
+
+      if (!visitorInfoData) {
+        Logger.logDbg('VisitorInfo not found. Refreshing from server'); // get a new visit id and device id from server and store it in storage
+
+        const apiVisitInfo = await NetworkService.fetchIdlInfo(DataStore.getIdlUrl());
+
+        if (!apiVisitInfo) {
+          return;
+        } else {
+          DataStore.setVisitorInfo(apiVisitInfo); // store to db as well
+
+          await DataStore.storeData(Constants.KEY_MP_IDL_VISITOR_ID_INFO, apiVisitInfo);
+        }
+      } else {
+        DataStore.setVisitorInfo(visitorInfoData);
+      }
+    } catch (err) {
+      Logger.logError(err);
+      DataStore.setVisitorInfo(null);
+      Reporter.reportError('setOrResetVisitorId', err);
+    }
+  }
+
+}
+//# sourceMappingURL=visit-id.processor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Logger","DataStore","Constants","Reporter","NetworkService","Utils","EventBus","VisitIdProcessor","init","initIdlEventListener","initDebugId","setOrResetVisitorId","setOrResetVisitInfo","on","channelName","eventPayload","logError","eventName","client_ev_name","attrInfoPayload","client_ev_payload","deepPayload","payload","org_id","event_id","event_ts","e","attrPayload","pu","page_url","ru","campaign_ref","pt","page_title","en","event_name","cid","campaign_id","rs","report_suite","v","client_sdk_version","vidl","idl_version","ev","event_val","ep","at","app_type","evId","evTs","orgId","_mp_vid","visitInfoToString","_lmid","getMpId","_ldid","getDeviceId","_mpidl","JSON","stringify","getVisitorInfoAsString","is_entry","pid","profile_id","postAttrInfo","err","debugId","getDataFromStorage","KEY_MP_DEBUG_ID","getUniqueID","storeData","setDebugId","visitInfo","KEY_MP_IDL_VISIT_ID_INFO","newVisitInfo","visitId","visitCt","visitDepth","visitTs","Date","now","visitVer","setVisitInfo","reportError","visitorInfoData","KEY_MP_IDL_VISITOR_ID_INFO","logDbg","apiVisitInfo","fetchIdlInfo","getIdlUrl","setVisitorInfo"],"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';\nimport { EventBus } from '../common/event-bus';\n\nexport class VisitIdProcessor {\n  static async init(): Promise<void> {\n    await this.initIdlEventListener();\n    await this.initDebugId();\n    await this.setOrResetVisitorId();\n    await this.setOrResetVisitInfo();\n  }\n\n  static async initIdlEventListener(): Promise<void> {\n    EventBus.on(\n      'mp_idl_app_event',\n      (channelName: string, eventPayload: Record<string, string>) => {\n        try {\n          if (!channelName || !eventPayload) {\n            Logger.logError(\n              'Both event name and event payload is mandatory for processing idl events'\n            );\n            return;\n          }\n\n          const eventName = eventPayload.client_ev_name;\n          const attrInfoPayload: any = eventPayload.client_ev_payload ?? {};\n          const deepPayload: any = attrInfoPayload?.payload ?? {};\n\n          // is_entry, app_type,\n          try {\n            deepPayload['org_id'] = eventPayload?.org_id;\n            deepPayload['event_id'] = eventPayload?.event_id;\n            deepPayload['event_ts'] = eventPayload?.event_ts;\n          } catch (e) {\n            Logger.logError('Error enhancing internal attr payload');\n          }\n\n          const attrPayload: any = {\n            pu: attrInfoPayload?.page_url,\n            ru: attrInfoPayload?.campaign_ref,\n            pt: attrInfoPayload?.page_title,\n            en: attrInfoPayload.event_name,\n            cid: attrInfoPayload?.campaign_id,\n            rs: attrInfoPayload?.report_suite,\n            v: attrInfoPayload?.client_sdk_version,\n            vidl: attrInfoPayload?.idl_version,\n            ev: attrInfoPayload?.event_val,\n            ep: deepPayload,\n            at: attrInfoPayload?.app_type,\n            evId: attrInfoPayload?.event_id,\n            evTs: attrInfoPayload?.event_ts,\n            orgId: attrInfoPayload?.org_id,\n            _mp_vid: DataStore.visitInfoToString(),\n            _lmid: DataStore.getMpId(),\n            _ldid: DataStore.getDeviceId(),\n            _mpidl: JSON.stringify(DataStore.getVisitorInfoAsString()),\n            is_entry: attrInfoPayload.is_entry ?? 0,\n            app_type: attrInfoPayload.app_type,\n          };\n\n          if (eventName === 'al') {\n            attrPayload.pid = eventPayload?.profile_id;\n          }\n\n          Reporter.postAttrInfo(attrPayload);\n        } catch (err) {\n          Logger.logError('Error processing idl event: ', err);\n        }\n      }\n    );\n  }\n\n  static async initDebugId(): Promise<void> {\n    try {\n      let debugId = await DataStore.getDataFromStorage<string>(\n        Constants.KEY_MP_DEBUG_ID\n      );\n      if (!debugId) {\n        debugId = Utils.getUniqueID();\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(): Promise<void> {\n    try {\n      const visitInfo: VisitInfo = await DataStore.getDataFromStorage(\n        Constants.KEY_MP_IDL_VISIT_ID_INFO\n      );\n\n      if (!visitInfo) {\n        // may be first time visit, setup a new visit info object and return\n        const newVisitInfo: VisitInfo = {\n          visitId: Utils.getUniqueID(),\n          visitCt: 1,\n          visitDepth: 1,\n          visitTs: Date.now(),\n          visitVer: 1,\n        };\n        DataStore.setVisitInfo(newVisitInfo);\n        await DataStore.storeData(\n          Constants.KEY_MP_IDL_VISIT_ID_INFO,\n          newVisitInfo\n        );\n      } else {\n        // reset visit id anyway, but retain the visitCt and depth setting\n        visitInfo.visitId = Utils.getUniqueID();\n        visitInfo.visitCt = visitInfo.visitCt + 1;\n        visitInfo.visitDepth = 1;\n        visitInfo.visitTs = Date.now();\n        visitInfo.visitVer = 1;\n        DataStore.setVisitInfo(visitInfo);\n        await DataStore.storeData(\n          Constants.KEY_MP_IDL_VISIT_ID_INFO,\n          visitInfo\n        );\n      }\n    } catch (err) {\n      Logger.logError(err);\n      DataStore.setVisitInfo(null);\n      Reporter.reportError('setOrResetVisitInfo', err);\n    }\n  }\n\n  static async setOrResetVisitorId(): Promise<void> {\n    try {\n      const visitorInfoData: VisitorInfo = await DataStore.getDataFromStorage(\n        Constants.KEY_MP_IDL_VISITOR_ID_INFO\n      );\n\n      if (!visitorInfoData) {\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        const apiVisitInfo = await NetworkService.fetchIdlInfo(\n          DataStore.getIdlUrl()\n        );\n        if (!apiVisitInfo) {\n          return;\n        } else {\n          DataStore.setVisitorInfo(apiVisitInfo);\n          // store to db as well\n          await DataStore.storeData(\n            Constants.KEY_MP_IDL_VISITOR_ID_INFO,\n            apiVisitInfo\n          );\n        }\n      } else {\n        DataStore.setVisitorInfo(visitorInfoData);\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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"}

package/lib/typescript/common/app-types.d.ts

@@ -0,0 +1,101 @@
+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 {
+    first_name?: string;
+    last_name?: string;
+    email?: string;
+    phone_number: number;
+    country_code: number;
+    city?: string;
+    state?: string;
+    country?: string;
+}
+export interface AppPageLoad {
+    page_name: string;
+    is_entry?: number;
+}
+export interface DeJsvHelper {
+    log: typeof Logger.logDbg;
+    err: typeof Logger.logError;
+}
+export interface QcInfoItem {
+    nm: string;
+    id: string;
+    st: boolean;
+}
+export interface TagInfoItem {
+    id: string;
+    nm: string;
+    pr: string;
+    prNm: string;
+    status: boolean;
+    qc: string | string[];
+}
+export declare type ReplaceMode = 'kph' | 'rph';
+export interface HydrateTagInfo {
+    isInError: boolean;
+    content: string | number | null;
+    errCd: string;
+    errMsg: string;
+}
+export interface ReportTagItem {
+    st: 200 | 900 | 1000 | number;
+    t: string;
+    p: string;
+    tNm: string;
+    req: any;
+}
+export interface Report {
+    envName: string;
+    envId: string;
+    pname?: string;
+    evt: string;
+    evtId: string;
+    dt?: number;
+    ln?: number;
+    bw?: number;
+    dm?: string;
+    items: ReportTagItem[];
+    tagCt: number;
+    dws: 'j' | 'n';
+    v: string;
+}
+export interface UrlInfo {
+    tfUrl: string;
+    errUrl: string;
+    rptUrl: string;
+    infoUrl: string;
+    baseUrl: string;
+    attrInfoUrl: string;
+    idlUrl: string;
+}
+export interface VisitInfo {
+    visitId: string;
+    visitTs: number;
+    visitCt: number;
+    visitDepth: number;
+    visitVer: number;
+}
+export interface VisitorInfo {
+    dId: string;
+    mId: string;
+    st: number;
+}
+export interface SdkInitOptions {
+    orgId: string;
+    env: string;
+    projectId: string;
+    baseUrl: string;
+}
+export declare type EventBusCallback = (event: string, payload: any) => void;

package/lib/typescript/common/constants.d.ts

@@ -0,0 +1,21 @@
+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;
+    static ST_VAL_FAIL: number;
+    static ST_ERR: number;
+    static ST_DEP_FAIL: number;
+    static ST_PR_BL: number;
+    static ST_PR_EXC: number;
+    static PR_TYP_JS: string;
+    static PR_TYP_IMG: string;
+    static PR_TYP_APP: string;
+    static PR_S_TYP_R: string;
+    static sortAscending: (a: BaseResourceParamType, b: BaseResourceParamType) => number;
+    static KEY_MP_IDL_VISITOR_ID_INFO: string;
+    static KEY_MP_IDL_VISIT_ID_INFO: string;
+    static KEY_MP_DEBUG_ID: string;
+}

package/lib/typescript/common/data-store.d.ts

@@ -0,0 +1,81 @@
+import type { DeJsvHelper, MapLike, QcInfoItem, RunQueueModel, SdkInitOptions, UrlInfo, VisitInfo, VisitorInfo } from './app-types';
+import type { ClientSdkDeItem, ClientSdkPrItem, ClientSdkQcItem, ClientSdkTagItem, MpClientSdk } from '../models/mp-client-sdk';
+export declare class DataStore {
+    private static isDataStoreInitialized;
+    private static dataElements;
+    private static validQcList;
+    private static validQcInfoList;
+    private static transFunctions;
+    private static prStatus;
+    private static clientSdk;
+    private static urls;
+    private static debugId;
+    private static visitorInfo;
+    private static visitInfo;
+    private static pageLang;
+    private static mpEnvShort;
+    private static devicePlatform;
+    private static deviceType;
+    private static runQueue;
+    private static isProcessing;
+    private static sdkInitOptions;
+    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 getSdkPcKey(): string;
+    static getSdkInitOptions(): SdkInitOptions;
+    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;
+    static getSSTDownStream(): 'j' | 'n';
+    static getClientDownStream(): 'j' | 'n';
+    static getClientSdk(): MpClientSdk;
+    static getSSTUrl(): string;
+    static getAttrInfoUrl(): string;
+    static setVisitInfo(visitInfo: VisitInfo): void;
+    static visitInfoToString(): string;
+    static setVisitorInfo(visitorInfo: VisitorInfo): void;
+    static getDebugId(): string;
+    static getErrorReportUrl(): string;
+    static getIdlUrl(): string;
+    static getSdkVersion(): string;
+    static setDebugId(dbgId: string): void;
+    static shouldFireSstForEvent(eventName: string): boolean;
+    static getUrlInfo(): UrlInfo;
+    static getSdkTags(): MapLike<ClientSdkTagItem>;
+    static getSdkProviders(): MapLike<ClientSdkPrItem>;
+    static getPrivacyCompliance(): boolean;
+    static setPrivacyCompliance(status: boolean): void;
+    static storeData(key: string, value: any): Promise<void>;
+    static getDataFromStorage<T>(key: string): Promise<T>;
+    static getDataElements(): MapLike;
+    static setDataElements(de: MapLike): void;
+    static getPageLang(): string;
+    static getDeviceOs(): string;
+    static getDataElementHelpers(): DeJsvHelper;
+    static getPageName(): string;
+    static getDataElementValue(param: string): string | boolean | number;
+    static setPageLang(lang: string): void;
+    static getSdkPageLangKey(): string;
+    static setDataElement(key: string, value: any): void;
+    static setValidQc(qcList: string[], qcInfo: QcInfoItem[]): void;
+    static getValidQcList(): string[];
+    static getValidQcInfo(): QcInfoItem[];
+    static setTransFunctions(elements: MapLike): MapLike;
+    static getTransFunctions(): MapLike;
+    static getOperatingSystem(): string;
+    static getVisitId(): string;
+    static getDeviceType(): string;
+    static getDeviceId(): string;
+    static getMpId(): string;
+    static getVisitorInfoAsString(): string | undefined;
+    static getOrgId(): string;
+    static getCoreVersion(): string;
+    static getMpEnv(): 'stg' | 'prd';
+    static setMpEnv(shortEnv: 'stg' | 'prd'): void;
+}

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

@@ -0,0 +1,6 @@
+import type { EventBusCallback } from './app-types';
+export declare class EventBus {
+    private static eventRegister;
+    static on(eventName: string, callback: EventBusCallback): void;
+    static triggerEvent(eventName: string, payload: any): void;
+}

package/lib/typescript/common/logger.d.ts

@@ -0,0 +1,5 @@
+export declare class Logger {
+    static logDbg(...args: any): void;
+    static logWarn(...args: any): void;
+    static logError(...args: any): void;
+}

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

@@ -0,0 +1,8 @@
+import type { MapLike, SdkInitOptions, VisitorInfo } from './app-types';
+export declare class NetworkService {
+    static fetchIdlInfo(url: string): Promise<VisitorInfo>;
+    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/reporter.d.ts

@@ -0,0 +1,12 @@
+import type { MapLike, Report, ReportTagItem } from './app-types';
+export declare class Reporter {
+    static reportMap: MapLike<Report>;
+    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 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 postAttrInfo(payload: MapLike): void;
+}

package/lib/typescript/common/utils.d.ts

@@ -0,0 +1,38 @@
+import type { BaseResourceParamType, TFType } from '../models/mp-client-sdk';
+import type { MapLike } from './app-types';
+export declare class Utils {
+    static triggerEvent(eventName: string, payload: any): void;
+    static sleep(delay?: number): Promise<void>;
+    /**
+     * deviceTypesMappings = {'1':'Desktop Web','2':'Mobile Web','3':'Tablet','4':'Other'};
+     * @param deviceType
+     */
+    static dtToNum(deviceType: string): number;
+    /**
+     * static browserToOsMappings = {'101': 'ios','102': 'android', '7': 'Other'};
+     * @param browser
+     */
+    static bwToNum(browser: string): number;
+    static langToNum(language: string): number;
+    static mergeMaps<T>(input: MapLike<T>, ...toMerge: Array<MapLike<T>>): MapLike<T>;
+    static applyTransformationResourceParam(paramValue: string, tf: TFType | undefined): any;
+    /**
+     * Verifies if the given 'toTest' string exists in any of the input array of strings.
+     * By default, this method does a case sensitive match unless specified by the ignoreCase param.
+     * @param toTest
+     * @param inputs
+     * @param ignoreCase - pass a value of 'true' to perform case-insensitive matching.
+     * @param fullMatch
+     */
+    static isMatch(toTest: string, inputs: string[], ignoreCase: boolean, fullMatch: boolean): boolean;
+    static regExpEscape(input: string): string;
+    static convertToRegex(input: string, ignoreCase: boolean, fullMatch: boolean): RegExp;
+    static safeExecute(fn: (payload: any) => any, payload: any): any;
+    static getUniqueID(): string;
+    static unFlattenResourceParams<T extends BaseResourceParamType>(input: T[]): MapLike<T>;
+    static unflattenObject(obj: Record<string, any>): Record<string, any>;
+    static flattenObject(obj: any): Record<string, any>;
+    private static flatten;
+    static keyIdentity(key: any): any;
+    static isBuffer(obj: any): boolean;
+}

package/lib/typescript/eedl/eedl.d.ts

@@ -0,0 +1,46 @@
+import type { EventProcessorFn, MapLike, TypedAny } from '../common/app-types';
+export declare class MpDataLayerHelper {
+    private readonly dlEventName;
+    private readonly dlInitMode;
+    isReady: boolean;
+    _masterDataLayer: MapLike;
+    eventProcessors: Record<string, any>;
+    stateTracker: Array<any>;
+    dlInitEvent: string;
+    receivedInitialEvent: boolean;
+    eventQueue: Array<any>;
+    constructor(dlEventName: string, dlInitMode: string, dlInitEvent: string);
+    init(globalEventListeners: Record<string, EventProcessorFn>): void;
+    pushEvent(eventName: string, payload: MapLike): void;
+    processQItems(eventName: string, payload: MapLike): void;
+    /**
+     * Private Processor for 'set' command object
+     */
+    setDl(obj: TypedAny | undefined): boolean;
+    getDl(): TypedAny;
+    /**
+     * Private event processor. Idea is that whenever an event is detected, we create a copy of the master data layer,
+     * add the event variables, and trigger the event requested when initializing the data layer helper
+     * @param eventName
+     * @param model
+     */
+    eventProcessor(eventName: string, model: TypedAny | undefined): void;
+    overrideDlInitEvent(eventName: string): string;
+    /**
+     * Exposed method for registering custom processors for events
+     * @param eventType
+     * @param fn
+     */
+    registerProcessor(eventType: string, fn: EventProcessorFn): void;
+    /**
+     * Exposed getter for getting values from data layer
+     * @param key
+     * @returns {*|undefined}
+     */
+    get(key: string): MapLike | undefined;
+    getState(): TypedAny[];
+    hasEventHappened(key: string): boolean;
+    reset(): boolean;
+    ready(): void;
+    drainQueue(): void;
+}

package/lib/typescript/index.d.ts

@@ -0,0 +1,18 @@
+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 firstAppLaunch;
+    static init(options: SdkInitOptions): Promise<void>;
+    static recordEvent(eventName: string, payload: MapLike): void;
+    static ready(): void;
+    static checkAndFireTM(): Promise<void>;
+    static runTM(sseOnly: boolean, triggerName: string, evtName: string, evtId: string, eventData?: Record<string, any>): Promise<void>;
+    static _fireTM(envName: string, envId: string, evtName: string, evtId: string): void;
+    static setCustomerInfo(customerInfo: AppCustomerInfo): void;
+    static recordPageLoad(pageLoadInfo: AppPageLoad): void;
+}
+export declare const MagicPixelEventBus: typeof EventBus;
+export declare const MagicPixel: typeof MagicPixelImpl;
+export {};

package/lib/typescript/models/mp-client-sdk.d.ts

@@ -0,0 +1,157 @@
+import type { MapLike } from '../common/app-types';
+export interface ClientSdkDeItem {
+    nm: string;
+    typ: string;
+    key?: string;
+    def?: any;
+    cl?: boolean;
+    lwcase?: boolean;
+    fn?: (deHelper: any, input: any) => any;
+    isAsync?: boolean;
+    fnTOut?: number;
+}
+export declare enum ParamResourceEncodingType {
+    URL_ENC = "URL_ENC",
+    BASE64 = "BASE64"
+}
+export declare enum ParamResourceHashType {
+    SHA256 = "SHA256",
+    SHA512 = "SHA512"
+}
+export declare enum ParamResourceValSrc {
+    STATIC = "STATIC",
+    DE = "DE",
+    TRANS_FUNC = "TRANS_FUNC",
+    CHILDREN = "CHILDREN",
+    TG_JSON_PATH = "TG_JSON_PATH"
+}
+export interface SdkParamEncodingTransformer {
+    nm: string;
+    eTyp: 'URL_ENC' | 'BASE64';
+    o?: number;
+}
+export interface SdkParamHashingTransformer {
+    nm: string;
+    hTyp: ParamResourceHashType;
+    o?: number;
+}
+export interface SdkParamIgnoreEmptyTransformer {
+    nm: string;
+    igEmpty: boolean;
+    o?: number;
+}
+export declare type TFType = (SdkParamHashingTransformer | SdkParamEncodingTransformer | SdkParamIgnoreEmptyTransformer)[];
+export interface ClientSdkParamItem {
+    id: string;
+    nm: string;
+    rqd?: boolean;
+    tf?: TFType;
+    prLvl?: boolean;
+    pId?: string;
+    sv?: string;
+    de?: string;
+    tfId?: string;
+    children?: ClientSdkParamItem[];
+    exclude_from_req_body?: boolean;
+    fKey: string;
+    val_src: string;
+}
+export interface ClientSdkQcCondition {
+    param: string;
+    i?: string[];
+    e?: string[];
+    i_ect: boolean;
+    i_cs?: boolean;
+    e_ect?: boolean;
+    e_cs?: boolean;
+}
+export interface ClientSdkPrItem {
+    nm: string;
+    url?: string;
+    typ: string;
+    sTyp: string;
+    rParams?: MapLike<ClientSdkParamItem>;
+    hrs?: MapLike<string>;
+    ext?: string;
+    src?: string;
+    sync?: boolean;
+    pr: string;
+    chld?: boolean;
+}
+export interface ClientSdkTfnItem {
+    nm: string;
+    fn: (input: any) => any;
+    rParams: MapLike<ClientSdkParamItem>;
+}
+export interface ClientSdkQcItem {
+    nm: string;
+    id: string;
+    c: ClientSdkQcCondition[];
+}
+export interface ClientSdkTagItem {
+    nm: string;
+    p: string;
+    url: string;
+    rParams?: MapLike<ClientSdkParamItem>;
+    st: number;
+    ex: number;
+    qc: string[];
+    img?: boolean;
+    wrk?: boolean;
+    chld?: boolean;
+}
+export interface ClientSdkSettingsItem {
+    dbg: boolean;
+    err: boolean;
+    c_dom: string;
+    v_dur: number;
+    c_url: string;
+    bare_c_url?: string;
+    wh_idl?: string[];
+    wh_domains?: string[];
+    c_url_lkp?: MapLike<{
+        v: string;
+        ig: boolean;
+        ect: boolean;
+    }>;
+    v_id: string;
+    p_id: string;
+    ev: string;
+    ev_id: string;
+    dly: number;
+    sst: boolean;
+    idl: boolean;
+    c_typ?: string;
+    c_src?: string;
+    c_key?: string;
+    v: string;
+    bld_dt: string;
+    p_view?: boolean;
+    dws_c_t: 'j' | 'n';
+    dws_s_t: 'j' | 'n';
+}
+export interface BaseResourceParamType {
+    id: string;
+    nm: string;
+    o?: number;
+    pId?: string;
+    children?: BaseResourceParamType[];
+}
+export interface MpClientSdk {
+    langKey: string;
+    pcKey: string;
+    cDomKey?: string;
+    domWListKey?: string;
+    d: MapLike<ClientSdkDeItem>;
+    qc?: ClientSdkQcItem[];
+    t?: MapLike<ClientSdkTagItem>;
+    p?: MapLike<ClientSdkPrItem>;
+    tfn?: MapLike<ClientSdkTfnItem>;
+    s: ClientSdkSettingsItem;
+    dtmE: string[];
+    ctmE: string[];
+    mpDlE: string[];
+    sseDtmE: string[];
+    sseCtmE: string[];
+    sseMpDlE: string[];
+}