@adobe/react-native-aepmessaging 7.1.1 → 7.2.0

package/dist/models/{JSONPropositionItem.js → JSONProposition.js}

@@ -11,4 +11,13 @@
     language governing permissions and limitations under the License.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=JSONPropositionItem.js.map
+exports.JSONPropositionItem = void 0;
+const PropositionItem_1 = require("./PropositionItem");
+class JSONPropositionItem extends PropositionItem_1.PropositionItem {
+    constructor(jsonData) {
+        super(jsonData);
+        this.data = jsonData.data;
+    }
+}
+exports.JSONPropositionItem = JSONPropositionItem;
+//# sourceMappingURL=JSONProposition.js.map

package/dist/models/JSONProposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSONProposition.js","sourceRoot":"","sources":["../../src/models/JSONProposition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;EAUE;;;AAGF,uDAAyE;AASzE,MAAa,mBAAoB,SAAQ,iCAAe;IAGvD,YAAY,QAA6B;QACxC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;CACD;AAPD,kDAOC"}

package/dist/models/Message.d.ts

@@ -35,5 +35,19 @@ declare class Message {
      * Failure to call this function leads to memory leaks.
      */
     clear(): void;
+    /**
+     * Adds a handler for named JavaScript messages sent from the message's WebView.
+     * The parameter passed to handler will contain the body of the message passed from the WebView's JavaScript.
+     * @param {string} handlerName: The name of the message that should be handled by the handler
+     * @param {function} handler: The method or closure to be called with the body of the message created in the Message's JavaScript
+     */
+    handleJavascriptMessage(handlerName: string, handler: (content: string) => void): void;
+    /**
+     * @internal - For internal use only.
+     * Clears all the javascript message handlers for the message.
+     * This function must be called if the callbacks registered in handleJavascriptMessage are no longer needed.
+     * Failure to call this function may lead to memory leaks.
+     */
+    _clearJavascriptMessageHandlers(): void;
 }
 export default Message;

package/dist/models/Message.js

@@ -13,6 +13,17 @@ governing permissions and limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 const react_native_1 = require("react-native");
 const RCTAEPMessaging = react_native_1.NativeModules.AEPMessaging;
+// Registery to store inAppMessage callbacks for each message in Message.handleJavascriptMessage
+// Record - {messageId : {handlerName : callback}}
+const jsMessageHandlers = {};
+const handleJSMessageEventEmitter = new react_native_1.NativeEventEmitter(RCTAEPMessaging);
+// invokes the callback registered in Message.handleJavascriptMessage with the content received from the inAppMessage webview
+handleJSMessageEventEmitter.addListener('onJavascriptMessage', (event) => {
+    const { messageId, handlerName, content } = event;
+    if (jsMessageHandlers[messageId] && jsMessageHandlers[messageId][handlerName]) {
+        jsMessageHandlers[messageId][handlerName](content);
+    }
+});
 class Message {
     constructor({ id, autoTrack = false }) {
         this.id = id;
@@ -59,6 +70,38 @@ class Message {
     clear() {
         RCTAEPMessaging.clear(this.id);
     }
+    /**
+     * Adds a handler for named JavaScript messages sent from the message's WebView.
+     * The parameter passed to handler will contain the body of the message passed from the WebView's JavaScript.
+     * @param {string} handlerName: The name of the message that should be handled by the handler
+     * @param {function} handler: The method or closure to be called with the body of the message created in the Message's JavaScript
+     */
+    handleJavascriptMessage(handlerName, handler) {
+        // Validate parameters
+        if (!handlerName) {
+            console.warn('[AEP Messaging] handleJavascriptMessage: handlerName is required');
+            return;
+        }
+        if (typeof handler !== 'function') {
+            console.warn('[AEP Messaging] handleJavascriptMessage: handler must be a function');
+            return;
+        }
+        // cache the callback
+        if (!jsMessageHandlers[this.id]) {
+            jsMessageHandlers[this.id] = {};
+        }
+        jsMessageHandlers[this.id][handlerName] = handler;
+        RCTAEPMessaging.handleJavascriptMessage(this.id, handlerName);
+    }
+    /**
+     * @internal - For internal use only.
+     * Clears all the javascript message handlers for the message.
+     * This function must be called if the callbacks registered in handleJavascriptMessage are no longer needed.
+     * Failure to call this function may lead to memory leaks.
+     */
+    _clearJavascriptMessageHandlers() {
+        delete jsMessageHandlers[this.id];
+    }
 }
 exports.default = Message;
 //# sourceMappingURL=Message.js.map

package/dist/models/Message.js.map

@@ -1 +1 @@
-{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../src/models/Message.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;EAUE;;AAEF,+CAA6C;AAC7C,MAAM,eAAe,GAAG,4BAAa,CAAC,YAAY,CAAC;AAEnD,MAAM,OAAO;IAIX,YAAY,EAAE,EAAE,EAAE,SAAS,GAAG,KAAK,EAAsC;QACvE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,SAAkB;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,iBAA2B;QACjC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAmB,EAAE,SAAiB;QAC1C,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;CACF;AAED,kBAAe,OAAO,CAAC"}
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../src/models/Message.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;EAUE;;AAEF,+CAAiE;AAEjE,MAAM,eAAe,GAAG,4BAAa,CAAC,YAAY,CAAC;AAEnD,gGAAgG;AAChG,kDAAkD;AAClD,MAAM,iBAAiB,GAA8D,EAAE,CAAC;AACxF,MAAM,2BAA2B,GAAG,IAAI,iCAAkB,CAAC,eAAe,CAAC,CAAC;AAE5E,6HAA6H;AAC7H,2BAA2B,CAAC,WAAW,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE;IACvE,MAAM,EAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAC,GAAG,KAAK,CAAC;IAChD,IAAI,iBAAiB,CAAC,SAAS,CAAC,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,EAAE;QAC7E,iBAAiB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC;KACpD;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,OAAO;IAIX,YAAY,EAAE,EAAE,EAAE,SAAS,GAAG,KAAK,EAAsC;QACvE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,SAAkB;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,iBAA2B;QACjC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAmB,EAAE,SAAiB;QAC1C,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,uBAAuB,CAAC,WAAmB,EAAE,OAAkC;QAC7E,sBAAsB;QACtB,IAAI,CAAC,WAAW,EAAE;YAChB,OAAO,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;YACjF,OAAO;SACR;QAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;YACjC,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;YACpF,OAAO;SACR;QAED,qBAAqB;QACrB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAC/B,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;SACjC;QACD,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC;QAClD,eAAe,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,+BAA+B;QAC7B,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;CACF;AAED,kBAAe,OAAO,CAAC"}

package/dist/models/MessagingProposition.d.ts

@@ -1,8 +1,15 @@
-import { MessagingPropositionItem } from './MessagingPropositionItem';
 import { ScopeDetails } from './ScopeDetails';
-export interface MessagingProposition {
+import { PropositionItem } from './PropositionItem';
+export declare class MessageProposition {
     id: string;
     scope: string;
     scopeDetails: ScopeDetails;
-    items: MessagingPropositionItem[];
+    items: PropositionItem[];
+    constructor(raw: {
+        id: string;
+        scope: string;
+        scopeDetails: ScopeDetails;
+        items?: any[];
+    });
 }
+export { MessageProposition as MessagingProposition };

package/dist/models/MessagingProposition.js

@@ -11,4 +11,49 @@
     language governing permissions and limitations under the License.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagingProposition = exports.MessageProposition = void 0;
+const PersonalizationSchema_1 = require("./PersonalizationSchema");
+const ContentCard_1 = require("./ContentCard");
+const HTMLProposition_1 = require("./HTMLProposition");
+const JSONProposition_1 = require("./JSONProposition");
+const PropositionItem_1 = require("./PropositionItem");
+class MessageProposition {
+    constructor(raw) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        this.id = (_a = raw === null || raw === void 0 ? void 0 : raw.id) !== null && _a !== void 0 ? _a : '';
+        this.scope = (_b = raw === null || raw === void 0 ? void 0 : raw.scope) !== null && _b !== void 0 ? _b : '';
+        this.scopeDetails = (_c = raw === null || raw === void 0 ? void 0 : raw.scopeDetails) !== null && _c !== void 0 ? _c : {};
+        // Mirror activity.id into activity.activityID for convenience
+        const activityIdFromScope = (_f = (_e = (_d = this.scopeDetails) === null || _d === void 0 ? void 0 : _d.activity) === null || _e === void 0 ? void 0 : _e.id) !== null && _f !== void 0 ? _f : '';
+        if ((_g = this.scopeDetails) === null || _g === void 0 ? void 0 : _g.activity) {
+            this.scopeDetails.activity.activityID = activityIdFromScope;
+        }
+        const rawItems = Array.isArray(raw === null || raw === void 0 ? void 0 : raw.items) ? raw.items : [];
+        this.items = rawItems.map((itemData) => {
+            var _a, _b, _c;
+            const activityId = (_c = (_b = (_a = this.scopeDetails) === null || _a === void 0 ? void 0 : _a.activity) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : '';
+            let instance;
+            switch (itemData === null || itemData === void 0 ? void 0 : itemData.schema) {
+                case PersonalizationSchema_1.PersonalizationSchema.CONTENT_CARD:
+                    instance = new ContentCard_1.ContentCard(itemData);
+                    instance.activityID = activityId;
+                    return instance;
+                case PersonalizationSchema_1.PersonalizationSchema.HTML_CONTENT:
+                    instance = new HTMLProposition_1.HTMLProposition(itemData);
+                    instance.activityID = activityId;
+                    return instance;
+                case PersonalizationSchema_1.PersonalizationSchema.JSON_CONTENT:
+                    instance = new JSONProposition_1.JSONPropositionItem(itemData);
+                    instance.activityID = activityId;
+                    return instance;
+                default:
+                    instance = new PropositionItem_1.PropositionItem(itemData);
+                    instance.activityID = activityId;
+                    return instance;
+            }
+        });
+    }
+}
+exports.MessageProposition = MessageProposition;
+exports.MessagingProposition = MessageProposition;
 //# sourceMappingURL=MessagingProposition.js.map

package/dist/models/MessagingProposition.js.map

@@ -1 +1 @@
-{"version":3,"file":"MessagingProposition.js","sourceRoot":"","sources":["../../src/models/MessagingProposition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;EAUE"}
+{"version":3,"file":"MessagingProposition.js","sourceRoot":"","sources":["../../src/models/MessagingProposition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;EAUE;;;AAGF,mEAAgE;AAChE,+CAA4C;AAC5C,uDAAoD;AACpD,uDAAwD;AACxD,uDAAoD;AAEpD,MAAa,kBAAkB;IAM7B,YAAY,GAA6E;;QACvF,IAAI,CAAC,EAAE,GAAG,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,EAAE,mCAAI,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,KAAK,mCAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,MAAC,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,YAA6B,mCAAK,EAAmB,CAAC;QAEhF,8DAA8D;QAC9D,MAAM,mBAAmB,GAAG,MAAA,MAAA,MAAA,IAAI,CAAC,YAAY,0CAAE,QAAQ,0CAAE,EAAE,mCAAI,EAAE,CAAC;QAClE,IAAI,MAAA,IAAI,CAAC,YAAY,0CAAE,QAAQ,EAAE;YAC9B,IAAI,CAAC,YAAY,CAAC,QAAgB,CAAC,UAAU,GAAG,mBAAmB,CAAC;SACtE;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAa,EAAE,EAAE;;YAC1C,MAAM,UAAU,GAAG,MAAA,MAAA,MAAA,IAAI,CAAC,YAAY,0CAAE,QAAQ,0CAAE,EAAE,mCAAI,EAAE,CAAC;YACzD,IAAI,QAAa,CAAC;YAClB,QAAQ,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,EAAE;gBACxB,KAAK,6CAAqB,CAAC,YAAY;oBACrC,QAAQ,GAAG,IAAI,yBAAW,CAAC,QAAe,CAAC,CAAC;oBAC3C,QAAgB,CAAC,UAAU,GAAG,UAAU,CAAC;oBAC1C,OAAO,QAAQ,CAAC;gBAClB,KAAK,6CAAqB,CAAC,YAAY;oBACrC,QAAQ,GAAG,IAAI,iCAAe,CAAC,QAAe,CAAC,CAAC;oBAC/C,QAAgB,CAAC,UAAU,GAAG,UAAU,CAAC;oBAC1C,OAAO,QAAQ,CAAC;gBAClB,KAAK,6CAAqB,CAAC,YAAY;oBACrC,QAAQ,GAAG,IAAI,qCAAmB,CAAC,QAAe,CAAC,CAAC;oBACnD,QAAgB,CAAC,UAAU,GAAG,UAAU,CAAC;oBAC1C,OAAO,QAAQ,CAAC;gBAClB;oBACE,QAAQ,GAAG,IAAI,iCAAe,CAAC,QAAe,CAAC,CAAC;oBAC/C,QAAgB,CAAC,UAAU,GAAG,UAAU,CAAC;oBAC1C,OAAO,QAAQ,CAAC;aACnB;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAzCD,gDAyCC;AAE8B,kDAAoB"}

package/dist/models/MessagingPropositionItem.d.ts

@@ -1,5 +1,6 @@
 import { ContentCard } from './ContentCard';
 import { HTMLProposition } from './HTMLProposition';
-import { JSONPropositionItem } from './JSONPropositionItem';
+import { JSONPropositionItem } from './JSONProposition';
 import { InAppMessage } from './InAppMessage';
-export type MessagingPropositionItem = ContentCard | HTMLProposition | InAppMessage | JSONPropositionItem;
+import { PropositionItem } from './PropositionItem';
+export type MessagingPropositionItem = ContentCard | HTMLProposition | InAppMessage | JSONPropositionItem | PropositionItem;

package/dist/models/PropositionItem.d.ts

@@ -0,0 +1,83 @@
+import { PersonalizationSchema } from './PersonalizationSchema';
+import MessagingEdgeEventType from './MessagingEdgeEventType';
+/**
+ * Base PropositionItem interface that all proposition items implement
+ */
+export interface PropositionItemData {
+    id: string;
+    uuid: string;
+    schema: PersonalizationSchema;
+    activityID: string;
+    data: {
+        [key: string]: any;
+    };
+}
+/**
+ * A PropositionItem represents a personalization JSON object returned by Konductor.
+ * This is the base class that provides tracking functionality for all proposition items
+ * including ContentCards, InApp messages, and code-based experiences.
+ *
+ * This mirrors the native Android PropositionItem class functionality.
+ */
+export declare class PropositionItem {
+    id: string;
+    uuid: string;
+    activityID: string;
+    schema: PersonalizationSchema;
+    data: {
+        [key: string]: any;
+    };
+    constructor(propositionItemData: PropositionItemData);
+    /**
+     * Gets the PropositionItem identifier.
+     *
+     * @returns {string} The PropositionItem identifier
+     */
+    getItemId(): string;
+    /**
+     * Gets the PropositionItem content schema.
+     *
+     * @returns {PersonalizationSchema} The PropositionItem content schema
+     */
+    getSchema(): PersonalizationSchema;
+    /**
+     * Gets the PropositionItem data.
+     *
+     * @returns {object} The PropositionItem data
+     */
+    getItemData(): {
+        [key: string]: any;
+    };
+    /**
+     * Tracks interaction with this proposition item.
+     * This is the core tracking method that all proposition items use.
+     *
+     * @param {MessagingEdgeEventType} eventType - The MessagingEdgeEventType specifying event type for the interaction
+     *
+     * @example
+     * propositionItem.track(MessagingEdgeEventType.DISPLAY);
+     */
+    track(eventType: MessagingEdgeEventType): void;
+    /**
+     * Tracks interaction with this proposition item.
+     *
+     * @param {string | null} interaction - String describing the interaction
+     * @param {MessagingEdgeEventType} eventType - The MessagingEdgeEventType specifying event type for the interaction
+     * @param {string[] | null} tokens - Array containing the sub-item tokens for recording interaction
+     *
+     * @example
+     * // Track display
+     * propositionItem.track(null, MessagingEdgeEventType.DISPLAY, null);
+     *
+     * // Track interaction
+     * propositionItem.track("button_clicked", MessagingEdgeEventType.INTERACT, null);
+     *
+     * // Track with tokens
+     * propositionItem.track("click", MessagingEdgeEventType.INTERACT, ["token1", "token2"]);
+     */
+    track(interaction: string | null, eventType: MessagingEdgeEventType, tokens: string[] | null): void;
+    /**
+     * Internal method that performs the actual tracking
+     */
+    private trackWithDetails;
+}

package/dist/models/PropositionItem.js

@@ -0,0 +1,78 @@
+"use strict";
+/*
+    Copyright 2025 Adobe. All rights reserved.
+    This file is licensed to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law
+    or agreed to in writing, software distributed under the License is
+    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF
+    ANY KIND, either express or implied. See the License for the specific
+    language governing permissions and limitations under the License.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropositionItem = void 0;
+const react_native_1 = require("react-native");
+const RCTAEPMessaging = react_native_1.NativeModules.AEPMessaging;
+/**
+ * A PropositionItem represents a personalization JSON object returned by Konductor.
+ * This is the base class that provides tracking functionality for all proposition items
+ * including ContentCards, InApp messages, and code-based experiences.
+ *
+ * This mirrors the native Android PropositionItem class functionality.
+ */
+class PropositionItem {
+    constructor(propositionItemData) {
+        this.id = propositionItemData.id;
+        this.schema = propositionItemData.schema;
+        this.data = propositionItemData.data;
+        this.uuid = propositionItemData.uuid;
+        this.activityID = propositionItemData.activityID;
+    }
+    /**
+     * Gets the PropositionItem identifier.
+     *
+     * @returns {string} The PropositionItem identifier
+     */
+    getItemId() {
+        return this.id;
+    }
+    /**
+     * Gets the PropositionItem content schema.
+     *
+     * @returns {PersonalizationSchema} The PropositionItem content schema
+     */
+    getSchema() {
+        return this.schema;
+    }
+    /**
+     * Gets the PropositionItem data.
+     *
+     * @returns {object} The PropositionItem data
+     */
+    getItemData() {
+        return this.data;
+    }
+    // Implementation
+    track(interactionOrEventType, eventType, tokens) {
+        // Handle overloaded method signatures
+        if (typeof interactionOrEventType === 'number' && eventType === undefined) {
+            // First overload: track(eventType)
+            this.trackWithDetails(null, interactionOrEventType, null);
+        }
+        else if (typeof interactionOrEventType === 'string' || interactionOrEventType === null) {
+            // Second overload: track(interaction, eventType, tokens)
+            this.trackWithDetails(interactionOrEventType, eventType, tokens || null);
+        }
+    }
+    /**
+     * Internal method that performs the actual tracking
+     */
+    trackWithDetails(interaction, eventType, tokens) {
+        var _a;
+        const nativeIdentifier = (_a = this.activityID) !== null && _a !== void 0 ? _a : null;
+        RCTAEPMessaging.trackPropositionItem(nativeIdentifier, interaction, eventType, tokens);
+    }
+}
+exports.PropositionItem = PropositionItem;
+//# sourceMappingURL=PropositionItem.js.map

package/dist/models/PropositionItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropositionItem.js","sourceRoot":"","sources":["../../src/models/PropositionItem.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;EAUE;;;AAEF,+CAA6C;AAI7C,MAAM,eAAe,GAAG,4BAAa,CAAC,YAAY,CAAC;AAenD;;;;;;GAMG;AACH,MAAa,eAAe;IAO1B,YAAY,mBAAwC;QAClD,IAAI,CAAC,EAAE,GAAG,mBAAmB,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAgCD,iBAAiB;IACjB,KAAK,CACH,sBAA8D,EAC9D,SAAkC,EAClC,MAAwB;QAExB,sCAAsC;QACtC,IAAI,OAAO,sBAAsB,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS,EAAE;YACzE,mCAAmC;YACnC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,sBAAsB,EAAE,IAAI,CAAC,CAAC;SAC3D;aAAM,IAAI,OAAO,sBAAsB,KAAK,QAAQ,IAAI,sBAAsB,KAAK,IAAI,EAAE;YACxF,yDAAyD;YACzD,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,SAAU,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;SAC3E;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,WAA0B,EAAE,SAAiC,EAAE,MAAuB;;QAC7G,MAAM,gBAAgB,GAAG,MAAA,IAAI,CAAC,UAAU,mCAAI,IAAI,CAAC;QACjD,eAAe,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACzF,CAAC;CAEF;AAhGD,0CAgGC"}

package/ios/src/RCTAEPMessaging.mm

@@ -55,4 +55,17 @@ RCT_EXTERN_METHOD(trackContentCardInteraction
                   : (NSDictionary *)propositionMap contentCardMap
                   : (NSDictionary *)contentCardMap);
 
+
+RCT_EXTERN_METHOD(handleJavascriptMessage
+                  : (NSString *)messageId handlerName
+                  : (NSString *)handlerName)
+
+RCT_EXTERN_METHOD(trackPropositionItem
+                  : (NSString *)uuid interaction
+                  : (NSString * _Nullable)interaction eventType
+                  : (NSInteger)eventType tokens
+                  : (NSArray<NSString *> * _Nullable)tokens withResolver
+                  : (RCTPromiseResolveBlock)resolve withRejecter
+                  : (RCTPromiseRejectBlock)reject);
+
 @end

package/ios/src/RCTAEPMessaging.swift

@@ -21,6 +21,7 @@ import WebKit
 @objc(RCTAEPMessaging)
 public class RCTAEPMessaging: RCTEventEmitter, MessagingDelegate {
     private var messageCache = [String: Message]()
+    private var jsHandlerMessageCache = [String: Message]()
     private var latestMessage: Message? = nil
     private let semaphore = DispatchSemaphore(value: 0)
     private var shouldSaveMessage = false
@@ -64,7 +65,7 @@ public class RCTAEPMessaging: RCTEventEmitter, MessagingDelegate {
     ) {
         resolve(self.latestMessage != nil ? RCTAEPMessagingDataBridge.transformToMessage(message: self.latestMessage!) : nil)
     }
-
+      
     @objc
     func getPropositionsForSurfaces(
         _ surfaces: [String],
@@ -72,16 +73,29 @@ public class RCTAEPMessaging: RCTEventEmitter, MessagingDelegate {
         withRejecter reject: @escaping RCTPromiseRejectBlock
     ) {
         let surfacePaths = surfaces.map { $0.isEmpty ? Surface() : Surface(path: $0) }
-        Messaging.getPropositionsForSurfaces(surfacePaths) { propositions, error in
+        Messaging.getPropositionsForSurfaces(surfacePaths) { [weak self] propositions, error in
+            guard let self = self else { return }
             guard error == nil else {
                 reject("Unable to Retrieve Propositions", nil, nil)
                 return
             }
-            if (propositions != nil && propositions!.isEmpty) {
-                resolve([String: Any]());
-                return;
+            guard let propositions = propositions, !propositions.isEmpty else {
+                resolve([String: Any]())
+                return
+            }
+
+            // Populate uuid->Proposition map using scopeDetails.activity.id
+            for (_, list) in propositions {
+                for proposition in list {
+                    if let pMap = proposition.asDictionary() {
+                        if let key = RCTAEPMessagingDataBridge.extractActivityId(from: pMap) {
+                            self.propositionByUuid[key] = proposition
+                        }
+                    }
+                }
             }
-            resolve(RCTAEPMessagingDataBridge.transformPropositionDict(dict: propositions!))
+
+            resolve(RCTAEPMessagingDataBridge.transformPropositionDict(dict: propositions))
         }
     }
 
@@ -113,6 +127,7 @@ public class RCTAEPMessaging: RCTEventEmitter, MessagingDelegate {
     ) {
         let mapped = surfaces.map { Surface(path: $0) }
         Messaging.updatePropositionsForSurfaces(mapped)
+        propositionByUuid.removeAll()
         resolve(nil)
     }
 
@@ -249,11 +264,95 @@ public class RCTAEPMessaging: RCTEventEmitter, MessagingDelegate {
         }
     }
 
+    @objc
+    func handleJavascriptMessage(
+        _ messageId: String,
+        handlerName: String
+    ) {
+        guard let message = jsHandlerMessageCache[messageId] else { 
+            print("[RCTAEPMessaging] handleJavascriptMessage: No message found in cache for messageId: \(messageId)")
+            return 
+        }
+
+        message.handleJavascriptMessage(handlerName) { [weak self] content in
+            self?.emitNativeEvent(
+                name: Constants.ON_JAVASCRIPT_MESSAGE_EVENT,
+                body: [
+                    Constants.MESSAGE_ID_KEY: messageId,
+                    Constants.HANDLER_NAME_KEY: handlerName,
+                    Constants.CONTENT_KEY: content ?? ""
+                ]
+            )
+        }
+    }
+
+    /// MARK: - Unified PropositionItem Tracking Methods
+    
+    /**
+     * Tracks interactions with a PropositionItem using the provided interaction and event type.
+     * This method is used by the React Native PropositionItem.track() method.
+     * 
+     * - Parameters:
+     *   - uuid: The UUID mapped to the PropositionItem (derived from activityId)
+     *   - interaction: A custom string value to be recorded in the interaction (optional)
+     *   - eventType: The MessagingEdgeEventType numeric value
+     *   - tokens: Array containing the sub-item tokens for recording interaction (optional)
+     */
+
+    @objc
+    func trackPropositionItem(
+        _ uuid: String,
+        interaction: String?,
+        eventType: Int,
+        tokens: [String]?,
+        withResolver resolve: @escaping RCTPromiseResolveBlock,
+        withRejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        NSLog("[MessagingBridge] trackPropositionItem called with eventType=\(eventType), uuid=\(uuid), interaction=\(String(describing: interaction)), tokens=\(String(describing: tokens))")
+
+        guard !uuid.isEmpty else {
+            NSLog("[MessagingBridge] Empty uuid provided; no-op.")
+            resolve(nil)
+            return
+        }
+
+        guard let proposition = propositionByUuid[uuid] else {
+            NSLog("[MessagingBridge] No cached proposition for uuid=\(uuid); no-op.")
+            resolve(nil)
+            return
+        }
+
+        NSLog("[MessagingBridge] Found proposition for uuid=\(uuid). scope=\(proposition.scope), items=\(proposition.items.count)")
+
+        // Event type mapping (Android parity)
+        let edgeEventType = mapEdgeEventType(eventType) ?? .display
+
+        // Track on the first item under this proposition
+        guard let item = proposition.items.first else {
+            NSLog("[MessagingBridge] Proposition for uuid=\(uuid) has no items; no-op.")
+            resolve(nil)
+            return
+        }
+
+        // Direct call without normalization (expecting valid inputs)
+        NSLog("[MessagingBridge] Tracking (direct) uuid=\(uuid), interaction=\(String(describing: interaction)), tokens=\(String(describing: tokens)), eventType=\(edgeEventType.rawValue)")
+        item.track(interaction, withEdgeEventType: edgeEventType, forTokens: tokens)
+
+        NSLog("[MessagingBridge] Tracking complete for uuid=\(uuid)")
+        resolve(nil)
+    }
+
+
+
+    // Map uuid (scopeDetails.activity.id) -> parent Proposition
+    private var propositionByUuid = [String: Proposition]()
+   
     // Messaging Delegate Methods
     public func onDismiss(message: Showable) {
         if let fullscreenMessage = message as? FullscreenMessage,
             let parentMessage = fullscreenMessage.parent
         {
+            jsHandlerMessageCache.removeValue(forKey: parentMessage.id)
             emitNativeEvent(
                 name: Constants.ON_DISMISS_EVENT,
                 body: RCTAEPMessagingDataBridge.transformToMessage(
@@ -267,6 +366,7 @@ public class RCTAEPMessaging: RCTEventEmitter, MessagingDelegate {
         if let fullscreenMessage = message as? FullscreenMessage,
             let message = fullscreenMessage.parent
         {
+            jsHandlerMessageCache[message.id] = message
             emitNativeEvent(
                 name: Constants.ON_SHOW_EVENT,
                 body: RCTAEPMessagingDataBridge.transformToMessage(message: message)
@@ -328,3 +428,20 @@ public class RCTAEPMessaging: RCTEventEmitter, MessagingDelegate {
         RCTAEPMessaging.emitter.sendEvent(withName: name, body: body)
     }
 }
+
+// MARK: - Private helpers
+private extension RCTAEPMessaging {
+    /// Maps JS MessagingEdgeEventType integer values to AEPMessaging.MessagingEdgeEventType cases
+    /// JS enum values: DISMISS=0, INTERACT=1, TRIGGER=2, DISPLAY=3, PUSH_APPLICATION_OPENED=4, PUSH_CUSTOM_ACTION=5
+    func mapEdgeEventType(_ value: Int) -> MessagingEdgeEventType? {
+        switch value {
+        case 0: return .dismiss
+        case 1: return .interact
+        case 2: return .trigger
+        case 3: return .display
+        case 4: return .pushApplicationOpened
+        case 5: return .pushCustomAction
+        default: return nil
+        }
+    }
+}

package/ios/src/RCTAEPMessagingConstants.swift

@@ -16,7 +16,11 @@ class Constants {
     static let ON_SHOW_EVENT = "onShow"
     static let SHOULD_SHOW_MESSAGE_EVENT = "shouldShowMessage"
     static let URL_LOADED_EVENT = "urlLoaded"
+    static let ON_JAVASCRIPT_MESSAGE_EVENT = "onJavascriptMessage"
     static let SUPPORTED_EVENTS = [
-        ON_DISMISS_EVENT, ON_SHOW_EVENT, SHOULD_SHOW_MESSAGE_EVENT, URL_LOADED_EVENT,
+        ON_DISMISS_EVENT, ON_SHOW_EVENT, SHOULD_SHOW_MESSAGE_EVENT, URL_LOADED_EVENT, ON_JAVASCRIPT_MESSAGE_EVENT
     ]
+    static let MESSAGE_ID_KEY = "messageId"
+    static let HANDLER_NAME_KEY = "handlerName"
+    static let CONTENT_KEY = "content"
 }

package/ios/src/RCTAEPMessagingDataBridge.swift

@@ -27,4 +27,23 @@ public class RCTAEPMessagingDataBridge: NSObject {
                 .map({ $0.asDictionary() })
         }
     }
+
+    /// Extracts the activity identifier from a proposition dictionary at scopeDetails.activity.id
+    static func extractActivityId(from propositionDict: [String: Any]) -> String? {
+        guard let scopeDetails = propositionDict["scopeDetails"] as? [String: Any] else {
+            NSLog("[MessagingBridge] Missing scopeDetails on proposition; cannot extract activity.id")
+            return nil
+        }
+
+        guard let activity = scopeDetails["activity"] as? [String: Any] else {
+            NSLog("[MessagingBridge] Missing activity under scopeDetails; cannot extract activity.id")
+            return nil
+        }
+
+        guard let id = activity["id"] as? String, !id.isEmpty else {
+            NSLog("[MessagingBridge] Missing or empty activity.id; skipping uuid cache mapping")
+            return nil
+        }
+        return id
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/react-native-aepmessaging",
-  "version": "7.1.1",
+  "version": "7.2.0",
   "description": "Adobe Experience Platform support for React Native apps.",
   "homepage": "https://developer.adobe.com/client-sdks/documentation/",
   "license": "Apache-2.0",
@@ -39,5 +39,5 @@
   "installConfig": {
     "hoistingLimits": "dependencies"
   },
-  "gitHead": "2e43601ac53a6982a643ff43d5af8276c675bf29"
+  "gitHead": "1784c9a89b5938021ab0f1f42bd7fa1a6caf1d54"
 }