Add new methods for requesting iOS permission and deprecate old one

Author: Minishlink

README.md

@@ -219,7 +219,11 @@ If you want to show foreground notifications, add the [relevant configuration](h
 ```js
 import { BatchPush } from '@bam.tech/react-native-batch';
 
-BatchPush.registerForRemoteNotifications();
+// when you want to show the alert asking for permission
+BatchPush.requestNotificationAuthorization();
+
+// at each app launch (after opt-in if you're opted out by default)
+BatchPush.refreshToken();
 ```
 
 <hr>

ios/RNBatch.m

@@ -166,6 +166,21 @@ - (NSDictionary*) dictionaryWithEventDispatcherPayload:(id<BatchEventDispatcherP
     [BatchPush registerForRemoteNotifications];
 }
 
+RCT_EXPORT_METHOD(push_requestNotificationAuthorization)
+{
+    [BatchPush requestNotificationAuthorization];
+}
+
+RCT_EXPORT_METHOD(push_requestProvisionalNotificationAuthorization)
+{
+    [BatchPush requestProvisionalNotificationAuthorization];
+}
+
+RCT_EXPORT_METHOD(push_refreshToken)
+{
+    [BatchPush refreshToken];
+}
+
 RCT_EXPORT_METHOD(push_clearBadge)
 {
     [BatchPush clearBadge];

src/BatchPush.ts

@@ -30,9 +30,49 @@ export const BatchPush = {
    *
    *
    * No effect on Android.
+   *
+   * @deprecated Please use requestNotificationAuthorization to request permission when needed, and requestToken at each app launch
+   */
+  registerForRemoteNotifications: (): void => {
+    if (Platform.OS === 'ios') {
+      RNBatch.push_registerForRemoteNotifications();
+    }
+  },
+
+  /**
+   * Ask iOS users if they want to accept push notifications.
+   * Required to be able to push users (or use requestProvisionalNotificationAuthorization).
+   *
+   * No effect on Android.
+   */
+  requestNotificationAuthorization: (): void => {
+    if (Platform.OS === 'ios') {
+      RNBatch.push_requestNotificationAuthorization();
+    }
+  },
+
+  /**
+   * Ask iOS for provisional notifications (no alert to users).
+   * Required to be able to push users (or use requestNotificationAuthorization).
+   *
+   * No effect on Android.
+   */
+  requestProvisionalNotificationAuthorization: (): void => {
+    if (Platform.OS === 'ios') {
+      RNBatch.push_requestProvisionalNotificationAuthorization();
+    }
+  },
+
+  /**
+   * Synchronizes the user's iOS token with Batch. Should be called at each app launch.
+   *
+   * No effect on Android.
    */
-  registerForRemoteNotifications: (): void =>
-    RNBatch.push_registerForRemoteNotifications(),
+  refreshToken: (): void => {
+    if (Platform.OS === 'ios') {
+      RNBatch.push_refreshToken();
+    }
+  },
 
   /**
    * Change the used remote notification types on Android. (Ex: sound, vibrate, alert)