@mparticle/web-sdk 2.67.0 → 2.69.0

package/dist/types/src/types.d.ts

@@ -53,8 +53,31 @@ export declare const ProductActionType: {
     Refund: 8;
     AddToWishlist: 9;
     RemoveFromWishlist: 10;
+    ViewCart: 11;
+    AddShippingInfo: 12;
+    AddPaymentInfo: 13;
+    PaymentMethodSelected: 14;
+    PaymentAttempted: 15;
+    PaymentSucceeded: 16;
+    PaymentFailed: 17;
+    RefundInitiated: 18;
+    isRoktCommerceType: (id: number) => boolean;
     getName: (id: number) => string;
-    getExpansionName: (id: number) => "add_to_cart" | "remove_from_cart" | "checkout" | "checkout_option" | "click" | "view_detail" | "purchase" | "refund" | "add_to_wishlist" | "remove_from_wishlist" | "unknown";
+    getExpansionName: (id: number) => "add_to_cart" | "remove_from_cart" | "checkout" | "checkout_option" | "click" | "view_detail" | "purchase" | "refund" | "add_to_wishlist" | "remove_from_wishlist" | "view_cart" | "add_shipping_info" | "add_payment_info" | "payment_method_selected" | "payment_attempted" | "payment_succeeded" | "payment_failed" | "refund_initiated" | "unknown";
+};
+export type RoktEventName = 'sign_up' | 'subscribe' | 'start_trial' | 'generate_lead' | 'search' | 'upsell' | 'earn_virtual_currency' | 'dwell_time' | 'hover' | 'scroll' | 'click_to_expand' | (string & {});
+export declare const RoktEvents: {
+    SignUp: "sign_up";
+    Subscribe: "subscribe";
+    StartTrial: "start_trial";
+    GenerateLead: "generate_lead";
+    Search: "search";
+    Upsell: "upsell";
+    EarnVirtualCurrency: "earn_virtual_currency";
+    DwellTime: "dwell_time";
+    Hover: "hover";
+    Scroll: "scroll";
+    ClickToExpand: "click_to_expand";
 };
 export declare const PromotionActionType: {
     Unknown: 0;
@@ -139,8 +162,17 @@ declare const _default: {
         Refund: 8;
         AddToWishlist: 9;
         RemoveFromWishlist: 10;
+        ViewCart: 11;
+        AddShippingInfo: 12;
+        AddPaymentInfo: 13;
+        PaymentMethodSelected: 14;
+        PaymentAttempted: 15;
+        PaymentSucceeded: 16;
+        PaymentFailed: 17;
+        RefundInitiated: 18;
+        isRoktCommerceType: (id: number) => boolean;
         getName: (id: number) => string;
-        getExpansionName: (id: number) => "add_to_cart" | "remove_from_cart" | "checkout" | "checkout_option" | "click" | "view_detail" | "purchase" | "refund" | "add_to_wishlist" | "remove_from_wishlist" | "unknown";
+        getExpansionName: (id: number) => "add_to_cart" | "remove_from_cart" | "checkout" | "checkout_option" | "click" | "view_detail" | "purchase" | "refund" | "add_to_wishlist" | "remove_from_wishlist" | "view_cart" | "add_shipping_info" | "add_payment_info" | "payment_method_selected" | "payment_attempted" | "payment_succeeded" | "payment_failed" | "refund_initiated" | "unknown";
     };
     readonly PromotionActionType: {
         Unknown: 0;
@@ -149,6 +181,19 @@ declare const _default: {
         getName: (id: number) => string;
         getExpansionName: (id: number) => string;
     };
+    readonly RoktEvents: {
+        SignUp: "sign_up";
+        Subscribe: "subscribe";
+        StartTrial: "start_trial";
+        GenerateLead: "generate_lead";
+        Search: "search";
+        Upsell: "upsell";
+        EarnVirtualCurrency: "earn_virtual_currency";
+        DwellTime: "dwell_time";
+        Hover: "hover";
+        Scroll: "scroll";
+        ClickToExpand: "click_to_expand";
+    };
     readonly Environment: {
         readonly Development: "development";
         readonly Production: "production";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mparticle/web-sdk",
-    "version": "2.67.0",
+    "version": "2.69.0",
     "description": "mParticle core SDK for web applications",
     "license": "Apache-2.0",
     "keywords": [
@@ -118,7 +118,7 @@
         "@types/jest": "^29.5.1",
         "@types/jest-expect-message": "^1.1.0",
         "@types/mocha": "^9.0.0",
-        "@types/mparticle__web-sdk": "^2.16.1",
+        "@types/mparticle__web-sdk": "^2.66.0",
         "@types/node": "^20.1.0",
         "babel-preset-minify": "^0.5.1",
         "browser-sync": "^2.26.3",

package/src/consent.ts

@@ -9,6 +9,7 @@ import KitFilterHelper from './kitFilterHelper';
 import Constants from './constants';
 import { IMParticleUser } from './identity-user-interfaces';
 import { IMParticleWebSDKInstance } from './mp-instance';
+import { logDeprecatedMethodUsage } from './reporting/deprecatedMethodLogger';
 
 const { CCPAPurpose } = Constants;
 
@@ -505,8 +506,13 @@ export default function Consent(this: IConsent, mpInstance: IMParticleWebSDKInst
 
         // TODO: Can we remove this? It is deprecated.
         function removeCCPAState(this: ConsentState) {
-            mpInstance.Logger.warning(
-                'removeCCPAState is deprecated and will be removed in a future release; use removeCCPAConsentState instead'
+            logDeprecatedMethodUsage(
+                {
+                    methodName: 'Consent.removeCCPAState',
+                    warningMessage: 'removeCCPAState is deprecated and will be removed in a future release; use removeCCPAConsentState instead',
+                },
+                mpInstance.Logger,
+                mpInstance._LoggingDispatcher
             );
             // @ts-ignore
             return removeCCPAConsentState();

package/src/ecommerce.js

@@ -69,6 +69,22 @@ export default function Ecommerce(mpInstance) {
                 return 'RemoveFromWishlist';
             case Types.ProductActionType.ViewDetail:
                 return 'ViewDetail';
+            case Types.ProductActionType.ViewCart:
+                return 'ViewCart';
+            case Types.ProductActionType.AddShippingInfo:
+                return 'AddShippingInfo';
+            case Types.ProductActionType.AddPaymentInfo:
+                return 'AddPaymentInfo';
+            case Types.ProductActionType.PaymentMethodSelected:
+                return 'PaymentMethodSelected';
+            case Types.ProductActionType.PaymentAttempted:
+                return 'PaymentAttempted';
+            case Types.ProductActionType.PaymentSucceeded:
+                return 'PaymentSucceeded';
+            case Types.ProductActionType.PaymentFailed:
+                return 'PaymentFailed';
+            case Types.ProductActionType.RefundInitiated:
+                return 'RefundInitiated';
             case Types.ProductActionType.Unknown:
             default:
                 return 'Unknown';
@@ -113,6 +129,18 @@ export default function Ecommerce(mpInstance) {
 
             case Types.ProductActionType.ViewDetail:
                 return Types.CommerceEventType.ProductViewDetail;
+
+            // Rokt Brain commerce-adjacent types map to Unknown on server
+            case Types.ProductActionType.ViewCart:
+            case Types.ProductActionType.AddShippingInfo:
+            case Types.ProductActionType.AddPaymentInfo:
+            case Types.ProductActionType.PaymentMethodSelected:
+            case Types.ProductActionType.PaymentAttempted:
+            case Types.ProductActionType.PaymentSucceeded:
+            case Types.ProductActionType.PaymentFailed:
+            case Types.ProductActionType.RefundInitiated:
+                return Types.EventType.Unknown;
+
             default:
                 mpInstance.Logger.error(
                     'Could not convert product action type ' +

package/src/events.js

@@ -174,6 +174,13 @@ export default function Events(mpInstance) {
                 ProductList: productList,
             };
 
+            if (Types.ProductActionType.isRoktCommerceType(productActionType)) {
+                event.CustomFlags = event.CustomFlags || {};
+                event.CustomFlags[
+                    'Rokt.CommerceEventType'
+                ] = Types.ProductActionType.getExpansionName(productActionType);
+            }
+
             if (mpInstance._Helpers.isObject(transactionAttributes)) {
                 mpInstance._Ecommerce.convertTransactionAttributesToProductAction(
                     transactionAttributes,

package/src/identity-utils.ts

@@ -289,6 +289,48 @@ const getExpireTimestamp = (maxAge: number = ONE_DAY_IN_SECONDS): number =>
 const parseIdentityResponse = (responseText: string): IdentityResultBody =>
     responseText ? JSON.parse(responseText) : ({} as IdentityResultBody);
 
+type Sha256IdentityAlias = 'email_sha256' | 'mobile_sha256';
+
+const SHA256_IDENTITY_ALIASES: Readonly<
+    Record<Sha256IdentityAlias, keyof UserIdentities>
+> = {
+    email_sha256: 'other',
+    mobile_sha256: 'other2',
+};
+
+type UserIdentitiesWithAliases = UserIdentities &
+    Partial<Record<Sha256IdentityAlias, string | null>>;
+
+export const normalizeUserIdentityKeys = (
+    userIdentities: UserIdentitiesWithAliases
+): UserIdentities => {
+    const normalized: UserIdentitiesWithAliases = { ...userIdentities };
+    (Object.keys(SHA256_IDENTITY_ALIASES) as Sha256IdentityAlias[]).forEach(
+        (alias) => {
+            if (alias in normalized) {
+                const value = normalized[alias];
+                delete normalized[alias];
+                normalized[SHA256_IDENTITY_ALIASES[alias]] = value;
+            }
+        }
+    );
+    return normalized;
+};
+
+// Compare two identity objects by key and value, independent of
+// object key insertion order. The two sides come from different sources
+// (numeric IdentityType iteration vs. partner-provided / alias-normalized
+// order)
+const identitiesEqual = (
+    a?: UserIdentities,
+    b?: UserIdentities
+): boolean => {
+    const aKeys = Object.keys(a ?? {});
+    const bKeys = Object.keys(b ?? {});
+    if (aKeys.length !== bKeys.length) return false;
+    return aKeys.every((key) => a[key] === b[key]);
+};
+
 export const hasIdentityRequestChanged = (
     currentUser: IMParticleUser,
     newIdentityRequest: IdentityApiData
@@ -300,11 +342,11 @@ export const hasIdentityRequestChanged = (
     const currentUserIdentities =
         currentUser.getUserIdentities().userIdentities;
 
-    const newIdentities = newIdentityRequest.userIdentities;
-
-    return (
-        JSON.stringify(currentUserIdentities) !== JSON.stringify(newIdentities)
+    const newIdentities = normalizeUserIdentityKeys(
+        newIdentityRequest.userIdentities
     );
+
+    return !identitiesEqual(currentUserIdentities, newIdentities);
 };
 
 /**

package/src/identity.js

@@ -4,6 +4,7 @@ import {
     cacheOrClearIdCache,
     createKnownIdentities,
     executeSearchRequest,
+    normalizeUserIdentityKeys,
     tryCacheIdentity,
 } from './identity-utils';
 import AudienceManager from './audienceManager';
@@ -19,6 +20,7 @@ import {
 } from './utils';
 import { hasMPIDAndUserLoginChanged, hasMPIDChanged } from './user-utils';
 import { processReadyQueue } from './pre-init-utils';
+import { logDeprecatedMethodUsage } from './reporting/deprecatedMethodLogger';
 
 export default function Identity(mpInstance) {
     const { getFeatureFlag, extend } = mpInstance._Helpers;
@@ -35,11 +37,21 @@ export default function Identity(mpInstance) {
             );
 
             // First, remove any falsy identity values and warn about them
-            const cleanedIdentityApiData = mpInstance._Helpers.Validators.removeFalsyIdentityValues(
+            const removedFalsyIdentityData = mpInstance._Helpers.Validators.removeFalsyIdentityValues(
                 identityApiData,
                 mpInstance.Logger
             );
 
+            // Normalize convenience aliases (email_sha256 → other, mobile_sha256 → other2)
+            const cleanedIdentityApiData = removedFalsyIdentityData?.userIdentities
+                ? {
+                      ...removedFalsyIdentityData,
+                      userIdentities: normalizeUserIdentityKeys(
+                          removedFalsyIdentityData.userIdentities
+                      ),
+                  }
+                : removedFalsyIdentityData;
+
             var identityValidationResult = mpInstance._Helpers.Validators.validateIdentities(
                 cleanedIdentityApiData,
                 method
@@ -1241,8 +1253,14 @@ export default function Identity(mpInstance) {
              * @return a cart object
              */
             getCart: function() {
-                mpInstance.Logger.warning(
-                    'Deprecated function Identity.getCurrentUser().getCart() will be removed in future releases'
+                logDeprecatedMethodUsage(
+                    {
+                        methodName: 'Identity.getCurrentUser().getCart()',
+                        warningMessage:
+                            'Deprecated function Identity.getCurrentUser().getCart() will be removed in future releases',
+                    },
+                    mpInstance.Logger,
+                    mpInstance._LoggingDispatcher
                 );
                 return self.mParticleUserCart();
             },
@@ -1323,13 +1341,18 @@ export default function Identity(mpInstance) {
              * @deprecated
              */
             add: function() {
-                mpInstance.Logger.warning(
-                    generateDeprecationMessage(
-                        'Identity.getCurrentUser().getCart().add()',
-                        true,
-                        'eCommerce.logProductAction()',
-                        'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
-                    )
+                logDeprecatedMethodUsage(
+                    {
+                        methodName: 'Identity.getCurrentUser().getCart().add()',
+                        warningMessage: generateDeprecationMessage(
+                            'Identity.getCurrentUser().getCart().add()',
+                            true,
+                            'eCommerce.logProductAction()',
+                            'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
+                        ),
+                    },
+                    mpInstance.Logger,
+                    mpInstance._LoggingDispatcher
                 );
             },
             /**
@@ -1338,13 +1361,19 @@ export default function Identity(mpInstance) {
              * @deprecated
              */
             remove: function() {
-                mpInstance.Logger.warning(
-                    generateDeprecationMessage(
-                        'Identity.getCurrentUser().getCart().remove()',
-                        true,
-                        'eCommerce.logProductAction()',
-                        'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
-                    )
+                logDeprecatedMethodUsage(
+                    {
+                        methodName:
+                            'Identity.getCurrentUser().getCart().remove()',
+                        warningMessage: generateDeprecationMessage(
+                            'Identity.getCurrentUser().getCart().remove()',
+                            true,
+                            'eCommerce.logProductAction()',
+                            'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
+                        ),
+                    },
+                    mpInstance.Logger,
+                    mpInstance._LoggingDispatcher
                 );
             },
             /**
@@ -1353,13 +1382,19 @@ export default function Identity(mpInstance) {
              * @deprecated
              */
             clear: function() {
-                mpInstance.Logger.warning(
-                    generateDeprecationMessage(
-                        'Identity.getCurrentUser().getCart().clear()',
-                        true,
-                        '',
-                        'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
-                    )
+                logDeprecatedMethodUsage(
+                    {
+                        methodName:
+                            'Identity.getCurrentUser().getCart().clear()',
+                        warningMessage: generateDeprecationMessage(
+                            'Identity.getCurrentUser().getCart().clear()',
+                            true,
+                            '',
+                            'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
+                        ),
+                    },
+                    mpInstance.Logger,
+                    mpInstance._LoggingDispatcher
                 );
             },
             /**
@@ -1369,13 +1404,19 @@ export default function Identity(mpInstance) {
              * @deprecated
              */
             getCartProducts: function() {
-                mpInstance.Logger.warning(
-                    generateDeprecationMessage(
-                        'Identity.getCurrentUser().getCart().getCartProducts()',
-                        true,
-                        'eCommerce.logProductAction()',
-                        'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
-                    )
+                logDeprecatedMethodUsage(
+                    {
+                        methodName:
+                            'Identity.getCurrentUser().getCart().getCartProducts()',
+                        warningMessage: generateDeprecationMessage(
+                            'Identity.getCurrentUser().getCart().getCartProducts()',
+                            true,
+                            'eCommerce.logProductAction()',
+                            'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
+                        ),
+                    },
+                    mpInstance.Logger,
+                    mpInstance._LoggingDispatcher
                 );
                 return [];
             },
@@ -1529,7 +1570,8 @@ export default function Identity(mpInstance) {
                     prevUser,
                     newUser,
                     identityApiData,
-                    mpInstance.Logger
+                    mpInstance.Logger,
+                    mpInstance._LoggingDispatcher
                 );
 
                 const persistence = mpInstance._Persistence.getPersistence();
@@ -1764,14 +1806,27 @@ export default function Identity(mpInstance) {
 }
 
 // https://go.mparticle.com/work/SQDSDKS-6359
-function tryOnUserAlias(previousUser, newUser, identityApiData, logger) {
+function tryOnUserAlias(
+    previousUser,
+    newUser,
+    identityApiData,
+    logger,
+    loggingDispatcher
+) {
     if (
         identityApiData &&
         identityApiData.onUserAlias &&
         isFunction(identityApiData.onUserAlias)
     ) {
         try {
-            logger.warning(generateDeprecationMessage('onUserAlias'));
+            logDeprecatedMethodUsage(
+                {
+                    methodName: 'onUserAlias',
+                    warningMessage: generateDeprecationMessage('onUserAlias'),
+                },
+                logger,
+                loggingDispatcher
+            );
             identityApiData.onUserAlias(previousUser, newUser);
         } catch (e) {
             logger.error(

package/src/mp-instance.ts

@@ -16,7 +16,7 @@
 //  Uses portions of code from jQuery
 //  jQuery v1.10.2 | (c) 2005, 2013 jQuery Foundation, Inc. | jquery.org/license
 
-import { EventType, IdentityType, CommerceEventType, PromotionActionType, ProductActionType, MessageType } from './types';
+import { EventType, IdentityType, CommerceEventType, PromotionActionType, ProductActionType, MessageType, RoktEvents } from './types';
 import Constants from './constants';
 import APIClient, { IAPIClient } from './apiClient';
 import Helpers from './helpers';
@@ -55,6 +55,7 @@ import CookieConsentManager, { ICookieConsentManager } from './cookieConsentMana
 import { ErrorReportingDispatcher } from './reporting/errorReportingDispatcher';
 import { LoggingDispatcher } from './reporting/loggingDispatcher';
 import { IErrorReportingService, ILoggingService } from './reporting/types';
+import { logDeprecatedMethodUsage } from './reporting/deprecatedMethodLogger';
 
 export interface IErrorLogMessage {
     message?: string;
@@ -187,6 +188,7 @@ export default function mParticleInstance(this: IMParticleWebSDKInstance, instan
     this.CommerceEventType = CommerceEventType;
     this.PromotionType = PromotionActionType;
     this.ProductActionType = ProductActionType;
+    this.RoktEvents = RoktEvents;
 
 
     this._Identity = new Identity(this);
@@ -772,13 +774,18 @@ export default function mParticleInstance(this: IMParticleWebSDKInstance, instan
              * @deprecated
              */
             add: function(product, logEventBoolean) {
-                self.Logger.warning(
-                    generateDeprecationMessage(
-                        'eCommerce.Cart.add()',
-                        true,
-                        'eCommerce.logProductAction()',
-                        'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
-                    )
+                logDeprecatedMethodUsage(
+                    {
+                        methodName: 'mPInstance.eCommerce.Cart.add()',
+                        warningMessage: generateDeprecationMessage(
+                            'eCommerce.Cart.add()',
+                            true,
+                            'eCommerce.logProductAction()',
+                            'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
+                        ),
+                    },
+                    self.Logger,
+                    self._LoggingDispatcher
                 );
             },
             /**
@@ -789,13 +796,18 @@ export default function mParticleInstance(this: IMParticleWebSDKInstance, instan
              * @deprecated
              */
             remove: function(product, logEventBoolean) {
-                self.Logger.warning(
-                    generateDeprecationMessage(
-                        'eCommerce.Cart.remove()',
-                        true,
-                        'eCommerce.logProductAction()',
-                        'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
-                    )
+                logDeprecatedMethodUsage(
+                    {
+                        methodName: 'mPInstance.eCommerce.Cart.remove()',
+                        warningMessage: generateDeprecationMessage(
+                            'eCommerce.Cart.remove()',
+                            true,
+                            'eCommerce.logProductAction()',
+                            'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
+                        ),
+                    },
+                    self.Logger,
+                    self._LoggingDispatcher
                 );
             },
             /**
@@ -804,13 +816,18 @@ export default function mParticleInstance(this: IMParticleWebSDKInstance, instan
              * @deprecated
              */
             clear: function() {
-                self.Logger.warning(
-                    generateDeprecationMessage(
-                        'eCommerce.Cart.clear()',
-                        true,
-                        '',
-                        'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
-                    )
+                logDeprecatedMethodUsage(
+                    {
+                        methodName: 'mPInstance.eCommerce.Cart.clear()',
+                        warningMessage: generateDeprecationMessage(
+                            'eCommerce.Cart.clear()',
+                            true,
+                            '',
+                            'https://docs.mparticle.com/developers/sdk/web/commerce-tracking'
+                        ),
+                    },
+                    self.Logger,
+                    self._LoggingDispatcher
                 );
             },
         },
@@ -940,8 +957,13 @@ export default function mParticleInstance(this: IMParticleWebSDKInstance, instan
          * @deprecated
          */
         logCheckout: function(step, option, attrs, customFlags) {
-            self.Logger.warning(
-                'mParticle.logCheckout is deprecated, please use mParticle.logProductAction instead'
+            logDeprecatedMethodUsage(
+                {
+                    methodName: 'mParticle.logCheckout',
+                    warningMessage: 'mParticle.logCheckout is deprecated, please use mParticle.logProductAction instead',
+                },
+                self.Logger,
+                self._LoggingDispatcher
             );
 
             if (!self._Store.isInitialized) {
@@ -1020,8 +1042,13 @@ export default function mParticleInstance(this: IMParticleWebSDKInstance, instan
             attrs,
             customFlags
         ) {
-            self.Logger.warning(
-                'mParticle.logPurchase is deprecated, please use mParticle.logProductAction instead'
+            logDeprecatedMethodUsage(
+                {
+                    methodName: 'mParticle.logPurchase',
+                    warningMessage: 'mParticle.logPurchase is deprecated, please use mParticle.logProductAction instead',
+                },
+                self.Logger,
+                self._LoggingDispatcher
             );
             if (!self._Store.isInitialized) {
                 self.ready(function() {
@@ -1132,8 +1159,13 @@ export default function mParticleInstance(this: IMParticleWebSDKInstance, instan
             attrs,
             customFlags
         ) {
-            self.Logger.warning(
-                'mParticle.logRefund is deprecated, please use mParticle.logProductAction instead'
+            logDeprecatedMethodUsage(
+                {
+                    methodName: 'mParticle.logRefund',
+                    warningMessage: 'mParticle.logRefund is deprecated, please use mParticle.logProductAction instead',
+                },
+                self.Logger,
+                self._LoggingDispatcher
             );
             if (!self._Store.isInitialized) {
                 self.ready(function() {
@@ -1741,4 +1773,3 @@ function queueIfNotInitialized(func, self) {
     });
     return true;
 }
-

package/src/mparticle-instance-manager.ts

@@ -1,5 +1,5 @@
 import Polyfill from './polyfill';
-import { CommerceEventType, EventType, IdentityType, PerformanceMarkType, ProductActionType, PromotionActionType } from './types';
+import { CommerceEventType, EventType, IdentityType, PerformanceMarkType, ProductActionType, PromotionActionType, RoktEvents } from './types';
 import Constants from './constants';
 import mParticleInstance, { IMParticleWebSDKInstance } from './mp-instance.js';
 import _BatchValidator from './mockBatchCreator';
@@ -36,6 +36,7 @@ function mParticleInstanceManager(this: IMParticleInstanceManager) {
     this.CommerceEventType = CommerceEventType;
     this.PromotionType = PromotionActionType;
     this.ProductActionType = ProductActionType;
+    this.RoktEvents = RoktEvents;
 
     this.MPSideloadedKit = MPSideloadedKit;
 

package/src/public-types.ts

@@ -27,6 +27,8 @@ export type {
     ProductActionType,
     PromotionActionType,
     MessageType,
+    RoktEventName,
+    RoktEvents,
 } from './types';
 
 // Configuration

package/src/reporting/deprecatedMethodLogger.ts

@@ -0,0 +1,19 @@
+import { ErrorCodes, ILoggingService } from './types';
+import { SDKLoggerApi } from '../sdkRuntimeModels';
+
+interface DeprecatedMethodUsage {
+    methodName: string;
+    warningMessage: string;
+}
+
+export function logDeprecatedMethodUsage(
+    usage: DeprecatedMethodUsage,
+    logger: Pick<SDKLoggerApi, 'warning'>,
+    loggingDispatcher: ILoggingService | undefined
+): void {
+    logger.warning(usage.warningMessage);
+    loggingDispatcher?.log({
+        message: usage.methodName,
+        code: ErrorCodes.MP_DEPRECATED_METHOD_USAGE,
+    });
+}

package/src/reporting/types.ts

@@ -6,6 +6,7 @@ export const ErrorCodes = {
     IDENTITY_REQUEST: 'IDENTITY_REQUEST',
     IDENTITY_MISMATCH: 'IDENTITY_MISMATCH',
     ROKT_KIT_ATTACHED: 'ROKT_KIT_ATTACHED',
+    MP_DEPRECATED_METHOD_USAGE: 'MP_DEPRECATED_METHOD_USAGE',
 } as const;
 
 export type ErrorCodes = valueof<typeof ErrorCodes>;