@sapui5/sap.ushell 1.140.0 → 1.141.0

package/src/main/js/sap/ushell/services/DarkModeSupport.js

@@ -26,7 +26,7 @@
  * disables dark mode automatic, the currently active theme remains selected. In the settings dialog,
  * the selected entry switches, for example, from ABC set to the (current) ABC High Contrast Light.
  *
- * @version 1.140.0
+ * @version 1.141.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/EndUserFeedback.js

@@ -66,8 +66,8 @@ sap.ui.define([
          * @public
          * @deprecated since 1.93
          */
-        this.isEnabled = function () {
-            return Promise.reject();
+        this.isEnabled = async function () {
+            throw new Error("EndUserFeedback service is deprecated and therefore always disabled.");
         };
 
         /**

package/src/main/js/sap/ushell/services/Extension/Item.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview Defines a generic interface for extension items in ShellAreas.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/Extension.js

@@ -5,7 +5,7 @@
  * This files exposes an API to extend the launchpad with new elements.
  * It is exposed publicly and meant to be used by apps and plugins.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/FlpLaunchPage.js

@@ -4,7 +4,7 @@
  * @file The Unified Shell's page builder service providing the data for the Fiori launchpad's classic Homepage.
  * This is the privately used subset of the previously deprecated public LaunchPage service API
  * @private
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -128,32 +128,38 @@ sap.ui.define([
         this.getGroupsForBookmarks = function (bGetAll) {
             const oDeferred = new jQuery.Deferred();
 
-            this.getGroups().then((aGroups) => {
-                this.getDefaultGroup().then((oDefaultGroup) => {
-                    if (aGroups.length > 0) {
-                        aGroups = aGroups.filter((group) => {
-                            if (bGetAll === true) {
-                                return this.isGroupVisible(group);
+            this.getGroups()
+                .then((aGroups) => {
+                    this.getDefaultGroup()
+                        .then((oDefaultGroup) => {
+                            if (aGroups.length > 0) {
+                                aGroups = aGroups.filter((group) => {
+                                    if (bGetAll === true) {
+                                        return this.isGroupVisible(group);
+                                    }
+                                    return !this.isGroupLocked(group) && this.isGroupVisible(group);
+                                });
+
+                                // create the model structure
+                                aGroups = aGroups.map((group) => {
+                                    return {
+                                        title: (group === oDefaultGroup && resources.i18n.getText("my_group")) || this.getGroupTitle(group),
+                                        object: group
+                                    };
+                                });
                             }
-                            return !this.isGroupLocked(group) && this.isGroupVisible(group);
-                        });
 
-                        // create the model structure
-                        aGroups = aGroups.map((group) => {
-                            return {
-                                title: (group === oDefaultGroup && resources.i18n.getText("my_group")) || this.getGroupTitle(group),
-                                object: group
-                            };
+                            oDeferred.resolve(aGroups);
+                        })
+                        .catch((oError) => {
+                            Log.error(`getGroupsForBookmarks - getDefaultGroup - failed: ${oError.message}`);
+                            oDeferred.reject(oError);
                         });
-                    }
-
-                    oDeferred.resolve(aGroups);
-                }, (oError) => {
-                    Log.error(`getGroupsForBookmarks - getDefaultGroup - failed: ${oError.message}`);
+                })
+                .catch((oError) => {
+                    Log.error(`getGroupsForBookmarks - getGroups - failed: ${oError.message}`);
+                    oDeferred.reject(oError);
                 });
-            }, (oError) => {
-                Log.error(`getGroupsForBookmarks - getGroups - failed: ${oError.message}`);
-            });
 
             return oDeferred.promise();
         };
@@ -344,9 +350,9 @@ sap.ui.define([
                     movePromise.fail(oDeferred.reject);
                 });
 
-                oPromise.fail(() => {
-                    Log.error(`addGroup ${sTitle} failed`);
-                    oDeferred.reject();
+                oPromise.fail((oError) => {
+                    Log.error(`addGroup ${sTitle} failed`, oError);
+                    oDeferred.reject(oError);
                 });
 
                 return oDeferred.promise();
@@ -526,13 +532,13 @@ sap.ui.define([
             const oDeferred = new jQuery.Deferred();
             const oAdapter = this._getAdapter();
             if (typeof oAdapter.hideGroups !== "function") {
-                oDeferred.reject("hideGroups() is not implemented in the Adapter.");
+                oDeferred.reject(new Error("hideGroups() is not implemented in the Adapter."));
             } else {
                 oAdapter.hideGroups(aHiddenGroupsIDs).done(() => {
                     oDeferred.resolve();
-                }).fail((sMsg) => {
-                    Log.error(`Fail to store groups visibility.${sMsg}`);
-                    oDeferred.reject();
+                }).fail((oError) => {
+                    Log.error("Fail to store groups visibility", oError);
+                    oDeferred.reject(oError);
                 });
             }
             return oDeferred.promise();
@@ -601,9 +607,9 @@ sap.ui.define([
 
                             oDeferred.resolve();
                         })
-                        .fail((error) => {
-                            Log.error(`Fail to remove Tile: ${this.getTileId(oTile)}`);
-                            oDeferred.reject(error);
+                        .fail((oError) => {
+                            Log.error(`Fail to remove Tile: ${this.getTileId(oTile)}`, oError);
+                            oDeferred.reject(oError);
                         });
                 })
                 .catch(oDeferred.reject);
@@ -1335,16 +1341,15 @@ sap.ui.define([
                 if (oGroup && this.isGroupLocked(oGroup)) {
                     const sMessage = `Tile cannot be added, target group (${this.getGroupTitle(oGroup)})is locked!`;
                     Log.error(sMessage);
-                    return oDeferred.reject(sMessage);
+                    return oDeferred.reject(new Error(sMessage));
                 }
 
                 const sAdapterName = oGroup && oGroup.contentProvider;
                 this._getAdapter(sAdapterName).addBookmark(oParameters, oGroup, sContentProviderId)
                     .done(oDeferred.resolve)
-                    .fail(() => {
-                        Log.error(`Fail to add bookmark for URL: ${
-                            oParameters.url} and Title: ${oParameters.title}`);
-                        oDeferred.reject();
+                    .fail((oError) => {
+                        Log.error(`Fail to add bookmark for URL: ${oParameters.url} and Title: ${oParameters.title}`, oError);
+                        oDeferred.reject(oError);
                     });
             }
             return oDeferred.promise();
@@ -1393,16 +1398,15 @@ sap.ui.define([
                 if (oGroup && this.isGroupLocked(oGroup)) {
                     const sMessage = `Tile cannot be added, target group (${this.getGroupTitle(oGroup)})is locked!`;
                     Log.error(sMessage);
-                    return oDeferred.reject(sMessage);
+                    return oDeferred.reject(new Error(sMessage));
                 }
 
                 const sAdapterName = oGroup && oGroup.contentProvider;
                 this._getAdapter(sAdapterName).addCustomBookmark(oBookmarkConfig, oGroup, sContentProviderId)
                     .done(oDeferred.resolve)
-                    .fail(() => {
-                        Log.error(`Fail to add bookmark for URL: ${
-                            oBookmarkConfig.url} and Title: ${oBookmarkConfig.title}`);
-                        oDeferred.reject();
+                    .fail((oError) => {
+                        Log.error(`Fail to add bookmark for URL: ${oBookmarkConfig.url} and Title: ${oBookmarkConfig.title}`, oError);
+                        oDeferred.reject(oError);
                     });
             }
             return oDeferred.promise();
@@ -1481,9 +1485,9 @@ sap.ui.define([
          *
          * @private
          */
-        this.countCustomBookmarks = function (oIdentifier) {
+        this.countCustomBookmarks = async function (oIdentifier) {
             if (!oIdentifier.url || !oIdentifier.vizType) {
-                return Promise.reject("countCustomBookmarks: Some required parameters are missing.");
+                throw new Error("countCustomBookmarks: Some required parameters are missing.");
             }
             return this._getAdapter().countCustomBookmarks(oIdentifier);
         };
@@ -1515,10 +1519,10 @@ sap.ui.define([
 
                             oDeferred.resolve(iCount);
                         })
-                        .fail((error) => {
-                            Log.error(`Fail to delete bookmark for: ${sUrl}`);
+                        .fail((oError) => {
+                            Log.error(`Fail to delete bookmark for: ${sUrl}`, oError);
 
-                            oDeferred.reject(error);
+                            oDeferred.reject(oError);
                         });
                 })
                 .catch(oDeferred.reject);
@@ -1550,9 +1554,9 @@ sap.ui.define([
          *
          * @private
          */
-        this.deleteCustomBookmarks = function (oIdentifier) {
+        this.deleteCustomBookmarks = async function (oIdentifier) {
             if (!oIdentifier.url || !oIdentifier.vizType) {
-                return Promise.reject("deleteCustomBookmarks: Some required parameters are missing.");
+                throw new Error("deleteCustomBookmarks: Some required parameters are missing.");
             }
             return this._getAdapter().deleteCustomBookmarks(oIdentifier);
         };
@@ -1585,9 +1589,9 @@ sap.ui.define([
             const oPromise = new jQuery.Deferred();
             this._getAdapter().updateBookmarks(sUrl, oParameters, undefined, sContentProviderId)
                 .done(oPromise.resolve)
-                .fail(() => {
-                    Log.error(`Fail to update bookmark for: ${sUrl}`);
-                    oPromise.reject();
+                .fail((oError) => {
+                    Log.error(`Fail to update bookmark for: ${sUrl}`, oError);
+                    oPromise.reject(oError);
                 });
 
             return oPromise.promise();
@@ -1641,9 +1645,9 @@ sap.ui.define([
          *
          * @private
          */
-        this.updateCustomBookmarks = function (oIdentifier, oBookmarkConfig) {
+        this.updateCustomBookmarks = async function (oIdentifier, oBookmarkConfig) {
             if (!oIdentifier.url || !oIdentifier.vizType || !oBookmarkConfig) {
-                return Promise.reject("updateCustomBookmarks: Some required parameters are missing.");
+                throw new Error("updateCustomBookmarks: Some required parameters are missing.");
             }
             return this._getAdapter().updateCustomBookmarks(oIdentifier, oBookmarkConfig);
         };
@@ -1717,8 +1721,8 @@ sap.ui.define([
                             }
                         });
                     }
-                } catch (e) {
-                    Log.error("error in deleting persistent state when bookmark is deleted", e, "sap.ushell.services.LaunchPage");
+                } catch (oError) {
+                    Log.error("error in deleting persistent state when bookmark is deleted", oError, "sap.ushell.services.LaunchPage");
                 }
             }
         };

package/src/main/js/sap/ushell/services/FrameBoundExtension/FloatingContainer.js

@@ -5,7 +5,7 @@
  *
  * This interface does NOT work when called from within a iframe.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/ui/base/ManagedObject",

package/src/main/js/sap/ushell/services/FrameBoundExtension/Footer.js

@@ -5,7 +5,7 @@
  *
  * This interface does NOT work when called from within a iframe.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/ushell/Container"

package/src/main/js/sap/ushell/services/FrameBoundExtension/Item.js

@@ -5,7 +5,7 @@
  *
  * This interface does NOT work when called from within a iframe.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/FrameBoundExtension/SidePane.js

@@ -5,7 +5,7 @@
  *
  * This interface does NOT work when called from within a iframe.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/ui/core/Element",

package/src/main/js/sap/ushell/services/FrameBoundExtension/ToolArea.js

@@ -5,7 +5,7 @@
  *
  * This interface does NOT work when called from within a iframe.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/ui/core/Element",

package/src/main/js/sap/ushell/services/FrameBoundExtension/UserSettingsEntry.js

@@ -5,7 +5,7 @@
  *
  * This interface does NOT work when called from within a iframe.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/ushell/EventHub"

package/src/main/js/sap/ushell/services/FrameBoundExtension.js

@@ -8,7 +8,7 @@
  * This service can only be called from the outer shell and is not available
  * in the inner shell or via post message API.
  *
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/ui/core/Element",

package/src/main/js/sap/ushell/services/LaunchPage.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileoverview The Unified Shell's page builder service providing the data for the Fiori launchpad's classic Homepage.
- * @version 1.140.0
+ * @version 1.141.0
  * @deprecated since 1.120
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/Menu.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The menu service provides the entries for the menu bar
- * @version 1.140.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/ushell/Config",
@@ -866,7 +866,7 @@ sap.ui.define([
     Menu.prototype.getEntryProvider = async function (pluginName, nodeIds) {
         if (this._isManagerBlocked(pluginName)) {
             Log.error(`ManagerId '${pluginName}' is already listed as an entry manager.`);
-            return Promise.reject(`ManagerId ${pluginName} is already listed as an entry manager.`);
+            throw new Error(`ManagerId ${pluginName} is already listed as an entry manager.`);
         }
         this._setManagerBlocked(pluginName);
         const oModel = await this.getMenuModel();

package/src/main/js/sap/ushell/services/Message.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's message service.
- * @version 1.140.0
+ * @version 1.141.0
  * @deprecated since 1.120
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/MessageBroker/ClientAlias.js

@@ -0,0 +1,37 @@
+// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+
+sap.ui.define([
+], (
+) => {
+    "use strict";
+
+    /**
+     * @alias sap.ushell.services.MessageBroker.ClientAlias
+     * @enum {string}
+     *
+     * @since 1.110.0
+     * @private
+     * @ui5-restricted SAP internally public
+     */
+    const ClientAlias = {
+        /**
+         * Wildcard '*' which refers to all clients in a channel
+         *
+         * @since 1.110.0
+         * @private
+         * @ui5-restricted SAP internally public
+         */
+        AllClients: "*",
+
+        /**
+         * The FLP client
+         *
+         * @since 1.141.0
+         * @private
+         * @ui5-restricted SAP internally public
+         */
+        FLP: "FLP"
+    };
+
+    return ClientAlias;
+});

package/src/main/js/sap/ushell/services/MessageBroker/ClientConnectionMessage.js

@@ -0,0 +1,37 @@
+// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+
+sap.ui.define([
+], (
+) => {
+    "use strict";
+
+    /**
+     * @alias sap.ushell.services.MessageBroker.ClientConnectionMessage
+     * @enum {string}
+     *
+     * @since 1.110.0
+     * @private
+     * @ui5-restricted SAP internally public
+     */
+    const ClientConnectionMessage = {
+        /**
+         * Emitted when a client subscribes to a channel.
+         *
+         * @since 1.110.0
+         * @private
+         * @ui5-restricted SAP internally public
+         */
+        ClientSubscribed: "clientSubscribed",
+
+        /**
+         * Emitted when a client unsubscribes from a channel.
+         *
+         * @since 1.110.0
+         * @private
+         * @ui5-restricted SAP internally public
+         */
+        ClientUnsubscribed: "clientUnsubscribed"
+    };
+
+    return ClientConnectionMessage;
+});