@voipsdk/react-native-voipcloud 1.0.5 → 1.0.6

package/CHANGELOG.md

@@ -5,6 +5,37 @@ All notable changes to `@voipsdk/react-native-voipcloud` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.6] - 2026-08-10
+
+Folds in the push-wake registration-refresh fixes that were living as an app-side
+`patch-package` patch (`@voipsdk+react-native-voipcloud+1.0.5.patch`), so a fresh
+install behaves correctly without any patch. Root-cause mitigation for the
+multi-contact fork that yields **482 Loop Detected** and slow-or-missed calls
+after a NAT-port change on a push-wake.
+
+### Added
+
+- `VoipCloud.refreshRegistration(accountId)` — re-send REGISTER on the EXISTING
+  account (renew, same socket/binding) instead of `unregister()` + `register()`.
+  Reuses the live PJSIP account so the registrar updates the SAME binding — no new
+  contact, no fork. Prefer it over `register()` on a push-wake / periodic refresh;
+  rejects `VC_REFRESH` if the account was never registered (fall back to
+  `register()` on a cold start). Wired on iOS (`refreshRegistrationAccount:error:`)
+  and Android.
+- Stable per-install SIP instance id (`+sip.instance`, RFC 5626 form) on the
+  Contact of each account, so a one-contact-per-AOR registrar (Kamailio
+  `max_contacts=1` / `matching_mode=instance`, Asterisk PJSIP `remove_existing=yes`)
+  replaces the device's previous binding instead of appending. Uses
+  `identifierForVendor` (iOS) / `ANDROID_ID` (Android); harmless if the server
+  ignores it.
+
+### Changed / Fixed
+
+- **iOS:** `natConfig.contactUseSrcPort = 1` — keep the learned NAT source **port**
+  (not just the IP) in the rewritten Contact, matching Android. Fixes stale-port
+  Contacts after an iOS suspend/rebind that routed inbound INVITEs to a dead port
+  and prevented re-REGISTER from matching the old binding.
+
 ## [1.0.3] - 2026-07-17
 
 Folds in the NAT / media / call-routing fixes that were living as app-side

package/README.md

@@ -146,6 +146,7 @@ export function useVoipEvents() {
 | `shutdown()` | Hang up all, destroy endpoint |
 | `register(account)` | Register SIP account → `accountId` |
 | `unregister(accountId)` | Unregister account |
+| `refreshRegistration(accountId)` | Re-REGISTER an existing account (renew, same binding) — push-wake refresh that avoids contact churn / 482 |
 | `makeCall(accountId, uri)` | Outbound call → `callId` |
 | `answer(callId)` | Answer incoming call |
 | `hangup(callId, mode?)` | End one call (`mode`: `'normal'` \| `'busy'` \| `'cancel'`) |

package/android/src/main/java/com/voipcloud/sdk/rn/VoipCloudModule.java

@@ -276,6 +276,25 @@ public class VoipCloudModule extends ReactContextBaseJavaModule {
             AuthCredInfo cred = new AuthCredInfo("digest", "*", username, 0, password);
             acfg.getSipConfig().getAuthCreds().add(cred);
 
+            // Stable per-install SIP instance id (+sip.instance) so the registrar
+            // can REPLACE this device's previous binding on re-REGISTER instead of
+            // appending a new contact — root-cause mitigation for the multi-contact
+            // fork that yields 482 Loop Detected (needs a one-contact-per-AOR server
+            // policy; harmless if the server ignores it). ANDROID_ID is stable per
+            // app-signing-key per device and resets on reinstall — the lifetime we
+            // want for a device-binding id. Mirrors the iOS engine
+            // (identifierForVendor). Wrapped so a lookup failure never breaks
+            // registration. The value is matched opaquely by the registrar.
+            try {
+                String androidId = android.provider.Settings.Secure.getString(
+                    ctx.getContentResolver(),
+                    android.provider.Settings.Secure.ANDROID_ID);
+                if (androidId != null && !androidId.isEmpty()) {
+                    acfg.getSipConfig().setContactParams(
+                        ";+sip.instance=\"<urn:uuid:" + androidId + ">\"");
+                }
+            } catch (Throwable ignored) {}
+
             ManagedAccount acc = new ManagedAccount(ctx, calls, endpoint);
             acc.create(acfg);
             int id = acc.accountId();
@@ -306,6 +325,29 @@ public class VoipCloudModule extends ReactContextBaseJavaModule {
         }
     }
 
+    // Re-REGISTER on the EXISTING account (renew) instead of unregister()+register().
+    // On a push-wake the account/transport are still alive, so this re-REGISTERs
+    // from the SAME socket and the registrar updates the SAME binding — no new
+    // contact, no fork (the churn behind 482 Loop Detected / slow-or-missed calls).
+    // Prefer this over unregister+register whenever the account already exists
+    // (see VoipCloudSipManager warm-refresh path).
+    @ReactMethod
+    public void refreshRegistration(int accountId, Promise promise) {
+        if (!BridgeGuard.ensureNative(promise)) return;
+        try {
+            ManagedAccount acc = accounts.get(accountId);
+            if (acc == null) {
+                promise.reject("VC_REFRESH",
+                    "Unknown accountId " + accountId + ". Call register() first.");
+                return;
+            }
+            acc.setRegistration(true);
+            promise.resolve(null);
+        } catch (Throwable t) {
+            BridgeGuard.reject(promise, "VC_REFRESH", "Failed to refresh registration", t);
+        }
+    }
+
     @ReactMethod
     public void makeCall(int accountId, String uri, Promise promise) {
         if (!BridgeGuard.ensureNative(promise)) return;

package/ios/VoipCloud.mm

@@ -98,6 +98,17 @@ RCT_EXPORT_METHOD(unregister:(NSInteger)accountId
     else reject(@"VC_UNREGISTER", err.localizedDescription ?: @"Failed to unregister account", err);
 }
 
+// Re-REGISTER on the existing account (renew, same socket) — the push-wake refresh
+// that avoids the unregister+recreate contact churn behind 482 / slow calls.
+RCT_EXPORT_METHOD(refreshRegistration:(NSInteger)accountId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+    NSError *err = nil;
+    if ([VoipCloudEngine.shared refreshRegistrationAccount:(int)accountId error:&err]) resolve(nil);
+    else reject(@"VC_REFRESH", err.localizedDescription ?: @"Failed to refresh registration", err);
+}
+
 #pragma mark - Calls
 
 RCT_EXPORT_METHOD(makeCall:(NSInteger)accountId

package/ios/VoipCloudEngine.h

@@ -42,6 +42,10 @@ NS_ASSUME_NONNULL_BEGIN
 /// Returns the accountId, or -1 on failure (with *error set).
 - (int)registerAccountWithConfig:(NSDictionary *)cfg error:(NSError **)error;
 - (BOOL)unregisterAccount:(int)accountId error:(NSError **)error;
+/// Re-send REGISTER on the EXISTING account (renew, same socket/Contact) instead
+/// of unregister+recreate — the push-wake refresh that avoids contact churn/482.
+/// NO (with *error) if the account was never registered.
+- (BOOL)refreshRegistrationAccount:(int)accountId error:(NSError **)error;
 
 /// Place a call from `accountId` to `uri` (full SIP URI).  Returns callId, or -1.
 - (int)makeCallFromAccount:(int)accountId toUri:(NSString *)uri error:(NSError **)error;

package/ios/VoipCloudEngine.mm

@@ -4,6 +4,7 @@
 //
 #import "VoipCloudEngine.h"
 #import <AVFoundation/AVFoundation.h>
+#import <UIKit/UIKit.h>   // UIDevice.identifierForVendor — stable per-install SIP instance id
 #include <pjsua2.hpp>
 #include <pjsua-lib/pjsua.h>
 #include <string>
@@ -419,10 +420,40 @@ void VCCall::onDtmfDigit(OnDtmfDigitParam &prm) {
         acfg.natConfig.contactRewriteUse = 1;
         acfg.natConfig.viaRewriteUse = 1;
         acfg.natConfig.udpKaIntervalSec = 20;
+        // Keep the learned NAT source PORT (not just the source IP) in the
+        // rewritten Contact — PARITY WITH ANDROID (setContactUseSrcPort(1)),
+        // previously missing on iOS. After iOS suspends the app the OS rebinds the
+        // NAT pinhole to a NEW port; the next REGISTER must advertise the EXACT
+        // ip:port it now sends from. Without this the Contact can carry a stale
+        // port, so (a) inbound INVITEs route to the dead port and (b) an
+        // unregister/re-REGISTER from the new port cannot match the old binding at
+        // the registrar → the AOR accumulates contacts → the PBX forks the INVITE
+        // to all of them → 482 Loop Detected + losing branches CANCELled.
+        acfg.natConfig.contactUseSrcPort = 1;
         acfg.regConfig.timeoutSec = 120;
         acfg.regConfig.firstRetryIntervalSec = 5;
         acfg.regConfig.retryIntervalSec = 30;
 
+        // Stable per-install SIP instance id (+sip.instance, RFC 5626 form). The
+        // registrar can then REPLACE this device's previous binding on every
+        // re-REGISTER instead of appending a new contact. Combined with a
+        // one-contact-per-AOR server policy (Kamailio max_contacts=1 /
+        // matching_mode=instance, or Asterisk PJSIP remove_existing=yes) this is
+        // the root-cause fix for the multi-contact fork that yields 482 Loop
+        // Detected after a NAT-port change on a push-wake. It is HARMLESS when the
+        // server ignores it (just an extra Contact param). identifierForVendor is
+        // stable across launches/suspends for this vendor's apps and only resets on
+        // reinstall — exactly the lifetime wanted for a device-binding id. We set
+        // it via contactParams (Contact header suffix) rather than enabling full
+        // outbound (sipOutboundUse), which would require server Path support.
+        NSString *vendorId = [[UIDevice currentDevice] identifierForVendor].UUIDString;
+        if (vendorId.length) {
+            std::string instance = ";+sip.instance=\"<urn:uuid:";
+            instance += std::string(vendorId.UTF8String);
+            instance += ">\"";
+            acfg.sipConfig.contactParams = instance;
+        }
+
         // STUN for MEDIA only: without it the SDP offer carries the LAN IP
         // (c=192.168.x) and the far end sends RTP to an unroutable address →
         // no 2-way audio. Falls back to the host addr if STUN is unreachable.
@@ -486,6 +517,35 @@ void VCCall::onDtmfDigit(OnDtmfDigitParam &prm) {
     return YES;
 }
 
+// Re-send REGISTER on the EXISTING account instead of unregister()+register().
+//
+// On an iOS VoIP push-wake the app was only SUSPENDED (not killed): the PJSUA
+// account and its pinned UDP transport/socket are still alive, so a plain refresh
+// re-REGISTERs from the SAME NAT source port and the registrar updates the SAME
+// binding. Delete+recreate (the old path) instead built a brand-new account on a
+// new ephemeral port, so the registrar saw a NEW contact while the stale one
+// lingered — the multi-contact churn behind 482 Loop Detected / slow-or-missed
+// calls. Prefer this whenever the account already exists (see VoipCloudSipManager
+// warm-refresh path); fall back to register() only on a cold start (no account).
+//
+// setRegistration(true) forces PJSIP to send REGISTER now (renew) even before the
+// timer elapses; autoreg stays on so periodic refresh continues normally.
+- (BOOL)refreshRegistrationAccount:(int)accountId error:(NSError **)error {
+    auto it = _accounts.find(accountId);
+    if (it == _accounts.end()) {
+        if (error) *error = VCMakeError(-1, [NSString stringWithFormat:
+            @"Unknown accountId %d. Call register() first.", accountId]);
+        return NO;
+    }
+    try {
+        it->second->setRegistration(true);
+        return YES;
+    } catch (Error &err) {
+        if (error) *error = VCMakeError(err.status, VCStr(err.info()));
+        return NO;
+    }
+}
+
 #pragma mark Calls
 
 - (int)makeCallFromAccount:(int)accountId toUri:(NSString *)uri error:(NSError **)error {

package/lib/commonjs/VoipCloud.js

@@ -39,6 +39,17 @@ const VoipCloud = exports.VoipCloud = {
   unregister(accountId) {
     return callNative(() => _nativeModule.NativeVoipCloud.unregister(accountId));
   },
+  /**
+   * Re-send REGISTER on an EXISTING account (renew) without unregister+recreate.
+   * Reuses the same PJSIP account/socket, so the registrar updates the SAME
+   * binding — no new contact. Prefer this over `register()` on a push-wake or
+   * periodic refresh (avoids the multi-contact churn behind 482 Loop Detected /
+   * slow-or-missed calls). Rejects with `VC_REFRESH` if `accountId` was never
+   * registered — the caller should fall back to `register()` on a cold start.
+   */
+  refreshRegistration(accountId) {
+    return callNative(() => _nativeModule.NativeVoipCloud.refreshRegistration(accountId));
+  },
   makeCall(accountId, destinationUri) {
     return callNative(() => _nativeModule.NativeVoipCloud.makeCall(accountId, destinationUri));
   },

package/lib/commonjs/VoipCloud.js.map

@@ -1 +1 @@
-{"version":3,"names":["_nativeModule","require","_events","rejectNotLinked","Promise","reject","Object","assign","Error","code","callNative","fn","NativeVoipCloud","VoipCloud","exports","init","cfg","shutdown","register","account","unregister","accountId","makeCall","destinationUri","answer","callId","hangup","mode","hold","unhold","mute","on","sendDtmf","digits","transferCall","hangupAllCalls","reconnectCallAudio"],"sourceRoot":"../../src","sources":["VoipCloud.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_nativeModule","require","_events","rejectNotLinked","Promise","reject","Object","assign","Error","code","callNative","fn","NativeVoipCloud","VoipCloud","exports","init","cfg","shutdown","register","account","unregister","accountId","refreshRegistration","makeCall","destinationUri","answer","callId","hangup","mode","hold","unhold","mute","on","sendDtmf","digits","transferCall","hangupAllCalls","reconnectCallAudio"],"sourceRoot":"../../src","sources":["VoipCloud.ts"],"mappings":";;;;;;AACA,IAAAA,aAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAEA;AACA,SAASE,eAAeA,CAAA,EAAmB;EACvC,OAAOC,OAAO,CAACC,MAAM,CACjBC,MAAM,CAACC,MAAM,CACT,IAAIC,KAAK,CACL,+DAA+D,GAC/D,+CAA+C,GAC/C,gFACJ,CAAC,EACD;IAAEC,IAAI,EAAE;EAAgB,CAC5B,CACJ,CAAC;AACL;AAEA,SAASC,UAAUA,CAAIC,EAAoB,EAAc;EACrD,IAAI,CAACC,6BAAe,EAAE,OAAOT,eAAe,CAAC,CAAC;EAC9C,OAAOQ,EAAE,CAAC,CAAC;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAME,SAAS,GAAAC,OAAA,CAAAD,SAAA,GAAG;EACrBE,IAAIA,CAACC,GAAe,GAAG,CAAC,CAAC,EAAiB;IACtC,OAAON,UAAU,CAAC,MAAME,6BAAe,CAACG,IAAI,CAACC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;EAC5D,CAAC;EAEDC,QAAQA,CAAA,EAAkB;IACtB,OAAOP,UAAU,CAAC,MAAME,6BAAe,CAACK,QAAQ,CAAC,CAAC,CAAC;EACvD,CAAC;EAEDC,QAAQA,CAACC,OAAsB,EAAmB;IAC9C,OAAOT,UAAU,CAAC,MAAME,6BAAe,CAACM,QAAQ,CAACC,OAAO,CAAC,CAAC;EAC9D,CAAC;EAEDC,UAAUA,CAACC,SAAiB,EAAiB;IACzC,OAAOX,UAAU,CAAC,MAAME,6BAAe,CAACQ,UAAU,CAACC,SAAS,CAAC,CAAC;EAClE,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;EACIC,mBAAmBA,CAACD,SAAiB,EAAiB;IAClD,OAAOX,UAAU,CAAC,MAAME,6BAAe,CAACU,mBAAmB,CAACD,SAAS,CAAC,CAAC;EAC3E,CAAC;EAEDE,QAAQA,CAACF,SAAiB,EAAEG,cAAsB,EAAmB;IACjE,OAAOd,UAAU,CAAC,MAAME,6BAAe,CAACW,QAAQ,CAACF,SAAS,EAAEG,cAAc,CAAC,CAAC;EAChF,CAAC;EAEDC,MAAMA,CAACC,MAAc,EAAiB;IAClC,OAAOhB,UAAU,CAAC,MAAME,6BAAe,CAACa,MAAM,CAACC,MAAM,CAAC,CAAC;EAC3D,CAAC;EAEDC,MAAMA,CAACD,MAAc,EAAEE,IAAkC,GAAG,QAAQ,EAAiB;IACjF,OAAOlB,UAAU,CAAC,MAAME,6BAAe,CAACe,MAAM,CAACD,MAAM,EAAEE,IAAI,CAAC,CAAC;EACjE,CAAC;EAEDC,IAAIA,CAACH,MAAc,EAAiB;IAChC,OAAOhB,UAAU,CAAC,MAAME,6BAAe,CAACiB,IAAI,CAACH,MAAM,CAAC,CAAC;EACzD,CAAC;EAEDI,MAAMA,CAACJ,MAAc,EAAiB;IAClC,OAAOhB,UAAU,CAAC,MAAME,6BAAe,CAACkB,MAAM,CAACJ,MAAM,CAAC,CAAC;EAC3D,CAAC;EAEDK,IAAIA,CAACL,MAAc,EAAEM,EAAW,EAAiB;IAC7C,OAAOtB,UAAU,CAAC,MAAME,6BAAe,CAACmB,IAAI,CAACL,MAAM,EAAEM,EAAE,CAAC,CAAC;EAC7D,CAAC;EAEDC,QAAQA,CAACP,MAAc,EAAEQ,MAAc,EAAiB;IACpD,OAAOxB,UAAU,CAAC,MAAME,6BAAe,CAACqB,QAAQ,CAACP,MAAM,EAAEQ,MAAM,CAAC,CAAC;EACrE,CAAC;EAEDC,YAAYA,CAACT,MAAc,EAAEF,cAAsB,EAAiB;IAChE,OAAOd,UAAU,CAAC,MAAME,6BAAe,CAACuB,YAAY,CAACT,MAAM,EAAEF,cAAc,CAAC,CAAC;EACjF,CAAC;EAEDY,cAAcA,CAAA,EAAkB;IAC5B,OAAO1B,UAAU,CAAC,MAAME,6BAAe,CAACwB,cAAc,CAAC,CAAC,CAAC;EAC7D,CAAC;EAEDC,kBAAkBA,CAACX,MAAc,EAAiB;IAC9C,OAAOhB,UAAU,CAAC,MAAME,6BAAe,CAACyB,kBAAkB,CAACX,MAAM,CAAC,CAAC;EACvE,CAAC;EAEDM,EAAE,EAAFA;AACJ,CAAC","ignoreList":[]}

package/lib/module/VoipCloud.js

@@ -34,6 +34,17 @@ export const VoipCloud = {
   unregister(accountId) {
     return callNative(() => NativeVoipCloud.unregister(accountId));
   },
+  /**
+   * Re-send REGISTER on an EXISTING account (renew) without unregister+recreate.
+   * Reuses the same PJSIP account/socket, so the registrar updates the SAME
+   * binding — no new contact. Prefer this over `register()` on a push-wake or
+   * periodic refresh (avoids the multi-contact churn behind 482 Loop Detected /
+   * slow-or-missed calls). Rejects with `VC_REFRESH` if `accountId` was never
+   * registered — the caller should fall back to `register()` on a cold start.
+   */
+  refreshRegistration(accountId) {
+    return callNative(() => NativeVoipCloud.refreshRegistration(accountId));
+  },
   makeCall(accountId, destinationUri) {
     return callNative(() => NativeVoipCloud.makeCall(accountId, destinationUri));
   },

package/lib/module/VoipCloud.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeVoipCloud","on","rejectNotLinked","Promise","reject","Object","assign","Error","code","callNative","fn","VoipCloud","init","cfg","shutdown","register","account","unregister","accountId","makeCall","destinationUri","answer","callId","hangup","mode","hold","unhold","mute","sendDtmf","digits","transferCall","hangupAllCalls","reconnectCallAudio"],"sourceRoot":"../../src","sources":["VoipCloud.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativeVoipCloud","on","rejectNotLinked","Promise","reject","Object","assign","Error","code","callNative","fn","VoipCloud","init","cfg","shutdown","register","account","unregister","accountId","refreshRegistration","makeCall","destinationUri","answer","callId","hangup","mode","hold","unhold","mute","sendDtmf","digits","transferCall","hangupAllCalls","reconnectCallAudio"],"sourceRoot":"../../src","sources":["VoipCloud.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/VoipCloud.d.ts

@@ -14,6 +14,15 @@ export declare const VoipCloud: {
     shutdown(): Promise<void>;
     register(account: AccountConfig): Promise<number>;
     unregister(accountId: number): Promise<void>;
+    /**
+     * Re-send REGISTER on an EXISTING account (renew) without unregister+recreate.
+     * Reuses the same PJSIP account/socket, so the registrar updates the SAME
+     * binding — no new contact. Prefer this over `register()` on a push-wake or
+     * periodic refresh (avoids the multi-contact churn behind 482 Loop Detected /
+     * slow-or-missed calls). Rejects with `VC_REFRESH` if `accountId` was never
+     * registered — the caller should fall back to `register()` on a cold start.
+     */
+    refreshRegistration(accountId: number): Promise<void>;
     makeCall(accountId: number, destinationUri: string): Promise<number>;
     answer(callId: number): Promise<void>;
     hangup(callId: number, mode?: "busy" | "cancel" | "normal"): Promise<void>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@voipsdk/react-native-voipcloud",
-  "version": "1.0.5",
-  "description": "Public React Native VoIP SDK backed by PJSIP (VoipCloud).",
+  "version": "1.0.6",
+  "description": "Public React Native VoIP SDK (VoipCloud).",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",

package/src/VoipCloud.ts

@@ -47,6 +47,18 @@ export const VoipCloud = {
         return callNative(() => NativeVoipCloud.unregister(accountId));
     },
 
+    /**
+     * Re-send REGISTER on an EXISTING account (renew) without unregister+recreate.
+     * Reuses the same PJSIP account/socket, so the registrar updates the SAME
+     * binding — no new contact. Prefer this over `register()` on a push-wake or
+     * periodic refresh (avoids the multi-contact churn behind 482 Loop Detected /
+     * slow-or-missed calls). Rejects with `VC_REFRESH` if `accountId` was never
+     * registered — the caller should fall back to `register()` on a cold start.
+     */
+    refreshRegistration(accountId: number): Promise<void> {
+        return callNative(() => NativeVoipCloud.refreshRegistration(accountId));
+    },
+
     makeCall(accountId: number, destinationUri: string): Promise<number> {
         return callNative(() => NativeVoipCloud.makeCall(accountId, destinationUri));
     },