Add delayed language network call

* Add OneSignalSetLanguageParameters
* OneSignalSetLanguageParameters stores language network call information when prior to user initialization
* On creating new session, delayed language parameters are retrieved and network call is made

Author: tanaynigam

iOS_SDK/OneSignalSDK/Source/OneSignal.m

@@ -74,6 +74,7 @@
 #import "OneSignalSetEmailParameters.h"
 #import "OneSignalSetSMSParameters.h"
 #import "OneSignalSetExternalIdParameters.h"
+#import "OneSignalSetLanguageParameters.h"
 #import "DelayedConsentInitializationParameters.h"
 #import "OneSignalDialogController.h"
 
@@ -146,6 +147,7 @@ + (OneSignalSetSMSParameters *)delayedSMSParameters {
     return _delayedSMSParameters;
 }
 static OneSignalSetExternalIdParameters *delayedExternalIdParameters;
+static OneSignalSetLanguageParameters *delayedLanguageParameters;
 
 static NSMutableArray* pendingSendTagCallbacks;
 static OSResultSuccessBlock pendingGetTagsSuccessBlock;
@@ -1886,6 +1888,12 @@ + (void)registerUserInternal {
                 _delayedSMSParameters = nil;
             }
 
+            if (delayedLanguageParameters) {
+                // Call to setLanguage: was delayed because the push player_id did not exist yet
+                [self setLanguage:delayedLanguageParameters.language withSuccess:delayedLanguageParameters.successBlock withFailure:delayedLanguageParameters.failureBlock];
+                delayedLanguageParameters = nil;
+            }
+            
             if (nowProcessingCallbacks) {
                 for (OSPendingCallbacks *callbackSet in nowProcessingCallbacks) {
                     if (callbackSet.successBlock)
@@ -1896,8 +1904,6 @@ + (void)registerUserInternal {
             if (self.playerTags.tagsToSend) {
                 [self performSelector:@selector(sendTagsToServer) withObject:nil afterDelay:5];
             }
-            
-            //TODO: Check for Pending Language State and add a put call for it
 
             // Try to send location
             [OneSignalLocation sendLocation];
@@ -2726,6 +2732,17 @@ + (void)setLanguage:(NSString * _Nonnull)language withSuccess:(OSUpdateLanguageS
 
 + (void)setLanguageOnServer:(NSString * _Nonnull)language WithSuccess:(OSUpdateLanguageSuccessBlock)successBlock withFailure:(OSUpdateLanguageFailureBlock)failureBlock {
 
+    if ([language isEqualToString:@""]) {
+        failureBlock([NSError errorWithDomain:@"com.onesignal.language" code:0 userInfo:@{@"error" : @"Empty Language Code"}]);
+        return;
+    }
+    
+    if (!self.currentSubscriptionState.userId || _downloadedParameters == false) {
+        [self onesignal_Log:ONE_S_LL_VERBOSE message:@"iOS Parameters for this application has not yet been downloaded. Delaying call to setLanguage: until the parameters have been downloaded."];
+        delayedLanguageParameters = [OneSignalSetLanguageParameters language:language withSuccess:successBlock withFailure:failureBlock];
+        return;
+    }
+    
     [OneSignal.stateSynchronizer updateLanguage:language appId:appId withSuccess:^(NSDictionary *results) {
         if (successBlock)
             successBlock(results);

iOS_SDK/OneSignalSDK/Source/OneSignalSetLanguageParameters.h

@@ -0,0 +1,39 @@
+/**
+ * Modified MIT License
+ *
+ * Copyright 2021 OneSignal
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * 1. The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 2. All copies of substantial portions of the Software may only be used in connection
+ * with services provided by OneSignal.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#import <Foundation/Foundation.h>
+#import "OneSignal.h"
+
+@interface OneSignalSetLanguageParameters : NSObject
+
++ (instancetype _Nullable )language:(NSString * _Nonnull)language withSuccess:(OSUpdateLanguageSuccessBlock _Nullable)successBlock withFailure:(OSUpdateLanguageFailureBlock _Nullable)failureBlock;
+
+@property (strong, nonatomic, nonnull) NSString *language;
+@property (nonatomic, nullable) OSResultSuccessBlock successBlock;
+@property (nonatomic, nullable) OSFailureBlock failureBlock;
+
+@end

iOS_SDK/OneSignalSDK/Source/OneSignalSetLanguageParameters.m

@@ -0,0 +1,42 @@
+/**
+ * Modified MIT License
+ *
+ * Copyright 2021 OneSignal
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * 1. The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 2. All copies of substantial portions of the Software may only be used in connection
+ * with services provided by OneSignal.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#import "OneSignalSetLanguageParameters.h"
+
+@implementation OneSignalSetLanguageParameters
+
++ (instancetype)language:(NSString * _Nonnull)language withSuccess:(OSUpdateLanguageSuccessBlock _Nullable)success withFailure:(OSUpdateLanguageFailureBlock _Nullable)failure {
+    OneSignalSetLanguageParameters *parameters = [OneSignalSetLanguageParameters new];
+    
+    parameters.language = language;
+    parameters.successBlock = success;
+    parameters.failureBlock = failure;
+    
+    return parameters;
+}
+
+@end