@sapui5/sap.fe.core 1.99.0 → 1.101.1

package/src/sap/fe/core/actions/collaboration/ActivitySync.ts

@@ -0,0 +1,362 @@
+import Log from "sap/base/Log";
+import UriParameters from "sap/base/util/UriParameters";
+import { Activity, CollaborationUtils, Message, User, UserActivity } from "sap/fe/core/actions/collaboration/CollaborationCommon";
+import MessageBox from "sap/m/MessageBox";
+import Event from "sap/ui/base/Event";
+import Control from "sap/ui/core/Control";
+import View from "sap/ui/core/mvc/View";
+import SapPcpWebSocket from "sap/ui/core/ws/SapPcpWebSocket";
+import Context from "sap/ui/model/odata/v4/Context";
+import ODataMetaModel from "sap/ui/model/odata/v4/ODataMetaModel";
+
+const CONNECTED = "/collaboration/connected";
+const CONNECTION = "/collaboration/connection";
+const MYACTIVITY = "/collaboration/myActivity";
+const ACTIVEUSERS = "/collaboration/activeUsers";
+const ACTIVITIES = "/collaboration/activities";
+
+export const isConnected = function (control: Control): boolean {
+	return !!control.getModel("internal").getProperty(CONNECTED);
+};
+
+export const send = function (control: Control, action: Activity, content: string | string[] | Context | Context[] | undefined) {
+	if (isConnected(control)) {
+		const contentArray = Array.isArray(content) ? content : [content];
+		let clientContent: string = "";
+		contentArray.forEach(function (c) {
+			if (c) {
+				clientContent += clientContent ? "|" : "";
+				clientContent += typeof c === "string" ? c : c.getPath();
+			}
+		});
+
+		const internalModel = control.getModel("internal") as any;
+		const webSocket = internalModel.getProperty(CONNECTION) as SapPcpWebSocket;
+
+		if (action === Activity.LiveChange) {
+			// To avoid unnecessary traffic we keep track of live changes and send it only once
+			const myActivity = internalModel.getProperty(MYACTIVITY);
+			if (myActivity === clientContent) {
+				return;
+			} else {
+				internalModel.setProperty(MYACTIVITY, clientContent);
+			}
+		} else {
+			// user finished the activity
+			internalModel.setProperty(MYACTIVITY, null);
+		}
+
+		webSocket.send("", {
+			clientAction: action,
+			clientContent: clientContent
+		});
+
+		if (action === Activity.Activate || action === Activity.Discard) {
+			disconnect(control);
+		}
+	}
+};
+
+const getWebSocketBaseURL = function (bindingContext: Context): string {
+	return bindingContext.getModel().getMetaModel().getObject("/@com.sap.vocabularies.Common.v1.WebSocketBaseURL");
+};
+
+export const isCollaborationEnabled = function (view: View): boolean {
+	const bindingContext = view?.getBindingContext && (view.getBindingContext() as Context);
+	return !!(bindingContext && getWebSocketBaseURL(bindingContext));
+};
+
+export const connect = async function (view: View) {
+	const internalModel: any = view.getModel("internal");
+	const me = CollaborationUtils.getMe(view);
+	if (internalModel.getProperty(CONNECTION)) {
+		// connection already established
+		return;
+	}
+
+	// Retrieving ME from shell service
+	if (!me) {
+		// no me = no shell = not sure what to do
+		return;
+	}
+
+	const activeUsers: any[] = [me];
+	internalModel.setProperty("/collaboration", { activeUsers: activeUsers, activities: {} });
+	const bindingContext = view.getBindingContext() as Context;
+	const webSocketBaseURL = getWebSocketBaseURL(bindingContext);
+
+	if (!webSocketBaseURL) {
+		return;
+	}
+
+	const sDraftUUID = await bindingContext.requestProperty("DraftAdministrativeData/DraftUUID");
+	if (!sDraftUUID) {
+		return;
+	}
+
+	const webSocket = establishWebSocketConnection(webSocketBaseURL, sDraftUUID, view);
+
+	webSocket.attachMessage(function (event: Event) {
+		const message: Message = event.getParameter("pcpFields");
+		messageReceive(message, view, webSocket);
+	});
+};
+
+export const disconnect = function (control: Control) {
+	const internalModel = control.getModel("internal") as any;
+	const webSocket = internalModel.getProperty(CONNECTION) as SapPcpWebSocket;
+	webSocket.close();
+	internalModel.setProperty(CONNECTION, null);
+};
+
+function establishWebSocketConnection(socketBaseURL: string, draftUUID: string, view: View) {
+	const internalModel: any = view.getModel("internal");
+	const hostLocation = window.location;
+	let socketURI;
+
+	// Support useBackendUrl for local testing
+	const useBackendUrl = UriParameters.fromQuery(window.location.search).get("useBackendUrl");
+	if (useBackendUrl) {
+		socketURI = useBackendUrl.replace("https", "wss");
+	} else {
+		socketURI = hostLocation.protocol === "https:" ? "wss:" : "ws:";
+		socketURI += "//" + hostLocation.host;
+	}
+
+	socketURI += (socketBaseURL.startsWith("/") ? "" : "/") + socketBaseURL + "?draft=" + draftUUID;
+
+	const useFLPUser = UriParameters.fromQuery(window.location.search).get("useFLPUser");
+	if (useFLPUser === "true") {
+		const me = CollaborationUtils.getMe(view);
+		socketURI += "&userID=" + encodeURI(me.id) + "&userName=" + encodeURI(me.initialName || "");
+	}
+
+	const webSocket = new SapPcpWebSocket(socketURI, ["v10.pcp.sap.com"]); // TODO: use enum
+	internalModel.setProperty(CONNECTION, webSocket);
+
+	webSocket.attachOpen(function () {
+		internalModel.setProperty(CONNECTED, true);
+	});
+
+	webSocket.attachError(function () {
+		Log.error("The connection to the websocket channel " + socketBaseURL + " could not be established");
+		internalModel.setProperty(CONNECTED, false);
+	});
+
+	webSocket.attachClose(function () {
+		internalModel.setProperty(CONNECTED, false);
+	});
+
+	return webSocket;
+}
+
+function messageReceive(message: Message, view: View, webSocket: any) {
+	const internalModel: any = view.getModel("internal");
+	let activeUsers: User[] = internalModel.getProperty(ACTIVEUSERS);
+	let activities: UserActivity[];
+	let activityKey: string;
+	const metaPath: string = message.clientContent && (view.getModel().getMetaModel() as ODataMetaModel).getMetaPath(message.clientContent);
+	message.userAction = message.userAction || message.clientAction;
+
+	const sender: User = {
+		id: message.userID,
+		name: message.userDescription,
+		initials: CollaborationUtils.formatInitials(message.userDescription),
+		color: CollaborationUtils.getUserColor(message.userID, activeUsers, [])
+	};
+
+	switch (message.userAction) {
+		case Activity.Join:
+		case Activity.JoinEcho:
+			if (activeUsers.findIndex((user) => user.id === sender.id) === -1) {
+				activeUsers.push(sender);
+				internalModel.setProperty(ACTIVEUSERS, activeUsers);
+			}
+
+			if (message.userAction === Activity.Join) {
+				// we echo our existence to the newly entered user and also send the current activity if there is any
+				webSocket.send("", {
+					clientAction: Activity.JoinEcho,
+					clientContent: internalModel.getProperty(MYACTIVITY)
+				});
+				// TODO: echo current activity
+			}
+
+			if (message.userAction === Activity.JoinEcho) {
+				if (message.clientContent) {
+					// another user was already typing therefore I want to see his activity immediately. Calling me again as a live change
+					message.userAction = Activity.LiveChange;
+					messageReceive(message, view, webSocket);
+				}
+			}
+
+			break;
+		case Activity.Leave:
+			// Removing the active user. Not removing "me" if I had the screen open in another session
+			activeUsers = activeUsers.filter((user) => user.id !== sender.id || user.me);
+			internalModel.setProperty(ACTIVEUSERS, activeUsers);
+			const allActivities = internalModel.getProperty(ACTIVITIES) || {};
+			const removeUserActivities = function (bag: any) {
+				if (Array.isArray(bag)) {
+					return bag.filter((activity) => activity.id !== sender.id);
+				} else {
+					for (const p in bag) {
+						bag[p] = removeUserActivities(bag[p]);
+					}
+					return bag;
+				}
+			};
+			removeUserActivities(allActivities);
+			internalModel.setProperty(ACTIVITIES, allActivities);
+			break;
+
+		case Activity.Change:
+			let currentActivities: any[] = internalModel.getProperty(ACTIVITIES + metaPath) || [];
+			activityKey = getActivityKey(message.clientContent);
+			currentActivities = currentActivities.filter((activity) => activity.key !== activityKey);
+			internalModel.setProperty(ACTIVITIES + metaPath, currentActivities);
+
+			update(view, message, metaPath, Activity.Change);
+			break;
+		case Activity.Create:
+			// For create we actually just need to refresh the table
+			update(view, message, metaPath, Activity.Create);
+			break;
+		case Activity.Delete:
+			// For now also refresh the page but in case of deletion we need to inform the user
+			update(view, message, metaPath, Activity.Delete);
+			break;
+		case Activity.Activate:
+			disconnect(view);
+			MessageBox.information(CollaborationUtils.getText("C_COLLABORATIONDRAFT_ACTIVATE", sender.name));
+			navigate(message.clientContent, view);
+			break;
+		case Activity.Discard:
+			disconnect(view);
+			MessageBox.information(CollaborationUtils.getText("C_COLLABORATIONDRAFT_DISCARD", sender.name));
+			navigate(message.clientContent, view);
+			break;
+		/*
+		// TODO: Action to be implemented
+		case Activity.Action:
+			// Just for test reasons show a toast - to be checked with UX
+			MessageToast.show("User " + sender.name + " has executed action " + metaPath.split("|")[0]);
+			//update(view, message, metaPath, Activity.Delete);
+			break;
+		 */
+		case Activity.LiveChange:
+			const activity: UserActivity = sender;
+			activity.key = getActivityKey(message.clientContent);
+
+			// stupid JSON model...
+			let initJSONModel: string = "";
+			const parts = metaPath.split("/");
+			for (let i = 1; i < parts.length - 1; i++) {
+				initJSONModel += "/" + parts[i];
+				if (!internalModel.getProperty(ACTIVITIES + initJSONModel)) {
+					internalModel.setProperty(ACTIVITIES + initJSONModel, {});
+				}
+			}
+
+			activities = internalModel.getProperty(ACTIVITIES + metaPath);
+			activities = activities ? activities.slice() : [];
+			activities.push(activity);
+			internalModel.setProperty(ACTIVITIES + metaPath, activities);
+			break;
+		case Activity.Undo:
+			// The user did a change but reverted it, therefore unblock the control
+			activities = internalModel.getProperty(ACTIVITIES + metaPath);
+			activityKey = getActivityKey(message.clientContent);
+			internalModel.setProperty(
+				ACTIVITIES + metaPath,
+				activities.filter((a) => a.key !== activityKey)
+			);
+			break;
+	}
+}
+
+function update(view: View, message: Message, metaPath: string, action: Activity) {
+	const appComponent = CollaborationUtils.getAppComponent(view);
+	const metaModel = view.getModel().getMetaModel() as ODataMetaModel;
+	const currentPage = getCurrentPage(view);
+	const sideEffectsService = (appComponent as any).getSideEffectsService(); // TODO: add to appcomponent
+	const currentContext = currentPage.getBindingContext();
+	const currentPath = currentContext.getPath();
+	const currentMetaPath = metaModel.getMetaPath(currentPath);
+	let changedDocument = message.clientContent;
+
+	if (action === Activity.Delete) {
+		// check if user currently displays one deleted object
+		const deletedObjects = message.clientContent.split("|");
+		if (deletedObjects.findIndex((deletedObject) => currentPath.startsWith(deletedObject)) > -1) {
+			// any other user deleted the object I'm currently looking at. Inform the user we will navigate to root now
+			MessageBox.information(CollaborationUtils.getText("C_COLLABORATIONDRAFT_DELETE", message.userDescription), {
+				onClose: function () {
+					// TODO: Navigate to root? To be implemented
+					history.back();
+				}
+			});
+		}
+		// TODO: For now just take the first object to get the meta path and do a full refresh of the table
+		changedDocument = deletedObjects[0];
+	}
+
+	if (changedDocument.startsWith(currentPath)) {
+		// Execute SideEffects (TODO for Meet there should be one central method)
+		const activityPath = metaPath.replace(currentMetaPath, "").slice(1);
+		if (activityPath) {
+			// Request also the property itself
+			const sideEffects: any[] = [
+				{
+					$PropertyPath: activityPath
+				}
+			];
+			const entityType = sideEffectsService.getEntityTypeFromContext(currentContext);
+			const entityTypeSideEffects = sideEffectsService.getODataEntitySideEffects(entityType);
+			// Poor man solution without checking source targets, just for POC, this is throw-way coding only
+			const object: any = Object; // just to overcome TS issues, will be anyway replaced
+			const relevantSideEffects = object.fromEntries(
+				object
+					.entries(entityTypeSideEffects)
+					.filter((x: any[]) => x[1].SourceProperties?.findIndex((source: any) => source.value === activityPath) > -1)
+			);
+			for (const p in relevantSideEffects) {
+				relevantSideEffects[p].TargetProperties.forEach(function (targetProperty: any) {
+					sideEffects.push({
+						$PropertyPath: targetProperty
+					});
+				});
+			}
+			sideEffectsService.requestSideEffects(sideEffects, currentContext, "$auto");
+		}
+	}
+
+	// Simulate any change so the edit flow shows the draft indicator and sets the page to dirty
+	currentPage.getController().editFlow.updateDocument(currentContext, Promise.resolve());
+}
+
+function navigate(path: string, view: View) {
+	// TODO: routing.navigate doesn't consider semantic bookmarking
+	const currentPage = getCurrentPage(view);
+	const targetContext = view.getModel().bindContext(path).getBoundContext();
+	currentPage.getController().routing.navigate(targetContext);
+}
+
+function getCurrentPage(view: View) {
+	const appComponent = CollaborationUtils.getAppComponent(view);
+	// TODO: isn't there an easier way to get the current page?
+	// TODO: What about FCL?
+	return (appComponent.getRootControl() as any).getContent()[0].getCurrentPage().getComponentInstance().getRootControl();
+}
+
+function getActivityKey(x: string): string {
+	return x.substring(x.lastIndexOf("(") + 1, x.lastIndexOf(")"));
+}
+
+export default {
+	connect: connect,
+	disconnect: disconnect,
+	isConnected: isConnected,
+	isCollaborationEnabled: isCollaborationEnabled,
+	send: send
+};

package/src/sap/fe/core/actions/collaboration/CollaborationCommon.js

@@ -0,0 +1,146 @@
+/*!
+ * SAP UI development toolkit for HTML5 (SAPUI5)
+ *      (c) Copyright 2009-2021 SAP SE. All rights reserved
+ */
+sap.ui.define(["sap/ui/core/Component", "sap/ui/core/Core"], function (Component, Core) {
+  "use strict";
+
+  var _exports = {};
+
+  var Role;
+
+  (function (Role) {
+    Role["Owner"] = "O";
+    Role["Edit"] = "E";
+  })(Role || (Role = {}));
+
+  _exports.Role = Role;
+  var Activity;
+
+  (function (Activity) {
+    Activity["Join"] = "JOIN";
+    Activity["JoinEcho"] = "JOINECHO";
+    Activity["Leave"] = "LEAVE";
+    Activity["Change"] = "CHANGE";
+    Activity["Create"] = "CREATE";
+    Activity["Delete"] = "DELETE";
+    Activity["Action"] = "ACTION";
+    Activity["LiveChange"] = "LIVECHANGE";
+    Activity["Activate"] = "ACTIVATE";
+    Activity["Discard"] = "DISCARD";
+    Activity["Undo"] = "UNDO";
+  })(Activity || (Activity = {}));
+
+  _exports.Activity = Activity;
+
+  function formatInitials(fullName) {
+    // remove titles - those are the ones from S/4 to be checked if there are others
+    var academicTitles = ["Dr.", "Prof.", "Prof. Dr.", "B.A.", "MBA", "Ph.D."];
+    academicTitles.forEach(function (academicTitle) {
+      fullName = fullName.replace(academicTitle, "");
+    });
+    var initials;
+    var parts = fullName.trimStart().split(" ");
+
+    if (parts.length > 1) {
+      var _parts$shift, _parts$pop;
+
+      initials = ((parts === null || parts === void 0 ? void 0 : (_parts$shift = parts.shift()) === null || _parts$shift === void 0 ? void 0 : _parts$shift.charAt(0)) || "") + ((_parts$pop = parts.pop()) === null || _parts$pop === void 0 ? void 0 : _parts$pop.charAt(0));
+    } else {
+      initials = fullName.substring(0, 2);
+    }
+
+    return initials.toUpperCase();
+  }
+
+  function getUserColor(UserID, activeUsers, invitedUsers) {
+    // search if user is known
+    var user = activeUsers.find(function (u) {
+      return u.id === UserID;
+    });
+
+    if (user) {
+      return user.color;
+    } else {
+      var _loop = function (i) {
+        if (activeUsers.findIndex(function (u) {
+          return u.color === i;
+        }) === -1 && invitedUsers.findIndex(function (u) {
+          return u.color === i;
+        }) === -1) {
+          return {
+            v: i
+          };
+        }
+      };
+
+      // search for next free color
+      for (var i = 1; i <= 10; i++) {
+        var _ret = _loop(i);
+
+        if (typeof _ret === "object") return _ret.v;
+      } // this seems to be a popular object :) for now just return 10 for all.
+      // for invited we should start from 1 again so the colors are different
+
+
+      return 10;
+    }
+  } // copied from CommonUtils. Due to a cycle dependency I can't use CommonUtils here.
+  // That's to be fixed. the discard popover thingy shouldn't be in the common utils at all
+
+
+  function getAppComponent(oControl) {
+    if (oControl.isA("sap.fe.core.AppComponent")) {
+      return oControl;
+    }
+
+    var oOwner = Component.getOwnerComponentFor(oControl);
+
+    if (!oOwner) {
+      return oControl;
+    } else {
+      return getAppComponent(oOwner);
+    }
+  }
+
+  function getMe(view) {
+    var shellServiceHelper = getAppComponent(view).getShellServices();
+
+    if (!shellServiceHelper || !shellServiceHelper.hasUShell()) {
+      throw "No Shell... No User";
+    }
+
+    var me = {
+      initials: shellServiceHelper.getUser().getInitials(),
+      id: shellServiceHelper.getUser().getId(),
+      name: shellServiceHelper.getUser().getFullName() + " (" + getText("C_COLLABORATIONDRAFT_YOU") + ")",
+      initialName: shellServiceHelper.getUser().getFullName(),
+      color: 6,
+      //  same color as FLP...
+      role: Role.Owner,
+      me: true
+    };
+    return me;
+  }
+
+  function getText(textId) {
+    var oResourceModel = Core.getLibraryResourceBundle("sap.fe.core");
+
+    for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      args[_key - 1] = arguments[_key];
+    }
+
+    return oResourceModel.getText(textId, args);
+  }
+
+  var CollaborationUtils = {
+    formatInitials: formatInitials,
+    getUserColor: getUserColor,
+    getMe: getMe,
+    getAppComponent: getAppComponent,
+    getText: getText
+  };
+  _exports.CollaborationUtils = CollaborationUtils;
+  return _exports;
+}, false);
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIkNvbGxhYm9yYXRpb25Db21tb24udHMiXSwibmFtZXMiOlsiUm9sZSIsIkFjdGl2aXR5IiwiZm9ybWF0SW5pdGlhbHMiLCJmdWxsTmFtZSIsImFjYWRlbWljVGl0bGVzIiwiZm9yRWFjaCIsImFjYWRlbWljVGl0bGUiLCJyZXBsYWNlIiwiaW5pdGlhbHMiLCJwYXJ0cyIsInRyaW1TdGFydCIsInNwbGl0IiwibGVuZ3RoIiwic2hpZnQiLCJjaGFyQXQiLCJwb3AiLCJzdWJzdHJpbmciLCJ0b1VwcGVyQ2FzZSIsImdldFVzZXJDb2xvciIsIlVzZXJJRCIsImFjdGl2ZVVzZXJzIiwiaW52aXRlZFVzZXJzIiwidXNlciIsImZpbmQiLCJ1IiwiaWQiLCJjb2xvciIsImkiLCJmaW5kSW5kZXgiLCJnZXRBcHBDb21wb25lbnQiLCJvQ29udHJvbCIsImlzQSIsIm9Pd25lciIsIkNvbXBvbmVudCIsImdldE93bmVyQ29tcG9uZW50Rm9yIiwiZ2V0TWUiLCJ2aWV3Iiwic2hlbGxTZXJ2aWNlSGVscGVyIiwiZ2V0U2hlbGxTZXJ2aWNlcyIsImhhc1VTaGVsbCIsIm1lIiwiZ2V0VXNlciIsImdldEluaXRpYWxzIiwiZ2V0SWQiLCJuYW1lIiwiZ2V0RnVsbE5hbWUiLCJnZXRUZXh0IiwiaW5pdGlhbE5hbWUiLCJyb2xlIiwiT3duZXIiLCJ0ZXh0SWQiLCJvUmVzb3VyY2VNb2RlbCIsIkNvcmUiLCJnZXRMaWJyYXJ5UmVzb3VyY2VCdW5kbGUiLCJhcmdzIiwiQ29sbGFib3JhdGlvblV0aWxzIl0sIm1hcHBpbmdzIjoiO0FBQUE7QUFDQTtBQUNBOzs7Ozs7TUFtQllBLEk7O2FBQUFBLEk7QUFBQUEsSUFBQUEsSTtBQUFBQSxJQUFBQSxJO0tBQUFBLEksS0FBQUEsSTs7O01BS0FDLFE7O2FBQUFBLFE7QUFBQUEsSUFBQUEsUTtBQUFBQSxJQUFBQSxRO0FBQUFBLElBQUFBLFE7QUFBQUEsSUFBQUEsUTtBQUFBQSxJQUFBQSxRO0FBQUFBLElBQUFBLFE7QUFBQUEsSUFBQUEsUTtB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LEtBSDBCO0FBSWpDTixJQUFBQSxlQUFlLEVBQUVBLGVBSmdCO0FBS2pDaUIsSUFBQUEsT0FBTyxFQUFFQTtBQUx3QixHQUEzQiIsInNvdXJjZVJvb3QiOiIuIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IFZpZXcgZnJvbSBcInNhcC91aS9jb3JlL212Yy9WaWV3XCI7XG5pbXBvcnQgQ29tcG9uZW50IGZyb20gXCJzYXAvdWkvY29yZS9Db21wb25lbnRcIjtcbmltcG9ydCBBcHBDb21wb25lbnQgZnJvbSBcInNhcC9mZS9jb3JlL0FwcENvbXBvbmVudFwiO1xuaW1wb3J0IHsgQ29yZUV4IH0gZnJvbSBcIi4uLy4uLy4uLy4uLy4uLy4uLy4uLy4uL3R5cGVzL2V4dGVuc2lvbl90eXBlc1wiO1xuaW1wb3J0IENvcmUgZnJvbSBcInNhcC91aS9jb3JlL0NvcmVcIjtcblxuZXhwb3J0IHR5cGUgVXNlciA9IHtcblx0aWQ6IHN0cmluZztcblx0aW5pdGlhbHM/OiBzdHJpbmc7XG5cdG5hbWU6IHN0cmluZztcblx0cm9sZT86IFJvbGU7XG5cdGNvbG9yPzogbnVtYmVyO1xuXHR0cmFuc2llbnQ/OiBib29sZWFuO1xuXHRtZT86IGJvb2xlYW47XG5cdGluaXRpYWxOYW1lPzogc3RyaW5nO1xufTtcblxuZXhwb3J0IHR5cGUgVXNlckFjdGl2aXR5ID0gVXNlciAmIHtcblx0a2V5Pzogc3RyaW5nO1xufTtcblxuZXhwb3J0IGVudW0gUm9sZSB7XG5cdE93bmVyID0gXCJPXCIsXG5cdEVkaXQgPSBcIkVcIlxufVxuXG5leHBvcnQgZW51bSBBY3Rpdml0eSB7XG5cdEpvaW4gPSBcIkpPSU5cIixcblx0Sm9pbkVjaG8gPSBcIkpPSU5FQ0hPXCIsXG5cdExlYXZlID0gXCJMRUFWRVwiLFxuXHRDaGFuZ2UgPSBcIkNIQU5HRVwiLFxuXHRDcmVhdGUgPSBcIkNSRUFURVwiLFxuXHREZWxldGUgPSBcIkRFTEVURVwiLFxuXHRBY3Rpb24gPSBcIkFDVElPTlwiLFxuXHRMaXZlQ2hhbmdlID0gXCJMSVZFQ0hBTkdFXCIsXG5cdEFjdGl2YXRlID0gXCJBQ1RJVkFURVwiLFxuXHREaXNjYXJkID0gXCJESVNDQVJEXCIsXG5cdFVuZG8gPSBcIlVORE9cIlxufVxuXG5leHBvcnQgdHlwZSBNZXNzYWdlID0ge1xuXHR1c2VyRGVzY3JpcHRpb246IHN0cmluZztcblx0dXNlcklEOiBzdHJpbmc7XG5cdHVzZXJBY3Rpb246IHN0cmluZztcblx0Y2xpZW50QWN0aW9uOiBzdHJpbmc7XG5cdGNsaWVudENvbnRlbnQ6IHN0cmluZztcbn07XG5cbmZ1bmN0aW9uIGZvcm1hdEluaXRpYWxzKGZ1bGxOYW1lOiBzdHJpbmcpOiBzdHJpbmcge1xuXHQvLyByZW1vdmUgdGl0bGVzIC0gdGhvc2UgYXJlIHRoZSBvbmVzIGZyb20gUy80IHRvIGJlIGNoZWNrZWQgaWYgdGhlcmUgYXJlIG90aGVyc1xuXHRjb25zdCBhY2FkZW1pY1RpdGxlcyA9IFtcIkRyLlwiLCBcIlByb2YuXCIsIFwiUHJvZi4gRHIuXCIsIFwiQi5BLlwiLCBcIk1CQVwiLCBcIlBoLkQuXCJdO1xuXHRhY2FkZW1pY1RpdGxlcy5mb3JFYWNoKGZ1bmN0aW9uKGFjYWRlbWljVGl0bGUpIHtcblx0XHRmdWxsTmFtZSA9IGZ1bGxOYW1lLnJlcGxhY2UoYWNhZGVtaWNUaXRsZSwgXCJcIik7XG5cdH0pO1xuXG5cdGxldCBpbml0aWFsczogc3RyaW5nO1xuXHRjb25zdCBwYXJ0cyA9IGZ1bGxOYW1lLnRyaW1TdGFydCgpLnNwbGl0KFwiIFwiKTtcblxuXHRpZiAocGFydHMubGVuZ3RoID4gMSkge1xuXHRcdGluaXRpYWxzID0gKHBhcnRzPy5zaGlmdCgpPy5jaGFyQXQoMCkgfHwgXCJcIikgKyBwYXJ0cy5wb3AoKT8uY2hhckF0KDApO1xuXHR9IGVsc2Uge1xuXHRcdGluaXRpYWxzID0gZnVsbE5hbWUuc3Vic3RyaW5nKDAsIDIpO1xuXHR9XG5cblx0cmV0dXJuIGluaXRpYWxzLnRvVXBwZXJDYXNlKCk7XG59XG5cbmZ1bmN0aW9uIGdldFVzZXJDb2xvcihVc2VySUQ6IHN0cmluZywgYWN0aXZlVXNlcnM6IFVzZXJbXSwgaW52aXRlZFVzZXJzOiBVc2VyW10pIHtcblx0Ly8gc2VhcmNoIGlmIHVzZXIgaXMga25vd25cblx0Y29uc3QgdXNlciA9IGFjdGl2ZVVzZXJzLmZpbmQodSA9PiB1LmlkID09PSBVc2VySUQpO1xuXHRpZiAodXNlcikge1xuXHRcdHJldHVybiB1c2VyLmNvbG9yO1xuXHR9IGVsc2Uge1xuXHRcdC8vIHNlYXJjaCBmb3IgbmV4dCBmcmVlIGNvbG9yXG5cdFx0Zm9yIChsZXQgaSA9IDE7IGkgPD0gMTA7IGkrKykge1xuXHRcdFx0aWYgKGFjdGl2ZVVzZXJzLmZpbmRJbmRleCh1ID0+IHUuY29sb3IgPT09IGkpID09PSAtMSAmJiBpbnZpdGVkVXNlcnMuZmluZEluZGV4KHUgPT4gdS5jb2xvciA9PT0gaSkgPT09IC0xKSB7XG5cdFx0XHRcdHJldHVybiBpO1xuXHRcdFx0fVxuXHRcdH1cblx0XHQvLyB0aGlzIHNlZW1zIHRvIGJlIGEgcG9wdWxhciBvYmplY3QgOikgZm9yIG5vdyBqdXN0IHJldHVybiAxMCBmb3IgYWxsLlxuXHRcdC8vIGZvciBpbnZpdGVkIHdlIHNob3VsZCBzdGFydCBmcm9tIDEgYWdhaW4gc28gdGhlIGNvbG9ycyBhcmUgZGlmZmVyZW50XG5cdFx0cmV0dXJuIDEwO1xuXHR9XG59XG5cbi8vIGNvcGllZCBmcm9tIENvbW1vblV0aWxzLiBEdWUgdG8gYSBjeWNsZSBkZXBlbmRlbmN5IEkgY2FuJ3QgdXNlIENvbW1vblV0aWxzIGhlcmUuXG4vLyBUaGF0J3MgdG8gYmUgZml4ZWQuIHRoZSBkaXNjYXJkIHBvcG92ZXIgdGhpbmd5IHNob3VsZG4ndCBiZSBpbiB0aGUgY29tbW9uIHV0aWxzIGF0IGFsbFxuZnVuY3Rpb24gZ2V0QXBwQ29tcG9uZW50KG9Db250cm9sOiBhbnkpOiBBcHBDb21wb25lbnQge1xuXHRpZiAob0NvbnRyb2wuaXNBKFwic2FwLmZlLmNvcmUuQXBwQ29tcG9uZW50XCIpKSB7XG5cdFx0cmV0dXJuIG9Db250cm9sO1xuXHR9XG5cdGNvbnN0IG9Pd25lciA9IENvbXBvbmVudC5nZXRPd25lckNvbXBvbmVudEZvcihvQ29udHJvbCk7XG5cdGlmICghb093bmVyKSB7XG5cdFx0cmV0dXJuIG9Db250cm9sO1xuXHR9IGVsc2Uge1xuXHRcdHJldHVybiBnZXRBcHBDb21wb25lbnQob093bmVyKTtcblx0fVxufVxuXG5mdW5jdGlvbiBnZXRNZSh2aWV3OiBWaWV3KTogVXNlciB7XG5cdGNvbnN0IHNoZWxsU2VydmljZUhlbHBlciA9IGdldEFwcENvbXBvbmVudCh2aWV3KS5nZXRTaGVsbFNlcnZpY2VzKCk7XG5cdGlmICghc2hlbGxTZXJ2aWNlSGVscGVyIHx8ICFzaGVsbFNlcnZpY2VIZWxwZXIuaGFzVVNoZWxsKCkpIHtcblx0XHR0aHJvdyBcIk5vIFNoZWxsLi4uIE5vIFVzZXJcIjtcblx0fVxuXHRjb25zdCBtZTogVXNlciA9IHtcblx0XHRpbml0aWFsczogc2hlbGxTZXJ2aWNlSGVscGVyLmdldFVzZXIoKS5nZXRJbml0aWFscygpLFxuXHRcdGlkOiBzaGVsbFNlcnZpY2VIZWxwZXIuZ2V0VXNlcigpLmdldElkKCksXG5cdFx0bmFtZTogc2hlbGxTZXJ2aWNlSGVscGVyLmdldFVzZXIoKS5nZXRGdWxsTmFtZSgpICsgXCIgKFwiICsgZ2V0VGV4dChcIkNfQ09MTEFCT1JBVElPTkRSQUZUX1lPVVwiKSArIFwiKVwiLFxuXHRcdGluaXRpYWxOYW1lOiBzaGVsbFNlcnZpY2VIZWxwZXIuZ2V0VXNlcigpLmdldEZ1bGxOYW1lKCksXG5cdFx0Y29sb3I6IDYsIC8vICBzYW1lIGNvbG9yIGFzIEZMUC4uLlxuXHRcdHJvbGU6IFJvbGUuT3duZXIsXG5cdFx0bWU6IHRydWVcblx0fTtcblxuXHRyZXR1cm4gbWU7XG59XG5cbmZ1bmN0aW9uIGdldFRleHQodGV4dElkOiBzdHJpbmcsIC4uLmFyZ3M6IHN0cmluZ1tdKTogc3RyaW5nIHtcblx0Y29uc3Qgb1Jlc291cmNlTW9kZWwgPSAoQ29yZSBhcyBDb3JlRXgpLmdldExpYnJhcnlSZXNvdXJjZUJ1bmRsZShcInNhcC5mZS5jb3JlXCIpO1xuXHRyZXR1cm4gb1Jlc291cmNlTW9kZWwuZ2V0VGV4dCh0ZXh0SWQsIGFyZ3MpO1xufVxuXG5leHBvcnQgY29uc3QgQ29sbGFib3JhdGlvblV0aWxzID0ge1xuXHRmb3JtYXRJbml0aWFsczogZm9ybWF0SW5pdGlhbHMsXG5cdGdldFVzZXJDb2xvcjogZ2V0VXNlckNvbG9yLFxuXHRnZXRNZTogZ2V0TWUsXG5cdGdldEFwcENvbXBvbmVudDogZ2V0QXBwQ29tcG9uZW50LFxuXHRnZXRUZXh0OiBnZXRUZXh0XG59O1xuIl19

package/src/sap/fe/core/actions/collaboration/CollaborationCommon.ts

@@ -0,0 +1,129 @@
+import View from "sap/ui/core/mvc/View";
+import Component from "sap/ui/core/Component";
+import AppComponent from "sap/fe/core/AppComponent";
+import { CoreEx } from "../../../../../../../../types/extension_types";
+import Core from "sap/ui/core/Core";
+
+export type User = {
+	id: string;
+	initials?: string;
+	name: string;
+	role?: Role;
+	color?: number;
+	transient?: boolean;
+	me?: boolean;
+	initialName?: string;
+};
+
+export type UserActivity = User & {
+	key?: string;
+};
+
+export enum Role {
+	Owner = "O",
+	Edit = "E"
+}
+
+export enum Activity {
+	Join = "JOIN",
+	JoinEcho = "JOINECHO",
+	Leave = "LEAVE",
+	Change = "CHANGE",
+	Create = "CREATE",
+	Delete = "DELETE",
+	Action = "ACTION",
+	LiveChange = "LIVECHANGE",
+	Activate = "ACTIVATE",
+	Discard = "DISCARD",
+	Undo = "UNDO"
+}
+
+export type Message = {
+	userDescription: string;
+	userID: string;
+	userAction: string;
+	clientAction: string;
+	clientContent: string;
+};
+
+function formatInitials(fullName: string): string {
+	// remove titles - those are the ones from S/4 to be checked if there are others
+	const academicTitles = ["Dr.", "Prof.", "Prof. Dr.", "B.A.", "MBA", "Ph.D."];
+	academicTitles.forEach(function(academicTitle) {
+		fullName = fullName.replace(academicTitle, "");
+	});
+
+	let initials: string;
+	const parts = fullName.trimStart().split(" ");
+
+	if (parts.length > 1) {
+		initials = (parts?.shift()?.charAt(0) || "") + parts.pop()?.charAt(0);
+	} else {
+		initials = fullName.substring(0, 2);
+	}
+
+	return initials.toUpperCase();
+}
+
+function getUserColor(UserID: string, activeUsers: User[], invitedUsers: User[]) {
+	// search if user is known
+	const user = activeUsers.find(u => u.id === UserID);
+	if (user) {
+		return user.color;
+	} else {
+		// search for next free color
+		for (let i = 1; i <= 10; i++) {
+			if (activeUsers.findIndex(u => u.color === i) === -1 && invitedUsers.findIndex(u => u.color === i) === -1) {
+				return i;
+			}
+		}
+		// this seems to be a popular object :) for now just return 10 for all.
+		// for invited we should start from 1 again so the colors are different
+		return 10;
+	}
+}
+
+// copied from CommonUtils. Due to a cycle dependency I can't use CommonUtils here.
+// That's to be fixed. the discard popover thingy shouldn't be in the common utils at all
+function getAppComponent(oControl: any): AppComponent {
+	if (oControl.isA("sap.fe.core.AppComponent")) {
+		return oControl;
+	}
+	const oOwner = Component.getOwnerComponentFor(oControl);
+	if (!oOwner) {
+		return oControl;
+	} else {
+		return getAppComponent(oOwner);
+	}
+}
+
+function getMe(view: View): User {
+	const shellServiceHelper = getAppComponent(view).getShellServices();
+	if (!shellServiceHelper || !shellServiceHelper.hasUShell()) {
+		throw "No Shell... No User";
+	}
+	const me: User = {
+		initials: shellServiceHelper.getUser().getInitials(),
+		id: shellServiceHelper.getUser().getId(),
+		name: shellServiceHelper.getUser().getFullName() + " (" + getText("C_COLLABORATIONDRAFT_YOU") + ")",
+		initialName: shellServiceHelper.getUser().getFullName(),
+		color: 6, //  same color as FLP...
+		role: Role.Owner,
+		me: true
+	};
+
+	return me;
+}
+
+function getText(textId: string, ...args: string[]): string {
+	const oResourceModel = (Core as CoreEx).getLibraryResourceBundle("sap.fe.core");
+	return oResourceModel.getText(textId, args);
+}
+
+export const CollaborationUtils = {
+	formatInitials: formatInitials,
+	getUserColor: getUserColor,
+	getMe: getMe,
+	getAppComponent: getAppComponent,
+	getText: getText
+};