zo0r
diff --git a/‎CHANGELOG.md
+45 b/‎CHANGELOG.md
+45
diff --git a/‎README.md
+158-44 b/‎README.md
+158-44
diff --git a/‎android/.classpath
+6 b/‎android/.classpath
+6
diff --git a/‎android/.project
+6 b/‎android/.project
+6
@@ -7,10 +7,55 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+### Breaking changes
+
 ### Features
 
 ### Fixed
 
+
+## [4.4.0] 2020-07-06
+
+### Breaking changes
+
+- `RNPushNotificationRegistrationService` has been removed, old reference in AndroidManifest must be removed.
+- `Notifications.registerNotificationActions()` has been removed and is not required for `actions`.
+- `DeviceEventEmitter.addListener('notificationActionReceived', callback)` is replaced by `onAction`.
+- Extra receiver must be added to manage actions.
+  ```xml
+      <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationActions" />
+  ```
+- (iOS) `userInfo` is now populated with id by default to allow operation based on `id`.
+
+### Features
+
+- (Android) `actions` accept an array of strings.
+- (Android) `invokeApp` allow you to handle actions in background without invoking the application.
+- (Android) `onAction` has been added to `.configure()` to handle action in background.
+- (Android) `PushNotification.invokeApp(notification)` allow you to invoke the application when in background (notification for initial notification).
+- (Android) `PushNotification.getChannels(callback)` allow you to get the list of channels.
+- (Android) `PushNotification.channelExists(channel_id, callback)` allow you to check of a channel exists.
+- (Android) `PushNotification.channelBlocked(channel_id, callback)` allow you to check of a channel is blocked. Based on [#1249](https://github.com/zo0r/react-native-push-notification/pull/1249)
+- (Android) `PushNotification.deleteChannel(channel_id)` allow you to delete a channel.
+- (Android) Add `largeIconUrl` to load a largeIcon based on Url. Based on [#1444](https://github.com/zo0r/react-native-push-notification/pull/1444)
+- (Android) Add `bigPictureUrl` to load a picture based on Url. Based on [#1444](https://github.com/zo0r/react-native-push-notification/pull/1444)
+- (Android) Add `shortcutId` for better badges management.
+- (Android) Add `showWhen` to display "when" it was published, default: true.
+- (Android) Add `groupSummary` to allow grouping notifications. Based on [#1253](https://github.com/zo0r/react-native-push-notification/pull/1253)
+- (Android) Add `channelId`, custom channel_id in android. Based on [#1159](https://github.com/zo0r/react-native-push-notification/pull/1159)
+- (Android) Add `channelName`, custom channel_name in android.
+- (Android) Add `channelDescription`, custom channel_description in android.
+- (iOS) Add fire date in notification response, NOTE: `push-notification-ios` in version `> 1.2.0` [#1345](https://github.com/zo0r/react-native-push-notification/pull/1345)
+- (iOS) `onRegistrationError` has been added to `.configure()` to handle `registrationError` events.
+- (Android/iOS) Add method getScheduledLocalNotifications()[#1466](https://github.com/zo0r/react-native-push-notification/pull/1466)
+
+### Fixed
+
+- (Android) Replace java.util.Random with java.security.SecureRandom [#1497](https://github.com/zo0r/react-native-push-notification/pull/1497)
+- (Android) WAKE_LOCK permission removed from documentation. [#1494](https://github.com/zo0r/react-native-push-notification/issues/1494)
+- (Android) Some options were ignored on scheduled/repeating notifications (allowWhileIdle, ignoreInForeground).
+- (Android/iOS) popInitialInotification might be ignored in `.configure()`
+
 ## [3.5.2] - 2020-05-25
 
 ### Fixed
 
@@ -5,6 +5,14 @@
 
 React Native Local and Remote Notifications for iOS and Android
 
+
+## 🎉 Version 4.0.0 is live ! 🎉
+
+Check out for changes in the CHANGELOG:
+
+[Changelog](https://github.com/zo0r/react-native-push-notification/blob/master/CHANGELOG.md)
+
+
 ## Supported React Native Versions
 
 | Component Version | RN Versions          | README                                                                                                                 |
@@ -29,6 +37,8 @@ Changelog is available from version 3.1.3 here: [Changelog](https://github.com/z
 
 `yarn add react-native-push-notification`
 
+**NOTE: If you target iOS you also need to follow the [installation instructions for PushNotificationIOS](https://github.com/react-native-community/react-native-push-notification-ios) since this package depends on it.**
+
 **NOTE: For Android, you will still have to manually update the AndroidManifest.xml (as below) in order to use Scheduled Notifications.**
 
 ## Issues
@@ -70,8 +80,6 @@ In your `android/app/src/main/AndroidManifest.xml`
 
 ```xml
     .....
-    <uses-permission android:name="android.permission.WAKE_LOCK" />
-
     <uses-permission android:name="android.permission.VIBRATE" />
     <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
 
@@ -84,10 +92,14 @@ In your `android/app/src/main/AndroidManifest.xml`
         <!-- Change the value to true to enable pop-up for in foreground (remote-only, for local use ignoreInForeground) -->
         <meta-data  android:name="com.dieam.reactnativepushnotification.notification_foreground"
                     android:value="false"/>
+        <!-- Change the value to false if you don't want the creation of the default channel -->
+        <meta-data  android:name="com.dieam.reactnativepushnotification.channel_create_default"
+                    android:value="true"/>
         <!-- Change the resource name to your App's accent color - or any other color you want -->
         <meta-data  android:name="com.dieam.reactnativepushnotification.notification_color"
                     android:resource="@color/white"/> <!-- or @android:color/{name} to use a standard color -->
 
+        <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationActions" />
         <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationPublisher" />
         <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationBootEventReceiver">
             <intent-filter>
@@ -222,6 +234,19 @@ PushNotification.configure({
     notification.finish(PushNotificationIOS.FetchResult.NoData);
   },
 
+  // (optional) Called when Registered Action is pressed and invokeApp is false, if true onNotification will be called (Android)
+  onAction: function (notification) {
+    console.log("ACTION:", notification.action);
+    console.log("NOTIFICATION:", notification);
+
+    // process the action
+  },
+
+  // (optional) Called when the user fails to register for remote notifications. Typically occurs when APNS is having issues, or the device is a simulator. (iOS)
+  onRegistrationError: function(err) {
+    console.error(err.message, err);
+  }
+
   // IOS ONLY (optional): default: all - Permissions to register.
   permissions: {
     alert: true,
@@ -276,22 +301,31 @@ PushNotification.localNotification({
   /* Android Only Properties */
   id: 0, // (optional) Valid unique 32 bit integer specified as string. default: Autogenerated Unique ID
   ticker: "My Notification Ticker", // (optional)
+  showWhen: true, // (optional) default: true
   autoCancel: true, // (optional) default: true
   largeIcon: "ic_launcher", // (optional) default: "ic_launcher"
+  largeIconUrl: "https://www.example.tld/picture.jpg", // (optional) default: undefined
   smallIcon: "ic_notification", // (optional) default: "ic_notification" with fallback for "ic_launcher"
   bigText: "My big text that will be shown when notification is expanded", // (optional) default: "message" prop
   subText: "This is a subText", // (optional) default: none
+  bigPictureUrl: "https://www.example.tld/picture.jpg", // (optional) default: undefined
   color: "red", // (optional) default: system default
   vibrate: true, // (optional) default: true
   vibration: 300, // vibration length in milliseconds, ignored if vibrate=false, default: 1000
   tag: "some_tag", // (optional) add tag to message
   group: "group", // (optional) add group to message
+  groupSummary: false, // (optional) set this notification to be the group summary for a group of notifications, default: false
   ongoing: false, // (optional) set whether this is an "ongoing" notification
   priority: "high", // (optional) set notification priority, default: high
   visibility: "private", // (optional) set notification visibility, default: private
   importance: "high", // (optional) set notification importance, default: high
   allowWhileIdle: false, // (optional) set notification to work while on doze, default: false
   ignoreInForeground: false, // (optional) if true, the notification will not be visible when the app is in the foreground (useful for parity with how iOS notifications appear)
+  shortcutId: "shortcut-id", // (optional) If this notification is duplicative of a Launcher shortcut, sets the id of the shortcut, in case the Launcher wants to hide the shortcut, default undefined
+  channelId: "your-custom-channel-id", // (optional) custom channelId, if the channel doesn't exist, it will be created with options passed above (importance, vibration, sound). Once the channel is created, the channel will not be update. Make sure your channelId is different if you change these options. If you have created a custom channel, it will apply options of the channel.
+
+  actions: '["Yes", "No"]', // (Android only) See the doc for notification actions to know more
+  invokeApp: true, // (optional) This enable click on actions to bring back the application to foreground or stay in background, default: true
 
   /* iOS only properties */
   alertAction: "view", // (optional) default: view
@@ -305,7 +339,6 @@ PushNotification.localNotification({
   soundName: "default", // (optional) Sound to play when the notification is shown. Value of 'default' plays the default sound. It can be set to a custom sound such as 'android.resource://com.xyz/raw/my_sound'. It will look for the 'my_sound' audio file in 'res/raw' directory and play it. default: 'default' (default sound is played)
   number: 10, // (optional) Valid 32 bit integer specified as string. default: none (Cannot be zero)
   repeatType: "day", // (optional) Repeating interval. Check 'Repeating Notifications' section for more info.
-  actions: '["Yes", "No"]', // (Android only) See the doc for notification actions to know more
 });
 ```
 
@@ -333,38 +366,115 @@ In the location notification json specify the full file name:
 
     soundName: 'my_sound.mp3'
 
-## Cancelling notifications
+## Channel Management (Android)
 
-### 1) cancelLocalNotifications
+This library doesn't include a full Channel Management at the moment. Channels are generated on the fly when you pass options to `PushNotification.localNotification` or `PushNotification.localNotificationSchedule`.
 
-#### Android
+The pattern of `channel_id` is:
 
-The `id` parameter for `PushNotification.localNotification` is required for this operation. The id supplied will then be used for the cancel operation.
+```
+rn-push-notification-channel-id-(importance: default "4")(-soundname, default if playSound "-default")-(vibration, default "300")
+```
 
-```javascript
-// Android
-PushNotification.localNotification({
-    ...
-    id: '123'
-    ...
+By default, 1 channel is created:
+
+- rn-push-notification-channel-id-4-default-300 (used for remote notification if none already exist).
+
+you can avoid the default creation by using this:
+
+```xml
+  <meta-data  android:name="com.dieam.reactnativepushnotification.channel_create_default"
+          android:value="false"/>
+```
+
+**NOTE: Without channel, remote notifications don't work**
+
+In the notifications options, you can provide a custom channel id with `channelId: "your-custom-channel-id"`, if the channel doesn't exist, it will be created with options passed above (importance, vibration, sound). Once the channel is created, the channel will not be update. Make sure your `channelId` is different if you change these options. If you have created a custom channel in another way, it will apply options of the channel.
+
+Custom and generated channels can have custom name and description in the `AndroidManifest.xml`, only if the library is responsible of the creation of the channel.
+You can also use `channelName` and `channelDescription` when you use to override the name or description. Once the channel is created, you won't be able to update them.
+
+```xml
+  <meta-data  android:name="com.dieam.reactnativepushnotification.notification_channel_name.[CHANNEL_ID]"
+          android:value="YOUR NOTIFICATION CHANNEL NAME FOR CHANNEL_ID"/>
+  <meta-data  android:name="com.dieam.reactnativepushnotification.notification_channel_description.[CHANNEL_ID]"
+              android:value="YOUR NOTIFICATION CHANNEL DESCRIPTION FOR CHANNEL_ID"/>
+```
+
+For example:
+
+```xml
+  <meta-data  android:name="com.dieam.reactnativepushnotification.notification_channel_name.rn-push-notification-channel-id-4-300"
+          android:value="YOUR NOTIFICATION CHANNEL NAME FOR SILENT CHANNEL"/>
+  <meta-data  android:name="com.dieam.reactnativepushnotification.notification_channel_description.rn-push-notification-channel-id-4-300"
+              android:value="YOUR NOTIFICATION CHANNEL DESCRIPTION FOR SILENT CHANNEL"/>
+```
+
+If you want to use a different default channel for remote notification, refer to the documentation of Firebase:
+
+[Set up a Firebase Cloud Messaging client app on Android](https://firebase.google.com/docs/cloud-messaging/android/client?hl=fr)
+
+```xml
+  <meta-data
+      android:name="com.google.firebase.messaging.default_notification_channel_id"
+      android:value="@string/default_notification_channel_id" />
+```
+
+### List channels
+
+You can list available channels with:
+
+```js
+PushNotification.getChannels(function (channel_ids) {
+  console.log(channel_ids); // ['channel_id_1']
+});
+```
+
+### Channel exists
+
+You can check if a channel exists with:
+
+```js
+PushNotification.channelExists(channel_id, function (exists) {
+  console.log(exists); // true/false
+});
+```
+
+### Channel blocked
+
+You can check if a channel blocked with:
+
+```js
+PushNotification.channelBlocked(channel_id, function (blocked) {
+  console.log(blocked); // true/false
 });
-PushNotification.cancelLocalNotifications({id: '123'});
 ```
 
-#### IOS
+### List channels
+
+You can list available channels with:
 
-The `userInfo` parameter for `PushNotification.localNotification` is required for this operation and must contain an `id` parameter. The id supplied will then be used for the cancel operation.
+```js
+PushNotification.deleteChannel(channel_id);
+```
+
+## Cancelling notifications
+
+### 1) cancelLocalNotifications
+
+The `id` parameter for `PushNotification.localNotification` is required for this operation. The id supplied will then be used for the cancel operation.
 
 ```javascript
-// IOS
 PushNotification.localNotification({
     ...
-    userInfo: { id: '123' }
+    id: '123'
     ...
 });
 PushNotification.cancelLocalNotifications({id: '123'});
 ```
 
+**iOS: `userInfo` is populated `id` if not defined this allow the previous method**
+
 ### 2) cancelAllLocalNotifications
 
 `PushNotification.cancelAllLocalNotifications()`
@@ -418,6 +528,31 @@ Removes the specified notifications from Notification Center
 | ----------- | ----- | -------- | ---------------------------------- |
 | identifiers | array | Yes      | Array of notification identifiers. |
 
+### 6) getScheduledLocalNotifications
+
+```javascript
+PushNotificationIOS.getScheduledLocalNotifications(callback);
+```
+
+Provides you with a list of the app’s scheduled local notifications that are yet to be displayed
+
+**Parameters:**
+
+| Name     | Type     | Required | Description                                                 |
+| -------- | -------- | -------- | ----------------------------------------------------------- |
+| callback | function | Yes      | Function which receive an array of delivered notifications. |
+
+Returns an array of local scheduled notification objects containing:
+
+| Name           | Type   | Description                               |
+| -------------- | ------ | ----------------------------------------- |
+| id             | number | The identifier of this notification.      |
+| date           | Date   | The fire date of this notification.       |
+| title          | string | The title of this notification.           |
+| message        | string | The message body of this notification.    |
+| soundName      | string | The sound name of this notification.      |
+| repeatInterval | number | The repeat interval of this notification. |
+| number         | number | App notification badge count number.      |
 
 ## Abandon Permissions
 
@@ -486,37 +621,16 @@ Property `repeatType` could be one of `month`, `week`, `day`, `hour`, `minute`,
 
 (Android only) [Refer](https://github.com/zo0r/react-native-push-notification/issues/151) to this issue to see an example of a notification action.
 
-Two things are required to setup notification actions.
-
-### 1) Specify notification actions for a notification
-
 This is done by specifying an `actions` parameters while configuring the local notification. This is an array of strings where each string is a notification action that will be presented with the notification.
 
-For e.g. `actions: '["Accept", "Reject"]' // Must be in string format`
-
-The array itself is specified in string format to circumvent some problems because of the way JSON arrays are handled by react-native android bridge.
+For e.g. `actions: ['Accept', 'Reject']`
 
-### 2) Specify handlers for the notification actions
+When you handle actions in background (`invokeApp: false`), you can open the application and pass the initial notification by using use `PushNotification.invokeApp(notification)`.
 
-For each action specified in the `actions` field, we need to add a handler that is called when the user clicks on the action. This can be done in the `componentWillMount` of your main app file or in a separate file which is imported in your main app file. Notification actions handlers can be configured as below:
+Make sure you have the receiver in `AndroidManifest.xml`:
 
-```
-import PushNotificationAndroid from 'react-native-push-notification'
-
-(function() {
-  // Register all the valid actions for notifications here and add the action handler for each action
-  PushNotificationAndroid.registerNotificationActions(['Accept','Reject','Yes','No']);
-  DeviceEventEmitter.addListener('notificationActionReceived', function(action){
-    console.log ('Notification action received: ' + action);
-    const info = JSON.parse(action.dataJSON);
-    if (info.action == 'Accept') {
-      // Do work pertaining to Accept action here
-    } else if (info.action == 'Reject') {
-      // Do work pertaining to Reject action here
-    }
-    // Add all the required actions handlers
-  });
-})();
+```xml
+  <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationActions" />
 ```
 
 For iOS, you can use this [package](https://github.com/holmesal/react-native-ios-notification-actions) to add notification actions.
 
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8/"/>
+	<classpathentry kind="con" path="org.eclipse.buildship.core.gradleclasspathcontainer"/>
+	<classpathentry kind="output" path="bin/default"/>
+</classpath>
@@ -5,13 +5,19 @@
 	<projects>
 	</projects>
 	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
 		<buildCommand>
 			<name>org.eclipse.buildship.core.gradleprojectbuilder</name>
 			<arguments>
 			</arguments>
 		</buildCommand>
 	</buildSpec>
 	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
 		<nature>org.eclipse.buildship.core.gradleprojectnature</nature>
 	</natures>
 </projectDescription>