react-native-moengage-personalize 1.0.0

package/android/src/oldarch/java/com/moengage/react/personalize/MoEReactPersonalize.kt

@@ -0,0 +1,63 @@
+/*
+ * Copyright (c) 2026 MoEngage, Inc.
+ * All rights reserved.
+ * Use of source code or binaries contained within MoEngage's SDKs is permitted only to enable use of the MoEngage platform by customers of MoEngage. The Licensee may not:
+ * - permit any third party to use the Software;
+ * - modify or translate the Software except as otherwise permitted;
+ * - reverse engineer, decompile, or disassemble the Software;
+ * - copy the Software, except as expressly provided above; or
+ * - remove or obscure any proprietary rights notices or labels on the Software.
+ * - Licensee may not transfer the Software or any rights under this Agreement without the Licensor's prior written consent.
+ * - MoEngage owns the Software and all intellectual property rights embodied therein, including copyrights and valuable trade secrets embodied in the Software. The Licensee shall not alter or remove this copyright notice.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF THE USER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package com.moengage.react.personalize
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+
+/**
+ * Bridge to communicate with personalize plugin JS code in old arch.
+ */
+class MoEReactPersonalize(
+    reactContext: ReactApplicationContext
+) : ReactContextBaseJavaModule(reactContext) {
+
+    private val bridgeHandler = MoEngagePersonalizeHandler(reactContext.applicationContext)
+
+    override fun getName() = bridgeHandler.getName()
+
+    @ReactMethod
+    fun fetchExperiencesMeta(payload: String, promise: Promise) {
+        bridgeHandler.fetchExperiencesMeta(payload, promise)
+    }
+
+    @ReactMethod
+    fun fetchExperiences(payload: String, promise: Promise) {
+        bridgeHandler.fetchExperiences(payload, promise)
+    }
+
+    @ReactMethod
+    fun experiencesShown(payload: String) {
+        bridgeHandler.trackExperienceShown(payload)
+    }
+
+    @ReactMethod
+    fun experienceClicked(payload: String) {
+        bridgeHandler.trackExperienceClicked(payload)
+    }
+
+    @ReactMethod
+    fun offeringsShown(payload: String) {
+        bridgeHandler.trackOfferingShown(payload)
+    }
+
+    @ReactMethod
+    fun offeringClicked(payload: String) {
+        bridgeHandler.trackOfferingClicked(payload)
+    }
+}

package/ios/MoEReactNativePersonalizeHandler.h

@@ -0,0 +1,26 @@
+//
+//  MoEReactNativePersonalizeHandler.h
+//  ReactNativeMoEngagePersonalize
+//
+
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+#import <React/RCTBridgeModule.h>
+
+@interface MoEReactNativePersonalizeHandler : NSObject
+
++(instancetype)sharedInstance;
+
+// Fetch APIs
+-(void)fetchExperiencesMeta:(NSString *)payload resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject;
+-(void)fetchExperiences:(NSString *)payload resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject;
+
+// Experience Tracking
+-(void)experiencesShown:(NSString *)payload;
+-(void)experienceClicked:(NSString *)payload;
+
+// Offering Tracking
+-(void)offeringsShown:(NSString *)payload;
+-(void)offeringClicked:(NSString *)payload;
+
+@end

package/ios/MoEReactNativePersonalizeHandler.m

@@ -0,0 +1,118 @@
+//
+//  MoEReactNativePersonalizeHandler.m
+//  ReactNativeMoEngagePersonalize
+//
+
+#import <Foundation/Foundation.h>
+#import "MoEReactNativePersonalizeHandler.h"
+#import "ReactNativeMoEngage/MoEngageReactUtils.h"
+
+@import MoEngagePluginPersonalize;
+
+static NSString * const kLogTag = @"[MoEngageReactPersonalize]";
+
+@implementation MoEReactNativePersonalizeHandler : NSObject
+
++(instancetype)sharedInstance {
+    static dispatch_once_t onceToken;
+    static MoEReactNativePersonalizeHandler *instance;
+    dispatch_once(&onceToken, ^{
+        instance = [[MoEReactNativePersonalizeHandler alloc] init];
+    });
+    return instance;
+}
+
+#pragma mark - Helpers
+
+/// Serializes the bridge response and resolves/rejects the JS promise. If the
+/// response carries an `error` key (per the contract), the promise is rejected
+/// with the stringified payload. JSON serialization failures reject with PARSE_ERROR.
+-(void)resolveResponse:(NSDictionary *)response
+              resolver:(RCTPromiseResolveBlock)resolve
+              rejecter:(RCTPromiseRejectBlock)reject
+                method:(NSString *)method {
+    NSError *err;
+    NSData *jsonData = [NSJSONSerialization dataWithJSONObject:response options:0 error:&err];
+    if (jsonData) {
+        NSString *strPayload = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
+        if (response[@"error"] != nil) {
+            NSLog(@"%@ %@: rejecting with PERSONALIZE_ERROR — %@", kLogTag, method, response[@"error"]);
+            reject(@"PERSONALIZE_ERROR", strPayload, nil);
+        } else {
+            resolve(strPayload);
+        }
+    } else {
+        NSLog(@"%@ %@: failed to serialize response — %@", kLogTag, method, err);
+        reject(@"PARSE_ERROR", @"Failed to serialize response", err);
+    }
+}
+
+/// Logs and parses the incoming JS payload string into an NSDictionary. Returns
+/// nil (and logs) on parse failure so callers can short-circuit safely.
+-(NSDictionary *)parsePayload:(NSString *)payload method:(NSString *)method {
+    NSDictionary *jsonPayload = [MoEngageReactUtils getJSONRepresentation:payload];
+    if (jsonPayload == nil) {
+        NSLog(@"%@ %@: failed to parse payload — input: %@", kLogTag, method, payload);
+    }
+    return jsonPayload;
+}
+
+#pragma mark - Fetch APIs
+
+-(void)fetchExperiencesMeta:(NSString *)payload resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+    NSLog(@"%@ fetchExperiencesMeta", kLogTag);
+    NSDictionary *jsonPayload = [self parsePayload:payload method:@"fetchExperiencesMeta"];
+    if (jsonPayload == nil) {
+        reject(@"PARSE_ERROR", @"Failed to parse incoming payload", nil);
+        return;
+    }
+    [[MoEngagePluginPersonalizeBridge sharedInstance] fetchExperiencesMeta:jsonPayload completionHandler:^(NSDictionary<NSString *,id> * _Nonnull response) {
+        [self resolveResponse:response resolver:resolve rejecter:reject method:@"fetchExperiencesMeta"];
+    }];
+}
+
+-(void)fetchExperiences:(NSString *)payload resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+    NSLog(@"%@ fetchExperiences", kLogTag);
+    NSDictionary *jsonPayload = [self parsePayload:payload method:@"fetchExperiences"];
+    if (jsonPayload == nil) {
+        reject(@"PARSE_ERROR", @"Failed to parse incoming payload", nil);
+        return;
+    }
+    [[MoEngagePluginPersonalizeBridge sharedInstance] fetchExperiences:jsonPayload completionHandler:^(NSDictionary<NSString *,id> * _Nonnull response) {
+        [self resolveResponse:response resolver:resolve rejecter:reject method:@"fetchExperiences"];
+    }];
+}
+
+#pragma mark - Experience Tracking
+
+-(void)experiencesShown:(NSString *)payload {
+    NSLog(@"%@ experiencesShown", kLogTag);
+    NSDictionary *jsonPayload = [self parsePayload:payload method:@"experiencesShown"];
+    if (jsonPayload == nil) return;
+    [[MoEngagePluginPersonalizeBridge sharedInstance] experiencesShown:jsonPayload];
+}
+
+-(void)experienceClicked:(NSString *)payload {
+    NSLog(@"%@ experienceClicked", kLogTag);
+    NSDictionary *jsonPayload = [self parsePayload:payload method:@"experienceClicked"];
+    if (jsonPayload == nil) return;
+    [[MoEngagePluginPersonalizeBridge sharedInstance] experienceClicked:jsonPayload];
+}
+
+#pragma mark - Offering Tracking
+
+-(void)offeringsShown:(NSString *)payload {
+    NSLog(@"%@ offeringsShown", kLogTag);
+    NSDictionary *jsonPayload = [self parsePayload:payload method:@"offeringsShown"];
+    if (jsonPayload == nil) return;
+    [[MoEngagePluginPersonalizeBridge sharedInstance] offeringsShown:jsonPayload];
+}
+
+-(void)offeringClicked:(NSString *)payload {
+    NSLog(@"%@ offeringClicked", kLogTag);
+    NSDictionary *jsonPayload = [self parsePayload:payload method:@"offeringClicked"];
+    if (jsonPayload == nil) return;
+    [[MoEngagePluginPersonalizeBridge sharedInstance] offeringClicked:jsonPayload];
+}
+
+@end

package/ios/MoEngagePersonalizeBridge.h

@@ -0,0 +1,15 @@
+// MoEngagePersonalizeBridge.h
+
+#import <React/RCTBridgeModule.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <NativeMoEngagePersonalizeSpec/NativeMoEngagePersonalizeSpec.h>
+#endif
+
+#ifdef RCT_NEW_ARCH_ENABLED
+@interface MoEngagePersonalizeBridge : NSObject <NativeMoEngagePersonalizeSpec>
+@end
+#else
+@interface MoEngagePersonalizeBridge : NSObject <RCTBridgeModule>
+@end
+#endif

package/ios/MoEngagePersonalizeBridge.mm

@@ -0,0 +1,46 @@
+// MoEngagePersonalizeBridge.mm
+
+#import "MoEngagePersonalizeBridge.h"
+#import "MoEReactNativePersonalizeHandler.h"
+
+@implementation MoEngagePersonalizeBridge
+
+RCT_EXPORT_MODULE()
+
+#pragma mark - Fetch APIs
+
+RCT_EXPORT_METHOD(fetchExperiencesMeta:(NSString *)payload resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject) {
+    [[MoEReactNativePersonalizeHandler sharedInstance] fetchExperiencesMeta:payload resolve:resolve reject:reject];
+}
+
+RCT_EXPORT_METHOD(fetchExperiences:(NSString *)payload resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject) {
+    [[MoEReactNativePersonalizeHandler sharedInstance] fetchExperiences:payload resolve:resolve reject:reject];
+}
+
+#pragma mark - Experience Tracking
+
+RCT_EXPORT_METHOD(experiencesShown:(NSString *)payload) {
+    [[MoEReactNativePersonalizeHandler sharedInstance] experiencesShown:payload];
+}
+
+RCT_EXPORT_METHOD(experienceClicked:(NSString *)payload) {
+    [[MoEReactNativePersonalizeHandler sharedInstance] experienceClicked:payload];
+}
+
+#pragma mark - Offering Tracking
+
+RCT_EXPORT_METHOD(offeringsShown:(NSString *)payload) {
+    [[MoEReactNativePersonalizeHandler sharedInstance] offeringsShown:payload];
+}
+
+RCT_EXPORT_METHOD(offeringClicked:(NSString *)payload) {
+    [[MoEReactNativePersonalizeHandler sharedInstance] offeringClicked:payload];
+}
+
+#ifdef RCT_NEW_ARCH_ENABLED
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:(const facebook::react::ObjCTurboModule::InitParams &)params {
+    return std::make_shared<facebook::react::NativeMoEngagePersonalizeSpecJSI>(params);
+}
+#endif
+
+@end

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "react-native-moengage-personalize",
+  "version": "1.0.0",
+  "description": "Personalize Module for the MoEngage Platform",
+  "main": "src/index.ts",
+  "files": [
+    "android",
+    "ios",
+    "src",
+    "package.json",
+    "ReactNativeMoEngagePersonalize.podspec",
+    "README.md",
+    "!**/__tests__",
+    "!**/__mocks__"
+  ],
+  "scripts": {
+    "test": "jest",
+    "build": "echo \"Not required\" && exit 0"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "moengage"
+  ],
+  "repository": "https://github.com/moengage/React-Native",
+  "author": {
+    "name": "MoEngage",
+    "email": "mobiledevs@moengage.com"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "react-native-moengage": "^12.0.0"
+  },
+  "license": "SEE LICENSE IN LICENSE.md",
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "react-native": "0.73.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^4.3.0"
+  },
+  "codegenConfig": {
+    "name": "NativeMoEngagePersonalizeSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.moengage.react.personalize"
+    }
+  }
+}

package/src/NativeMoEngagePersonalize.ts

@@ -0,0 +1,51 @@
+import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport';
+import { TurboModuleRegistry } from 'react-native';
+
+export interface Spec extends TurboModule {
+    /**
+     * Fetches experience campaign metadata filtered by status.
+     *
+     * @param payload Stringified JSON payload.
+     * @returns {Promise<string>} A promise that contains experience metadata.
+     */
+    fetchExperiencesMeta(payload: string): Promise<string>;
+
+    /**
+     * Fetches experience campaigns for the given keys and optional attributes.
+     *
+     * @param payload Stringified JSON payload.
+     * @returns {Promise<string>} A promise that contains experiences and failures.
+     */
+    fetchExperiences(payload: string): Promise<string>;
+
+    /**
+     * Tracks impression events for one or more experience campaigns.
+     *
+     * @param payload Stringified JSON payload.
+     */
+    experiencesShown(payload: string): void;
+
+    /**
+     * Tracks a click event for a single experience campaign.
+     *
+     * @param payload Stringified JSON payload.
+     */
+    experienceClicked(payload: string): void;
+
+    /**
+     * Tracks impression events for one or more offerings.
+     *
+     * @param payload Stringified JSON payload.
+     */
+    offeringsShown(payload: string): void;
+
+    /**
+     * Tracks a click event for a single offering within an experience campaign.
+     *
+     * @param payload Stringified JSON payload.
+     */
+    offeringClicked(payload: string): void;
+}
+
+const MoEngagePersonalizeBridge = TurboModuleRegistry.getEnforcing<Spec>('MoEngagePersonalizeBridge');
+export default MoEngagePersonalizeBridge;

package/src/index.ts

@@ -0,0 +1,164 @@
+import ExperienceCampaign from "./model/ExperienceCampaign";
+import ExperienceCampaignFailure from "./model/ExperienceCampaignFailure";
+import ExperienceCampaignMeta from "./model/ExperienceCampaignMeta";
+import ExperienceCampaignsMetadata from "./model/ExperienceCampaignsMetadata";
+import ExperienceCampaignsResult from "./model/ExperienceCampaignsResult";
+import { DataSource } from "./model/DataSource";
+import { ExperienceStatus } from "./model/ExperienceStatus";
+import { ExperienceFailureReason } from "./model/ExperienceFailureReason";
+import MoEngagePersonalizeHandler from "./internal/MoEngagePersonalizeHandler";
+import { MoEngageLogger } from "react-native-moengage";
+import { MODULE_TAG } from "./internal/Constants";
+
+/**
+ * Public API for the MoEngage Personalize Experience module. Each instance is
+ * scoped to a single MoEngage workspace (app id) — multiple workspaces should
+ * each instantiate their own.
+ *
+ * @author MoEngage
+ * @since 1.0.0
+ */
+class ReactMoEngagePersonalize {
+
+  private readonly TAG = `${MODULE_TAG}ReactMoEngagePersonalize`;
+
+  private handler: MoEngagePersonalizeHandler;
+
+  /**
+   * Construct a personalize instance for the given workspace.
+   *
+   * @param appId The MoEngage workspace identifier.
+   * @since 1.0.0
+   */
+  constructor(appId: string) {
+    MoEngageLogger.debug(`${this.TAG} constructor() : appId=${appId}`);
+    this.handler = new MoEngagePersonalizeHandler(appId);
+  }
+
+  /**
+   * Fetches experience campaign metadata filtered by status.
+   *
+   * @param statuses Array of {@link ExperienceStatus} to filter by.
+   * @returns Promise resolving to {@link ExperienceCampaignsMetadata}.
+   * @throws Rejects on SDK-level failures (SDK not initialized, network error, etc.).
+   * @since 1.0.0
+   */
+  fetchExperiencesMeta(statuses: ExperienceStatus[]): Promise<ExperienceCampaignsMetadata> {
+    MoEngageLogger.verbose(`${this.TAG} fetchExperiencesMeta() : `);
+    return this.handler.fetchExperiencesMeta(statuses);
+  }
+
+  /**
+   * Fetches a single experience campaign for the given key.
+   *
+   * @param experienceKey The experience key to fetch.
+   * @param attributes Optional key-value attributes for personalization.
+   * @returns Promise resolving to {@link ExperienceCampaignsResult}.
+   * @throws Rejects on SDK-level failures.
+   * @since 1.0.0
+   */
+  fetchExperience(
+    experienceKey: string,
+    attributes: Record<string, string> = {}
+  ): Promise<ExperienceCampaignsResult> {
+    MoEngageLogger.verbose(`${this.TAG} fetchExperience() : `);
+    return this.fetchExperiences([experienceKey], attributes);
+  }
+
+  /**
+   * Fetches experience campaigns for the given keys and optional attributes.
+   *
+   * @param experienceKeys Array of experience keys to fetch.
+   * @param attributes Optional key-value attributes for personalization.
+   * @returns Promise resolving to {@link ExperienceCampaignsResult}.
+   * @throws Rejects on SDK-level failures.
+   * @since 1.0.0
+   */
+  fetchExperiences(
+    experienceKeys: string[],
+    attributes: Record<string, string> = {}
+  ): Promise<ExperienceCampaignsResult> {
+    MoEngageLogger.verbose(`${this.TAG} fetchExperiences() : `);
+    return this.handler.fetchExperiences(experienceKeys, attributes);
+  }
+
+  /**
+   * Tracks impression events for one or more experience campaigns.
+   *
+   * @param campaigns Array of {@link ExperienceCampaign} that were shown.
+   * @since 1.0.0
+   */
+  experiencesShown(campaigns: ExperienceCampaign[]): void {
+    MoEngageLogger.verbose(`${this.TAG} experiencesShown() : `);
+    this.handler.experiencesShown(campaigns);
+  }
+
+  /**
+   * Tracks an impression event for a single experience campaign.
+   *
+   * @param campaign The {@link ExperienceCampaign} that was shown.
+   * @since 1.0.0
+   */
+  experienceShown(campaign: ExperienceCampaign): void {
+    MoEngageLogger.verbose(`${this.TAG} experienceShown() : `);
+    this.experiencesShown([campaign]);
+  }
+
+  /**
+   * Tracks a click event for a single experience campaign.
+   *
+   * @param campaign The {@link ExperienceCampaign} that was clicked.
+   * @since 1.0.0
+   */
+  experienceClicked(campaign: ExperienceCampaign): void {
+    MoEngageLogger.verbose(`${this.TAG} experienceClicked() : `);
+    this.handler.experienceClicked(campaign);
+  }
+
+  /**
+   * Tracks impression events for one or more offerings.
+   *
+   * @param offeringPayloads Array of full offering payload dictionaries.
+   * @since 1.0.0
+   */
+  offeringsShown(offeringPayloads: Record<string, any>[]): void {
+    MoEngageLogger.verbose(`${this.TAG} offeringsShown() : `);
+    this.handler.offeringsShown(offeringPayloads);
+  }
+
+  /**
+   * Tracks an impression event for a single offering.
+   *
+   * @param offeringPayload The full offering payload dictionary that was shown.
+   * @since 1.0.0
+   */
+  offeringShown(offeringPayload: Record<string, any>): void {
+    MoEngageLogger.verbose(`${this.TAG} offeringShown() : `);
+    this.offeringsShown([offeringPayload]);
+  }
+
+  /**
+   * Tracks a click event for a single offering within an experience campaign.
+   *
+   * @param campaign The {@link ExperienceCampaign} containing the offering.
+   * @param offeringPayload The full offering payload dictionary that was clicked.
+   * @since 1.0.0
+   */
+  offeringClicked(campaign: ExperienceCampaign, offeringPayload: Record<string, any>): void {
+    MoEngageLogger.verbose(`${this.TAG} offeringClicked() : `);
+    this.handler.offeringClicked(campaign, offeringPayload);
+  }
+}
+
+export {
+  ExperienceCampaign,
+  ExperienceCampaignFailure,
+  ExperienceCampaignMeta,
+  ExperienceCampaignsMetadata,
+  ExperienceCampaignsResult,
+  DataSource,
+  ExperienceStatus,
+  ExperienceFailureReason,
+};
+
+export default ReactMoEngagePersonalize;

package/src/internal/Constants.ts

@@ -0,0 +1,16 @@
+export const MODULE_TAG = "MoEngageReactPersonalize_"
+
+export const keyData = 'data'
+
+export const keyStatus = 'status'
+
+export const keyExperiences = 'experiences'
+export const keyExperienceKey = 'experienceKey'
+export const keyExperienceName = 'experienceName'
+export const keyPayload = 'payload'
+export const keyExperienceContext = 'experienceContext'
+export const keySource = 'source'
+
+export const keyFailures = 'failures'
+export const keyReason = 'reason'
+export const keyExperienceKeys = 'experienceKeys'

package/src/internal/MoEngagePersonalizeHandler.ts

@@ -0,0 +1,97 @@
+import MoEngagePersonalizeBridge from "../NativeMoEngagePersonalize";
+import ExperienceCampaign from "../model/ExperienceCampaign";
+import ExperienceCampaignsMetadata from "../model/ExperienceCampaignsMetadata";
+import ExperienceCampaignsResult from "../model/ExperienceCampaignsResult";
+import { ExperienceStatus } from "../model/ExperienceStatus";
+import { MoEngageLogger } from "react-native-moengage";
+import { MODULE_TAG } from "./Constants";
+import * as PayloadBuilder from "./utils/PayloadBuilder";
+import * as Parser from "./utils/PayloadParser";
+
+/**
+ * Helper class that translates Public Personalize APIs into native bridge calls.
+ *
+ * @author MoEngage
+ * @since 1.0.0
+ */
+export default class MoEngagePersonalizeHandler {
+
+    private TAG = `${MODULE_TAG}MoEngagePersonalizeHandler`;
+
+    private appId: string;
+
+    constructor(appId: string) {
+        this.appId = appId;
+        MoEngageLogger.debug(`${this.TAG} constructor() : initialised for appId=${appId}`);
+    }
+
+    async fetchExperiencesMeta(statuses: ExperienceStatus[]): Promise<ExperienceCampaignsMetadata> {
+        try {
+            const payload = PayloadBuilder.buildFetchExperiencesMetaPayload(this.appId, statuses);
+            MoEngageLogger.verbose(`${this.TAG} fetchExperiencesMeta() : ${payload}`);
+            const response = await MoEngagePersonalizeBridge.fetchExperiencesMeta(payload);
+            return Parser.parseExperiencesMetadata(response);
+        } catch (error) {
+            MoEngageLogger.error(`${this.TAG} fetchExperiencesMeta() : `, error);
+            throw error;
+        }
+    }
+
+    async fetchExperiences(
+        experienceKeys: string[],
+        attributes: Record<string, string>
+    ): Promise<ExperienceCampaignsResult> {
+        try {
+            const payload = PayloadBuilder.buildFetchExperiencesPayload(this.appId, experienceKeys, attributes);
+            MoEngageLogger.verbose(`${this.TAG} fetchExperiences() : ${payload}`);
+            const response = await MoEngagePersonalizeBridge.fetchExperiences(payload);
+            return Parser.parseExperiencesResult(response);
+        } catch (error) {
+            MoEngageLogger.error(`${this.TAG} fetchExperiences() : `, error);
+            throw error;
+        }
+    }
+
+    experiencesShown(campaigns: ExperienceCampaign[]): void {
+        try {
+            const payload = PayloadBuilder.buildExperiencesShownPayload(this.appId, campaigns);
+            MoEngageLogger.verbose(`${this.TAG} experiencesShown() : ${payload}`);
+            MoEngagePersonalizeBridge.experiencesShown(payload);
+        } catch (error) {
+            MoEngageLogger.error(`${this.TAG} experiencesShown() : `, error);
+        }
+    }
+
+    experienceClicked(campaign: ExperienceCampaign): void {
+        try {
+            const payload = PayloadBuilder.buildExperienceClickedPayload(this.appId, campaign);
+            MoEngageLogger.verbose(`${this.TAG} experienceClicked() : ${payload}`);
+            MoEngagePersonalizeBridge.experienceClicked(payload);
+        } catch (error) {
+            MoEngageLogger.error(`${this.TAG} experienceClicked() : `, error);
+        }
+    }
+
+    offeringsShown(offeringPayloads: Record<string, any>[]): void {
+        try {
+            const payload = PayloadBuilder.buildOfferingsShownPayload(this.appId, offeringPayloads);
+            MoEngageLogger.verbose(`${this.TAG} offeringsShown() : ${payload}`);
+            MoEngagePersonalizeBridge.offeringsShown(payload);
+        } catch (error) {
+            MoEngageLogger.error(`${this.TAG} offeringsShown() : `, error);
+        }
+    }
+
+    offeringClicked(
+        campaign: ExperienceCampaign,
+        offeringPayload: Record<string, any>
+    ): void {
+        try {
+            const payload = PayloadBuilder.buildOfferingClickedPayload(this.appId, campaign, offeringPayload);
+            MoEngageLogger.verbose(`${this.TAG} offeringClicked() : ${payload}`);
+            MoEngagePersonalizeBridge.offeringClicked(payload);
+        } catch (error) {
+            MoEngageLogger.error(`${this.TAG} offeringClicked() : `, error);
+        }
+    }
+}