fcr-core 3.8.1 → 3.9.0-alpha

package/lib-es/room-control/user-control/index.js

@@ -0,0 +1,344 @@
+import "core-js/modules/esnext.function.metadata.js";
+import "core-js/modules/esnext.map.delete-all.js";
+import "core-js/modules/esnext.map.emplace.js";
+import "core-js/modules/esnext.map.every.js";
+import "core-js/modules/esnext.map.filter.js";
+import "core-js/modules/esnext.map.find.js";
+import "core-js/modules/esnext.map.find-key.js";
+import "core-js/modules/esnext.map.includes.js";
+import "core-js/modules/esnext.map.key-of.js";
+import "core-js/modules/esnext.map.map-keys.js";
+import "core-js/modules/esnext.map.map-values.js";
+import "core-js/modules/esnext.map.merge.js";
+import "core-js/modules/esnext.map.reduce.js";
+import "core-js/modules/esnext.map.some.js";
+import "core-js/modules/esnext.map.update.js";
+import "core-js/modules/esnext.symbol.metadata.js";
+let _initProto, _getUserDecs, _fetchUserListDecs, _updateUserNameDecs, _updateUserPropertiesDecs, _updateIncrementUserPropertiesDecs, _deleteUserPropertiesDecs, _getUserPropertiesByUserIdDecs, _getUserPropertiesByKeyPathDecs, _updateRemoteUserRoleDecs, _claimHostDecs, _kickOutDecs, _kickOutByUserIdsDecs, _kickOutByUserRolesDecs, _mergeAudioStreamDecs;
+import "core-js/modules/es.array.push.js";
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.find.js";
+import "core-js/modules/esnext.iterator.for-each.js";
+import "core-js/modules/esnext.iterator.map.js";
+import "core-js/modules/esnext.iterator.reduce.js";
+function _applyDecs(e, t, r, n, o, a) { function i(e, t, r) { return function (n, o) { return r && r(n), e[t].call(n, o); }; } function c(e, t) { for (var r = 0; r < e.length; r++) e[r].call(t); return t; } function s(e, t, r, n) { if ("function" != typeof e && (n || void 0 !== e)) throw new TypeError(t + " must " + (r || "be") + " a function" + (n ? "" : " or undefined")); return e; } function applyDec(e, t, r, n, o, a, c, u, l, f, p, d, h) { function m(e) { if (!h(e)) throw new TypeError("Attempted to access private element on non-instance"); } var y, v = t[0], g = t[3], b = !u; if (!b) { r || Array.isArray(v) || (v = [v]); var w = {}, S = [], A = 3 === o ? "get" : 4 === o || d ? "set" : "value"; f ? (p || d ? w = { get: _setFunctionName(function () { return g(this); }, n, "get"), set: function (e) { t[4](this, e); } } : w[A] = g, p || _setFunctionName(w[A], n, 2 === o ? "" : A)) : p || (w = Object.getOwnPropertyDescriptor(e, n)); } for (var P = e, j = v.length - 1; j >= 0; j -= r ? 2 : 1) { var D = v[j], E = r ? v[j - 1] : void 0, I = {}, O = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: n, metadata: a, addInitializer: function (e, t) { if (e.v) throw Error("attempted to call addInitializer after decoration was finished"); s(t, "An initializer", "be", !0), c.push(t); }.bind(null, I) }; try { if (b) (y = s(D.call(E, P, O), "class decorators", "return")) && (P = y);else { var k, F; O.static = l, O.private = f, f ? 2 === o ? k = function (e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function (e) { return e[n]; }, (o < 2 || 4 === o) && (F = function (e, t) { e[n] = t; })); var N = O.access = { has: f ? h.bind() : function (e) { return n in e; } }; if (k && (N.get = k), F && (N.set = F), P = D.call(E, d ? { get: w.get, set: w.set } : w[A], O), d) { if ("object" == typeof P && P) (y = s(P.get, "accessor.get")) && (w.get = y), (y = s(P.set, "accessor.set")) && (w.set = y), (y = s(P.init, "accessor.init")) && S.push(y);else if (void 0 !== P) throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0"); } else s(P, (p ? "field" : "method") + " decorators", "return") && (p ? S.push(P) : w[A] = P); } } finally { I.v = !0; } } return (p || d) && u.push(function (e, t) { for (var r = S.length - 1; r >= 0; r--) t = S[r].call(e, t); return t; }), p || b || (f ? d ? u.push(i(w, "get"), i(w, "set")) : u.push(2 === o ? w[A] : i.call.bind(w[A])) : Object.defineProperty(e, n, w)), P; } function u(e, t) { return Object.defineProperty(e, Symbol.metadata || Symbol.for("Symbol.metadata"), { configurable: !0, enumerable: !0, value: t }); } if (arguments.length >= 6) var l = a[Symbol.metadata || Symbol.for("Symbol.metadata")]; var f = Object.create(null == l ? null : l), p = function (e, t, r, n) { var o, a, i = [], s = function (t) { return _checkInRHS(t) === e; }, u = new Map(); function l(e) { e && i.push(c.bind(null, e)); } for (var f = 0; f < t.length; f++) { var p = t[f]; if (Array.isArray(p)) { var d = p[1], h = p[2], m = p.length > 3, y = 16 & d, v = !!(8 & d), g = 0 == (d &= 7), b = h + "/" + v; if (!g && !m) { var w = u.get(b); if (!0 === w || 3 === w && 4 !== d || 4 === w && 3 !== d) throw Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + h); u.set(b, !(d > 2) || d); } applyDec(v ? e : e.prototype, p, y, m ? "#" + h : _toPropertyKey(h), d, n, v ? a = a || [] : o = o || [], i, v, m, g, 1 === d, v && m ? s : r); } } return l(o), l(a), i; }(e, t, o, f); return r.length || u(e, f), { e: p, get c() { var t = []; return r.length && [u(applyDec(e, [r], n, e.name, 5, f, t), f), c.bind(null, 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); }
+function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
+function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
+import { get, trace } from '../../imports';
+import { FcrUserRole, FcrUserRoleToStringMap } from '../../type';
+import { AgoraObservable } from '../../imports';
+import { convertRteUserToFcrUser } from '../../utilities/user';
+import { FcrUserKickedOutType, FcrUserLeftReason } from './type';
+import { bound } from '../../imports';
+import { convertToStructure } from '../../utilities/collection';
+import { createLogger, generateLogObserver } from '../../utilities/logger';
+import { handleRequestError } from '../../utilities/error';
+import validateParams from '../../utilities/validate-params';
+import { fcrUserKickedOutTypeSchema, fcrUserRolesSchema, stringKeyUnknownValueSchema, stringSchema, stringArraySchema, fcrUserRoleSchema, stringKeyNumberValueSchema } from '../../schema';
+import { ErrorModuleCode } from '../../imports';
+
+/**
+ * @internal
+ */
+export class FcrUserControlImpl {
+  static {
+    [_initProto] = _applyDecs(this, [[bound, 2, "getLocalUser"], [bound, 2, "getUsers"], [bound, 2, "getUserList"], [_getUserDecs, 2, "getUser"], [[bound, trace], 2, "getAllUserCount"], [bound, 2, "getWaterMarkContent"], [_fetchUserListDecs, 2, "fetchUserList"], [_updateUserNameDecs, 2, "updateUserName"], [_updateUserPropertiesDecs, 2, "updateUserProperties"], [_updateIncrementUserPropertiesDecs, 2, "updateIncrementUserProperties"], [_deleteUserPropertiesDecs, 2, "deleteUserProperties"], [[bound, trace], 2, "getUserProperties"], [_getUserPropertiesByUserIdDecs, 2, "getUserPropertiesByUserId"], [_getUserPropertiesByKeyPathDecs, 2, "getUserPropertiesByKeyPath"], [_updateRemoteUserRoleDecs, 2, "updateRemoteUserRole"], [[bound, trace], 2, "revokeHost"], [_claimHostDecs, 2, "claimHost"], [_kickOutDecs, 2, "kickOut"], [_kickOutByUserIdsDecs, 2, "kickOutByUserIds"], [_kickOutByUserRolesDecs, 2, "kickOutByUserRoles"], [_mergeAudioStreamDecs, 2, "mergeAudioStream"]], []).e;
+  }
+  //@internal
+  [(_getUserDecs = [bound, validateParams(stringSchema)], _fetchUserListDecs = [bound, trace(['params'])], _updateUserNameDecs = [bound, trace(['userId', 'userName']), validateParams(stringSchema, stringSchema)], _updateUserPropertiesDecs = [bound, trace(['properties', 'cause', 'userId']), validateParams(stringKeyUnknownValueSchema, stringKeyUnknownValueSchema, stringSchema)], _updateIncrementUserPropertiesDecs = [bound, trace(['increments', 'cause', 'userId']), validateParams(stringKeyNumberValueSchema, stringKeyUnknownValueSchema, stringSchema)], _deleteUserPropertiesDecs = [bound, trace(['keyPath', 'cause', 'userId']), validateParams(stringArraySchema, stringKeyUnknownValueSchema, stringSchema)], _getUserPropertiesByUserIdDecs = [bound, trace(['userId']), validateParams(stringSchema)], _getUserPropertiesByKeyPathDecs = [bound, trace(['keyPath', 'userId']), validateParams(stringSchema, stringSchema)], _updateRemoteUserRoleDecs = [bound, trace(['userId', 'userRole']), validateParams(stringSchema, fcrUserRoleSchema)], _claimHostDecs = [bound, trace(['hostKey']), validateParams(stringSchema)], _kickOutDecs = [bound, trace(['userId', 'type']), validateParams(stringSchema, fcrUserKickedOutTypeSchema)], _kickOutByUserIdsDecs = [trace(['userIds', 'type']), validateParams(stringArraySchema, fcrUserKickedOutTypeSchema)], _kickOutByUserRolesDecs = [trace(['userRoles', 'type']), validateParams(fcrUserRolesSchema, fcrUserKickedOutTypeSchema)], _mergeAudioStreamDecs = [trace(['userId']), validateParams(stringSchema)], "logger")] = (_initProto(this), createLogger({
+    prefix: 'FcrUserControlImpl'
+  }));
+  //@internal
+  _observable = new AgoraObservable();
+  //@internal
+  _userMapByUserId = {};
+  //@internal
+  _userList = [];
+  //@internal
+
+  //@internal
+
+  //@internal
+  _sceneObserver = {
+    onRemoteUsersJoined: (roomId, events) => {
+      events.forEach(event => {
+        const userProperties = this._scene.getUserPropertiesByUserId(event.userInfo.userId);
+        this._roomCache.setUserPlatform(event.userInfo.userId, userProperties?.platform);
+        this._roomCache.setUserAvatar(event.userInfo.userId, userProperties?.avatar);
+      });
+      const fcrUserEvents = events.map(e => {
+        return {
+          userInfo: e.userInfo && convertRteUserToFcrUser(e.userInfo, this._roomCache),
+          operatorUser: e.operatorUser && convertRteUserToFcrUser(e.operatorUser, this._roomCache)
+        };
+      });
+      fcrUserEvents.forEach(event => {
+        const user = event.userInfo;
+        const exists = user.userId in this._userMapByUserId;
+        if (exists) {
+          this.logger.warn(`[FcrUserControl] user joined when the user already exists, userId: ${user.userId}`);
+        } else {
+          this._userMapByUserId[user.userId] = user;
+          this._userList.push(user);
+        }
+      });
+      this._observable.notifyObservers('onRemoteUsersJoined', roomId, fcrUserEvents);
+    },
+    onRemoteUsersLeft: (roomId, events) => {
+      const fcrUserEvents = events.map(e => {
+        return {
+          userInfo: e.userInfo && convertRteUserToFcrUser(e.userInfo, this._roomCache),
+          userProperties: e.userProperties,
+          operatorUser: e.operatorUser && convertRteUserToFcrUser(e.operatorUser, this._roomCache),
+          reason: e.cause?.cmd === 5 ? FcrUserLeftReason.kickOut : FcrUserLeftReason.LeaveRoom
+        };
+      });
+      fcrUserEvents.forEach(event => {
+        const user = event.userInfo;
+        const exists = user.userId in this._userMapByUserId;
+        if (!exists) {
+          this.logger.warn(`[FcrUserControl] user left when the user does not exist, userId: ${user.userId}`);
+        } else {
+          delete this._userMapByUserId[user.userId];
+          const index = this._userList.findIndex(u => user.userId === u.userId);
+          if (index !== -1) {
+            this._userList.splice(index, 1);
+          }
+        }
+      });
+      events.forEach(event => {
+        this._roomCache.deleteUserPlatform(event.userInfo.userId);
+        this._roomCache.deleteUserAvatar(event.userInfo.userId);
+      });
+      this._observable.notifyObservers('onRemoteUsersLeft', roomId, fcrUserEvents);
+    },
+    onUserUpdated: (sceneId, event) => {
+      const fcrUserUpdatedEvent = {
+        modifiedUser: event.modifiedUser && convertRteUserToFcrUser(event.modifiedUser, this._roomCache),
+        operatorUser: event.operatorUser && convertRteUserToFcrUser(event.operatorUser, this._roomCache),
+        reason: event.reason
+      };
+      const user = fcrUserUpdatedEvent.modifiedUser;
+      const exists = user.userId in this._userMapByUserId;
+      if (!exists) {
+        this.logger.warn(`[FcrUserControl] user updated when the user does not exist, userId: ${user.userId}`);
+      } else {
+        this._userMapByUserId[user.userId] = user;
+        const index = this._userList.findIndex(u => user.userId === u.userId);
+        if (index !== -1) {
+          this._userList.splice(index, 1, user);
+        }
+      }
+      this._observable.notifyObservers('onUserInfoUpdated', sceneId, fcrUserUpdatedEvent);
+    },
+    onAllUserCountUpdated: (sceneId, count) => {
+      this._observable.notifyObservers('onAllUserCountUpdated', sceneId, count);
+    },
+    onUserPropertiesUpdated: (roomId, event) => {
+      if (event.cause?.cmd === 5 && event.modifiedUser.userId === this._localUserId) {
+        const {
+          changedProperties
+        } = event;
+        const dirtyStateMap = {
+          '0': FcrUserKickedOutType.Once,
+          '1': FcrUserKickedOutType.Forever,
+          '2': 2
+        };
+        const key = get(changedProperties, 'dirty.state');
+        const type = dirtyStateMap[key];
+        this._observable.notifyObservers('onLocalUserKickedOut', roomId, {
+          type
+        });
+      }
+      if (event.cause?.cmd === 8) {
+        const changedProperties = {};
+        for (const key in event.changedProperties) {
+          if (key.startsWith('flexProps')) {
+            changedProperties[key] = event.changedProperties[key];
+          }
+        }
+        if (Object.keys(changedProperties).length > 0) {
+          const structure = convertToStructure(changedProperties);
+          this._observable.notifyObservers('onUserPropertiesUpdated', roomId, {
+            ...event,
+            changedProperties: structure['flexProps']
+          });
+        }
+      }
+    },
+    onUserPropertiesDeleted: (roomId, event) => {
+      if (event.cause?.cmd === 8) {
+        const changedKeyPaths = [];
+        for (const keyPath of event.changedKeyPaths) {
+          if (keyPath.startsWith('flexProps')) {
+            changedKeyPaths.push(keyPath);
+          }
+        }
+        if (changedKeyPaths.length > 0) {
+          this._observable.notifyObservers('onUserPropertiesDeleted', roomId, {
+            ...event,
+            changedKeyPaths
+          });
+        }
+      }
+    }
+  };
+  constructor(_scene, _api, _sharedCache) {
+    this._scene = _scene;
+    this._api = _api;
+    this._sharedCache = _sharedCache;
+    this._roomCache = _sharedCache.getRoomCache(this._scene.sceneId);
+    const users = this._scene.getUsers();
+    Object.keys(users).forEach(userId => {
+      const userProperties = this._scene.getUserPropertiesByUserId(userId);
+      this._roomCache.setUserAvatar(userId, userProperties?.avatar);
+      this._roomCache.setUserPlatform(userId, userProperties?.platform);
+    });
+    this._userMapByUserId = Object.keys(users).reduce((prev, userId) => {
+      prev[userId] = convertRteUserToFcrUser(users[userId], this._roomCache);
+      return prev;
+    }, {});
+    this._userList = this._scene.getUserList().map(user => {
+      return convertRteUserToFcrUser(user, this._roomCache);
+    });
+    this._localUserId = this._scene.localUser.getLocalUserId();
+    this._addLogObserver();
+    this._scene.addObserver(this._sceneObserver);
+  }
+  // @trace
+  getLocalUser() {
+    const localUserId = this._scene.localUser.getLocalUserId();
+    const localUser = this._scene.getUser(localUserId);
+    return convertRteUserToFcrUser(localUser, this._roomCache);
+  }
+  // @trace
+  getUsers() {
+    return this._userMapByUserId;
+  }
+  // @trace
+  getUserList() {
+    return this._userList;
+  }
+  getUser(userId) {
+    const user = this._scene.getUser(userId);
+    if (user) {
+      return convertRteUserToFcrUser(user, this._roomCache);
+    }
+  }
+  getAllUserCount() {
+    return this._scene.getUserCount();
+  }
+  getWaterMarkContent() {
+    const {
+      userId
+    } = this.getLocalUser();
+    return get(this._scene.getUserPropertiesByUserId(userId), 'security.watermark.content');
+  }
+  async fetchUserList(params) {
+    return await this._scene.fetchUserList(params);
+  }
+  async updateUserName(userId, userName) {
+    return handleRequestError(() => this._api.updateUserName({
+      roomId: this._scene.sceneId,
+      userId,
+      userName
+    }), ErrorModuleCode.FCR_ROOM_USER, 'update user name failed');
+  }
+  updateUserProperties(properties, cause, userId) {
+    return handleRequestError(() => this._api.updateUserProperties({
+      roomId: this._scene.sceneId,
+      userUuid: userId,
+      properties,
+      cause
+    }), ErrorModuleCode.FCR_ROOM_USER, 'update user properties failed');
+  }
+  updateIncrementUserProperties(increments, cause, userId) {
+    return handleRequestError(() => this._api.updateUserProperties({
+      roomId: this._scene.sceneId,
+      userUuid: userId,
+      increments,
+      cause
+    }), ErrorModuleCode.FCR_ROOM_USER, 'update increment user properties failed');
+  }
+  async deleteUserProperties(keyPath, cause, userId) {
+    return handleRequestError(() => this._api.deleteUserProperties({
+      roomId: this._scene.sceneId,
+      userUuid: userId,
+      properties: keyPath,
+      cause
+    }), ErrorModuleCode.FCR_ROOM_USER, 'delete user properties failed');
+  }
+  getUserProperties() {
+    const userProperties = this._scene.getUserProperties();
+    const res = {};
+    for (const userId in userProperties) {
+      res[userId] = userProperties[userId]?.['flexProps'];
+    }
+    return res;
+  }
+  getUserPropertiesByUserId(userId) {
+    return this._scene.getUserPropertiesByUserId(userId)?.['flexProps'];
+  }
+  getUserPropertiesByKeyPath(keyPath, userId) {
+    return this._scene.getUserPropertiesByKeyPath('flexProps.' + keyPath, userId);
+  }
+  async updateRemoteUserRole(userId, userRole) {
+    return handleRequestError(() => this._api.updateUserRole({
+      roomId: this._scene.sceneId,
+      userId,
+      localRole: userRole === FcrUserRole.HOST ? FcrUserRoleToStringMap[FcrUserRole.PARTICIPANT] : undefined,
+      remoteRole: FcrUserRoleToStringMap[userRole]
+    }), ErrorModuleCode.FCR_ROOM_USER, 'update remote user role failed');
+  }
+  async revokeHost() {
+    const userList = this.getUserList();
+    const originHostUser = userList.find(user => user.userRole === FcrUserRole.HOST);
+    if (originHostUser) {
+      return handleRequestError(() => this._api.revokeUserRole({
+        roomId: this._scene.sceneId,
+        remoteRole: FcrUserRoleToStringMap[FcrUserRole.PARTICIPANT]
+      }), ErrorModuleCode.FCR_ROOM_USER, 'revoke host failed');
+    }
+  }
+  async claimHost(hostKey) {
+    const {
+      userId
+    } = this.getLocalUser();
+    return await handleRequestError(() => this._api.claimHost({
+      roomId: this._scene.sceneId,
+      hostKey,
+      userId
+    }), ErrorModuleCode.FCR_ROOM_USER, 'claim host by ticket failed');
+  }
+  async kickOut(userId, type) {
+    return handleRequestError(() => this._api.kickOut(userId, type, {
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM_USER, 'kick out failed');
+  }
+  async kickOutByUserIds(userIds, type) {
+    return handleRequestError(() => this._api.kickOutByUserIds(userIds, type, {
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM_USER, 'kick out by user ids failed');
+  }
+  async kickOutByUserRoles(userRoles, type) {
+    return handleRequestError(() => this._api.kickOutByUserRoles(type, {
+      roomId: this._scene.sceneId
+    }, userRoles.map(role => FcrUserRoleToStringMap[role])), ErrorModuleCode.FCR_ROOM_USER, 'kick out by user roles failed');
+  }
+  mergeAudioStream(userId) {
+    return handleRequestError(() => this._api.mergeAudioStream(userId, {
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM_USER, 'merge audio stream failed');
+  }
+  addObserver(observer) {
+    this._observable.addObserver(observer);
+  }
+  removeObserver(observer) {
+    this._observable.removeObserver(observer);
+  }
+  _addLogObserver() {
+    this.addObserver(generateLogObserver(this.logger, [['onRemoteUsersJoined', ['roomId', 'events']], ['onRemoteUsersLeft', ['roomId', 'events']], ['onUserInfoUpdated', ['roomId', 'event']], ['onAllUserCountUpdated', ['roomId', 'count']], ['onLocalUserKickedOut', ['roomId', 'event']], ['onUserPropertiesUpdated', ['roomId', 'event']], ['onUserPropertiesDeleted', ['roomId', 'event']]]));
+  }
+}

package/lib-es/room-control/user-control/type.js

@@ -0,0 +1,21 @@
+/** user */
+
+export let FcrUserLeftReason = /*#__PURE__*/function (FcrUserLeftReason) {
+  FcrUserLeftReason[FcrUserLeftReason["LeaveRoom"] = 1] = "LeaveRoom";
+  FcrUserLeftReason[FcrUserLeftReason["kickOut"] = 2] = "kickOut";
+  return FcrUserLeftReason;
+}({});
+export let FcrUserKickedOutType = /*#__PURE__*/function (FcrUserKickedOutType) {
+  FcrUserKickedOutType[FcrUserKickedOutType["Once"] = 1] = "Once";
+  FcrUserKickedOutType[FcrUserKickedOutType["Forever"] = 2] = "Forever";
+  return FcrUserKickedOutType;
+}({});
+export let FcrUserRole = /*#__PURE__*/function (FcrUserRole) {
+  FcrUserRole[FcrUserRole["HOST"] = 1] = "HOST";
+  FcrUserRole[FcrUserRole["COHOST"] = 2] = "COHOST";
+  FcrUserRole[FcrUserRole["PARTICIPANT"] = 3] = "PARTICIPANT";
+  FcrUserRole[FcrUserRole["AUDIENCE"] = 4] = "AUDIENCE";
+  FcrUserRole[FcrUserRole["OBSERVER"] = 5] = "OBSERVER";
+  FcrUserRole[FcrUserRole["ROBOT"] = 6] = "ROBOT";
+  return FcrUserRole;
+}({});

package/lib-es/room-control/waitingroom-control/index.js

@@ -0,0 +1,68 @@
+import "core-js/modules/es.array.push.js";
+import "core-js/modules/esnext.function.metadata.js";
+import "core-js/modules/esnext.map.delete-all.js";
+import "core-js/modules/esnext.map.emplace.js";
+import "core-js/modules/esnext.map.every.js";
+import "core-js/modules/esnext.map.filter.js";
+import "core-js/modules/esnext.map.find.js";
+import "core-js/modules/esnext.map.find-key.js";
+import "core-js/modules/esnext.map.includes.js";
+import "core-js/modules/esnext.map.key-of.js";
+import "core-js/modules/esnext.map.map-keys.js";
+import "core-js/modules/esnext.map.map-values.js";
+import "core-js/modules/esnext.map.merge.js";
+import "core-js/modules/esnext.map.reduce.js";
+import "core-js/modules/esnext.map.some.js";
+import "core-js/modules/esnext.map.update.js";
+import "core-js/modules/esnext.symbol.metadata.js";
+let _initProto, _moveToMainRoomByUserIdsDecs, _moveToMainRoomByUserRolesDecs;
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.map.js";
+function _applyDecs(e, t, r, n, o, a) { function i(e, t, r) { return function (n, o) { return r && r(n), e[t].call(n, o); }; } function c(e, t) { for (var r = 0; r < e.length; r++) e[r].call(t); return t; } function s(e, t, r, n) { if ("function" != typeof e && (n || void 0 !== e)) throw new TypeError(t + " must " + (r || "be") + " a function" + (n ? "" : " or undefined")); return e; } function applyDec(e, t, r, n, o, a, c, u, l, f, p, d, h) { function m(e) { if (!h(e)) throw new TypeError("Attempted to access private element on non-instance"); } var y, v = t[0], g = t[3], b = !u; if (!b) { r || Array.isArray(v) || (v = [v]); var w = {}, S = [], A = 3 === o ? "get" : 4 === o || d ? "set" : "value"; f ? (p || d ? w = { get: _setFunctionName(function () { return g(this); }, n, "get"), set: function (e) { t[4](this, e); } } : w[A] = g, p || _setFunctionName(w[A], n, 2 === o ? "" : A)) : p || (w = Object.getOwnPropertyDescriptor(e, n)); } for (var P = e, j = v.length - 1; j >= 0; j -= r ? 2 : 1) { var D = v[j], E = r ? v[j - 1] : void 0, I = {}, O = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: n, metadata: a, addInitializer: function (e, t) { if (e.v) throw Error("attempted to call addInitializer after decoration was finished"); s(t, "An initializer", "be", !0), c.push(t); }.bind(null, I) }; try { if (b) (y = s(D.call(E, P, O), "class decorators", "return")) && (P = y);else { var k, F; O.static = l, O.private = f, f ? 2 === o ? k = function (e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function (e) { return e[n]; }, (o < 2 || 4 === o) && (F = function (e, t) { e[n] = t; })); var N = O.access = { has: f ? h.bind() : function (e) { return n in e; } }; if (k && (N.get = k), F && (N.set = F), P = D.call(E, d ? { get: w.get, set: w.set } : w[A], O), d) { if ("object" == typeof P && P) (y = s(P.get, "accessor.get")) && (w.get = y), (y = s(P.set, "accessor.set")) && (w.set = y), (y = s(P.init, "accessor.init")) && S.push(y);else if (void 0 !== P) throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0"); } else s(P, (p ? "field" : "method") + " decorators", "return") && (p ? S.push(P) : w[A] = P); } } finally { I.v = !0; } } return (p || d) && u.push(function (e, t) { for (var r = S.length - 1; r >= 0; r--) t = S[r].call(e, t); return t; }), p || b || (f ? d ? u.push(i(w, "get"), i(w, "set")) : u.push(2 === o ? w[A] : i.call.bind(w[A])) : Object.defineProperty(e, n, w)), P; } function u(e, t) { return Object.defineProperty(e, Symbol.metadata || Symbol.for("Symbol.metadata"), { configurable: !0, enumerable: !0, value: t }); } if (arguments.length >= 6) var l = a[Symbol.metadata || Symbol.for("Symbol.metadata")]; var f = Object.create(null == l ? null : l), p = function (e, t, r, n) { var o, a, i = [], s = function (t) { return _checkInRHS(t) === e; }, u = new Map(); function l(e) { e && i.push(c.bind(null, e)); } for (var f = 0; f < t.length; f++) { var p = t[f]; if (Array.isArray(p)) { var d = p[1], h = p[2], m = p.length > 3, y = 16 & d, v = !!(8 & d), g = 0 == (d &= 7), b = h + "/" + v; if (!g && !m) { var w = u.get(b); if (!0 === w || 3 === w && 4 !== d || 4 === w && 3 !== d) throw Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + h); u.set(b, !(d > 2) || d); } applyDec(v ? e : e.prototype, p, y, m ? "#" + h : _toPropertyKey(h), d, n, v ? a = a || [] : o = o || [], i, v, m, g, 1 === d, v && m ? s : r); } } return l(o), l(a), i; }(e, t, o, f); return r.length || u(e, f), { e: p, get c() { var t = []; return r.length && [u(applyDec(e, [r], n, e.name, 5, f, t), f), c.bind(null, 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); }
+function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
+function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
+import { FcrBaseRoomControlImpl } from '..';
+import { ErrorModuleCode, trace } from '../../imports';
+import { fcrUserRolesSchema, stringArraySchema } from '../../schema';
+import { FcrUserRoleToStringMap } from '../../type';
+import { handleRequestError } from '../../utilities/error';
+import { createLogger, generateLogObserver } from '../../utilities/logger';
+import validateParams from '../../utilities/validate-params';
+import { FcrRoomType } from '../type';
+
+/**
+ * @internal
+ */
+export class FcrWaitingRoomControlImpl extends FcrBaseRoomControlImpl {
+  static {
+    [_initProto] = _applyDecs(this, [[_moveToMainRoomByUserIdsDecs, 2, "moveToMainRoomByUserIds"], [_moveToMainRoomByUserRolesDecs, 2, "moveToMainRoomByUserRoles"]], [], 0, void 0, FcrBaseRoomControlImpl).e;
+  }
+  //@internal
+  [(_moveToMainRoomByUserIdsDecs = [trace(['userIds']), validateParams(stringArraySchema)], _moveToMainRoomByUserRolesDecs = [trace(['userRoles']), validateParams(fcrUserRolesSchema)], "logger")] = (_initProto(this), createLogger({
+    prefix: 'FcrWaitingRoomControlImpl'
+  }));
+  constructor(engine, scene, api, config, sharedCache, chatConnection, chatRoomControl) {
+    super(engine, scene, api, config, FcrRoomType.Waitingroom, chatConnection, sharedCache, chatRoomControl);
+    this._addLogObserver();
+  }
+  addObserver(observer) {
+    super.addObserver(observer);
+  }
+  removeObserver(observer) {
+    super.removeObserver(observer);
+  }
+  async moveToMainRoomByUserIds(userIds) {
+    return handleRequestError(() => this._api.moveToMainRoomByUserIds(userIds, this._scene.getScenePropertiesByKeyPath('info.mainRoomUuid')), ErrorModuleCode.FCR_ROOM, 'move to main room by user ids failed');
+  }
+  async moveToMainRoomByUserRoles(userRoles) {
+    return handleRequestError(() => this._api.moveToMainRoomByUserRoles(userRoles.map(role => FcrUserRoleToStringMap[role]), this._scene.getScenePropertiesByKeyPath('info.mainRoomUuid')), ErrorModuleCode.FCR_ROOM, 'move to main room by user roles failed');
+  }
+  _addLogObserver() {
+    this.addObserver(generateLogObserver(this.logger, [['onCloudRecordingStateUpdated', ['roomId', 'state']], ['onJoinRoomFailure', ['roomId', 'error']], ['onJoinRoomSuccess', ['roomId']], ['onLiveStreamingStateUpdated', ['roomId', 'state', 'url', 'reason']],
+    // 'onNetworkQualityUpdated',
+    // 'onNetworkStatsUpdated',
+    ['onRoomMessageReceived', ['roomId', 'message']], ['onRoomPropertiesDeleted', ['roomId', 'event']], ['onRoomPropertiesUpdated', ['roomId', 'event']], ['onRoomStateUpdated', ['roomId', 'state']]]));
+  }
+}

package/lib-es/room-control/whiteboard-control/enum.js

@@ -0,0 +1,18 @@
+/**
+ * common enums shared by whiteboard v1 and v2
+ */
+
+export let FcrBoardInactiveReason = /*#__PURE__*/function (FcrBoardInactiveReason) {
+  FcrBoardInactiveReason[FcrBoardInactiveReason["CLOSE"] = 1] = "CLOSE";
+  FcrBoardInactiveReason[FcrBoardInactiveReason["TIMEOUT"] = 2] = "TIMEOUT";
+  FcrBoardInactiveReason[FcrBoardInactiveReason["SEIZE"] = 3] = "SEIZE";
+  return FcrBoardInactiveReason;
+}({});
+export let FcrBoardRegion = /*#__PURE__*/function (FcrBoardRegion) {
+  FcrBoardRegion["CN"] = "cn-hz";
+  FcrBoardRegion["US"] = "us-sv";
+  FcrBoardRegion["IN"] = "in-mum";
+  FcrBoardRegion["SG"] = "sg";
+  FcrBoardRegion["GB"] = "gb-lon";
+  return FcrBoardRegion;
+}({});

package/lib-es/room-control/whiteboard-control/type.js

@@ -0,0 +1,10 @@
+/**
+ * common types shared by whiteboard v1 and v2
+ */
+
+export let FcrBoardPropertiesState = /*#__PURE__*/function (FcrBoardPropertiesState) {
+  FcrBoardPropertiesState[FcrBoardPropertiesState["ACTIVE"] = 1] = "ACTIVE";
+  FcrBoardPropertiesState[FcrBoardPropertiesState["INACTIVE"] = 0] = "INACTIVE";
+  FcrBoardPropertiesState[FcrBoardPropertiesState["BACKGROUND_COLOR_UPDATED"] = 100101] = "BACKGROUND_COLOR_UPDATED";
+  return FcrBoardPropertiesState;
+}({});

package/lib-es/room-control/whiteboard-control/utils.js

@@ -0,0 +1,13 @@
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.some.js";
+import { FcrPermissionAction } from '../privilege-control/type';
+export const hasBoardWritePermission = permissions => {
+  return permissions.some(permission => {
+    return permission.info?.action === FcrPermissionAction.BoardWrite;
+  });
+};
+export const hasAnnotationWritePermission = permissions => {
+  return permissions.some(permission => {
+    return permission.info?.action === FcrPermissionAction.AnnotationWrite;
+  });
+};

package/lib-es/room-control/whiteboard-control-v1/board-subwindow.js

@@ -0,0 +1,18 @@
+export class FcrBoardSubWindowImpl {
+  constructor(_appId) {
+    this._appId = _appId;
+  }
+  exportPdf() {
+    window.postMessage({
+      type: '@netless/_request_save_pdf_',
+      appId: this._appId /* windowManager.addApp 返回的值, 指定要保存哪个窗口的板书, */
+    });
+    return new Promise((resolve, reject) => {
+      window.addEventListener('message', event => {
+        if (event.data.type === '@netless/_result_save_pdf_') {
+          event.data.progress === 100 && resolve(event.data.result?.pdf);
+        }
+      });
+    });
+  }
+}