@voipsdk/react-native-voipcloud 0.2.1 → 1.0.0

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,87 @@
-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);
+        return callNative(() => NativeVoipCloud.hangup(callId));
     },
 
     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());
     },
 
-    // ---------------------- 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.',
+    );
+}

package/src/types.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.
  */
 
@@ -36,23 +36,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.). */

package/lib/commonjs/License.js

@@ -1,51 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.License = void 0;
-var _reactNative = require("react-native");
-const Native = _reactNative.NativeModules.VoipCloud;
-if (!Native) {
-  // Defer the error: only thrown if the consumer actually calls a
-  // method, so importing the package never crashes at load time.
-  console.warn('[react-native-voipcloud] Native module not linked. ' + 'Did you rebuild the Android app after adding the package?');
-}
-
-/**
- * License management — all SDK functionality is gated behind a valid
- * token.  Customers paste their token (issued by your server) into the
- * app; the app calls {@link set} once at startup and the SDK handles
- * everything else, including periodic refresh.
- */
-const License = exports.License = {
-  /**
-   * Apply a license token.  Resolves on success, rejects with one of
-   * the granular `VC_*` codes if the token is malformed, signed by
-   * the wrong key, expired, suspended, or for a different app bundle.
-   *
-   * Side-effect: if the token's payload includes a `ref` field, the
-   * background refresher is started (or restarted with the new URL)
-   * automatically — the consumer never types a refresh URL.
-   */
-  set(token) {
-    return Native.setLicense(token);
-  },
-  /**
-   * Query the current license state.  Safe to call before `set`
-   * (returns valid=false, status="unset").
-   */
-  status() {
-    return Native.getLicenseStatus();
-  },
-  /**
-   * Cancel the background refresher.  Optional: most apps will
-   * never call this.  Useful when the user logs out or the SDK is
-   * being torn down and you do not want a long-running daemon
-   * thread sitting in the process.
-   */
-  stopRefresh() {
-    return Native.stopLicenseRefresh();
-  }
-};
-//# sourceMappingURL=License.js.map

package/lib/commonjs/License.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_reactNative","require","Native","NativeModules","VoipCloud","console","warn","License","exports","set","token","setLicense","status","getLicenseStatus","stopRefresh","stopLicenseRefresh"],"sourceRoot":"../../src","sources":["License.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAGA,MAAMC,MAAM,GAAGC,0BAAa,CAACC,SAAS;AAEtC,IAAI,CAACF,MAAM,EAAE;EACT;EACA;EACAG,OAAO,CAACC,IAAI,CACR,qDAAqD,GACrD,2DACJ,CAAC;AACL;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,OAAO,GAAAC,OAAA,CAAAD,OAAA,GAAG;EACnB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACIE,GAAGA,CAACC,KAAa,EAAiB;IAC9B,OAAOR,MAAM,CAACS,UAAU,CAACD,KAAK,CAAC;EACnC,CAAC;EAED;AACJ;AACA;AACA;EACIE,MAAMA,CAAA,EAA2B;IAC7B,OAAOV,MAAM,CAACW,gBAAgB,CAAC,CAAC;EACpC,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;EACIC,WAAWA,CAAA,EAAkB;IACzB,OAAOZ,MAAM,CAACa,kBAAkB,CAAC,CAAC;EACtC;AACJ,CAAC","ignoreList":[]}

package/lib/module/License.js

@@ -1,45 +0,0 @@
-import { NativeModules } from 'react-native';
-const Native = NativeModules.VoipCloud;
-if (!Native) {
-  // Defer the error: only thrown if the consumer actually calls a
-  // method, so importing the package never crashes at load time.
-  console.warn('[react-native-voipcloud] Native module not linked. ' + 'Did you rebuild the Android app after adding the package?');
-}
-
-/**
- * License management — all SDK functionality is gated behind a valid
- * token.  Customers paste their token (issued by your server) into the
- * app; the app calls {@link set} once at startup and the SDK handles
- * everything else, including periodic refresh.
- */
-export const License = {
-  /**
-   * Apply a license token.  Resolves on success, rejects with one of
-   * the granular `VC_*` codes if the token is malformed, signed by
-   * the wrong key, expired, suspended, or for a different app bundle.
-   *
-   * Side-effect: if the token's payload includes a `ref` field, the
-   * background refresher is started (or restarted with the new URL)
-   * automatically — the consumer never types a refresh URL.
-   */
-  set(token) {
-    return Native.setLicense(token);
-  },
-  /**
-   * Query the current license state.  Safe to call before `set`
-   * (returns valid=false, status="unset").
-   */
-  status() {
-    return Native.getLicenseStatus();
-  },
-  /**
-   * Cancel the background refresher.  Optional: most apps will
-   * never call this.  Useful when the user logs out or the SDK is
-   * being torn down and you do not want a long-running daemon
-   * thread sitting in the process.
-   */
-  stopRefresh() {
-    return Native.stopLicenseRefresh();
-  }
-};
-//# sourceMappingURL=License.js.map

package/lib/module/License.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["NativeModules","Native","VoipCloud","console","warn","License","set","token","setLicense","status","getLicenseStatus","stopRefresh","stopLicenseRefresh"],"sourceRoot":"../../src","sources":["License.ts"],"mappings":"AAAA,SAASA,aAAa,QAAQ,cAAc;AAG5C,MAAMC,MAAM,GAAGD,aAAa,CAACE,SAAS;AAEtC,IAAI,CAACD,MAAM,EAAE;EACT;EACA;EACAE,OAAO,CAACC,IAAI,CACR,qDAAqD,GACrD,2DACJ,CAAC;AACL;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,OAAO,GAAG;EACnB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACIC,GAAGA,CAACC,KAAa,EAAiB;IAC9B,OAAON,MAAM,CAACO,UAAU,CAACD,KAAK,CAAC;EACnC,CAAC;EAED;AACJ;AACA;AACA;EACIE,MAAMA,CAAA,EAA2B;IAC7B,OAAOR,MAAM,CAACS,gBAAgB,CAAC,CAAC;EACpC,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;EACIC,WAAWA,CAAA,EAAkB;IACzB,OAAOV,MAAM,CAACW,kBAAkB,CAAC,CAAC;EACtC;AACJ,CAAC","ignoreList":[]}

package/lib/typescript/License.d.ts

@@ -1,31 +0,0 @@
-import type { LicenseStatus } from './types';
-/**
- * License management — all SDK functionality is gated behind a valid
- * token.  Customers paste their token (issued by your server) into the
- * app; the app calls {@link set} once at startup and the SDK handles
- * everything else, including periodic refresh.
- */
-export declare const License: {
-    /**
-     * Apply a license token.  Resolves on success, rejects with one of
-     * the granular `VC_*` codes if the token is malformed, signed by
-     * the wrong key, expired, suspended, or for a different app bundle.
-     *
-     * Side-effect: if the token's payload includes a `ref` field, the
-     * background refresher is started (or restarted with the new URL)
-     * automatically — the consumer never types a refresh URL.
-     */
-    set(token: string): Promise<void>;
-    /**
-     * Query the current license state.  Safe to call before `set`
-     * (returns valid=false, status="unset").
-     */
-    status(): Promise<LicenseStatus>;
-    /**
-     * Cancel the background refresher.  Optional: most apps will
-     * never call this.  Useful when the user logs out or the SDK is
-     * being torn down and you do not want a long-running daemon
-     * thread sitting in the process.
-     */
-    stopRefresh(): Promise<void>;
-};

package/src/License.ts

@@ -1,52 +0,0 @@
-import { NativeModules } from 'react-native';
-import type { LicenseStatus } from './types';
-
-const Native = NativeModules.VoipCloud;
-
-if (!Native) {
-    // Defer the error: only thrown if the consumer actually calls a
-    // method, so importing the package never crashes at load time.
-    console.warn(
-        '[react-native-voipcloud] Native module not linked. ' +
-        'Did you rebuild the Android app after adding the package?',
-    );
-}
-
-/**
- * License management — all SDK functionality is gated behind a valid
- * token.  Customers paste their token (issued by your server) into the
- * app; the app calls {@link set} once at startup and the SDK handles
- * everything else, including periodic refresh.
- */
-export const License = {
-    /**
-     * Apply a license token.  Resolves on success, rejects with one of
-     * the granular `VC_*` codes if the token is malformed, signed by
-     * the wrong key, expired, suspended, or for a different app bundle.
-     *
-     * Side-effect: if the token's payload includes a `ref` field, the
-     * background refresher is started (or restarted with the new URL)
-     * automatically — the consumer never types a refresh URL.
-     */
-    set(token: string): Promise<void> {
-        return Native.setLicense(token);
-    },
-
-    /**
-     * Query the current license state.  Safe to call before `set`
-     * (returns valid=false, status="unset").
-     */
-    status(): Promise<LicenseStatus> {
-        return Native.getLicenseStatus();
-    },
-
-    /**
-     * Cancel the background refresher.  Optional: most apps will
-     * never call this.  Useful when the user logs out or the SDK is
-     * being torn down and you do not want a long-running daemon
-     * thread sitting in the process.
-     */
-    stopRefresh(): Promise<void> {
-        return Native.stopLicenseRefresh();
-    },
-};