@voipsdk/react-native-voipcloud 0.2.1 → 1.0.1

package/lib/module/VoipCloud.js

@@ -1,83 +1,69 @@
-import { NativeModules } from 'react-native';
-import { License } from './License';
+import { NativeVoipCloud } from './nativeModule';
 import { on } from './events';
-const Native = NativeModules.VoipCloud;
+
+/** Thrown as Promise rejection — never crashes at import time. */
+function rejectNotLinked() {
+  return Promise.reject(Object.assign(new Error('@voipsdk/react-native-voipcloud native module is not linked. ' + 'Install the package, rebuild the Android app ' + '(./gradlew clean assembleDebug), and ensure voipcloud-release.aar is packaged.'), {
+    code: 'VC_NOT_LINKED'
+  }));
+}
+function callNative(fn) {
+  if (!NativeVoipCloud) return rejectNotLinked();
+  return fn();
+}
 
 /**
- * Top-level VoIP SDK.  Workflow:
+ * Top-level VoIP SDK for {@code @voipsdk/react-native-voipcloud}.  Workflow:
  *
- *   1. {@link License.set} — install a token (paste from your portal).
- *   2. {@link init} — start the PJSIP endpoint.
- *   3. {@link register} — get an `accountId` back.
- *   4. {@link makeCall} / {@link answer} / {@link hangup}.
+ *   1. {@link init} — start the PJSIP endpoint.
+ *   2. {@link register} — get an `accountId` back.
+ *   3. {@link makeCall} / {@link answer} / {@link hangup}.
  *
- * Every method returns a Promise.  License-gate failures surface as a
- * Promise rejection with `code = "VC_<NAME>"` matching the
- * `PJ_EVOIPCLOUD_*` enum from `voipcloud_errno.h`.
+ * Every method returns a Promise.  Failures reject with a `VC_*` code.
  */
 export const VoipCloud = {
-  // ---------------------- License ---------------------------------
-  License,
-  // ---------------------- Lifecycle -------------------------------
   init(cfg = {}) {
-    return Native.init(cfg);
+    return callNative(() => NativeVoipCloud.init(cfg ?? {}));
   },
   shutdown() {
-    return Native.shutdown();
+    return callNative(() => NativeVoipCloud.shutdown());
   },
-  // ---------------------- Accounts --------------------------------
-  /** Register a new SIP account. Resolves with the account id. */
   register(account) {
-    return Native.register(account);
+    return callNative(() => NativeVoipCloud.register(account));
   },
   unregister(accountId) {
-    return Native.unregister(accountId);
+    return callNative(() => NativeVoipCloud.unregister(accountId));
   },
-  // ---------------------- Calls -----------------------------------
-  /** Place an outbound call. Resolves with the new callId. */
   makeCall(accountId, destinationUri) {
-    return Native.makeCall(accountId, destinationUri);
+    return callNative(() => NativeVoipCloud.makeCall(accountId, destinationUri));
   },
   answer(callId) {
-    return Native.answer(callId);
+    return callNative(() => NativeVoipCloud.answer(callId));
   },
-  hangup(callId) {
-    return Native.hangup(callId);
+  hangup(callId, mode = 'normal') {
+    return callNative(() => NativeVoipCloud.hangup(callId, mode));
   },
   hold(callId) {
-    return Native.hold(callId);
+    return callNative(() => NativeVoipCloud.hold(callId));
   },
   unhold(callId) {
-    return Native.unhold(callId);
+    return callNative(() => NativeVoipCloud.unhold(callId));
   },
-  /**
-   * Mute / unmute the local microphone for a call.  Implemented by
-   * stopping / starting the capture device's transmission to the
-   * call's active audio media — independent of `hold`.  A
-   * `callMediaState` event fires after the toggle so the UI can
-   * mirror the new `isMuted` flag without polling.
-   */
   mute(callId, on) {
-    return Native.mute(callId, on);
+    return callNative(() => NativeVoipCloud.mute(callId, on));
   },
   sendDtmf(callId, digits) {
-    return Native.sendDtmf(callId, digits);
+    return callNative(() => NativeVoipCloud.sendDtmf(callId, digits));
   },
-  /**
-   * Blind-transfer a call (SIP REFER) to a new destination.  The
-   * local leg moves to DISCONNECTED once the remote party accepts.
-   */
   transferCall(callId, destinationUri) {
-    return Native.transferCall(callId, destinationUri);
+    return callNative(() => NativeVoipCloud.transferCall(callId, destinationUri));
   },
-  /**
-   * End every active call.  Each call still emits its own
-   * `callState` event with state=DISCONNECTED.
-   */
   hangupAllCalls() {
-    return Native.hangupAllCalls();
+    return callNative(() => NativeVoipCloud.hangupAllCalls());
+  },
+  reconnectCallAudio(callId) {
+    return callNative(() => NativeVoipCloud.reconnectCallAudio(callId));
   },
-  // ---------------------- Events ----------------------------------
   on
 };
 //# sourceMappingURL=VoipCloud.js.map

package/lib/module/VoipCloud.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","License","on","Native","VoipCloud","init","cfg","shutdown","register","account","unregister","accountId","makeCall","destinationUri","answer","callId","hangup","hold","unhold","mute","sendDtmf","digits","transferCall","hangupAllCalls"],"sourceRoot":"../../src","sources":["VoipCloud.ts"],"mappings":"AAAA,SAASA,aAAa,QAAQ,cAAc;AAE5C,SAASC,OAAO,QAAQ,WAAW;AACnC,SAASC,EAAE,QAAQ,UAAU;AAE7B,MAAMC,MAAM,GAAGH,aAAa,CAACI,SAAS;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,SAAS,GAAG;EACrB;EACAH,OAAO;EAEP;EACAI,IAAIA,CAACC,GAAe,GAAG,CAAC,CAAC,EAAiB;IACtC,OAAOH,MAAM,CAACE,IAAI,CAACC,GAAG,CAAC;EAC3B,CAAC;EAEDC,QAAQA,CAAA,EAAkB;IACtB,OAAOJ,MAAM,CAACI,QAAQ,CAAC,CAAC;EAC5B,CAAC;EAED;EACA;EACAC,QAAQA,CAACC,OAAsB,EAAmB;IAC9C,OAAON,MAAM,CAACK,QAAQ,CAACC,OAAO,CAAC;EACnC,CAAC;EAEDC,UAAUA,CAACC,SAAiB,EAAiB;IACzC,OAAOR,MAAM,CAACO,UAAU,CAACC,SAAS,CAAC;EACvC,CAAC;EAED;EACA;EACAC,QAAQA,CAACD,SAAiB,EAAEE,cAAsB,EAAmB;IACjE,OAAOV,MAAM,CAACS,QAAQ,CAACD,SAAS,EAAEE,cAAc,CAAC;EACrD,CAAC;EAEDC,MAAMA,CAACC,MAAc,EAAiB;IAClC,OAAOZ,MAAM,CAACW,MAAM,CAACC,MAAM,CAAC;EAChC,CAAC;EAEDC,MAAMA,CAACD,MAAc,EAAiB;IAClC,OAAOZ,MAAM,CAACa,MAAM,CAACD,MAAM,CAAC;EAChC,CAAC;EAEDE,IAAIA,CAACF,MAAc,EAAiB;IAChC,OAAOZ,MAAM,CAACc,IAAI,CAACF,MAAM,CAAC;EAC9B,CAAC;EAEDG,MAAMA,CAACH,MAAc,EAAiB;IAClC,OAAOZ,MAAM,CAACe,MAAM,CAACH,MAAM,CAAC;EAChC,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;EACII,IAAIA,CAACJ,MAAc,EAAEb,EAAW,EAAiB;IAC7C,OAAOC,MAAM,CAACgB,IAAI,CAACJ,MAAM,EAAEb,EAAE,CAAC;EAClC,CAAC;EAEDkB,QAAQA,CAACL,MAAc,EAAEM,MAAc,EAAiB;IACpD,OAAOlB,MAAM,CAACiB,QAAQ,CAACL,MAAM,EAAEM,MAAM,CAAC;EAC1C,CAAC;EAED;AACJ;AACA;AACA;EACIC,YAAYA,CAACP,MAAc,EAAEF,cAAsB,EAAiB;IAChE,OAAOV,MAAM,CAACmB,YAAY,CAACP,MAAM,EAAEF,cAAc,CAAC;EACtD,CAAC;EAED;AACJ;AACA;AACA;EACIU,cAAcA,CAAA,EAAkB;IAC5B,OAAOpB,MAAM,CAACoB,cAAc,CAAC,CAAC;EAClC,CAAC;EAED;EACArB;AACJ,CAAC","ignoreList":[]}
+{"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":[]}

package/lib/module/events.js

@@ -1,13 +1,11 @@
-import { NativeEventEmitter, NativeModules } from 'react-native';
-const Native = NativeModules.VoipCloud;
-
-// Lazy emitter — must point at the module to satisfy the contract
-// NativeEventEmitter expects on RN 0.65+.
-const emitter = Native ? new NativeEventEmitter(Native) : null;
+import { NativeEventEmitter } from 'react-native';
+import { NATIVE_MODULE_NAME, NativeVoipCloud } from './nativeModule';
+const emitter = NativeVoipCloud ? new NativeEventEmitter(NativeVoipCloud) : null;
 
 /**
- * Subscribe to a typed event.  Returns a handle whose `remove()` must
- * be called from a React `useEffect` cleanup to avoid leaks.
+ * Subscribe to a typed event from {@code @voipsdk/react-native-voipcloud}.
+ * Returns a handle whose `remove()` must be called from a React `useEffect`
+ * cleanup to avoid leaks.
  */
 export function on(name, callback) {
   if (!emitter) {
@@ -20,4 +18,7 @@ export function on(name, callback) {
     remove: () => sub.remove()
   };
 }
+
+/** Native module name registered with React Native (for debugging). */
+export { NATIVE_MODULE_NAME };
 //# sourceMappingURL=events.js.map

package/lib/module/events.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeModules","Native","VoipCloud","emitter","on","name","callback","remove","sub","addListener"],"sourceRoot":"../../src","sources":["events.ts"],"mappings":"AAAA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,cAAc;AAGhE,MAAMC,MAAM,GAAGD,aAAa,CAACE,SAAS;;AAEtC;AACA;AACA,MAAMC,OAAO,GAAGF,MAAM,GAAG,IAAIF,kBAAkB,CAACE,MAAM,CAAC,GAAG,IAAI;;AAE9D;AACA;AACA;AACA;AACA,OAAO,SAASG,EAAEA,CACdC,IAAO,EACPC,QAAsC,EAC1B;EACZ,IAAI,CAACH,OAAO,EAAE;IACV,OAAO;MAAEI,MAAM,EAAEA,CAAA,KAAM,CAAC;IAAE,CAAC;EAC/B;EACA,MAAMC,GAAG,GAAGL,OAAO,CAACM,WAAW,CAACJ,IAAI,EAAEC,QAAgC,CAAC;EACvE,OAAO;IAAEC,MAAM,EAAEA,CAAA,KAAMC,GAAG,CAACD,MAAM,CAAC;EAAE,CAAC;AACzC","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","NATIVE_MODULE_NAME","NativeVoipCloud","emitter","on","name","callback","remove","sub","addListener"],"sourceRoot":"../../src","sources":["events.ts"],"mappings":"AAAA,SAASA,kBAAkB,QAAQ,cAAc;AAEjD,SAASC,kBAAkB,EAAEC,eAAe,QAAQ,gBAAgB;AAEpE,MAAMC,OAAO,GAAGD,eAAe,GAAG,IAAIF,kBAAkB,CAACE,eAAe,CAAC,GAAG,IAAI;;AAEhF;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,EAAEA,CACdC,IAAO,EACPC,QAAsC,EAC1B;EACZ,IAAI,CAACH,OAAO,EAAE;IACV,OAAO;MAAEI,MAAM,EAAEA,CAAA,KAAM,CAAC;IAAE,CAAC;EAC/B;EACA,MAAMC,GAAG,GAAGL,OAAO,CAACM,WAAW,CAACJ,IAAI,EAAEC,QAAgC,CAAC;EACvE,OAAO;IAAEC,MAAM,EAAEA,CAAA,KAAMC,GAAG,CAACD,MAAM,CAAC;EAAE,CAAC;AACzC;;AAEA;AACA,SAASN,kBAAkB","ignoreList":[]}

package/lib/module/index.js

@@ -1,4 +1,3 @@
 export { VoipCloud } from './VoipCloud';
-export { License } from './License';
-export { on as addEventListener } from './events';
+export { on as addEventListener, NATIVE_MODULE_NAME } from './events';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["VoipCloud","License","on","addEventListener"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA,SAASA,SAAS,QAAQ,aAAa;AACvC,SAASC,OAAO,QAAQ,WAAW;AACnC,SAASC,EAAE,IAAIC,gBAAgB,QAAQ,UAAU","ignoreList":[]}
+{"version":3,"names":["VoipCloud","on","addEventListener","NATIVE_MODULE_NAME"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA,SAASA,SAAS,QAAQ,aAAa;AACvC,SAASC,EAAE,IAAIC,gBAAgB,EAAEC,kBAAkB,QAAQ,UAAU","ignoreList":[]}

package/lib/module/nativeModule.js

@@ -0,0 +1,13 @@
+import { NativeModules } from 'react-native';
+
+/**
+ * Native module name — must match {@code VoipCloudModule.getName()} on Android
+ * and the future iOS RCT export. Derived from npm package
+ * {@code @voipsdk/react-native-voipcloud}.
+ */
+export const NATIVE_MODULE_NAME = 'VoipsdkReactNativeVoipcloud';
+export const NativeVoipCloud = NativeModules[NATIVE_MODULE_NAME];
+if (!NativeVoipCloud) {
+  console.warn('[@voipsdk/react-native-voipcloud] Native module not linked. ' + 'Methods will reject with VC_NOT_LINKED until the app is rebuilt.');
+}
+//# sourceMappingURL=nativeModule.js.map

package/lib/module/nativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","NATIVE_MODULE_NAME","NativeVoipCloud","console","warn"],"sourceRoot":"../../src","sources":["nativeModule.ts"],"mappings":"AAAA,SAASA,aAAa,QAAQ,cAAc;;AAE5C;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,GAAG,6BAA6B;AAE/D,OAAO,MAAMC,eAAe,GAAGF,aAAa,CAACC,kBAAkB,CAAC;AAEhE,IAAI,CAACC,eAAe,EAAE;EAClBC,OAAO,CAACC,IAAI,CACR,8DAA8D,GAC9D,kEACJ,CAAC;AACL","ignoreList":[]}

package/lib/typescript/VoipCloud.d.ts

@@ -1,52 +1,28 @@
 import type { AccountConfig, InitConfig } from './types';
 import { on } from './events';
 /**
- * Top-level VoIP SDK.  Workflow:
+ * Top-level VoIP SDK for {@code @voipsdk/react-native-voipcloud}.  Workflow:
  *
- *   1. {@link License.set} — install a token (paste from your portal).
- *   2. {@link init} — start the PJSIP endpoint.
- *   3. {@link register} — get an `accountId` back.
- *   4. {@link makeCall} / {@link answer} / {@link hangup}.
+ *   1. {@link init} — start the PJSIP endpoint.
+ *   2. {@link register} — get an `accountId` back.
+ *   3. {@link makeCall} / {@link answer} / {@link hangup}.
  *
- * Every method returns a Promise.  License-gate failures surface as a
- * Promise rejection with `code = "VC_<NAME>"` matching the
- * `PJ_EVOIPCLOUD_*` enum from `voipcloud_errno.h`.
+ * Every method returns a Promise.  Failures reject with a `VC_*` code.
  */
 export declare const VoipCloud: {
-    License: {
-        set(token: string): Promise<void>;
-        status(): Promise<import("./types").LicenseStatus>;
-        stopRefresh(): Promise<void>;
-    };
     init(cfg?: InitConfig): Promise<void>;
     shutdown(): Promise<void>;
-    /** Register a new SIP account. Resolves with the account id. */
     register(account: AccountConfig): Promise<number>;
     unregister(accountId: number): Promise<void>;
-    /** Place an outbound call. Resolves with the new callId. */
     makeCall(accountId: number, destinationUri: string): Promise<number>;
     answer(callId: number): Promise<void>;
-    hangup(callId: number): Promise<void>;
+    hangup(callId: number, mode?: "busy" | "cancel" | "normal"): Promise<void>;
     hold(callId: number): Promise<void>;
     unhold(callId: number): Promise<void>;
-    /**
-     * Mute / unmute the local microphone for a call.  Implemented by
-     * stopping / starting the capture device's transmission to the
-     * call's active audio media — independent of `hold`.  A
-     * `callMediaState` event fires after the toggle so the UI can
-     * mirror the new `isMuted` flag without polling.
-     */
     mute(callId: number, on: boolean): Promise<void>;
     sendDtmf(callId: number, digits: string): Promise<void>;
-    /**
-     * Blind-transfer a call (SIP REFER) to a new destination.  The
-     * local leg moves to DISCONNECTED once the remote party accepts.
-     */
     transferCall(callId: number, destinationUri: string): Promise<void>;
-    /**
-     * End every active call.  Each call still emits its own
-     * `callState` event with state=DISCONNECTED.
-     */
     hangupAllCalls(): Promise<void>;
+    reconnectCallAudio(callId: number): Promise<void>;
     on: typeof on;
 };

package/lib/typescript/events.d.ts

@@ -1,6 +1,10 @@
 import type { EventMap, Subscription } from './types';
+import { NATIVE_MODULE_NAME } from './nativeModule';
 /**
- * Subscribe to a typed event.  Returns a handle whose `remove()` must
- * be called from a React `useEffect` cleanup to avoid leaks.
+ * Subscribe to a typed event from {@code @voipsdk/react-native-voipcloud}.
+ * Returns a handle whose `remove()` must be called from a React `useEffect`
+ * cleanup to avoid leaks.
  */
 export declare function on<K extends keyof EventMap>(name: K, callback: (event: EventMap[K]) => void): Subscription;
+/** Native module name registered with React Native (for debugging). */
+export { NATIVE_MODULE_NAME };

package/lib/typescript/index.d.ts

@@ -1,4 +1,3 @@
 export { VoipCloud } from './VoipCloud';
-export { License } from './License';
-export { on as addEventListener } from './events';
-export type { Transport, InitConfig, AccountConfig, LicenseStatus, RegistrationStateEvent, IncomingCallEvent, CallState, CallStateEvent, CallMediaStateEvent, CallHoldEvent, CallUnholdEvent, CallMuteEvent, CallDtmfSentEvent, CallTransferEvent, CallTransferStatusEvent, IncomingDtmfEvent, EventMap, Subscription, } from './types';
+export { on as addEventListener, NATIVE_MODULE_NAME } from './events';
+export type { Transport, InitConfig, AccountConfig, RegistrationStateEvent, IncomingCallEvent, CallState, CallStateEvent, CallMediaStateEvent, CallHoldEvent, CallUnholdEvent, CallMuteEvent, CallDtmfSentEvent, CallTransferEvent, CallTransferStatusEvent, IncomingDtmfEvent, EventMap, Subscription, } from './types';

package/lib/typescript/nativeModule.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Native module name — must match {@code VoipCloudModule.getName()} on Android
+ * and the future iOS RCT export. Derived from npm package
+ * {@code @voipsdk/react-native-voipcloud}.
+ */
+export declare const NATIVE_MODULE_NAME = "VoipsdkReactNativeVoipcloud";
+export declare const NativeVoipCloud: any;

package/lib/typescript/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Public types for react-native-voipcloud.
+ * Public types for @voipsdk/react-native-voipcloud.
  * Keep these stable across versions — they form the API contract.
  */
 export type Transport = 'UDP' | 'TCP' | 'TLS';
@@ -32,22 +32,6 @@ export interface AccountConfig {
      */
     transport: Transport;
 }
-export interface LicenseStatus {
-    /** True if voipcloud_license_is_valid() returned 1 at call time. */
-    valid: boolean;
-    /** Server-side label: "active" | "trial" | "suspended" | "expired" | "unset". */
-    status: string;
-    /** Customer identifier embedded in the token. */
-    customerId: string;
-    /** Concurrent-call ceiling allowed by the license. */
-    ccu: number;
-    /** Current count of active calls held by the gate. */
-    currentCalls: number;
-    /** Token expiry (unix seconds). 0 if unbounded. */
-    expiry: number;
-    /** Last clock-skew anchor pushed by the refresher (unix seconds). 0 if none yet. */
-    serverTime: number;
-}
 export interface RegistrationStateEvent {
     accountId: number;
     /** SIP response code (200 = registered, 401/407 = auth, etc.). */
@@ -62,6 +46,8 @@ export interface IncomingCallEvent {
     from: string;
     /** Local AOR. */
     to: string;
+    /** SIP Call-ID header of the dialog (stable across systems). */
+    sipCallId?: string;
 }
 export type CallState = 'NULL' | 'CALLING' | 'INCOMING' | 'EARLY' | 'CONNECTING' | 'CONFIRMED' | 'DISCONNECTED';
 export interface CallStateEvent {
@@ -69,6 +55,8 @@ export interface CallStateEvent {
     state: CallState;
     code: number;
     reason: string;
+    /** SIP Call-ID header of the dialog (stable across systems). */
+    sipCallId?: string;
 }
 export interface CallMediaStateEvent {
     callId: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@voipsdk/react-native-voipcloud",
-  "version": "0.2.1",
-  "description": "React Native VoIP SDK backed by PJSIP, license-gated by VoipCloud.",
+  "version": "1.0.1",
+  "description": "Public React Native VoIP SDK backed by PJSIP (VoipCloud).",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -14,11 +14,12 @@
     "ios",
     "react-native-voipcloud.podspec",
     "README.md",
+    "CHANGELOG.md",
     "!**/__tests__",
     "!**/.*"
   ],
   "scripts": {
-    "prepare": "bob build && yarn build:types",
+    "prepare": "bob build && tsc --project tsconfig.build.json --outDir lib/typescript --emitDeclarationOnly --declaration",
     "build:types": "tsc --project tsconfig.build.json --outDir lib/typescript --emitDeclarationOnly --declaration",
     "clean": "rm -rf lib",
     "pack:tgz": "yarn pack --out ./%s-%v.tgz"
@@ -42,7 +43,7 @@
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hoangdx/react-native-voipcloud.git"
+    "url": "git+https://github.com/hoangdx/react-native-voipcloud.git"
   },
   "bugs": {
     "url": "https://github.com/hoangdx/react-native-voipcloud/issues"
@@ -72,5 +73,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "packageManager": "yarn@4.17.0+sha512.c2957de2f9025ab14d63b24d0d8be1f1655810e22c341042c27f7ecd017b180ec12db73d69ac366d71b304ef9f069349ce462de96f04f8f1da317f4f762c95ae"
 }

package/react-native-voipcloud.podspec

@@ -1,16 +1,18 @@
 require "json"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+npm_name = package["name"]
+pod_name = npm_name.include?("/") ? npm_name.split("/").last : npm_name
 
 Pod::Spec.new do |s|
-  s.name         = "react-native-voipcloud"
+  s.name         = pod_name
   s.version      = package["version"]
   s.summary      = package["description"]
-  s.homepage     = "https://github.com/hoangdx/react-native-voipcloud"
-  s.license      = "UNLICENSED"
-  s.authors      = { "VoipCloud" => "htt.bkap@gmail.com" }
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = { package["author"]["name"] => package["author"]["email"] }
   s.platforms    = { :ios => "13.0" }
-  s.source       = { :git => "https://github.com/hoangdx/react-native-voipcloud.git", :tag => "#{s.version}" }
+  s.source       = { :git => package["repository"]["url"] + ".git", :tag => "v#{s.version}" }
   s.source_files = "ios/**/*.{h,m,mm,swift}"
   s.dependency "React-Core"
 end

package/src/VoipCloud.ts

@@ -1,98 +1,91 @@
-import { NativeModules } from 'react-native';
 import type { AccountConfig, InitConfig } from './types';
-import { License } from './License';
+import { NativeVoipCloud } from './nativeModule';
 import { on } from './events';
 
-const Native = NativeModules.VoipCloud;
+/** Thrown as Promise rejection — never crashes at import time. */
+function rejectNotLinked(): Promise<never> {
+    return Promise.reject(
+        Object.assign(
+            new Error(
+                '@voipsdk/react-native-voipcloud native module is not linked. ' +
+                'Install the package, rebuild the Android app ' +
+                '(./gradlew clean assembleDebug), and ensure voipcloud-release.aar is packaged.',
+            ),
+            { code: 'VC_NOT_LINKED' },
+        ),
+    );
+}
+
+function callNative<T>(fn: () => Promise<T>): Promise<T> {
+    if (!NativeVoipCloud) return rejectNotLinked();
+    return fn();
+}
 
 /**
- * Top-level VoIP SDK.  Workflow:
+ * Top-level VoIP SDK for {@code @voipsdk/react-native-voipcloud}.  Workflow:
  *
- *   1. {@link License.set} — install a token (paste from your portal).
- *   2. {@link init} — start the PJSIP endpoint.
- *   3. {@link register} — get an `accountId` back.
- *   4. {@link makeCall} / {@link answer} / {@link hangup}.
+ *   1. {@link init} — start the PJSIP endpoint.
+ *   2. {@link register} — get an `accountId` back.
+ *   3. {@link makeCall} / {@link answer} / {@link hangup}.
  *
- * Every method returns a Promise.  License-gate failures surface as a
- * Promise rejection with `code = "VC_<NAME>"` matching the
- * `PJ_EVOIPCLOUD_*` enum from `voipcloud_errno.h`.
+ * Every method returns a Promise.  Failures reject with a `VC_*` code.
  */
 export const VoipCloud = {
-    // ---------------------- License ---------------------------------
-    License,
-
-    // ---------------------- Lifecycle -------------------------------
     init(cfg: InitConfig = {}): Promise<void> {
-        return Native.init(cfg);
+        return callNative(() => NativeVoipCloud.init(cfg ?? {}));
     },
 
     shutdown(): Promise<void> {
-        return Native.shutdown();
+        return callNative(() => NativeVoipCloud.shutdown());
     },
 
-    // ---------------------- Accounts --------------------------------
-    /** Register a new SIP account. Resolves with the account id. */
     register(account: AccountConfig): Promise<number> {
-        return Native.register(account);
+        return callNative(() => NativeVoipCloud.register(account));
     },
 
     unregister(accountId: number): Promise<void> {
-        return Native.unregister(accountId);
+        return callNative(() => NativeVoipCloud.unregister(accountId));
     },
 
-    // ---------------------- Calls -----------------------------------
-    /** Place an outbound call. Resolves with the new callId. */
     makeCall(accountId: number, destinationUri: string): Promise<number> {
-        return Native.makeCall(accountId, destinationUri);
+        return callNative(() => NativeVoipCloud.makeCall(accountId, destinationUri));
     },
 
     answer(callId: number): Promise<void> {
-        return Native.answer(callId);
+        return callNative(() => NativeVoipCloud.answer(callId));
     },
 
-    hangup(callId: number): Promise<void> {
-        return Native.hangup(callId);
+    hangup(callId: number, mode: 'busy' | 'cancel' | 'normal' = 'normal'): Promise<void> {
+        return callNative(() => NativeVoipCloud.hangup(callId, mode));
     },
 
     hold(callId: number): Promise<void> {
-        return Native.hold(callId);
+        return callNative(() => NativeVoipCloud.hold(callId));
     },
 
     unhold(callId: number): Promise<void> {
-        return Native.unhold(callId);
+        return callNative(() => NativeVoipCloud.unhold(callId));
     },
 
-    /**
-     * Mute / unmute the local microphone for a call.  Implemented by
-     * stopping / starting the capture device's transmission to the
-     * call's active audio media — independent of `hold`.  A
-     * `callMediaState` event fires after the toggle so the UI can
-     * mirror the new `isMuted` flag without polling.
-     */
     mute(callId: number, on: boolean): Promise<void> {
-        return Native.mute(callId, on);
+        return callNative(() => NativeVoipCloud.mute(callId, on));
     },
 
     sendDtmf(callId: number, digits: string): Promise<void> {
-        return Native.sendDtmf(callId, digits);
+        return callNative(() => NativeVoipCloud.sendDtmf(callId, digits));
     },
 
-    /**
-     * Blind-transfer a call (SIP REFER) to a new destination.  The
-     * local leg moves to DISCONNECTED once the remote party accepts.
-     */
     transferCall(callId: number, destinationUri: string): Promise<void> {
-        return Native.transferCall(callId, destinationUri);
+        return callNative(() => NativeVoipCloud.transferCall(callId, destinationUri));
     },
 
-    /**
-     * End every active call.  Each call still emits its own
-     * `callState` event with state=DISCONNECTED.
-     */
     hangupAllCalls(): Promise<void> {
-        return Native.hangupAllCalls();
+        return callNative(() => NativeVoipCloud.hangupAllCalls());
+    },
+
+    reconnectCallAudio(callId: number): Promise<void> {
+        return callNative(() => NativeVoipCloud.reconnectCallAudio(callId));
     },
 
-    // ---------------------- Events ----------------------------------
     on,
 };

package/src/events.ts

@@ -1,15 +1,13 @@
-import { NativeEventEmitter, NativeModules } from 'react-native';
+import { NativeEventEmitter } from 'react-native';
 import type { EventMap, Subscription } from './types';
+import { NATIVE_MODULE_NAME, NativeVoipCloud } from './nativeModule';
 
-const Native = NativeModules.VoipCloud;
-
-// Lazy emitter — must point at the module to satisfy the contract
-// NativeEventEmitter expects on RN 0.65+.
-const emitter = Native ? new NativeEventEmitter(Native) : null;
+const emitter = NativeVoipCloud ? new NativeEventEmitter(NativeVoipCloud) : null;
 
 /**
- * Subscribe to a typed event.  Returns a handle whose `remove()` must
- * be called from a React `useEffect` cleanup to avoid leaks.
+ * Subscribe to a typed event from {@code @voipsdk/react-native-voipcloud}.
+ * Returns a handle whose `remove()` must be called from a React `useEffect`
+ * cleanup to avoid leaks.
  */
 export function on<K extends keyof EventMap>(
     name: K,
@@ -21,3 +19,6 @@ export function on<K extends keyof EventMap>(
     const sub = emitter.addListener(name, callback as (e: unknown) => void);
     return { remove: () => sub.remove() };
 }
+
+/** Native module name registered with React Native (for debugging). */
+export { NATIVE_MODULE_NAME };

package/src/index.ts

@@ -1,11 +1,9 @@
 export { VoipCloud } from './VoipCloud';
-export { License } from './License';
-export { on as addEventListener } from './events';
+export { on as addEventListener, NATIVE_MODULE_NAME } from './events';
 export type {
     Transport,
     InitConfig,
     AccountConfig,
-    LicenseStatus,
     RegistrationStateEvent,
     IncomingCallEvent,
     CallState,

package/src/nativeModule.ts

@@ -0,0 +1,17 @@
+import { NativeModules } from 'react-native';
+
+/**
+ * Native module name — must match {@code VoipCloudModule.getName()} on Android
+ * and the future iOS RCT export. Derived from npm package
+ * {@code @voipsdk/react-native-voipcloud}.
+ */
+export const NATIVE_MODULE_NAME = 'VoipsdkReactNativeVoipcloud';
+
+export const NativeVoipCloud = NativeModules[NATIVE_MODULE_NAME];
+
+if (!NativeVoipCloud) {
+    console.warn(
+        '[@voipsdk/react-native-voipcloud] Native module not linked. ' +
+        'Methods will reject with VC_NOT_LINKED until the app is rebuilt.',
+    );
+}