@sapui5/sap.suite.ui.commons 1.140.0 → 1.142.0

package/src/sap/suite/ui/commons/collaboration/TeamsHelperService.js

@@ -28,7 +28,7 @@ sap.ui.define([
     "sap/base/i18n/Localization",
     "./CollaborationManagerService",
     "sap/m/FlexItemData"
-], function (Log, Core, URLListValidator, CollaborationHelper, BaseHelperService, Element, ContactHelper, Device, CollaborationCardHelper, Fragment, MessageBox, Library, Popover, HBox, VBox, MessageStrip, Button, CollaborationContactInfoHelper, sapMLibrary, FlexBox, Localization, CollaborationManagerService, FlexItemData) {
+], function(Log, Core, URLListValidator, CollaborationHelper, BaseHelperService, Element, ContactHelper, Device, CollaborationCardHelper, Fragment, MessageBox, Library, Popover, HBox, VBox, MessageStrip, Button, CollaborationContactInfoHelper, sapMLibrary, FlexBox, Localization, CollaborationManagerService, FlexItemData) {
     "use strict";
 
     /**
@@ -41,7 +41,7 @@ sap.ui.define([
      * @experimental Since 1.108
      */
     var TeamsHelperService = BaseHelperService.extend("sap.suite.ui.commons.collaboration.TeamsHelperService", {
-        constructor: function (oProviderConfig) {
+        constructor: function(oProviderConfig) {
             this._providerConfig = oProviderConfig;
             this._providerConfig.shareAsLinkUrl = "https://teams.microsoft.com/share";
             this._getShareAsTabUrl().then(function(sShareAsTabUrl) {
@@ -53,18 +53,32 @@ sap.ui.define([
     /**
      * sTeamsAppID is hardcoded as of now, will be changed when app is published at org level.
      */
-    var COLLABORATION_MSTEAMS_APPID = 'db5b69c6-0430-4ae1-8d6e-a65c2220b50c';
-    var oLogger = Log.getLogger("sap.suite.ui.commons.collaboration.TeamsHelperService");
-	var CARD_URL_PREFIX = "https://saps4hana.azure-api.net/bot/redirect?target-url=";
+    const COLLABORATION_MSTEAMS_APPID = 'db5b69c6-0430-4ae1-8d6e-a65c2220b50c';
+    const oLogger = Log.getLogger("sap.suite.ui.commons.collaboration.TeamsHelperService");
+    const CARD_URL_PREFIX = "https://saps4hana.azure-api.net/bot/redirect?target-url=";
+    const oResourceBundle = Library.getResourceBundleFor("sap.suite.ui.commons");
+    const PARAM_SAP_CARD_INFO = "info";
 
-    var oResourceBundle = Library.getResourceBundleFor("sap.suite.ui.commons");
-	var PARAM_SAP_CARD_INFO = "info";
-
-    var oBusyDailog;
-    let iTimeoutId;
-    const AUTO_CLOSE_BUSY_DIALOG_TIME = 60 * 1000; // 1 sec = 1000, here 60 sec
-    var oTeamsParams = {};
-    var windowWidthAndHeight = "width=720,height=720";
+    let oBusyDialog;
+    let iBusyDialogTimeoutId;
+    const AUTO_CLOSE_BUSY_DIALOG_TIME = 60 * 1000; //60 sec
+    let oTeamsParams = {};
+    const windowWidthAndHeight = "width=720,height=720";
+    const validDomains = [
+        "*.s4hana.ondemand.com",
+        "*.*.s4hana.ondemand.com",
+        "*.*.*.s4hana.ondemand.com",
+        "*.cloud.sap",
+        "*.*.cloud.sap",
+        "*.*.*.cloud.sap",
+        "*.sapcloud.cn",
+        "*.*.sapcloud.cn",
+        "*.*.*.sapcloud.cn",
+        "*.saps4hanacloud.cn",
+        "*.*.saps4hanacloud.cn",
+        "*.*.*.saps4hanacloud.cn",
+        "*.sap.com"
+    ];
 
     /**
      * Gives list of all Collaboration Options
@@ -77,7 +91,7 @@ sap.ui.define([
      * @ui5-restricted
      * @experimental Since 1.108
      */
-    TeamsHelperService.prototype.getOptions = function (oParams) {
+    TeamsHelperService.prototype.getOptions = function(oParams) {
         oTeamsParams = {
             isShareAsLinkEnabled: (oParams && typeof oParams.isShareAsLinkEnabled !== 'undefined') ? oParams.isShareAsLinkEnabled : true,
             isShareAsTabEnabled: (oParams && typeof oParams.isShareAsTabEnabled !== 'undefined') ? oParams.isShareAsTabEnabled : true,
@@ -195,7 +209,7 @@ sap.ui.define([
      * @ui5-restricted
      * @experimental Since 1.108
      */
-    TeamsHelperService.prototype.share = function (oOption, oParams) {
+    TeamsHelperService.prototype.share = function(oOption, oParams) {
 
         if (!oParams.url) {
             oLogger.error("url is not supplied in object so terminating Click");
@@ -236,7 +250,7 @@ sap.ui.define([
      * @ui5-restricted
      * @experimental Since 1.108
      */
-    TeamsHelperService.prototype._shareAsChat = function (oParams) {
+    TeamsHelperService.prototype._shareAsChat = function(oParams) {
         var newWindow = window.open(
             "",
             "_blank",
@@ -249,13 +263,13 @@ sap.ui.define([
 
         newWindow.opener = null;
         if (oParams.minifyUrlForChat) {
-			CollaborationHelper.compactHash(oParams.url, []).then(async function (sShortURL) {
+            CollaborationHelper.compactHash(oParams.url, []).then(async function(sShortURL) {
                 var sModifiedUrl = await this._modifyUrlForNavigationContext(oParams.url, sShortURL.url);
-				newWindow.location = this._providerConfig.shareAsLinkUrl + "?msgText=" + encodeURIComponent(sMessage) + "&preview=false" + "&href=" + encodeURIComponent(sModifiedUrl);
-			}.bind(this));
-		} else {
-			newWindow.location = this._providerConfig.shareAsLinkUrl + "?msgText=" + encodeURIComponent(sMessage) + "&preview=false" + "&href=" + encodeURIComponent(oParams.url);
-		}
+                newWindow.location = this._providerConfig.shareAsLinkUrl + "?msgText=" + encodeURIComponent(sMessage) + "&preview=false" + "&href=" + encodeURIComponent(sModifiedUrl);
+            }.bind(this));
+        } else {
+            newWindow.location = this._providerConfig.shareAsLinkUrl + "?msgText=" + encodeURIComponent(sMessage) + "&preview=false" + "&href=" + encodeURIComponent(oParams.url);
+        }
     };
 
     /**
@@ -297,7 +311,7 @@ sap.ui.define([
      * @ui5-restricted
      * @experimental Since 1.108
      */
-    TeamsHelperService.prototype._shareAsTab = async function (oParams) {
+    TeamsHelperService.prototype._shareAsTab = async function(oParams) {
         var sAppUri = await this._modifyUrlForShareAsTab(oParams.url, "MST:T");
         var oData = {
             "subEntityId": {
@@ -308,19 +322,19 @@ sap.ui.define([
             }
         };
         if (oParams.minifyUrlForChat) {
-			CollaborationHelper.compactHash(sAppUri, []).then(async function (sShortURL) {
+            CollaborationHelper.compactHash(sAppUri, []).then(async function(sShortURL) {
                 var sModifiedUrl = await this._modifyUrlForNavigationContext(sAppUri, sShortURL.url);
-				oData.subEntityId.url = await this._addNavmodeInUrl(sModifiedUrl, 'explace');
-				var sURL = this._providerConfig.shareAsTabUrl + "?&context=" + encodeURIComponent(JSON.stringify(oData));
-		        sap.m.URLHelper.redirect(sURL, true);
-			}.bind(this));
-		} else {
-			var sURL = this._providerConfig.shareAsTabUrl + "?&context=" + encodeURIComponent(JSON.stringify(oData));
-			sap.m.URLHelper.redirect(sURL, true);
-		}
+                oData.subEntityId.url = await this._addNavmodeInUrl(sModifiedUrl, 'explace');
+                var sURL = this._providerConfig.shareAsTabUrl + "?&context=" + encodeURIComponent(JSON.stringify(oData));
+                sap.m.URLHelper.redirect(sURL, true);
+            }.bind(this));
+        } else {
+            var sURL = this._providerConfig.shareAsTabUrl + "?&context=" + encodeURIComponent(JSON.stringify(oData));
+            sap.m.URLHelper.redirect(sURL, true);
+        }
     };
 
-    TeamsHelperService.prototype._addNavmodeInUrl = function (sURL, sNavMode) {
+    TeamsHelperService.prototype._addNavmodeInUrl = function(sURL, sNavMode) {
         const UshellContainer = sap.ui.require("sap/ushell/Container");
         return UshellContainer && UshellContainer.getServiceAsync("URLParsing").then(function(oURLParsing) {
             var sAppUri = sURL;
@@ -347,7 +361,7 @@ sap.ui.define([
             var oHashPartOfUri = oURLParsing.parseShellHash(sAppUri.substring(iIndexOfHash));
             var iParamsCount = Object.keys(oHashPartOfUri.params).length;
             var oUrl = new URL(sURL);
-            if (iParamsCount > 0){
+            if (iParamsCount > 0) {
                 if (!oUrl.searchParams.has("sap-collaboration-teams")) {
                     oUrl.searchParams.set("sap-collaboration-teams", "true");
                 } else {
@@ -368,125 +382,256 @@ sap.ui.define([
      * @ui5-restricted
      * @experimental Since 1.108
      */
-    TeamsHelperService.prototype._shareAsCard = function (oParams) {
-        if (oParams.cardId && oParams.cardId.length > 0 && oParams.cardManifest && this.isFeatureFlagEnabled()) {
-            // Card Id and Card Manifest Passed. It will show busy helper and store card into DB.
-            oParams.cardManifest["rtl"]= Localization.getRTL();
-            Fragment.load({
-                name: "sap.suite.ui.commons.collaboration.CollaborationBusyDialog",
-                controller: this,
-                type:  "XML"
-            }).then(function (oDialog) {
-                oBusyDailog = oDialog;
-                oBusyDailog.open();
-                iTimeoutId = setTimeout(function() {
-                    oBusyDailog.close();
-                    oBusyDailog.destroy();
-                }, AUTO_CLOSE_BUSY_DIALOG_TIME);
-                CollaborationCardHelper.postCard(oParams.cardId, oParams.cardManifest).then(function (response) {
-                    var bSuccessScenario = true;
-                    var oResponseData = {
-                        cardId: response.card_id,
-                        version: response.version
-                    };
-                    if (response.error) {
-                        if (response.error.code === "APS_UI_MSG/001") {
-                            // Card ID with same CardManifest detail is present so it will get version and open Teams Dialog
-                            bSuccessScenario = true;
-                            oResponseData.cardId = oParams.cardId;
-                            if (response.error.message.length > 0){
-                                try {
-                                    var sCardVersion = JSON.parse(atob(response.error.message)).version;
-                                    oResponseData.version = sCardVersion;
-                                } catch (e) {
-                                    bSuccessScenario = false;
-                                }
-                            }
-                        } else {
-                            bSuccessScenario = false;
-                        }
-                    }
-                    if (bSuccessScenario) {
-                        this._updateUrl(oParams, oResponseData);
-                    } else {
-                        MessageBox.error(oResourceBundle.getText("SAVE_CARD_ERROR"));
-                        this._closeBusyDailog();
-                    }
-                }.bind(this));
-            }.bind(this));
-        } else {
+    TeamsHelperService.prototype._shareAsCard = async function (oParams) {
+        if (!oParams?.cardId || !oParams.cardId.length || !oParams.cardManifest || !this.isFeatureFlagEnabled()) {
             // Base Card to unfurl
             this._updateUrl(oParams, {});
+            return;
+        }
+        let oCardData = {};
+        try {
+            // Card Id and Card Manifest Passed. It will show busy helper and store card into DB.
+            try {
+                const oDialog = await Fragment.load({
+                    name: "sap.suite.ui.commons.collaboration.CollaborationBusyDialog",
+                    controller: this,
+                    type: "XML"
+                });
+                oBusyDialog = oDialog;
+                oBusyDialog.open();
+
+                // Automatically close the dialog after a fixed time
+                iBusyDialogTimeoutId = setTimeout(() => {
+                    oBusyDialog.close();
+                    oBusyDialog.destroy();
+                }, AUTO_CLOSE_BUSY_DIALOG_TIME);
+            } catch (err) {
+                oLogger.error("Fragment load failed: " + err.message);
+            }
+
+            oCardData = await this._buildCardInfo(oParams);
+        } catch (err) {
+            oLogger.error("buildCardInfo failed: " + err.message);
+        } finally {
+            if (oCardData && Object.keys(oCardData).length === 0) {
+                oLogger.warn("Card info could not be saved.");
+            }
+
+            // Auth/Base card to unfurl
+            this._updateUrl(oParams, oCardData);
         }
     };
 
-    TeamsHelperService.prototype._updateUrl = async function(oParams, oResponseData) {
-        if (oParams.minifyUrlForChat) {
-          CollaborationHelper.compactHash(oParams.url, []).then(async function (sShortURL) {
-                var sModifiedUrl = await this._modifyUrlForNavigationContext(oParams.url, sShortURL.url);
-                var sUrlForTab = await this._modifyUrlForShareAsTab(oParams.url, "MST:C");
-                var sShortURLTab = await CollaborationHelper.compactHash(sUrlForTab, []);
-                var sStageViewHash = sShortURLTab.url.split("sap-url-hash=")[1];
-                // Scenario in which URL shortening is enabled, but the iAppState is set to Transient.
-                if (sStageViewHash) {
-                    sModifiedUrl += `,${sStageViewHash}`;
-                } else {
-                    sUrlForTab = await this._modifyUrlForShareAsTab(sModifiedUrl, "MST:C");
-                    sModifiedUrl = await this._addNavmodeInUrl(sUrlForTab, 'inplace');
+    /**
+     * Builds card information for a Teams collaboration card.
+     * This method calls the postCard API to create or retrieve card info.
+     * - On success: returns { cardId, version }.
+     * - On business error (e.g., APS_UI_MSG/001 when card already exists):
+     *   tries to recover the card version from the error message and still returns { cardId, version }.
+     * - On other business errors: returns an empty object {}.
+     * - On technical errors (network/CSRF/JSON parsing): the promise rejects and should be caught by the caller.
+     *
+     * @param {Object} oParams - Parameters for building the card
+     * @param {string} oParams.cardId - The card ID
+     * @param {Object} oParams.cardManifest - The card manifest metadata
+     * @returns {Promise<Object>} - Resolves with card information { cardId, version } or {} if not available
+     *                              (may reject on technical errors)
+     */
+    TeamsHelperService.prototype._buildCardInfo = async function (oParams) {
+        // Set right-to-left layout based on localization settings
+        oParams.cardManifest.rtl = Localization.getRTL();
+        const postCardResponse = await CollaborationCardHelper.postCard(oParams.cardId, oParams.cardManifest);
+
+        let oCardData = {
+            cardId: postCardResponse.card_id,
+            version: postCardResponse.version
+        };
+
+        // Handle special error scenario where the card already exists
+        if (postCardResponse.error) {
+            if (postCardResponse.error.code === "APS_UI_MSG/001") {
+                // Card ID with same CardManifest detail is present so it will get version and open Teams Dialog
+                oCardData.cardId = oParams.cardId;
+                if (postCardResponse.error.message.length > 0){
+                    try {
+                        const sCardVersion = JSON.parse(atob(postCardResponse.error.message)).version;
+                        oCardData.version = sCardVersion;
+                    } catch (e) {
+                        oCardData = {};
+                    }
                 }
-                this._closeBusyDialogAndOpenTeamsDialog(sModifiedUrl, oParams, oResponseData);
-            }.bind(this));
-        } else {
-            var sModifiedUrl = oParams.url;
-            if (oTeamsParams.isShareAsTabEnabled && this._providerConfig.isShareAsTabEnabled) {
-                var sUrlForTab = await this._modifyUrlForShareAsTab(sModifiedUrl, "MST:C");
+            } else {
+                oCardData = {};
+            }
+        }
+        return oCardData;
+    };
+
+    /**
+     * Updates the URL based on parameters, optionally minifying it for chat,
+     * and then opens the Teams dialog with the processed URL.
+     *
+     * @param {Object} oParams - Parameters including original URL and flags.
+     * @param {Object} oCardData - The card data containing cardId and version.
+     */
+    TeamsHelperService.prototype._updateUrl = async function(oParams, oCardData) {
+        let sModifiedUrl = oParams?.url || window.location.href;
+        try {
+            if (oParams.minifyUrlForChat) {
+                sModifiedUrl = await this._getModifiedUrlForSharing(oParams);
+            } else if (oTeamsParams.isShareAsTabEnabled && this._providerConfig.isShareAsTabEnabled) {
+                const sUrlForTab = await this._modifyUrlForShareAsTab(sModifiedUrl, "MST:C");
                 sModifiedUrl = await this._addNavmodeInUrl(sUrlForTab, 'inplace');
             }
-            this._closeBusyDialogAndOpenTeamsDialog(sModifiedUrl, oParams, oResponseData);
+        } catch (error) {
+            oLogger.error("Error while modifying URL for sharing: " + error.message);
+        } finally {
+            // Close busy dialog and open the Teams dialog with the final URL
+            this._closeBusyDialogAndOpenTeamsDialog(sModifiedUrl, oParams, oCardData);
         }
     };
 
-    TeamsHelperService.prototype._closeBusyDailog = function() {
-        if (oBusyDailog) {
-            oBusyDailog.close();
-            oBusyDailog.destroy();
-            clearTimeout(iTimeoutId);
+    /**
+     * Generates a modified URL for sharing in Microsoft Teams.
+     * @param {Object} oParams - Parameters containing the original URL and flags.
+     * @returns {Promise<string>} - A fully processed URL ready to be used for sharing.
+     */
+    TeamsHelperService.prototype._getModifiedUrlForSharing = async function(oParams) {
+        const sShortURL = await CollaborationHelper.compactHash(oParams.url, []);
+        let sModifiedUrl = await this._modifyUrlForNavigationContext(oParams.url, sShortURL.url);
+        let sUrlForTab = await this._modifyUrlForShareAsTab(oParams.url, "MST:C");
+        const sShortURLTab = await CollaborationHelper.compactHash(sUrlForTab, []);
+        const sStageViewHash = sShortURLTab.url.split("sap-url-hash=")[1];
+
+        if (sStageViewHash) {
+            sModifiedUrl += `,${sStageViewHash}`;
+        } else {
+            sUrlForTab = await this._modifyUrlForShareAsTab(sModifiedUrl, "MST:C");
+            sModifiedUrl = await this._addNavmodeInUrl(sUrlForTab, 'inplace');
         }
+
+        return sModifiedUrl;
     };
 
-    TeamsHelperService.prototype._closeBusyDialogAndOpenTeamsDialog = function(sUrl, oParams, response) {
-        this._closeBusyDailog();
-        var newWindow = window.open(
+    /**
+     * Closes and destroys the busy dialog, and clears timeout.
+     */
+    TeamsHelperService.prototype._closeBusyDialog = function() {
+        if (oBusyDialog) {
+            oBusyDialog.close();
+            oBusyDialog.destroy();
+            clearTimeout(iBusyDialogTimeoutId);
+        }
+    };
+
+    /**
+     * Closes the busy dialog and opens a new Teams dialog window with card info in the URL.
+     *
+     * @param {string} sUrl - URL with card info.
+     * @param {Object} oParams - Parameters including original URL and flags.
+     * @param {Object} oCardData - The card data containing cardId and version.
+     */
+    TeamsHelperService.prototype._closeBusyDialogAndOpenTeamsDialog = function(sUrl, oParams, oCardData) {
+        this._closeBusyDialog();
+        const newWindow = window.open(
             "",
             "_blank",
             windowWidthAndHeight
         );
         newWindow.opener = null;
-        newWindow.location = this._addCardParamsInUrl(sUrl, oParams.appTitle, response);
+        newWindow.location = this._generateShareAsCardUrl(sUrl, oParams.appTitle, oCardData);
+    };
+
+    /**
+     * Converts a wildcard pattern to a regular expression
+     * @param {string} pattern - The wildcard pattern to convert
+     * @returns {RegExp} The resulting regular expression
+     */
+    TeamsHelperService.prototype._wildcardToRegExp = function(pattern) {
+        return new RegExp('^' + pattern.split('*').map(function(part) {
+            return part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        }).join('[^.]+') + '$', 'i');
+    };
+
+    /**
+     * Checks if a given URL's domain is valid according to the validDomains list
+     * @param {string} url - The URL to check
+     * @returns {boolean} True if the domain is valid, false otherwise
+     */
+    TeamsHelperService.prototype._isValidDomain = function(url) {
+        try {
+            const domain = new URL(url).hostname;
+            return validDomains.some((pattern) =>
+                this._wildcardToRegExp(pattern).test(domain)
+            );
+        } catch (e) {
+            return false;
+        }
+    };
+
+    /**
+     * Generates the card info URL based on the provided parameters.
+     *
+     * @param {string} sUrl - The base URL to be processed.
+     * @param {Object} oParams - An object containing additional parameters.
+     * @param {string} oParams.appTitle - The title of the application.
+     * @param {Object} oCardData - The card data object.
+     * @returns {string} The processed URL with card info parameters.
+     */
+    TeamsHelperService.prototype._getCardInfoUrl = function(sUrl, oParams, oCardData) {
+        const isValid = this._isValidDomain(sUrl);
+        const sAppTitle = oParams?.appTitle;
+        if (isValid) {
+            return this._generateCardUnfurlingUrl(sUrl, oCardData, { appTitle: sAppTitle });
+        } else {
+            return this._generateShareAsCardUrl(sUrl, sAppTitle, oCardData);
+        }
     };
 
-    TeamsHelperService.prototype._addCardParamsInUrl = function(sUrl, sAppTitle, response) {
-		var aInfoField = [
-			response.cardId || "",
-			response.version || "",
-			encodeURIComponent(sAppTitle)
-		].filter(Boolean);
-		sUrl += `&${PARAM_SAP_CARD_INFO}=${aInfoField.join(",")}`;
-        const encodeUrl = encodeURIComponent(sUrl);
+    /**
+     * Generates the full shareable Teams URL with card info.
+     *
+     * @param {string} sUrl - The card URL.
+     * @param {string} sAppTitle - The application title.
+     * @param {Object} oCardData - The card data containing cardId and version.
+     * @returns {string} Teams shareable URL.
+     */
+    TeamsHelperService.prototype._generateShareAsCardUrl = function(sUrl, sAppTitle, oCardData) {
+        const sCardInfoUrl = this._generateCardUnfurlingUrl(sUrl, oCardData, { appTitle: sAppTitle });
+
 		// add the domain prefix to solve link unfurling issue for systems with different domain patterns
-		return `${this._providerConfig.shareAsLinkUrl}?href=${encodeURIComponent(CARD_URL_PREFIX + encodeUrl)}`;
+		return `${this._providerConfig.shareAsLinkUrl}?href=${encodeURIComponent(CARD_URL_PREFIX + encodeURIComponent(sCardInfoUrl))}`;
     };
 
-    TeamsHelperService.prototype._getShareAsTabUrl = function () {
+    /**
+     * Generates the unfurling URL with card info.
+     * Appends the SAP card info parameters (cardId, version, appTitle) to the given URL.
+     *
+     * @param {string} cardUrl - The base card URL to which the parameter will be appended.
+     * @param {Object} oCardData - The card data object containing cardId and version.
+     * @param {Object} oParams - The parameter object containing appTitle.
+     * @returns {string} The updated URL with the appended sap-card-info query parameter.
+     */
+    TeamsHelperService.prototype._generateCardUnfurlingUrl = function(cardUrl, oCardData, oParams) {
+        const infoFields = [
+            oCardData.cardId || "",
+            oCardData.version || "",
+            encodeURIComponent(oParams.appTitle || "")
+        ].filter(Boolean);
+
+        return `${cardUrl}&${PARAM_SAP_CARD_INFO}=${infoFields.join(",")}`;
+    };
+
+    TeamsHelperService.prototype._getShareAsTabUrl = function() {
         return this._getApplicationID().then(function(sTeamsAppID) {
             return "https://teams.microsoft.com/l/entity/" + sTeamsAppID + "/tab";
         });
     };
 
-    TeamsHelperService.prototype._getApplicationID = function () {
+    TeamsHelperService.prototype._getApplicationID = function() {
         const UshellContainer = sap.ui.require("sap/ushell/Container");
         return UshellContainer && UshellContainer.getServiceAsync("URLParsing").then(function(oURLParsing) {
-            return CollaborationHelper._getCurrentUrl().then(function (sCurrentUrl) {
+            return CollaborationHelper._getCurrentUrl().then(function(sCurrentUrl) {
                 var sBeforeHashURL = sCurrentUrl.split("#")[0];
                 if (sBeforeHashURL.indexOf('?') !== -1) {
                     var oParsedUrl = oURLParsing && oURLParsing.parseParameters(sBeforeHashURL.substring(sBeforeHashURL.indexOf('?')));
@@ -509,7 +654,7 @@ sap.ui.define([
      * @returns {boolean} If set to true, Adaptive Card Generation is enabled
      * @private
      */
-    TeamsHelperService.prototype.isFeatureFlagEnabled = function () {
+    TeamsHelperService.prototype.isFeatureFlagEnabled = function() {
         const bIsShareAsCardEnabled = this._providerConfig.isShareAsCardEnabled;
         return bIsShareAsCardEnabled === "AUTHENABLE";
     };
@@ -521,7 +666,7 @@ sap.ui.define([
      * @private
      */
 
-    TeamsHelperService.prototype.isContactsCollaborationSupported = function () {
+    TeamsHelperService.prototype.isContactsCollaborationSupported = function() {
         return true;
     };
 
@@ -534,7 +679,7 @@ sap.ui.define([
      * @private
      */
 
-    TeamsHelperService.prototype.enableContactsCollaboration = async function (sEmail, oParams) {
+    TeamsHelperService.prototype.enableContactsCollaboration = async function(sEmail, oParams) {
         const isTeamMode = await CollaborationHelper.isTeamsModeActive();
         const isContactServiceAvailable = await CollaborationContactInfoHelper.fetchServiceStatus();
         if (sEmail && isContactServiceAvailable.value && isContactServiceAvailable.value && isContactServiceAvailable.value[0].FetchContacts === "Active") {
@@ -563,7 +708,7 @@ sap.ui.define([
      * @private
      */
 
-    TeamsHelperService.prototype.getTeamsContactCollabOptions = async function () {
+    TeamsHelperService.prototype.getTeamsContactCollabOptions = async function() {
         const isTeamMode = await CollaborationHelper.isTeamsModeActive();
         if (isTeamMode || this._providerConfig.isDirectCommunicationEnabled !== "ENABLED") {
             return Promise.reject();
@@ -581,7 +726,7 @@ sap.ui.define([
      * @private
      */
 
-    TeamsHelperService.prototype.getTeamsContactStatus = async function (sEmail) {
+    TeamsHelperService.prototype.getTeamsContactStatus = async function(sEmail) {
         const isTeamMode = await CollaborationHelper.isTeamsModeActive();
         if (isTeamMode) {
             return Promise.reject();
@@ -592,25 +737,24 @@ sap.ui.define([
         return this.oContactHelper.getTeamsContactStatus(sEmail);
     };
 
-
-
     /**
      * Opens a Popup that helps to share content to teams, mail.
      * @param { object } oParams Optional argument in case consumer wants to influence the options, otherwise pass as undefined
      * @param { object } oData Title and data to share
      * @param { string } oSource The source to which the popover is rendered.
      * @param { boolean } isLink Indicates the data is a URL or not.
+     * @param { object } oCollaborationOptionsConfig Configuration options for collaboration (e.g., shareToTeams, shareToEmail, shareToCM).
      *
      */
     TeamsHelperService.prototype.getCollaborationPopover = function(oParams, oData, oSource, isLink, oCollaborationOptionsConfig) {
         if (oData.data === undefined || oData.data.trim() === "") {
-			oLogger.error("Popover cannnot be opened without data");
-			return;
-		}
+            oLogger.error("Popover cannnot be opened without data");
+            return;
+        }
         var oTeamsParams = {
             isShareAsLinkEnabled: (oParams && typeof oParams.isShareAsLinkEnabled !== 'undefined') ? oParams.isShareAsLinkEnabled : true
         };
-        var oCollaborationOptionsConfig = {
+        var oCollaborationOptionsCfg = {
             shareToTeams: oCollaborationOptionsConfig && typeof oCollaborationOptionsConfig.shareToTeams !== "undefined" ? oCollaborationOptionsConfig.shareToTeams : true,
             shareToEmail: oCollaborationOptionsConfig && typeof oCollaborationOptionsConfig.shareToEmail !== "undefined" ? oCollaborationOptionsConfig.shareToEmail : true,
             shareToCM: oCollaborationOptionsConfig && typeof oCollaborationOptionsConfig.shareToCM !== "undefined" ? oCollaborationOptionsConfig.shareToCM : false
@@ -618,7 +762,7 @@ sap.ui.define([
         var aOptions = [];
         if (Device.system.desktop) {
             if (oTeamsParams.isShareAsLinkEnabled) {
-                if (this._providerConfig.isShareAsLinkEnabled === "X" && oCollaborationOptionsConfig.shareToTeams) {
+                if (this._providerConfig.isShareAsLinkEnabled === "X" && oCollaborationOptionsCfg.shareToTeams) {
                     aOptions.push({
                         "text": oResourceBundle.getText("COLLABORATION_POPOVER_TEAMS"),
                         "icon": "sap-icon://discussion",
@@ -634,7 +778,7 @@ sap.ui.define([
         } else {
             oLogger.info("Share as Chat option is not supported in Phone and Tablet");
         }
-        if (oCollaborationOptionsConfig.shareToEmail) {
+        if (oCollaborationOptionsCfg.shareToEmail) {
             aOptions.push({
                 "text": oResourceBundle.getText("COLLABORATION_POPOVER_MAIL"),
                 "icon": "sap-icon://email",
@@ -643,7 +787,7 @@ sap.ui.define([
         }
         this.oCollaborationManager = new CollaborationManagerService();
         var oCMOption = this.oCollaborationManager.getOptions();
-        if (oCMOption && oCollaborationOptionsConfig.shareToCM) {
+        if (oCMOption && oCollaborationOptionsCfg.shareToCM) {
             aOptions.push({
                 "text": oCMOption.text,
                 "icon": oCMOption.icon,
@@ -663,9 +807,9 @@ sap.ui.define([
      * @param { object } oData Title and data to share
      * @param { array } aOptions Array of available options
      * @param { boolean } isLink Indicates the data is a URL or not.
-     * @returns Returns the final Popover to the control.
+     * @returns {sap.m.Popover} Returns the final Popover to the control.
      */
-    TeamsHelperService.prototype._getPopover = function(oData,aOptions,isLink) {
+    TeamsHelperService.prototype._getPopover = function(oData, aOptions, isLink) {
         var oCollaborationPopover = new Popover({
             showHeader: false,
             placement: oData.placement ? oData.placement : "Auto",
@@ -681,10 +825,11 @@ sap.ui.define([
      * @param { object } oData Title and data to share
      * @param { array } aOptions Array of available options
      * @param { boolean } isLink Indicates the data is a URL or not.
+     * @returns {sap.m.FlexBox} Returns the FlexBox containing the popover content.
      */
     TeamsHelperService.prototype._getPopoverContent = function(oData, aOptions, isLink) {
         var oMainFBox = new FlexBox({
-            items:[],
+            items: [],
             direction: sapMLibrary.FlexDirection.Column
         });
         var oOptionFBox = new FlexBox({
@@ -694,8 +839,8 @@ sap.ui.define([
         });
         aOptions.forEach((oOption) => {
             var button = new Button({
-                text:oOption.text,
-                icon:oOption.icon,
+                text: oOption.text,
+                icon: oOption.icon,
                 width: oData.sFormat === "Horizontal" && aOptions.length === 3 ? "120px" : "180px",
                 press: (oEvent) => {
                     oEvent.getSource().getParent().getParent().getParent().close();
@@ -722,7 +867,7 @@ sap.ui.define([
                     new Button({
                         text: oResourceBundle.getText("COLLABORATION_POPOVER_COPYURL_BUTTON"),
                         width: oData.sFormat === "Vertical" ? "150px" : "",
-                        press: async() => {
+                        press: async () => {
                             await this._writeToClipBoard(oData.data);
                         }
                     }).addStyleClass("sapUiTinyMarginBeginEnd")
@@ -756,13 +901,13 @@ sap.ui.define([
      * @param { text } sText Text to copy to the cilpboard
      * Writes the given URL to the clipboard
      */
-    TeamsHelperService.prototype._writeToClipBoard = async function (sText) {
+    TeamsHelperService.prototype._writeToClipBoard = async function(sText) {
         try {
-            await navigator.clipboard.writeText(sText);
+            await window.navigator.clipboard.writeText(sText);
         } catch (e) {
             oLogger.info(e);
         }
-    }
+    };
 
     /**
      *
@@ -773,23 +918,23 @@ sap.ui.define([
     TeamsHelperService.prototype._shareData = function(oData, oOption, isLink) {
         if (oOption.key === "COLLABORATION_POPOVER_TEAMS") {
             if (isLink) {
-                var oShareData = {
+                var oShareDataLink = {
                     url: oData.data,
                     appTitle: oData.title ? oData.title : "",
                     subTitle: "",
                     minifyUrlForChat: true
                 };
-                this._shareAsChat(oShareData);
+                this._shareAsChat(oShareDataLink);
             } else {
-                var oShareData = {
+                var oShareDataSummary = {
                     appTitle: oData.title ? oData.title : "",
                     message: oData.data,
                     showPreview: typeof oData.showPreview !== "undefined" ? oData.showPreview : true
                 };
-                this._shareSummary(oShareData);
+                this._shareSummary(oShareDataSummary);
             }
         } else if (oOption.key === "COLLABORATION_POPOVER_MAIL") {
-            sap.m.URLHelper.triggerEmail(null, oData.title && oData.title.trim() !== "" ? oData.title: null, oData.data);
+            sap.m.URLHelper.triggerEmail(null, oData.title && oData.title.trim() !== "" ? oData.title : null, oData.data);
         } else if (oOption.key === "COLLABORATION_POPOVER_CM") {
             this.oCollaborationManager.triggerH2HChat(oData.title, oData.data);
         }
@@ -813,5 +958,156 @@ sap.ui.define([
         sap.m.URLHelper.redirect(sURL, true);
 
     };
+
+    /**
+     * Shares the current or unfurled URL via email.
+     * @param {Object} oParams - Parameters for sharing.
+     * @param {string} [oParams.url] - The base URL to share.
+     * @param {string} [oParams.appTitle] - The subject of the email.
+     * @returns {Promise<void>} A promise that resolves when the email sharing process is complete.
+     */
+    TeamsHelperService.prototype._shareToEmail = async function (oParams) {
+        let sUnfurlingUrl = oParams?.url || window.location.href;
+        try {
+            sUnfurlingUrl = await this._getUnfurlingUrl(oParams);
+        } catch (error) {
+            oLogger.error("getUnfurlingUrl failed: " + error.message);
+        }
+
+        const sSubject = oParams?.appTitle?.trim() ? oParams.appTitle : null;
+        sap.m.URLHelper.triggerEmail(null, sSubject, sUnfurlingUrl);
+    };
+
+    /**
+     * Shares a card from the collaboration bar.
+     * @param {Object} params - Parameters for sharing the card.
+     */
+    TeamsHelperService.prototype._shareAsChatFromCollabBar = async function (params) {
+        try {
+            await this._shareAsCard(params);
+        } catch (error) {
+            oLogger.error("Failed to share card from collaboration bar: " + error.message);
+        }
+    };
+
+    /**
+     * Copies the unfurled card URL to the clipboard.
+     * @param {Object} oParams - Parameters for sharing.
+     * @param {string} [oParams.url] - The base URL to copy.
+     * @returns {Promise<void>} A promise that resolves when the URL has been copied to the clipboard.
+     */
+    TeamsHelperService.prototype._copyLink = async function (oParams) {
+        let sUnfurlingUrl = oParams?.url || window.location.href;
+        try {
+            sUnfurlingUrl = await this._getUnfurlingUrl(oParams);
+        } catch (error) {
+            oLogger.error("getUnfurlingUrl failed: " + error.message);
+        }
+
+        this._copyCardUrlToClipboard(sUnfurlingUrl);
+    };
+
+    /**
+     * Copies a given URL string into the clipboard.
+     * @param {string} sUrl - The URL to copy into the clipboard.
+     * @returns {Promise<void>} A promise that resolves when the URL has been copied to the clipboard.
+     */
+    TeamsHelperService.prototype._copyCardUrlToClipboard = async function(sUrl) {
+        try {
+            if (typeof window.navigator !== "undefined" &&
+                window.navigator.clipboard &&
+                typeof window.navigator.clipboard.writeText === "function") {
+                try {
+                    await window.navigator.clipboard.writeText(sUrl);
+                    oLogger.info("Card URL copied to clipboard successfully.");
+                    sap.m.MessageToast.show(oResourceBundle.getText("COLLABORATION_POPOVER_MSGSTRIP_SUCCESS"));
+                } catch (e) {
+                    oLogger.error("Clipboard write failed: " + e.message);
+                }
+            } else {
+                oLogger.error("Clipboard API is not available.");
+            }
+
+        } catch (err) {
+            oLogger.error("Failed to generate or copy Card URL", err);
+        }
+    };
+
+    /**
+     * Gets the unfurling URL for a card.
+     * If cardId and cardManifest are provided, saves the card data and shows a busy dialog.
+     * Otherwise, returns a base unfurling URL.
+     * @param {Object} oParams - Parameters for the card.
+     * @param {string} [oParams.url] - Base URL for the card.
+     * @param {string} [oParams.cardId] - The card ID.
+     * @param {Object} [oParams.cardManifest] - The card manifest definition.
+     * @returns {Promise<string>} The unfurling URL.
+     */
+    TeamsHelperService.prototype._getUnfurlingUrl = async function(oParams) {
+        if (!oParams?.cardId || !oParams.cardId.length || !oParams.cardManifest || !this.isFeatureFlagEnabled()) {
+            // Base Card to unfurl
+            return this._generateUnfurlingUrl(oParams, {});
+        }
+
+        let sUnfurlingUrl = "";
+        let oCardData = {};
+        try {
+            // Card Id and Card Manifest Passed. It will show busy helper and store card into DB.
+            try {
+                const oDialog = await Fragment.load({
+                    name: "sap.suite.ui.commons.collaboration.CollaborationBusyDialog",
+                    controller: this,
+                    type: "XML"
+                });
+                oBusyDialog = oDialog;
+                oBusyDialog.open();
+
+                // Automatically close the dialog after a fixed time
+                iBusyDialogTimeoutId = setTimeout(() => {
+                    oBusyDialog.close();
+                    oBusyDialog.destroy();
+                }, AUTO_CLOSE_BUSY_DIALOG_TIME);
+            } catch (err) {
+                oLogger.error("Fragment load failed: " + err.message);
+            }
+
+            oCardData = await this._buildCardInfo(oParams);
+        } catch (err) {
+            oLogger.error("buildCardInfo failed: " + err.message);
+        } finally {
+            if (oCardData && Object.keys(oCardData).length === 0) {
+                oLogger.warn("Card info could not be saved.");
+            }
+
+            // Auth/Base card to unfurl
+            sUnfurlingUrl = this._generateUnfurlingUrl(oParams, oCardData);
+            this._closeBusyDialog();
+        }
+
+        return sUnfurlingUrl;
+    };
+
+    /**
+     * Generates a URL for unfurling a card in Microsoft Teams.
+     * Handles minification, share-as-tab logic, and adds navigation modes.
+     * @param {Object} oParams - Parameters for the card.
+     * @param {Object} oCardData - The card data (id, version, etc.).
+     * @returns {Promise<string>} The generated unfurling URL.
+     */
+    TeamsHelperService.prototype._generateUnfurlingUrl = async function(oParams, oCardData) {
+        let sModifiedUrl = oParams?.url || window.location.href;
+        try {
+            if (oParams?.minifyUrlForChat) {
+                sModifiedUrl = await this._getModifiedUrlForSharing(oParams);
+            } else if (oTeamsParams.isShareAsTabEnabled && this._providerConfig.isShareAsTabEnabled) {
+                const sUrlForTab = await this._modifyUrlForShareAsTab(sModifiedUrl, "MST:C");
+                sModifiedUrl = await this._addNavmodeInUrl(sUrlForTab, 'inplace');
+            }
+        } catch (error) {
+            oLogger.error("Error while modifying URL for sharing: " + error.message);
+        }
+        return this._getCardInfoUrl(sModifiedUrl, oParams, oCardData);
+    };
+
     return TeamsHelperService;
 });