feat: Add marketing cloud ID override (#20)

Author: einsteinx2

mParticle-Adobe/MPKitAdobe.h

@@ -20,4 +20,6 @@
 @property (nonatomic, unsafe_unretained, readonly) BOOL started;
 @property (nonatomic, strong, nullable) MPKitAPI *kitApi;
 
++ (void)overrideMarketingCloudId:(NSString * _Nullable)mid;
+
 @end

mParticle-Adobe/MPKitAdobe.m

@@ -28,6 +28,8 @@ @interface MPKitAdobe ()
 
 @implementation MPKitAdobe
 
+static NSString *_midOverride = nil;
+
 + (NSNumber *)kitCode {
     return @124;
 }
@@ -39,6 +41,9 @@ + (void)load {
     [MParticle registerExtension:kitRegister];
 }
 
++ (void)overrideMarketingCloudId:(NSString *)mid {
+    _midOverride = mid;
+}
 
 #pragma mark MPKitInstanceProtocol methods
 
@@ -119,12 +124,15 @@ - (NSString *)pushToken {
 }
 
 - (void)sendNetworkRequest {
-    NSString *marketingCloudId = [self marketingCloudIdFromIntegrationAttributes];
+    NSString *marketingCloudId = _midOverride;
     if (!marketingCloudId) {
-        marketingCloudId = [_adobe marketingCloudIdFromUserDefaults];
-        if (marketingCloudId.length) {
-            [[MParticle sharedInstance] setIntegrationAttributes:@{marketingCloudIdIntegrationAttributeKey: marketingCloudId} forKit:[[self class] kitCode]];
-            _hasSetMCID = YES;
+        marketingCloudId = [self marketingCloudIdFromIntegrationAttributes];
+        if (!marketingCloudId) {
+            marketingCloudId = [_adobe marketingCloudIdFromUserDefaults];
+            if (marketingCloudId.length) {
+                [[MParticle sharedInstance] setIntegrationAttributes:@{marketingCloudIdIntegrationAttributeKey: marketingCloudId} forKit:[[self class] kitCode]];
+                _hasSetMCID = YES;
+            }
         }
     }
 
@@ -140,7 +148,7 @@ - (void)sendNetworkRequest {
 
         NSMutableDictionary *integrationAttributes = [NSMutableDictionary dictionary];
         if (marketingCloudId.length) {
-            [integrationAttributes setObject:marketingCloudId forKey:marketingCloudIdIntegrationAttributeKey];
+            [integrationAttributes setObject:(_midOverride ?: marketingCloudId) forKey:marketingCloudIdIntegrationAttributeKey];
         }
         if (locationHint.length) {
             [integrationAttributes setObject:locationHint forKey:locationHintIntegrationAttributeKey];