pushwoosh-react-native-plugin 6.1.54 → 6.1.56

package/README.md

@@ -53,17 +53,28 @@ npm install pushwoosh-react-native-plugin --save
 cd ios && pod install
 ```
 
-### Android Setup
+### Android Setup (Firebase Cloud Messaging)
 
-Add to your project's `build.gradle`:
+Push notifications on Android require Firebase Cloud Messaging (FCM).
 
-```groovy
-buildscript {
-    dependencies {
-        classpath 'com.google.gms:google-services:4.3.15'
-    }
-}
-```
+**Option A — Android Studio (recommended):**
+Open the `android/` folder in Android Studio, then go to
+Tools > Firebase > Cloud Messaging > Set up Firebase Cloud Messaging.
+The wizard will automatically add all required configuration.
+
+**Option B — Manual setup:**
+1. Create a project in [Firebase Console](https://console.firebase.google.com)
+2. Download `google-services.json` and place it in `android/app/`
+3. Add the Google Services classpath to `android/build.gradle`:
+   ```groovy
+   classpath("com.google.gms:google-services:4.3.15")
+   ```
+4. Apply the plugin in `android/app/build.gradle`:
+   ```groovy
+   apply plugin: "com.google.gms.google-services"
+   ```
+
+The Pushwoosh plugin already includes the `firebase-messaging` dependency, so you do not need to add it manually.
 
 ## AI-Assisted Integration
 
@@ -131,8 +142,7 @@ DeviceEventEmitter.addListener('pushOpened', (e) => {
 
 // Initialize Pushwoosh
 Pushwoosh.init({
-    pw_appid: "YOUR_PUSHWOOSH_APP_ID",
-    project_number: "YOUR_FCM_SENDER_ID"
+    pw_appid: "YOUR_PUSHWOOSH_APP_ID"
 });
 
 // Register for push notifications
@@ -228,7 +238,6 @@ import Pushwoosh from 'pushwoosh-react-native-plugin';
 
 Pushwoosh.init({
     pw_appid: "YOUR_PUSHWOOSH_APP_ID",
-    project_number: "YOUR_FCM_SENDER_ID",
     pw_notification_handling: "CUSTOM"
 });
 ```
@@ -318,6 +327,12 @@ Pushwoosh.init({
 | `setCommunicationEnabled(enable, success?, fail?)` | Enable/disable all Pushwoosh communication |
 | `isCommunicationEnabled(success)` | Check if communication is enabled |
 
+### Reverse Proxy
+
+| Method | Description |
+|--------|-------------|
+| `setReverseProxy(url, headers?)` | Route all SDK requests through a reverse proxy. Call before `init()` |
+
 ### Events (DeviceEventEmitter)
 
 | Event | Description |

package/docs/README.md

@@ -8,7 +8,7 @@ Example:
 ```js
 var Pushwoosh = require('pushwoosh-react-native-plugin');
 
-Pushwoosh.init({ "pw_appid" : "PUSHWOOSH_APP_ID" , "project_number" : "GOOGLE_PROJECT_NUMBER" });
+Pushwoosh.init({ "pw_appid" : "PUSHWOOSH_APP_ID" });
 
 Pushwoosh.register(
   (token) => {
@@ -61,6 +61,7 @@ DeviceEventEmitter.addListener('pushOpened', (e: Event) => {
 <tr class="even"><td><a href="#enableHuaweiPushNotifications">enableHuaweiPushNotifications()</a></td></tr>
 <tr class="even"><td><a href="#registersmsnumber">registerSMSNumber(phoneNumber)</a></td></tr>
 <tr class="even"><td><a href="#registerwhatsappnumber">registerWhatsappNumber(phoneNumber)</a></td></tr>
+<tr class="even"><td><a href="#setreverseproxy">setReverseProxy(url, headers)</a></td></tr>
 <tr>
 <th align="left" colspan="2"><strong>Events</strong></th>
 </tr>
@@ -77,7 +78,7 @@ DeviceEventEmitter.addListener('pushOpened', (e: Event) => {
 init(config, success, fail)
 ```
 
-Initializes Pushwoosh module with application id and google project number.
+Initializes Pushwoosh module with application id.
 
 <table width=100% style='background-color:#0EA7ED;'>
 <colgroup>
@@ -91,8 +92,6 @@ Initializes Pushwoosh module with application id and google project number.
 </tr>
 <tr class="even"><td>object</td><td><b>config</b></td><td>Pushwoosh initialization config.</td></tr>
 <tr class="even"><td>string</td><td><b>config.pw_appid</b></td><td>Pushwoosh application id.</td></tr>
-<tr class="even"><td>string</td><td><b>config.project_number</b></td><td>GCM project number (for Android push notifications).</td></tr>
-<tr class="even"><td>string</td><td><b>config.reverse_proxy_url</b></td><td>(optional) Url to your reverse proxy.</td></tr>
 <tr class="even"><td>string</td><td><b>config.pw_notification_handling</b></td><td>(optional) To use custom notification handling on iOS specify the parameter "pw_notification_handling" to "CUSTOM".</td></tr>
 <tr class="even"><td>function</td><td><b>success</b></td><td>(optional) initialization success callback.</td></tr>
 <tr class="even"><td>function</td><td><b>fail</b></td><td>(optional) initialization failure callback.</td></tr>
@@ -484,6 +483,40 @@ registerWhatsappNumber(phoneNumber)
 Registers WhatsApp number associated to the current user.
 WhatsApp numbers must be in E.164 format (e.g., "+1234567890") and be valid.
 
+### setReverseProxy
+
+```js
+setReverseProxy(url, headers)
+```
+**[android, ios]**
+Routes all SDK network requests through a reverse proxy server. Must be called before `init()`.
+
+<table width=100% style='background-color:#0EA7ED;'>
+<colgroup>
+<col width="10%" />
+<col width="20%" />
+<col width="70%" />
+</colgroup>
+<tbody>
+<tr>
+<th align="left" colspan="3"><strong>Parameters</strong></th>
+</tr>
+<tr class="even"><td>string</td><td><b>url</b></td><td>Reverse proxy URL.</td></tr>
+<tr class="even"><td>object</td><td><b>headers</b></td><td>(optional) Custom HTTP headers for all requests.</td></tr>
+</tbody>
+</table>
+
+**Prerequisites:**
+- **Android:** add `<meta-data android:name="com.pushwoosh.allow_reverse_proxy" android:value="true" />` to AndroidManifest.xml
+- **iOS:** add `Pushwoosh_ALLOW_REVERSE_PROXY = YES` to Info.plist
+
+Example:
+
+```js
+Pushwoosh.setReverseProxy("https://your-proxy.example.com/", { "X-Proxy-Auth": "my-token" });
+Pushwoosh.init({ "pw_appid": "XXXXX-XXXXX" });
+```
+
 ### pushReceived
 
 ```js

package/index.d.ts

@@ -1,7 +1,8 @@
 declare module 'pushwoosh-react-native-plugin' {
   interface PushwooshConfig {
     pw_appid: string;
-    project_number: string;
+    /** @deprecated FCM Sender ID is no longer required. Firebase Cloud Messaging configuration is handled automatically via google-services.json. */
+    project_number?: string;
     pw_notification_handling?: string;
   }
   type LocalNotification = {
@@ -28,6 +29,7 @@ declare module 'pushwoosh-react-native-plugin' {
 
   interface Pushwoosh {
     //general interaction with Pushwoosh
+    setReverseProxy(url: string, headers?: Record<string, string>): void;
     init(config: PushwooshConfig, success?: () => void, fail?: () => void): void;
     createLocalNotification(notification: LocalNotification): void;
     clearLocalNotification(): void;

package/index.js

@@ -15,6 +15,29 @@
  * cd ios && pod install
  * ```
  *
+ * @section Android Setup (Firebase Cloud Messaging)
+ *
+ * Push notifications on Android require Firebase Cloud Messaging (FCM).
+ * Add Firebase to your Android project using one of the following methods:
+ *
+ * Option A — Android Studio (recommended):
+ *   Open the `android/` folder in Android Studio, then go to
+ *   Tools → Firebase → Cloud Messaging → Set up Firebase Cloud Messaging.
+ *   The wizard will automatically add all required configuration.
+ *
+ * Option B — Manual setup:
+ *   1. Create a project in the Firebase Console (https://console.firebase.google.com)
+ *   2. Download `google-services.json` and place it in `android/app/`
+ *   3. Add the Google Services classpath to `android/build.gradle`:
+ *      `classpath("com.google.gms:google-services:4.3.15")`
+ *   4. Apply the plugin in `android/app/build.gradle`:
+ *      `apply plugin: "com.google.gms.google-services"`
+ *
+ * The Pushwoosh plugin already includes the `firebase-messaging` dependency,
+ * so you do not need to add it manually.
+ *
+ * For more details, see: https://firebase.google.com/docs/android/setup
+ *
  * @section Quick Start
  *
  * Step 1: Initialize the plugin and register for push notifications
@@ -30,8 +53,7 @@
  *
  * // Initialize Pushwoosh
  * Pushwoosh.init({
- *     pw_appid: "XXXXX-XXXXX",
- *     project_number: "YOUR_FCM_SENDER_ID"
+ *     pw_appid: "XXXXX-XXXXX"
  * });
  *
  * // Register for push notifications
@@ -162,7 +184,6 @@
  *
  * Pushwoosh.init({
  *     pw_appid: "XXXXX-XXXXX",
- *     project_number: "YOUR_FCM_SENDER_ID",
  *     pw_notification_handling: "CUSTOM"
  * });
  * ```
@@ -170,9 +191,7 @@
  * @section Configuration Parameters
  *
  * - pw_appid (required) - Pushwoosh Application ID from Control Panel
- * - project_number (required for Android) - FCM Sender ID
  * - pw_notification_handling (optional, iOS) - Set to "CUSTOM" for custom notification handling
- * - reverse_proxy_url (optional) - URL to reverse proxy for Pushwoosh server communication
  *
  * @section Events (DeviceEventEmitter)
  *
@@ -210,13 +229,55 @@ const RichMediaStyle = {
  */
 class PushNotification {
 
+	//Function: setReverseProxy
+	//Routes all SDK network requests through a reverse proxy server instead of Pushwoosh servers directly.
+	//The proxy server must be configured to forward requests to Pushwoosh APIs.
+	//
+	//Settings are not persisted and must be set on every app start.
+	//Must be called before init() to ensure no SDK requests are sent without the proxy.
+	//
+	//When the reverse proxy flag is enabled, the SDK blocks all network requests until
+	//setReverseProxy() is called. This guarantees that no traffic goes directly to Pushwoosh servers.
+	//
+	//Prerequisites:
+	// Android: add the following meta-data to AndroidManifest.xml:
+	//   <meta-data android:name="com.pushwoosh.allow_reverse_proxy" android:value="true" />
+	//
+	// iOS: add the following key to Info.plist (main app target):
+	//   Pushwoosh_ALLOW_REVERSE_PROXY = YES
+	//
+	// iOS Notification Service Extension (required for delivery tracking via proxy):
+	//   If your app uses a Notification Service Extension (NSE), you must configure App Groups
+	//   so the main app can share the proxy URL with the extension process:
+	//   1. In Xcode, enable the "App Groups" capability for both the main app target
+	//      and the NSE target with the same group identifier (e.g. "group.com.yourcompany.app").
+	//   2. Add the following keys to Info.plist of BOTH the main app and the NSE target:
+	//      PW_APP_GROUPS_NAME = group.com.yourcompany.app
+	//      Pushwoosh_ALLOW_REVERSE_PROXY = YES
+	//      Pushwoosh_APPID = XXXXX-XXXXX
+	//   Without App Groups, the NSE cannot access the proxy URL and delivery event
+	//   requests will either be sent directly to Pushwoosh servers or be silently dropped.
+	//
+	//Parameters:
+	// "url" - reverse proxy URL (must be a valid https:// or http:// URL)
+	// "headers" - optional map of custom HTTP headers to include in all requests (e.g. authorization headers)
+	//
+	//Example:
+	//(start code)
+	//	Pushwoosh.setReverseProxy("https://your-proxy.example.com/", { "X-Proxy-Auth": "my-token" });
+	//	Pushwoosh.init({ pw_appid: "XXXXX-XXXXX" });
+	//	Pushwoosh.register();
+	//(end)
+	setReverseProxy(url: string, headers: ?Object) {
+		PushwooshModule.setReverseProxy(url, headers || null);
+	}
+
 	//Function: init
-	//Call this first thing with your Pushwoosh App ID (pw_appid parameter) and Google Project ID for Android (projectid parameter)
+	//Call this first thing with your Pushwoosh App ID (pw_appid parameter).
 	//
 	//Example:
 	//(start code)
-	//	//initialize Pushwoosh with projectid: "GOOGLE_PROJECT_ID", appid : "PUSHWOOSH_APP_ID". This will trigger all pending push notifications on start.
-	//	Pushwoosh.init({ projectid: "XXXXXXXXXXXXXXX", pw_appid : "XXXXX-XXXXX" });
+	//	Pushwoosh.init({ pw_appid: "XXXXX-XXXXX" });
 	//(end)
 	init(config: Object, success: ?Function, fail: ?Function) {
 		if (!success) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pushwoosh-react-native-plugin",
-  "version": "6.1.54",
+  "version": "6.1.56",
   "description": "This plugin allows you to send and receive push notifications. Powered by Pushwoosh (www.pushwoosh.com).",
   "main": "index.js",
   "types": "index.d.ts",

package/pushwoosh-react-native-plugin.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = "pushwoosh-react-native-plugin"
-  s.version          = "6.1.54"
+  s.version          = "6.1.56"
   s.summary          = "React Native Pushwoosh Push Notifications module"
   s.requires_arc = true
   s.author       = 'Pushwoosh'
@@ -15,6 +15,6 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'React'
-  s.dependency 'PushwooshXCFramework', '7.0.29'
+  s.dependency 'PushwooshXCFramework', '7.0.32'
   s.dependency 'PushwooshInboxUIXCFramework'
 end

package/src/android/src/main/java/com/pushwoosh/reactnativeplugin/PushwooshPlugin.java

@@ -34,7 +34,6 @@ import com.pushwoosh.inbox.PushwooshInbox;
 import com.pushwoosh.inbox.data.InboxMessage;
 import com.pushwoosh.inbox.exception.InboxMessagesException;
 import com.pushwoosh.inbox.ui.presentation.view.activity.InboxActivity;
-import com.pushwoosh.internal.network.NetworkModule;
 import com.pushwoosh.internal.platform.AndroidPlatformModule;
 import com.pushwoosh.internal.utils.PWLog;
 import com.pushwoosh.notification.PushwooshNotificationSettings;
@@ -50,6 +49,8 @@ import org.json.JSONObject;
 
 import java.util.ArrayList;
 import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
 
 public class PushwooshPlugin extends ReactContextBaseJavaModule implements LifecycleEventListener {
 
@@ -95,25 +96,30 @@ public class PushwooshPlugin extends ReactContextBaseJavaModule implements Lifec
 		return "Pushwoosh";
 	}
 
+	@ReactMethod
+	public void setReverseProxy(String url, ReadableMap headers) {
+		Map<String, String> headersMap = null;
+		if (headers != null) {
+			headersMap = new HashMap<>();
+			for (Map.Entry<String, Object> entry : headers.toHashMap().entrySet()) {
+				headersMap.put(entry.getKey(), String.valueOf(entry.getValue()));
+			}
+		}
+		Pushwoosh.getInstance().setReverseProxy(url, headersMap);
+	}
+
 	@ReactMethod
 	public void init(ReadableMap config, Callback success, Callback error) {
-		String appId = config.getString("pw_appid");
-		String projectId = config.getString("project_number");
+		String appId = config.hasKey("pw_appid") ? config.getString("pw_appid") : null;
+		String projectId = config.hasKey("project_number") ? config.getString("project_number") : null;
 
-		if (appId == null || projectId == null) {
+		if (appId == null) {
 			if (error != null) {
-				error.invoke("Pushwoosh Application id and GCM project number not specified");
+				error.invoke("Pushwoosh Application id not specified");
 			}
 			return;
 		}
 
-		if (config.hasKey("reverse_proxy_url")) {
-			String proxyUrl = config.getString("reverse_proxy_url");
-			if (!TextUtils.isEmpty(proxyUrl) && NetworkModule.getRequestManager() != null) {
-				NetworkModule.getRequestManager().setReverseProxyUrl(proxyUrl);
-			}
-		}
-
 		Pushwoosh.getInstance().setAppId(appId);
 		
 		if (!TextUtils.isEmpty(projectId)) {

package/src/ios/PushwooshPlugin/Pushwoosh.m

@@ -15,6 +15,7 @@
 
 #import <UserNotifications/UserNotifications.h>
 #import <PushwooshFramework/PushNotificationManager.h>
+#import <PushwooshCore/PushwooshConfig.h>
 
 #import <objc/runtime.h>
 #import <objc/message.h>
@@ -127,11 +128,6 @@ RCT_EXPORT_METHOD(init:(NSDictionary*)config success:(RCTResponseSenderBlock)suc
         return;
     }
     
-    NSString *proxyUrl = config[@"reverse_proxy_url"];
-    if (proxyUrl && ![proxyUrl isEqualToString:@""]) {
-        [[Pushwoosh sharedInstance] setReverseProxy:proxyUrl];
-    }
-    
     [PushNotificationManager initializeWithAppCode:appCode appName:nil];
     [[PushNotificationManager pushManager] sendAppOpen];
     [PushNotificationManager pushManager].delegate = self;
@@ -896,6 +892,10 @@ RCT_EXPORT_METHOD(clearNotificationCenter){
 }
 
 
+RCT_EXPORT_METHOD(setReverseProxy:(NSString *)url headers:(NSDictionary *)headers) {
+    [PushwooshConfig setReverseProxy:url headers:headers];
+}
+
 RCT_EXPORT_METHOD(enableHuaweiPushNotifications) {
     // available in Android only
 }