@microsoft/teams-js 2.28.1-beta.0 → 2.29.0-beta.1

package/dist/{MicrosoftTeams.js → umd/MicrosoftTeams.js}

@@ -1026,6 +1026,7 @@ __webpack_require__.d(__webpack_exports__, {
   executeDeepLink: () => (/* reexport */ executeDeepLink),
   externalAppAuthentication: () => (/* reexport */ externalAppAuthentication),
   externalAppCardActions: () => (/* reexport */ externalAppCardActions),
+  externalAppCardActionsForCEA: () => (/* reexport */ externalAppCardActionsForCEA),
   externalAppCommands: () => (/* reexport */ externalAppCommands),
   files: () => (/* reexport */ files),
   geoLocation: () => (/* reexport */ geoLocation),
@@ -1095,215 +1096,6 @@ __webpack_require__.d(__webpack_exports__, {
 
 // EXTERNAL MODULE: ../../node_modules/.pnpm/debug@4.3.5/node_modules/debug/src/browser.js
 var browser = __webpack_require__(815);
-;// CONCATENATED MODULE: ./src/internal/telemetry.ts
-
-const topLevelLogger = (0,browser.debug)('teamsJs');
-/**
- * @internal
- * Limited to Microsoft-internal use
- *
- * Returns a logger for a given namespace, within the pre-defined top-level teamsJs namespace
- */
-function getLogger(namespace) {
-    return topLevelLogger.extend(namespace);
-}
-/**
- * @hidden
- * Creates a string tag for labeling apiVersionTag, which is used for API function call to create message request
- * sent to host(s).
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-function getApiVersionTag(apiVersionNumber, functionName) {
-    return `${apiVersionNumber}_${functionName}`;
-}
-/**
- * @hidden
- * Check if apiVersionTag developer sends follows the pattern starting with a lowercase 'v', then
- * followed by one or more digits, then concatenated with underscore and some characters to indicate api name.
- * For example, 'v2_app.getContext'. If yes, return true. Otherwise, return false.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-function isFollowingApiVersionTagFormat(apiVersionTag) {
-    const pattern = /^v\d+_[\w.]+$/;
-    return pattern.test(apiVersionTag);
-}
-
-;// CONCATENATED MODULE: ./src/artifactsForCDN/validDomains.json
-const validDomains_namespaceObject = /*#__PURE__*/JSON.parse('{"validOrigins":["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.live.com","outlook-sdf.live.com","teams.live.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","devspaces.skype.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","www.bing.com","www.staging-bing-int.com","*.cloud.microsoft","*.m365.cloud.microsoft","edgeapi.svc.cloud.microsoft","copilot.microsoft.com","windows.msn.com","fa000000125.resources.office.net","fa000000129.resources.office.net","fa000000124.resources.office.net","fa000000128.resources.office.net","fa000000136.resources.office.net"]}');
-var artifactsForCDN_validDomains_namespaceObject = /*#__PURE__*/__webpack_require__.t(validDomains_namespaceObject, 2);
-;// CONCATENATED MODULE: ./src/internal/constants.ts
-
-/**
- * @hidden
- * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
- * Modified to 2.0.1 which is hightest till now so that if any client doesn't pass version in initialize function, it will be set to highest.
- * Mobile clients are passing versions, hence will be applicable to web and desktop clients only.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const defaultSDKVersionForCompatCheck = '2.0.1';
-/**
- * @hidden
- * This is the client version when selectMedia API - VideoAndImage is supported on mobile.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const videoAndImageMediaAPISupportVersion = '2.0.2';
-/**
- * @hidden
- * This is the client version when selectMedia API - Video with non-full screen mode is supported on mobile.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const nonFullScreenVideoModeAPISupportVersion = '2.0.3';
-/**
- * @hidden
- * This is the client version when selectMedia API - ImageOutputFormats is supported on mobile.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const imageOutputFormatsAPISupportVersion = '2.0.4';
-/**
- * @hidden
- * Minimum required client supported version for {@link getUserJoinedTeams} to be supported on {@link HostClientType.android}
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const getUserJoinedTeamsSupportedAndroidClientVersion = '2.0.1';
-/**
- * @hidden
- * This is the client version when location APIs (getLocation and showLocation) are supported.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const locationAPIsRequiredVersion = '1.9.0';
-/**
- * @hidden
- * This is the client version when permisisons are supported
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const permissionsAPIsRequiredVersion = '2.0.1';
-/**
- * @hidden
- * This is the client version when people picker API is supported on mobile.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const peoplePickerRequiredVersion = '2.0.0';
-/**
- * @hidden
- * This is the client version when captureImage API is supported on mobile.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const captureImageMobileSupportVersion = '1.7.0';
-/**
- * @hidden
- * This is the client version when media APIs are supported on all three platforms ios, android and web.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const mediaAPISupportVersion = '1.8.0';
-/**
- * @hidden
- * This is the client version when getMedia API is supported via Callbacks on all three platforms ios, android and web.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const getMediaCallbackSupportVersion = '2.0.0';
-/**
- * @hidden
- * This is the client version when scanBarCode API is supported on mobile.
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const scanBarCodeAPIMobileSupportVersion = '1.9.0';
-/**
- * @hidden
- * Fallback list of valid origins in JSON format
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const validOriginsLocal = artifactsForCDN_validDomains_namespaceObject;
-/**
- * @hidden
- * Fallback list of valid origins
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const validOriginsFallback = validOriginsLocal.validOrigins;
-/**
- * @hidden
- * CDN endpoint of the list of valid origins
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const validOriginsCdnEndpoint = new URL('https://res.cdn.office.net/teams-js/validDomains/json/validDomains.json');
-/**
- * @hidden
- * USer specified message origins should satisfy this test
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const userOriginUrlValidationRegExp = /^https:\/\//;
-/**
- * @hidden
- * The protocol used for deep links into Teams
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const teamsDeepLinkProtocol = 'https';
-/**
- * @hidden
- * The host used for deep links into Teams
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-const teamsDeepLinkHost = 'teams.microsoft.com';
-/** @hidden */
-const errorLibraryNotInitialized = 'The library has not yet been initialized';
-/** @hidden */
-const errorRuntimeNotInitialized = 'The runtime has not yet been initialized';
-/** @hidden */
-const errorRuntimeNotSupported = 'The runtime version is not supported';
-/** @hidden */
-const errorCallNotStarted = 'The call was not properly started';
-
-;// CONCATENATED MODULE: ./src/internal/globalVars.ts
-class GlobalVars {
-}
-GlobalVars.initializeCalled = false;
-GlobalVars.initializeCompleted = false;
-GlobalVars.additionalValidOrigins = [];
-GlobalVars.initializePromise = undefined;
-GlobalVars.isFramelessWindow = false;
-GlobalVars.frameContext = undefined;
-GlobalVars.hostClientType = undefined;
-GlobalVars.printCapabilityEnabled = false;
-
 // EXTERNAL MODULE: ../../node_modules/.pnpm/base64-js@1.5.1/node_modules/base64-js/index.js
 var base64_js = __webpack_require__(933);
 ;// CONCATENATED MODULE: ../../node_modules/.pnpm/skeleton-buffer@file+skeleton-buffer/node_modules/skeleton-buffer/index.js
@@ -2893,11 +2685,11 @@ function runWithTimeout(action, timeoutInMs, timeoutError) {
  */
 function createTeamsAppLink(params) {
     const url = new URL('https://teams.microsoft.com/l/entity/' +
-        encodeURIComponent(params.appId) +
+        encodeURIComponent(params.appId.toString()) +
         '/' +
         encodeURIComponent(params.pageId));
     if (params.webUrl) {
-        url.searchParams.append('webUrl', params.webUrl);
+        url.searchParams.append('webUrl', params.webUrl.toString());
     }
     if (params.chatId || params.channelId || params.subPageId) {
         url.searchParams.append('context', JSON.stringify({ chatId: params.chatId, channelId: params.channelId, subEntityId: params.subPageId }));
@@ -3060,43 +2852,15 @@ function fullyQualifyUrlString(fullOrRelativePath) {
     return new URL(link.href);
 }
 /**
- * The hasScriptTags function first decodes any HTML entities in the input string using the decodeHTMLEntities function.
- * It then tries to decode the result as a URI component. If the URI decoding fails (which would throw an error), it assumes that the input was not encoded and uses the original input.
- * Next, it defines a regular expression scriptRegex that matches any string that starts with <script (followed by any characters), then has any characters (including newlines),
- * and ends with </script> (preceded by any characters).
- * Finally, it uses the test method to check if the decoded input matches this regular expression. The function returns true if a match is found and false otherwise.
- * @param input URL converted to string to pattern match
+ * Detects if there are any script tags in a given string, even if they are Uri encoded or encoded as HTML entities.
+ * @param input string to test for script tags
  * @returns true if the input string contains a script tag, false otherwise
  */
 function hasScriptTags(input) {
-    let decodedInput;
-    try {
-        const decodedHTMLInput = decodeHTMLEntities(input);
-        decodedInput = decodeURIComponent(decodedHTMLInput);
-    }
-    catch (e) {
-        // input was not encoded, use it as is
-        decodedInput = input;
-    }
-    const scriptRegex = /<script[^>]*>[\s\S]*?<\/script[^>]*>/gi;
-    return scriptRegex.test(decodedInput);
-}
-/**
- * The decodeHTMLEntities function replaces HTML entities in the input string with their corresponding characters.
- */
-function decodeHTMLEntities(input) {
-    const entityMap = new Map([
-        ['&lt;', '<'],
-        ['&gt;', '>'],
-        ['&amp;', '&'],
-        ['&quot;', '"'],
-        ['&#39;', "'"],
-        ['&#x2F;', '/'],
-    ]);
-    entityMap.forEach((value, key) => {
-        input = input.replace(new RegExp(key, 'gi'), value);
-    });
-    return input;
+    const openingScriptTagRegex = /<script[^>]*>|&lt;script[^&]*&gt;|%3Cscript[^%]*%3E/gi;
+    const closingScriptTagRegex = /<\/script[^>]*>|&lt;\/script[^&]*&gt;|%3C\/script[^%]*%3E/gi;
+    const openingOrClosingScriptTagRegex = new RegExp(`${openingScriptTagRegex.source}|${closingScriptTagRegex.source}`, 'gi');
+    return openingOrClosingScriptTagRegex.test(input);
 }
 function isIdLengthValid(id) {
     return id.length < 256 && id.length > 4;
@@ -3126,46 +2890,282 @@ function validateUuid(id) {
     }
 }
 
-;// CONCATENATED MODULE: ./src/public/runtime.ts
-/* eslint-disable @typescript-eslint/ban-types */
-var __rest = (undefined && undefined.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-
-
-
-
+;// CONCATENATED MODULE: ./src/internal/uuidObject.ts
 
-const runtimeLogger = getLogger('runtime');
-const latestRuntimeApiVersion = 4;
-function isLatestRuntimeVersion(runtime) {
-    return runtime.apiVersion === latestRuntimeApiVersion;
-}
-// Constant used to set the runtime configuration
-const _uninitializedRuntime = {
-    apiVersion: -1,
-    supports: {},
-};
 /**
- * @hidden
- * Ensures that the runtime has been initialized
-
- * @returns True if the runtime has been initialized
- * @throws Error if the runtime has not been initialized
- *
  * @internal
  * Limited to Microsoft-internal use
+ *
+ * UUID object
  */
-function isRuntimeInitialized(runtime) {
-    if (isLatestRuntimeVersion(runtime)) {
+class UUID {
+    constructor(uuid = generateGUID()) {
+        this.uuid = uuid;
+        validateUuid(uuid);
+    }
+    toString() {
+        return this.uuid;
+    }
+}
+
+;// CONCATENATED MODULE: ./src/internal/telemetry.ts
+
+
+// Each teamsjs instance gets a unique identifier that will be prepended to every log statement
+const teamsJsInstanceIdentifier = new UUID();
+// Every log statement will get prepended with the teamsJsInstanceIdentifier and a timestamp
+const originalFormatArgsFunction = browser.debug.formatArgs;
+browser.debug.formatArgs = function (args) {
+    args[0] = `(${new Date().toISOString()}): ${args[0]} [${teamsJsInstanceIdentifier.toString()}]`;
+    originalFormatArgsFunction.call(this, args);
+};
+const topLevelLogger = (0,browser.debug)('teamsJs');
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * Returns a logger for a given namespace, within the pre-defined top-level teamsJs namespace
+ */
+function getLogger(namespace) {
+    return topLevelLogger.extend(namespace);
+}
+/**
+ * @hidden
+ * Creates a string tag for labeling apiVersionTag, which is used for API function call to create message request
+ * sent to host(s).
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function getApiVersionTag(apiVersionNumber, functionName) {
+    return `${apiVersionNumber}_${functionName}`;
+}
+/**
+ * @hidden
+ * Check if apiVersionTag developer sends follows the pattern starting with a lowercase 'v', then
+ * followed by one or more digits, then concatenated with underscore and some characters to indicate api name.
+ * For example, 'v2_app.getContext'. If yes, return true. Otherwise, return false.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function isFollowingApiVersionTagFormat(apiVersionTag) {
+    const pattern = /^v\d+_[\w.]+$/;
+    return pattern.test(apiVersionTag);
+}
+
+;// CONCATENATED MODULE: ./src/artifactsForCDN/validDomains.json
+const validDomains_namespaceObject = /*#__PURE__*/JSON.parse('{"validOrigins":["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.live.com","outlook-sdf.live.com","teams.live.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","devspaces.skype.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","www.bing.com","www.staging-bing-int.com","*.cloud.microsoft","*.m365.cloud.microsoft","edgeapi.svc.cloud.microsoft","copilot.microsoft.com","windows.msn.com","fa000000125.resources.office.net","fa000000129.resources.office.net","fa000000124.resources.office.net","fa000000128.resources.office.net","fa000000136.resources.office.net"]}');
+var artifactsForCDN_validDomains_namespaceObject = /*#__PURE__*/__webpack_require__.t(validDomains_namespaceObject, 2);
+;// CONCATENATED MODULE: ./src/internal/constants.ts
+
+/**
+ * @hidden
+ * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
+ * Modified to 2.0.1 which is hightest till now so that if any client doesn't pass version in initialize function, it will be set to highest.
+ * Mobile clients are passing versions, hence will be applicable to web and desktop clients only.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const defaultSDKVersionForCompatCheck = '2.0.1';
+/**
+ * @hidden
+ * This is the client version when selectMedia API - VideoAndImage is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const videoAndImageMediaAPISupportVersion = '2.0.2';
+/**
+ * @hidden
+ * This is the client version when selectMedia API - Video with non-full screen mode is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const nonFullScreenVideoModeAPISupportVersion = '2.0.3';
+/**
+ * @hidden
+ * This is the client version when selectMedia API - ImageOutputFormats is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const imageOutputFormatsAPISupportVersion = '2.0.4';
+/**
+ * @hidden
+ * Minimum required client supported version for {@link getUserJoinedTeams} to be supported on {@link HostClientType.android}
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const getUserJoinedTeamsSupportedAndroidClientVersion = '2.0.1';
+/**
+ * @hidden
+ * This is the client version when location APIs (getLocation and showLocation) are supported.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const locationAPIsRequiredVersion = '1.9.0';
+/**
+ * @hidden
+ * This is the client version when permisisons are supported
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const permissionsAPIsRequiredVersion = '2.0.1';
+/**
+ * @hidden
+ * This is the client version when people picker API is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const peoplePickerRequiredVersion = '2.0.0';
+/**
+ * @hidden
+ * This is the client version when captureImage API is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const captureImageMobileSupportVersion = '1.7.0';
+/**
+ * @hidden
+ * This is the client version when media APIs are supported on all three platforms ios, android and web.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const mediaAPISupportVersion = '1.8.0';
+/**
+ * @hidden
+ * This is the client version when getMedia API is supported via Callbacks on all three platforms ios, android and web.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const getMediaCallbackSupportVersion = '2.0.0';
+/**
+ * @hidden
+ * This is the client version when scanBarCode API is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const scanBarCodeAPIMobileSupportVersion = '1.9.0';
+/**
+ * @hidden
+ * Fallback list of valid origins in JSON format
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const validOriginsLocal = artifactsForCDN_validDomains_namespaceObject;
+/**
+ * @hidden
+ * Fallback list of valid origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const validOriginsFallback = validOriginsLocal.validOrigins;
+/**
+ * @hidden
+ * CDN endpoint of the list of valid origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const validOriginsCdnEndpoint = new URL('https://res.cdn.office.net/teams-js/validDomains/json/validDomains.json');
+/**
+ * @hidden
+ * USer specified message origins should satisfy this test
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const userOriginUrlValidationRegExp = /^https:\/\//;
+/**
+ * @hidden
+ * The protocol used for deep links into Teams
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const teamsDeepLinkProtocol = 'https';
+/**
+ * @hidden
+ * The host used for deep links into Teams
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+const teamsDeepLinkHost = 'teams.microsoft.com';
+/** @hidden */
+const errorLibraryNotInitialized = 'The library has not yet been initialized';
+/** @hidden */
+const errorRuntimeNotInitialized = 'The runtime has not yet been initialized';
+/** @hidden */
+const errorRuntimeNotSupported = 'The runtime version is not supported';
+/** @hidden */
+const errorCallNotStarted = 'The call was not properly started';
+
+;// CONCATENATED MODULE: ./src/internal/globalVars.ts
+class GlobalVars {
+}
+GlobalVars.initializeCalled = false;
+GlobalVars.initializeCompleted = false;
+GlobalVars.additionalValidOrigins = [];
+GlobalVars.initializePromise = undefined;
+GlobalVars.isFramelessWindow = false;
+GlobalVars.frameContext = undefined;
+GlobalVars.hostClientType = undefined;
+GlobalVars.printCapabilityEnabled = false;
+
+;// CONCATENATED MODULE: ./src/public/runtime.ts
+/* eslint-disable @typescript-eslint/ban-types */
+var __rest = (undefined && undefined.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+
+
+
+
+
+const runtimeLogger = getLogger('runtime');
+const latestRuntimeApiVersion = 4;
+function isLatestRuntimeVersion(runtime) {
+    return runtime.apiVersion === latestRuntimeApiVersion;
+}
+// Constant used to set the runtime configuration
+const _uninitializedRuntime = {
+    apiVersion: -1,
+    supports: {},
+};
+/**
+ * @hidden
+ * Ensures that the runtime has been initialized
+
+ * @returns True if the runtime has been initialized
+ * @throws Error if the runtime has not been initialized
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function isRuntimeInitialized(runtime) {
+    if (isLatestRuntimeVersion(runtime)) {
         return true;
     }
     else if (runtime.apiVersion === -1) {
@@ -3509,7 +3509,7 @@ const _minRuntimeConfigToUninitialize = {
  * @hidden
  *  Package version.
  */
-const version = "2.28.1-beta.0";
+const version = "2.29.0-beta.1";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -3776,6 +3776,74 @@ function validateOrigin(messageOrigin) {
     });
 }
 
+;// CONCATENATED MODULE: ./src/internal/appIdValidation.ts
+
+/**
+ * This function can be used to validate if a string is a "valid" app id.
+ * Valid is a relative term, in this case. Truly valid app ids are UUIDs as documented in the schema:
+ * https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema#id
+ * However, there are some older internal/hard-coded apps which violate this schema and use names like com.microsoft.teamspace.tab.youtube.
+ * For compatibility with these legacy apps, we unfortunately cannot securely and completely validate app ids as UUIDs. Based
+ * on this, the validation is limited to checking for script tags, length, and non-printable characters.
+ *
+ * @param potentialAppId A string to check if it's a "valid" app id
+ * @throws Error with a message describing the exact validation violation
+ */
+function validateStringAsAppId(potentialAppId) {
+    if (hasScriptTags(potentialAppId)) {
+        throw new Error(`Potential app id (${potentialAppId}) is invalid; it contains script tags.`);
+    }
+    if (!isStringWithinAppIdLengthLimits(potentialAppId)) {
+        throw new Error(`Potential app id (${potentialAppId}) is invalid; its length ${potentialAppId.length} is not within the length limits (${minimumValidAppIdLength}-${maximumValidAppIdLength}).`);
+    }
+    if (doesStringContainNonPrintableCharacters(potentialAppId)) {
+        throw new Error(`Potential app id (${potentialAppId}) is invalid; it contains non-printable characters.`);
+    }
+}
+const minimumValidAppIdLength = 4;
+const maximumValidAppIdLength = 256;
+function isStringWithinAppIdLengthLimits(potentialAppId) {
+    return potentialAppId.length < maximumValidAppIdLength && potentialAppId.length > minimumValidAppIdLength;
+}
+function doesStringContainNonPrintableCharacters(str) {
+    return [...str].some((char) => {
+        const charCode = char.charCodeAt(0);
+        return charCode < 32 || charCode > 126;
+    });
+}
+
+;// CONCATENATED MODULE: ./src/public/appId.ts
+
+/**
+ * A strongly-typed class used to represent a "valid" app id.
+ *
+ * Valid is a relative term, in this case. Truly valid app ids are UUIDs as documented in the schema:
+ * https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema#id
+ * However, there are some older internal/hard-coded apps which violate this schema and use names like
+ * com.microsoft.teamspace.tab.youtube. For compatibility with these legacy apps, we unfortunately cannot
+ * securely and completely validate app ids as UUIDs. Based on this, the validation is limited to checking
+ * for script tags, length, and non-printable characters. Validation will be updated in the future to ensure
+ * the app id is a valid UUID as legacy apps update.
+ */
+class AppId {
+    /**
+     * Creates a strongly-typed AppId from a string
+     *
+     * @param appIdAsString An app id represented as a string
+     * @throws Error with a message describing the exact validation violation
+     */
+    constructor(appIdAsString) {
+        this.appIdAsString = appIdAsString;
+        validateStringAsAppId(appIdAsString);
+    }
+    /**
+     * Returns the app id as a string
+     */
+    toString() {
+        return this.appIdAsString;
+    }
+}
+
 ;// CONCATENATED MODULE: ./src/private/messageChannels.ts
 var messageChannels_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -5227,7 +5295,8 @@ var app;
             appLogger('teamsjs is being used from %s. %s', currentScriptSrc, scriptUsageWarning);
         }
     }
-    // This is called right away to make sure that we capture which script is being executed correctly
+    // This is called right away to make sure that we capture which script is being executed and important stats about the current teamsjs instance
+    appLogger('teamsjs instance is version %s, starting at %s UTC (%s local)', version, new Date().toISOString(), new Date().toLocaleString());
     logWhereTeamsJsIsBeingUsed();
     /**
      * Initializes the library.
@@ -5537,6 +5606,7 @@ function transformLegacyContextToAppContext(legacyContext) {
 
 
 
+
 /**
  * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
@@ -5796,6 +5866,7 @@ var pages;
      *
      * @param params Parameters for the navigation
      * @returns a `Promise` that will resolve if the navigation was successful or reject if it was not
+     * @throws `Error` if the app ID is not valid or `params.webUrl` is defined but not a valid URL
      */
     function navigateToApp(params) {
         return new Promise((resolve) => {
@@ -5805,10 +5876,16 @@ var pages;
             }
             const apiVersionTag = getApiVersionTag(pagesTelemetryVersionNumber, "pages.navigateToApp" /* ApiName.Pages_NavigateToApp */);
             if (runtime.isLegacyTeams) {
-                resolve(sendAndHandleStatusAndReason(apiVersionTag, 'executeDeepLink', createTeamsAppLink(params)));
+                const typeSafeParameters = !isAppNavigationParametersObject(params)
+                    ? convertNavigateToAppParamsToAppNavigationParameters(params)
+                    : params;
+                resolve(sendAndHandleStatusAndReason(apiVersionTag, 'executeDeepLink', createTeamsAppLink(typeSafeParameters)));
             }
             else {
-                resolve(sendAndHandleStatusAndReason(apiVersionTag, 'pages.navigateToApp', params));
+                const serializedParameters = isAppNavigationParametersObject(params)
+                    ? convertAppNavigationParametersToNavigateToAppParams(params)
+                    : params;
+                resolve(sendAndHandleStatusAndReason(apiVersionTag, 'pages.navigateToApp', serializedParameters));
             }
         });
     }
@@ -6371,6 +6448,15 @@ var pages;
         currentApp.isSupported = isSupported;
     })(currentApp = pages.currentApp || (pages.currentApp = {}));
 })(pages || (pages = {}));
+function isAppNavigationParametersObject(obj) {
+    return obj.appId instanceof AppId;
+}
+function convertNavigateToAppParamsToAppNavigationParameters(params) {
+    return Object.assign(Object.assign({}, params), { appId: new AppId(params.appId), webUrl: params.webUrl ? new URL(params.webUrl) : undefined });
+}
+function convertAppNavigationParametersToNavigateToAppParams(params) {
+    return Object.assign(Object.assign({}, params), { appId: params.appId.toString(), webUrl: params.webUrl ? params.webUrl.toString() : undefined });
+}
 
 ;// CONCATENATED MODULE: ./src/internal/handlers.ts
 /* eslint-disable @typescript-eslint/ban-types */
@@ -6635,24 +6721,6 @@ function handlers_registerOnResumeHandler(handler) {
         ]);
 }
 
-;// CONCATENATED MODULE: ./src/internal/uuidObject.ts
-
-/**
- * @internal
- * Limited to Microsoft-internal use
- *
- * UUID object
- */
-class UUID {
-    constructor(uuid = generateGUID()) {
-        this.uuid = uuid;
-        validateUuid(uuid);
-    }
-    toString() {
-        return this.uuid;
-    }
-}
-
 ;// CONCATENATED MODULE: ./src/internal/messageObjects.ts
 var messageObjects_rest = (undefined && undefined.__rest) || function (s, e) {
     var t = {};
@@ -6842,7 +6910,7 @@ CommunicationPrivate.legacyMessageIdsToUuidMap = {};
  */
 function initializeCommunication(validMessageOrigins, apiVersionTag) {
     // Listen for messages post to our window
-    CommunicationPrivate.messageListener = (evt) => communication_awaiter(this, void 0, void 0, function* () { return yield processMessage(evt); });
+    CommunicationPrivate.messageListener = (evt) => processIncomingMessage(evt);
     // If we are in an iframe, our parent window is the one hosting us (i.e., window.parent); otherwise,
     // it's the window that opened us (i.e., window.opener)
     Communication.currentWindow = Communication.currentWindow || ssrSafeWindow();
@@ -6860,7 +6928,7 @@ function initializeCommunication(validMessageOrigins, apiVersionTag) {
         const extendedWindow = Communication.currentWindow;
         if (extendedWindow.nativeInterface) {
             GlobalVars.isFramelessWindow = true;
-            extendedWindow.onNativeMessage = handleParentMessage;
+            extendedWindow.onNativeMessage = handleIncomingMessageFromParent;
         }
         else {
             // at this point we weren't able to find a parent to talk to, no way initialization will succeed
@@ -7055,7 +7123,9 @@ function sendNestedAuthRequestToTopWindow(message) {
     const logger = sendNestedAuthRequestToTopWindowLogger;
     const targetWindow = Communication.topWindow;
     const request = createNestedAppAuthRequest(message);
-    logger('Message %i information: %o', request.uuid, { actionName: request.func });
+    logger('Message %s information: %o', getMessageIdsAsLogString(request), {
+        actionName: request.func,
+    });
     return sendRequestToTargetWindowHelper(targetWindow, request);
 }
 const sendRequestToTargetWindowHelperLogger = communicationLogger.extend('sendRequestToTargetWindowHelper');
@@ -7069,7 +7139,7 @@ function sendRequestToTargetWindowHelper(targetWindow, messageRequest) {
     const request = serializeMessageRequest(messageRequest);
     if (GlobalVars.isFramelessWindow) {
         if (Communication.currentWindow && Communication.currentWindow.nativeInterface) {
-            logger(`Sending message %i to ${targetWindowName} via framelessPostMessage interface`, request.uuidAsString);
+            logger('Sending message %s to %s via framelessPostMessage interface', getMessageIdsAsLogString(request), targetWindowName);
             Communication.currentWindow.nativeInterface.framelessPostMessage(JSON.stringify(request));
         }
     }
@@ -7078,11 +7148,11 @@ function sendRequestToTargetWindowHelper(targetWindow, messageRequest) {
         // If the target window isn't closed and we already know its origin, send the message right away; otherwise,
         // queue the message and send it after the origin is established
         if (targetWindow && targetOrigin) {
-            logger(`Sending message %i to ${targetWindowName} via postMessage`, request.uuidAsString);
+            logger('Sending message %s to %s via postMessage', getMessageIdsAsLogString(request), targetWindowName);
             targetWindow.postMessage(request, targetOrigin);
         }
         else {
-            logger(`Adding message %i to ${targetWindowName} message queue`, request.uuidAsString);
+            logger('Adding message %s to %s message queue', getMessageIdsAsLogString(request), targetWindowName);
             getTargetMessageQueue(targetWindow).push(messageRequest);
         }
     }
@@ -7097,19 +7167,19 @@ function sendMessageToParentHelper(apiVersionTag, actionName, args) {
     const logger = sendMessageToParentHelperLogger;
     const targetWindow = Communication.parentWindow;
     const request = createMessageRequest(apiVersionTag, actionName, args);
-    logger('Message %i information: %o', request.uuid, { actionName, args });
+    logger('Message %s information: %o', getMessageIdsAsLogString(request), { actionName, args });
     return sendRequestToTargetWindowHelper(targetWindow, request);
 }
-const processMessageLogger = communicationLogger.extend('processMessage');
+const processIncomingMessageLogger = communicationLogger.extend('processIncomingMessage');
 /**
  * @internal
  * Limited to Microsoft-internal use
  */
-function processMessage(evt) {
+function processIncomingMessage(evt) {
     return communication_awaiter(this, void 0, void 0, function* () {
         // Process only if we received a valid message
         if (!evt || !evt.data || typeof evt.data !== 'object') {
-            processMessageLogger('Unrecognized message format received by app, message being ignored. Message: %o', evt);
+            processIncomingMessageLogger('Unrecognized message format received by app, message being ignored. Message: %o', evt);
             return;
         }
         // Process only if the message is coming from a different window and a valid origin
@@ -7117,19 +7187,19 @@ function processMessage(evt) {
         // in their call to app.initialize
         const messageSource = evt.source || (evt.originalEvent && evt.originalEvent.source);
         const messageOrigin = evt.origin || (evt.originalEvent && evt.originalEvent.origin);
-        return shouldProcessMessage(messageSource, messageOrigin).then((result) => {
+        return shouldProcessIncomingMessage(messageSource, messageOrigin).then((result) => {
             if (!result) {
-                processMessageLogger('Message being ignored by app because it is either coming from the current window or a different window with an invalid origin');
+                processIncomingMessageLogger('Message being ignored by app because it is either coming from the current window or a different window with an invalid origin, message: %o, source: %o, origin: %o', evt, messageSource, messageOrigin);
                 return;
             }
             // Update our parent and child relationships based on this message
             updateRelationships(messageSource, messageOrigin);
             // Handle the message
             if (messageSource === Communication.parentWindow) {
-                handleParentMessage(evt);
+                handleIncomingMessageFromParent(evt);
             }
             else if (messageSource === Communication.childWindow) {
-                handleChildMessage(evt);
+                handleIncomingMessageFromChild(evt);
             }
         });
     });
@@ -7173,7 +7243,7 @@ function processAuthBridgeMessage(evt, onMessageReceived) {
         logger('Message being ignored by app because it is coming for a target that is null');
         return;
     }
-    if (!shouldProcessMessage(messageSource, messageOrigin)) {
+    if (!shouldProcessIncomingMessage(messageSource, messageOrigin)) {
         logger('Message being ignored by app because it is either coming from the current window or a different window with an invalid origin');
         return;
     }
@@ -7197,7 +7267,7 @@ function processAuthBridgeMessage(evt, onMessageReceived) {
     // Return the response to the registered callback
     onMessageReceived(message);
 }
-const shouldProcessMessageLogger = communicationLogger.extend('shouldProcessMessage');
+const shouldProcessIncomingMessageLogger = communicationLogger.extend('shouldProcessIncomingMessage');
 /**
  * @hidden
  * Validates the message source and origin, if it should be processed
@@ -7205,12 +7275,12 @@ const shouldProcessMessageLogger = communicationLogger.extend('shouldProcessMess
  * @internal
  * Limited to Microsoft-internal use
  */
-function shouldProcessMessage(messageSource, messageOrigin) {
+function shouldProcessIncomingMessage(messageSource, messageOrigin) {
     return communication_awaiter(this, void 0, void 0, function* () {
         // Process if message source is a different window and if origin is either in
         // Teams' pre-known whitelist or supplied as valid origin by user during initialization
         if (Communication.currentWindow && messageSource === Communication.currentWindow) {
-            shouldProcessMessageLogger('Should not process message because it is coming from the current window');
+            shouldProcessIncomingMessageLogger('Should not process message because it is coming from the current window');
             return false;
         }
         else if (Communication.currentWindow &&
@@ -7225,12 +7295,12 @@ function shouldProcessMessage(messageSource, messageOrigin) {
                 messageOriginURL = new URL(messageOrigin);
             }
             catch (_) {
-                shouldProcessMessageLogger('Message has an invalid origin of %s', messageOrigin);
+                shouldProcessIncomingMessageLogger('Message has an invalid origin of %s', messageOrigin);
                 return false;
             }
             const isOriginValid = yield validateOrigin(messageOriginURL);
             if (!isOriginValid) {
-                shouldProcessMessageLogger('Message has an invalid origin of %s', messageOrigin);
+                shouldProcessIncomingMessageLogger('Message has an invalid origin of %s', messageOrigin);
             }
             return isOriginValid;
         }
@@ -7268,14 +7338,13 @@ function updateRelationships(messageSource, messageOrigin) {
     flushMessageQueue(Communication.parentWindow);
     flushMessageQueue(Communication.childWindow);
 }
-const handleParentMessageLogger = communicationLogger.extend('handleParentMessage');
+const handleIncomingMessageFromParentLogger = communicationLogger.extend('handleIncomingMessageFromParent');
 /**
  * @internal
  * Limited to Microsoft-internal use
  */
 function retrieveMessageUUIDFromResponse(response) {
-    var _a;
-    const logger = handleParentMessageLogger;
+    const logger = handleIncomingMessageFromParentLogger;
     if (response.uuid) {
         const responseUUID = response.uuid;
         const callbackUUID = retrieveMessageUUIDFromCallback(CommunicationPrivate.callbacks, responseUUID);
@@ -7294,7 +7363,7 @@ function retrieveMessageUUIDFromResponse(response) {
     else {
         return CommunicationPrivate.legacyMessageIdsToUuidMap[response.id];
     }
-    logger(`Received a message with uuid: ${(_a = response.uuid) === null || _a === void 0 ? void 0 : _a.toString()} and legacyId: %i that failed to produce a callbackId`, response.id);
+    logger('Received message %s that failed to produce a callbackId', getMessageIdsAsLogString(response));
     return undefined;
 }
 /**
@@ -7303,7 +7372,7 @@ function retrieveMessageUUIDFromResponse(response) {
  *
  * This function is used to compare a new MessageUUID object value to the key values in the specified callback and retrieving that key
  * We use this because two objects with the same value are not considered equivalent therefore we can't use the new MessageUUID object
- * as a key to retrieve the value assosciated with it and should use this function instead.
+ * as a key to retrieve the value associated with it and should use this function instead.
  */
 function retrieveMessageUUIDFromCallback(map, responseUUID) {
     if (responseUUID) {
@@ -7337,8 +7406,8 @@ function removeMessageHandlers(message, map) {
  * @internal
  * Limited to Microsoft-internal use
  */
-function handleParentMessage(evt) {
-    const logger = handleParentMessageLogger;
+function handleIncomingMessageFromParent(evt) {
+    const logger = handleIncomingMessageFromParentLogger;
     if ('id' in evt.data && typeof evt.data.id === 'number') {
         // Call any associated Communication.callbacks
         const serializedResponse = evt.data;
@@ -7346,34 +7415,34 @@ function handleParentMessage(evt) {
         const callbackId = retrieveMessageUUIDFromResponse(message);
         if (callbackId) {
             const callback = CommunicationPrivate.callbacks.get(callbackId);
-            logger('Received a response from parent for message %i', callbackId);
+            logger('Received a response from parent for message %s', callbackId.toString());
             if (callback) {
-                logger('Invoking the registered callback for message %i with arguments %o', callbackId, message.args);
+                logger('Invoking the registered callback for message %s with arguments %o', callbackId.toString(), message.args);
                 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
                 // @ts-ignore
                 callback.apply(null, [...message.args, message.isPartialResponse]);
                 // Remove the callback to ensure that the callback is called only once and to free up memory if response is a complete response
                 if (!isPartialResponse(evt)) {
-                    logger('Removing registered callback for message %i', callbackId);
+                    logger('Removing registered callback for message %s', callbackId.toString());
                     removeMessageHandlers(message, CommunicationPrivate.callbacks);
                 }
             }
             const promiseCallback = CommunicationPrivate.promiseCallbacks.get(callbackId);
             if (promiseCallback) {
-                logger('Invoking the registered promise callback for message %i with arguments %o', callbackId, message.args);
+                logger('Invoking the registered promise callback for message %s with arguments %o', callbackId.toString(), message.args);
                 promiseCallback(message.args);
-                logger('Removing registered promise callback for message %i', callbackId);
+                logger('Removing registered promise callback for message %s', callbackId.toString());
                 removeMessageHandlers(message, CommunicationPrivate.promiseCallbacks);
             }
             const portCallback = CommunicationPrivate.portCallbacks.get(callbackId);
             if (portCallback) {
-                logger('Invoking the registered port callback for message %i with arguments %o', callbackId, message.args);
+                logger('Invoking the registered port callback for message %s with arguments %o', callbackId.toString(), message.args);
                 let port;
                 if (evt.ports && evt.ports[0] instanceof MessagePort) {
                     port = evt.ports[0];
                 }
                 portCallback(port, message.args);
-                logger('Removing registered port callback for message %i', callbackId);
+                logger('Removing registered port callback for message %s', callbackId.toString());
                 removeMessageHandlers(message, CommunicationPrivate.portCallbacks);
             }
             if (message.uuid) {
@@ -7384,7 +7453,7 @@ function handleParentMessage(evt) {
     else if ('func' in evt.data && typeof evt.data.func === 'string') {
         // Delegate the request to the proper handler
         const message = evt.data;
-        logger('Received an action message %s from parent', message.func);
+        logger('Received a message from parent %s, action: "%s"', getMessageIdsAsLogString(message), message.func);
         callHandler(message.func, message.args);
     }
     else {
@@ -7398,25 +7467,29 @@ function handleParentMessage(evt) {
 function isPartialResponse(evt) {
     return evt.data.isPartialResponse === true;
 }
+const handleIncomingMessageFromChildLogger = communicationLogger.extend('handleIncomingMessageFromChild');
 /**
  * @internal
  * Limited to Microsoft-internal use
  */
-function handleChildMessage(evt) {
+function handleIncomingMessageFromChild(evt) {
     if ('id' in evt.data && 'func' in evt.data) {
         // Try to delegate the request to the proper handler, if defined
         const message = deserializeMessageRequest(evt.data);
         const [called, result] = callHandler(message.func, message.args);
         if (called && typeof result !== 'undefined') {
+            handleIncomingMessageFromChildLogger('Returning message %s from child back to child, action: %s.', getMessageIdsAsLogString(message), message.func);
             // eslint-disable-next-line @typescript-eslint/ban-ts-comment
             // @ts-ignore
             sendMessageResponseToChild(message.id, message.uuid, Array.isArray(result) ? result : [result]);
         }
         else {
             // No handler, proxy to parent
+            handleIncomingMessageFromChildLogger('Relaying message %s from child to parent, action: %s. Relayed message will have a new id.', getMessageIdsAsLogString(message), message.func);
             sendMessageToParent(getApiVersionTag("v2" /* ApiVersionNumber.V_2 */, "tasks.startTask" /* ApiName.Tasks_StartTask */), message.func, message.args, (...args) => {
                 if (Communication.childWindow) {
                     const isPartialResponse = args.pop();
+                    handleIncomingMessageFromChildLogger('Message from parent being relayed to child, id: %s', getMessageIdsAsLogString(message));
                     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
                     // @ts-ignore
                     sendMessageResponseToChild(message.id, message.uuid, args, isPartialResponse);
@@ -7504,7 +7577,7 @@ function flushMessageQueue(targetWindow) {
         if (messageRequest) {
             const request = serializeMessageRequest(messageRequest);
             /* eslint-disable-next-line strict-null-checks/all */ /* Fix tracked by 5730662 */
-            flushMessageQueueLogger('Flushing message %i from ' + target + ' message queue via postMessage.', request === null || request === void 0 ? void 0 : request.uuidAsString);
+            flushMessageQueueLogger('Flushing message %s from %s message queue via postMessage.', getMessageIdsAsLogString(request), target);
             targetWindow.postMessage(request, targetOrigin);
         }
     }
@@ -7631,6 +7704,17 @@ function createMessageEvent(func, args) {
         args: args || [],
     };
 }
+function getMessageIdsAsLogString(message) {
+    if ('uuidAsString' in message) {
+        return `${message.uuidAsString} (legacy id: ${message.id})`;
+    }
+    else if ('uuid' in message && message.uuid !== undefined) {
+        return `${message.uuid.toString()} (legacy id: ${message.id})`;
+    }
+    else {
+        return `legacy id: ${message.id} (no uuid)`;
+    }
+}
 
 ;// CONCATENATED MODULE: ./src/private/logs.ts
 
@@ -7745,6 +7829,36 @@ var UserSettingTypes;
      */
     UserSettingTypes["theme"] = "theme";
 })(UserSettingTypes || (UserSettingTypes = {}));
+/**
+ * @beta
+ * @hidden
+ * The types for ActionOpenUrl
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+var ActionOpenUrlType;
+(function (ActionOpenUrlType) {
+    ActionOpenUrlType["DeepLinkDialog"] = "DeepLinkDialog";
+    ActionOpenUrlType["DeepLinkOther"] = "DeepLinkOther";
+    ActionOpenUrlType["DeepLinkStageView"] = "DeepLinkStageView";
+    ActionOpenUrlType["GenericUrl"] = "GenericUrl";
+})(ActionOpenUrlType || (ActionOpenUrlType = {}));
+/**
+ * @beta
+ * @hidden
+ * Error codes that can be thrown from IExternalAppCardActionService.handleActionOpenUrl
+ * and IExternalAppCardActionForCEAService.handleActionOpenUrl
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+var ActionOpenUrlErrorCode;
+(function (ActionOpenUrlErrorCode) {
+    ActionOpenUrlErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ActionOpenUrlErrorCode["INVALID_LINK"] = "INVALID_LINK";
+    ActionOpenUrlErrorCode["NOT_SUPPORTED"] = "NOT_SUPPORTED";
+})(ActionOpenUrlErrorCode || (ActionOpenUrlErrorCode = {}));
 
 ;// CONCATENATED MODULE: ./src/private/privateAPIs.ts
 /* eslint-disable @typescript-eslint/no-explicit-any */
@@ -8061,6 +8175,7 @@ var copilot;
 
 
 
+
 /**
  * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
@@ -8162,11 +8277,11 @@ var externalAppAuthentication;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        validateId(appId, new Error('App id is not valid.'));
+        const typeSafeAppId = new AppId(appId);
         validateOriginalRequestInfo(originalRequestInfo);
         // Ask the parent window to open an authentication window with the parameters provided by the caller.
         return sendMessageToParentAsync(getApiVersionTag(externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthentication.authenticateAndResendRequest" /* ApiName.ExternalAppAuthentication_AuthenticateAndResendRequest */), 'externalAppAuthentication.authenticateAndResendRequest', [
-            appId,
+            typeSafeAppId.toString(),
             originalRequestInfo,
             authenticateParameters.url.href,
             authenticateParameters.width,
@@ -8198,8 +8313,8 @@ var externalAppAuthentication;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        validateId(appId, new Error('App id is not valid.'));
-        return sendMessageToParentAsync(getApiVersionTag(externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthentication.authenticateWithSSO" /* ApiName.ExternalAppAuthentication_AuthenticateWithSSO */), 'externalAppAuthentication.authenticateWithSSO', [appId, authTokenRequest.claims, authTokenRequest.silent]).then(([wasSuccessful, error]) => {
+        const typeSafeAppId = new AppId(appId);
+        return sendMessageToParentAsync(getApiVersionTag(externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthentication.authenticateWithSSO" /* ApiName.ExternalAppAuthentication_AuthenticateWithSSO */), 'externalAppAuthentication.authenticateWithSSO', [typeSafeAppId.toString(), authTokenRequest.claims, authTokenRequest.silent]).then(([wasSuccessful, error]) => {
             if (!wasSuccessful) {
                 throw error;
             }
@@ -8222,9 +8337,9 @@ var externalAppAuthentication;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        validateId(appId, new Error('App id is not valid.'));
+        const typeSafeAppId = new AppId(appId);
         validateOriginalRequestInfo(originalRequestInfo);
-        return sendMessageToParentAsync(getApiVersionTag(externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthentication.authenticateWithSSOAndResendRequest" /* ApiName.ExternalAppAuthentication_AuthenticateWithSSOAndResendRequest */), 'externalAppAuthentication.authenticateWithSSOAndResendRequest', [appId, originalRequestInfo, authTokenRequest.claims, authTokenRequest.silent]).then(([wasSuccessful, response]) => {
+        return sendMessageToParentAsync(getApiVersionTag(externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthentication.authenticateWithSSOAndResendRequest" /* ApiName.ExternalAppAuthentication_AuthenticateWithSSOAndResendRequest */), 'externalAppAuthentication.authenticateWithSSOAndResendRequest', [typeSafeAppId.toString(), originalRequestInfo, authTokenRequest.claims, authTokenRequest.silent]).then(([wasSuccessful, response]) => {
             if (wasSuccessful && response.responseType != null) {
                 return response;
             }
@@ -8347,18 +8462,6 @@ var externalAppCardActions;
         ActionOpenUrlType["DeepLinkStageView"] = "DeepLinkStageView";
         ActionOpenUrlType["GenericUrl"] = "GenericUrl";
     })(ActionOpenUrlType = externalAppCardActions.ActionOpenUrlType || (externalAppCardActions.ActionOpenUrlType = {}));
-    /**
-     * @hidden
-     * Error codes that can be thrown from IExternalAppCardActionService.handleActionOpenUrl
-     * @internal
-     * Limited to Microsoft-internal use
-     */
-    let ActionOpenUrlErrorCode;
-    (function (ActionOpenUrlErrorCode) {
-        ActionOpenUrlErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
-        ActionOpenUrlErrorCode["INVALID_LINK"] = "INVALID_LINK";
-        ActionOpenUrlErrorCode["NOT_SUPPORTED"] = "NOT_SUPPORTED";
-    })(ActionOpenUrlErrorCode = externalAppCardActions.ActionOpenUrlErrorCode || (externalAppCardActions.ActionOpenUrlErrorCode = {}));
     /**
      * @beta
      * @hidden
@@ -8375,8 +8478,8 @@ var externalAppCardActions;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        validateId(appId, new Error('App id is not valid.'));
-        return sendMessageToParentAsync(getApiVersionTag(externalAppCardActionsTelemetryVersionNumber, "externalAppCardActions.processActionSubmit" /* ApiName.ExternalAppCardActions_ProcessActionSubmit */), 'externalAppCardActions.processActionSubmit', [appId, actionSubmitPayload]).then(([wasSuccessful, error]) => {
+        const typeSafeAppId = new AppId(appId);
+        return sendMessageToParentAsync(getApiVersionTag(externalAppCardActionsTelemetryVersionNumber, "externalAppCardActions.processActionSubmit" /* ApiName.ExternalAppCardActions_ProcessActionSubmit */), 'externalAppCardActions.processActionSubmit', [typeSafeAppId.toString(), actionSubmitPayload]).then(([wasSuccessful, error]) => {
             if (!wasSuccessful) {
                 throw error;
             }
@@ -8401,8 +8504,8 @@ var externalAppCardActions;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        validateId(appId, new Error('App id is not valid.'));
-        return sendMessageToParentAsync(getApiVersionTag(externalAppCardActionsTelemetryVersionNumber, "externalAppCardActions.processActionOpenUrl" /* ApiName.ExternalAppCardActions_ProcessActionOpenUrl */), 'externalAppCardActions.processActionOpenUrl', [appId, url.href, fromElement]).then(([error, response]) => {
+        const typeSafeAppId = new AppId(appId);
+        return sendMessageToParentAsync(getApiVersionTag(externalAppCardActionsTelemetryVersionNumber, "externalAppCardActions.processActionOpenUrl" /* ApiName.ExternalAppCardActions_ProcessActionOpenUrl */), 'externalAppCardActions.processActionOpenUrl', [typeSafeAppId.toString(), url.href, fromElement]).then(([error, response]) => {
             if (error) {
                 throw error;
             }
@@ -8411,10 +8514,111 @@ var externalAppCardActions;
             }
         });
     }
-    externalAppCardActions.processActionOpenUrl = processActionOpenUrl;
+    externalAppCardActions.processActionOpenUrl = processActionOpenUrl;
+    /**
+     * @hidden
+     * Checks if the externalAppCardActions capability is supported by the host
+     * @returns boolean to represent whether externalAppCardActions capability is supported
+     *
+     * @throws Error if {@linkcode app.initialize} has not successfully completed
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    function isSupported() {
+        return ensureInitialized(runtime) && runtime.supports.externalAppCardActions ? true : false;
+    }
+    externalAppCardActions.isSupported = isSupported;
+})(externalAppCardActions || (externalAppCardActions = {}));
+
+;// CONCATENATED MODULE: ./src/private/externalAppCardActionsForCEA.ts
+var externalAppCardActionsForCEA_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+
+
+
+
+
+
+/**
+ * All of APIs in this capability file should send out API version v2 ONLY
+ */
+const externalAppCardActionsForCEA_externalAppCardActionsTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
+/**
+ * @beta
+ * @hidden
+ * Namespace to delegate adaptive card action for Custom Engine Agent execution to the host
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+var externalAppCardActionsForCEA;
+(function (externalAppCardActionsForCEA) {
+    /**
+     * @beta
+     * @hidden
+     * Delegates an Adaptive Card Action.OpenUrl request to the host for the application with the provided app ID.
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param appId ID of the application the request is intended for. This must be a UUID
+     * @param conversationId To tell the bot what conversation the calls are coming from
+     * @param url The URL to open
+     * @throws Error if the response has not successfully completed
+     * @returns Promise that resolves to ActionOpenUrlType indicating the type of URL that was opened on success and rejects with ActionOpenUrlError if the request fails
+     */
+    function processActionOpenUrl(appId, conversationId, url) {
+        return externalAppCardActionsForCEA_awaiter(this, void 0, void 0, function* () {
+            ensureInitialized(runtime, FrameContexts.content);
+            if (!isSupported()) {
+                throw errorNotSupportedOnPlatform;
+            }
+            validateId(conversationId, new Error('conversation id is not valid.'));
+            const [error, response] = yield sendMessageToParentAsync(getApiVersionTag(externalAppCardActionsForCEA_externalAppCardActionsTelemetryVersionNumber, "externalAppCardActionsForCEA.processActionOpenUrl" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionOpenUrl */), "externalAppCardActionsForCEA.processActionOpenUrl" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionOpenUrl */, [appId, url.href, conversationId]);
+            if (error) {
+                throw error;
+            }
+            else {
+                return response;
+            }
+        });
+    }
+    externalAppCardActionsForCEA.processActionOpenUrl = processActionOpenUrl;
+    /**
+     * @beta
+     * @hidden
+     * Delegates an Adaptive Card Action.Submit request to the host for the application with the provided app ID
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param appId ID of the application the request is intended for. This must be a UUID
+     * @param conversationId To tell the bot what conversation the calls are coming from
+     * @param actionSubmitPayload The Adaptive Card Action.Submit payload
+     * @throws Error if host notifies of an error
+     * @returns Promise that resolves when the request is completed and rejects with ActionSubmitError if the request fails
+     */
+    function processActionSubmit(appId, conversationId, actionSubmitPayload) {
+        return externalAppCardActionsForCEA_awaiter(this, void 0, void 0, function* () {
+            ensureInitialized(runtime, FrameContexts.content);
+            if (!isSupported()) {
+                throw errorNotSupportedOnPlatform;
+            }
+            validateId(conversationId, new Error('conversation id is not valid.'));
+            const error = yield sendAndUnwrap(getApiVersionTag(externalAppCardActionsForCEA_externalAppCardActionsTelemetryVersionNumber, "externalAppCardActionsForCEA.processActionSubmit" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionSubmit */), "externalAppCardActionsForCEA.processActionSubmit" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionSubmit */, [appId, conversationId, actionSubmitPayload]);
+            if (error) {
+                throw error;
+            }
+        });
+    }
+    externalAppCardActionsForCEA.processActionSubmit = processActionSubmit;
     /**
+     * @beta
      * @hidden
-     * Checks if the externalAppCardActions capability is supported by the host
+     * Checks if the externalAppCardActionsForCEA capability is supported by the host
      * @returns boolean to represent whether externalAppCardActions capability is supported
      *
      * @throws Error if {@linkcode app.initialize} has not successfully completed
@@ -8423,10 +8627,10 @@ var externalAppCardActions;
      * Limited to Microsoft-internal use
      */
     function isSupported() {
-        return ensureInitialized(runtime) && runtime.supports.externalAppCardActions ? true : false;
+        return ensureInitialized(runtime) && runtime.supports.externalAppCardActionsForCEA ? true : false;
     }
-    externalAppCardActions.isSupported = isSupported;
-})(externalAppCardActions || (externalAppCardActions = {}));
+    externalAppCardActionsForCEA.isSupported = isSupported;
+})(externalAppCardActionsForCEA || (externalAppCardActionsForCEA = {}));
 
 ;// CONCATENATED MODULE: ./src/private/externalAppCommands.ts
 var externalAppCommands_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -8478,8 +8682,8 @@ var externalAppCommands;
             if (!isSupported()) {
                 throw errorNotSupportedOnPlatform;
             }
-            validateId(appId, new Error('App id is not valid.'));
-            const [error, response] = yield sendMessageToParentAsync(getApiVersionTag(externalAppCommandsTelemetryVersionNumber, "externalAppCommands.processActionCommand" /* ApiName.ExternalAppCommands_ProcessActionCommands */), "externalAppCommands.processActionCommand" /* ApiName.ExternalAppCommands_ProcessActionCommands */, [appId, commandId, extractedParameters]);
+            const typeSafeAppId = new AppId(appId);
+            const [error, response] = yield sendMessageToParentAsync(getApiVersionTag(externalAppCommandsTelemetryVersionNumber, "externalAppCommands.processActionCommand" /* ApiName.ExternalAppCommands_ProcessActionCommands */), "externalAppCommands.processActionCommand" /* ApiName.ExternalAppCommands_ProcessActionCommands */, [typeSafeAppId.toString(), commandId, extractedParameters]);
             if (error) {
                 throw error;
             }
@@ -11031,75 +11235,288 @@ var videoEffectsEx;
     videoEffectsEx.notifyFatalError = notifyFatalError;
 })(videoEffectsEx || (videoEffectsEx = {}));
 
-;// CONCATENATED MODULE: ./src/internal/appIdValidation.ts
+;// CONCATENATED MODULE: ./src/private/hostEntity.ts
+
+
+
+
+
+
 /**
- * This function can be used to validate if a string is a "valid" app id.
- * Valid is a relative term, in this case. Truly valid app ids are UUIDs as documented in the schema:
- * https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema#id
- * However, there are some older internal/hard-coded apps which violate this schema and use names like com.microsoft.teamspace.tab.youtube.
- * For compatibility with these legacy apps, we unfortunately cannot securely and completely validate app ids as UUIDs. Based
- * on this, the validation is limited to checking for script tags, length, and non-printable characters.
- *
- * @param potentialAppId A string to check if it's a "valid" app id
- * @throws Error with a message describing the exact validation violation
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
-function validateStringAsAppId(potentialAppId) {
-    if (doesStringContainScriptTags(potentialAppId)) {
-        throw new Error(`Potential app id (${potentialAppId}) is invalid; it contains script tags.`);
-    }
-    if (!isStringWithinAppIdLengthLimits(potentialAppId)) {
-        throw new Error(`Potential app id (${potentialAppId}) is invalid; its length ${potentialAppId.length} is not within the length limits (${minimumValidAppIdLength}-${maximumValidAppIdLength}).`);
-    }
-    if (doesStringContainNonPrintableCharacters(potentialAppId)) {
-        throw new Error(`Potential app id (${potentialAppId}) is invalid; it contains non-printable characters.`);
-    }
-}
-function doesStringContainScriptTags(str) {
-    const scriptRegex = /<script[^>]*>[\s\S]*?<\/script[^>]*>/gi;
-    return scriptRegex.test(str);
-}
-const minimumValidAppIdLength = 4;
-const maximumValidAppIdLength = 256;
-function isStringWithinAppIdLengthLimits(potentialAppId) {
-    return potentialAppId.length < maximumValidAppIdLength && potentialAppId.length > minimumValidAppIdLength;
-}
-function doesStringContainNonPrintableCharacters(str) {
-    return [...str].some((char) => {
-        const charCode = char.charCodeAt(0);
-        return charCode < 32 || charCode > 126;
-    });
-}
-
-;// CONCATENATED MODULE: ./src/public/appId.ts
-
+const hostEntityTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
 /**
- * A strongly-typed class used to represent a "valid" app id.
+ * @hidden
+ * @internal
+ * @beta
+ * Limited to Microsoft-internal use
  *
- * Valid is a relative term, in this case. Truly valid app ids are UUIDs as documented in the schema:
- * https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema#id
- * However, there are some older internal/hard-coded apps which violate this schema and use names like
- * com.microsoft.teamspace.tab.youtube. For compatibility with these legacy apps, we unfortunately cannot
- * securely and completely validate app ids as UUIDs. Based on this, the validation is limited to checking
- * for script tags, length, and non-printable characters.
+ * This capability allows an app to associate apps with a host entity, such as a Teams channel or chat, and configure them as needed.
  */
-class AppId {
+var hostEntity;
+(function (hostEntity) {
+    let AppTypes;
+    (function (AppTypes) {
+        AppTypes["edu"] = "EDU";
+    })(AppTypes = hostEntity.AppTypes || (hostEntity.AppTypes = {}));
+    /**
+     * @hidden
+     * @internal
+     * @beta
+     * Limited to Microsoft-internal use
+     *
+     * CRUD operations for tabs associated with apps
+     */
+    let tab;
+    (function (tab_1) {
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Launches host-owned UI that lets a user select an app, installs it if required,
+         * runs through app configuration if required, and then associates the app with the threadId provided
+         *
+         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
+         *
+         * @param appTypes What type of applications to show the user. If EDU is passed as appType, only apps supported by EDU tenant are shown.
+         * If no value is passed, all apps are shown.
+         *
+         * @returns The HostEntityTabInstance of the newly associated app
+         *
+         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation or installing
+         * or configuring or adding tab fails
+         */
+        function addAndConfigure(hostEntityIds, appTypes) {
+            ensureInitialized(runtime);
+            if (!isSupported()) {
+                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
+            }
+            validateThreadId(hostEntityIds.threadId);
+            if (appTypes && appTypes.length === 0) {
+                throw new Error(`Error code: ${ErrorCode.INVALID_ARGUMENTS}, message: App types cannot be an empty array`);
+            }
+            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.addAndConfigure" /* ApiName.HostEntity_Tab_addAndConfigureApp */), 'hostEntity.tab.addAndConfigure', [hostEntityIds, appTypes]).then(([response]) => {
+                var _a;
+                if (isSdkError(response)) {
+                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
+                }
+                return response;
+            });
+        }
+        tab_1.addAndConfigure = addAndConfigure;
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Returns all tab instances associated with a host entity
+         *
+         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
+         *
+         * @returns Object with array of HostEntityTabInstance's associated with a host entity
+         *
+         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid or fetching tabs fails
+         */
+        function getAll(hostEntityIds) {
+            ensureInitialized(runtime);
+            if (!isSupported()) {
+                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
+            }
+            validateThreadId(hostEntityIds.threadId);
+            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.getAll" /* ApiName.HostEntity_Tab_getAll */), 'hostEntity.tab.getAll', [hostEntityIds]).then(([response]) => {
+                var _a;
+                if (isSdkError(response)) {
+                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
+                }
+                return response;
+            });
+        }
+        tab_1.getAll = getAll;
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Launches host-owned UI that lets a user re-configure the contentUrl of the tab
+         *
+         * @param tab Configurable tab instance that needs to be updated
+         *
+         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
+         *
+         * @returns The HostEntityTabInstance of the updated tab
+         *
+         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation,
+         * re-configuring tab fails or if tab is a static tab
+         */
+        function reconfigure(tab, hostEntityIds) {
+            ensureInitialized(runtime);
+            if (!isSupported()) {
+                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
+            }
+            validateTab(tab);
+            validateThreadId(hostEntityIds.threadId);
+            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.reconfigure" /* ApiName.HostEntity_Tab_reconfigure */), 'hostEntity.tab.reconfigure', [tab, hostEntityIds]).then(([response]) => {
+                var _a;
+                if (isSdkError(response)) {
+                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
+                }
+                return response;
+            });
+        }
+        tab_1.reconfigure = reconfigure;
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Launches host-owned UI that lets a user rename the tab
+         *
+         * @param tab Configurable tab instance that needs to be updated
+         *
+         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
+         *
+         * @returns The HostEntityTabInstance of the updated tab
+         *
+         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation,
+         * re-naming tab fails or if tab is a static tab
+         */
+        function rename(tab, hostEntityIds) {
+            ensureInitialized(runtime);
+            if (!isSupported()) {
+                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
+            }
+            validateTab(tab);
+            validateThreadId(hostEntityIds.threadId);
+            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.rename" /* ApiName.HostEntity_Tab_rename */), 'hostEntity.tab.rename', [tab, hostEntityIds]).then(([response]) => {
+                var _a;
+                if (isSdkError(response)) {
+                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
+                }
+                return response;
+            });
+        }
+        tab_1.rename = rename;
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Launches host-owned UI that lets a user remove the tab
+         *
+         * @param tab tab instance that needs to be updated. Can be static tab or configurable tab.
+         *
+         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
+         *
+         * @returns Boolean. Returns true if removing tab was successful
+         *
+         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation or
+         * removing tab fails
+         */
+        function remove(tab, hostEntityIds) {
+            ensureInitialized(runtime);
+            if (!isSupported()) {
+                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
+            }
+            validateThreadId(hostEntityIds.threadId);
+            validateTab(tab);
+            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.remove" /* ApiName.HostEntity_Tab_remove */), 'hostEntity.tab.remove', [tab, hostEntityIds]).then(([response]) => {
+                var _a;
+                if (isSdkError(response)) {
+                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
+                }
+                return true;
+            });
+        }
+        tab_1.remove = remove;
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Checks if the hostEntity.tab capability is supported by the host
+         * @returns boolean to represent whether the histEntity and hostEntity.tab capability is supported
+         *
+         * @throws Error if {@linkcode app.initialize} has not successfully completed
+         */
+        function isSupported() {
+            var _a;
+            return ensureInitialized(runtime) && hostEntity.isSupported() && ((_a = runtime.supports.hostEntity) === null || _a === void 0 ? void 0 : _a.tab) ? true : false;
+        }
+        tab_1.isSupported = isSupported;
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Checks if the threadId is defined
+         * @throws Error if threadId is null, undefined or empty
+         */
+        function validateThreadId(threadId) {
+            if (!threadId || threadId.length == 0) {
+                throw new Error(`Error code: ${ErrorCode.INVALID_ARGUMENTS}, message: ThreadId cannot be null or empty`);
+            }
+        }
+        /**
+         * @hidden
+         * @internal
+         * @beta
+         * Limited to Microsoft-internal use
+         *
+         * Checks if the tabId is defined
+         * @throws Error if tabId is null, undefined or empty
+         */
+        function validateTab(tab) {
+            if (!(tab === null || tab === void 0 ? void 0 : tab.internalTabInstanceId) || tab.internalTabInstanceId.length === 0) {
+                throw new Error(`Error code: ${ErrorCode.INVALID_ARGUMENTS}, message: TabId cannot be null or empty`);
+            }
+        }
+    })(tab = hostEntity.tab || (hostEntity.tab = {}));
     /**
-     * Creates a strongly-typed AppId from a string
+     * @hidden
+     * @internal
+     * @beta
+     * Limited to Microsoft-internal use
      *
-     * @param appIdAsString An app id represented as a string
-     * @throws Error with a message describing the exact validation violation
-     */
-    constructor(appIdAsString) {
-        this.appIdAsString = appIdAsString;
-        validateStringAsAppId(appIdAsString);
-    }
-    /**
-     * Returns the app id as a string
+     * Checks if the hostEntity capability is supported by the host
+     * @returns boolean to represent whether the hostEntity capability is supported
+     *
+     * @throws Error if {@linkcode app.initialize} has not successfully completed
      */
-    toString() {
-        return this.appIdAsString;
+    function isSupported() {
+        return ensureInitialized(runtime) && runtime.supports.hostEntity ? true : false;
     }
-}
+    hostEntity.isSupported = isSupported;
+})(hostEntity || (hostEntity = {}));
+
+;// CONCATENATED MODULE: ./src/private/index.ts
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 ;// CONCATENATED MODULE: ./src/internal/deepLinkConstants.ts
 /**
@@ -15909,284 +16326,53 @@ function marketplaceUtils_validateUuid(id) {
         throw new Error('id must not be empty');
     }
     if (esm_browser_validate(id) === false) {
-        throw new Error('id must be a valid UUID');
-    }
-}
-/**
- * @hidden
- * Validate the cart item properties are valid
- * @param price The price to be validated
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-function validatePrice(price) {
-    if (typeof price !== 'number' || price < 0) {
-        throw new Error(`price ${price} must be a number not less than 0`);
-    }
-    if (parseFloat(price.toFixed(3)) !== price) {
-        throw new Error(`price ${price} must have at most 3 decimal places`);
-    }
-}
-/**
- * @hidden
- * Validate quantity
- * @param quantity The quantity to be validated
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-function validateQuantity(quantity) {
-    if (typeof quantity !== 'number' || quantity <= 0 || parseInt(quantity.toString()) !== quantity) {
-        throw new Error(`quantity ${quantity} must be an integer greater than 0`);
-    }
-}
-/**
- * @hidden
- * Validate cart status
- * @param cartStatus The cartStatus to be validated
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-function validateCartStatus(cartStatus) {
-    if (!Object.values(marketplace.CartStatus).includes(cartStatus)) {
-        throw new Error(`cartStatus ${cartStatus} is not valid`);
-    }
-}
-
-;// CONCATENATED MODULE: ./src/public/marketplace.ts
-
-
-
-
-
-
-/**
- * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
- */
-const marketplaceTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
-/**
- * @hidden
- * Namespace for an app to support a checkout flow by interacting with the marketplace cart in the host.
- * @beta
- */
-var marketplace;
-(function (marketplace) {
-    /**
-     * @hidden
-     * the version of the current cart interface
-     * which is forced to send to the host in the calls.
-     * @internal
-     * Limited to Microsoft-internal use
-     * @beta
-     */
-    marketplace.cartVersion = {
-        /**
-         * @hidden
-         * Represents the major version of the current cart interface,
-         * it is increased when incompatible interface update happens.
-         */
-        majorVersion: 1,
-        /**
-         * @hidden
-         * The minor version of the current cart interface, which is compatible
-         * with the previous minor version in the same major version.
-         */
-        minorVersion: 1,
-    };
-    /**
-     * @hidden
-     * Represents the persona creating the cart.
-     * @beta
-     */
-    let Intent;
-    (function (Intent) {
-        /**
-         * @hidden
-         * The cart is created by admin of an organization in Teams Admin Center.
-         */
-        Intent["TACAdminUser"] = "TACAdminUser";
-        /**
-         * @hidden
-         * The cart is created by admin of an organization in Teams.
-         */
-        Intent["TeamsAdminUser"] = "TeamsAdminUser";
-        /**
-         * @hidden
-         * The cart is created by end user of an organization in Teams.
-         */
-        Intent["TeamsEndUser"] = "TeamsEndUser";
-    })(Intent = marketplace.Intent || (marketplace.Intent = {}));
-    /**
-     * @hidden
-     * Represents the status of the cart.
-     * @beta
-     */
-    let CartStatus;
-    (function (CartStatus) {
-        /**
-         * @hidden
-         * Cart is created but not checked out yet.
-         */
-        CartStatus["Open"] = "Open";
-        /**
-         * @hidden
-         * Cart is checked out but not completed yet.
-         */
-        CartStatus["Processing"] = "Processing";
-        /**
-         * @hidden
-         * Indicate checking out is completed and the host should
-         * return a new cart in the next getCart call.
-         */
-        CartStatus["Processed"] = "Processed";
-        /**
-         * @hidden
-         * Indicate checking out process is manually cancelled by the user
-         */
-        CartStatus["Closed"] = "Closed";
-        /**
-         * @hidden
-         * Indicate checking out is failed and the host should
-         * return a new cart in the next getCart call.
-         */
-        CartStatus["Error"] = "Error";
-    })(CartStatus = marketplace.CartStatus || (marketplace.CartStatus = {}));
-    /**
-     * @hidden
-     * Get the cart object owned by the host to checkout.
-     * @returns A promise of the cart object in the cartVersion.
-     * @beta
-     */
-    function getCart() {
-        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
-        if (!isSupported()) {
-            throw errorNotSupportedOnPlatform;
-        }
-        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.getCart" /* ApiName.Marketplace_GetCart */), 'marketplace.getCart', marketplace.cartVersion).then(deserializeCart);
-    }
-    marketplace.getCart = getCart;
-    /**
-     * @hidden
-     * Add or update cart items in the cart owned by the host.
-     * @param addOrUpdateCartItemsParams Represents the parameters to update the cart items.
-     * @returns A promise of the updated cart object in the cartVersion.
-     * @beta
-     */
-    function addOrUpdateCartItems(addOrUpdateCartItemsParams) {
-        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
-        if (!isSupported()) {
-            throw errorNotSupportedOnPlatform;
-        }
-        if (!addOrUpdateCartItemsParams) {
-            throw new Error('addOrUpdateCartItemsParams must be provided');
-        }
-        marketplaceUtils_validateUuid(addOrUpdateCartItemsParams === null || addOrUpdateCartItemsParams === void 0 ? void 0 : addOrUpdateCartItemsParams.cartId);
-        validateCartItems(addOrUpdateCartItemsParams === null || addOrUpdateCartItemsParams === void 0 ? void 0 : addOrUpdateCartItemsParams.cartItems);
-        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.addOrUpdateCartItems" /* ApiName.Marketplace_AddOrUpdateCartItems */), 'marketplace.addOrUpdateCartItems', Object.assign(Object.assign({}, addOrUpdateCartItemsParams), { cartItems: serializeCartItems(addOrUpdateCartItemsParams.cartItems), cartVersion: marketplace.cartVersion })).then(deserializeCart);
+        throw new Error('id must be a valid UUID');
     }
-    marketplace.addOrUpdateCartItems = addOrUpdateCartItems;
-    /**
-     * @hidden
-     * Remove cart items from the cart owned by the host.
-     * @param removeCartItemsParams The parameters to remove the cart items.
-     * @returns A promise of the updated cart object in the cartVersion.
-     * @beta
-     */
-    function removeCartItems(removeCartItemsParams) {
-        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
-        if (!isSupported()) {
-            throw errorNotSupportedOnPlatform;
-        }
-        if (!removeCartItemsParams) {
-            throw new Error('removeCartItemsParams must be provided');
-        }
-        marketplaceUtils_validateUuid(removeCartItemsParams === null || removeCartItemsParams === void 0 ? void 0 : removeCartItemsParams.cartId);
-        if (!Array.isArray(removeCartItemsParams === null || removeCartItemsParams === void 0 ? void 0 : removeCartItemsParams.cartItemIds) || (removeCartItemsParams === null || removeCartItemsParams === void 0 ? void 0 : removeCartItemsParams.cartItemIds.length) === 0) {
-            throw new Error('cartItemIds must be a non-empty array');
-        }
-        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.removeCartItems" /* ApiName.Marketplace_RemoveCardItems */), 'marketplace.removeCartItems', Object.assign(Object.assign({}, removeCartItemsParams), { cartVersion: marketplace.cartVersion })).then(deserializeCart);
+}
+/**
+ * @hidden
+ * Validate the cart item properties are valid
+ * @param price The price to be validated
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function validatePrice(price) {
+    if (typeof price !== 'number' || price < 0) {
+        throw new Error(`price ${price} must be a number not less than 0`);
     }
-    marketplace.removeCartItems = removeCartItems;
-    /**
-     * @hidden
-     * Update cart status in the cart owned by the host.
-     * @param updateCartStatusParams The parameters to update the cart status.
-     * @returns A promise of the updated cart object in the cartVersion.
-     * @beta
-     */
-    function updateCartStatus(updateCartStatusParams) {
-        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
-        if (!isSupported()) {
-            throw errorNotSupportedOnPlatform;
-        }
-        if (!updateCartStatusParams) {
-            throw new Error('updateCartStatusParams must be provided');
-        }
-        marketplaceUtils_validateUuid(updateCartStatusParams === null || updateCartStatusParams === void 0 ? void 0 : updateCartStatusParams.cartId);
-        validateCartStatus(updateCartStatusParams === null || updateCartStatusParams === void 0 ? void 0 : updateCartStatusParams.cartStatus);
-        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.updateCartStatus" /* ApiName.Marketplace_UpdateCartStatus */), 'marketplace.updateCartStatus', Object.assign(Object.assign({}, updateCartStatusParams), { cartVersion: marketplace.cartVersion })).then(deserializeCart);
+    if (parseFloat(price.toFixed(3)) !== price) {
+        throw new Error(`price ${price} must have at most 3 decimal places`);
     }
-    marketplace.updateCartStatus = updateCartStatus;
-    /**
-     * @hidden
-     * Checks if the marketplace capability is supported by the host.
-     * @returns Boolean to represent whether the marketplace capability is supported.
-     * @throws Error if {@linkcode app.initialize} has not successfully completed.
-     * @beta
-     */
-    function isSupported() {
-        return ensureInitialized(runtime) && runtime.supports.marketplace ? true : false;
+}
+/**
+ * @hidden
+ * Validate quantity
+ * @param quantity The quantity to be validated
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function validateQuantity(quantity) {
+    if (typeof quantity !== 'number' || quantity <= 0 || parseInt(quantity.toString()) !== quantity) {
+        throw new Error(`quantity ${quantity} must be an integer greater than 0`);
     }
-    marketplace.isSupported = isSupported;
-})(marketplace || (marketplace = {}));
-
-;// CONCATENATED MODULE: ./src/public/index.ts
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+}
+/**
+ * @hidden
+ * Validate cart status
+ * @param cartStatus The cartStatus to be validated
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function validateCartStatus(cartStatus) {
+    if (!Object.values(marketplace.CartStatus).includes(cartStatus)) {
+        throw new Error(`cartStatus ${cartStatus} is not valid`);
+    }
+}
 
-;// CONCATENATED MODULE: ./src/private/hostEntity.ts
+;// CONCATENATED MODULE: ./src/public/marketplace.ts
 
 
 
@@ -16196,259 +16382,208 @@ var marketplace;
 /**
  * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
-const hostEntityTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
+const marketplaceTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
 /**
  * @hidden
- * @internal
+ * Namespace for an app to support a checkout flow by interacting with the marketplace cart in the host.
  * @beta
- * Limited to Microsoft-internal use
- *
- * This capability allows an app to associate apps with a host entity, such as a Teams channel or chat, and configure them as needed.
  */
-var hostEntity;
-(function (hostEntity) {
-    let AppTypes;
-    (function (AppTypes) {
-        AppTypes["edu"] = "EDU";
-    })(AppTypes = hostEntity.AppTypes || (hostEntity.AppTypes = {}));
+var marketplace;
+(function (marketplace) {
     /**
      * @hidden
+     * the version of the current cart interface
+     * which is forced to send to the host in the calls.
      * @internal
-     * @beta
      * Limited to Microsoft-internal use
-     *
-     * CRUD operations for tabs associated with apps
+     * @beta
      */
-    let tab;
-    (function (tab_1) {
+    marketplace.cartVersion = {
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Launches host-owned UI that lets a user select an app, installs it if required,
-         * runs through app configuration if required, and then associates the app with the threadId provided
-         *
-         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
-         *
-         * @param appTypes What type of applications to show the user. If EDU is passed as appType, only apps supported by EDU tenant are shown.
-         * If no value is passed, all apps are shown.
-         *
-         * @returns The HostEntityTabInstance of the newly associated app
-         *
-         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation or installing
-         * or configuring or adding tab fails
+         * Represents the major version of the current cart interface,
+         * it is increased when incompatible interface update happens.
          */
-        function addAndConfigure(hostEntityIds, appTypes) {
-            ensureInitialized(runtime);
-            if (!isSupported()) {
-                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
-            }
-            validateThreadId(hostEntityIds.threadId);
-            if (appTypes && appTypes.length === 0) {
-                throw new Error(`Error code: ${ErrorCode.INVALID_ARGUMENTS}, message: App types cannot be an empty array`);
-            }
-            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.addAndConfigure" /* ApiName.HostEntity_Tab_addAndConfigureApp */), 'hostEntity.tab.addAndConfigure', [hostEntityIds, appTypes]).then(([response]) => {
-                var _a;
-                if (isSdkError(response)) {
-                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
-                }
-                return response;
-            });
-        }
-        tab_1.addAndConfigure = addAndConfigure;
+        majorVersion: 1,
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Returns all tab instances associated with a host entity
-         *
-         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
-         *
-         * @returns Object with array of HostEntityTabInstance's associated with a host entity
-         *
-         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid or fetching tabs fails
+         * The minor version of the current cart interface, which is compatible
+         * with the previous minor version in the same major version.
          */
-        function getAll(hostEntityIds) {
-            ensureInitialized(runtime);
-            if (!isSupported()) {
-                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
-            }
-            validateThreadId(hostEntityIds.threadId);
-            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.getAll" /* ApiName.HostEntity_Tab_getAll */), 'hostEntity.tab.getAll', [hostEntityIds]).then(([response]) => {
-                var _a;
-                if (isSdkError(response)) {
-                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
-                }
-                return response;
-            });
-        }
-        tab_1.getAll = getAll;
+        minorVersion: 1,
+    };
+    /**
+     * @hidden
+     * Represents the persona creating the cart.
+     * @beta
+     */
+    let Intent;
+    (function (Intent) {
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Launches host-owned UI that lets a user re-configure the contentUrl of the tab
-         *
-         * @param tab Configurable tab instance that needs to be updated
-         *
-         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
-         *
-         * @returns The HostEntityTabInstance of the updated tab
-         *
-         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation,
-         * re-configuring tab fails or if tab is a static tab
+         * The cart is created by admin of an organization in Teams Admin Center.
+         */
+        Intent["TACAdminUser"] = "TACAdminUser";
+        /**
+         * @hidden
+         * The cart is created by admin of an organization in Teams.
          */
-        function reconfigure(tab, hostEntityIds) {
-            ensureInitialized(runtime);
-            if (!isSupported()) {
-                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
-            }
-            validateTab(tab);
-            validateThreadId(hostEntityIds.threadId);
-            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.reconfigure" /* ApiName.HostEntity_Tab_reconfigure */), 'hostEntity.tab.reconfigure', [tab, hostEntityIds]).then(([response]) => {
-                var _a;
-                if (isSdkError(response)) {
-                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
-                }
-                return response;
-            });
-        }
-        tab_1.reconfigure = reconfigure;
+        Intent["TeamsAdminUser"] = "TeamsAdminUser";
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Launches host-owned UI that lets a user rename the tab
-         *
-         * @param tab Configurable tab instance that needs to be updated
-         *
-         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
-         *
-         * @returns The HostEntityTabInstance of the updated tab
-         *
-         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation,
-         * re-naming tab fails or if tab is a static tab
+         * The cart is created by end user of an organization in Teams.
          */
-        function rename(tab, hostEntityIds) {
-            ensureInitialized(runtime);
-            if (!isSupported()) {
-                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
-            }
-            validateTab(tab);
-            validateThreadId(hostEntityIds.threadId);
-            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.rename" /* ApiName.HostEntity_Tab_rename */), 'hostEntity.tab.rename', [tab, hostEntityIds]).then(([response]) => {
-                var _a;
-                if (isSdkError(response)) {
-                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
-                }
-                return response;
-            });
-        }
-        tab_1.rename = rename;
+        Intent["TeamsEndUser"] = "TeamsEndUser";
+    })(Intent = marketplace.Intent || (marketplace.Intent = {}));
+    /**
+     * @hidden
+     * Represents the status of the cart.
+     * @beta
+     */
+    let CartStatus;
+    (function (CartStatus) {
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Launches host-owned UI that lets a user remove the tab
-         *
-         * @param tab tab instance that needs to be updated. Can be static tab or configurable tab.
-         *
-         * @param hostEntityIds Ids of the host entity like channel, chat or meeting
-         *
-         * @returns Boolean. Returns true if removing tab was successful
-         *
-         * @throws Error if host does not support this capability, library as not been initialized successfully, input parameters are invalid, user cancels operation or
-         * removing tab fails
+         * Cart is created but not checked out yet.
          */
-        function remove(tab, hostEntityIds) {
-            ensureInitialized(runtime);
-            if (!isSupported()) {
-                throw new Error(`Error code: ${ErrorCode.NOT_SUPPORTED_ON_PLATFORM}, message: Not supported on platform`);
-            }
-            validateThreadId(hostEntityIds.threadId);
-            validateTab(tab);
-            return sendMessageToParentAsync(getApiVersionTag(hostEntityTelemetryVersionNumber, "hostEntity.tab.remove" /* ApiName.HostEntity_Tab_remove */), 'hostEntity.tab.remove', [tab, hostEntityIds]).then(([response]) => {
-                var _a;
-                if (isSdkError(response)) {
-                    throw new Error(`Error code: ${response.errorCode}, message: ${(_a = response.message) !== null && _a !== void 0 ? _a : 'None'}`);
-                }
-                return true;
-            });
-        }
-        tab_1.remove = remove;
+        CartStatus["Open"] = "Open";
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Checks if the hostEntity.tab capability is supported by the host
-         * @returns boolean to represent whether the histEntity and hostEntity.tab capability is supported
-         *
-         * @throws Error if {@linkcode app.initialize} has not successfully completed
+         * Cart is checked out but not completed yet.
          */
-        function isSupported() {
-            var _a;
-            return ensureInitialized(runtime) && hostEntity.isSupported() && ((_a = runtime.supports.hostEntity) === null || _a === void 0 ? void 0 : _a.tab) ? true : false;
-        }
-        tab_1.isSupported = isSupported;
+        CartStatus["Processing"] = "Processing";
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Checks if the threadId is defined
-         * @throws Error if threadId is null, undefined or empty
+         * Indicate checking out is completed and the host should
+         * return a new cart in the next getCart call.
          */
-        function validateThreadId(threadId) {
-            if (!threadId || threadId.length == 0) {
-                throw new Error(`Error code: ${ErrorCode.INVALID_ARGUMENTS}, message: ThreadId cannot be null or empty`);
-            }
-        }
+        CartStatus["Processed"] = "Processed";
         /**
          * @hidden
-         * @internal
-         * @beta
-         * Limited to Microsoft-internal use
-         *
-         * Checks if the tabId is defined
-         * @throws Error if tabId is null, undefined or empty
+         * Indicate checking out process is manually cancelled by the user
          */
-        function validateTab(tab) {
-            if (!(tab === null || tab === void 0 ? void 0 : tab.internalTabInstanceId) || tab.internalTabInstanceId.length === 0) {
-                throw new Error(`Error code: ${ErrorCode.INVALID_ARGUMENTS}, message: TabId cannot be null or empty`);
-            }
+        CartStatus["Closed"] = "Closed";
+        /**
+         * @hidden
+         * Indicate checking out is failed and the host should
+         * return a new cart in the next getCart call.
+         */
+        CartStatus["Error"] = "Error";
+    })(CartStatus = marketplace.CartStatus || (marketplace.CartStatus = {}));
+    /**
+     * @hidden
+     * Get the cart object owned by the host to checkout.
+     * @returns A promise of the cart object in the cartVersion.
+     * @beta
+     */
+    function getCart() {
+        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
+        if (!isSupported()) {
+            throw errorNotSupportedOnPlatform;
         }
-    })(tab = hostEntity.tab || (hostEntity.tab = {}));
+        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.getCart" /* ApiName.Marketplace_GetCart */), 'marketplace.getCart', marketplace.cartVersion).then(deserializeCart);
+    }
+    marketplace.getCart = getCart;
     /**
      * @hidden
-     * @internal
+     * Add or update cart items in the cart owned by the host.
+     * @param addOrUpdateCartItemsParams Represents the parameters to update the cart items.
+     * @returns A promise of the updated cart object in the cartVersion.
+     * @beta
+     */
+    function addOrUpdateCartItems(addOrUpdateCartItemsParams) {
+        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
+        if (!isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        if (!addOrUpdateCartItemsParams) {
+            throw new Error('addOrUpdateCartItemsParams must be provided');
+        }
+        marketplaceUtils_validateUuid(addOrUpdateCartItemsParams === null || addOrUpdateCartItemsParams === void 0 ? void 0 : addOrUpdateCartItemsParams.cartId);
+        validateCartItems(addOrUpdateCartItemsParams === null || addOrUpdateCartItemsParams === void 0 ? void 0 : addOrUpdateCartItemsParams.cartItems);
+        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.addOrUpdateCartItems" /* ApiName.Marketplace_AddOrUpdateCartItems */), 'marketplace.addOrUpdateCartItems', Object.assign(Object.assign({}, addOrUpdateCartItemsParams), { cartItems: serializeCartItems(addOrUpdateCartItemsParams.cartItems), cartVersion: marketplace.cartVersion })).then(deserializeCart);
+    }
+    marketplace.addOrUpdateCartItems = addOrUpdateCartItems;
+    /**
+     * @hidden
+     * Remove cart items from the cart owned by the host.
+     * @param removeCartItemsParams The parameters to remove the cart items.
+     * @returns A promise of the updated cart object in the cartVersion.
+     * @beta
+     */
+    function removeCartItems(removeCartItemsParams) {
+        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
+        if (!isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        if (!removeCartItemsParams) {
+            throw new Error('removeCartItemsParams must be provided');
+        }
+        marketplaceUtils_validateUuid(removeCartItemsParams === null || removeCartItemsParams === void 0 ? void 0 : removeCartItemsParams.cartId);
+        if (!Array.isArray(removeCartItemsParams === null || removeCartItemsParams === void 0 ? void 0 : removeCartItemsParams.cartItemIds) || (removeCartItemsParams === null || removeCartItemsParams === void 0 ? void 0 : removeCartItemsParams.cartItemIds.length) === 0) {
+            throw new Error('cartItemIds must be a non-empty array');
+        }
+        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.removeCartItems" /* ApiName.Marketplace_RemoveCardItems */), 'marketplace.removeCartItems', Object.assign(Object.assign({}, removeCartItemsParams), { cartVersion: marketplace.cartVersion })).then(deserializeCart);
+    }
+    marketplace.removeCartItems = removeCartItems;
+    /**
+     * @hidden
+     * Update cart status in the cart owned by the host.
+     * @param updateCartStatusParams The parameters to update the cart status.
+     * @returns A promise of the updated cart object in the cartVersion.
+     * @beta
+     */
+    function updateCartStatus(updateCartStatusParams) {
+        ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
+        if (!isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        if (!updateCartStatusParams) {
+            throw new Error('updateCartStatusParams must be provided');
+        }
+        marketplaceUtils_validateUuid(updateCartStatusParams === null || updateCartStatusParams === void 0 ? void 0 : updateCartStatusParams.cartId);
+        validateCartStatus(updateCartStatusParams === null || updateCartStatusParams === void 0 ? void 0 : updateCartStatusParams.cartStatus);
+        return sendAndHandleSdkError(getApiVersionTag(marketplaceTelemetryVersionNumber, "marketplace.updateCartStatus" /* ApiName.Marketplace_UpdateCartStatus */), 'marketplace.updateCartStatus', Object.assign(Object.assign({}, updateCartStatusParams), { cartVersion: marketplace.cartVersion })).then(deserializeCart);
+    }
+    marketplace.updateCartStatus = updateCartStatus;
+    /**
+     * @hidden
+     * Checks if the marketplace capability is supported by the host.
+     * @returns Boolean to represent whether the marketplace capability is supported.
+     * @throws Error if {@linkcode app.initialize} has not successfully completed.
      * @beta
-     * Limited to Microsoft-internal use
-     *
-     * Checks if the hostEntity capability is supported by the host
-     * @returns boolean to represent whether the hostEntity capability is supported
-     *
-     * @throws Error if {@linkcode app.initialize} has not successfully completed
      */
     function isSupported() {
-        return ensureInitialized(runtime) && runtime.supports.hostEntity ? true : false;
+        return ensureInitialized(runtime) && runtime.supports.marketplace ? true : false;
     }
-    hostEntity.isSupported = isSupported;
-})(hostEntity || (hostEntity = {}));
+    marketplace.isSupported = isSupported;
+})(marketplace || (marketplace = {}));
 
-;// CONCATENATED MODULE: ./src/private/index.ts
+;// CONCATENATED MODULE: ./src/public/index.ts
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+