@cloudflare/realtimekit 1.2.4-staging.1 → 1.2.4-staging.2

package/dist/index.es.js

@@ -6295,6 +6295,12 @@ const Bp = 1080, Hp = 1920, Pw = (s, t, e, r, i, a) => {
 };
 var zt, gi, st, Yt, be, ps, zs, gt, De, Vn, Ln, Ys, xn;
 const Qh = class extends jt {
+  /**
+   * @param {Context} context
+   * @param {Self} self
+   * @param {(string|HTMLImageElement)} [pin]
+   * @param {(string|HTMLImageElement)} [handraise]
+   */
   constructor(e, r, i, a) {
     const o = e.getValue("logger");
     super(o);
@@ -6362,6 +6368,10 @@ const Qh = class extends jt {
       textOnBrand: r.config.designTokens.colors.textOnBrand
     }), i && this.setupIcon("pin", i), a && this.setupIcon("handRaise", a);
   }
+  /**
+   * @param {Context} context
+   * @param {Self} self
+   */
   static _init(e, r) {
     return u(this, null, function* () {
       let i, a;
@@ -6546,8 +6556,11 @@ const Qh = class extends jt {
     this.removeAllSources(), f(this, zt, void 0), f(this, Yt, void 0), f(this, zs, void 0);
   }
   /**
-  	 * Initialize PiP and prepare sources
-  	 */
+   * Initialize PiP and prepare sources
+   * @param {Object} [options]
+   * @param {number} [options.height]
+   * @param {number} [options.width]
+   */
   init({ height: e, width: r } = {}) {
     if (!this.isSupported())
       throw this.logger.error("Pip.unsupported"), new Error("Picture-in-picture is not available in this environment");
@@ -6574,6 +6587,9 @@ const Qh = class extends jt {
   enableSource(e) {
     n(this, gt)[e] !== void 0 && (n(this, gt)[e].enabled = !0);
   }
+  /**
+   * @param {string} source
+   */
   disableSource(e) {
     n(this, gt)[e] !== void 0 && (n(this, gt)[e].enabled = !1);
   }
@@ -6617,7 +6633,11 @@ const Qh = class extends jt {
       handRaised: d
     }, c && this.generateAvatar(e, c);
   }
-  /** Update a video source */
+  /**
+   * Update a video source
+   * @param {string} id
+   * @param {any} source
+   */
   updateSource(e, r) {
     this.logger.info("Pip::UpdateSource", {
       pip: {
@@ -12738,6 +12758,13 @@ var ZM = Object.defineProperty, e0 = Object.getOwnPropertyDescriptor, ht = (s, t
 const t0 = ["text", "image", "file", "custom", "poll"], ud = { maxInvocations: 180, period: 60 };
 var Z, mi, $e, fi, vi, xd, Mf, No, Lu, Ag;
 let ze = (Ag = class extends jt {
+  /**
+   * @param {Context} context
+   * @param {ChatSocketHandler} chatSocketHandler
+   * @param {ChatChannelSocketHandler} chatChannelSocketHandler
+   * @param {Self} self
+   * @param {Participants} participants
+   */
   constructor(t, e, r, i, a) {
     const o = t.getValue("logger");
     super(o);
@@ -12771,11 +12798,19 @@ let ze = (Ag = class extends jt {
     return n(this, vi).getValue("telemetry");
   }
   /**
-  	Set the max character limit of a text message
-  */
+   * Set the max character limit of a text message
+   * @param {number} limit - Max character limit for a text message.
+   */
   setMaxTextLimit(t) {
     this.maxTextLimit = t;
   }
+  /**
+   * @param {MessagePayload} message - Message payload to send.
+   * @param {string[]} [participantIds] - Participant ids to send the message to.
+   * @param {string} [channelId] - Channel id (if sending to a channel).
+   * @param {Object} [options] - Additional options.
+   * @param {Message} [options.replyTo] - Message to reply to.
+   */
   sendMessageInternal(a, o, c) {
     return u(this, arguments, function* (t, e, r, i = {}) {
       switch (t.type) {
@@ -12798,6 +12833,11 @@ let ze = (Ag = class extends jt {
       }
     });
   }
+  /**
+   * @param {string} message - Text message to send.
+   * @param {string[]} [peerIds] - Peer ids to send the message to.
+   * @param {string} [channelId] - Channel id (if sending to a channel).
+   */
   sendTextMessageInternal(t, e, r) {
     return u(this, null, function* () {
       var a, o, c, d, l, p;
@@ -12822,6 +12862,11 @@ let ze = (Ag = class extends jt {
       );
     });
   }
+  /**
+   * @param {(File|ReactNativeFile)} image - Image file to send.
+   * @param {string[]} [peerIds] - Peer ids to send the message to.
+   * @param {string} [channelId] - Channel id (if sending to a channel).
+   */
   sendImageMessageInternal(t, e, r) {
     return u(this, null, function* () {
       var a, o, c, d, l, p;
@@ -12866,6 +12911,11 @@ let ze = (Ag = class extends jt {
       }
     });
   }
+  /**
+   * @param {(File|ReactNativeFile)} file - File to send.
+   * @param {string[]} [peerIds] - Peer ids to send the message to.
+   * @param {string} [channelId] - Channel id (if sending to a channel).
+   */
   sendFileMessageInternal(t, e, r) {
     return u(this, null, function* () {
       var i, a, o, c, d, l;
@@ -12920,6 +12970,10 @@ let ze = (Ag = class extends jt {
   get rateLimits() {
     return ud;
   }
+  /**
+   * @param {number} num
+   * @param {number} period
+   */
   // eslint-disable-next-line class-methods-use-this
   updateRateLimits(t, e) {
     ud.maxInvocations = t, ud.period = e;
@@ -12929,6 +12983,10 @@ let ze = (Ag = class extends jt {
       return this.sendTextMessageInternal(t, e);
     });
   }
+  /**
+   * @param {CustomMessagePayload} message - Custom message payload.
+   * @param {string[]} [peerIds] - Peer ids to send the message to.
+   */
   sendCustomMessage(t, e) {
     return u(this, null, function* () {
       var a, o, c, d, l, p, g, v, S, P, _, C, w, L, F;
@@ -13107,21 +13165,23 @@ let ze = (Ag = class extends jt {
   }
   /**
    * Returns an array of messages sent by a specific userId.
-   * @param userId The user id of the user that sent the message.
+   * @param {string} userId The user id of the user that sent the message.
    */
   getMessagesByUser(t) {
     return this.messages.filter((e) => e.userId === t);
   }
   /**
    * Returns an array of 'text', 'image' or 'file' messages.
-   * @param type 'text', 'image', or 'file'.
+   * @param {(
+   *  'text'|'image'|'file'|'custom'|'poll'
+   * )} type 'text', 'image', 'file', 'custom', or 'poll'.
    */
   getMessagesByType(t) {
     return this.messages.filter((e) => e.type === t);
   }
   /**
    * Pins a chat message
-   * @param id ID of the message to be pinned
+   * @param {string} id ID of the message to be pinned
    */
   pin(t) {
     return u(this, null, function* () {
@@ -13139,7 +13199,7 @@ let ze = (Ag = class extends jt {
   }
   /**
    * Unpins a chat message
-   * @param id ID of the message to be unpinned
+   * @param {string} id ID of the message to be unpinned
    */
   unpin(t) {
     return u(this, null, function* () {
@@ -13157,6 +13217,11 @@ let ze = (Ag = class extends jt {
   }
   /**
    * Gets chat messages in a paginated manner
+   * @param {number} timeStamp
+   * @param {number} size
+   * @param {boolean} reversed
+   * @param {number} [offset=0]
+   * @param {string} [channelId]
    */
   getMessages(t, e, r, i = 0, a = void 0) {
     return u(this, null, function* () {
@@ -13738,6 +13803,13 @@ var u0 = Object.defineProperty, h0 = Object.getOwnPropertyDescriptor, p0 = (s, t
   return r && i && u0(t, e, i), i;
 }, Vf = /* @__PURE__ */ ((s) => (s[s.User = 0] = "User", s[s.Meeting = 1] = "Meeting", s))(Vf || {}), qn, Lo, $u, yi, xo, Ng;
 let Uu = (Ng = class extends jt {
+  /**
+   * @param {Context} context
+   * @param {Self} self
+   * @param {string} viewType
+   * @param {RoomSocketHandler} roomSocketHandler
+   * @param {string} meetingTitle
+   */
   constructor(t, e, r, i, a) {
     const o = t.getValue("logger");
     super(o);
@@ -13786,7 +13858,7 @@ let Uu = (Ng = class extends jt {
   }
   /**
    * Sets current user as broadcasting tab changes
-   * @param broadcastTabChanges
+   * @param {boolean} broadcastTabChanges
    */
   setBroadcastTabChanges(t) {
     if (!n(this, yi).permissions.canSpotlight)
@@ -13795,7 +13867,8 @@ let Uu = (Ng = class extends jt {
   }
   /**
    * Sets current active tab for user
-   * @param spotlightTab
+   * @param {ActiveTab} spotlightTab
+   * @param {TabChangeSource} tabChangeSource
    */
   setSelfActiveTab(t, e) {
     var r;
@@ -13862,6 +13935,8 @@ let Zr = (Vg = class extends jt {
   }
   /**
   * Parse a single line transcript
+  * @param {string} transcriptData - The transcript data to parse
+  * @param {boolean} [isPartialTranscript=false] - Whether the transcript is partial
   */
   static parseTranscript(t, e = !1) {
     if (!t)
@@ -13887,6 +13962,7 @@ let Zr = (Vg = class extends jt {
   }
   /**
   * Parse a multi-line transcript
+  * @param {string} transcriptData - The transcript data to parse
   */
   static parseTranscripts(t) {
     return t ? t.split(`
@@ -13901,6 +13977,9 @@ let Zr = (Vg = class extends jt {
       }
     });
   }
+  /**
+   * @param {TranscriptionData} transcript - Transcript data received for a participant.
+   */
   onTranscript(t) {
     return u(this, null, function* () {
       var r;
@@ -14156,11 +14235,21 @@ var y0 = Object.defineProperty, E0 = Object.getOwnPropertyDescriptor, mn = (s, t
   return r && i && y0(t, e, i), i;
 }, Qt, Fd, ie, $o, Ds, We, Fo, Fu, Gn, hd;
 class ti extends jt {
+  /**
+   * @param {Context} context
+   * @param {Self} self
+   * @param {Participants} participants
+   * @param {StageSocketHandler} stageSocketHandler
+   * @param {RoomSocketHandler} roomSocketHandler
+   */
   constructor(e, r, i, a, o) {
     const c = e.getValue("logger");
     super(c);
     // eslint-disable-next-line class-methods-use-this
     m(this, Fo);
+    /**
+     * @param {StageStatus} status
+     */
     m(this, Gn);
     m(this, Qt, void 0);
     m(this, Fd, void 0);
@@ -14253,6 +14342,9 @@ class ti extends jt {
       n(this, Qt).cancelRequestAccess(), U(this, Gn, hd).call(this, "OFF_STAGE");
     });
   }
+  /**
+   * @param {string[]} userIds
+   */
   grantAccess(e) {
     if (!n(this, ie).roomJoined)
       throw new b(
@@ -14264,6 +14356,9 @@ class ti extends jt {
       throw this.logger.error("Stage::grant_access::permission_denied"), new b("You do not have permission to perform this action", "2001");
     return n(this, Qt).grantAccess(e);
   }
+  /**
+   * @param {string[]} userIds
+   */
   denyAccess(e) {
     if (!n(this, ie).roomJoined)
       throw new b(
@@ -14315,6 +14410,7 @@ class ti extends jt {
    * Method to kick a user off the stage
    *
    * `permissions.acceptStageRequests` privilege required
+   * @param {string[]} userIds
    */
   kick(e) {
     return u(this, null, function* () {
@@ -14533,6 +14629,15 @@ const Ie = {
 };
 var it, xt, Wn, Jn, Qs, Kn, Lr, zn, xg;
 let Ua = (xg = class extends $a {
+  /**
+   * @param {Context} context
+   * @param {PluginResponse} plugin
+   * @param {PluginSocketHandler} pluginSocketHandler
+   * @param {Self} self
+   * @param {Participants} participants
+   * @param {Chat} chat
+   * @param {string} meetingTitle
+   */
   constructor(t, {
     baseURL: e,
     createdAt: r,
@@ -14587,7 +14692,7 @@ let Ua = (xg = class extends $a {
   /**
    * @access private
    * This function forwards events to plugin. This is not meant for external use.
-   * @param message Socket message forwarded to this plugin.
+   * @param {PluginIframeMessage} message Socket message forwarded to this plugin.
    */
   sendIframeEvent(t) {
     this.iframes.size && this.iframes.forEach((e) => {
@@ -14595,6 +14700,9 @@ let Ua = (xg = class extends $a {
       r && (navigator.isReactNative ? r.postMessage(JSON.stringify(t)) : r.contentWindow.postMessage(t, "*"));
     });
   }
+  /**
+   * @param {PluginIframeMessage} iframeMessage
+   */
   handleIframeMessage(t) {
     return u(this, null, function* () {
       var o;
@@ -14777,7 +14885,7 @@ let Ua = (xg = class extends $a {
   /**
    * This method is used for cleaning up event listeners attached to an iframe. It must
    * be used before the iframe is removed from the DOM.
-   * @param viewId ID of the view corresponding to this iframe. Default is 'default'.
+   * @param {string} viewId ID of the view corresponding to this iframe. Default is 'default'.
    */
   removePluginView(t = "default") {
     var i;
@@ -14787,8 +14895,8 @@ let Ua = (xg = class extends $a {
   /**
    * This method adds the communcation layer between the plugin inside the iframe
    * and the core application (meeting object) in the main window.
-   * @param iframe Iframe element to display this plugin.
-   * @param viewId ID of the view corresponding to this iframe. Default is 'default'.
+   * @param {(HTMLIFrameElement|ReactNativeWebView)} iframe Iframe element to display this plugin.
+   * @param {string} viewId ID of the view corresponding to this iframe. Default is 'default'.
    */
   addPluginView(t, e = "default") {
     var o;
@@ -14820,6 +14928,9 @@ let Ua = (xg = class extends $a {
       window.addEventListener("message", c), this.iframes.set(e, { iframe: r, listener: c });
     }
   }
+  /**
+   * @param {boolean} active
+   */
   setActive(t) {
     var e, r;
     if (this.active = t, t) {
@@ -15023,6 +15134,9 @@ var k0 = Object.defineProperty, I0 = Object.getOwnPropertyDescriptor, A0 = (s, t
   return r && i && k0(t, e, i), i;
 };
 let Bu = class {
+  /**
+   * @param {Logger} logger
+   */
   constructor(s) {
     /**
      * All plugins accessible by the current user.
@@ -17505,6 +17619,9 @@ const fD = jc, vg = Rs(
 );
 var Ct, bi, Jo, sa;
 const Rn = class {
+  /**
+   * @param {PresetV2CamelCased} preset
+   */
   constructor(t) {
     m(this, Ct, void 0);
     m(this, bi, void 0);
@@ -17514,7 +17631,10 @@ const Rn = class {
       throw new b("Could not load preset.", "0904");
     f(this, Ct, t.config), f(this, Jo, t.name), f(this, bi, t.ui || Rs(Rh().ui)), f(this, sa, t.permissions.plugins.config);
   }
-  /** @deprecated. Use init() */
+  /**
+   * @deprecated. Use init()
+   * @param {PresetV2CamelCased} preset
+   */
   static fromResponse(t) {
     return new Rn(t);
   }
@@ -17522,6 +17642,10 @@ const Rn = class {
   static default() {
     return new Rn(vg);
   }
+  /**
+   * @param {PresetV2CamelCased} [preset]
+   * @param {boolean} [useDefault=true]
+   */
   static init(t, e = !0) {
     return !t || e ? new Rn(vg) : new Rn(t);
   }
@@ -17671,6 +17795,10 @@ var vD = Object.defineProperty, SD = Object.getOwnPropertyDescriptor, Wf = (s, t
   return r && i && vD(t, e, i), i;
 }, ra, Ko;
 class $h extends jt {
+  /**
+   * @param {Context} context
+   * @param {Self} self
+   */
   constructor(e, r) {
     const i = e.getValue("logger");
     super(i);
@@ -17689,6 +17817,9 @@ class $h extends jt {
   get telemetry() {
     return n(this, Ko).getValue("telemetry");
   }
+  /**
+   * @param {LivestreamState} livestreamState
+   */
   setLivestreamState(e) {
     const r = this.state;
     this.state = e, r !== e && this.emitCurrentLivestreamState();
@@ -17852,6 +17983,12 @@ var PD = Object.defineProperty, _D = Object.getOwnPropertyDescriptor, Gc = (s, t
   return r && i && PD(t, e, i), i;
 }, nt, xr, Ur, Bd, Kf;
 class Ha {
+  /**
+   * @param {Object} args
+   * @param {string} args.name
+   * @param {PluginSocketHandler} args.socketHandler
+   * @param {string} args.meetingId
+   */
   constructor({ name: t, socketHandler: e, meetingId: r }) {
     m(this, Bd);
     h(this, "name", "");
@@ -17873,6 +18010,8 @@ class Ha {
      * @description Sets a value in the store.
      * @param {string} key - Unique identifier used to store value.
      * @param {any} value - Data to be set.
+   * @param {boolean} [sync=true] - Whether to sync change to remote store.
+   * @param {boolean} [emit=false] - Whether to emit to local subscribers.
      * @returns {Promise<void>} A promise.
      */
   set(t, e, r = !0, i = !1) {
@@ -17941,12 +18080,20 @@ class Ha {
   get rateLimits() {
     return this.rateLimitConfig;
   }
+  /**
+   * @param {number} num
+   * @param {number} period
+   */
   updateRateLimits(t, e) {
     this.rateLimitConfig.maxInvocations = t, this.rateLimitConfig.period = e;
   }
   get bulkRateLimits() {
     return this.bulkRateLimitConfig;
   }
+  /**
+   * @param {number} num
+   * @param {number} period
+   */
   // eslint-disable-next-line class-methods-use-this
   updateBulkRateLimits(t, e) {
     this.bulkRateLimitConfig.maxInvocations = t, this.bulkRateLimitConfig.period = e;
@@ -17966,11 +18113,11 @@ class Ha {
     this.listeners[t] = [e];
   }
   /**
-     * @description Removes all listeners for a key on the store.
-     * @param {string} key - Unique identifier used to store value.
-  * * @param {Function} cb - Callback to be removed.
-     * @returns {void} void
-     */
+   * @description Removes all listeners for a key on the store.
+   * @param {string} key - Unique identifier used to store value.
+   * @param {Function} [cb] - Callback to be removed.
+   * @returns {void} void
+   */
   unsubscribe(t, e) {
     var r;
     if (e) {
@@ -17979,6 +18126,9 @@ class Ha {
     }
     this.listeners[t] && delete this.listeners[t];
   }
+  /**
+   * @param {StoreData} data
+   */
   populate(t) {
     f(this, nt, t);
   }
@@ -18125,6 +18275,12 @@ var wD = Object.defineProperty, RD = Object.getOwnPropertyDescriptor, qa = (s, t
 const bD = 0.8, kD = 1.2;
 var aa, oa, Ut, Ai, ho, Fr, En, Mi, po, qd, Yf, er, Qo, Br, Di, go, tr, jd, Xo, ju, Gd, Qf, Wd, Xf, Bg;
 let Tr = (Bg = class extends jt {
+  /**
+   * @param {Context} context
+   * @param {IParticipant} participant
+   * @param {Self} self
+   * @param {RoomSocketHandler} roomSocket
+   */
   constructor(t, e, r, i) {
     const a = t.getValue("logger");
     super(a);
@@ -18285,18 +18441,30 @@ let Tr = (Bg = class extends jt {
   get telemetry() {
     return n(this, Ut).getValue("telemetry");
   }
+  /**
+   * @param {boolean} videoEnabled
+   * @param {boolean} [emitEvent=true]
+   */
   setVideoEnabled(t, e = !0) {
     this.videoEnabled = t, e && (this.logger.info("Participant::setVideoEnabled::videoUpdate", D({}, ui(this))), this.emit("videoUpdate", {
       videoEnabled: this.videoEnabled,
       videoTrack: this.videoTrack
     }));
   }
+  /**
+   * @param {boolean} audioEnabled
+   * @param {boolean} [emitEvent=true]
+   */
   setAudioEnabled(t, e = !0) {
     this.audioEnabled = t, e && (this.logger.info("Participant::setAudioEnabled::audioUpdate", D({}, ui(this))), this.emit("audioUpdate", {
       audioEnabled: this.audioEnabled,
       audioTrack: this.audioTrack
     }));
   }
+  /**
+   * @param {boolean} screenShareEnabled
+   * @param {boolean} [emitEvent=true]
+   */
   setScreenShareEnabled(t, e = !0) {
     this.screenShareEnabled = t, e && this.emit("screenShareUpdate", {
       screenShareEnabled: this.screenShareEnabled,
@@ -18335,6 +18503,8 @@ let Tr = (Bg = class extends jt {
   /**
    * @access private
    * Not for external use
+   * @param {boolean} isPinned
+   * @param {boolean} [emitEvent=true]
    */
   setIsPinned(t, e = !0) {
     var i;
@@ -18408,6 +18578,9 @@ let Tr = (Bg = class extends jt {
       return n(this, Qo).getUserPermissions(this.userId);
     });
   }
+  /**
+   * @param {StageStatus} stageStatus
+   */
   setStageStatus(t) {
     f(this, oa, t), this.emit("stageStatusUpdate", this);
   }
@@ -18417,6 +18590,9 @@ let Tr = (Bg = class extends jt {
   get isPinned() {
     return n(this, aa);
   }
+  /**
+   * @param {HTMLVideoElement} videoElem
+   */
   registerVideoElement(t) {
     var r, i, a, o;
     if (!t)
@@ -18432,6 +18608,9 @@ let Tr = (Bg = class extends jt {
       (a = this.raised) != null ? a : !1
     );
   }
+  /**
+   * @param {HTMLVideoElement} [videoElem]
+   */
   deregisterVideoElement(t) {
     var e, r, i, a;
     if (!t) {
@@ -18442,6 +18621,7 @@ let Tr = (Bg = class extends jt {
   }
   /**
    * Internal method, do not use
+   * @param {HTMLVideoElement} e
    */
   updateVideo(t) {
     var e;
@@ -18495,6 +18675,10 @@ Tr = qa([
   ut("1200")
 ], Tr);
 class uo extends Ff {
+  /**
+   * @param {Logger} logger
+   * @param {MapEvents} [options]
+   */
   constructor(t, e) {
     const {
       onAddEvent: r = "participantJoined",
@@ -18507,12 +18691,25 @@ class uo extends Ff {
       onClearEvent: a
     }, t);
   }
+  /**
+   * @param {T} participant
+   * @param {boolean} [emitEvent=true]
+   */
   add(t, e = !0) {
     return this.has(t.id) && Object.is(this.get(t.id), t) === !1 && this.delete(t.id), super.add(t, e);
   }
+  /**
+   * @param {boolean} [emitEvent=true]
+   * @param {boolean} [removeListeners=false]
+   */
   clear(t = !0, e = !1) {
     return super.clear(t, e);
   }
+  /**
+   * @param {string} participantId
+   * @param {boolean} [emitEvent=true]
+   * @param {boolean} [removeListeners=false]
+   */
   delete(t, e = !0, r = !1) {
     return super.delete(t, e, r);
   }
@@ -18627,6 +18824,14 @@ var DD = Object.defineProperty, OD = Object.getOwnPropertyDescriptor, Jt = (s, t
 const ND = ["ACTIVE_GRID", "PAGINATED", "MANUAL"];
 var Ee, Zo, Gu, Oi, mo, ca, gd, Ni, wt, Hg;
 let Pt = (Hg = class extends jt {
+  /**
+   * This constructs a new Participant object and maintains
+   * the maps of active/joined/waitlisted/pinned/selectedPeers maps.
+   * self : Self
+   * @param {Context} context
+   * @param {Self} self
+   * @param {RoomSocketHandler} roomSocketHandler
+   */
   constructor(t, e, r) {
     const i = t.getValue("logger");
     super(i);
@@ -18702,11 +18907,6 @@ let Pt = (Hg = class extends jt {
      * This stores the `participantId` of the last participant who spoke in the meeting.
      */
     h(this, "lastActiveSpeaker");
-    /**
-     * This constructs a new Participant object and maintains
-     * the maps of active/joined/waitlisted/pinned/selectedPeers maps.
-     * @param self : Self
-     */
     /**
      * Keeps a list of all participants who have been present in the selected peers list.
      */
@@ -18763,7 +18963,7 @@ let Pt = (Hg = class extends jt {
    * Updates the maximum number of participants that are populated in
    * the active map.
    *
-   * @param limit: Updated max limit
+   * @param {number} limit Updated max limit
    */
   setMaxActiveParticipantsCount(t) {
     if (t < 0 || t > 24)
@@ -18786,7 +18986,7 @@ let Pt = (Hg = class extends jt {
   /**
    * Accepts requests from waitlisted participants if user
    * has appropriate permissions.
-   * @param id peerId or userId of the waitlisted participant.
+   * @param {string} id peerId or userId of the waitlisted participant.
    */
   acceptWaitingRoomRequest(t) {
     var r, i;
@@ -18802,6 +19002,7 @@ let Pt = (Hg = class extends jt {
    * We need a new event for socket service events
    * since if we send them all together, sequence of events
    * can be unreliable
+   * @param {string[]} userIds
    */
   acceptAllWaitingRoomRequest(t) {
     return u(this, null, function* () {
@@ -18815,7 +19016,7 @@ let Pt = (Hg = class extends jt {
   /**
    * Rejects requests from waitlisted participants if user
    * has appropriate permissions.
-   * @param id participantId of the waitlisted participant.
+   * @param {string} id participantId of the waitlisted participant.
    */
   rejectWaitingRoomRequest(t) {
     return u(this, null, function* () {
@@ -18863,6 +19064,10 @@ let Pt = (Hg = class extends jt {
       });
     });
   }
+  /**
+   * @param {string[]} peerIds
+   * @param {Array.<('audio'|'video'|'screenshareAudio'|'screenshareVideo')>} [kinds]
+   */
   subscribe(r) {
     return u(this, arguments, function* (t, e = ["audio", "video", "screenshareAudio", "screenshareVideo"]) {
       if (this.viewMode !== "MANUAL")
@@ -18881,6 +19086,10 @@ let Pt = (Hg = class extends jt {
       }), n(this, Ee).getValue("peerSessionStore").emit(k.UPDATE_ACTIVE, { viewMode: this.viewMode, page: this.currentPage });
     });
   }
+  /**
+   * @param {string[]} peerIds
+   * @param {Array.<('audio'|'video'|'screenshareAudio'|'screenshareVideo')>} [kinds]
+   */
   unsubscribe(r) {
     return u(this, arguments, function* (t, e = ["audio", "video", "screenshareAudio", "screenshareVideo"]) {
       if (this.viewMode !== "MANUAL")
@@ -19023,6 +19232,10 @@ let Pt = (Hg = class extends jt {
       return (yield n(this, wt).getRoomPeers(t, e, r)).peers.map(_r.formatSocketPeerMessage);
     });
   }
+  /**
+   * @param {string[]} participantIds
+   * @param {PresetUpdates} permissions
+   */
   updatePermissions(t, e) {
     return u(this, null, function* () {
       const r = this.joined.toArray().filter((a) => t.includes(a.id)).map((a) => a.userId), i = [...new Set(r)];
@@ -20522,6 +20735,10 @@ q = new WeakMap(), la = new WeakMap(), ua = new WeakMap(), Jd = new WeakMap(), f
 };
 var $t;
 class tv extends jt {
+  /**
+   * @param {Context} context
+   * @param {Logger} logger
+   */
   constructor(e, r) {
     super(r);
     h(this, "localMediaHandler");
@@ -20584,6 +20801,14 @@ class tv extends jt {
     var e;
     return (e = n(this, $t)) == null ? void 0 : e.getValue("peerId");
   }
+  /**
+   * @param {Object} options
+   * @param {boolean} [options.video]
+   * @param {boolean} [options.audio]
+   * @param {MediaConstraints} [options.constraints]
+   * @param {boolean} [skipAwaits=false]
+   * @param {Context} [context=null]
+   */
   init() {
     return u(this, arguments, function* (e = {}, r = !1, i = null) {
       var a, o, c, d, l, p, g;
@@ -20683,6 +20908,7 @@ class tv extends jt {
    * If there are more than 1 audio middlewares,
    * they will be executed in the sequence they were added in.
    * If you want the sequence to be altered, please remove all previous middlewares and re-add.
+   * @param {AudioMiddleware} audioMiddleware
    */
   addAudioMiddleware(e) {
     return u(this, null, function* () {
@@ -20691,6 +20917,7 @@ class tv extends jt {
   }
   /**
    * Removes the audio middleware, if it is there.
+   * @param {AudioMiddleware} audioMiddleware
    */
   removeAudioMiddleware(e) {
     return u(this, null, function* () {
@@ -20722,6 +20949,7 @@ class tv extends jt {
    * If there are more than 1 video middlewares,
    * they will be executed in the sequence they were added in.
    * If you want the sequence to be altered, please remove all previous middlewares and re-add.
+   * @param {VideoMiddleware} videoMiddleware
    */
   addVideoMiddleware(e) {
     return u(this, null, function* () {
@@ -20730,8 +20958,8 @@ class tv extends jt {
   }
   /**
    * Sets global config to be used by video middlewares.
-   * @param config config
-   * @param config.disablePerFrameCanvasRendering If set to true,
+   * @param {VideoMiddlewareGlobalConfig} config config
+   * @param {boolean} config.disablePerFrameCanvasRendering If set to true,
    * Instead of calling Middleware for every frame,
    * Middleware will only be called once that too with empty canvas,
    *  it is the responsibility of the middleware author to keep updating this canvas.
@@ -20746,6 +20974,7 @@ class tv extends jt {
   }
   /**
    * Removes the video middleware, if it is there.
+   * @param {VideoMiddleware} videoMiddleware
    */
   removeVideoMiddleware(e) {
     return u(this, null, function* () {
@@ -20864,8 +21093,8 @@ class tv extends jt {
   }
   /**
    * Returns the local participant's device, indexed by ID and kind.
-   * @param deviceId The ID of the device.
-   * @param kind The kind of the device: audio, video, or speaker.
+   * @param {string} deviceId The ID of the device.
+   * @param {('audio'|'video'|'speaker')} kind The kind of the device: audio, video, or speaker.
    */
   getDeviceById(e, r) {
     let i;
@@ -20873,7 +21102,8 @@ class tv extends jt {
   }
   /**
    * Change the current media device that is being used by the local participant.
-   * @param device The device that is to be used. A device of the same `kind` will be replaced.
+   * @param {MediaDeviceInfo} device The device that is to be used.
+   * A device of the same `kind` will be replaced.
    * the primary stream.
    */
   setDevice(e) {
@@ -21113,7 +21343,7 @@ let Ye = (jg = class extends tv {
    * The name of the user can be set by calling this method.
    * This will get reflected to other participants ONLY if
    * this method is called before the room is joined.
-   * @param name Name of the user.
+   * @param {string} name Name of the user.
    */
   setName(t) {
     if (!t)
@@ -27665,6 +27895,9 @@ var FO = Object.defineProperty, BO = Object.getOwnPropertyDescriptor, HO = (s, t
   return r && i && FO(t, e, i), i;
 }, Ps;
 class Xv extends jt {
+  /**
+   * @param {Context} context
+   */
   constructor(e) {
     const r = e.getValue("logger");
     super(r);
@@ -27693,6 +27926,7 @@ class Xv extends jt {
   }
   /**
    * create connected meetings
+   * @param {Array.<{ title: string }>} request
    */
   createMeetings(e) {
     return u(this, null, function* () {
@@ -27708,6 +27942,7 @@ class Xv extends jt {
   }
   /**
    * update meeting title
+   * @param {Array.<{ id: string, title: string }>} request
    */
   updateMeetings(e) {
     return u(this, null, function* () {
@@ -27718,6 +27953,7 @@ class Xv extends jt {
   }
   /**
    * delete connected meetings
+   * @param {string[]} meetingIds
    */
   deleteMeetings(e) {
     return u(this, null, function* () {
@@ -27758,6 +27994,9 @@ class Xv extends jt {
   }
   /**
    * Trigger event to move participants with custom preset
+   * @param {string} sourceMeetingId - id of source meeting
+   * @param {string} destinationMeetingId - id of destination meeting
+   * @param {Array.<{ id: string, presetId: string }>} participants
    */
   moveParticipantsWithCustomPreset(e, r, i) {
     return u(this, null, function* () {
@@ -28368,6 +28607,10 @@ var QO = Object.defineProperty, XO = Object.getOwnPropertyDescriptor, Xl = (s, t
   return r && i && QO(t, e, i), i;
 }, Ge, sn, Kg;
 let ei = (Kg = class {
+  /**
+   * @param {IContext} context
+   * @param {Controller} controller
+   */
   constructor(t, e) {
     m(this, Ge, void 0);
     m(this, sn, void 0);
@@ -28376,6 +28619,14 @@ let ei = (Kg = class {
   get peerId() {
     return n(this, sn).getValue("peerId");
   }
+  /**
+   * @param {Object} [options]
+   * @param {boolean} [options.video]
+   * @param {boolean} [options.audio]
+   * @param {MediaConstraints} [options.constraints]
+   * @param {boolean} [skipAwaits=false]
+   * @param {CachedUserDetails} [cachedUserDetails]
+   */
   static initMedia() {
     return u(this, arguments, function* (t = {}, e = !1, r = void 0) {
       var d;
@@ -28414,6 +28665,12 @@ let ei = (Kg = class {
       return d.setValue("meeting", v), v;
     });
   }
+  /**
+   * @param {string} peerId
+   * @param {ClientOptions} options
+   * @param {string} meetingId
+   * @param {any} args
+   */
   static setupContext(t, e, r, i) {
     var d, l;
     const a = mr.createContext(t, e), o = D(D({}, dw), e == null ? void 0 : e.modules), c = e.defaults || {
@@ -28421,7 +28678,7 @@ let ei = (Kg = class {
       video: !0
     };
     return a.setValue("options", e), a.setValue("peerId", t), a.setValue("modules", o), a.setValue("sdkName", "web-core"), a.setValue("meetingId", r), a.setValue("apiBase", i.apiBase), a.setValue("baseURI", i.baseURI), a.setValue("userId", i.participantId), a.setValue("organizationId", i.orgId), a.setValue("authToken", e.authToken), a.setValue("overrides", (d = e.overrides) != null ? d : {}), a.setValue("env", lw({ baseURI: i.baseURI })), a.setValue("defaults", c), a.setValue("onError", e.onError || (() => {
-    })), a.setValue("cachedUserDetails", Rs(e.cachedUserDetails)), a.setValue("sdkVersion", "1.2.4-staging.1"), (l = e.modules) != null && l.experimentalAudioPlayback && a.setValue("audioPlayback", new YO()), a;
+    })), a.setValue("cachedUserDetails", Rs(e.cachedUserDetails)), a.setValue("sdkVersion", "1.2.4-staging.2"), (l = e.modules) != null && l.experimentalAudioPlayback && a.setValue("audioPlayback", new YO()), a;
   }
   join() {
     return u(this, null, function* () {
@@ -28429,6 +28686,9 @@ let ei = (Kg = class {
       return t.self.roomJoined ? null : t.joinRoom();
     });
   }
+  /**
+   * @param {LeaveRoomState} [state]
+   */
   leave(t) {
     return u(this, null, function* () {
       bg.cleanup(), n(this, sn).getValue("peerSessionStore").reset();
@@ -28541,7 +28801,10 @@ let ei = (Kg = class {
       return this.join();
     });
   }
-  /** @deprecated Use `leave()` instead */
+  /**
+   * @deprecated Use `leave()` instead
+   * @param {LeaveRoomState} [state]
+   */
   leaveRoom(t) {
     return u(this, null, function* () {
       return this.leave(t);