react-native-telecom 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,155 @@
 {
   "name": "react-native-telecom",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Modern react-native-callkeep alternative for React Native New Architecture. Android Jetpack Core-Telecom, CallStyle notifications, lock-screen incoming call UI, VoIP ringtone, mute, hold, DTMF, Bluetooth audio routes, FCM wake. TurboModule. Works with Telnyx, WebRTC, LiveKit.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native-telecom-source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-telecom-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\""
+  },
+  "keywords": [
+    "react-native",
+    "react-native-callkeep",
+    "callkeep",
+    "callkeep-alternative",
+    "voip",
+    "telecom",
+    "core-telecom",
+    "connection-service",
+    "callstyle",
+    "incoming-call",
+    "outgoing-call",
+    "call-notification",
+    "full-screen-intent",
+    "lock-screen",
+    "ringtone",
+    "webrtc",
+    "telnyx",
+    "livekit",
+    "twilio",
+    "sip",
+    "dtmf",
+    "bluetooth",
+    "fcm",
+    "push-notification",
+    "turbomodule",
+    "new-architecture",
+    "fabric",
+    "android",
+    "kotlin",
+    "calls",
+    "phone-call-ui"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itxmoizdev/react-native-telecom.git"
+  },
+  "author": "Abdul Moiz <princemoiz664@gmail.com> (https://github.com/itxmoizdev)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/itxmoizdev/react-native-telecom/issues"
+  },
+  "homepage": "https://github.com/itxmoizdev/react-native-telecom#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.6",
+    "@eslint/js": "^9.39.5",
+    "@react-native/babel-preset": "0.87.1",
+    "@react-native/eslint-config": "0.86.2",
+    "@types/react": "^19.2.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.6",
+    "prettier": "^3.9.6",
+    "react": "19.2.3",
+    "react-native": "0.87.1",
+    "react-native-builder-bob": "^0.43.0",
+    "turbo": "^2.10.8",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "TelecomSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.telecom"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint"
+    ],
+    "version": "0.63.1"
+  }
+}

package/src/NativeTelecom.ts

@@ -0,0 +1,55 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+export type TelecomSetupOptions = {
+  appName?: string;
+  supportsVideo?: boolean;
+  /** Customize the full-screen incoming host Activity (not the CallStyle notification). */
+  ui?: {
+    incomingTitle?: string;
+    answerLabel?: string;
+    declineLabel?: string;
+    /** Hex colors e.g. `#000000`, `#43A047` */
+    backgroundColor?: string;
+    titleColor?: string;
+    nameColor?: string;
+    handleColor?: string;
+    answerColor?: string;
+    declineColor?: string;
+    /** Default true. Set false for notification-only (native CallStyle). */
+    launchFullScreenOnIncoming?: boolean;
+  };
+};
+
+export type TelecomAudioRoute = 'earpiece' | 'speaker' | 'bluetooth';
+
+export interface Spec extends TurboModule {
+  setup(options: Object): Promise<boolean>;
+  displayIncomingCall(
+    uuid: string,
+    handle: string,
+    callerName: string,
+    hasVideo: boolean,
+    autoAnswer: boolean,
+    avatarUrl: string
+  ): void;
+  startCall(
+    uuid: string,
+    handle: string,
+    callerName: string,
+    hasVideo: boolean,
+    avatarUrl: string
+  ): void;
+  answerCall(uuid: string): void;
+  endCall(uuid: string): void;
+  endAllCalls(): void;
+  setMuted(uuid: string, muted: boolean): void;
+  setOnHold(uuid: string, hold: boolean): void;
+  setAudioRoute(uuid: string, route: string): void;
+  getAvailableAudioRoutes(): Promise<Object>;
+  sendDtmf(uuid: string, digits: string): void;
+  handlePushMessage(data: Object): Promise<boolean>;
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('Telecom');

package/src/index.tsx

@@ -0,0 +1,220 @@
+import {
+  NativeEventEmitter,
+  NativeModules,
+  Platform,
+  type EmitterSubscription,
+} from 'react-native';
+import NativeTelecom, {
+  type TelecomAudioRoute,
+  type TelecomSetupOptions,
+} from './NativeTelecom';
+
+export type { TelecomAudioRoute, TelecomSetupOptions };
+
+export type TelecomAudioRouteInfo = {
+  id: TelecomAudioRoute;
+  name: string;
+  available: boolean;
+  selected: boolean;
+};
+
+export type TelecomEvents = {
+  answerCall: { callUUID: string };
+  endCall: { callUUID: string };
+  didDisplayIncomingCall: {
+    callUUID: string;
+    handle: string;
+    callerName: string;
+    hasVideo: boolean;
+    direction: 'incoming' | 'outgoing';
+    avatarUrl?: string;
+  };
+  didChangeHoldState: { callUUID: string; hold: boolean };
+  didChangeMuteState: { callUUID: string; muted: boolean };
+  didChangeSpeaker: { callUUID: string; speakerOn: boolean };
+  didChangeAudioRoute: { callUUID: string; route: TelecomAudioRoute };
+  didActivateAudioSession: { callUUID: string; route: TelecomAudioRoute };
+  didDeactivateAudioSession: { callUUID?: string };
+  dtmfTone: { callUUID: string; digit: string };
+};
+
+export type TelecomEventName = keyof TelecomEvents;
+
+export type TelecomPushPayload = {
+  uuid?: string;
+  callUUID?: string;
+  handle?: string;
+  number?: string;
+  callerName?: string;
+  name?: string;
+  hasVideo?: boolean | string;
+  autoAnswer?: boolean | string;
+  avatarUrl?: string;
+  avatar?: string;
+  type?: string;
+  [key: string]: unknown;
+};
+
+const isAndroid = Platform.OS === 'android';
+
+const emitter = new NativeEventEmitter(
+  (NativeModules.Telecom ?? NativeTelecom) as never
+);
+
+function assertAndroid(): void {
+  if (!isAndroid) {
+    throw new Error(
+      'react-native-telecom: Android Jetpack Core-Telecom only in v0.x. iOS CallKit support is coming later.'
+    );
+  }
+}
+
+export async function setup(
+  options: TelecomSetupOptions = {}
+): Promise<boolean> {
+  assertAndroid();
+  return NativeTelecom.setup({
+    appName: options.appName ?? 'App',
+    supportsVideo: options.supportsVideo ?? true,
+    ui: options.ui,
+  });
+}
+
+export function displayIncomingCall(
+  uuid: string,
+  handle: string,
+  callerName: string,
+  hasVideo: boolean = false,
+  autoAnswer: boolean = false,
+  avatarUrl: string = ''
+): void {
+  assertAndroid();
+  NativeTelecom.displayIncomingCall(
+    uuid,
+    handle,
+    callerName,
+    hasVideo,
+    autoAnswer,
+    avatarUrl
+  );
+}
+
+export function startCall(
+  uuid: string,
+  handle: string,
+  callerName: string,
+  hasVideo: boolean = false,
+  avatarUrl: string = ''
+): void {
+  assertAndroid();
+  NativeTelecom.startCall(uuid, handle, callerName, hasVideo, avatarUrl);
+}
+
+export function answerCall(uuid: string): void {
+  assertAndroid();
+  NativeTelecom.answerCall(uuid);
+}
+
+export function endCall(uuid: string): void {
+  assertAndroid();
+  NativeTelecom.endCall(uuid);
+}
+
+export function endAllCalls(): void {
+  assertAndroid();
+  NativeTelecom.endAllCalls();
+}
+
+export function setMuted(uuid: string, muted: boolean): void {
+  assertAndroid();
+  NativeTelecom.setMuted(uuid, muted);
+}
+
+export function setOnHold(uuid: string, hold: boolean): void {
+  assertAndroid();
+  NativeTelecom.setOnHold(uuid, hold);
+}
+
+export function setAudioRoute(
+  uuid: string,
+  route: TelecomAudioRoute
+): void {
+  assertAndroid();
+  NativeTelecom.setAudioRoute(uuid, route);
+}
+
+export async function getAvailableAudioRoutes(): Promise<
+  TelecomAudioRouteInfo[]
+> {
+  assertAndroid();
+  const routes = await NativeTelecom.getAvailableAudioRoutes();
+  return routes as TelecomAudioRouteInfo[];
+}
+
+/** Local DTMF beep + `dtmfTone` event — forward digits in your signaling/WebRTC. */
+export function sendDtmf(uuid: string, digits: string): void {
+  assertAndroid();
+  NativeTelecom.sendDtmf(uuid, digits);
+}
+
+/**
+ * Handle an FCM / push data map from JS (foreground).
+ * For killed-state, call `TelecomPushBridge` from your native MessagingService.
+ */
+export async function handlePushMessage(
+  data: TelecomPushPayload
+): Promise<boolean> {
+  assertAndroid();
+  return NativeTelecom.handlePushMessage(data);
+}
+
+export function addEventListener<E extends TelecomEventName>(
+  eventName: E,
+  listener: (event: TelecomEvents[E]) => void
+): EmitterSubscription {
+  assertAndroid();
+  return emitter.addListener(eventName, (event) => {
+    listener(event as TelecomEvents[E]);
+  });
+}
+
+export function removeAllListeners(eventName?: TelecomEventName): void {
+  if (eventName) {
+    emitter.removeAllListeners(eventName);
+    return;
+  }
+
+  (
+    [
+      'answerCall',
+      'endCall',
+      'didDisplayIncomingCall',
+      'didChangeHoldState',
+      'didChangeMuteState',
+      'didChangeSpeaker',
+      'didChangeAudioRoute',
+      'didActivateAudioSession',
+      'didDeactivateAudioSession',
+      'dtmfTone',
+    ] as TelecomEventName[]
+  ).forEach((name) => emitter.removeAllListeners(name));
+}
+
+const Telecom = {
+  setup,
+  displayIncomingCall,
+  startCall,
+  answerCall,
+  endCall,
+  endAllCalls,
+  setMuted,
+  setOnHold,
+  setAudioRoute,
+  getAvailableAudioRoutes,
+  sendDtmf,
+  handlePushMessage,
+  addEventListener,
+  removeAllListeners,
+};
+
+export default Telecom;