pushwoosh-react-native-plugin 6.1.57 → 6.1.59

package/README.md

@@ -25,7 +25,7 @@
 
 - [Integration Guide](https://docs.pushwoosh.com/platform-docs/pushwoosh-sdk/cross-platform-frameworks/react-native/integrating-react-native-plugin) — step-by-step setup
 - [API Reference](docs/README.md) — full API documentation
-- [Sample Project](https://github.com/Pushwoosh/pushwoosh-react-native-sample) — ready-to-run demo app
+- [Sample Project](https://github.com/Pushwoosh/pushwoosh-react-native-plugin/tree/master/example/demoapp) — ready-to-run demo app
 
 ## Features
 

package/docs/README.md

@@ -46,6 +46,8 @@ DeviceEventEmitter.addListener('pushOpened', (e: Event) => {
 <tr class="even"><td><a href="#getpushtoken">getPushToken(success)</a></td></tr>
 <tr class="even"><td><a href="#gethwid">getHwid(success)</a></td></tr>
 <tr class="even"><td><a href="#setuserid">setUserId(userId, success, fail)</a></td></tr>
+<tr class="even"><td><a href="#setemails">setEmails(emails, success, fail)</a></td></tr>
+<tr class="even"><td><a href="#setuseremails">setUserEmails(userId, emails, success, fail)</a></td></tr>
 <tr class="even"><td><a href="#postevent">postEvent(event, attributes)</a></td></tr>
 <tr class="even"><td><a href="#setapplicationiconbadgenumber">setApplicationIconBadgeNumber(badgeNumber)</a></td></tr>
 <tr class="even"><td><a href="#getapplicationiconbadgenumber">getApplicationIconBadgeNumber(callback)</a></td></tr>
@@ -292,6 +294,75 @@ This allows data and events to be matched across multiple user devices.
 </table>
 
 
+### setEmails
+
+```js
+setEmails(emails, success, fail)
+```
+
+Registers email address(es) for the current user. The addresses are associated with the user identifier currently set on the device; if `setUserId` was never called, the device HWID is used as the identifier. Use `setUserEmails` to set the user identifier and the addresses in a single call.
+
+<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>array</td><td><b>emails</b></td><td>Array of email addresses associated with the current user.</td></tr>
+<tr class="even"><td>function</td><td><b>success</b></td><td>(optional) method success callback.</td></tr>
+<tr class="even"><td>function</td><td><b>fail</b></td><td>(optional) method failure callback.</td></tr>
+</tbody>
+</table>
+
+Example:
+
+```js
+Pushwoosh.setEmails(["user@example.com"],
+    function() { console.warn("setEmails success"); },
+    function(error) { console.warn("setEmails failed: " + error); }
+);
+```
+
+
+### setUserEmails
+
+```js
+setUserEmails(userId, emails, success, fail)
+```
+
+Registers email address(es) for a specific user identifier. The method sets the user identifier and registers the addresses in a single call, so data and events can be matched across multiple channels (push, email) for the same user. A separate `setUserId` call is not required.
+
+<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>userId</b></td><td>Identifier of currently logged in user</td></tr>
+<tr class="even"><td>array</td><td><b>emails</b></td><td>Array of email addresses associated with the user.</td></tr>
+<tr class="even"><td>function</td><td><b>success</b></td><td>(optional) method success callback.</td></tr>
+<tr class="even"><td>function</td><td><b>fail</b></td><td>(optional) method failure callback.</td></tr>
+</tbody>
+</table>
+
+Example:
+
+```js
+Pushwoosh.setUserEmails("user-123", ["user@example.com"],
+    function() { console.warn("setUserEmails success"); },
+    function(error) { console.warn("setUserEmails failed: " + error); }
+);
+```
+
+
 ### postEvent
 
 ```js

package/index.d.ts

@@ -51,8 +51,8 @@ declare module 'pushwoosh-react-native-plugin' {
     enableHuaweiPushNotifications(): void;
 
     //email methods
-    setUserEmails(userId: string, emails: (string | string[]), success?: () => void, fail?: (error: Error) => void): void;
-    setEmails(emails: (string | string[]), success?: () => void, fail?: (error: Error) => void): void; 
+    setUserEmails(userId: string, emails: (string | string[]), success?: () => void, fail?: (error: string) => void): void;
+    setEmails(emails: (string | string[]), success?: () => void, fail?: (error: string) => void): void; 
     //SMS and WhatsApp methods
     registerSMSNumber(phoneNumber: string): void;
     registerWhatsappNumber(phoneNumber: string): void;

package/index.js

@@ -383,14 +383,26 @@ class PushNotification {
 	//		}
 	//	);
 	//
-	setUserEmails(userId: string, emails: Object, success: ?Function, fail: ?Function) {
+	setUserEmails(userId: string, emails: string | Array<string>, success: ?Function, fail: ?Function) {
 		if (!success) {
 			success = function() {};
 		}
 		if (!fail) {
 			fail = function(error) {};
 		}
-		PushwooshModule.setUserEmails(userId, emails, success, fail);
+		// Both native SDKs return silently on an empty user id without touching the callback.
+		if (typeof userId !== 'string' || userId.length === 0) {
+			fail('userId must not be empty');
+			return;
+		}
+		// The native bridge accepts arrays only, while the public type allows a single address.
+		const emailsList = (Array.isArray(emails) ? emails : [emails])
+			.filter(email => typeof email === 'string' && email.length > 0);
+		if (emailsList.length === 0) {
+			fail('emails must be a non-empty array of strings');
+			return;
+		}
+		PushwooshModule.setUserEmails(userId, emailsList, success, fail);
 	}
 
 
@@ -408,14 +420,21 @@ class PushNotification {
 	//		}
 	//	);
 	//
-	setEmails(emails: Object, success: ?Function, fail: ?Function) {
+	setEmails(emails: string | Array<string>, success: ?Function, fail: ?Function) {
 		if (!success) {
 			success = function() {};
 		}
 		if (!fail) {
 			fail = function(error) {};
 		}
-		PushwooshModule.setEmails(emails, success, fail);
+		// The native bridge accepts arrays only, while the public type allows a single address.
+		const emailsList = (Array.isArray(emails) ? emails : [emails])
+			.filter(email => typeof email === 'string' && email.length > 0);
+		if (emailsList.length === 0) {
+			fail('emails must be a non-empty array of strings');
+			return;
+		}
+		PushwooshModule.setEmails(emailsList, success, fail);
 	}
 
 	//Function: registerSMSNumber

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pushwoosh-react-native-plugin",
-  "version": "6.1.57",
+  "version": "6.1.59",
   "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.57"
+  s.version          = "6.1.59"
   s.summary          = "React Native Pushwoosh Push Notifications module"
   s.requires_arc = true
   s.author       = 'Pushwoosh'
@@ -8,13 +8,13 @@ Pod::Spec.new do |s|
   s.homepage     = 'n/a'
   s.source       = { :git => "https://github.com/Pushwoosh/pushwoosh-react-native-plugin.git" }
   s.source_files = 'src/ios/PushwooshPlugin/Pushwoosh.{h,m}', 'src/ios/PushwooshPlugin/PWEventDispatcher.{h,m}'
-  s.platform     = :ios, "11.0"
+  s.platform     = :ios, "13.0"
   s.xcconfig = {
     "HEADER_SEARCH_PATHS" => "${PODS_ROOT}/Headers/Public/React"
   }
   s.static_framework = true
 
   s.dependency 'React'
-  s.dependency 'PushwooshXCFramework', '7.0.33'
+  s.dependency 'PushwooshXCFramework', '7.2.3'
   s.dependency 'PushwooshInboxUIXCFramework'
 end

package/src/android/build.gradle

@@ -37,7 +37,7 @@ android {
 }
 
 ext {
-    pushwoosh = "6.7.60"
+    pushwoosh = "6.10.2"
 }
 
 dependencies {

package/src/ios/PushwooshPlugin/Pushwoosh.m

@@ -34,6 +34,40 @@ static id objectOrNull(id object) {
     }
 }
 
+typedef void (^PWEmailsCompletion)(NSError *error);
+
+// The SDK invokes the completion once per address, an RCTResponseSenderBlock only once:
+// the first error wins, success is reported after the last address.
+static PWEmailsCompletion emailsCompletionHandler(NSUInteger addressCount, RCTResponseSenderBlock successCallback, RCTResponseSenderBlock errorCallback) {
+    NSObject *lock = [NSObject new];
+    __block NSUInteger completedCount = 0;
+    __block BOOL responded = NO;
+
+    return ^(NSError *error) {
+        @synchronized (lock) {
+            if (responded) {
+                return;
+            }
+
+            if (error) {
+                responded = YES;
+                if (errorCallback) {
+                    errorCallback(@[ objectOrNull([error localizedDescription]) ]);
+                }
+                return;
+            }
+
+            completedCount++;
+            if (completedCount >= addressCount) {
+                responded = YES;
+                if (successCallback) {
+                    successCallback(@[]);
+                }
+            }
+        }
+    };
+}
+
 static NSDictionary * gStartPushData = nil;
 static NSURL * gPushDeepLinkURL = nil;  // Deep link URL for New Architecture support
 static NSString * const kRegistrationSuccesEvent = @"PWRegistrationSuccess";
@@ -253,35 +287,34 @@ RCT_EXPORT_METHOD(getPushToken:(RCTResponseSenderBlock)callback) {
 }
 
 RCT_EXPORT_METHOD(setEmails:(NSArray *)emails success:(RCTResponseSenderBlock)successCallback error:(RCTResponseSenderBlock)errorCallback) {
-    __block NSError* gError = nil;
-    [[Pushwoosh sharedInstance] setEmails:emails completion:^(NSError * _Nullable error) {
-        if (error) {
-            gError = error;
+    if (emails.count == 0) {
+        // The SDK ignores an empty list without invoking the completion block.
+        if (errorCallback) {
+            errorCallback(@[ @"emails must be a non-empty array" ]);
         }
-    }];
-    if (!gError && successCallback) {
-        successCallback(@[]);
-    }
-    
-    if (gError && errorCallback) {
-        errorCallback(@[ objectOrNull([gError localizedDescription]) ]);
+        return;
     }
+
+    [[Pushwoosh sharedInstance] setEmails:emails completion:emailsCompletionHandler(emails.count, successCallback, errorCallback)];
 }
 
 RCT_EXPORT_METHOD(setUserEmails:(NSString*)userId emails:(NSArray *)emails success:(RCTResponseSenderBlock)successCallback error:(RCTResponseSenderBlock)errorCallback) {
-    __block NSError* gError = nil;
-    [[Pushwoosh sharedInstance] setUser:userId emails:emails completion:^(NSError * _Nullable error) {
-        if (error) {
-            gError = error;
+    if (userId.length == 0) {
+        // The SDK ignores an empty user id without invoking the completion block.
+        if (errorCallback) {
+            errorCallback(@[ @"userId must not be empty" ]);
         }
-    }];
-    if (!gError && successCallback) {
-        successCallback(@[]);
+        return;
     }
-    
-    if (gError && errorCallback) {
-        errorCallback(@[ objectOrNull([gError localizedDescription]) ]);
+
+    if (emails.count == 0) {
+        if (errorCallback) {
+            errorCallback(@[ @"emails must be a non-empty array" ]);
+        }
+        return;
     }
+
+    [[Pushwoosh sharedInstance] setUser:userId emails:emails completion:emailsCompletionHandler(emails.count, successCallback, errorCallback)];
 }
 
 RCT_EXPORT_METHOD(setTags:(NSDictionary*)tags success:(RCTResponseSenderBlock)successCallback error:(RCTResponseSenderBlock)errorCallback) {