@capillarytech/cap-ui-utils 3.0.14 → 3.0.15-alpha.1

package/index.js

@@ -12,3 +12,4 @@ export { default as sanitizeTemplateWithRegexp } from "./utils/contentSanitizati
 export { default as decompressJsonObject } from "./utils/zlibDataDecompress";
 export { default as getEnvVariable } from "./utils/getEnvVariables";
 export { formatDateWithTimezone, getTimezoneTooltip, hasTimezoneFeatureAccess } from "./utils/timezone";
+export { default as MFEEventBus } from "./utils/mfeEventBus";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capillarytech/cap-ui-utils",
-  "version": "3.0.14",
+  "version": "3.0.15-alpha.1",
   "description": "Utility functions shared accross all the modules",
   "main": "index.js",
   "scripts": {

package/utils/mfeEventBus.js

@@ -0,0 +1,47 @@
+/**
+ * MFEEventBus
+ *
+ * Lightweight event bus for cross-boundary communication between the MFE
+ * host shell and remote apps. Uses window CustomEvent — no build-time
+ * coupling between apps.
+ *
+ * All events are namespaced with the MFE_EVENT_PREFIX to avoid collisions
+ * with other window events (e.g. analytics, third-party libraries).
+ */
+
+const MFE_EVENT_PREFIX = 'mfe:';
+
+const MFEEventBus = {
+  /**
+   * Emit an event to all listeners (host or any remote).
+   *
+   * @param {string} eventName - Event name without prefix (e.g. 'loyalty:navigate')
+   * @param {object} payload   - Arbitrary serialisable data
+   */
+  emit(eventName, payload = {}) {
+    window.dispatchEvent(
+      new CustomEvent(`${MFE_EVENT_PREFIX}${eventName}`, {
+        detail: payload,
+        bubbles: false,
+        cancelable: false,
+      }),
+    );
+  },
+
+  /**
+   * Subscribe to an event. Returns an unsubscribe function — call it in
+   * useEffect cleanup to prevent memory leaks.
+   *
+   * @param {string}   eventName - Event name without prefix
+   * @param {function} handler   - Called with the event payload object
+   * @returns {function}         - Unsubscribe / cleanup function
+   */
+  on(eventName, handler) {
+    const listener = event => handler(event.detail);
+    window.addEventListener(`${MFE_EVENT_PREFIX}${eventName}`, listener);
+    return () =>
+      window.removeEventListener(`${MFE_EVENT_PREFIX}${eventName}`, listener);
+  },
+};
+
+export default MFEEventBus;