@purplecallio/react-native 0.1.0

package/dist/optional/inCallManager.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Defensive bridge to the *optional* peer dependency
+ * `react-native-incall-manager`, which manages call audio routing
+ * (speaker / earpiece / Bluetooth) — something `react-native-webrtc` does
+ * not handle on its own.
+ *
+ * It is listed in package.json as an optional peerDependency
+ * (`peerDependenciesMeta.react-native-incall-manager.optional = true`), so
+ * consumers who don't need custom audio routing behavior can skip
+ * installing it entirely. We load it with `require()` inside a try/catch so
+ * a missing install never crashes module evaluation — it just disables
+ * automatic audio routing and logs a one-time warning.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inCallManager = exports.InCallManagerBridge = void 0;
+exports.loadInCallManager = loadInCallManager;
+let warnedMissing = false;
+function warnMissingOnce() {
+    if (warnedMissing)
+        return;
+    warnedMissing = true;
+    // eslint-disable-next-line no-console
+    console.warn('[@purplecallio/react-native] react-native-incall-manager is not installed. ' +
+        'Call audio routing (speaker/earpiece switching on join/leave, setSpeakerphoneOn()) ' +
+        'will not be managed automatically. Install it for production call UX: ' +
+        'npm install react-native-incall-manager');
+}
+/**
+ * Default loader: defensively requires the real optional native module.
+ * Kept as a plain function (rather than inlined) so `InCallManagerBridge`
+ * can be constructed with a fake loader in tests, without needing the real
+ * native package installed or mocked at the module resolution level.
+ */
+function loadInCallManager() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const mod = require('react-native-incall-manager');
+        return (mod && mod.default ? mod.default : mod);
+    }
+    catch {
+        return null;
+    }
+}
+class InCallManagerBridge {
+    constructor(load = loadInCallManager) {
+        this.load = load;
+    }
+    resolve() {
+        const mgr = this.load();
+        if (!mgr)
+            warnMissingOnce();
+        return mgr;
+    }
+    /** Called automatically by `<PurpleCallioProvider>` on `join()`. */
+    start(media) {
+        this.resolve()?.start({ media, auto: true });
+    }
+    /** Called automatically by `<PurpleCallioProvider>` on `leave()`/unmount. */
+    stop() {
+        this.resolve()?.stop();
+    }
+    /** Force call audio to the loudspeaker (true) or earpiece/default route (false). */
+    setSpeakerphoneOn(enabled) {
+        const mgr = this.resolve();
+        if (!mgr)
+            return;
+        if (typeof mgr.setForceSpeakerphoneOn === 'function') {
+            mgr.setForceSpeakerphoneOn(enabled);
+        }
+        else {
+            mgr.setSpeakerphoneOn?.(enabled);
+        }
+    }
+}
+exports.InCallManagerBridge = InCallManagerBridge;
+/** Shared default instance used by the provider and the standalone `setSpeakerphoneOn` export. */
+exports.inCallManager = new InCallManagerBridge();
+//# sourceMappingURL=inCallManager.js.map

package/dist/optional/inCallManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inCallManager.js","sourceRoot":"","sources":["../../src/optional/inCallManager.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AA4BH,8CAQC;AA3BD,IAAI,aAAa,GAAG,KAAK,CAAC;AAC1B,SAAS,eAAe;IACtB,IAAI,aAAa;QAAE,OAAO;IAC1B,aAAa,GAAG,IAAI,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,IAAI,CACV,6EAA6E;QAC3E,qFAAqF;QACrF,wEAAwE;QACxE,yCAAyC,CAC5C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB;IAC/B,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAsB,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAa,mBAAmB;IAC9B,YAA6B,OAAuC,iBAAiB;QAAxD,SAAI,GAAJ,IAAI,CAAoD;IAAG,CAAC;IAEjF,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,eAAe,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,KAAwB;QAC5B,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,6EAA6E;IAC7E,IAAI;QACF,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,oFAAoF;IACpF,iBAAiB,CAAC,OAAgB;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,OAAO,GAAG,CAAC,sBAAsB,KAAK,UAAU,EAAE,CAAC;YACrD,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AA7BD,kDA6BC;AAED,kGAAkG;AACrF,QAAA,aAAa,GAAG,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/optional/netInfo.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Defensive bridge to the *optional* peer dependency
+ * `@react-native-community/netinfo`.
+ *
+ * This package deliberately does NOT invent any reconnection logic on top
+ * of network state — that's core-SDK territory (see README "Known
+ * Limitations" re: the `'reconnecting'` connection state). All this bridge
+ * does is surface raw connectivity info so a consuming app can show its own
+ * "you're offline" UI via `useNetworkState()`.
+ */
+export type NetInfoStateTypeLike = string;
+export interface NetInfoStateLike {
+    type: NetInfoStateTypeLike;
+    isConnected: boolean | null;
+    isInternetReachable: boolean | null;
+}
+export type NetInfoUnsubscribe = () => void;
+export interface NetInfoLike {
+    addEventListener(listener: (state: NetInfoStateLike) => void): NetInfoUnsubscribe;
+    fetch(): Promise<NetInfoStateLike>;
+}
+/**
+ * Default loader: defensively requires the real optional native module.
+ * Kept as a plain function so `NetInfoBridge` can be constructed with a
+ * fake loader in tests, without needing the real native package installed.
+ */
+export declare function loadNetInfo(): NetInfoLike | null;
+export declare class NetInfoBridge {
+    private readonly load;
+    constructor(load?: () => NetInfoLike | null);
+    private resolve;
+    isSupported(): boolean;
+    subscribe(listener: (state: NetInfoStateLike) => void): NetInfoUnsubscribe;
+    fetch(): Promise<NetInfoStateLike | null>;
+}
+/** Shared default instance used by `useNetworkState()`. */
+export declare const netInfo: NetInfoBridge;
+//# sourceMappingURL=netInfo.d.ts.map

package/dist/optional/netInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netInfo.d.ts","sourceRoot":"","sources":["../../src/optional/netInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,kBAAkB,CAAC;IAClF,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACpC;AAcD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAQhD;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,MAAM,WAAW,GAAG,IAAkB;IAEzE,OAAO,CAAC,OAAO;IAMf,WAAW,IAAI,OAAO;IAItB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,kBAAkB;IAM1E,KAAK,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAK1C;AAED,2DAA2D;AAC3D,eAAO,MAAM,OAAO,eAAsB,CAAC"}

package/dist/optional/netInfo.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Defensive bridge to the *optional* peer dependency
+ * `@react-native-community/netinfo`.
+ *
+ * This package deliberately does NOT invent any reconnection logic on top
+ * of network state — that's core-SDK territory (see README "Known
+ * Limitations" re: the `'reconnecting'` connection state). All this bridge
+ * does is surface raw connectivity info so a consuming app can show its own
+ * "you're offline" UI via `useNetworkState()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.netInfo = exports.NetInfoBridge = void 0;
+exports.loadNetInfo = loadNetInfo;
+let warnedMissing = false;
+function warnMissingOnce() {
+    if (warnedMissing)
+        return;
+    warnedMissing = true;
+    // eslint-disable-next-line no-console
+    console.warn('[@purplecallio/react-native] @react-native-community/netinfo is not installed. ' +
+        'useNetworkState() will report { supported: false } and never update. Install it ' +
+        'to surface real connectivity state: npm install @react-native-community/netinfo');
+}
+/**
+ * Default loader: defensively requires the real optional native module.
+ * Kept as a plain function so `NetInfoBridge` can be constructed with a
+ * fake loader in tests, without needing the real native package installed.
+ */
+function loadNetInfo() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const mod = require('@react-native-community/netinfo');
+        return (mod && mod.default ? mod.default : mod);
+    }
+    catch {
+        return null;
+    }
+}
+class NetInfoBridge {
+    constructor(load = loadNetInfo) {
+        this.load = load;
+    }
+    resolve() {
+        const mod = this.load();
+        if (!mod)
+            warnMissingOnce();
+        return mod;
+    }
+    isSupported() {
+        return this.resolve() !== null;
+    }
+    subscribe(listener) {
+        const mod = this.resolve();
+        if (!mod)
+            return () => { };
+        return mod.addEventListener(listener);
+    }
+    fetch() {
+        const mod = this.resolve();
+        if (!mod)
+            return Promise.resolve(null);
+        return mod.fetch();
+    }
+}
+exports.NetInfoBridge = NetInfoBridge;
+/** Shared default instance used by `useNetworkState()`. */
+exports.netInfo = new NetInfoBridge();
+//# sourceMappingURL=netInfo.js.map

package/dist/optional/netInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netInfo.js","sourceRoot":"","sources":["../../src/optional/netInfo.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAkCH,kCAQC;AAzBD,IAAI,aAAa,GAAG,KAAK,CAAC;AAC1B,SAAS,eAAe;IACtB,IAAI,aAAa;QAAE,OAAO;IAC1B,aAAa,GAAG,IAAI,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,IAAI,CACV,iFAAiF;QAC/E,kFAAkF;QAClF,iFAAiF,CACpF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW;IACzB,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAgB,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAa,aAAa;IACxB,YAA6B,OAAiC,WAAW;QAA5C,SAAI,GAAJ,IAAI,CAAwC;IAAG,CAAC;IAErE,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,eAAe,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,QAA2C;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAC1B,OAAO,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAxBD,sCAwBC;AAED,2DAA2D;AAC9C,QAAA,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/permissions.d.ts

@@ -0,0 +1,29 @@
+export interface RequestMediaPermissionsOptions {
+    /** Request microphone (RECORD_AUDIO) access. Default: true. */
+    audio?: boolean;
+    /** Request camera access. Default: true. */
+    video?: boolean;
+}
+/**
+ * Requests the runtime OS permissions needed for `getUserMedia()` to
+ * succeed on-device.
+ *
+ * - **Android** requires an explicit runtime permission request before
+ *   camera/microphone access (`PermissionsAndroid.requestMultiple`), on top
+ *   of declaring the permissions in AndroidManifest.xml (see README).
+ * - **iOS** has no equivalent upfront JS-level permission API: the system
+ *   prompt appears automatically the first time `getUserMedia()` is called,
+ *   *provided* the app's Info.plist declares `NSCameraUsageDescription`
+ *   and/or `NSMicrophoneUsageDescription` (an app-level native config this
+ *   package cannot inject — see README). So on iOS this function is a
+ *   deliberate no-op that resolves `true`; if Info.plist is missing the
+ *   required keys, `getUserMedia()` itself will reject when called, not
+ *   this function.
+ *
+ * `<PurpleCallioProvider>` calls this automatically before `join()` for
+ * whichever of `audio`/`video` are requested, but it's also exported
+ * standalone for apps that want to prompt earlier (e.g. on a "join call"
+ * button) for better UX.
+ */
+export declare function requestMediaPermissions(options?: RequestMediaPermissionsOptions): Promise<boolean>;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/dist/permissions.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestMediaPermissions = requestMediaPermissions;
+const react_native_1 = require("react-native");
+/**
+ * Requests the runtime OS permissions needed for `getUserMedia()` to
+ * succeed on-device.
+ *
+ * - **Android** requires an explicit runtime permission request before
+ *   camera/microphone access (`PermissionsAndroid.requestMultiple`), on top
+ *   of declaring the permissions in AndroidManifest.xml (see README).
+ * - **iOS** has no equivalent upfront JS-level permission API: the system
+ *   prompt appears automatically the first time `getUserMedia()` is called,
+ *   *provided* the app's Info.plist declares `NSCameraUsageDescription`
+ *   and/or `NSMicrophoneUsageDescription` (an app-level native config this
+ *   package cannot inject — see README). So on iOS this function is a
+ *   deliberate no-op that resolves `true`; if Info.plist is missing the
+ *   required keys, `getUserMedia()` itself will reject when called, not
+ *   this function.
+ *
+ * `<PurpleCallioProvider>` calls this automatically before `join()` for
+ * whichever of `audio`/`video` are requested, but it's also exported
+ * standalone for apps that want to prompt earlier (e.g. on a "join call"
+ * button) for better UX.
+ */
+async function requestMediaPermissions(options = {}) {
+    const { audio = true, video = true } = options;
+    if (react_native_1.Platform.OS !== 'android') {
+        return true;
+    }
+    const permissions = [];
+    if (audio)
+        permissions.push(react_native_1.PermissionsAndroid.PERMISSIONS.RECORD_AUDIO);
+    if (video)
+        permissions.push(react_native_1.PermissionsAndroid.PERMISSIONS.CAMERA);
+    if (permissions.length === 0)
+        return true;
+    const results = await react_native_1.PermissionsAndroid.requestMultiple(permissions);
+    return permissions.every((permission) => results[permission] === react_native_1.PermissionsAndroid.RESULTS.GRANTED);
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":";;AA8BA,0DAiBC;AA/CD,+CAA4D;AAS5D;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,uBAAuB,CAC3C,UAA0C,EAAE;IAE5C,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE/C,IAAI,uBAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAgG,EAAE,CAAC;IACpH,IAAI,KAAK;QAAE,WAAW,CAAC,IAAI,CAAC,iCAAkB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACzE,IAAI,KAAK;QAAE,WAAW,CAAC,IAAI,CAAC,iCAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAEnE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,OAAO,GAAG,MAAM,iCAAkB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IACtE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,iCAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACvG,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@purplecallio/react-native",
+  "version": "0.1.0",
+  "description": "Official React Native components and hooks for PurpleCallio, a developer-first real-time communication platform for integrating voice, video and WebRTC communication into applications.",
+  "homepage": "https://purplecallio.com",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "purplecallio",
+    "react-native",
+    "mobile",
+    "video",
+    "webrtc",
+    "voice",
+    "real-time",
+    "sdk",
+    "typescript"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.70.0",
+    "react-native-webrtc": ">=1.100.0",
+    "react-native-incall-manager": ">=4.0.0",
+    "@react-native-community/netinfo": ">=9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-incall-manager": {
+      "optional": true
+    },
+    "@react-native-community/netinfo": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@purplecallio/sdk": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/react": "^19.2.17",
+    "@types/react-test-renderer": "^19.2.0",
+    "react": "^19.2.0",
+    "react-native": "^0.87.1",
+    "react-native-webrtc": "^124.0.8",
+    "react-test-renderer": "^19.2.0",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9"
+  }
+}