@voipsdk/react-native-voipcloud 0.2.1

package/lib/module/VoipCloud.js

@@ -0,0 +1,83 @@
+import { NativeModules } from 'react-native';
+import { License } from './License';
+import { on } from './events';
+const Native = NativeModules.VoipCloud;
+
+/**
+ * Top-level VoIP SDK.  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}.
+ *
+ * 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`.
+ */
+export const VoipCloud = {
+  // ---------------------- License ---------------------------------
+  License,
+  // ---------------------- Lifecycle -------------------------------
+  init(cfg = {}) {
+    return Native.init(cfg);
+  },
+  shutdown() {
+    return Native.shutdown();
+  },
+  // ---------------------- Accounts --------------------------------
+  /** Register a new SIP account. Resolves with the account id. */
+  register(account) {
+    return Native.register(account);
+  },
+  unregister(accountId) {
+    return Native.unregister(accountId);
+  },
+  // ---------------------- Calls -----------------------------------
+  /** Place an outbound call. Resolves with the new callId. */
+  makeCall(accountId, destinationUri) {
+    return Native.makeCall(accountId, destinationUri);
+  },
+  answer(callId) {
+    return Native.answer(callId);
+  },
+  hangup(callId) {
+    return Native.hangup(callId);
+  },
+  hold(callId) {
+    return Native.hold(callId);
+  },
+  unhold(callId) {
+    return Native.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);
+  },
+  sendDtmf(callId, digits) {
+    return Native.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);
+  },
+  /**
+   * End every active call.  Each call still emits its own
+   * `callState` event with state=DISCONNECTED.
+   */
+  hangupAllCalls() {
+    return Native.hangupAllCalls();
+  },
+  // ---------------------- Events ----------------------------------
+  on
+};
+//# sourceMappingURL=VoipCloud.js.map

package/lib/module/VoipCloud.js.map

@@ -0,0 +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":[]}

package/lib/module/events.js

@@ -0,0 +1,23 @@
+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;
+
+/**
+ * Subscribe to a typed event.  Returns a handle whose `remove()` must
+ * be called from a React `useEffect` cleanup to avoid leaks.
+ */
+export function on(name, callback) {
+  if (!emitter) {
+    return {
+      remove: () => {}
+    };
+  }
+  const sub = emitter.addListener(name, callback);
+  return {
+    remove: () => sub.remove()
+  };
+}
+//# sourceMappingURL=events.js.map

package/lib/module/events.js.map

@@ -0,0 +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":[]}

package/lib/module/index.js

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

package/lib/module/index.js.map

@@ -0,0 +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":[]}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/License.d.ts

@@ -0,0 +1,31 @@
+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/lib/typescript/VoipCloud.d.ts

@@ -0,0 +1,52 @@
+import type { AccountConfig, InitConfig } from './types';
+import { on } from './events';
+/**
+ * Top-level VoIP SDK.  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}.
+ *
+ * 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`.
+ */
+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>;
+    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>;
+    on: typeof on;
+};

package/lib/typescript/events.d.ts

@@ -0,0 +1,6 @@
+import type { EventMap, Subscription } from './types';
+/**
+ * Subscribe to a typed event.  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;

package/lib/typescript/index.d.ts

@@ -0,0 +1,4 @@
+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';

package/lib/typescript/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Public types for react-native-voipcloud.
+ * Keep these stable across versions — they form the API contract.
+ */
+export type Transport = 'UDP' | 'TCP' | 'TLS';
+export interface InitConfig {
+    /** STUN server hostname, e.g. "stun.l.google.com:19302". Optional. */
+    stunServer?: string;
+    /** User-Agent header value advertised to the SIP server. */
+    userAgent?: string;
+    /** Default log level 0–6 (PJSIP convention; 4 = info). */
+    logLevel?: number;
+}
+export interface AccountConfig {
+    /** AOR — e.g. "sip:alice@example.com". */
+    uri: string;
+    /**
+     * Registrar URI — e.g. "sip:example.com" or
+     * "sip:example.com:5061;transport=tls".  The transport is taken from
+     * the `;transport=` parameter on this URI; if absent, PJSIP defaults
+     * to UDP.
+     */
+    registrar: string;
+    /** Auth username (often the same as the local part of `uri`). */
+    username: string;
+    /** Auth password (will be sent only in challenge response, never logged). */
+    password: string;
+    /**
+     * Hint for the transport you intend to use.  Informational only —
+     * the actual transport is resolved from the `registrar` URI.  Keep
+     * the two in sync to avoid surprises.
+     */
+    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.). */
+    code: number;
+    /** Free-form reason string. */
+    reason: string;
+}
+export interface IncomingCallEvent {
+    accountId: number;
+    callId: number;
+    /** Remote-party display URI. */
+    from: string;
+    /** Local AOR. */
+    to: string;
+}
+export type CallState = 'NULL' | 'CALLING' | 'INCOMING' | 'EARLY' | 'CONNECTING' | 'CONFIRMED' | 'DISCONNECTED';
+export interface CallStateEvent {
+    callId: number;
+    state: CallState;
+    code: number;
+    reason: string;
+}
+export interface CallMediaStateEvent {
+    callId: number;
+    hasAudio: boolean;
+    isHold: boolean;
+    isMuted: boolean;
+}
+/** Fired right after `hold(callId)` succeeds (re-INVITE sent). */
+export interface CallHoldEvent {
+    callId: number;
+}
+/** Fired right after `unhold(callId)` succeeds. */
+export interface CallUnholdEvent {
+    callId: number;
+}
+/** Fired right after `mute(callId, isMuted)` succeeds. */
+export interface CallMuteEvent {
+    callId: number;
+    isMuted: boolean;
+}
+/** Fired right after `sendDtmf(callId, digits)` succeeds. */
+export interface CallDtmfSentEvent {
+    callId: number;
+    digits: string;
+}
+/** Fired right after `transferCall(callId, destinationUri)` sends the REFER. */
+export interface CallTransferEvent {
+    callId: number;
+    destinationUri: string;
+}
+/**
+ * Multi-stage progress for a transfer we initiated.  Fires once per
+ * NOTIFY received from the remote — final stage has `finalNotify=true`
+ * and a 2xx statusCode (success) or a 4xx-6xx (failure).
+ */
+export interface CallTransferStatusEvent {
+    callId: number;
+    statusCode: number;
+    reason: string;
+    finalNotify: boolean;
+}
+/** RFC 2833 DTMF digit detected on the inbound RTP stream. */
+export interface IncomingDtmfEvent {
+    callId: number;
+    digit: string;
+    /** Duration in PJSIP timer ticks (~ ms with default sampling). */
+    duration: number;
+}
+export interface EventMap {
+    registrationState: RegistrationStateEvent;
+    incomingCall: IncomingCallEvent;
+    callState: CallStateEvent;
+    callMediaState: CallMediaStateEvent;
+    callHold: CallHoldEvent;
+    callUnhold: CallUnholdEvent;
+    callMute: CallMuteEvent;
+    callDtmfSent: CallDtmfSentEvent;
+    callTransfer: CallTransferEvent;
+    callTransferStatus: CallTransferStatusEvent;
+    incomingDtmf: IncomingDtmfEvent;
+}
+/** Subscription handle returned by VoipCloud.on(...). */
+export interface Subscription {
+    remove(): void;
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@voipsdk/react-native-voipcloud",
+  "version": "0.2.1",
+  "description": "React Native VoIP SDK backed by PJSIP, license-gated by VoipCloud.",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "react-native": "src/index.ts",
+  "types": "lib/typescript/index.d.ts",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "react-native-voipcloud.podspec",
+    "README.md",
+    "!**/__tests__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "prepare": "bob build && yarn build:types",
+    "build:types": "tsc --project tsconfig.build.json --outDir lib/typescript --emitDeclarationOnly --declaration",
+    "clean": "rm -rf lib",
+    "pack:tgz": "yarn pack --out ./%s-%v.tgz"
+  },
+  "keywords": [
+    "react-native",
+    "voip",
+    "sip",
+    "sip-client",
+    "pjsip",
+    "android",
+    "telephony",
+    "calling",
+    "webrtc",
+    "voipcloud"
+  ],
+  "author": {
+    "name": "VoipCloud",
+    "email": "htt.bkap@gmail.com"
+  },
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hoangdx/react-native-voipcloud.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hoangdx/react-native-voipcloud/issues"
+  },
+  "homepage": "https://github.com/hoangdx/react-native-voipcloud#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-native": ">=0.70.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "react": "18.2.0",
+    "react-native": "0.74.0",
+    "react-native-builder-bob": "^0.20.0",
+    "typescript": "^5.3.0"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/react-native-voipcloud.podspec

@@ -0,0 +1,16 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-voipcloud"
+  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.platforms    = { :ios => "13.0" }
+  s.source       = { :git => "https://github.com/hoangdx/react-native-voipcloud.git", :tag => "#{s.version}" }
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.dependency "React-Core"
+end

package/src/License.ts

@@ -0,0 +1,52 @@
+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();
+    },
+};

package/src/VoipCloud.ts

@@ -0,0 +1,98 @@
+import { NativeModules } from 'react-native';
+import type { AccountConfig, InitConfig } from './types';
+import { License } from './License';
+import { on } from './events';
+
+const Native = NativeModules.VoipCloud;
+
+/**
+ * Top-level VoIP SDK.  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}.
+ *
+ * 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`.
+ */
+export const VoipCloud = {
+    // ---------------------- License ---------------------------------
+    License,
+
+    // ---------------------- Lifecycle -------------------------------
+    init(cfg: InitConfig = {}): Promise<void> {
+        return Native.init(cfg);
+    },
+
+    shutdown(): Promise<void> {
+        return Native.shutdown();
+    },
+
+    // ---------------------- Accounts --------------------------------
+    /** Register a new SIP account. Resolves with the account id. */
+    register(account: AccountConfig): Promise<number> {
+        return Native.register(account);
+    },
+
+    unregister(accountId: number): Promise<void> {
+        return Native.unregister(accountId);
+    },
+
+    // ---------------------- Calls -----------------------------------
+    /** Place an outbound call. Resolves with the new callId. */
+    makeCall(accountId: number, destinationUri: string): Promise<number> {
+        return Native.makeCall(accountId, destinationUri);
+    },
+
+    answer(callId: number): Promise<void> {
+        return Native.answer(callId);
+    },
+
+    hangup(callId: number): Promise<void> {
+        return Native.hangup(callId);
+    },
+
+    hold(callId: number): Promise<void> {
+        return Native.hold(callId);
+    },
+
+    unhold(callId: number): Promise<void> {
+        return Native.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);
+    },
+
+    sendDtmf(callId: number, digits: string): Promise<void> {
+        return Native.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);
+    },
+
+    /**
+     * End every active call.  Each call still emits its own
+     * `callState` event with state=DISCONNECTED.
+     */
+    hangupAllCalls(): Promise<void> {
+        return Native.hangupAllCalls();
+    },
+
+    // ---------------------- Events ----------------------------------
+    on,
+};

package/src/events.ts

@@ -0,0 +1,23 @@
+import { NativeEventEmitter, NativeModules } from 'react-native';
+import type { EventMap, Subscription } from './types';
+
+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;
+
+/**
+ * Subscribe to a typed event.  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,
+    callback: (event: EventMap[K]) => void,
+): Subscription {
+    if (!emitter) {
+        return { remove: () => {} };
+    }
+    const sub = emitter.addListener(name, callback as (e: unknown) => void);
+    return { remove: () => sub.remove() };
+}

package/src/index.ts

@@ -0,0 +1,23 @@
+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';