Library for receiving notifications issued from firebase/janis.

In order to receive notifications it is necessary to include the dependency

    npm install @react-native-firebase/messaging

    npm install @janis-commerce/app-push-notification

What is received is an object called RemoteMessage, which contains the data emitted from Firebase and is what triggers the notification listeners. Inside remoteMessage you get the notifications object that contains the information that we could use to render a component with the application in the foreground

For more information about this, read https://rnfirebase.io/reference/messaging/remotemessage

NotificationProvider(children, appName, events, environment) ⇒ null | React.element

It is the main component of the package, it is a HOC that is responsible for handling the logic of subscribing to notifications and receiving messages from the Firebase console. The HOC contains listeners to listen to notifications in the foreground and background, so (unless we cancel the subscription), we will receive notifications from the app even when it is closed.

setupBackgroundMessageHandler(callback)

This function is responsible for handling any callbacks from Firebase cloud messaging in the background or with the application closed

usePushNotification() ⇒ object

is a hook, which returns the elements contained within the notifications context. Returns an object containing:

name	description
deviceToken	Is the token linked to the device, which we use to subscribe it to notifications.
foregroundNotification	An object containing all data received when a foreground push notification is triggered.
backgroundNotification	An object containing all data received when a background push notification is triggered.
subscribeError	An object containing all data received from a notification service subscription failure.
cancelNotifications	This util is responsible for making the request to unsubscribe from all notification events. If no arguments are received, the request will be made with the previously registered events.
addNewEvent	This function allows you to add a new event to receive notifications.
deleteReceivedNotification	An util that clears the foreground or background notification state to the depending on the type it receives by parameter
getSubscribedEvents	This function returns an array with the events to which the user is subscribed.

It is the main component of the package, it is a HOC that is responsible for handling the logic of subscribing to notifications and receiving messages from the Firebase console. The HOC contains listeners to listen to notifications in the foreground and background, so (unless we cancel the subscription), we will receive notifications from the app even when it is closed.

Kind: global function
Throws:

• null when not receive a children argument

Example

import NotificationProvider from '@janiscommerce/app-push-notification'

return (
 <NotificationProvider
   appName='pickingApp'
   events={["picking:session:created","picking:session:assigned"]}
   environment='beta'
   >
   <MyComponent/>
 </NotificationProvider>
)

This function is responsible for handling any callbacks from Firebase cloud messaging in the background or with the application closed

Kind: global function

is a hook, which returns the elements contained within the notifications context. Returns an object containing:

Kind: global function
Example

import {usePushNotification} from '@janiscommerce/app-push-notification'

const { deviceToken, foregroundNotification, backgroundNotification} = usePushNotification()