@100mslive/react-native-hms 1.10.7 → 1.10.9

package/lib/commonjs/classes/HMSSessionStore.js

@@ -15,9 +15,9 @@ function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /**
- * Session store is a shared realtime key-value store that is accessible by everyone in the room.
+ * Session store is a shared realtime key-value store that is accessible by all Peers in a Room.
  * It can be utilized to implement features such as pinned text, spotlight (which brings a particular
- * peer to the center stage for everyone in the room) and more.
+ * peer to the center stage for everyone in the room) and more, enhancing interactive experiences.
  *
  * To get an instance of `HMSSessionStore` class, You can add an event listener for `ON_SESSION_STORE_AVAILABLE`
  * event on the `HMSSDK` instance
@@ -40,9 +40,9 @@ class HMSSessionStore {
    * Once a value is assigned, it will be available for other peers in the room
    * who are listening for changes in value for that specific key.
    *
-   * @param {JsonValue} value
-   * @param {string} key
-   * @returns {Promise}
+   * @param {JsonValue} value - The value to set, which can be any JSON-compatible type.
+   * @param {string} key - The key under which to store the value.
+   * @returns {Promise} A promise that resolves when the operation is complete.
    */
   async set(value, key) {
     const data = await _HMSManagerModule.default.setSessionMetadataForKey({
@@ -54,14 +54,13 @@ class HMSSessionStore {
   }
 
   /**
-   * This method returns the value of any specified key on session store.
-   * Note that you will not get updates for any change in value of the specified key,
-   * It returns the latest value at the time it was called.
+   * Retrieves the value for a given key from the session store. This method does not subscribe
+   * to changes; it only returns the current value at the time of the call.
    *
    * To listen to value change updates use `addKeyChangeListener` method instead.
    *
-   * @param {string} key
-   * @returns {Promise}
+   * @param {string} key - The key whose value is to be retrieved.
+   * @returns {Promise} A promise that resolves with the value of the key.
    */
   async get(key) {
     const data = await _HMSManagerModule.default.getSessionMetadataForKey({
@@ -72,12 +71,12 @@ class HMSSessionStore {
   }
 
   /**
-   * This method registers a callback function for listening to value changes of a particular key.
-   * Registered Callback function will be called initially with latest value and whenever the value updates
+   * Registers a callback to listen for changes to specified keys in the session store.
+   * The callback is called with the initial value and again whenever any value changes.
    *
-   * @param {string[]} forKeys
-   * @param {Function} callback
-   * @returns {Object} subscription object
+   * @param {string[]} forKeys - An array of keys to listen for changes on.
+   * @param {Function} callback - The function to call when a value changes.
+   * @returns {Object} An object with a `remove` method to unregister the listener.
    */
   addKeyChangeListener(forKeys, callback) {
     // Add Native Device Event Emitter if it is not already added

package/lib/commonjs/classes/HMSSessionStore.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_HMSManagerModule","_interopRequireDefault","_HMSConstants","_HMSLogger","_HMSUpdateListenerActions","_utils","e","__esModule","default","_defineProperty","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","HMSSessionStore","constructor","set","key","data","HMSManager","setSessionMetadataForKey","id","HMSConstants","DEFAULT_SDK_ID","get","getSessionMetadataForKey","addKeyChangeListener","forKeys","callback","_deviceEventEmitterSubscription","DeviceEventEmitter","addListener","HMSUpdateListenerActions","ON_SESSION_STORE_CHANGED","_deviceEventEmitterListener","bind","_eventEmitter","EventEmitter","uniqueId","join","Date","now","toString","eventEmitter","subscriptions","map","cleanupHandler","_cleanup","keys","catch","err","_addedKeyChangeListenerCount","remove","subscriptionsToRemove","length","context","forEach","subscription","removeKeyChangeListener","error","logger","getLogger","verbose","removeListener","undefined","_getLogger","_this$_eventEmitter","emit","exports"],"sources":["HMSSessionStore.ts"],"sourcesContent":["import { DeviceEventEmitter } from 'react-native';\nimport type { EmitterSubscription as RNEmitterSubscription } from 'react-native';\n\nimport HMSManager from '../modules/HMSManagerModule';\n\nimport { HMSConstants } from './HMSConstants';\nimport { getLogger } from './HMSLogger';\nimport { HMSUpdateListenerActions } from './HMSUpdateListenerActions';\nimport { EventEmitter } from '../utils';\nimport type { EmitterSubscription } from '../utils';\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonMap = {\n  [key: string]: JsonPrimitive | JsonMap | JsonArray;\n};\nexport type JsonArray = Array<JsonPrimitive | JsonMap | JsonArray>;\nexport type JsonValue = JsonPrimitive | JsonMap | JsonArray;\n\n/**\n * Session store is a shared realtime key-value store that is accessible by everyone in the room.\n * It can be utilized to implement features such as pinned text, spotlight (which brings a particular\n * peer to the center stage for everyone in the room) and more.\n *\n * To get an instance of `HMSSessionStore` class, You can add an event listener for `ON_SESSION_STORE_AVAILABLE`\n * event on the `HMSSDK` instance\n *\n * For example:\n * ```\n * hmsInstance.addEventListener(HMSUpdateListenerActions.ON_SESSION_STORE_AVAILABLE, <your callback function>);\n * ```\n *\n * Checkout Session Store docs fore more details ${@link https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/room/session-store}\n */\nexport class HMSSessionStore {\n  private _deviceEventEmitterSubscription?: RNEmitterSubscription;\n  private _eventEmitter?: EventEmitter;\n  private _addedKeyChangeListenerCount = 0;\n\n  /**\n   * This method sets a value for a specific key on session store.\n   * Once a value is assigned, it will be available for other peers in the room\n   * who are listening for changes in value for that specific key.\n   *\n   * @param {JsonValue} value\n   * @param {string} key\n   * @returns {Promise}\n   */\n  async set(value: JsonValue, key: string) {\n    const data: { success: true } = await HMSManager.setSessionMetadataForKey({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      key,\n      value,\n    });\n    return data;\n  }\n\n  /**\n   * This method returns the value of any specified key on session store.\n   * Note that you will not get updates for any change in value of the specified key,\n   * It returns the latest value at the time it was called.\n   *\n   * To listen to value change updates use `addKeyChangeListener` method instead.\n   *\n   * @param {string} key\n   * @returns {Promise}\n   */\n  async get(key: string) {\n    const data: JsonValue = await HMSManager.getSessionMetadataForKey({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      key,\n    });\n    return data;\n  }\n\n  /**\n   * This method registers a callback function for listening to value changes of a particular key.\n   * Registered Callback function will be called initially with latest value and whenever the value updates\n   *\n   * @param {string[]} forKeys\n   * @param {Function} callback\n   * @returns {Object} subscription object\n   */\n  addKeyChangeListener<T extends string[]>(\n    forKeys: T,\n    callback: (\n      error: string | null,\n      data: { key: T[number]; value: JsonValue } | null\n    ) => void\n  ) {\n    // Add Native Device Event Emitter if it is not already added\n    if (!this._deviceEventEmitterSubscription) {\n      this._deviceEventEmitterSubscription = DeviceEventEmitter.addListener(\n        HMSUpdateListenerActions.ON_SESSION_STORE_CHANGED,\n        this._deviceEventEmitterListener.bind(this)\n      );\n    }\n\n    // Create JS side EventEmitter\n    if (!this._eventEmitter) {\n      this._eventEmitter = new EventEmitter();\n    }\n\n    // Unique Identifier for adding native event listener\n    const uniqueId = forKeys.join('') + '_' + Date.now().toString();\n\n    const eventEmitter = this._eventEmitter;\n\n    // Add listeners on eventEmitter for each key\n    const subscriptions = forKeys.map((key) =>\n      eventEmitter.addListener(key, callback, { uniqueId })\n    );\n\n    //\n    let cleanupHandler: (() => void) | null = () => {\n      this._cleanup(subscriptions);\n    };\n\n    // Adding 'KeyChangeListener' on native side\n    HMSManager.addKeyChangeListener({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      keys: forKeys,\n      uniqueId,\n    })\n      // Adding 'KeyChangeListener' fails on native side\n      .catch((err: any) => {\n        if (typeof cleanupHandler === 'function') {\n          callback(err, null);\n          cleanupHandler();\n          cleanupHandler = null;\n        }\n      });\n\n    this._addedKeyChangeListenerCount += 1;\n\n    return {\n      remove: () => {\n        if (typeof cleanupHandler === 'function') {\n          cleanupHandler();\n          cleanupHandler = null;\n        }\n      },\n    };\n  }\n\n  private _cleanup(subscriptionsToRemove: EmitterSubscription[]) {\n    // Extracting `uniqueId` from first subscription (all subscriptions have same uniqueId)\n    // this `uniqueId` will be used to remove 'KeyChangeListener' from native side\n    const uniqueId =\n      subscriptionsToRemove.length > 0\n        ? (subscriptionsToRemove[0]!.context as { uniqueId: string }).uniqueId\n        : null;\n\n    // Removing required subscriptions from 'eventEmitter'\n    subscriptionsToRemove.forEach((subscription) => subscription.remove());\n\n    // Removing 'KeyChangeListener' from native side\n    HMSManager.removeKeyChangeListener({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      uniqueId,\n    }).catch((error: any) => {\n      const logger = getLogger();\n      logger?.verbose(\n        \"Error while removing key change listener, Listener didn't get registerred at first place or was already removed\",\n        error\n      );\n    });\n\n    this._addedKeyChangeListenerCount -= 1;\n\n    if (this._addedKeyChangeListenerCount <= 0) {\n      this._addedKeyChangeListenerCount = 0;\n      if (\n        this._deviceEventEmitterSubscription &&\n        typeof this._deviceEventEmitterSubscription.remove === 'function'\n      ) {\n        this._deviceEventEmitterSubscription.remove();\n      } else {\n        DeviceEventEmitter.removeListener(\n          HMSUpdateListenerActions.ON_SESSION_STORE_CHANGED,\n          this._deviceEventEmitterListener\n        );\n      }\n\n      this._deviceEventEmitterSubscription = undefined;\n\n      this._eventEmitter = undefined;\n    }\n  }\n\n  private _deviceEventEmitterListener(data: {\n    id: string;\n    key: string;\n    value: JsonValue;\n  }) {\n    // if id is different from default sdk_id, return early\n    if (data.id !== HMSConstants.DEFAULT_SDK_ID) {\n      return;\n    }\n\n    // emit event for the key\n    getLogger()?.verbose('#Listener ON_SESSION_STORE_CHANGED event: ', data);\n\n    this._eventEmitter?.emit(data.key, null, data);\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_HMSManagerModule","_interopRequireDefault","_HMSConstants","_HMSLogger","_HMSUpdateListenerActions","_utils","e","__esModule","default","_defineProperty","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","HMSSessionStore","constructor","set","key","data","HMSManager","setSessionMetadataForKey","id","HMSConstants","DEFAULT_SDK_ID","get","getSessionMetadataForKey","addKeyChangeListener","forKeys","callback","_deviceEventEmitterSubscription","DeviceEventEmitter","addListener","HMSUpdateListenerActions","ON_SESSION_STORE_CHANGED","_deviceEventEmitterListener","bind","_eventEmitter","EventEmitter","uniqueId","join","Date","now","toString","eventEmitter","subscriptions","map","cleanupHandler","_cleanup","keys","catch","err","_addedKeyChangeListenerCount","remove","subscriptionsToRemove","length","context","forEach","subscription","removeKeyChangeListener","error","logger","getLogger","verbose","removeListener","undefined","_getLogger","_this$_eventEmitter","emit","exports"],"sources":["HMSSessionStore.ts"],"sourcesContent":["import { DeviceEventEmitter } from 'react-native';\nimport type { EmitterSubscription as RNEmitterSubscription } from 'react-native';\n\nimport HMSManager from '../modules/HMSManagerModule';\n\nimport { HMSConstants } from './HMSConstants';\nimport { getLogger } from './HMSLogger';\nimport { HMSUpdateListenerActions } from './HMSUpdateListenerActions';\nimport { EventEmitter } from '../utils';\nimport type { EmitterSubscription } from '../utils';\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonMap = {\n  [key: string]: JsonPrimitive | JsonMap | JsonArray;\n};\nexport type JsonArray = Array<JsonPrimitive | JsonMap | JsonArray>;\nexport type JsonValue = JsonPrimitive | JsonMap | JsonArray;\n\n/**\n * Session store is a shared realtime key-value store that is accessible by all Peers in a Room.\n * It can be utilized to implement features such as pinned text, spotlight (which brings a particular\n * peer to the center stage for everyone in the room) and more, enhancing interactive experiences.\n *\n * To get an instance of `HMSSessionStore` class, You can add an event listener for `ON_SESSION_STORE_AVAILABLE`\n * event on the `HMSSDK` instance\n *\n * For example:\n * ```\n * hmsInstance.addEventListener(HMSUpdateListenerActions.ON_SESSION_STORE_AVAILABLE, <your callback function>);\n * ```\n *\n * Checkout Session Store docs fore more details ${@link https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/room/session-store}\n */\nexport class HMSSessionStore {\n  private _deviceEventEmitterSubscription?: RNEmitterSubscription;\n  private _eventEmitter?: EventEmitter;\n  private _addedKeyChangeListenerCount = 0;\n\n  /**\n   * This method sets a value for a specific key on session store.\n   * Once a value is assigned, it will be available for other peers in the room\n   * who are listening for changes in value for that specific key.\n   *\n   * @param {JsonValue} value - The value to set, which can be any JSON-compatible type.\n   * @param {string} key - The key under which to store the value.\n   * @returns {Promise} A promise that resolves when the operation is complete.\n   */\n  async set(value: JsonValue, key: string) {\n    const data: { success: true } = await HMSManager.setSessionMetadataForKey({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      key,\n      value,\n    });\n    return data;\n  }\n\n  /**\n   * Retrieves the value for a given key from the session store. This method does not subscribe\n   * to changes; it only returns the current value at the time of the call.\n   *\n   * To listen to value change updates use `addKeyChangeListener` method instead.\n   *\n   * @param {string} key - The key whose value is to be retrieved.\n   * @returns {Promise} A promise that resolves with the value of the key.\n   */\n  async get(key: string) {\n    const data: JsonValue = await HMSManager.getSessionMetadataForKey({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      key,\n    });\n    return data;\n  }\n\n  /**\n   * Registers a callback to listen for changes to specified keys in the session store.\n   * The callback is called with the initial value and again whenever any value changes.\n   *\n   * @param {string[]} forKeys - An array of keys to listen for changes on.\n   * @param {Function} callback - The function to call when a value changes.\n   * @returns {Object} An object with a `remove` method to unregister the listener.\n   */\n  addKeyChangeListener<T extends string[]>(\n    forKeys: T,\n    callback: (\n      error: string | null,\n      data: { key: T[number]; value: JsonValue } | null\n    ) => void\n  ) {\n    // Add Native Device Event Emitter if it is not already added\n    if (!this._deviceEventEmitterSubscription) {\n      this._deviceEventEmitterSubscription = DeviceEventEmitter.addListener(\n        HMSUpdateListenerActions.ON_SESSION_STORE_CHANGED,\n        this._deviceEventEmitterListener.bind(this)\n      );\n    }\n\n    // Create JS side EventEmitter\n    if (!this._eventEmitter) {\n      this._eventEmitter = new EventEmitter();\n    }\n\n    // Unique Identifier for adding native event listener\n    const uniqueId = forKeys.join('') + '_' + Date.now().toString();\n\n    const eventEmitter = this._eventEmitter;\n\n    // Add listeners on eventEmitter for each key\n    const subscriptions = forKeys.map((key) =>\n      eventEmitter.addListener(key, callback, { uniqueId })\n    );\n\n    //\n    let cleanupHandler: (() => void) | null = () => {\n      this._cleanup(subscriptions);\n    };\n\n    // Adding 'KeyChangeListener' on native side\n    HMSManager.addKeyChangeListener({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      keys: forKeys,\n      uniqueId,\n    })\n      // Adding 'KeyChangeListener' fails on native side\n      .catch((err: any) => {\n        if (typeof cleanupHandler === 'function') {\n          callback(err, null);\n          cleanupHandler();\n          cleanupHandler = null;\n        }\n      });\n\n    this._addedKeyChangeListenerCount += 1;\n\n    return {\n      remove: () => {\n        if (typeof cleanupHandler === 'function') {\n          cleanupHandler();\n          cleanupHandler = null;\n        }\n      },\n    };\n  }\n\n  private _cleanup(subscriptionsToRemove: EmitterSubscription[]) {\n    // Extracting `uniqueId` from first subscription (all subscriptions have same uniqueId)\n    // this `uniqueId` will be used to remove 'KeyChangeListener' from native side\n    const uniqueId =\n      subscriptionsToRemove.length > 0\n        ? (subscriptionsToRemove[0]!.context as { uniqueId: string }).uniqueId\n        : null;\n\n    // Removing required subscriptions from 'eventEmitter'\n    subscriptionsToRemove.forEach((subscription) => subscription.remove());\n\n    // Removing 'KeyChangeListener' from native side\n    HMSManager.removeKeyChangeListener({\n      id: HMSConstants.DEFAULT_SDK_ID,\n      uniqueId,\n    }).catch((error: any) => {\n      const logger = getLogger();\n      logger?.verbose(\n        \"Error while removing key change listener, Listener didn't get registerred at first place or was already removed\",\n        error\n      );\n    });\n\n    this._addedKeyChangeListenerCount -= 1;\n\n    if (this._addedKeyChangeListenerCount <= 0) {\n      this._addedKeyChangeListenerCount = 0;\n      if (\n        this._deviceEventEmitterSubscription &&\n        typeof this._deviceEventEmitterSubscription.remove === 'function'\n      ) {\n        this._deviceEventEmitterSubscription.remove();\n      } else {\n        DeviceEventEmitter.removeListener(\n          HMSUpdateListenerActions.ON_SESSION_STORE_CHANGED,\n          this._deviceEventEmitterListener\n        );\n      }\n\n      this._deviceEventEmitterSubscription = undefined;\n\n      this._eventEmitter = undefined;\n    }\n  }\n\n  private _deviceEventEmitterListener(data: {\n    id: string;\n    key: string;\n    value: JsonValue;\n  }) {\n    // if id is different from default sdk_id, return early\n    if (data.id !== HMSConstants.DEFAULT_SDK_ID) {\n      return;\n    }\n\n    // emit event for the key\n    getLogger()?.verbose('#Listener ON_SESSION_STORE_CHANGED event: ', data);\n\n    this._eventEmitter?.emit(data.key, null, data);\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/classes/HMSTrack.js

@@ -7,6 +7,19 @@ exports.HMSTrack = void 0;
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Represents a generic track within the HMS (100ms) system.
+ *
+ * This class serves as a base for different types of tracks (audio, video, etc.) within the HMS system. It encapsulates
+ * common properties and functionalities that are shared across different track types.
+ *
+ * @property {string} trackId - The unique identifier for the track.
+ * @property {HMSTrackSource} [source] - The source of the track, indicating whether it's from a plugin, regular input, or screen sharing.
+ * @property {string} [trackDescription] - A brief description of the track.
+ * @property {boolean} [mute] - Indicates whether the track is currently muted.
+ * @property {string} id - A secondary identifier for the track.
+ * @property {HMSTrackType} [type] - The type of the track, distinguishing between audio and video.
+ */
 class HMSTrack {
   constructor(params) {
     _defineProperty(this, "trackId", void 0);

package/lib/commonjs/classes/HMSTrack.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSTrack","constructor","params","_defineProperty","mute","trackId","source","trackDescription","isMute","id","type","exports"],"sources":["HMSTrack.ts"],"sourcesContent":["import type { HMSTrackSource } from './HMSTrackSource';\nimport type { HMSTrackType } from './HMSTrackType';\n\nexport class HMSTrack {\n  trackId: string;\n  source?: HMSTrackSource;\n  trackDescription?: string;\n  mute?: boolean;\n  id: string;\n  type?: HMSTrackType;\n\n  isMute = () => {\n    return this.mute;\n  };\n\n  constructor(params: {\n    trackId: string;\n    source?: HMSTrackSource;\n    trackDescription?: string;\n    isMute?: boolean;\n    id: string;\n    type?: HMSTrackType;\n  }) {\n    this.trackId = params.trackId;\n    this.source = params.source;\n    this.trackDescription = params.trackDescription;\n    this.mute = params.isMute;\n    this.id = params.id;\n    this.type = params.type;\n  }\n}\n"],"mappings":";;;;;;;;;AAGO,MAAMA,QAAQ,CAAC;EAYpBC,WAAWA,CAACC,MAOX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA,iBAXM,MAAM;MACb,OAAO,IAAI,CAACC,IAAI;IAClB,CAAC;IAUC,IAAI,CAACC,OAAO,GAAGH,MAAM,CAACG,OAAO;IAC7B,IAAI,CAACC,MAAM,GAAGJ,MAAM,CAACI,MAAM;IAC3B,IAAI,CAACC,gBAAgB,GAAGL,MAAM,CAACK,gBAAgB;IAC/C,IAAI,CAACH,IAAI,GAAGF,MAAM,CAACM,MAAM;IACzB,IAAI,CAACC,EAAE,GAAGP,MAAM,CAACO,EAAE;IACnB,IAAI,CAACC,IAAI,GAAGR,MAAM,CAACQ,IAAI;EACzB;AACF;AAACC,OAAA,CAAAX,QAAA,GAAAA,QAAA","ignoreList":[]}
+{"version":3,"names":["HMSTrack","constructor","params","_defineProperty","mute","trackId","source","trackDescription","isMute","id","type","exports"],"sources":["HMSTrack.ts"],"sourcesContent":["import type { HMSTrackSource } from './HMSTrackSource';\nimport type { HMSTrackType } from './HMSTrackType';\n\n/**\n * Represents a generic track within the HMS (100ms) system.\n *\n * This class serves as a base for different types of tracks (audio, video, etc.) within the HMS system. It encapsulates\n * common properties and functionalities that are shared across different track types.\n *\n * @property {string} trackId - The unique identifier for the track.\n * @property {HMSTrackSource} [source] - The source of the track, indicating whether it's from a plugin, regular input, or screen sharing.\n * @property {string} [trackDescription] - A brief description of the track.\n * @property {boolean} [mute] - Indicates whether the track is currently muted.\n * @property {string} id - A secondary identifier for the track.\n * @property {HMSTrackType} [type] - The type of the track, distinguishing between audio and video.\n */\nexport class HMSTrack {\n  trackId: string;\n  source?: HMSTrackSource;\n  trackDescription?: string;\n  mute?: boolean;\n  id: string;\n  type?: HMSTrackType;\n\n  isMute = () => {\n    return this.mute;\n  };\n\n  constructor(params: {\n    trackId: string;\n    source?: HMSTrackSource;\n    trackDescription?: string;\n    isMute?: boolean;\n    id: string;\n    type?: HMSTrackType;\n  }) {\n    this.trackId = params.trackId;\n    this.source = params.source;\n    this.trackDescription = params.trackDescription;\n    this.mute = params.isMute;\n    this.id = params.id;\n    this.type = params.type;\n  }\n}\n"],"mappings":";;;;;;;;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,QAAQ,CAAC;EAYpBC,WAAWA,CAACC,MAOX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA,iBAXM,MAAM;MACb,OAAO,IAAI,CAACC,IAAI;IAClB,CAAC;IAUC,IAAI,CAACC,OAAO,GAAGH,MAAM,CAACG,OAAO;IAC7B,IAAI,CAACC,MAAM,GAAGJ,MAAM,CAACI,MAAM;IAC3B,IAAI,CAACC,gBAAgB,GAAGL,MAAM,CAACK,gBAAgB;IAC/C,IAAI,CAACH,IAAI,GAAGF,MAAM,CAACM,MAAM;IACzB,IAAI,CAACC,EAAE,GAAGP,MAAM,CAACO,EAAE;IACnB,IAAI,CAACC,IAAI,GAAGR,MAAM,CAACQ,IAAI;EACzB;AACF;AAACC,OAAA,CAAAX,QAAA,GAAAA,QAAA","ignoreList":[]}

package/lib/commonjs/classes/HMSTrackSettings.js

@@ -7,6 +7,16 @@ exports.HMSTrackSettings = void 0;
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Represents the settings for both video and audio tracks in a HMS (100ms) application.
+ *
+ * This class encapsulates the configurations for video and audio tracks that can be used
+ * in a HMS session.
+ *
+ * @property {HMSVideoTrackSettings} video - Optional video track settings.
+ * @property {HMSAudioTrackSettings} audio - Optional audio track settings.
+ *
+ */
 class HMSTrackSettings {
   constructor(params) {
     _defineProperty(this, "video", void 0);

package/lib/commonjs/classes/HMSTrackSettings.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSTrackSettings","constructor","params","_defineProperty","video","audio","exports"],"sources":["HMSTrackSettings.ts"],"sourcesContent":["import type { HMSAudioTrackSettings } from './HMSAudioTrackSettings';\nimport type { HMSVideoTrackSettings } from './HMSVideoTrackSettings';\n\nexport class HMSTrackSettings {\n  video?: HMSVideoTrackSettings;\n  audio?: HMSAudioTrackSettings;\n\n  constructor(params?: {\n    video?: HMSVideoTrackSettings;\n    audio?: HMSAudioTrackSettings;\n  }) {\n    if (params) {\n      this.video = params.video;\n      this.audio = params.audio;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAGO,MAAMA,gBAAgB,CAAC;EAI5BC,WAAWA,CAACC,MAGX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IACD,IAAID,MAAM,EAAE;MACV,IAAI,CAACE,KAAK,GAAGF,MAAM,CAACE,KAAK;MACzB,IAAI,CAACC,KAAK,GAAGH,MAAM,CAACG,KAAK;IAC3B;EACF;AACF;AAACC,OAAA,CAAAN,gBAAA,GAAAA,gBAAA","ignoreList":[]}
+{"version":3,"names":["HMSTrackSettings","constructor","params","_defineProperty","video","audio","exports"],"sources":["HMSTrackSettings.ts"],"sourcesContent":["import type { HMSAudioTrackSettings } from './HMSAudioTrackSettings';\nimport type { HMSVideoTrackSettings } from './HMSVideoTrackSettings';\n\n/**\n * Represents the settings for both video and audio tracks in a HMS (100ms) application.\n *\n * This class encapsulates the configurations for video and audio tracks that can be used\n * in a HMS session.\n *\n * @property {HMSVideoTrackSettings} video - Optional video track settings.\n * @property {HMSAudioTrackSettings} audio - Optional audio track settings.\n *\n */\nexport class HMSTrackSettings {\n  video?: HMSVideoTrackSettings;\n  audio?: HMSAudioTrackSettings;\n\n  constructor(params?: {\n    video?: HMSVideoTrackSettings;\n    audio?: HMSAudioTrackSettings;\n  }) {\n    if (params) {\n      this.video = params.video;\n      this.audio = params.audio;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,gBAAgB,CAAC;EAI5BC,WAAWA,CAACC,MAGX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IACD,IAAID,MAAM,EAAE;MACV,IAAI,CAACE,KAAK,GAAGF,MAAM,CAACE,KAAK;MACzB,IAAI,CAACC,KAAK,GAAGH,MAAM,CAACG,KAAK;IAC3B;EACF;AACF;AAACC,OAAA,CAAAN,gBAAA,GAAAA,gBAAA","ignoreList":[]}

package/lib/commonjs/classes/HMSTrackSettingsInitState.js

@@ -4,6 +4,15 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.HMSTrackSettingsInitState = void 0;
+/**
+ * Enum for the initial state of tracks in a 100ms (HMS) application.
+ *
+ * This enumeration defines the initial mute state for tracks (audio or video) in a 100ms (HMS) application.
+ * It allows developers to specify whether a track should start in a muted or unmuted state, providing control over the user's media state upon joining a Room.
+ *
+ * @enum {string}
+ * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/join#join-with-muted-audio-video
+ */
 let HMSTrackSettingsInitState = exports.HMSTrackSettingsInitState = /*#__PURE__*/function (HMSTrackSettingsInitState) {
   HMSTrackSettingsInitState["MUTED"] = "MUTED";
   HMSTrackSettingsInitState["UNMUTED"] = "UNMUTED";

package/lib/commonjs/classes/HMSTrackSettingsInitState.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSTrackSettingsInitState","exports"],"sources":["HMSTrackSettingsInitState.ts"],"sourcesContent":["export enum HMSTrackSettingsInitState {\n  MUTED = 'MUTED',\n  UNMUTED = 'UNMUTED',\n}\n"],"mappings":";;;;;;IAAYA,yBAAyB,GAAAC,OAAA,CAAAD,yBAAA,0BAAzBA,yBAAyB;EAAzBA,yBAAyB;EAAzBA,yBAAyB;EAAA,OAAzBA,yBAAyB;AAAA","ignoreList":[]}
+{"version":3,"names":["HMSTrackSettingsInitState","exports"],"sources":["HMSTrackSettingsInitState.ts"],"sourcesContent":["/**\n * Enum for the initial state of tracks in a 100ms (HMS) application.\n *\n * This enumeration defines the initial mute state for tracks (audio or video) in a 100ms (HMS) application.\n * It allows developers to specify whether a track should start in a muted or unmuted state, providing control over the user's media state upon joining a Room.\n *\n * @enum {string}\n * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/join#join-with-muted-audio-video\n */\nexport enum HMSTrackSettingsInitState {\n  /** Represents the state where the track is initially muted. */\n  MUTED = 'MUTED',\n  /** Represents the state where the track is initially unmuted. */\n  UNMUTED = 'UNMUTED',\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AARA,IASYA,yBAAyB,GAAAC,OAAA,CAAAD,yBAAA,0BAAzBA,yBAAyB;EAAzBA,yBAAyB;EAAzBA,yBAAyB;EAAA,OAAzBA,yBAAyB;AAAA","ignoreList":[]}

package/lib/commonjs/classes/HMSTrackSource.js

@@ -4,6 +4,16 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.HMSTrackSource = void 0;
+/**
+ * Enum for HMS Track Source types.
+ *
+ * Defines the source of an HMS track, indicating whether the track originates from a plugin, is a regular track, or is a screen-sharing track.
+ *
+ * @enum {string}
+ * @property {string} REGULAR - Represents a regular track, typically from a user's camera or microphone.
+ * @property {string} SCREEN - Represents a track that shares the screen.
+ * @property {string} PLUGIN - Represents a track sourced from a plugin.
+ */
 let HMSTrackSource = exports.HMSTrackSource = /*#__PURE__*/function (HMSTrackSource) {
   HMSTrackSource["PLUGIN"] = "plugin";
   HMSTrackSource["REGULAR"] = "regular";

package/lib/commonjs/classes/HMSTrackSource.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSTrackSource","exports"],"sources":["HMSTrackSource.ts"],"sourcesContent":["export enum HMSTrackSource {\n  PLUGIN = 'plugin',\n  REGULAR = 'regular',\n  SCREEN = 'screen',\n}\n"],"mappings":";;;;;;IAAYA,cAAc,GAAAC,OAAA,CAAAD,cAAA,0BAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAA,OAAdA,cAAc;AAAA","ignoreList":[]}
+{"version":3,"names":["HMSTrackSource","exports"],"sources":["HMSTrackSource.ts"],"sourcesContent":["/**\n * Enum for HMS Track Source types.\n *\n * Defines the source of an HMS track, indicating whether the track originates from a plugin, is a regular track, or is a screen-sharing track.\n *\n * @enum {string}\n * @property {string} REGULAR - Represents a regular track, typically from a user's camera or microphone.\n * @property {string} SCREEN - Represents a track that shares the screen.\n * @property {string} PLUGIN - Represents a track sourced from a plugin.\n */\nexport enum HMSTrackSource {\n  PLUGIN = 'plugin',\n  REGULAR = 'regular',\n  SCREEN = 'screen',\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AATA,IAUYA,cAAc,GAAAC,OAAA,CAAAD,cAAA,0BAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAA,OAAdA,cAAc;AAAA","ignoreList":[]}

package/lib/commonjs/classes/HMSTrackType.js

@@ -4,6 +4,13 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.HMSTrackType = void 0;
+/**
+ * Enum for HMS Track Types.
+ *
+ * This enumeration defines the types of tracks that can be handled within the HMS (100ms) system, specifically distinguishing between audio and video tracks.
+ * - `AUDIO`: Represents an audio track, typically containing sound or voice data.
+ * - `VIDEO`: Represents a video track, typically containing visual data from a camera or other video sources.
+ */
 let HMSTrackType = exports.HMSTrackType = /*#__PURE__*/function (HMSTrackType) {
   HMSTrackType["AUDIO"] = "AUDIO";
   HMSTrackType["VIDEO"] = "VIDEO";

package/lib/commonjs/classes/HMSTrackType.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSTrackType","exports"],"sources":["HMSTrackType.ts"],"sourcesContent":["export enum HMSTrackType {\n  AUDIO = 'AUDIO',\n  VIDEO = 'VIDEO',\n}\n"],"mappings":";;;;;;IAAYA,YAAY,GAAAC,OAAA,CAAAD,YAAA,0BAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA","ignoreList":[]}
+{"version":3,"names":["HMSTrackType","exports"],"sources":["HMSTrackType.ts"],"sourcesContent":["/**\n * Enum for HMS Track Types.\n *\n * This enumeration defines the types of tracks that can be handled within the HMS (100ms) system, specifically distinguishing between audio and video tracks.\n * - `AUDIO`: Represents an audio track, typically containing sound or voice data.\n * - `VIDEO`: Represents a video track, typically containing visual data from a camera or other video sources.\n */\nexport enum HMSTrackType {\n  AUDIO = 'AUDIO',\n  VIDEO = 'VIDEO',\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,YAAY,GAAAC,OAAA,CAAAD,YAAA,0BAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA","ignoreList":[]}

package/lib/commonjs/classes/HMSUpdateListenerActions.js

@@ -5,16 +5,55 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.HMSUpdateListenerActions = void 0;
 /**
- * These are the available events emitted by the `HMSSDK`
+ * Enum for HMSUpdateListenerActions.
  *
+ * This enumeration defines the set of possible events that can be emitted by the HMSSDK during a Session.
+ * These events cover a wide range of actions, from joining a room to receiving updates about peers and tracks, and more.
  * For more info about these events, checkout Event Listener docs
- * {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners}
+ *
+ * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners
+ *
+ * @enum {string}
+ *
+ * @example
+ * ```typescript
+ * hmsInstance.addEventListener(HMSUpdateListenerActions.ON_JOIN, ({ room: HMSRoom }}) => {
+ *  console.log('Joined room', data);
+ *  // Handle the event
+ * });
+ * ```
+ *
+ * @property {string} ON_PREVIEW - Emitted when the local preview is available.
+ * @property {string} ON_JOIN - Emitted when the local user joins the room.
+ * @property {string} ON_ROOM_UPDATE - Emitted when there is an update related to the room.
+ * @property {string} ON_PEER_UPDATE - Emitted when there is an update related to a peer in the room.
+ * @property {string} ON_TRACK_UPDATE - Emitted when there is an update related to a track in the room.
+ * @property {string} ON_ERROR - Emitted when an error occurs.
+ * @property {string} ON_MESSAGE - Emitted when a message is received.
+ * @property {string} ON_SPEAKER - Emitted when there is an update on the current speaker.
+ * @property {string} RECONNECTING - Emitted when the SDK is attempting to reconnect to the room.
+ * @property {string} RECONNECTED - Emitted when the SDK has successfully reconnected to the room.
+ * @property {string} ON_ROLE_CHANGE_REQUEST - Emitted when there is a request to change the role of a peer.
+ * @property {string} ON_CHANGE_TRACK_STATE_REQUEST - Emitted when there is a request to change the state of a track.
+ * @property {string} ON_REMOVED_FROM_ROOM - Emitted when the local user is removed from the room.
+ * @property {string} ON_RTC_STATS - Emitted when RTC stats are available.
+ * @property {string} ON_LOCAL_AUDIO_STATS - Emitted when stats for the local audio track are available.
+ * @property {string} ON_LOCAL_VIDEO_STATS - Emitted when stats for the local video track are available.
+ * @property {string} ON_REMOTE_AUDIO_STATS - Emitted when stats for a remote audio track are available.
+ * @property {string} ON_REMOTE_VIDEO_STATS - Emitted when stats for a remote video track are available.
+ * @property {string} ON_AUDIO_DEVICE_CHANGED - Emitted when the audio device has changed.
+ * @property {string} ON_SESSION_STORE_AVAILABLE - Emitted when the session store is available.
+ * @property {string} ON_SESSION_STORE_CHANGED - Emitted when the session store has changed.
+ * @property {string} ON_PEER_LIST_UPDATED - Emitted when the list of peers is updated.
+ * @property {string} ON_TRANSCRIPTS - Emitted when transcripts are available.
+ * @property {string} ON_PERMISSIONS_REQUESTED - Emitted when permissions are requested.
  */
 let HMSUpdateListenerActions = exports.HMSUpdateListenerActions = /*#__PURE__*/function (HMSUpdateListenerActions) {
   HMSUpdateListenerActions["ON_PREVIEW"] = "ON_PREVIEW";
   HMSUpdateListenerActions["ON_JOIN"] = "ON_JOIN";
   HMSUpdateListenerActions["ON_ROOM_UPDATE"] = "ON_ROOM_UPDATE";
   HMSUpdateListenerActions["ON_PEER_UPDATE"] = "3";
+  HMSUpdateListenerActions["ON_PEER_LIST_UPDATED"] = "ON_PEER_LIST_UPDATED";
   HMSUpdateListenerActions["ON_TRACK_UPDATE"] = "ON_TRACK_UPDATE";
   HMSUpdateListenerActions["ON_ERROR"] = "ON_ERROR";
   HMSUpdateListenerActions["ON_MESSAGE"] = "ON_MESSAGE";
@@ -32,8 +71,8 @@ let HMSUpdateListenerActions = exports.HMSUpdateListenerActions = /*#__PURE__*/f
   HMSUpdateListenerActions["ON_AUDIO_DEVICE_CHANGED"] = "ON_AUDIO_DEVICE_CHANGED";
   HMSUpdateListenerActions["ON_SESSION_STORE_AVAILABLE"] = "ON_SESSION_STORE_AVAILABLE";
   HMSUpdateListenerActions["ON_SESSION_STORE_CHANGED"] = "ON_SESSION_STORE_CHANGED";
-  HMSUpdateListenerActions["ON_PEER_LIST_UPDATED"] = "ON_PEER_LIST_UPDATED";
   HMSUpdateListenerActions["ON_TRANSCRIPTS"] = "ON_TRANSCRIPTS";
+  HMSUpdateListenerActions["ON_PERMISSIONS_REQUESTED"] = "ON_PERMISSIONS_REQUESTED";
   return HMSUpdateListenerActions;
 }({});
 //# sourceMappingURL=HMSUpdateListenerActions.js.map

package/lib/commonjs/classes/HMSUpdateListenerActions.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSUpdateListenerActions","exports"],"sources":["HMSUpdateListenerActions.ts"],"sourcesContent":["/**\n * These are the available events emitted by the `HMSSDK`\n *\n * For more info about these events, checkout Event Listener docs\n * {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners}\n */\nexport enum HMSUpdateListenerActions {\n  ON_PREVIEW = 'ON_PREVIEW',\n  ON_JOIN = 'ON_JOIN',\n  ON_ROOM_UPDATE = 'ON_ROOM_UPDATE',\n  ON_PEER_UPDATE = '3',\n  ON_TRACK_UPDATE = 'ON_TRACK_UPDATE',\n  ON_ERROR = 'ON_ERROR',\n  ON_MESSAGE = 'ON_MESSAGE',\n  ON_SPEAKER = 'ON_SPEAKER',\n  RECONNECTING = 'RECONNECTING',\n  RECONNECTED = 'RECONNECTED',\n  ON_ROLE_CHANGE_REQUEST = 'ON_ROLE_CHANGE_REQUEST',\n  ON_CHANGE_TRACK_STATE_REQUEST = 'ON_CHANGE_TRACK_STATE_REQUEST',\n  ON_REMOVED_FROM_ROOM = 'ON_REMOVED_FROM_ROOM',\n  ON_RTC_STATS = 'ON_RTC_STATS',\n  ON_LOCAL_AUDIO_STATS = 'ON_LOCAL_AUDIO_STATS',\n  ON_LOCAL_VIDEO_STATS = 'ON_LOCAL_VIDEO_STATS',\n  ON_REMOTE_AUDIO_STATS = 'ON_REMOTE_AUDIO_STATS',\n  ON_REMOTE_VIDEO_STATS = 'ON_REMOTE_VIDEO_STATS',\n  ON_AUDIO_DEVICE_CHANGED = 'ON_AUDIO_DEVICE_CHANGED',\n  ON_SESSION_STORE_AVAILABLE = 'ON_SESSION_STORE_AVAILABLE',\n  ON_SESSION_STORE_CHANGED = 'ON_SESSION_STORE_CHANGED',\n  ON_PEER_LIST_UPDATED = 'ON_PEER_LIST_UPDATED',\n  ON_TRANSCRIPTS = 'ON_TRANSCRIPTS',\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AALA,IAMYA,wBAAwB,GAAAC,OAAA,CAAAD,wBAAA,0BAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAA,OAAxBA,wBAAwB;AAAA","ignoreList":[]}
+{"version":3,"names":["HMSUpdateListenerActions","exports"],"sources":["HMSUpdateListenerActions.ts"],"sourcesContent":["/**\n * Enum for HMSUpdateListenerActions.\n *\n * This enumeration defines the set of possible events that can be emitted by the HMSSDK during a Session.\n * These events cover a wide range of actions, from joining a room to receiving updates about peers and tracks, and more.\n * For more info about these events, checkout Event Listener docs\n *\n * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners\n *\n * @enum {string}\n *\n * @example\n * ```typescript\n * hmsInstance.addEventListener(HMSUpdateListenerActions.ON_JOIN, ({ room: HMSRoom }}) => {\n *  console.log('Joined room', data);\n *  // Handle the event\n * });\n * ```\n *\n * @property {string} ON_PREVIEW - Emitted when the local preview is available.\n * @property {string} ON_JOIN - Emitted when the local user joins the room.\n * @property {string} ON_ROOM_UPDATE - Emitted when there is an update related to the room.\n * @property {string} ON_PEER_UPDATE - Emitted when there is an update related to a peer in the room.\n * @property {string} ON_TRACK_UPDATE - Emitted when there is an update related to a track in the room.\n * @property {string} ON_ERROR - Emitted when an error occurs.\n * @property {string} ON_MESSAGE - Emitted when a message is received.\n * @property {string} ON_SPEAKER - Emitted when there is an update on the current speaker.\n * @property {string} RECONNECTING - Emitted when the SDK is attempting to reconnect to the room.\n * @property {string} RECONNECTED - Emitted when the SDK has successfully reconnected to the room.\n * @property {string} ON_ROLE_CHANGE_REQUEST - Emitted when there is a request to change the role of a peer.\n * @property {string} ON_CHANGE_TRACK_STATE_REQUEST - Emitted when there is a request to change the state of a track.\n * @property {string} ON_REMOVED_FROM_ROOM - Emitted when the local user is removed from the room.\n * @property {string} ON_RTC_STATS - Emitted when RTC stats are available.\n * @property {string} ON_LOCAL_AUDIO_STATS - Emitted when stats for the local audio track are available.\n * @property {string} ON_LOCAL_VIDEO_STATS - Emitted when stats for the local video track are available.\n * @property {string} ON_REMOTE_AUDIO_STATS - Emitted when stats for a remote audio track are available.\n * @property {string} ON_REMOTE_VIDEO_STATS - Emitted when stats for a remote video track are available.\n * @property {string} ON_AUDIO_DEVICE_CHANGED - Emitted when the audio device has changed.\n * @property {string} ON_SESSION_STORE_AVAILABLE - Emitted when the session store is available.\n * @property {string} ON_SESSION_STORE_CHANGED - Emitted when the session store has changed.\n * @property {string} ON_PEER_LIST_UPDATED - Emitted when the list of peers is updated.\n * @property {string} ON_TRANSCRIPTS - Emitted when transcripts are available.\n * @property {string} ON_PERMISSIONS_REQUESTED - Emitted when permissions are requested.\n */\nexport enum HMSUpdateListenerActions {\n  /**\n   * Event emitted when the local preview is available.\n   *\n   * This event is triggered once the local user's video preview becomes available.\n   * It allows the application to display the local video stream to the user,\n   * ensuring they can see their own feed before interacting with others in the room.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/preview\n   */\n  ON_PREVIEW = 'ON_PREVIEW',\n\n  /**\n   * Event emitted when the local user joins the room.\n   *\n   * This event signifies that the local user has successfully connected to the room and is now part of the session.\n   * It is a critical event for initiating further actions within the room, such as fetching current participants,\n   * subscribing to tracks, or sending messages. Handling this event properly is essential for setting up the user's\n   * environment and ensuring a smooth experience in the room.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/join\n   */\n  ON_JOIN = 'ON_JOIN',\n\n  /**\n   * Event emitted when there is an update related to the room.\n   *\n   * This event is triggered by various room-related changes, such as updates to the room's metadata, changes in the room's state,\n   * or modifications to the list of available tracks. It serves as a general notification to the application that some aspect of the\n   * room's configuration or status has changed, enabling the application to respond appropriately, such as updating the UI or querying\n   * for new information to reflect the current state of the room.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners\n   */\n  ON_ROOM_UPDATE = 'ON_ROOM_UPDATE',\n\n  /**\n   * Event emitted when there is an update related to a peer in the room.\n   *\n   * This event is triggered whenever a peer's state changes within the room, such as when a peer's video or audio track is enabled or disabled,\n   * or when a peer's metadata is updated. It provides a way for the application to react to changes in a peer's status, ensuring that the UI\n   * and application state can be updated to reflect the current state of peers in the room.\n   *\n   * @type {string}\n   * @see  https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners\n   */\n  ON_PEER_UPDATE = '3',\n\n  /**\n   * Event emitted when the list of peers in the room is updated.\n   *\n   * This event is triggered whenever there is a change in the list of peers present in the room, such as when a new peer joins,\n   * an existing peer leaves. It allows the application to react to changes in the room's\n   * participant list, enabling dynamic updates to the UI or other logic based on the current set of participants.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/peer/large-room\n   */\n  ON_PEER_LIST_UPDATED = 'ON_PEER_LIST_UPDATED',\n\n  /**\n   * Event emitted when there is an update related to a track in the room.\n   *\n   * This event is triggered whenever a track's state changes within the room, such as when a video or audio track is enabled or disabled,\n   * or when a track's settings are modified. It provides a way for the application to react to changes in a track's status, ensuring that\n   * the UI and application state can be updated to reflect the current state of tracks in the room.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners\n   */\n  ON_TRACK_UPDATE = 'ON_TRACK_UPDATE',\n\n  /**\n   * Event emitted when an error occurs.\n   *\n   * This event is triggered whenever the HMS SDK encounters an error during its operation. It could be due to network issues,\n   * permissions being denied, or any other error that prevents the SDK from functioning as expected. Handling this event allows\n   * the application to inform the user about the issue and possibly take corrective action or log the error for further analysis.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/debugging/error-handling\n   */\n  ON_ERROR = 'ON_ERROR',\n\n  /**\n   * Event emitted when a message is received.\n   *\n   * This event is triggered whenever a message is sent by a peer in the room and received by the local user.\n   * It is crucial for enabling real-time communication within the room, allowing participants to exchange text messages,\n   * notifications, or commands. Handling this event is essential for applications that support chat or command-based interactions\n   * among participants.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/chat\n   */\n  ON_MESSAGE = 'ON_MESSAGE',\n\n  /**\n   * Event emitted when there is an update on the current speaker.\n   *\n   * This event is triggered whenever the active speaker in the room changes, such as when a new participant starts speaking or the current speaker stops.\n   * It allows the application to highlight the current speaker in the UI, enhancing the user experience by making it easier to follow the conversation flow.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/render-video/show-audio-level\n   */\n  ON_SPEAKER = 'ON_SPEAKER',\n\n  /**\n   * Event emitted when the SDK is attempting to reconnect to the room.\n   *\n   * This event is triggered when the connection to the room is lost, and the HMS SDK is trying to re-establish the connection.\n   * It indicates that the SDK is in the process of reconnecting, allowing the application to notify users about the reconnection attempt\n   * and possibly display a loading or waiting indicator. Handling this event is crucial for maintaining a smooth user experience during\n   * network interruptions.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/handle-interruptions/reconnection-handling\n   */\n  RECONNECTING = 'RECONNECTING',\n\n  /**\n   * Event emitted when the SDK has successfully reconnected to the room.\n   *\n   * This event signifies that after a disconnection, the HMS SDK has managed to re-establish the connection to the room successfully.\n   * It is crucial for applications to handle this event to update the UI and inform the user that the connection has been restored,\n   * ensuring a seamless experience. This event can trigger re-initialization of room-related functionalities or refreshes of the UI\n   * to reflect the current state of the room.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/handle-interruptions/reconnection-handling\n   */\n  RECONNECTED = 'RECONNECTED',\n\n  /**\n   * Event emitted when there is a request to change the role of a peer.\n   *\n   * This event is triggered whenever a request is made to change the role of a participant in the room, such as from a viewer to a speaker or vice versa.\n   * Handling this event allows the application to manage user roles dynamically, ensuring that participants have the correct permissions for their intended\n   * actions within the room. It is crucial for applications that implement role-based access control or need to change user permissions on the fly.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/peer/change-role\n   */\n  ON_ROLE_CHANGE_REQUEST = 'ON_ROLE_CHANGE_REQUEST',\n\n  /**\n   * Event emitted when there is a request to change the state of a track.\n   *\n   * This event is triggered whenever a request is made to change the state of a track within the room, such as enabling or disabling a video or audio track.\n   * Handling this event allows the application to respond to changes in track states, ensuring that participants can control their audio and video streams\n   * as needed. It is crucial for applications that allow users to manage their media streams dynamically during a session.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/track/remote-mute\n   */\n  ON_CHANGE_TRACK_STATE_REQUEST = 'ON_CHANGE_TRACK_STATE_REQUEST',\n\n  /**\n   * Event emitted when the local user is removed from the room.\n   *\n   * This event is triggered whenever the local user is explicitly removed from the room by an action from another participant with sufficient permissions or due to room policy violations. Handling this event is crucial for applications to gracefully disconnect the user from the session, possibly clear user-related data, and inform the user about the removal reason if applicable.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/room/end-room\n   */\n  ON_REMOVED_FROM_ROOM = 'ON_REMOVED_FROM_ROOM',\n\n  /**\n   * Event emitted when RTC stats are available.\n   *\n   * This event is triggered when real-time communication (RTC) statistics become available from the HMS SDK.\n   * RTC stats provide detailed information about the performance and quality of the media streams in the session,\n   * including metrics such as packet loss, jitter, round-trip time (RTT), and more. Handling this event allows\n   * the application to monitor and react to the quality of the connection, potentially informing users about\n   * the current call quality or troubleshooting issues in real-time.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/measure-network-quality-and-performance/rtc-stats\n   */\n  ON_RTC_STATS = 'ON_RTC_STATS',\n\n  /**\n   * Event emitted when stats for the local audio track are available.\n   *\n   * This event is triggered when statistics related to the local user's audio track become available from the HMS SDK.\n   * These statistics can include metrics such as round trip time, bitrate, and bytesSent, which are crucial for monitoring\n   * the quality of the audio being transmitted. Handling this event allows the application to react to the audio quality,\n   * potentially adjusting settings or notifying the user about issues in real-time.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/measure-network-quality-and-performance/rtc-stats\n   */\n  ON_LOCAL_AUDIO_STATS = 'ON_LOCAL_AUDIO_STATS',\n\n  /**\n   * Event emitted when stats for the local video track are available.\n   *\n   * This event is triggered when statistics related to the local user's video track become available from the HMS SDK.\n   * These statistics can include metrics such as frame rate, resolution, and bitrate, which are crucial for monitoring\n   * the quality of the video being transmitted. Handling this event allows the application to react to the video quality,\n   * potentially adjusting settings or notifying the user about issues in real-time.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/measure-network-quality-and-performance/rtc-stats\n   */\n  ON_LOCAL_VIDEO_STATS = 'ON_LOCAL_VIDEO_STATS',\n\n  /**\n   * Event emitted when statistics for a remote audio track are available.\n   *\n   * This event is triggered when statistics related to an audio track from a remote user become available from the HMS SDK.\n   * These statistics can include metrics such as bitrate, packet loss, and jitter, which are crucial for monitoring\n   * the quality of the audio being received. Handling this event allows the application to react to the audio quality,\n   * potentially adjusting settings or notifying the user about issues in real-time.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/measure-network-quality-and-performance/rtc-stats\n   */\n  ON_REMOTE_AUDIO_STATS = 'ON_REMOTE_AUDIO_STATS',\n\n  /**\n   * Event emitted when statistics for a remote video track are available.\n   *\n   * This event is triggered when statistics related to a video track from a remote user become available from the HMS SDK.\n   * These statistics can include metrics such as frame rate, resolution, bitrate, and packet loss, which are crucial for monitoring\n   * the quality of the video being received. Handling this event allows the application to react to the video quality,\n   * potentially adjusting settings or notifying the user about issues in real-time.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/measure-network-quality-and-performance/rtc-stats\n   */\n  ON_REMOTE_VIDEO_STATS = 'ON_REMOTE_VIDEO_STATS',\n\n  /**\n   * Event emitted when the audio device has changed. Android only.\n   *\n   * This event is triggered whenever there is a change in the audio output device, such as switching from the built-in speaker to a Bluetooth headset.\n   * Handling this event allows the application to update any UI elements or settings related to the current audio device, ensuring that the user is always aware of which device is being used for audio output.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/configure-your-device/speaker/audio-output-routing\n   */\n  ON_AUDIO_DEVICE_CHANGED = 'ON_AUDIO_DEVICE_CHANGED',\n\n  /**\n   * Event emitted when the session store becomes available.\n   *\n   * This event is triggered when the session store, which may contain critical data for the ongoing session such as user tokens, room state, or other metadata, becomes available to the application.\n   * Handling this event allows the application to perform actions that depend on session-specific data, such as initializing user interfaces or fetching additional room details.\n   * It is crucial for applications that need to ensure all necessary data is loaded before proceeding with further operations.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/room/session-store\n   */\n  ON_SESSION_STORE_AVAILABLE = 'ON_SESSION_STORE_AVAILABLE',\n\n  /**\n   * Event emitted when the session store has changed.\n   *\n   * This event is triggered whenever there is a change in the session store, which may include updates to user tokens, room state, or other metadata critical for the ongoing session.\n   * Handling this event allows the application to react to changes in session-specific data in real-time, ensuring that the application's state is always synchronized with the session store.\n   * This is crucial for applications that rely on up-to-date session information for functionalities like UI updates, access control, and room management.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/room/session-store\n   */\n  ON_SESSION_STORE_CHANGED = 'ON_SESSION_STORE_CHANGED',\n\n  /**\n   * Event emitted when transcripts are available.\n   *\n   * This event is triggered when the HMS SDK has generated transcripts from the audio streams in the room.\n   * It allows the application to receive real-time or post-processed text versions of spoken content, which can be used for\n   * accessibility features, content analysis, or storing meeting minutes. The availability of this feature depends on the\n   * HMS service configuration and may require additional setup or permissions.\n   *\n   * @type {string}\n   * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/extend-capabilities/live-captions\n   */\n  ON_TRANSCRIPTS = 'ON_TRANSCRIPTS',\n\n  /**\n   * Event emitted when the HMS SDK requests permissions from the user. Android only.\n   *\n   * This event is triggered whenever the application needs to request permissions from the user, such as access to the camera or microphone.\n   * It is used in conjunction with the platform's permissions API to prompt the user for the necessary permissions and to inform the HMS SDK\n   * of the user's response. This is crucial for features that require explicit user consent before they can be used.\n   *\n   * @type {string}\n   */\n  ON_PERMISSIONS_REQUESTED = 'ON_PERMISSIONS_REQUESTED',\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AA3CA,IA4CYA,wBAAwB,GAAAC,OAAA,CAAAD,wBAAA,0BAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAA,OAAxBA,wBAAwB;AAAA","ignoreList":[]}

package/lib/commonjs/classes/HMSVideoTrack.js

@@ -8,9 +8,26 @@ var _HMSTrack = require("./HMSTrack");
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Represents a video track within the HMS (100ms) system.
+ *
+ * This class extends `HMSTrack` to provide functionalities specific to video tracks. It includes additional
+ * property `isDegraded` to indicate whether the video quality has been intentionally reduced, typically for
+ * performance reasons. The constructor allows for the initialization of the video track with various parameters
+ * such as track ID, source, description, mute state, degradation state, ID, and type. These parameters provide
+ * detailed information about the video track and its characteristics.
+ *
+ * @extends HMSTrack
+ *
+ * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/render-video/overview
+ */
 class HMSVideoTrack extends _HMSTrack.HMSTrack {
   constructor(params) {
     super(params);
+    /**
+     * Indicates whether the video quality of the track is degraded.
+     * @type {boolean | undefined}
+     */
     _defineProperty(this, "isDegraded", void 0);
     this.isDegraded = params.isDegraded;
   }

package/lib/commonjs/classes/HMSVideoTrack.js.map

@@ -1 +1 @@
-{"version":3,"names":["_HMSTrack","require","_defineProperty","e","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","HMSVideoTrack","HMSTrack","constructor","params","isDegraded","exports"],"sources":["HMSVideoTrack.ts"],"sourcesContent":["import { HMSTrack } from './HMSTrack';\nimport type { HMSTrackSource } from './HMSTrackSource';\nimport type { HMSTrackType } from './HMSTrackType';\n\nexport class HMSVideoTrack extends HMSTrack {\n  isDegraded?: boolean;\n\n  constructor(params: {\n    trackId: string;\n    source?: HMSTrackSource;\n    trackDescription?: string;\n    isMute?: boolean;\n    id: string;\n    isDegraded?: boolean;\n    type?: HMSTrackType;\n  }) {\n    super(params);\n    this.isDegraded = params.isDegraded;\n  }\n}\n"],"mappings":";;;;;;AAAA,IAAAA,SAAA,GAAAC,OAAA;AAAsC,SAAAC,gBAAAC,CAAA,EAAAC,CAAA,EAAAC,CAAA,YAAAD,CAAA,GAAAE,cAAA,CAAAF,CAAA,MAAAD,CAAA,GAAAI,MAAA,CAAAC,cAAA,CAAAL,CAAA,EAAAC,CAAA,IAAAK,KAAA,EAAAJ,CAAA,EAAAK,UAAA,MAAAC,YAAA,MAAAC,QAAA,UAAAT,CAAA,CAAAC,CAAA,IAAAC,CAAA,EAAAF,CAAA;AAAA,SAAAG,eAAAD,CAAA,QAAAQ,CAAA,GAAAC,YAAA,CAAAT,CAAA,uCAAAQ,CAAA,GAAAA,CAAA,GAAAA,CAAA;AAAA,SAAAC,aAAAT,CAAA,EAAAD,CAAA,2BAAAC,CAAA,KAAAA,CAAA,SAAAA,CAAA,MAAAF,CAAA,GAAAE,CAAA,CAAAU,MAAA,CAAAC,WAAA,kBAAAb,CAAA,QAAAU,CAAA,GAAAV,CAAA,CAAAc,IAAA,CAAAZ,CAAA,EAAAD,CAAA,uCAAAS,CAAA,SAAAA,CAAA,YAAAK,SAAA,yEAAAd,CAAA,GAAAe,MAAA,GAAAC,MAAA,EAAAf,CAAA;AAI/B,MAAMgB,aAAa,SAASC,kBAAQ,CAAC;EAG1CC,WAAWA,CAACC,MAQX,EAAE;IACD,KAAK,CAACA,MAAM,CAAC;IAACtB,eAAA;IACd,IAAI,CAACuB,UAAU,GAAGD,MAAM,CAACC,UAAU;EACrC;AACF;AAACC,OAAA,CAAAL,aAAA,GAAAA,aAAA","ignoreList":[]}
+{"version":3,"names":["_HMSTrack","require","_defineProperty","e","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","HMSVideoTrack","HMSTrack","constructor","params","isDegraded","exports"],"sources":["HMSVideoTrack.ts"],"sourcesContent":["import { HMSTrack } from './HMSTrack';\nimport type { HMSTrackSource } from './HMSTrackSource';\nimport type { HMSTrackType } from './HMSTrackType';\n\n/**\n * Represents a video track within the HMS (100ms) system.\n *\n * This class extends `HMSTrack` to provide functionalities specific to video tracks. It includes additional\n * property `isDegraded` to indicate whether the video quality has been intentionally reduced, typically for\n * performance reasons. The constructor allows for the initialization of the video track with various parameters\n * such as track ID, source, description, mute state, degradation state, ID, and type. These parameters provide\n * detailed information about the video track and its characteristics.\n *\n * @extends HMSTrack\n *\n * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/render-video/overview\n */\nexport class HMSVideoTrack extends HMSTrack {\n  /**\n   * Indicates whether the video quality of the track is degraded.\n   * @type {boolean | undefined}\n   */\n  isDegraded?: boolean;\n\n  constructor(params: {\n    trackId: string;\n    source?: HMSTrackSource;\n    trackDescription?: string;\n    isMute?: boolean;\n    id: string;\n    isDegraded?: boolean;\n    type?: HMSTrackType;\n  }) {\n    super(params);\n    this.isDegraded = params.isDegraded;\n  }\n}\n"],"mappings":";;;;;;AAAA,IAAAA,SAAA,GAAAC,OAAA;AAAsC,SAAAC,gBAAAC,CAAA,EAAAC,CAAA,EAAAC,CAAA,YAAAD,CAAA,GAAAE,cAAA,CAAAF,CAAA,MAAAD,CAAA,GAAAI,MAAA,CAAAC,cAAA,CAAAL,CAAA,EAAAC,CAAA,IAAAK,KAAA,EAAAJ,CAAA,EAAAK,UAAA,MAAAC,YAAA,MAAAC,QAAA,UAAAT,CAAA,CAAAC,CAAA,IAAAC,CAAA,EAAAF,CAAA;AAAA,SAAAG,eAAAD,CAAA,QAAAQ,CAAA,GAAAC,YAAA,CAAAT,CAAA,uCAAAQ,CAAA,GAAAA,CAAA,GAAAA,CAAA;AAAA,SAAAC,aAAAT,CAAA,EAAAD,CAAA,2BAAAC,CAAA,KAAAA,CAAA,SAAAA,CAAA,MAAAF,CAAA,GAAAE,CAAA,CAAAU,MAAA,CAAAC,WAAA,kBAAAb,CAAA,QAAAU,CAAA,GAAAV,CAAA,CAAAc,IAAA,CAAAZ,CAAA,EAAAD,CAAA,uCAAAS,CAAA,SAAAA,CAAA,YAAAK,SAAA,yEAAAd,CAAA,GAAAe,MAAA,GAAAC,MAAA,EAAAf,CAAA;AAItC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMgB,aAAa,SAASC,kBAAQ,CAAC;EAO1CC,WAAWA,CAACC,MAQX,EAAE;IACD,KAAK,CAACA,MAAM,CAAC;IAff;AACF;AACA;AACA;IAHEtB,eAAA;IAgBE,IAAI,CAACuB,UAAU,GAAGD,MAAM,CAACC,UAAU;EACrC;AACF;AAACC,OAAA,CAAAL,aAAA,GAAAA,aAAA","ignoreList":[]}

package/lib/commonjs/classes/HMSVideoTrackSettings.js

@@ -8,9 +8,19 @@ function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /**
- * Customize local peer's Video track settings before Joining the Room.
+ * Represents the settings for a video track in a HMS (100ms) application.
  *
- * Checkout Track Settings docs for more details {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/track/track-settings}
+ * This class encapsulates the configurations for video tracks that can be used
+ * in a HMS session.
+ *
+ * @property {HMSSimulcastLayerSettings[]} simulcastSettings - Optional simulcast settings.
+ * @property {HMSTrackSettingsInitState} initialState - Optional initial state for the track.
+ * @property {HMSCameraFacing} cameraFacing - Optional camera facing for the track.
+ * @property {boolean} forceSoftwareDecoder - Optional flag to force software decoder.
+ * @property {boolean} disableAutoResize - Optional flag to disable auto resize.
+ * @property {HMSVirtualBackgroundPlugin} videoPlugin - Optional video plugin settings.
+ *
+ * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/track/track-settings
  */
 class HMSVideoTrackSettings {
   constructor(params) {

package/lib/commonjs/classes/HMSVideoTrackSettings.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSVideoTrackSettings","constructor","params","_defineProperty","simulcastSettings","initialState","cameraFacing","forceSoftwareDecoder","disableAutoResize","videoPlugin","exports"],"sources":["HMSVideoTrackSettings.ts"],"sourcesContent":["import type { ImageURISource, ImageRequireSource } from 'react-native';\nimport type { HMSSimulcastLayerSettings } from './HMSSimulcastLayerSettings';\nimport type { HMSCameraFacing } from './HMSCameraFacing';\nimport type { HMSTrackSettingsInitState } from './HMSTrackSettingsInitState';\n\nexport declare class HMSVirtualBackgroundPlugin {\n  static NAME: string;\n  constructor();\n  enable(): Promise<boolean>;\n  disable(): Promise<boolean>;\n  setBlur(blurRadius: number): Promise<boolean>;\n  setBackground(\n    backgroundImage: ImageURISource | ImageRequireSource\n  ): Promise<boolean>;\n}\n\n/**\n * Customize local peer's Video track settings before Joining the Room.\n *\n * Checkout Track Settings docs for more details {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/track/track-settings}\n */\nexport class HMSVideoTrackSettings {\n  readonly simulcastSettings?: HMSSimulcastLayerSettings[];\n  initialState?: HMSTrackSettingsInitState;\n  cameraFacing?: HMSCameraFacing;\n  forceSoftwareDecoder?: boolean; // android only\n  disableAutoResize?: boolean; // android only\n  videoPlugin?: HMSVirtualBackgroundPlugin;\n\n  constructor(params: {\n    simulcastSettings?: HMSSimulcastLayerSettings[];\n    initialState?: HMSTrackSettingsInitState;\n    cameraFacing?: HMSCameraFacing;\n    forceSoftwareDecoder?: boolean;\n    disableAutoResize?: boolean;\n    videoPlugin?: HMSVirtualBackgroundPlugin;\n  }) {\n    this.simulcastSettings = params.simulcastSettings;\n    this.initialState = params.initialState;\n    this.cameraFacing = params.cameraFacing;\n    this.forceSoftwareDecoder = params.forceSoftwareDecoder;\n    this.disableAutoResize = params.disableAutoResize;\n    this.videoPlugin = params.videoPlugin;\n  }\n}\n"],"mappings":";;;;;;;;;AAgBA;AACA;AACA;AACA;AACA;AACO,MAAMA,qBAAqB,CAAC;EAQjCC,WAAWA,CAACC,MAOX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAX6B;IAAAA,eAAA;IACH;IAAAA,eAAA;IAW3B,IAAI,CAACC,iBAAiB,GAAGF,MAAM,CAACE,iBAAiB;IACjD,IAAI,CAACC,YAAY,GAAGH,MAAM,CAACG,YAAY;IACvC,IAAI,CAACC,YAAY,GAAGJ,MAAM,CAACI,YAAY;IACvC,IAAI,CAACC,oBAAoB,GAAGL,MAAM,CAACK,oBAAoB;IACvD,IAAI,CAACC,iBAAiB,GAAGN,MAAM,CAACM,iBAAiB;IACjD,IAAI,CAACC,WAAW,GAAGP,MAAM,CAACO,WAAW;EACvC;AACF;AAACC,OAAA,CAAAV,qBAAA,GAAAA,qBAAA","ignoreList":[]}
+{"version":3,"names":["HMSVideoTrackSettings","constructor","params","_defineProperty","simulcastSettings","initialState","cameraFacing","forceSoftwareDecoder","disableAutoResize","videoPlugin","exports"],"sources":["HMSVideoTrackSettings.ts"],"sourcesContent":["import type { ImageURISource, ImageRequireSource } from 'react-native';\nimport type { HMSSimulcastLayerSettings } from './HMSSimulcastLayerSettings';\nimport type { HMSCameraFacing } from './HMSCameraFacing';\nimport type { HMSTrackSettingsInitState } from './HMSTrackSettingsInitState';\n\nexport declare class HMSVirtualBackgroundPlugin {\n  static NAME: string;\n  constructor();\n  enable(): Promise<boolean>;\n  disable(): Promise<boolean>;\n  setBlur(blurRadius: number): Promise<boolean>;\n  setBackground(\n    backgroundImage: ImageURISource | ImageRequireSource\n  ): Promise<boolean>;\n}\n\n/**\n * Represents the settings for a video track in a HMS (100ms) application.\n *\n * This class encapsulates the configurations for video tracks that can be used\n * in a HMS session.\n *\n * @property {HMSSimulcastLayerSettings[]} simulcastSettings - Optional simulcast settings.\n * @property {HMSTrackSettingsInitState} initialState - Optional initial state for the track.\n * @property {HMSCameraFacing} cameraFacing - Optional camera facing for the track.\n * @property {boolean} forceSoftwareDecoder - Optional flag to force software decoder.\n * @property {boolean} disableAutoResize - Optional flag to disable auto resize.\n * @property {HMSVirtualBackgroundPlugin} videoPlugin - Optional video plugin settings.\n *\n * @see https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/track/track-settings\n */\nexport class HMSVideoTrackSettings {\n  readonly simulcastSettings?: HMSSimulcastLayerSettings[];\n  initialState?: HMSTrackSettingsInitState;\n  cameraFacing?: HMSCameraFacing;\n  forceSoftwareDecoder?: boolean; // android only\n  disableAutoResize?: boolean; // android only\n  videoPlugin?: HMSVirtualBackgroundPlugin;\n\n  constructor(params: {\n    simulcastSettings?: HMSSimulcastLayerSettings[];\n    initialState?: HMSTrackSettingsInitState;\n    cameraFacing?: HMSCameraFacing;\n    forceSoftwareDecoder?: boolean;\n    disableAutoResize?: boolean;\n    videoPlugin?: HMSVirtualBackgroundPlugin;\n  }) {\n    this.simulcastSettings = params.simulcastSettings;\n    this.initialState = params.initialState;\n    this.cameraFacing = params.cameraFacing;\n    this.forceSoftwareDecoder = params.forceSoftwareDecoder;\n    this.disableAutoResize = params.disableAutoResize;\n    this.videoPlugin = params.videoPlugin;\n  }\n}\n"],"mappings":";;;;;;;;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,qBAAqB,CAAC;EAQjCC,WAAWA,CAACC,MAOX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAAAA,eAAA;IAX6B;IAAAA,eAAA;IACH;IAAAA,eAAA;IAW3B,IAAI,CAACC,iBAAiB,GAAGF,MAAM,CAACE,iBAAiB;IACjD,IAAI,CAACC,YAAY,GAAGH,MAAM,CAACG,YAAY;IACvC,IAAI,CAACC,YAAY,GAAGJ,MAAM,CAACI,YAAY;IACvC,IAAI,CAACC,oBAAoB,GAAGL,MAAM,CAACK,oBAAoB;IACvD,IAAI,CAACC,iBAAiB,GAAGN,MAAM,CAACM,iBAAiB;IACjD,IAAI,CAACC,WAAW,GAAGP,MAAM,CAACO,WAAW;EACvC;AACF;AAACC,OAAA,CAAAV,qBAAA,GAAAA,qBAAA","ignoreList":[]}

package/lib/commonjs/classes/HmsView.js

@@ -11,9 +11,51 @@ var _HMSVideoViewMode = require("./HMSVideoViewMode");
 var _hmsviews = require("../hooks/hmsviews");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/**
+ * Interface defining the properties for the `HmsView` component.
+ *
+ * This interface specifies the structure of the props that the `HmsView` component expects. It includes
+ * properties for configuring the video track display, such as the track ID, mirroring options,
+ * and scale type. It also includes properties for handling events and customizing the component's style.
+ *
+ * @interface HmsViewProps
+ * @property {Object} data - An object containing the track ID, instance ID, mirroring option, and scale type for the video or audio track.
+ * @property {string} data.trackId - The unique identifier for the track to be displayed.
+ * @property {string} data.id - The identifier for the `HmsViewComponent` instance.
+ * @property {boolean} data.mirror - Indicates whether the video should be mirrored. This is commonly used for local video tracks.
+ * @property {HMSVideoViewMode} data.scaleType - Determines how the video fits within the bounds of the view (e.g., aspect fill, aspect fit).
+ * @property {boolean} autoSimulcast - Enables automatic simulcast layer switching based on network conditions, if supported.
+ * @property {boolean} setZOrderMediaOverlay - When true, the video view will be rendered above the regular view hierarchy.
+ * @property {ViewStyle} style - Custom styles to apply to the view.
+ * @property {Function} onChange - A callback function that is invoked when the `HmsView` component emits a change event.
+ * @property {Function} onDataReturned - A callback function that is invoked when the `HmsView` component returns data in response to a capture frame event.
+ *
+ * @see {https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/render-video/overview}
+ */
+
+// Imports the `HmsView` component from the native side using the `requireNativeComponent` function.
+// This component is used to render video tracks in the application.
 const HmsView = (0, _reactNative.requireNativeComponent)('HMSView');
 let _nextRequestId = 1;
 let _requestMap = new Map();
+
+/**
+ * Defines the properties for the `HmsViewComponent`.
+ *
+ * This interface outlines the props that can be passed to the `HmsViewComponent` to configure its behavior and appearance.
+ *
+ * @interface HmsComponentProps
+ * @property {string} trackId - The unique identifier for the track to be displayed.
+ * @property {ViewStyle} [style] - Optional. Custom styles to apply to the view.
+ * @property {boolean} [mirror] - Optional. If true, the video will be mirrored. This is commonly used for local video tracks.
+ * @property {boolean} [autoSimulcast] - Optional. Enables automatic simulcast layer switching based on network conditions, if supported.
+ * @property {HMSVideoViewMode} [scaleType] - Optional. Determines how the video fits within the bounds of the view (e.g., aspect fill, aspect fit).
+ * @property {boolean} [setZOrderMediaOverlay] - Optional. When true, the video view will be rendered above the regular view hierarchy.
+ * @property {string} id - The identifier for the `HmsViewComponent` instance.
+ *
+ * @see {https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/render-video/overview}
+ */
+
 const HmsViewComponent = exports.HmsViewComponent = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
   const {
     trackId,

package/lib/commonjs/classes/HmsView.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_HMSConstants","_HMSVideoViewMode","_hmsviews","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","HmsView","requireNativeComponent","_nextRequestId","_requestMap","Map","HmsViewComponent","exports","React","forwardRef","props","ref","trackId","style","styles","hmsView","id","HMSConstants","DEFAULT_SDK_ID","mirror","setZOrderMediaOverlay","autoSimulcast","scaleType","HMSVideoViewMode","ASPECT_FILL","hmsViewRef","useRef","applyStyles_ANDROID","setApplyStyles_ANDROID","useState","data","onChange","nativeEvent","event","setHmsViewsResolutionsState","_onDataReturned","requestId","result","error","promise","resolve","reject","delete","capture","viewManagerConfig","UIManager","getViewManagerConfig","requestMap","Promise","dispatchViewManagerCommand","findNodeHandle","current","Commands","useImperativeHandle","createElement","Platform","OS","onDataReturned","StyleSheet","create","flex"],"sources":["HmsView.tsx"],"sourcesContent":["import React, { useState, useImperativeHandle, useRef } from 'react';\nimport {\n  findNodeHandle,\n  requireNativeComponent,\n  StyleSheet,\n  UIManager,\n  Platform,\n} from 'react-native';\nimport type { NativeSyntheticEvent, ViewStyle } from 'react-native';\nimport { HMSConstants } from './HMSConstants';\nimport { HMSVideoViewMode } from './HMSVideoViewMode';\nimport { setHmsViewsResolutionsState } from '../hooks/hmsviews';\n\ninterface HmsViewProps {\n  data: {\n    trackId: string;\n    id: string;\n    mirror: boolean;\n    scaleType: HMSVideoViewMode;\n  };\n  autoSimulcast: boolean;\n  setZOrderMediaOverlay: boolean;\n  scaleType: HMSVideoViewMode;\n  style: ViewStyle;\n  onChange: Function;\n  onDataReturned: Function;\n}\n\nconst HmsView = requireNativeComponent<HmsViewProps>('HMSView');\nlet _nextRequestId = 1;\nlet _requestMap = new Map();\n\nexport interface HmsComponentProps {\n  trackId: string;\n  style?: ViewStyle;\n  mirror?: boolean;\n  autoSimulcast?: boolean;\n  scaleType?: HMSVideoViewMode;\n  setZOrderMediaOverlay?: boolean;\n  id: string;\n}\n\nexport const HmsViewComponent = React.forwardRef<any, HmsComponentProps>(\n  (props, ref) => {\n    const {\n      trackId,\n      style = styles.hmsView,\n      id = HMSConstants.DEFAULT_SDK_ID,\n      mirror = false,\n      setZOrderMediaOverlay = false,\n      autoSimulcast = true,\n      scaleType = HMSVideoViewMode.ASPECT_FILL,\n    } = props;\n\n    const hmsViewRef: any = useRef();\n    const [applyStyles_ANDROID, setApplyStyles_ANDROID] = useState(false);\n    const data = {\n      trackId,\n      id,\n      mirror,\n      scaleType,\n    };\n\n    /**\n     * This method is passed to `onChange` prop of `HmsView` Native Component.\n     * It is invoked when `HmsView` emits 'topChange' event.\n     */\n    const onChange = ({\n      nativeEvent,\n    }: NativeSyntheticEvent<{\n      data: { height: number; width: number };\n      event: 'ON_RESOLUTION_CHANGE_EVENT';\n    }>) => {\n      const { event, data } = nativeEvent;\n\n      setApplyStyles_ANDROID(true);\n\n      if (event === 'ON_RESOLUTION_CHANGE_EVENT') {\n        setHmsViewsResolutionsState(trackId, data);\n      }\n    };\n\n    /**\n     * This method is passed to `onDataReturned` prop of `HmsView` Native Component.\n     * It is invoked when `HmsView` emits 'captureFrame' event.\n     */\n    const _onDataReturned = (event: {\n      nativeEvent: { requestId: any; result: any; error: any };\n    }) => {\n      // We grab the relevant data out of our event.\n      let { requestId, result, error } = event.nativeEvent;\n      // Then we get the promise we saved earlier for the given request ID.\n      let promise = _requestMap.get(requestId);\n      if (result) {\n        // If it was successful, we resolve the promise.\n        promise.resolve(result);\n      } else {\n        // Otherwise, we reject it.\n        promise.reject(error);\n      }\n      // Finally, we clean up our request map.\n      _requestMap.delete(requestId);\n    };\n\n    const capture = async () => {\n      const viewManagerConfig = UIManager.getViewManagerConfig('HMSView');\n\n      let requestId = _nextRequestId++;\n      let requestMap = _requestMap;\n\n      // We create a promise here that will be resolved once `_onRequestDone` is\n      // called.\n      let promise = new Promise(function (resolve, reject) {\n        requestMap.set(requestId, { resolve, reject });\n      });\n\n      UIManager.dispatchViewManagerCommand(\n        findNodeHandle(hmsViewRef.current),\n        viewManagerConfig.Commands.capture,\n        [requestId]\n      );\n      return promise;\n    };\n\n    useImperativeHandle(ref, () => {\n      return {\n        capture,\n      };\n    });\n\n    return (\n      <HmsView\n        ref={hmsViewRef}\n        onChange={onChange}\n        data={data}\n        style={\n          Platform.OS === 'android' ? (applyStyles_ANDROID ? style : {}) : style\n        }\n        autoSimulcast={autoSimulcast}\n        scaleType={scaleType}\n        setZOrderMediaOverlay={setZOrderMediaOverlay}\n        onDataReturned={_onDataReturned}\n      />\n    );\n  }\n);\n\nconst styles = StyleSheet.create({\n  hmsView: {\n    flex: 1,\n  },\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_HMSConstants","_HMSVideoViewMode","_hmsviews","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","HmsView","requireNativeComponent","_nextRequestId","_requestMap","Map","HmsViewComponent","exports","React","forwardRef","props","ref","trackId","style","styles","hmsView","id","HMSConstants","DEFAULT_SDK_ID","mirror","setZOrderMediaOverlay","autoSimulcast","scaleType","HMSVideoViewMode","ASPECT_FILL","hmsViewRef","useRef","applyStyles_ANDROID","setApplyStyles_ANDROID","useState","data","onChange","nativeEvent","event","setHmsViewsResolutionsState","_onDataReturned","requestId","result","error","promise","resolve","reject","delete","capture","viewManagerConfig","UIManager","getViewManagerConfig","requestMap","Promise","dispatchViewManagerCommand","findNodeHandle","current","Commands","useImperativeHandle","createElement","Platform","OS","onDataReturned","StyleSheet","create","flex"],"sources":["HmsView.tsx"],"sourcesContent":["import React, { useState, useImperativeHandle, useRef } from 'react';\nimport {\n  findNodeHandle,\n  requireNativeComponent,\n  StyleSheet,\n  UIManager,\n  Platform,\n} from 'react-native';\nimport type { NativeSyntheticEvent, ViewStyle } from 'react-native';\nimport { HMSConstants } from './HMSConstants';\nimport { HMSVideoViewMode } from './HMSVideoViewMode';\nimport { setHmsViewsResolutionsState } from '../hooks/hmsviews';\n\n/**\n * Interface defining the properties for the `HmsView` component.\n *\n * This interface specifies the structure of the props that the `HmsView` component expects. It includes\n * properties for configuring the video track display, such as the track ID, mirroring options,\n * and scale type. It also includes properties for handling events and customizing the component's style.\n *\n * @interface HmsViewProps\n * @property {Object} data - An object containing the track ID, instance ID, mirroring option, and scale type for the video or audio track.\n * @property {string} data.trackId - The unique identifier for the track to be displayed.\n * @property {string} data.id - The identifier for the `HmsViewComponent` instance.\n * @property {boolean} data.mirror - Indicates whether the video should be mirrored. This is commonly used for local video tracks.\n * @property {HMSVideoViewMode} data.scaleType - Determines how the video fits within the bounds of the view (e.g., aspect fill, aspect fit).\n * @property {boolean} autoSimulcast - Enables automatic simulcast layer switching based on network conditions, if supported.\n * @property {boolean} setZOrderMediaOverlay - When true, the video view will be rendered above the regular view hierarchy.\n * @property {ViewStyle} style - Custom styles to apply to the view.\n * @property {Function} onChange - A callback function that is invoked when the `HmsView` component emits a change event.\n * @property {Function} onDataReturned - A callback function that is invoked when the `HmsView` component returns data in response to a capture frame event.\n *\n * @see {https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/render-video/overview}\n */\ninterface HmsViewProps {\n  data: {\n    trackId: string;\n    id: string;\n    mirror: boolean;\n    scaleType: HMSVideoViewMode;\n  };\n  autoSimulcast: boolean;\n  setZOrderMediaOverlay: boolean;\n  scaleType: HMSVideoViewMode;\n  style: ViewStyle;\n  onChange: Function;\n  onDataReturned: Function;\n}\n\n// Imports the `HmsView` component from the native side using the `requireNativeComponent` function.\n// This component is used to render video tracks in the application.\nconst HmsView = requireNativeComponent<HmsViewProps>('HMSView');\nlet _nextRequestId = 1;\nlet _requestMap = new Map();\n\n/**\n * Defines the properties for the `HmsViewComponent`.\n *\n * This interface outlines the props that can be passed to the `HmsViewComponent` to configure its behavior and appearance.\n *\n * @interface HmsComponentProps\n * @property {string} trackId - The unique identifier for the track to be displayed.\n * @property {ViewStyle} [style] - Optional. Custom styles to apply to the view.\n * @property {boolean} [mirror] - Optional. If true, the video will be mirrored. This is commonly used for local video tracks.\n * @property {boolean} [autoSimulcast] - Optional. Enables automatic simulcast layer switching based on network conditions, if supported.\n * @property {HMSVideoViewMode} [scaleType] - Optional. Determines how the video fits within the bounds of the view (e.g., aspect fill, aspect fit).\n * @property {boolean} [setZOrderMediaOverlay] - Optional. When true, the video view will be rendered above the regular view hierarchy.\n * @property {string} id - The identifier for the `HmsViewComponent` instance.\n *\n * @see {https://www.100ms.live/docs/react-native/v2/how-to-guides/set-up-video-conferencing/render-video/overview}\n */\nexport interface HmsComponentProps {\n  trackId: string;\n  style?: ViewStyle;\n  mirror?: boolean;\n  autoSimulcast?: boolean;\n  scaleType?: HMSVideoViewMode;\n  setZOrderMediaOverlay?: boolean;\n  id: string;\n}\n\nexport const HmsViewComponent = React.forwardRef<any, HmsComponentProps>(\n  (props, ref) => {\n    const {\n      trackId,\n      style = styles.hmsView,\n      id = HMSConstants.DEFAULT_SDK_ID,\n      mirror = false,\n      setZOrderMediaOverlay = false,\n      autoSimulcast = true,\n      scaleType = HMSVideoViewMode.ASPECT_FILL,\n    } = props;\n\n    const hmsViewRef: any = useRef();\n    const [applyStyles_ANDROID, setApplyStyles_ANDROID] = useState(false);\n    const data = {\n      trackId,\n      id,\n      mirror,\n      scaleType,\n    };\n\n    /**\n     * This method is passed to `onChange` prop of `HmsView` Native Component.\n     * It is invoked when `HmsView` emits 'topChange' event.\n     */\n    const onChange = ({\n      nativeEvent,\n    }: NativeSyntheticEvent<{\n      data: { height: number; width: number };\n      event: 'ON_RESOLUTION_CHANGE_EVENT';\n    }>) => {\n      const { event, data } = nativeEvent;\n\n      setApplyStyles_ANDROID(true);\n\n      if (event === 'ON_RESOLUTION_CHANGE_EVENT') {\n        setHmsViewsResolutionsState(trackId, data);\n      }\n    };\n\n    /**\n     * This method is passed to `onDataReturned` prop of `HmsView` Native Component.\n     * It is invoked when `HmsView` emits 'captureFrame' event.\n     */\n    const _onDataReturned = (event: {\n      nativeEvent: { requestId: any; result: any; error: any };\n    }) => {\n      // We grab the relevant data out of our event.\n      let { requestId, result, error } = event.nativeEvent;\n      // Then we get the promise we saved earlier for the given request ID.\n      let promise = _requestMap.get(requestId);\n      if (result) {\n        // If it was successful, we resolve the promise.\n        promise.resolve(result);\n      } else {\n        // Otherwise, we reject it.\n        promise.reject(error);\n      }\n      // Finally, we clean up our request map.\n      _requestMap.delete(requestId);\n    };\n\n    const capture = async () => {\n      const viewManagerConfig = UIManager.getViewManagerConfig('HMSView');\n\n      let requestId = _nextRequestId++;\n      let requestMap = _requestMap;\n\n      // We create a promise here that will be resolved once `_onRequestDone` is\n      // called.\n      let promise = new Promise(function (resolve, reject) {\n        requestMap.set(requestId, { resolve, reject });\n      });\n\n      UIManager.dispatchViewManagerCommand(\n        findNodeHandle(hmsViewRef.current),\n        viewManagerConfig.Commands.capture,\n        [requestId]\n      );\n      return promise;\n    };\n\n    useImperativeHandle(ref, () => {\n      return {\n        capture,\n      };\n    });\n\n    return (\n      <HmsView\n        ref={hmsViewRef}\n        onChange={onChange}\n        data={data}\n        style={\n          Platform.OS === 'android' ? (applyStyles_ANDROID ? style : {}) : style\n        }\n        autoSimulcast={autoSimulcast}\n        scaleType={scaleType}\n        setZOrderMediaOverlay={setZOrderMediaOverlay}\n        onDataReturned={_onDataReturned}\n      />\n    );\n  }\n);\n\nconst styles = StyleSheet.create({\n  hmsView: {\n    flex: 1,\n  },\n});\n"],"mappings":"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","ignoreList":[]}

package/lib/module/classes/HMSAudioDevice.js

@@ -1,3 +1,12 @@
+/**
+ * Enum for HMSAudioDevice types.
+ *
+ * This enum represents the different types of audio devices that can be used
+ * in the context of the HMS SDK. It provides a way to specify the preferred
+ * audio output device for audio playback.
+ *
+ * @enum {string}
+ */
 export let HMSAudioDevice = /*#__PURE__*/function (HMSAudioDevice) {
   HMSAudioDevice["SPEAKER_PHONE"] = "SPEAKER_PHONE";
   HMSAudioDevice["WIRED_HEADSET"] = "WIRED_HEADSET";