@capgo/capacitor-stream-call 7.4.0 → 7.7.7

package/README.md

@@ -2,12 +2,16 @@
  <a href="https://capgo.app/"><img src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/></a>
 
 <div align="center">
-  <h2><a href="https://capgo.app/?ref=plugin"> ➡️ Get Instant updates for your App with Capgo</a></h2>
-  <h2><a href="https://capgo.app/consulting/?ref=plugin"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
+  <h2><a href="https://capgo.app/?ref=plugin_streamcall"> ➡️ Get Instant updates for your App with Capgo</a></h2>
+  <h2><a href="https://capgo.app/consulting/?ref=plugin_streamcall"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
 </div>
 
 A Capacitor plugin that uses the [Stream Video SDK](https://getstream.io/) to enable video calling functionality in your app.
 
+## Documentation
+
+The most complete doc is available here: https://capgo.app/docs/plugins/streamcall/
+
 ## Installation
 
 ```bash
@@ -259,6 +263,7 @@ export class CallService {
 * [`setDynamicStreamVideoApikey(...)`](#setdynamicstreamvideoapikey)
 * [`getDynamicStreamVideoApikey()`](#getdynamicstreamvideoapikey)
 * [`getCurrentUser()`](#getcurrentuser)
+* [`getPluginVersion()`](#getpluginversion)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 * [Enums](#enums)
@@ -612,6 +617,19 @@ Get the current user's information
 --------------------
 
 
+### getPluginVersion()
+
+```typescript
+getPluginVersion() => Promise<{ version: string; }>
+```
+
+Get the native Capacitor plugin version
+
+**Returns:** <code>Promise&lt;{ version: string; }&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 

package/android/build.gradle

@@ -77,8 +77,8 @@ dependencies {
 
     
     // Stream dependencies
-    implementation("io.getstream:stream-video-android-ui-compose:1.14.0")
-    implementation("io.getstream:stream-video-android-core:1.14.0")
+    implementation("io.getstream:stream-video-android-ui-compose:1.16.0")
+    implementation("io.getstream:stream-video-android-core:1.16.0")
     implementation("io.getstream:stream-android-push:1.3.2")
     implementation("io.getstream:stream-android-push-firebase:1.3.2")
     

package/android/src/main/java/ee/forgr/capacitor/streamcall/StreamCallPlugin.kt

@@ -107,6 +107,7 @@ import kotlinx.coroutines.flow.collectLatest
 // It's a spaghetti-like, tangled, unreadable mess and frankly, I am deeply sorry for the code crimes commited in the Android impl
 @CapacitorPlugin(name = "StreamCall")
 class StreamCallPlugin : Plugin() {
+  private val pluginVersion = "7.7.4"
   private var streamVideoClient: StreamVideo? = null
   private var state: State = State.NOT_INITIALIZED
   private var overlayView: ComposeView? = null
@@ -265,6 +266,7 @@ class StreamCallPlugin : Plugin() {
     if (action === "io.getstream.video.android.action.INCOMING_CALL") {
       Log.d("StreamCallPlugin", "handleOnNewIntent: Matched INCOMING_CALL action")
       // We need to make sure the activity is visible on locked screen in such case
+      bringAppToForeground()
       changeActivityAsVisibleOnLockScreen(this@StreamCallPlugin.activity, true)
       activity?.runOnUiThread {
         val cid = intent.streamCallId(NotificationHandler.INTENT_EXTRA_CALL_CID)
@@ -275,6 +277,12 @@ class StreamCallPlugin : Plugin() {
           val call = streamVideoClient?.call(id = cid.id, type = cid.type)
           Log.d("StreamCallPlugin", "handleOnNewIntent: INCOMING_CALL - Got call object: ${call?.id}")
 
+          val preview = JSObject().apply {
+            put("cid", cid.cid)
+            put("type", "incoming")
+          }
+          notifyListeners("incomingCall", preview, true)
+
           // Try to get caller information from the call
           kotlinx.coroutines.GlobalScope.launch {
             try {
@@ -301,9 +309,6 @@ class StreamCallPlugin : Plugin() {
 
               // Notify WebView/JS about incoming call so it can render its own UI
               notifyListeners("incomingCall", payload, true)
-              // Delay bringing app to foreground to allow the event to be processed first
-              kotlinx.coroutines.delay(500) // 500ms delay
-              bringAppToForeground()
             } catch (e: Exception) {
               Log.e("StreamCallPlugin", "Error getting call info for incoming call", e)
               // Fallback to basic payload without caller info
@@ -313,9 +318,6 @@ class StreamCallPlugin : Plugin() {
               }
               notifyListeners("incomingCall", payload, true)
               ringingCallId = cid.cid;
-              // Delay bringing app to foreground to allow the event to be processed first
-              kotlinx.coroutines.delay(500) // 500ms delay
-              bringAppToForeground()
             }
           }
         } else {
@@ -1370,8 +1372,6 @@ class StreamCallPlugin : Plugin() {
             updateCallStatusAndNotify(call.cid, "joined")
             CallUIController.layoutType.value = LayoutType.GRID
             ringingCallId = ""
-            // Make sure activity is visible on lock screen
-            changeActivityAsVisibleOnLockScreen(this@StreamCallPlugin.activity, true)
 
             cameraStatusJob?.cancel()
             microphoneStatusJob?.cancel()
@@ -3256,4 +3256,15 @@ class StreamCallPlugin : Plugin() {
       false
     }
   }
+
+  @PluginMethod
+  fun getPluginVersion(call: PluginCall) {
+    try {
+      val ret = JSObject()
+      ret.put("version", pluginVersion)
+      call.resolve(ret)
+    } catch (e: Exception) {
+      call.reject("Could not get plugin version", e)
+    }
+  }
 }

package/dist/docs.json

@@ -598,6 +598,25 @@
           "CurrentUserResponse"
         ],
         "slug": "getcurrentuser"
+      },
+      {
+        "name": "getPluginVersion",
+        "signature": "() => Promise<{ version: string; }>",
+        "parameters": [],
+        "returns": "Promise<{ version: string; }>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "an Promise with version for this device"
+          },
+          {
+            "name": "throws",
+            "text": "An error if the something went wrong"
+          }
+        ],
+        "docs": "Get the native Capacitor plugin version",
+        "complexTypes": [],
+        "slug": "getpluginversion"
       }
     ],
     "properties": []

package/dist/esm/definitions.d.ts

@@ -369,6 +369,15 @@ export interface StreamCallPlugin {
      * console.log(currentUser);
      */
     getCurrentUser(): Promise<CurrentUserResponse>;
+    /**
+     * Get the native Capacitor plugin version
+     *
+     * @returns {Promise<{ id: string }>} an Promise with version for this device
+     * @throws An error if the something went wrong
+     */
+    getPluginVersion(): Promise<{
+        version: string;
+    }>;
 }
 /**
  * @interface IncomingCallPayload

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * @interface LoginOptions\n * @description Configuration options for logging into the Stream Video service\n * @property {string} token - Stream Video API token for authentication\n * @property {string} userId - Unique identifier for the current user\n * @property {string} name - Display name for the current user\n * @property {string} [imageURL] - Avatar URL for the current user\n * @property {string} apiKey - Stream Video API key for your application\n * @property {string} [magicDivId] - DOM element ID where video will be rendered\n */\nexport interface LoginOptions {\n  /** Stream Video API token */\n  token: string;\n  /** User ID for the current user */\n  userId: string;\n  /** Display name for the current user */\n  name: string;\n  /** Optional avatar URL for the current user */\n  imageURL?: string;\n  /** Stream Video API key */\n  apiKey: string;\n  /** ID of the HTML element where the video will be rendered */\n  magicDivId?: string;\n  pushNotificationsConfig?: PushNotificationsConfig;\n}\n\nexport interface PushNotificationsConfig {\n  pushProviderName: string;\n  voipProviderName: string;\n}\n\n/**\n * @typedef CallState\n * @description Represents all possible call states from API and UI\n */\nexport type CallState =\n  // User-facing states\n  | 'idle'\n  | 'ringing'\n  | 'joining'\n  | 'reconnecting'\n  | 'joined'\n  | 'leaving'\n  | 'left'\n  // Event-specific states\n  | 'created'\n  | 'session_started'\n  | 'rejected'\n  | 'participant_counts'\n  | 'missed'\n  | 'accepted'\n  | 'ended'\n  | 'camera_enabled'\n  | 'camera_disabled'\n  | 'speaker_enabled'\n  | 'speaker_disabled'\n  | 'microphone_enabled'\n  | 'microphone_disabled'\n  | 'outgoing_call_ended'\n  | 'unknown';\n\n/**\n * @typedef CallType\n * @description Represents the pre-defined types of a call.\n * - `default`: Simple 1-1 or group video calling with sensible defaults. Video/audio enabled, backstage disabled. Admins/hosts have elevated permissions.\n * - `audio_room`: For audio-only spaces (like Clubhouse). Backstage enabled (requires `goLive`), pre-configured permissions for requesting to speak.\n * - `livestream`: For one-to-many streaming. Backstage enabled (requires `goLive`), access granted to all authenticated users.\n * - `development`: For testing ONLY. All permissions enabled, backstage disabled. **Not recommended for production.**\n */\nexport type CallType = 'default' | 'audio' | 'audio_room' | 'livestream' | 'development';\n\n/**\n * @typedef StreamCallLayout\n * @description Layout modes matching the Stream React SDK; includes native aliases.\n */\nexport type StreamCallLayout = 'grid' | 'spotlight' | 'dynamic' | 'fullScreen' | 'fullscreen';\n\n/**\n * @interface CallMember\n * @description Information about a call member/participant\n * @property {string} userId - User ID of the member\n * @property {string} [name] - Display name of the user\n * @property {string} [imageURL] - Profile image URL of the user\n * @property {string} [role] - Role of the user in the call\n */\nexport interface CallMember {\n  /** User ID of the member */\n  userId: string;\n  /** Display name of the user */\n  name?: string;\n  /** Profile image URL of the user */\n  imageURL?: string;\n  /** Role of the user in the call */\n  role?: string;\n}\n\n/**\n * @interface CallEvent\n * @description Event emitted when call state changes\n * @property {string} callId - Unique identifier of the call\n * @property {CallState} state - Current state of the call\n * @property {string} [userId] - User ID of the participant who triggered the event\n * @property {string} [reason] - Reason for the call state change\n * @property {CallMember} [caller] - Information about the caller (for incoming calls)\n * @property {CallMember[]} [members] - List of call members\n */\nexport interface CallEvent {\n  /** ID of the call */\n  callId: string;\n  /** Current state of the call */\n  state: CallState;\n  /** User ID of the participant in the call who triggered the event */\n  userId?: string;\n  /** Reason for the call state change, if applicable */\n  reason?: string;\n  /** Information about the caller (for incoming calls) */\n  caller?: CallMember;\n  /** List of call members */\n  members?: CallMember[];\n\n  custom?: Record<\n    string,\n    | string\n    | boolean\n    | number\n    | null\n    | Record<string, string | boolean | number | null>\n    | string[]\n    | boolean[]\n    | number[]\n  >;\n\n  count?: number;\n}\n\nexport interface CameraEnabledResponse {\n  enabled: boolean;\n}\n\n/**\n * @interface DynamicApiKeyResponse\n * @description Response from getDynamicStreamVideoApikey\n * @property {string|null} apiKey - The dynamic API key if set, null if not\n * @property {boolean} hasDynamicKey - Whether a dynamic key is currently set\n */\nexport interface DynamicApiKeyResponse {\n  /** The dynamic API key if set, null if not */\n  apiKey: string | null;\n  /** Whether a dynamic key is currently set */\n  hasDynamicKey: boolean;\n}\n\n/**\n * @interface CurrentUserResponse\n * @description Response from getCurrentUser containing user information\n * @property {string} userId - User ID of the current user\n * @property {string} name - Display name of the current user\n * @property {string} [imageURL] - Avatar URL of the current user\n * @property {boolean} isLoggedIn - Whether the user is currently logged in\n */\nexport interface CurrentUserResponse {\n  /** User ID of the current user */\n  userId: string;\n  /** Display name of the current user */\n  name: string;\n  /** Avatar URL of the current user */\n  imageURL?: string;\n  /** Whether the user is currently logged in */\n  isLoggedIn: boolean;\n}\n\n/**\n * @interface SuccessResponse\n * @description Standard response indicating operation success/failure\n * @property {boolean} success - Whether the operation succeeded\n */\nexport interface SuccessResponse {\n  /** Whether the operation was successful */\n  success: boolean;\n  callId?: string;\n}\n\n/**\n * @interface CallOptions\n * @description Options for initiating a video call\n * @property {string[]} userIds - IDs of the users to call\n * @property {CallType} [type=default] - Type of call\n * @property {boolean} [ring=true] - Whether to send ring notification\n * @property {string} [team] - Team name to call\n */\nexport interface CallOptions {\n  /** User ID of the person to call */\n  userIds: string[];\n  /** Type of call, defaults to 'default' */\n  type?: CallType;\n  /** Whether to ring the other user, defaults to true */\n  ring?: boolean;\n  /** Team name to call */\n  team?: string;\n  /** Whether to start the call with video enabled, defaults to false */\n  video?: boolean;\n  /** Custom data to be passed to the call */\n  custom?: Record<\n    string,\n    | string\n    | boolean\n    | number\n    | null\n    | Record<string, string | boolean | number | null>\n    | string[]\n    | boolean[]\n    | number[]\n  >;\n}\n\n/**\n * @interface StreamCallPlugin\n * @description Capacitor plugin for Stream Video calling functionality\n */\nexport interface StreamCallPlugin {\n  /**\n   * Login to Stream Video service\n   * @param {LoginOptions} options - Login configuration\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.login({\n   *   token: 'your-token',\n   *   userId: 'user-123',\n   *   name: 'John Doe',\n   *   apiKey: 'your-api-key'\n   * });\n   */\n  login(options: LoginOptions): Promise<SuccessResponse>;\n\n  /**\n   * Logout from Stream Video service\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.logout();\n   */\n  logout(): Promise<SuccessResponse>;\n\n  /**\n   * Initiate a call to another user\n   * @param {CallOptions} options - Call configuration\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.call({\n   *   userId: 'user-456',\n   *   type: 'video',\n   *   ring: true\n   * });\n   */\n  call(options: CallOptions): Promise<SuccessResponse>;\n\n  /**\n   * End the current call\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.endCall();\n   */\n  endCall(): Promise<SuccessResponse>;\n\n  /**\n   * Join an existing call\n   * @param {{  callId: string, callType: string  }} options - Microphone state\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.joinCall({ callId: 'call001', callType: 'default' });\n   */\n  joinCall?(options: { callId: string; callType: string }): Promise<SuccessResponse>;\n\n  /**\n   * Enable or disable microphone\n   * @param {{ enabled: boolean }} options - Microphone state\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setMicrophoneEnabled({ enabled: false });\n   */\n  setMicrophoneEnabled(options: { enabled: boolean }): Promise<SuccessResponse>;\n\n  /**\n   * Enable or disable camera\n   * @param {{ enabled: boolean }} options - Camera state\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setCameraEnabled({ enabled: false });\n   */\n  setCameraEnabled(options: { enabled: boolean }): Promise<SuccessResponse>;\n\n  /**\n   * Add listener for call events\n   * @param {'callEvent'} eventName - Name of the event to listen for\n   * @param {(event: CallEvent) => void} listenerFunc - Callback function\n   * @returns {Promise<{ remove: () => Promise<void> }>} Function to remove listener\n   * @example\n   * const listener = await StreamCall.addListener('callEvent', (event) => {\n   *   console.log(`Call ${event.callId} is now ${event.state}`);\n   * });\n   */\n  addListener(\n    eventName: 'callEvent',\n    listenerFunc: (event: CallEvent) => void,\n  ): Promise<{ remove: () => Promise<void> }>;\n\n  /**\n   * Listen for lock-screen incoming call (Android only).\n   * Fired when the app is shown by full-screen intent before user interaction.\n   */\n  addListener(\n    eventName: 'incomingCall',\n    listenerFunc: (event: IncomingCallPayload) => void,\n  ): Promise<{ remove: () => Promise<void> }>;\n\n  /**\n   * Remove all event listeners\n   * @returns {Promise<void>}\n   * @example\n   * await StreamCall.removeAllListeners();\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Enable bluetooth audio\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.enableBluetooth();\n   */\n  enableBluetooth?(): Promise<SuccessResponse>;\n\n  /**\n   * Accept an incoming call\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.acceptCall();\n   */\n  acceptCall(): Promise<SuccessResponse>;\n\n  /**\n   * Reject an incoming call\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.rejectCall();\n   */\n  rejectCall(): Promise<SuccessResponse>;\n\n  /**\n   * Check if camera is enabled\n   * @returns {Promise<CameraEnabledResponse>} Camera enabled status\n   * @example\n   * const isCameraEnabled = await StreamCall.isCameraEnabled();\n   * console.log(isCameraEnabled);\n   */\n  isCameraEnabled(): Promise<CameraEnabledResponse>;\n\n  /**\n   * Get the current call status\n   * @returns {Promise<CallEvent>} Current call status as a CallEvent\n   * @example\n   * const callStatus = await StreamCall.getCallStatus();\n   * console.log(callStatus);\n   */\n  getCallStatus(): Promise<CallEvent>;\n\n  /**\n   * Get the current ringing call\n   * @returns {Promise<CallEvent>} Current ringing call status as a CallEvent\n   * @example\n   * const ringingCall = await StreamCall.getRingingCall();\n   * console.log(ringingCall);\n   */\n  getRingingCall?(): Promise<CallEvent>;\n\n  /**\n   * Cycle through the available video layouts\n   * @returns {Promise<{ newLayout: StreamCallLayout }>} The layout that is now active\n   * @example\n   * const { newLayout } = await StreamCall.toggleViews();\n   * console.log(`Layout switched to ${newLayout}`);\n   */\n  toggleViews?(): Promise<{ newLayout: StreamCallLayout }>;\n\n  /**\n   * Set speakerphone on\n   * @param {{ name: string }} options - Speakerphone name\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setSpeaker({ name: 'speaker' });\n   */\n  setSpeaker(options: { name: string }): Promise<SuccessResponse>;\n\n  /**\n   * Switch camera\n   * @param {{ camera: 'front' | 'back' }} options - Camera to switch to\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.switchCamera({ camera: 'back' });\n   */\n  switchCamera(options: { camera: 'front' | 'back' }): Promise<SuccessResponse>;\n\n  /**\n   * Get detailed information about an active call including caller details\n   * @param options - Options containing the call ID\n   */\n  getCallInfo(options: { callId: string }): Promise<CallEvent>;\n\n  /**\n   * Set a dynamic Stream Video API key that overrides the static one\n   * @param {{ apiKey: string }} options - The API key to set\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setDynamicStreamVideoApikey({ apiKey: 'new-api-key' });\n   */\n  setDynamicStreamVideoApikey(options: { apiKey: string }): Promise<SuccessResponse>;\n\n  /**\n   * Get the currently set dynamic Stream Video API key\n   * @returns {Promise<DynamicApiKeyResponse>} The dynamic API key and whether it's set\n   * @example\n   * const result = await StreamCall.getDynamicStreamVideoApikey();\n   * if (result.hasDynamicKey) {\n   *   console.log('Dynamic API key:', result.apiKey);\n   * } else {\n   *   console.log('Using static API key from resources');\n   * }\n   */\n  getDynamicStreamVideoApikey(): Promise<DynamicApiKeyResponse>;\n\n  /**\n   * Get the current user's information\n   * @returns {Promise<CurrentUserResponse>} Current user information\n   * @example\n   * const currentUser = await StreamCall.getCurrentUser();\n   * console.log(currentUser);\n   */\n  getCurrentUser(): Promise<CurrentUserResponse>;\n}\n\n/**\n * @interface IncomingCallPayload\n * @description Payload delivered with \"incomingCall\" event (Android lock-screen).\n * @property {string} cid - Call CID (type:id)\n * @property {string} type - Always \"incoming\" for this event\n * @property {CallMember} [caller] - Information about the caller\n */\nexport interface IncomingCallPayload {\n  /** Full call CID (e.g. default:123) */\n  cid: string;\n  /** Event type (currently always \"incoming\") */\n  type: 'incoming';\n  /** Information about the caller */\n  caller?: CallMember;\n  /** Custom data to be passed to the call */\n  custom?: Record<\n    string,\n    | string\n    | boolean\n    | number\n    | null\n    | Record<string, string | boolean | number | null>\n    | string[]\n    | boolean[]\n    | number[]\n  >;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * @interface LoginOptions\n * @description Configuration options for logging into the Stream Video service\n * @property {string} token - Stream Video API token for authentication\n * @property {string} userId - Unique identifier for the current user\n * @property {string} name - Display name for the current user\n * @property {string} [imageURL] - Avatar URL for the current user\n * @property {string} apiKey - Stream Video API key for your application\n * @property {string} [magicDivId] - DOM element ID where video will be rendered\n */\nexport interface LoginOptions {\n  /** Stream Video API token */\n  token: string;\n  /** User ID for the current user */\n  userId: string;\n  /** Display name for the current user */\n  name: string;\n  /** Optional avatar URL for the current user */\n  imageURL?: string;\n  /** Stream Video API key */\n  apiKey: string;\n  /** ID of the HTML element where the video will be rendered */\n  magicDivId?: string;\n  pushNotificationsConfig?: PushNotificationsConfig;\n}\n\nexport interface PushNotificationsConfig {\n  pushProviderName: string;\n  voipProviderName: string;\n}\n\n/**\n * @typedef CallState\n * @description Represents all possible call states from API and UI\n */\nexport type CallState =\n  // User-facing states\n  | 'idle'\n  | 'ringing'\n  | 'joining'\n  | 'reconnecting'\n  | 'joined'\n  | 'leaving'\n  | 'left'\n  // Event-specific states\n  | 'created'\n  | 'session_started'\n  | 'rejected'\n  | 'participant_counts'\n  | 'missed'\n  | 'accepted'\n  | 'ended'\n  | 'camera_enabled'\n  | 'camera_disabled'\n  | 'speaker_enabled'\n  | 'speaker_disabled'\n  | 'microphone_enabled'\n  | 'microphone_disabled'\n  | 'outgoing_call_ended'\n  | 'unknown';\n\n/**\n * @typedef CallType\n * @description Represents the pre-defined types of a call.\n * - `default`: Simple 1-1 or group video calling with sensible defaults. Video/audio enabled, backstage disabled. Admins/hosts have elevated permissions.\n * - `audio_room`: For audio-only spaces (like Clubhouse). Backstage enabled (requires `goLive`), pre-configured permissions for requesting to speak.\n * - `livestream`: For one-to-many streaming. Backstage enabled (requires `goLive`), access granted to all authenticated users.\n * - `development`: For testing ONLY. All permissions enabled, backstage disabled. **Not recommended for production.**\n */\nexport type CallType = 'default' | 'audio' | 'audio_room' | 'livestream' | 'development';\n\n/**\n * @typedef StreamCallLayout\n * @description Layout modes matching the Stream React SDK; includes native aliases.\n */\nexport type StreamCallLayout = 'grid' | 'spotlight' | 'dynamic' | 'fullScreen' | 'fullscreen';\n\n/**\n * @interface CallMember\n * @description Information about a call member/participant\n * @property {string} userId - User ID of the member\n * @property {string} [name] - Display name of the user\n * @property {string} [imageURL] - Profile image URL of the user\n * @property {string} [role] - Role of the user in the call\n */\nexport interface CallMember {\n  /** User ID of the member */\n  userId: string;\n  /** Display name of the user */\n  name?: string;\n  /** Profile image URL of the user */\n  imageURL?: string;\n  /** Role of the user in the call */\n  role?: string;\n}\n\n/**\n * @interface CallEvent\n * @description Event emitted when call state changes\n * @property {string} callId - Unique identifier of the call\n * @property {CallState} state - Current state of the call\n * @property {string} [userId] - User ID of the participant who triggered the event\n * @property {string} [reason] - Reason for the call state change\n * @property {CallMember} [caller] - Information about the caller (for incoming calls)\n * @property {CallMember[]} [members] - List of call members\n */\nexport interface CallEvent {\n  /** ID of the call */\n  callId: string;\n  /** Current state of the call */\n  state: CallState;\n  /** User ID of the participant in the call who triggered the event */\n  userId?: string;\n  /** Reason for the call state change, if applicable */\n  reason?: string;\n  /** Information about the caller (for incoming calls) */\n  caller?: CallMember;\n  /** List of call members */\n  members?: CallMember[];\n\n  custom?: Record<\n    string,\n    | string\n    | boolean\n    | number\n    | null\n    | Record<string, string | boolean | number | null>\n    | string[]\n    | boolean[]\n    | number[]\n  >;\n\n  count?: number;\n}\n\nexport interface CameraEnabledResponse {\n  enabled: boolean;\n}\n\n/**\n * @interface DynamicApiKeyResponse\n * @description Response from getDynamicStreamVideoApikey\n * @property {string|null} apiKey - The dynamic API key if set, null if not\n * @property {boolean} hasDynamicKey - Whether a dynamic key is currently set\n */\nexport interface DynamicApiKeyResponse {\n  /** The dynamic API key if set, null if not */\n  apiKey: string | null;\n  /** Whether a dynamic key is currently set */\n  hasDynamicKey: boolean;\n}\n\n/**\n * @interface CurrentUserResponse\n * @description Response from getCurrentUser containing user information\n * @property {string} userId - User ID of the current user\n * @property {string} name - Display name of the current user\n * @property {string} [imageURL] - Avatar URL of the current user\n * @property {boolean} isLoggedIn - Whether the user is currently logged in\n */\nexport interface CurrentUserResponse {\n  /** User ID of the current user */\n  userId: string;\n  /** Display name of the current user */\n  name: string;\n  /** Avatar URL of the current user */\n  imageURL?: string;\n  /** Whether the user is currently logged in */\n  isLoggedIn: boolean;\n}\n\n/**\n * @interface SuccessResponse\n * @description Standard response indicating operation success/failure\n * @property {boolean} success - Whether the operation succeeded\n */\nexport interface SuccessResponse {\n  /** Whether the operation was successful */\n  success: boolean;\n  callId?: string;\n}\n\n/**\n * @interface CallOptions\n * @description Options for initiating a video call\n * @property {string[]} userIds - IDs of the users to call\n * @property {CallType} [type=default] - Type of call\n * @property {boolean} [ring=true] - Whether to send ring notification\n * @property {string} [team] - Team name to call\n */\nexport interface CallOptions {\n  /** User ID of the person to call */\n  userIds: string[];\n  /** Type of call, defaults to 'default' */\n  type?: CallType;\n  /** Whether to ring the other user, defaults to true */\n  ring?: boolean;\n  /** Team name to call */\n  team?: string;\n  /** Whether to start the call with video enabled, defaults to false */\n  video?: boolean;\n  /** Custom data to be passed to the call */\n  custom?: Record<\n    string,\n    | string\n    | boolean\n    | number\n    | null\n    | Record<string, string | boolean | number | null>\n    | string[]\n    | boolean[]\n    | number[]\n  >;\n}\n\n/**\n * @interface StreamCallPlugin\n * @description Capacitor plugin for Stream Video calling functionality\n */\nexport interface StreamCallPlugin {\n  /**\n   * Login to Stream Video service\n   * @param {LoginOptions} options - Login configuration\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.login({\n   *   token: 'your-token',\n   *   userId: 'user-123',\n   *   name: 'John Doe',\n   *   apiKey: 'your-api-key'\n   * });\n   */\n  login(options: LoginOptions): Promise<SuccessResponse>;\n\n  /**\n   * Logout from Stream Video service\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.logout();\n   */\n  logout(): Promise<SuccessResponse>;\n\n  /**\n   * Initiate a call to another user\n   * @param {CallOptions} options - Call configuration\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.call({\n   *   userId: 'user-456',\n   *   type: 'video',\n   *   ring: true\n   * });\n   */\n  call(options: CallOptions): Promise<SuccessResponse>;\n\n  /**\n   * End the current call\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.endCall();\n   */\n  endCall(): Promise<SuccessResponse>;\n\n  /**\n   * Join an existing call\n   * @param {{  callId: string, callType: string  }} options - Microphone state\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.joinCall({ callId: 'call001', callType: 'default' });\n   */\n  joinCall?(options: { callId: string; callType: string }): Promise<SuccessResponse>;\n\n  /**\n   * Enable or disable microphone\n   * @param {{ enabled: boolean }} options - Microphone state\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setMicrophoneEnabled({ enabled: false });\n   */\n  setMicrophoneEnabled(options: { enabled: boolean }): Promise<SuccessResponse>;\n\n  /**\n   * Enable or disable camera\n   * @param {{ enabled: boolean }} options - Camera state\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setCameraEnabled({ enabled: false });\n   */\n  setCameraEnabled(options: { enabled: boolean }): Promise<SuccessResponse>;\n\n  /**\n   * Add listener for call events\n   * @param {'callEvent'} eventName - Name of the event to listen for\n   * @param {(event: CallEvent) => void} listenerFunc - Callback function\n   * @returns {Promise<{ remove: () => Promise<void> }>} Function to remove listener\n   * @example\n   * const listener = await StreamCall.addListener('callEvent', (event) => {\n   *   console.log(`Call ${event.callId} is now ${event.state}`);\n   * });\n   */\n  addListener(\n    eventName: 'callEvent',\n    listenerFunc: (event: CallEvent) => void,\n  ): Promise<{ remove: () => Promise<void> }>;\n\n  /**\n   * Listen for lock-screen incoming call (Android only).\n   * Fired when the app is shown by full-screen intent before user interaction.\n   */\n  addListener(\n    eventName: 'incomingCall',\n    listenerFunc: (event: IncomingCallPayload) => void,\n  ): Promise<{ remove: () => Promise<void> }>;\n\n  /**\n   * Remove all event listeners\n   * @returns {Promise<void>}\n   * @example\n   * await StreamCall.removeAllListeners();\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Enable bluetooth audio\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.enableBluetooth();\n   */\n  enableBluetooth?(): Promise<SuccessResponse>;\n\n  /**\n   * Accept an incoming call\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.acceptCall();\n   */\n  acceptCall(): Promise<SuccessResponse>;\n\n  /**\n   * Reject an incoming call\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.rejectCall();\n   */\n  rejectCall(): Promise<SuccessResponse>;\n\n  /**\n   * Check if camera is enabled\n   * @returns {Promise<CameraEnabledResponse>} Camera enabled status\n   * @example\n   * const isCameraEnabled = await StreamCall.isCameraEnabled();\n   * console.log(isCameraEnabled);\n   */\n  isCameraEnabled(): Promise<CameraEnabledResponse>;\n\n  /**\n   * Get the current call status\n   * @returns {Promise<CallEvent>} Current call status as a CallEvent\n   * @example\n   * const callStatus = await StreamCall.getCallStatus();\n   * console.log(callStatus);\n   */\n  getCallStatus(): Promise<CallEvent>;\n\n  /**\n   * Get the current ringing call\n   * @returns {Promise<CallEvent>} Current ringing call status as a CallEvent\n   * @example\n   * const ringingCall = await StreamCall.getRingingCall();\n   * console.log(ringingCall);\n   */\n  getRingingCall?(): Promise<CallEvent>;\n\n  /**\n   * Cycle through the available video layouts\n   * @returns {Promise<{ newLayout: StreamCallLayout }>} The layout that is now active\n   * @example\n   * const { newLayout } = await StreamCall.toggleViews();\n   * console.log(`Layout switched to ${newLayout}`);\n   */\n  toggleViews?(): Promise<{ newLayout: StreamCallLayout }>;\n\n  /**\n   * Set speakerphone on\n   * @param {{ name: string }} options - Speakerphone name\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setSpeaker({ name: 'speaker' });\n   */\n  setSpeaker(options: { name: string }): Promise<SuccessResponse>;\n\n  /**\n   * Switch camera\n   * @param {{ camera: 'front' | 'back' }} options - Camera to switch to\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.switchCamera({ camera: 'back' });\n   */\n  switchCamera(options: { camera: 'front' | 'back' }): Promise<SuccessResponse>;\n\n  /**\n   * Get detailed information about an active call including caller details\n   * @param options - Options containing the call ID\n   */\n  getCallInfo(options: { callId: string }): Promise<CallEvent>;\n\n  /**\n   * Set a dynamic Stream Video API key that overrides the static one\n   * @param {{ apiKey: string }} options - The API key to set\n   * @returns {Promise<SuccessResponse>} Success status\n   * @example\n   * await StreamCall.setDynamicStreamVideoApikey({ apiKey: 'new-api-key' });\n   */\n  setDynamicStreamVideoApikey(options: { apiKey: string }): Promise<SuccessResponse>;\n\n  /**\n   * Get the currently set dynamic Stream Video API key\n   * @returns {Promise<DynamicApiKeyResponse>} The dynamic API key and whether it's set\n   * @example\n   * const result = await StreamCall.getDynamicStreamVideoApikey();\n   * if (result.hasDynamicKey) {\n   *   console.log('Dynamic API key:', result.apiKey);\n   * } else {\n   *   console.log('Using static API key from resources');\n   * }\n   */\n  getDynamicStreamVideoApikey(): Promise<DynamicApiKeyResponse>;\n\n  /**\n   * Get the current user's information\n   * @returns {Promise<CurrentUserResponse>} Current user information\n   * @example\n   * const currentUser = await StreamCall.getCurrentUser();\n   * console.log(currentUser);\n   */\n  getCurrentUser(): Promise<CurrentUserResponse>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n\n/**\n * @interface IncomingCallPayload\n * @description Payload delivered with \"incomingCall\" event (Android lock-screen).\n * @property {string} cid - Call CID (type:id)\n * @property {string} type - Always \"incoming\" for this event\n * @property {CallMember} [caller] - Information about the caller\n */\nexport interface IncomingCallPayload {\n  /** Full call CID (e.g. default:123) */\n  cid: string;\n  /** Event type (currently always \"incoming\") */\n  type: 'incoming';\n  /** Information about the caller */\n  caller?: CallMember;\n  /** Custom data to be passed to the call */\n  custom?: Record<\n    string,\n    | string\n    | boolean\n    | number\n    | null\n    | Record<string, string | boolean | number | null>\n    | string[]\n    | boolean[]\n    | number[]\n  >;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/ios/Sources/StreamCallPlugin/StreamCallPlugin.swift

@@ -12,7 +12,7 @@ import WebKit
  */
 @objc(StreamCallPlugin)
 public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let PLUGIN_VERSION: String = "7.4.0"
+    private let pluginVersion: String = "7.7.7"
     public let identifier = "StreamCallPlugin"
     public let jsName = "StreamCall"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -68,6 +68,8 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
 
     @Injected(\.callKitAdapter) var callKitAdapter
     @Injected(\.callKitPushNotificationAdapter) var callKitPushNotificationAdapter
+    @Injected(\.utils) var utils
+
     private var webviewDelegate: WebviewNavigationDelegate?
 
     // Declare as optional and initialize in load() method
@@ -227,13 +229,6 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
                             "state": "rejected"
                         ]
                         notifyListeners("callEvent", data: data)
-                    case let .typeCallAcceptedEvent(response):
-                        if let streamUserId = self.streamVideo?.user.id,
-                           response.user.id == streamUserId,
-                           response.callCid != self.currentCallId {
-
-                            self.updateCallStatusAndNotify(callId: response.callCid, state: "joined")
-                        }
                     case let .typeCallEndedEvent(response):
                         let data: [String: Any] = [
                             "callId": response.callCid,
@@ -283,6 +278,12 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
                         viewModel.setActiveCall(activeCall)
                         viewModel.update(participantsLayout: .grid)
 
+                        if let callId = viewModel.call?.cId, !self.hasNotifiedCallJoined || callId != self.currentCallId {
+                            print("Notifying call joined: \(callId)")
+                            self.updateCallStatusAndNotify(callId: callId, state: "joined")
+                            self.hasNotifiedCallJoined = true
+                        }
+
                         // Subscribe to speaker status for this active call
                         self.speakerSubscription = activeCall.speaker.$status
                             .receive(on: DispatchQueue.main)
@@ -316,6 +317,17 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
                         print("Active call became nil, cleaning up speaker subscription")
                         self.speakerSubscription?.cancel()
                         self.speakerSubscription = nil
+
+                        print("Call actually ending: \(self.currentCallId)")
+
+                        // Notify that call has ended - use the stored call ID
+                        self.updateCallStatusAndNotify(callId: self.currentCallId, state: "left")
+
+                        // Reset notification flag when call ends
+                        self.hasNotifiedCallJoined = false
+
+                        // Remove the call overlay view and touch intercept view when not in a call
+                        self.ensureViewRemoved()
                     }
                 }
 
@@ -340,6 +352,9 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
                            case .outgoing = previousState {
                             print("Call state changed from outgoing to idle. Ending call with ID: \(self.currentCallId)")
 
+                            // Stop ongoing sound when call is cancelled
+                            self.utils.callSoundsPlayer.stopOngoingSound()
+
                             // End the call using the stored call ID and type
                             if !self.currentCallId.isEmpty {
                                 Task {
@@ -389,6 +404,9 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
                             // Create/update overlay and make visible when there's an active call
                             self.createCallOverlayView()
 
+                            // Stop ongoing sound when call is joined
+                            self.utils.callSoundsPlayer.stopOngoingSound()
+
                             // Notify that a call has started - but only if we haven't notified for this call yet
                             if let callId = viewModel.call?.cId, !self.hasNotifiedCallJoined || callId != self.currentCallId {
                                 print("Notifying call joined: \(callId)")
@@ -399,28 +417,7 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
                         } else if case .incoming(let incomingCall) = newState {
                             self.updateCallStatusAndNotify(callId: incomingCall.id, state: "ringing")
                             //                            }
-                        } else if newState == .idle {
-                            print("Call state changed to idle. CurrentCallId: \(self.currentCallId), ActiveCall: \(String(describing: self.streamVideo?.state.activeCall?.cId))")
-
-                            // Only notify about call ending if we have a valid stored call ID and there's truly no active call
-                            // This prevents false "left" events during normal state transitions
-                            if !self.currentCallId.isEmpty && self.streamVideo?.state.activeCall == nil {
-                                print("Call actually ending: \(self.currentCallId)")
-
-                                // Notify that call has ended - use the stored call ID
-                                self.updateCallStatusAndNotify(callId: self.currentCallId, state: "left")
-
-                                // Reset notification flag when call ends
-                                self.hasNotifiedCallJoined = false
-
-                                // Remove the call overlay view and touch intercept view when not in a call
-                                self.ensureViewRemoved()
-
-                            } else {
-                                print("Not sending left event - CurrentCallId: \(self.currentCallId), ActiveCall exists: \(self.streamVideo?.state.activeCall != nil)")
-                            }
                         }
-
                         // Update the previous state for next comparison
                         self.previousCallingState = newState
                     } catch {
@@ -692,6 +689,8 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
                     print("- Users: \(members)")
                     print("- Should Ring: \(shouldRing)")
                     print("- Team: \(String(describing: team))")
+                    // Play outgoing call sound
+                    self.utils.callSoundsPlayer.playOutgoingCallSound()
 
                     // Create the call object
                     await self.callViewModel?.startCall(
@@ -821,6 +820,9 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     private func endCallInternal() {
+        // Stop ongoing sound when call ends
+        self.utils.callSoundsPlayer.stopOngoingSound()
+
         do {
             try requireInitialized()
 
@@ -905,6 +907,9 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     @objc func endCall(_ call: CAPPluginCall) {
+        // Stop ongoing sound when call ends
+        self.utils.callSoundsPlayer.stopOngoingSound()
+
         do {
             try requireInitialized()
 
@@ -1631,7 +1636,7 @@ public class StreamCallPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     @objc func getPluginVersion(_ call: CAPPluginCall) {
-        call.resolve(["version": self.PLUGIN_VERSION])
+        call.resolve(["version": self.pluginVersion])
     }
 
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-stream-call",
-  "version": "7.4.0",
+  "version": "7.7.7",
   "description": "Uses the https://getstream.io/ SDK to implement calling in Capacitor",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",