@unvired/cordova-plugin-unvired-universal-sdk 1.0.196 → 1.0.198

package/README.md

@@ -60,4 +60,48 @@ https://github.com/ionic-team/ionic-native/tree/master/src/%40ionic-native/plugi
 
  The source contains a single file, index.ts which contains declarations of all the functions available in www/kernel.js file of this repo. To expose newly added methods in kernel.js, you will have to fork https://github.com/ionic-team/ionic-native repo to your GitHub repo, make changes and submit a pull request.
 
-Once the Pull request is approved, the new method should be available publicly for all the users.
+Once the Pull request is approved, the new method should be available publicly for all the users.
+
+# Push Notifications (Firebase)
+
+## Electron Setup
+
+For push notifications to work in an Electron environment, you must expose an Inter-Process Communication (IPC) bridge so the web app can communicate with the main process for Firebase Cloud Messaging (FCM).
+
+In your Electron project's preload script (e.g., `cdv-electron-preload.js`), ensure you expose the `electronAPI` with the `fcm` object as shown below:
+
+```javascript
+const { contextBridge, ipcRenderer, shell } = require('electron');
+
+contextBridge.exposeInMainWorld('electronAPI', {
+  // ... other exposed APIs ...
+
+  fcm: {
+    startService: (firebaseCredentials) => ipcRenderer.send('PUSH_RECEIVER:::START_NOTIFICATION_SERVICE', firebaseCredentials),
+    onNotification: (callback) => {
+      ipcRenderer.on('PUSH_RECEIVER:::NOTIFICATION_RECEIVED', (event, notification) => {
+        callback(notification);
+      });
+    },
+    onToken: (callback) => {
+      ipcRenderer.on('PUSH_RECEIVER:::TOKEN_UPDATED', (event, token) => {
+        callback(token);
+      });
+      ipcRenderer.on('PUSH_RECEIVER:::NOTIFICATION_SERVICE_STARTED', (event, token) => {
+        callback(token);
+      });
+    },
+    onError: (callback) => {
+      ipcRenderer.on('PUSH_RECEIVER:::NOTIFICATION_SERVICE_ERROR', (event, error) => {
+        callback(error);
+      });
+    }
+  }
+});
+```
+
+## Web / Browser Setup
+
+For web apps running in a standard browser, you must include the `firebase-messaging-sw.js` service worker file at the **root level** of your web application (e.g., in the same directory as your `index.html` or in your `public` folder). 
+
+This service worker is mandatory for the browser to successfully register for FCM tokens and receive background push messages from Firebase.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unvired/cordova-plugin-unvired-universal-sdk",
-  "version": "1.0.196",
+  "version": "1.0.198",
   "description": "Unvired Cordova Plugin",
   "scripts": {
     "build": "webpack -c webpack.config.js",

package/plugin.xml

@@ -1,8 +1,8 @@
 <?xml version='1.0' encoding='utf-8'?>
-<plugin id="@unvired/cordova-plugin-unvired-universal-sdk" version="1.0.196" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
+<plugin id="@unvired/cordova-plugin-unvired-universal-sdk" version="1.0.198" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
   <name>UnviredSDK</name>
   <dependency id="@unvired/cordova-plugin-unvired-device" version="^1.0.7" />
-  <dependency id="@unvired/cordova-plugin-unvired-electron-db" version="^0.0.43" />
+  <dependency id="@unvired/cordova-plugin-unvired-electron-db" version="^0.0.44" />
   <dependency id="@unvired/cordova-plugin-unvired-logger" version="^0.0.30" />
   <dependency id="cordova-plugin-firebase-messaging" version="^8.0.1" />