@capgo/capacitor-stream-call 0.0.43 → 0.0.51

package/dist/docs.json

@@ -408,6 +408,29 @@
           "SuccessResponse"
         ],
         "slug": "switchcamera"
+      },
+      {
+        "name": "getCallInfo",
+        "signature": "(options: { callId: string; }) => Promise<CallEvent>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "- Options containing the call ID",
+            "type": "{ callId: string; }"
+          }
+        ],
+        "returns": "Promise<CallEvent>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options - Options containing the call ID"
+          }
+        ],
+        "docs": "Get detailed information about an active call including caller details",
+        "complexTypes": [
+          "CallEvent"
+        ],
+        "slug": "getcallinfo"
       }
     ],
     "properties": []
@@ -618,6 +641,14 @@
         {
           "text": "{string} [reason] - Reason for the call state change",
           "name": "property"
+        },
+        {
+          "text": "{CallMember} [caller] - Information about the caller (for incoming calls)",
+          "name": "property"
+        },
+        {
+          "text": "{CallMember[]} [members] - List of call members",
+          "name": "property"
         }
       ],
       "methods": [],
@@ -651,6 +682,24 @@
           "docs": "Reason for the call state change, if applicable",
           "complexTypes": [],
           "type": "string | undefined"
+        },
+        {
+          "name": "caller",
+          "tags": [],
+          "docs": "Information about the caller (for incoming calls)",
+          "complexTypes": [
+            "CallMember"
+          ],
+          "type": "CallMember"
+        },
+        {
+          "name": "members",
+          "tags": [],
+          "docs": "List of call members",
+          "complexTypes": [
+            "CallMember"
+          ],
+          "type": "CallMember[] | undefined"
         }
       ]
     },
@@ -1134,6 +1183,68 @@
         }
       ]
     },
+    {
+      "name": "CallMember",
+      "slug": "callmember",
+      "docs": "",
+      "tags": [
+        {
+          "text": "CallMember",
+          "name": "interface"
+        },
+        {
+          "text": "Information about a call member/participant",
+          "name": "description"
+        },
+        {
+          "text": "{string} userId - User ID of the member",
+          "name": "property"
+        },
+        {
+          "text": "{string} [name] - Display name of the user",
+          "name": "property"
+        },
+        {
+          "text": "{string} [imageURL] - Profile image URL of the user",
+          "name": "property"
+        },
+        {
+          "text": "{string} [role] - Role of the user in the call",
+          "name": "property"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "userId",
+          "tags": [],
+          "docs": "User ID of the member",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "name",
+          "tags": [],
+          "docs": "Display name of the user",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "imageURL",
+          "tags": [],
+          "docs": "Profile image URL of the user",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "role",
+          "tags": [],
+          "docs": "Role of the user in the call",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
     {
       "name": "IncomingCallPayload",
       "slug": "incomingcallpayload",
@@ -1154,6 +1265,10 @@
         {
           "text": "{string} type - Always \"incoming\" for this event",
           "name": "property"
+        },
+        {
+          "text": "{CallMember} [caller] - Information about the caller",
+          "name": "property"
         }
       ],
       "methods": [],
@@ -1171,6 +1286,15 @@
           "docs": "Event type (currently always \"incoming\")",
           "complexTypes": [],
           "type": "'incoming'"
+        },
+        {
+          "name": "caller",
+          "tags": [],
+          "docs": "Information about the caller",
+          "complexTypes": [
+            "CallMember"
+          ],
+          "type": "CallMember"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -36,6 +36,24 @@ export type CallState = 'idle' | 'ringing' | 'joining' | 'reconnecting' | 'joine
  * - `development`: For testing ONLY. All permissions enabled, backstage disabled. **Not recommended for production.**
  */
 export type CallType = 'default' | 'audio_room' | 'livestream' | 'development';
+/**
+ * @interface CallMember
+ * @description Information about a call member/participant
+ * @property {string} userId - User ID of the member
+ * @property {string} [name] - Display name of the user
+ * @property {string} [imageURL] - Profile image URL of the user
+ * @property {string} [role] - Role of the user in the call
+ */
+export interface CallMember {
+    /** User ID of the member */
+    userId: string;
+    /** Display name of the user */
+    name?: string;
+    /** Profile image URL of the user */
+    imageURL?: string;
+    /** Role of the user in the call */
+    role?: string;
+}
 /**
  * @interface CallEvent
  * @description Event emitted when call state changes
@@ -43,6 +61,8 @@ export type CallType = 'default' | 'audio_room' | 'livestream' | 'development';
  * @property {CallState} state - Current state of the call
  * @property {string} [userId] - User ID of the participant who triggered the event
  * @property {string} [reason] - Reason for the call state change
+ * @property {CallMember} [caller] - Information about the caller (for incoming calls)
+ * @property {CallMember[]} [members] - List of call members
  */
 export interface CallEvent {
     /** ID of the call */
@@ -53,6 +73,10 @@ export interface CallEvent {
     userId?: string;
     /** Reason for the call state change, if applicable */
     reason?: string;
+    /** Information about the caller (for incoming calls) */
+    caller?: CallMember;
+    /** List of call members */
+    members?: CallMember[];
 }
 export interface CameraEnabledResponse {
     enabled: boolean;
@@ -225,16 +249,26 @@ export interface StreamCallPlugin {
     switchCamera(options: {
         camera: 'front' | 'back';
     }): Promise<SuccessResponse>;
+    /**
+     * Get detailed information about an active call including caller details
+     * @param options - Options containing the call ID
+     */
+    getCallInfo(options: {
+        callId: string;
+    }): Promise<CallEvent>;
 }
 /**
  * @interface IncomingCallPayload
  * @description Payload delivered with "incomingCall" event (Android lock-screen).
  * @property {string} cid - Call CID (type:id)
  * @property {string} type - Always "incoming" for this event
+ * @property {CallMember} [caller] - Information about the caller
  */
 export interface IncomingCallPayload {
     /** Full call CID (e.g. default:123) */
     cid: string;
     /** Event type (currently always "incoming") */
     type: 'incoming';
+    /** Information about the caller */
+    caller?: CallMember;
 }

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}\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  | 'missed'\n  | 'accepted'\n  | '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_room' | 'livestream' | 'development';\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 */\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}\n\nexport interface CameraEnabledResponse {\n  enabled: 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}\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}\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   * 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   * 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   * 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/**\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 */\nexport interface IncomingCallPayload {\n  /** Full call CID (e.g. default:123) */\n  cid: string;\n  /** Event type (currently always \"incoming\") */\n  type: 'incoming';\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}\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  | 'missed'\n  | 'accepted'\n  | '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_room' | 'livestream' | 'development';\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\nexport interface CameraEnabledResponse {\n  enabled: 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}\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}\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   * 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   * 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   * 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/**\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}\n"]}

package/dist/esm/web.d.ts

@@ -46,5 +46,8 @@ export declare class StreamCallWeb extends WebPlugin implements StreamCallPlugin
     acceptCall(): Promise<SuccessResponse>;
     rejectCall(): Promise<SuccessResponse>;
     isCameraEnabled(): Promise<CameraEnabledResponse>;
+    getCallInfo(options: {
+        callId: string;
+    }): Promise<CallEvent>;
     getCallStatus(): Promise<CallEvent>;
 }

package/dist/esm/web.js

@@ -8,20 +8,34 @@ export class StreamCallWeb extends WebPlugin {
         this.participantResponses = new Map();
         this.callMembersExpected = new Map();
         this.ringCallback = (event) => {
-            var _a, _b;
+            var _a, _b, _c;
             console.log('Call ringing', event, this.currentCall);
             this.incomingCall = event.call;
+            // Extract caller information
+            let caller;
+            if ((_a = event.call) === null || _a === void 0 ? void 0 : _a.created_by) {
+                caller = {
+                    userId: event.call.created_by.id,
+                    name: event.call.created_by.name,
+                    imageURL: event.call.created_by.image,
+                    role: event.call.created_by.role,
+                };
+            }
             if (!this.currentCall) {
                 console.log('Creating new call', event.call.id);
-                this.currentCall = (_a = this.client) === null || _a === void 0 ? void 0 : _a.call(event.call.type, event.call.id);
+                this.currentCall = (_b = this.client) === null || _b === void 0 ? void 0 : _b.call(event.call.type, event.call.id);
                 // this.currentActiveCallId = this.currentCall?.cid;
-                this.notifyListeners('callEvent', { callId: event.call.id, state: CallingState.RINGING });
+                this.notifyListeners('callEvent', {
+                    callId: event.call.id,
+                    state: CallingState.RINGING,
+                    caller,
+                });
                 // Clear previous responses when a new call starts
                 this.participantResponses.clear();
             }
             if (this.currentCall) {
                 console.log('Call found', this.currentCall.id);
-                this.callStateSubscription = (_b = this.currentCall) === null || _b === void 0 ? void 0 : _b.state.callingState$.subscribe((s) => {
+                this.callStateSubscription = (_c = this.currentCall) === null || _c === void 0 ? void 0 : _c.state.callingState$.subscribe((s) => {
                     var _a;
                     console.log('Call state', s);
                     if (s === CallingState.JOINED) {
@@ -586,6 +600,75 @@ export class StreamCallWeb extends WebPlugin {
         const enabled = await this.currentCall.camera.enabled;
         return { enabled };
     }
+    async getCallInfo(options) {
+        var _a;
+        if (!this.currentCall) {
+            throw new Error('No active call');
+        }
+        if (this.currentCall.id !== options.callId) {
+            throw new Error('Call ID does not match active call');
+        }
+        const callingState = this.currentCall.state.callingState;
+        let state;
+        switch (callingState) {
+            case CallingState.IDLE:
+                state = 'idle';
+                break;
+            case CallingState.RINGING:
+                state = 'ringing';
+                break;
+            case CallingState.JOINING:
+                state = 'joining';
+                break;
+            case CallingState.RECONNECTING:
+                state = 'reconnecting';
+                break;
+            case CallingState.JOINED:
+                state = 'joined';
+                break;
+            case CallingState.LEFT:
+                state = 'left';
+                break;
+            default:
+                state = 'unknown';
+        }
+        // Try to get caller information from the call
+        let caller;
+        let members = [];
+        try {
+            // Get call details
+            const callDetails = await this.currentCall.get();
+            if ((_a = callDetails === null || callDetails === void 0 ? void 0 : callDetails.call) === null || _a === void 0 ? void 0 : _a.created_by) {
+                caller = {
+                    userId: callDetails.call.created_by.id,
+                    name: callDetails.call.created_by.name,
+                    imageURL: callDetails.call.created_by.image,
+                    role: callDetails.call.created_by.role,
+                };
+            }
+            // Get current participants
+            if (this.currentCall.state.participants) {
+                members = this.currentCall.state.participants.map((participant) => {
+                    var _a;
+                    return ({
+                        userId: participant.userId,
+                        name: participant.name,
+                        imageURL: participant.image,
+                        role: (_a = participant.roles) === null || _a === void 0 ? void 0 : _a[0],
+                    });
+                });
+            }
+        }
+        catch (error) {
+            console.warn('Failed to get call details:', error);
+        }
+        return {
+            callId: this.currentCall.id,
+            state,
+            caller,
+            members,
+        };
+    }
     async getCallStatus() {
         if (!this.currentCall) {
             throw new Error('No active call');