@stream-io/react-native-callingx 0.1.0-beta.0

package/Callingx.podspec

@@ -0,0 +1,23 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Callingx"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/GetStream/stream-video-js/tree/main/packages/react-native-callingx.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.public_header_files = "ios/CallingxPublic.h"
+  s.swift_version = "5.0"
+
+  s.dependency "stream-react-native-webrtc"
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,219 @@
+SOURCE CODE LICENSE AGREEMENT
+
+IMPORTANT - READ THIS CAREFULLY BEFORE DOWNLOADING, INSTALLING, USING OR
+ELECTRONICALLY ACCESSING THIS PROPRIETARY PRODUCT.
+
+THIS IS A LEGAL AGREEMENT BETWEEN STREAM.IO, INC. (“STREAM.IO”) AND THE
+BUSINESS ENTITY OR PERSON FOR WHOM YOU (“YOU”) ARE ACTING (“CUSTOMER”) AS THE
+LICENSEE OF THE PROPRIETARY SOFTWARE INTO WHICH THIS AGREEMENT HAS BEEN
+INCLUDED (THE “AGREEMENT”). YOU AGREE THAT YOU ARE THE CUSTOMER, OR YOU ARE AN
+EMPLOYEE OR AGENT OF CUSTOMER AND ARE ENTERING INTO THIS AGREEMENT FOR LICENSE
+OF THE SOFTWARE BY CUSTOMER FOR CUSTOMER’S BUSINESS PURPOSES AS DESCRIBED IN
+AND IN ACCORDANCE WITH THIS AGREEMENT. YOU HEREBY AGREE THAT YOU ENTER INTO
+THIS AGREEMENT ON BEHALF OF CUSTOMER AND THAT YOU HAVE THE AUTHORITY TO BIND
+CUSTOMER TO THIS AGREEMENT.
+
+STREAM.IO IS WILLING TO LICENSE THE SOFTWARE TO CUSTOMER ONLY ON THE FOLLOWING
+CONDITIONS: (1) YOU ARE A CURRENT CUSTOMER OF STREAM.IO; (2) YOU ARE NOT A
+COMPETITOR OF STREAM.IO; AND (3) THAT YOU ACCEPT ALL THE TERMS IN THIS
+AGREEMENT. BY DOWNLOADING, INSTALLING, CONFIGURING, ACCESSING OR OTHERWISE
+USING THE SOFTWARE, INCLUDING ANY UPDATES, UPGRADES, OR NEWER VERSIONS, YOU
+REPRESENT, WARRANT AND ACKNOWLEDGE THAT (A) CUSTOMER IS A CURRENT CUSTOMER OF
+STREAM.IO; (B) CUSTOMER IS NOT A COMPETITOR OF STREAM.IO; AND THAT (C) YOU HAVE
+READ THIS AGREEMENT, UNDERSTAND THIS AGREEMENT, AND THAT CUSTOMER AGREES TO BE
+BOUND BY ALL THE TERMS OF THIS AGREEMENT.
+
+IF YOU DO NOT AGREE TO ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT,
+STREAM.IO IS UNWILLING TO LICENSE THE SOFTWARE TO CUSTOMER, AND THEREFORE, DO
+NOT COMPLETE THE DOWNLOAD PROCESS, ACCESS OR OTHERWISE USE THE SOFTWARE, AND
+CUSTOMER SHOULD IMMEDIATELY RETURN THE SOFTWARE AND CEASE ANY USE OF THE
+SOFTWARE. 
+
+1. SOFTWARE. The Stream.io software accompanying this Agreement, may include
+Source Code, Executable Object Code, associated media, printed materials and
+documentation (collectively, the “Software”). The Software also includes any
+updates or upgrades to or new versions of the original Software, if and when
+made available to you by Stream.io. “Source Code” means computer programming
+code in human readable form that is not suitable for machine execution without
+the intervening steps of interpretation or compilation. “Executable Object
+Code" means the computer programming code in any other form than Source Code
+that is not readily perceivable by humans and suitable for machine execution
+without the intervening steps of interpretation or compilation. “Site” means a
+Customer location controlled by Customer. “Authorized User” means any employee
+or contractor of Customer working at the Site, who has signed a written
+confidentiality agreement with Customer or is otherwise bound in writing by
+confidentiality and use obligations at least as restrictive as those imposed
+under this Agreement.
+
+2. LICENSE GRANT. Subject to the terms and conditions of this Agreement, in
+consideration for the representations, warranties, and covenants made by
+Customer in this Agreement, Stream.io grants to Customer, during the term of
+this Agreement, a personal, non-exclusive, non-transferable, non-sublicensable
+license to:
+
+a. install and use Software Source Code on password protected computers at a Site,
+restricted to Authorized Users;
+
+b. create derivative works, improvements (whether or not patentable), extensions
+and other modifications to the Software Source Code (“Modifications”) to build
+unique scalable newsfeeds, activity streams, and in-app messaging via Stream’s
+application program interface (“API”);
+
+c. compile the Software Source Code to create Executable Object Code versions of
+the Software Source Code and Modifications to build such newsfeeds, activity
+streams, and in-app messaging via the API;
+
+d. install, execute and use such Executable Object Code versions solely for
+Customer’s internal business use (including development of websites through
+which data generated by Stream services will be streamed (“Apps”));
+
+e. use and distribute such Executable Object Code as part of Customer’s Apps; and
+
+f. make electronic copies of the Software and Modifications as required for backup
+or archival purposes.
+
+3. RESTRICTIONS. Customer is responsible for all activities that occur in
+connection with the Software. Customer will not, and will not attempt to: (a)
+sublicense or transfer the Software or any Source Code related to the Software
+or any of Customer’s rights under this Agreement, except as otherwise provided
+in this Agreement, (b) use the Software Source Code for the benefit of a third
+party or to operate a service; (c) allow any third party to access or use the
+Software Source Code; (d) sublicense or distribute the Software Source Code or
+any Modifications in Source Code or other derivative works based on any part of
+the Software Source Code; (e) use the Software in any manner that competes with
+Stream.io or its business; or (e) otherwise use the Software in any manner that
+exceeds the scope of use permitted in this Agreement. Customer shall use the
+Software in compliance with any accompanying documentation any laws applicable
+to Customer.
+
+4. OPEN SOURCE. Customer and its Authorized Users shall not use any software or
+software components that are open source in conjunction with the Software
+Source Code or any Modifications in Source Code or in any way that could
+subject the Software to any open source licenses.
+
+5. CONTRACTORS. Under the rights granted to Customer under this Agreement,
+Customer may permit its employees, contractors, and agencies of Customer to
+become Authorized Users to exercise the rights to the Software granted to
+Customer in accordance with this Agreement solely on behalf of Customer to
+provide services to Customer; provided that Customer shall be liable for the
+acts and omissions of all Authorized Users to the extent any of such acts or
+omissions, if performed by Customer, would constitute a breach of, or otherwise
+give rise to liability to Customer under, this Agreement. Customer shall not
+and shall not permit any Authorized User to use the Software except as
+expressly permitted in this Agreement.
+
+6. COMPETITIVE PRODUCT DEVELOPMENT. Customer shall not use the Software in any way
+to engage in the development of products or services which could be reasonably
+construed to provide a complete or partial functional or commercial alternative
+to Stream.io’s products or services (a “Competitive Product”). Customer shall
+ensure that there is no direct or indirect use of, or sharing of, Software
+source code, or other information based upon or derived from the Software to
+develop such products or services. Without derogating from the generality of
+the foregoing, development of Competitive Products shall include having direct
+or indirect access to, supervising, consulting or assisting in the development
+of, or producing any specifications, documentation, object code or source code
+for, all or part of a Competitive Product.
+
+7. LIMITATION ON MODIFICATIONS. Notwithstanding any provision in this Agreement,
+Modifications may only be created and used by Customer as permitted by this
+Agreement and Modification Source Code may not be distributed to third parties.
+Customer will not assert against Stream.io, its affiliates, or their customers,
+direct or indirect, agents and contractors, in any way, any patent rights that
+Customer may obtain relating to any Modifications for Stream.io, its
+affiliates’, or their customers’, direct or indirect, agents’ and contractors’
+manufacture, use, import, offer for sale or sale of any Stream.io products or
+services.
+
+8. DELIVERY AND ACCEPTANCE. The Software will be delivered electronically pursuant
+to Stream.io standard download procedures. The Software is deemed accepted upon
+delivery.
+
+9. IMPLEMENTATION AND SUPPORT. Stream.io has no obligation under this Agreement to
+provide any support or consultation concerning the Software.
+
+10. TERM AND TERMINATION. The term of this Agreement begins when the Software is
+downloaded or accessed and shall continue until terminated. Either party may
+terminate this Agreement upon written notice. This Agreement shall
+automatically terminate if Customer is or becomes a competitor of Stream.io or
+makes or sells any Competitive Products. Upon termination of this Agreement for
+any reason, (a) all rights granted to Customer in this Agreement immediately
+cease to exist, (b) Customer must promptly discontinue all use of the Software
+and return to Stream.io or destroy all copies of the Software in Customer’s
+possession or control. Any continued use of the Software by Customer or attempt
+by Customer to exercise any rights under this Agreement after this Agreement
+has terminated shall be considered copyright infringement and subject Customer
+to applicable remedies for copyright infringement. Sections 2, 5, 6, 8 and 9
+shall survive expiration or termination of this Agreement for any reason.
+
+11. OWNERSHIP. As between the parties, the Software and all worldwide intellectual
+property rights and proprietary rights relating thereto or embodied therein,
+are the exclusive property of Stream.io and its suppliers. Stream.io and its
+suppliers reserve all rights in and to the Software not expressly granted to
+Customer in this Agreement, and no other licenses or rights are granted by
+implication, estoppel or otherwise.
+
+12. WARRANTY DISCLAIMER. USE OF THIS SOFTWARE IS ENTIRELY AT YOURS AND CUSTOMER’S
+OWN RISK. THE SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTY OF ANY KIND
+WHATSOEVER. STREAM.IO DOES NOT MAKE, AND HEREBY DISCLAIMS, ANY WARRANTY OF ANY
+KIND, WHETHER EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING WITHOUT
+LIMITATION, THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE, TITLE, NON-INFRINGEMENT OF THIRD-PARTY RIGHTS, RESULTS, EFFORTS,
+QUALITY OR QUIET ENJOYMENT. STREAM.IO DOES NOT WARRANT THAT THE SOFTWARE IS
+ERROR-FREE, WILL FUNCTION WITHOUT INTERRUPTION, WILL MEET ANY SPECIFIC NEED
+THAT CUSTOMER HAS, THAT ALL DEFECTS WILL BE CORRECTED OR THAT IT IS
+SUFFICIENTLY DOCUMENTED TO BE USABLE BY CUSTOMER. TO THE EXTENT THAT STREAM.IO
+MAY NOT DISCLAIM ANY WARRANTY AS A MATTER OF APPLICABLE LAW, THE SCOPE AND
+DURATION OF SUCH WARRANTY WILL BE THE MINIMUM PERMITTED UNDER SUCH LAW.
+CUSTOMER ACKNOWLEDGES THAT IT HAS RELIED ON NO WARRANTIES OTHER THAN THE
+EXPRESS WARRANTIES IN THIS AGREEMENT.
+
+13. LIMITATION OF LIABILITY. TO THE FULLEST EXTENT PERMISSIBLE BY LAW, STREAM.IO’S
+TOTAL LIABILITY FOR ALL DAMAGES ARISING OUT OF OR RELATED TO THE SOFTWARE OR
+THIS AGREEMENT, WHETHER IN CONTRACT, TORT (INCLUDING NEGLIGENCE) OR OTHERWISE,
+SHALL NOT EXCEED $100. IN NO EVENT WILL STREAM.IO BE LIABLE FOR ANY INDIRECT,
+CONSEQUENTIAL, EXEMPLARY, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES OF ANY KIND
+WHATSOEVER, INCLUDING ANY LOST DATA AND LOST PROFITS, ARISING FROM OR RELATING
+TO THE SOFTWARE EVEN IF STREAM.IO HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES. CUSTOMER ACKNOWLEDGES THAT THIS PROVISION REFLECTS THE AGREED UPON
+ALLOCATION OF RISK FOR THIS AGREEMENT AND THAT STREAM.IO WOULD NOT ENTER INTO
+THIS AGREEMENT WITHOUT THESE LIMITATIONS ON ITS LIABILITY.
+
+14. General. Customer may not assign or transfer this Agreement, by operation of
+law or otherwise, or any of its rights under this Agreement (including the
+license rights granted to Customer) to any third party without Stream.io’s
+prior written consent, which consent will not be unreasonably withheld or
+delayed. Stream.io may assign this Agreement, without consent, including, but
+limited to, affiliate or any successor to all or substantially all its business
+or assets to which this Agreement relates, whether by merger, sale of assets,
+sale of stock, reorganization or otherwise. Any attempted assignment or
+transfer in violation of the foregoing will be null and void. Stream.io shall
+not be liable hereunder by reason of any failure or delay in the performance of
+its obligations hereunder for any cause which is beyond the reasonable control.
+All notices, consents, and approvals under this Agreement must be delivered in
+writing by courier, by electronic mail, or by certified or registered mail,
+(postage prepaid and return receipt requested) to the other party at the
+address set forth in the customer agreement between Stream.io and Customer and
+will be effective upon receipt or when delivery is refused. This Agreement will
+be governed by and interpreted in accordance with the laws of the State of
+Colorado, without reference to its choice of laws rules. The United Nations
+Convention on Contracts for the International Sale of Goods does not apply to
+this Agreement. Any action or proceeding arising from or relating to this
+Agreement shall be brought in a federal or state court in Denver, Colorado, and
+each party irrevocably submits to the jurisdiction and venue of any such court
+in any such action or proceeding. All waivers must be in writing. Any waiver or
+failure to enforce any provision of this Agreement on one occasion will not be
+deemed a waiver of any other provision or of such provision on any other
+occasion. If any provision of this Agreement is unenforceable, such provision
+will be changed and interpreted to accomplish the objectives of such provision
+to the greatest extent possible under applicable law and the remaining
+provisions will continue in full force and effect. Customer shall not violate
+any applicable law, rule or regulation, including those regarding the export of
+technical data. The headings of Sections of this Agreement are for convenience
+and are not to be used in interpreting this Agreement. As used in this
+Agreement, the word “including” means “including but not limited to.” This
+Agreement (including all exhibits and attachments) constitutes the entire
+agreement between the parties regarding the subject hereof and supersedes all
+prior or contemporaneous agreements, understandings and communication, whether
+written or oral. This Agreement may be amended only by a written document
+signed by both parties. The terms of any purchase order or similar document
+submitted by Customer to Stream.io will have no effect.

package/README.md

@@ -0,0 +1,392 @@
+# react-native-callingx
+
+A React Native Turbo Module for seamless native calling integration. This library provides a unified API to integrate with **CallKit** on iOS and the **Telecom/ConnectionService** API on Android, enabling your app to display system-level calling UI and interact with native call controls.
+
+## Features
+
+- 📞 **Incoming call UI** — Display native incoming call screens (even when the app is killed)
+- 📲 **Outgoing call registration** — Register outgoing calls with the system
+- 🎛️ **Call controls** — Mute, hold, end calls with native system integration
+- 🔔 **Custom notifications** — Configurable Android notification channels
+- ⚡ **Turbo Module** — Built with the New Architecture for optimal performance
+- 📱 **Background support** — Handle calls when the app is backgrounded or killed
+
+## Requirements
+
+- React Native 0.73+ (New Architecture / Turbo Modules)
+- iOS 13.0+
+- Android API 26+ (Android 8.0 Oreo)
+
+## Installation
+
+```sh
+npm install @stream-io/react-native-callingx
+# or
+yarn add @stream-io/react-native-callingx
+```
+
+### iOS Setup
+
+1. Add the required background modes to your `Info.plist`:
+
+```xml
+<key>UIBackgroundModes</key>
+<array>
+  <string>voip</string>
+  <string>audio</string>
+</array>
+```
+
+2. Run pod install:
+
+```sh
+cd ios && pod install
+```
+
+3. For VoIP push notifications, configure your `AppDelegate` to report incoming calls:
+
+```objc
+#import <Callingx/CallingxPublic.h>
+
+- (void)pushRegistry:(PKPushRegistry *)registry
+didReceiveIncomingPushWithPayload:(PKPushPayload *)payload
+             forType:(PKPushType)type
+withCompletionHandler:(void (^)(void))completion {
+
+    // Extract call information from payload
+    NSString *callId = payload.dictionaryPayload[@"call_id"];
+    NSString *callerName = payload.dictionaryPayload[@"caller_name"];
+    NSString *handle = payload.dictionaryPayload[@"handle"];
+    BOOL hasVideo = [payload.dictionaryPayload[@"has_video"] boolValue];
+
+    [Callingx reportNewIncomingCall:callId
+                             handle:handle
+                         handleType:@"generic"
+                           hasVideo:hasVideo
+                localizedCallerName:callerName
+                    supportsHolding:YES
+                       supportsDTMF:NO
+                   supportsGrouping:NO
+                 supportsUngrouping:NO
+                        fromPushKit:YES
+                            payload:payload.dictionaryPayload
+              withCompletionHandler:completion];
+}
+```
+
+### Android Setup
+
+## Usage
+
+### Setup
+
+Initialize the module with platform-specific configuration:
+
+```typescript
+import { CallingxModule } from 'react-native-callingx';
+
+// Setup must be called before any other method
+CallingxModule.setup({
+  ios: {
+    appName: 'My App',
+    supportsVideo: true,
+    maximumCallsPerCallGroup: 1,
+    maximumCallGroups: 1,
+    handleType: 'generic', // 'generic' | 'number' | 'phone' | 'email'
+  },
+  android: {
+    incomingChannel: {
+      id: 'incoming_calls',
+      name: 'Incoming Calls',
+      sound: 'ringtone', // optional custom sound
+      vibration: true,
+    },
+    outgoingChannel: {
+      id: 'ongoing_calls',
+      name: 'Ongoing Calls',
+    },
+    // Optional: transform display text
+    titleTransformer: (name) => `Call from ${name}`,
+    subtitleTransformer: (phoneNumber) => phoneNumber,
+  },
+});
+```
+
+### Request Permissions
+
+Before displaying calls, request the required permissions:
+
+```typescript
+const permissions = await CallingxModule.requestPermissions();
+console.log('Audio permission:', permissions.recordAudio);
+console.log('Notification permission:', permissions.postNotifications);
+```
+
+### Display Incoming Call
+
+Show the native incoming call UI:
+
+```typescript
+await CallingxModule.displayIncomingCall(
+  'unique-call-id',
+  '+1234567890', // phone number / handle
+  'John Doe', // caller name
+  true, // has video
+);
+```
+
+### Start Outgoing Call
+
+Register an outgoing call with the system:
+
+```typescript
+await CallingxModule.startCall(
+  'unique-call-id',
+  '+1234567890',
+  'John Doe',
+  false, // audio only
+);
+```
+
+### Answer Call
+
+Answer an incoming call programmatically:
+
+```typescript
+await CallingxModule.answerIncomingCall('unique-call-id');
+```
+
+### Activate Call
+
+Mark a call as active (connected):
+
+```typescript
+await CallingxModule.setCurrentCallActive('unique-call-id');
+```
+
+### End Call
+
+End a call with a specific reason:
+
+```typescript
+import type { EndCallReason } from 'react-native-callingx';
+
+// Available reasons: 'local' | 'remote' | 'rejected' | 'busy' |
+//                    'answeredElsewhere' | 'missed' | 'error'
+await CallingxModule.endCallWithReason('unique-call-id', 'remote');
+```
+
+### Mute/Unmute
+
+Toggle call mute state:
+
+```typescript
+await CallingxModule.setMutedCall('unique-call-id', true); // mute
+await CallingxModule.setMutedCall('unique-call-id', false); // unmute
+```
+
+### Hold/Unhold
+
+Toggle call hold state:
+
+```typescript
+await CallingxModule.setOnHoldCall('unique-call-id', true); // hold
+await CallingxModule.setOnHoldCall('unique-call-id', false); // unhold
+```
+
+### Update Display
+
+Update the caller information during a call:
+
+```typescript
+await CallingxModule.updateDisplay(
+  'unique-call-id',
+  '+1234567890',
+  'Updated Name',
+);
+```
+
+### Event Listeners
+
+Subscribe to call events:
+
+```typescript
+import { CallingxModule } from 'react-native-callingx';
+import type { EventName } from 'react-native-callingx';
+
+// Answer event - user answered from system UI
+const answerSubscription = CallingxModule.addEventListener(
+  'answerCall',
+  (params) => {
+    console.log('Call answered:', params.callId);
+  },
+);
+
+// End event - call ended
+const endSubscription = CallingxModule.addEventListener('endCall', (params) => {
+  console.log('Call ended:', params.callId, 'Cause:', params.cause);
+});
+
+// Hold toggle event
+const holdSubscription = CallingxModule.addEventListener(
+  'didToggleHoldCallAction',
+  (params) => {
+    console.log('Hold toggled:', params.callId, 'On hold:', params.hold);
+  },
+);
+
+// Mute toggle event
+const muteSubscription = CallingxModule.addEventListener(
+  'didPerformSetMutedCallAction',
+  (params) => {
+    console.log('Mute toggled:', params.callId, 'Muted:', params.muted);
+  },
+);
+
+// Start call action (outgoing call initiated from system)
+const startSubscription = CallingxModule.addEventListener(
+  'didReceiveStartCallAction',
+  (params) => {
+    console.log('Start call action:', params.callId);
+  },
+);
+
+// Clean up when done
+answerSubscription.remove();
+endSubscription.remove();
+// ... remove other subscriptions
+```
+
+### Handle Initial Events
+
+When the app is launched from a killed state by a call action, retrieve queued events:
+
+```typescript
+// Get events that occurred before the module was initialized
+const initialEvents = CallingxModule.getInitialEvents();
+initialEvents.forEach((event) => {
+  console.log('Initial event:', event.eventName, event.params);
+});
+
+// Clear initial events after processing
+await CallingxModule.clearInitialEvents();
+```
+
+### Background Tasks (Android)
+
+Run background tasks for call-related operations:
+
+```typescript
+// Start a managed background task
+await CallingxModule.startBackgroundTask(async (taskData, stopTask) => {
+  try {
+    // Perform background work (e.g., connect to call server)
+    await connectToCallServer();
+  } finally {
+    stopTask(); // Always call when done
+  }
+});
+
+// Or stop manually
+await CallingxModule.stopBackgroundTask();
+```
+
+## API Reference
+
+### CallingxModule
+
+| Method                                                           | Description                                          |
+| ---------------------------------------------------------------- | ---------------------------------------------------- |
+| `setup(options)`                                                 | Initialize the module with platform-specific options |
+| `requestPermissions()`                                           | Request required permissions (audio, notifications)  |
+| `checkPermissions()`                                             | Check current permission status                      |
+| `displayIncomingCall(callId, phoneNumber, callerName, hasVideo)` | Display incoming call UI                             |
+| `answerIncomingCall(callId)`                                     | Answer an incoming call                              |
+| `startCall(callId, phoneNumber, callerName, hasVideo)`           | Register an outgoing call                            |
+| `setCurrentCallActive(callId)`                                   | Mark call as active/connected                        |
+| `updateDisplay(callId, phoneNumber, callerName)`                 | Update caller display info                           |
+| `endCallWithReason(callId, reason)`                              | End call with specified reason                       |
+| `setMutedCall(callId, isMuted)`                                  | Toggle call mute state                               |
+| `setOnHoldCall(callId, isOnHold)`                                | Toggle call hold state                               |
+| `addEventListener(eventName, callback)`                          | Subscribe to call events                             |
+| `getInitialEvents()`                                             | Get queued events from app launch                    |
+| `clearInitialEvents()`                                           | Clear queued initial events                          |
+| `startBackgroundTask(taskProvider)`                              | Start Android background task                        |
+| `stopBackgroundTask()`                                           | Stop Android background task                         |
+| `log(message, level)`                                            | Log message to native console                        |
+
+### Events
+
+| Event                          | Parameters          | Description                       |
+| ------------------------------ | ------------------- | --------------------------------- |
+| `answerCall`                   | `{ callId }`        | User answered call from system UI |
+| `endCall`                      | `{ callId, cause }` | Call ended                        |
+| `didToggleHoldCallAction`      | `{ callId, hold }`  | Hold state changed                |
+| `didPerformSetMutedCallAction` | `{ callId, muted }` | Mute state changed                |
+| `didReceiveStartCallAction`    | `{ callId }`        | Outgoing call action received     |
+
+### Types
+
+```typescript
+type EndCallReason =
+  | 'local' // Call ended by local user
+  | 'remote' // Call ended by remote party
+  | 'rejected' // Call was rejected
+  | 'busy' // Remote party is busy
+  | 'answeredElsewhere' // Answered on another device
+  | 'missed' // Call was missed
+  | 'error'; // Call failed due to error
+
+type CallingExpiOSOptions = {
+  appName: string;
+  supportsVideo?: boolean;
+  maximumCallsPerCallGroup?: number;
+  maximumCallGroups?: number;
+  handleType?: 'generic' | 'number' | 'phone' | 'email';
+};
+
+type CallingExpAndroidOptions = {
+  incomingChannel?: {
+    id: string;
+    name: string;
+    sound?: string;
+    vibration?: boolean;
+  };
+  outgoingChannel?: {
+    id: string;
+    name: string;
+    sound?: string;
+    vibration?: boolean;
+  };
+};
+
+type PermissionsResult = {
+  recordAudio: boolean;
+  postNotifications: boolean;
+};
+```
+
+## Troubleshooting
+
+### iOS
+
+- **Incoming call not showing**: Ensure `voip` background mode is enabled and VoIP push certificate is configured
+- **CallKit errors**: Check that `appName` is set in setup options
+- **Audio issues**: The module automatically configures the audio session, but ensure no conflicts with other audio libraries
+
+### Android
+
+- **Notifications not showing**: Check POST_NOTIFICATIONS permission on Android 13+
+- **Call not answered on tap**: Ensure `handleCallingIntent` is called in both `onCreate` and `onNewIntent` in your MainActivity
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/bin/build/generated/source/codegen/jni/CMakeLists.txt

@@ -0,0 +1,28 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+cmake_minimum_required(VERSION 3.13)
+set(CMAKE_VERBOSE_MAKEFILE on)
+
+file(GLOB react_codegen_SRCS CONFIGURE_DEPENDS *.cpp react/renderer/components/CallingxSpec/*.cpp)
+
+add_library(
+  react_codegen_CallingxSpec
+  OBJECT
+  ${react_codegen_SRCS}
+)
+
+target_include_directories(react_codegen_CallingxSpec PUBLIC . react/renderer/components/CallingxSpec)
+
+target_link_libraries(
+  react_codegen_CallingxSpec
+  fbjni
+  jsi
+  # We need to link different libraries based on whether we are building rncore or not, that's necessary
+  # because we want to break a circular dependency between react_codegen_rncore and reactnative
+  reactnative
+)
+
+target_compile_reactnative_options(react_codegen_CallingxSpec PRIVATE)