@microsoft/teams-js 2.12.1-beta.0 → 2.13.0-beta.0

package/dist/MicrosoftTeams.d.ts

@@ -8017,150 +8017,176 @@ export namespace tasks {
 }
 
 /**
-    * @hidden
-    * Allowed roles during a meeting.
-    *
-    * @beta
-    */
-export enum UserMeetingRole {
-        guest = "Guest",
-        attendee = "Attendee",
-        presenter = "Presenter",
-        organizer = "Organizer"
-}
-/**
-    * @hidden
-    * State of the current Live Share sessions backing fluid container.
-    *
-    * @beta
-    */
-export enum ContainerState {
-        /**
-            * The call to `LiveShareHost.setContainerId()` successfully created the container mapping
-            * for the current Live Share session.
-            */
-        added = "Added",
-        /**
-            * A container mapping for the current Live Share Session already exists and should be used
-            * when joining the sessions Fluid container.
-            */
-        alreadyExists = "AlreadyExists",
-        /**
-            * The call to `LiveShareHost.setContainerId()` failed to create the container mapping due to
-            * another client having already set the container ID for the current Live Share session.
-            */
-        conflict = "Conflict",
-        /**
-            * A container mapping for the current Live Share session doesn't exist yet.
-            */
-        notFound = "NotFound"
-}
-/**
-    * @hidden
-    * Returned from `LiveShareHost.get/setFluidContainerId()` to specify the container mapping for the
-    * current Live Share session.
+    * APIs involving Live Share, a framework for building real-time collaborative apps.
+    * For more information, visit https://aka.ms/teamsliveshare
     *
-    * @beta
+    * @see LiveShareHost
     */
-export interface IFluidContainerInfo {
-        /**
-            * State of the containerId mapping.
-            */
-        containerState: ContainerState;
+export namespace liveShare {
         /**
-            * ID of the container to join for the meeting. Undefined if the container hasn't been
-            * created yet.
+            * @hidden
+            * The meeting roles of a user.
+            * Used in Live Share for its role verification feature.
+            * For more information, visit https://learn.microsoft.com/microsoftteams/platform/apps-in-teams-meetings/teams-live-share-capabilities?tabs=javascript#role-verification-for-live-data-structures
             */
-        containerId: string | undefined;
+        enum UserMeetingRole {
+                /**
+                    * Guest role.
+                    */
+                guest = "Guest",
+                /**
+                    * Attendee role.
+                    */
+                attendee = "Attendee",
+                /**
+                    * Presenter role.
+                    */
+                presenter = "Presenter",
+                /**
+                    * Organizer role.
+                    */
+                organizer = "Organizer"
+        }
         /**
-            * If true, the local client should create the container and then save the created containers
-            * ID to the mapping service.
+            * @hidden
+            * State of the current Live Share session's Fluid container.
+            * This is used internally by the `LiveShareClient` when joining a Live Share session.
             */
-        shouldCreate: boolean;
+        enum ContainerState {
+                /**
+                    * The call to `LiveShareHost.setContainerId()` successfully created the container mapping
+                    * for the current Live Share session.
+                    */
+                added = "Added",
+                /**
+                    * A container mapping for the current Live Share session already exists.
+                    * This indicates to Live Share that a new container does not need be created.
+                    */
+                alreadyExists = "AlreadyExists",
+                /**
+                    * The call to `LiveShareHost.setContainerId()` failed to create the container mapping.
+                    * This happens when another client has already set the container ID for the session.
+                    */
+                conflict = "Conflict",
+                /**
+                    * A container mapping for the current Live Share session does not yet exist.
+                    * This indicates to Live Share that a new container should be created.
+                    */
+                notFound = "NotFound"
+        }
         /**
-            * If `containerId` is undefined and `shouldCreate` is false, the container isn't ready but
-            * another client is creating it. The local client should wait the specified amount of time and
-            * then ask for the container info again.
+            * @hidden
+            * Returned from `LiveShareHost.getFluidContainerId()` and `LiveShareHost.setFluidContainerId`.
+            * This response specifies the container mapping information for the current Live Share session.
             */
-        retryAfter: number;
-}
-/**
-    * @hidden
-    * Returned from `LiveShareHost.getNtpTime()` to specify the global timestamp for the current
-    * Live Share session.
-    *
-    * @beta
-    */
-export interface INtpTimeInfo {
+        interface IFluidContainerInfo {
+                /**
+                    * State of the containerId mapping.
+                    */
+                containerState: ContainerState;
+                /**
+                    * ID of the container to join for the meeting. Undefined if the container hasn't been
+                    * created yet.
+                    */
+                containerId: string | undefined;
+                /**
+                    * If true, the local client should create the container and then save the created containers
+                    * ID to the mapping service.
+                    */
+                shouldCreate: boolean;
+                /**
+                    * If `containerId` is undefined and `shouldCreate` is false, the container isn't ready
+                    * but another client is creating it. In this case, the local client should wait the specified
+                    * amount of time before calling `LiveShareHost.getFluidContainerId()` again.
+                    */
+                retryAfter: number;
+        }
         /**
-            * ISO 8601 formatted server time. For example: '2019-09-07T15:50-04:00'
+            * @hidden
+            * Returned from `LiveShareHost.getNtpTime()` to specify the global timestamp for the current
+            * Live Share session.
             */
-        ntpTime: string;
+        interface INtpTimeInfo {
+                /**
+                    * ISO 8601 formatted server time. For example: '2019-09-07T15:50-04:00'
+                    */
+                ntpTime: string;
+                /**
+                    * Server time expressed as the number of milliseconds since the ECMAScript epoch.
+                    */
+                ntpTimeInUTC: number;
+        }
         /**
-            * Server time expressed as the number of milliseconds since the ECMAScript epoch.
+            * @hidden
+            * Returned from `LiveShareHost.getFluidTenantInfo()` to specify the Fluid service to use for the
+            * current Live Share session.
             */
-        ntpTimeInUTC: number;
-}
-/**
-    * @hidden
-    * Returned from `LiveShareHost.getFluidTenantInfo()` to specify the Fluid service to use for the
-    * current Live Share session.
-    *
-    * @beta
-    */
-export interface IFluidTenantInfo {
+        interface IFluidTenantInfo {
+                /**
+                    * The Fluid Tenant ID Live Share should use.
+                    */
+                tenantId: string;
+                /**
+                    * The Fluid service endpoint Live Share should use.
+                    */
+                serviceEndpoint: string;
+        }
         /**
-            * The Fluid Tenant ID Live Share should use.
+            * @hidden
+            * Returned from `LiveShareHost.getClientInfo()` to specify the client info for a
+            * particular client in a Live Share session.
             */
-        tenantId: string;
+        interface IClientInfo {
+                /**
+                    * The host user's `userId` associated with a given `clientId`
+                    */
+                userId: string;
+                /**
+                    * User's meeting roles associated with a given `clientId`
+                    */
+                roles: UserMeetingRole[];
+                /**
+                    * The user's display name associated with a given `clientId`.
+                    * If this returns as `undefined`, the user may need to update their host client.
+                    */
+                displayName?: string;
+        }
         /**
-            * The Fluid service endpoint Live Share should use.
+            * Checks if the interactive capability is supported by the host
+            * @returns boolean to represent whether the interactive capability is supported
+            *
+            * @throws Error if {@linkcode app.initialize} has not successfully completed
             */
-        serviceEndpoint: string;
-}
-/**
-    * @hidden
-    * Returned from `LiveShareHost.getClientInfo()` to specify the client info for a
-    * particular client in a Live Share session.
-    *
-    * @beta
-    */
-export interface IClientInfo {
-        userId: string;
-        roles: UserMeetingRole[];
-        displayName?: string;
+        function isSupported(): boolean;
 }
 /**
-    * @hidden
-    * Live Share host implementation for O365 and Teams clients.
+    * Live Share host implementation for connecting to real-time collaborative sessions.
+    * Designed for use with the `LiveShareClient` class in the `@microsoft/live-share` package.
+    * Learn more at https://aka.ms/teamsliveshare
     *
-    * @beta
+    * @remarks
+    * The `LiveShareClient` class from Live Share uses the hidden API's to join/manage the session.
+    * To create a new `LiveShareHost` instance use the static `LiveShareHost.create()` function.
     */
 export class LiveShareHost {
         /**
             * @hidden
             * Returns the Fluid Tenant connection info for user's current context.
-            *
-            * @beta
             */
-        getFluidTenantInfo(): Promise<IFluidTenantInfo>;
+        getFluidTenantInfo(): Promise<liveShare.IFluidTenantInfo>;
         /**
             * @hidden
             * Returns the fluid access token for mapped container Id.
             *
             * @param containerId Fluid's container Id for the request. Undefined for new containers.
             * @returns token for connecting to Fluid's session.
-            *
-            * @beta
             */
         getFluidToken(containerId?: string): Promise<string>;
         /**
             * @hidden
             * Returns the ID of the fluid container associated with the user's current context.
-            *
-            * @beta
             */
-        getFluidContainerId(): Promise<IFluidContainerInfo>;
+        getFluidContainerId(): Promise<liveShare.IFluidContainerInfo>;
         /**
             * @hidden
             * Sets the ID of the fluid container associated with the current context.
@@ -8170,69 +8196,47 @@ export class LiveShareHost {
             * `getFluidContainerId()` to get the ID of the container being used.
             * @param containerId ID of the fluid container the client created.
             * @returns A data structure with a `containerState` indicating the success or failure of the request.
-            *
-            * @beta
             */
-        setFluidContainerId(containerId: string): Promise<IFluidContainerInfo>;
+        setFluidContainerId(containerId: string): Promise<liveShare.IFluidContainerInfo>;
         /**
             * @hidden
             * Returns the shared clock server's current time.
-            *
-            * @beta
             */
-        getNtpTime(): Promise<INtpTimeInfo>;
+        getNtpTime(): Promise<liveShare.INtpTimeInfo>;
         /**
             * @hidden
             * Associates the fluid client ID with a set of user roles.
             *
             * @param clientId The ID for the current user's Fluid client. Changes on reconnects.
             * @returns The roles for the current user.
-            *
-            * @beta
             */
-        registerClientId(clientId: string): Promise<UserMeetingRole[]>;
+        registerClientId(clientId: string): Promise<liveShare.UserMeetingRole[]>;
         /**
             * @hidden
             * Returns the roles associated with a client ID.
             *
             * @param clientId The Client ID the message was received from.
             * @returns The roles for a given client. Returns `undefined` if the client ID hasn't been registered yet.
-            *
-            * @beta
             */
-        getClientRoles(clientId: string): Promise<UserMeetingRole[] | undefined>;
+        getClientRoles(clientId: string): Promise<liveShare.UserMeetingRole[] | undefined>;
         /**
             * @hidden
             * Returns the `IClientInfo` associated with a client ID.
             *
             * @param clientId The Client ID the message was received from.
             * @returns The info for a given client. Returns `undefined` if the client ID hasn't been registered yet.
-            *
-            * @beta
             */
-        getClientInfo(clientId: string): Promise<IClientInfo | undefined>;
+        getClientInfo(clientId: string): Promise<liveShare.IClientInfo | undefined>;
         /**
-            * Returns a host instance for the client that can be passed to the `LiveShareClient` class.
+            * Factories a new `LiveShareHost` instance for use with the `LiveShareClient` class
+            * in the `@microsoft/live-share` package.
             *
             * @remarks
-            * The application must first be initialized and may only be called from `meetingStage` or `sidePanel` contexts.
-            *
-            * @beta
+            * `app.initialize()` must first be called before using this API.
+            * This API can only be called from `meetingStage` or `sidePanel` contexts.
             */
         static create(): LiveShareHost;
 }
-/**
-    * @hidden
-    *
-    * Checks if the interactive capability is supported by the host
-    * @returns boolean to represent whether the interactive capability is supported
-    *
-    * @throws Error if {@linkcode app.initialize} has not successfully completed
-    *
-    * @internal
-    * Limited to Microsoft-internal use
-    */
-export function isSupported(): boolean;
 
 /**
     * @hidden

package/dist/MicrosoftTeams.js

@@ -805,7 +805,6 @@ __webpack_require__.d(__webpack_exports__, {
   "ActionObjectType": () => (/* reexport */ ActionObjectType),
   "ChannelType": () => (/* reexport */ ChannelType),
   "ChildAppWindow": () => (/* reexport */ ChildAppWindow),
-  "ContainerState": () => (/* reexport */ ContainerState),
   "DialogDimension": () => (/* reexport */ DialogDimension),
   "ErrorCode": () => (/* reexport */ ErrorCode),
   "FileOpenPreference": () => (/* reexport */ FileOpenPreference),
@@ -818,7 +817,6 @@ __webpack_require__.d(__webpack_exports__, {
   "SecondaryM365ContentIdName": () => (/* reexport */ SecondaryM365ContentIdName),
   "TaskModuleDimension": () => (/* reexport */ TaskModuleDimension),
   "TeamType": () => (/* reexport */ TeamType),
-  "UserMeetingRole": () => (/* reexport */ UserMeetingRole),
   "UserSettingTypes": () => (/* reexport */ UserSettingTypes),
   "UserTeamRole": () => (/* reexport */ UserTeamRole),
   "ViewerActionTypes": () => (/* reexport */ ViewerActionTypes),
@@ -843,7 +841,7 @@ __webpack_require__.d(__webpack_exports__, {
   "getTabInstances": () => (/* reexport */ getTabInstances),
   "initialize": () => (/* reexport */ initialize),
   "initializeWithFrameContext": () => (/* reexport */ initializeWithFrameContext),
-  "isSupported": () => (/* reexport */ isSupported),
+  "liveShare": () => (/* reexport */ liveShare),
   "location": () => (/* reexport */ location_location),
   "logs": () => (/* reexport */ logs),
   "mail": () => (/* reexport */ mail),
@@ -2090,7 +2088,7 @@ var _minRuntimeConfigToUninitialize = {
  * @hidden
  *  Package version.
  */
-var version = "2.12.1-beta.0";
+var version = "2.13.0-beta.0";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -9367,51 +9365,88 @@ var tasks;
 
 
 /**
- * @hidden
- * Allowed roles during a meeting.
- *
- * @beta
- */
-var UserMeetingRole;
-(function (UserMeetingRole) {
-    UserMeetingRole["guest"] = "Guest";
-    UserMeetingRole["attendee"] = "Attendee";
-    UserMeetingRole["presenter"] = "Presenter";
-    UserMeetingRole["organizer"] = "Organizer";
-})(UserMeetingRole || (UserMeetingRole = {}));
-/**
- * @hidden
- * State of the current Live Share sessions backing fluid container.
+ * APIs involving Live Share, a framework for building real-time collaborative apps.
+ * For more information, visit https://aka.ms/teamsliveshare
  *
- * @beta
+ * @see LiveShareHost
  */
-var ContainerState;
-(function (ContainerState) {
+var liveShare;
+(function (liveShare) {
     /**
-     * The call to `LiveShareHost.setContainerId()` successfully created the container mapping
-     * for the current Live Share session.
-     */
-    ContainerState["added"] = "Added";
-    /**
-     * A container mapping for the current Live Share Session already exists and should be used
-     * when joining the sessions Fluid container.
+     * @hidden
+     * The meeting roles of a user.
+     * Used in Live Share for its role verification feature.
+     * For more information, visit https://learn.microsoft.com/microsoftteams/platform/apps-in-teams-meetings/teams-live-share-capabilities?tabs=javascript#role-verification-for-live-data-structures
      */
-    ContainerState["alreadyExists"] = "AlreadyExists";
+    var UserMeetingRole;
+    (function (UserMeetingRole) {
+        /**
+         * Guest role.
+         */
+        UserMeetingRole["guest"] = "Guest";
+        /**
+         * Attendee role.
+         */
+        UserMeetingRole["attendee"] = "Attendee";
+        /**
+         * Presenter role.
+         */
+        UserMeetingRole["presenter"] = "Presenter";
+        /**
+         * Organizer role.
+         */
+        UserMeetingRole["organizer"] = "Organizer";
+    })(UserMeetingRole = liveShare.UserMeetingRole || (liveShare.UserMeetingRole = {}));
     /**
-     * The call to `LiveShareHost.setContainerId()` failed to create the container mapping due to
-     * another client having already set the container ID for the current Live Share session.
+     * @hidden
+     * State of the current Live Share session's Fluid container.
+     * This is used internally by the `LiveShareClient` when joining a Live Share session.
      */
-    ContainerState["conflict"] = "Conflict";
+    var ContainerState;
+    (function (ContainerState) {
+        /**
+         * The call to `LiveShareHost.setContainerId()` successfully created the container mapping
+         * for the current Live Share session.
+         */
+        ContainerState["added"] = "Added";
+        /**
+         * A container mapping for the current Live Share session already exists.
+         * This indicates to Live Share that a new container does not need be created.
+         */
+        ContainerState["alreadyExists"] = "AlreadyExists";
+        /**
+         * The call to `LiveShareHost.setContainerId()` failed to create the container mapping.
+         * This happens when another client has already set the container ID for the session.
+         */
+        ContainerState["conflict"] = "Conflict";
+        /**
+         * A container mapping for the current Live Share session does not yet exist.
+         * This indicates to Live Share that a new container should be created.
+         */
+        ContainerState["notFound"] = "NotFound";
+    })(ContainerState = liveShare.ContainerState || (liveShare.ContainerState = {}));
     /**
-     * A container mapping for the current Live Share session doesn't exist yet.
+     * Checks if the interactive capability is supported by the host
+     * @returns boolean to represent whether the interactive capability is supported
+     *
+     * @throws Error if {@linkcode app.initialize} has not successfully completed
      */
-    ContainerState["notFound"] = "NotFound";
-})(ContainerState || (ContainerState = {}));
+    function isSupported() {
+        return ensureInitialized(runtime, FrameContexts.meetingStage, FrameContexts.sidePanel) &&
+            runtime.supports.interactive
+            ? true
+            : false;
+    }
+    liveShare.isSupported = isSupported;
+})(liveShare || (liveShare = {}));
 /**
- * @hidden
- * Live Share host implementation for O365 and Teams clients.
+ * Live Share host implementation for connecting to real-time collaborative sessions.
+ * Designed for use with the `LiveShareClient` class in the `@microsoft/live-share` package.
+ * Learn more at https://aka.ms/teamsliveshare
  *
- * @beta
+ * @remarks
+ * The `LiveShareClient` class from Live Share uses the hidden API's to join/manage the session.
+ * To create a new `LiveShareHost` instance use the static `LiveShareHost.create()` function.
  */
 var LiveShareHost = /** @class */ (function () {
     function LiveShareHost() {
@@ -9419,8 +9454,6 @@ var LiveShareHost = /** @class */ (function () {
     /**
      * @hidden
      * Returns the Fluid Tenant connection info for user's current context.
-     *
-     * @beta
      */
     LiveShareHost.prototype.getFluidTenantInfo = function () {
         ensureSupported();
@@ -9434,8 +9467,6 @@ var LiveShareHost = /** @class */ (function () {
      *
      * @param containerId Fluid's container Id for the request. Undefined for new containers.
      * @returns token for connecting to Fluid's session.
-     *
-     * @beta
      */
     LiveShareHost.prototype.getFluidToken = function (containerId) {
         ensureSupported();
@@ -9447,8 +9478,6 @@ var LiveShareHost = /** @class */ (function () {
     /**
      * @hidden
      * Returns the ID of the fluid container associated with the user's current context.
-     *
-     * @beta
      */
     LiveShareHost.prototype.getFluidContainerId = function () {
         ensureSupported();
@@ -9465,8 +9494,6 @@ var LiveShareHost = /** @class */ (function () {
      * `getFluidContainerId()` to get the ID of the container being used.
      * @param containerId ID of the fluid container the client created.
      * @returns A data structure with a `containerState` indicating the success or failure of the request.
-     *
-     * @beta
      */
     LiveShareHost.prototype.setFluidContainerId = function (containerId) {
         ensureSupported();
@@ -9477,8 +9504,6 @@ var LiveShareHost = /** @class */ (function () {
     /**
      * @hidden
      * Returns the shared clock server's current time.
-     *
-     * @beta
      */
     LiveShareHost.prototype.getNtpTime = function () {
         ensureSupported();
@@ -9492,8 +9517,6 @@ var LiveShareHost = /** @class */ (function () {
      *
      * @param clientId The ID for the current user's Fluid client. Changes on reconnects.
      * @returns The roles for the current user.
-     *
-     * @beta
      */
     LiveShareHost.prototype.registerClientId = function (clientId) {
         ensureSupported();
@@ -9507,8 +9530,6 @@ var LiveShareHost = /** @class */ (function () {
      *
      * @param clientId The Client ID the message was received from.
      * @returns The roles for a given client. Returns `undefined` if the client ID hasn't been registered yet.
-     *
-     * @beta
      */
     LiveShareHost.prototype.getClientRoles = function (clientId) {
         ensureSupported();
@@ -9522,8 +9543,6 @@ var LiveShareHost = /** @class */ (function () {
      *
      * @param clientId The Client ID the message was received from.
      * @returns The info for a given client. Returns `undefined` if the client ID hasn't been registered yet.
-     *
-     * @beta
      */
     LiveShareHost.prototype.getClientInfo = function (clientId) {
         ensureSupported();
@@ -9532,12 +9551,12 @@ var LiveShareHost = /** @class */ (function () {
         });
     };
     /**
-     * Returns a host instance for the client that can be passed to the `LiveShareClient` class.
+     * Factories a new `LiveShareHost` instance for use with the `LiveShareClient` class
+     * in the `@microsoft/live-share` package.
      *
      * @remarks
-     * The application must first be initialized and may only be called from `meetingStage` or `sidePanel` contexts.
-     *
-     * @beta
+     * `app.initialize()` must first be called before using this API.
+     * This API can only be called from `meetingStage` or `sidePanel` contexts.
      */
     LiveShareHost.create = function () {
         ensureSupported();
@@ -9546,24 +9565,8 @@ var LiveShareHost = /** @class */ (function () {
     return LiveShareHost;
 }());
 
-/**
- * @hidden
- *
- * Checks if the interactive capability is supported by the host
- * @returns boolean to represent whether the interactive capability is supported
- *
- * @throws Error if {@linkcode app.initialize} has not successfully completed
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-function isSupported() {
-    return ensureInitialized(runtime, FrameContexts.meetingStage, FrameContexts.sidePanel) && runtime.supports.interactive
-        ? true
-        : false;
-}
 function ensureSupported() {
-    if (!isSupported()) {
+    if (!liveShare.isSupported()) {
         throw new Error('LiveShareHost Not supported');
     }
 }