refactor: migrate MPConvertJS to objc

Author: nickolas-dimitrakas

UnitTests/ObjCTests/MPConvertJSTests.m

@@ -1,7 +1,7 @@
 #import <XCTest/XCTest.h>
 #import "mParticle.h"
 #import "MPBaseTestCase.h"
-#import "MParticleSwift.h"
+#import "MPConvertJS.h"
 
 @interface MPConvertJSTests : MPBaseTestCase
 

mParticle-Apple-SDK.xcodeproj/project.pbxproj

@@ -257,6 +257,8 @@
 		7231B8552EB9652C001565E5 /* MParticlePushNotificationTokenTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7231B8542EB9652C001565E5 /* MParticlePushNotificationTokenTests.swift */; };
 		7231B8582EB96598001565E5 /* MParticleRemoteNotificationTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7231B8572EB96598001565E5 /* MParticleRemoteNotificationTests.swift */; };
 		7231B85E2EB96D88001565E5 /* MParticleBackendControllerDelegateTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7231B85C2EB96D88001565E5 /* MParticleBackendControllerDelegateTests.swift */; };
+		72528B292F2C118F00AAABCF /* MPConvertJS.h in Headers */ = {isa = PBXBuildFile; fileRef = 72528B282F2C118F00AAABCF /* MPConvertJS.h */; };
+		72528B2B2F2C119E00AAABCF /* MPConvertJS.m in Sources */ = {isa = PBXBuildFile; fileRef = 72528B2A2F2C119E00AAABCF /* MPConvertJS.m */; };
 		727801DE2EB0FE8400BDAD98 /* MPNotificationControllerMock.swift in Sources */ = {isa = PBXBuildFile; fileRef = 727801DD2EB0FE8400BDAD98 /* MPNotificationControllerMock.swift */; };
 		727801E12EB0FECA00BDAD98 /* AppEnvironmentProviderMock.swift in Sources */ = {isa = PBXBuildFile; fileRef = 727801E02EB0FECA00BDAD98 /* AppEnvironmentProviderMock.swift */; };
 		727801E42EB1131B00BDAD98 /* MPAppNotificationHandlerMock.swift in Sources */ = {isa = PBXBuildFile; fileRef = 727801E32EB1131B00BDAD98 /* MPAppNotificationHandlerMock.swift */; };
@@ -282,7 +284,6 @@
 		D3CEDABC2C9B14BF001B32DF /* MPCCPAConsent.swift in Sources */ = {isa = PBXBuildFile; fileRef = D3CEDAB82C9B14BF001B32DF /* MPCCPAConsent.swift */; };
 		D3CEDABF2C9C5B5B001B32DF /* MPGDPRConsent.swift in Sources */ = {isa = PBXBuildFile; fileRef = D3CEDABD2C9C5B5B001B32DF /* MPGDPRConsent.swift */; };
 		D3CEDAC12C9C5B5B001B32DF /* MPGDPRConsent.swift in Sources */ = {isa = PBXBuildFile; fileRef = D3CEDABD2C9C5B5B001B32DF /* MPGDPRConsent.swift */; };
-		D3CEDACC2CB027E1001B32DF /* MPConvertJS.swift in Sources */ = {isa = PBXBuildFile; fileRef = D3CEDACA2CB027E1001B32DF /* MPConvertJS.swift */; };
 		D3DE316C2D5261FC00CC537F /* MPDevice.swift in Sources */ = {isa = PBXBuildFile; fileRef = D3DE316A2D5261F700CC537F /* MPDevice.swift */; };
 /* End PBXBuildFile section */
 
@@ -588,6 +589,8 @@
 		7231B8542EB9652C001565E5 /* MParticlePushNotificationTokenTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MParticlePushNotificationTokenTests.swift; sourceTree = "<group>"; };
 		7231B8572EB96598001565E5 /* MParticleRemoteNotificationTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MParticleRemoteNotificationTests.swift; sourceTree = "<group>"; };
 		7231B85C2EB96D88001565E5 /* MParticleBackendControllerDelegateTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MParticleBackendControllerDelegateTests.swift; sourceTree = "<group>"; };
+		72528B282F2C118F00AAABCF /* MPConvertJS.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = MPConvertJS.h; sourceTree = "<group>"; };
+		72528B2A2F2C119E00AAABCF /* MPConvertJS.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = MPConvertJS.m; sourceTree = "<group>"; };
 		727801DD2EB0FE8400BDAD98 /* MPNotificationControllerMock.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MPNotificationControllerMock.swift; sourceTree = "<group>"; };
 		727801E02EB0FECA00BDAD98 /* AppEnvironmentProviderMock.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppEnvironmentProviderMock.swift; sourceTree = "<group>"; };
 		727801E32EB1131B00BDAD98 /* MPAppNotificationHandlerMock.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MPAppNotificationHandlerMock.swift; sourceTree = "<group>"; };
@@ -613,7 +616,6 @@
 		D3BA75152B614E3D008C3C65 /* PrivacyInfo.xcprivacy */ = {isa = PBXFileReference; lastKnownFileType = text.xml; path = PrivacyInfo.xcprivacy; sourceTree = "<group>"; };
 		D3CEDAB82C9B14BF001B32DF /* MPCCPAConsent.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MPCCPAConsent.swift; sourceTree = "<group>"; };
 		D3CEDABD2C9C5B5B001B32DF /* MPGDPRConsent.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MPGDPRConsent.swift; sourceTree = "<group>"; };
-		D3CEDACA2CB027E1001B32DF /* MPConvertJS.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MPConvertJS.swift; sourceTree = "<group>"; };
 		D3DE316A2D5261F700CC537F /* MPDevice.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MPDevice.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
@@ -897,7 +899,8 @@
 				D34286082D3806CF00FEC2C8 /* MPUserDefaults.swift */,
 				D342860E2D419CA700FEC2C8 /* MPUploadSettings.swift */,
 				53A79B0229CDFB1F00E7489F /* MPMessageBuilder.m */,
-				D3CEDACA2CB027E1001B32DF /* MPConvertJS.swift */,
+				72528B282F2C118F00AAABCF /* MPConvertJS.h */,
+				72528B2A2F2C119E00AAABCF /* MPConvertJS.m */,
 				53A79B0929CDFB1F00E7489F /* NSDictionary+MPCaseInsensitive.m */,
 				D356E0232CFE08ED0020898D /* MPResponseConfig.swift */,
 				53A79B0D29CDFB1F00E7489F /* MPApplication.m */,
@@ -1238,6 +1241,7 @@
 				53A79D2329CE23F700E7489F /* MPTransactionAttributes+Dictionary.h in Headers */,
 				D33C8B342B8510C20012EDFD /* MPAudience.h in Headers */,
 				53A79D2729CE23F700E7489F /* MPApplication.h in Headers */,
+				72528B292F2C118F00AAABCF /* MPConvertJS.h in Headers */,
 				53A79D2829CE23F700E7489F /* MPCustomModulePreference.h in Headers */,
 				53A79D2929CE23F700E7489F /* MPDataModelProtocol.h in Headers */,
 				53A79D2C29CE23F700E7489F /* MPIConstants.h in Headers */,
@@ -1592,7 +1596,6 @@
 				53A79D7629CE23F700E7489F /* MPConsumerInfo.m in Sources */,
 				53A79D7729CE23F700E7489F /* MPKitConfiguration.m in Sources */,
 				53A79D7829CE23F700E7489F /* MPConsentState.m in Sources */,
-				D3CEDACC2CB027E1001B32DF /* MPConvertJS.swift in Sources */,
 				53A79D7929CE23F700E7489F /* MPBracket.m in Sources */,
 				53A79D7A29CE23F700E7489F /* MParticleUserNotification.m in Sources */,
 				531BCF372B28A23400F5C573 /* MPIdentityCaching.m in Sources */,
@@ -1606,6 +1609,7 @@
 				53A79D8429CE23F700E7489F /* MPIdentityApi.m in Sources */,
 				53A79D8629CE23F700E7489F /* MPUpload.m in Sources */,
 				D3CEDABA2C9B14BF001B32DF /* MPCCPAConsent.swift in Sources */,
+				72528B2B2F2C119E00AAABCF /* MPConvertJS.m in Sources */,
 				53A79D8829CE23F700E7489F /* MPApplication.m in Sources */,
 				53A79D8A29CE23F700E7489F /* MPCustomModule.m in Sources */,
 				53A79D8C29CE23F700E7489F /* MPKitActivity.m in Sources */,

mParticle-Apple-SDK/Utils/MPConvertJS.h

@@ -0,0 +1,86 @@
+#import <Foundation/Foundation.h>
+#import "MPCommerceEvent.h"
+
+@class MPProduct;
+@class MPPromotion;
+@class MPTransactionAttributes;
+@class MPPromotionContainer;
+@class MPIdentityApiRequest;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * JavaScript Commerce Event Action types
+ * These map to the action types sent from the WebView JavaScript bridge
+ */
+typedef NS_ENUM(NSUInteger, MPJSCommerceEventAction) {
+    MPJSCommerceEventActionUnknown = 0,
+    MPJSCommerceEventActionAddToCart = 1,
+    MPJSCommerceEventActionRemoveFromCart = 2,
+    MPJSCommerceEventActionCheckout = 3,
+    MPJSCommerceEventActionCheckoutOptions = 4,
+    MPJSCommerceEventActionClick = 5,
+    MPJSCommerceEventActionViewDetail = 6,
+    MPJSCommerceEventActionPurchase = 7,
+    MPJSCommerceEventActionRefund = 8,
+    MPJSCommerceEventActionAddToWishList = 9,
+    MPJSCommerceEventActionRemoveFromWishlist = 10
+};
+
+/**
+ * Utility class to convert JavaScript dictionaries from WebView bridge into mParticle SDK objects
+ */
+@interface MPConvertJS_PRIVATE : NSObject
+
+/**
+ * Converts a JavaScript commerce event action number to an MPCommerceEventAction
+ * @param json The action number from JavaScript
+ * @return The corresponding MPCommerceEventAction
+ */
++ (MPCommerceEventAction)commerceEventAction:(NSNumber *)json;
+
+/**
+ * Converts a JavaScript commerce event dictionary to an MPCommerceEvent
+ * @param json The commerce event dictionary from JavaScript
+ * @return An MPCommerceEvent object, or nil if the dictionary is invalid
+ */
++ (nullable MPCommerceEvent *)commerceEvent:(NSDictionary *)json;
+
+/**
+ * Converts a JavaScript promotion container dictionary to an MPPromotionContainer
+ * @param json The promotion container dictionary from JavaScript
+ * @return An MPPromotionContainer object, or nil if the dictionary is invalid
+ */
++ (nullable MPPromotionContainer *)promotionContainer:(NSDictionary *)json;
+
+/**
+ * Converts a JavaScript promotion dictionary to an MPPromotion
+ * @param json The promotion dictionary from JavaScript
+ * @return An MPPromotion object
+ */
++ (MPPromotion *)promotion:(NSDictionary *)json;
+
+/**
+ * Converts a JavaScript transaction attributes dictionary to MPTransactionAttributes
+ * @param json The transaction attributes dictionary from JavaScript (can be empty)
+ * @return An MPTransactionAttributes object
+ */
++ (MPTransactionAttributes *)transactionAttributes:(NSDictionary *)json;
+
+/**
+ * Converts a JavaScript product dictionary to an MPProduct
+ * @param json The product dictionary from JavaScript
+ * @return An MPProduct object
+ */
++ (MPProduct *)product:(NSDictionary *)json;
+
+/**
+ * Converts a JavaScript identity request dictionary to an MPIdentityApiRequest
+ * @param json The identity request dictionary from JavaScript
+ * @return An MPIdentityApiRequest object, or nil if the dictionary is invalid
+ */
++ (nullable MPIdentityApiRequest *)identityApiRequest:(nullable NSDictionary *)json;
+
+@end
+
+NS_ASSUME_NONNULL_END