@salesforce/experimental-mfe-bridge 2.2.0 → 2.2.1-rc.1

package/dist/index.esm.js

@@ -1,4 +1,4 @@
-/*! @salesforce/experimental-mfe-bridge v2.2.0-rc.2 (2026-03-20) */
+/*! @salesforce/experimental-mfe-bridge v2.2.1-rc.1 (2026-04-09) */
 /**
  * EmbeddingResizer - Handles dynamic iframe/container resizing
  * Uses ResizeObserver to monitor element size changes and notify the host

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/experimental-mfe-bridge",
-    "version": "2.2.0",
+    "version": "2.2.1-rc.1",
     "private": false,
     "description": "EventTarget-Based Embed ↔ Host Communication for UI Embedding",
     "license": "SEE LICENSE IN LICENSE.txt",
@@ -24,8 +24,8 @@
         "test": "jest",
         "clean": "rimraf dist"
     },
-    "dependencies": {
-        "utils": "2.2.0"
+    "devDependencies": {
+        "utils": "2.2.1-rc.1"
     },
     "files": [
         "dist/",

package/dist/index.iife.js

@@ -1,282 +0,0 @@
-var LightningBridge = (function (exports) {
-    'use strict';
-
-    /**
-     * EmbeddingResizer - Handles dynamic iframe/container resizing
-     * Uses ResizeObserver to monitor element size changes and notify the host
-     */
-    class EmbeddingResizer {
-        #observer = null;
-        #targetElement;
-        #onResize;
-        #onReady;
-        #waitForDOMReady;
-        #lastHeight = -1;
-        #scheduled = false;
-        #isObserving = false;
-        constructor(options) {
-            this.#targetElement = options.targetElement || document.body;
-            this.#onResize = options.onResize;
-            this.#onReady = options.onReady;
-            this.#waitForDOMReady = options.waitForDOMReady ?? true;
-        }
-        /**
-         * Start observing the target element for size changes
-         */
-        start() {
-            if (this.#isObserving) {
-                return;
-            }
-            if (this.#waitForDOMReady && document.readyState === "loading") {
-                document.addEventListener("DOMContentLoaded", () => this.#startObserver(), { once: true });
-            }
-            else {
-                this.#startObserver();
-            }
-        }
-        /**
-         * Stop observing and clean up resources
-         */
-        stop() {
-            if (this.#observer) {
-                this.#observer.disconnect();
-                this.#observer = null;
-            }
-            this.#isObserving = false;
-            this.#lastHeight = -1;
-            this.#scheduled = false;
-        }
-        /**
-         * Get the current observed height
-         */
-        getLastHeight() {
-            return this.#lastHeight;
-        }
-        /**
-         * Check if currently observing
-         */
-        isObserving() {
-            return this.#isObserving;
-        }
-        #startObserver = () => {
-            this.#observer = new ResizeObserver((entries) => {
-                this.#handleResize(entries);
-            });
-            this.#observer.observe(this.#targetElement, { box: "border-box" });
-            this.#isObserving = true;
-            // Invoke ready callback if provided
-            if (this.#onReady) {
-                this.#onReady();
-            }
-        };
-        #handleResize = (entries) => {
-            if (!entries || entries.length === 0) {
-                return;
-            }
-            const entry = entries[0];
-            const measuredHeight = this.#extractHeight(entry);
-            const heightPx = Math.max(0, Math.ceil(Number(measuredHeight)));
-            if (!Number.isFinite(heightPx)) {
-                return;
-            }
-            if (heightPx === this.#lastHeight) {
-                return;
-            }
-            this.#lastHeight = heightPx;
-            if (!this.#scheduled) {
-                this.#scheduled = true;
-                requestAnimationFrame(() => {
-                    this.#scheduled = false;
-                    this.#onResize(heightPx);
-                });
-            }
-        };
-        #extractHeight = (entry) => {
-            // Try borderBoxSize first (more accurate)
-            if (entry.borderBoxSize) {
-                if (Array.isArray(entry.borderBoxSize)) {
-                    return entry.borderBoxSize[0]?.blockSize || 0;
-                }
-                // Some browsers return a single object instead of array
-                return entry.borderBoxSize.blockSize || 0;
-            }
-            // Fallback to contentRect
-            if (entry.contentRect && typeof entry.contentRect.height === "number") {
-                return entry.contentRect.height;
-            }
-            // Last resort: getBoundingClientRect
-            if (entry.target && typeof entry.target.getBoundingClientRect === "function") {
-                return entry.target.getBoundingClientRect().height;
-            }
-            return 0;
-        };
-    }
-
-    /**
-     * ExternalEmbedBridge - EventTarget-based iframe ↔ host communication
-     * Provides secure, structured interface for widget development
-     * Auto-handles theme synchronization and error telemetry
-     */
-    class ExternalEmbedBridge extends EventTarget {
-        #connected = false;
-        #hostAppOrigin = null;
-        #instanceId = null;
-        #currentTheme = {};
-        #currentData = {};
-        #resizer = null;
-        constructor() {
-            super();
-            window.addEventListener("message", (e) => this.#handleHostMessage(e));
-            this.#setupErrorCapture();
-            this.#sendToHost("bridge-ready");
-            this.#setupResizeObserver();
-            // eslint-disable-next-line no-console
-            console.log("[Bridge] Initialized and ready for communication");
-        }
-        #handleHostMessage(event) {
-            if (event.source !== window.parent)
-                return;
-            if (this.#hostAppOrigin && event.origin !== this.#hostAppOrigin)
-                return;
-            const payload = event.data || {};
-            const { type, data, id } = payload;
-            if (typeof type !== "string" || !type.startsWith("salesforce-"))
-                return;
-            if (this.#instanceId && id !== this.#instanceId)
-                return;
-            // eslint-disable-next-line no-console
-            console.log("[Bridge] host->widget", type, data);
-            switch (type) {
-                case "salesforce-theme":
-                    this.#handleThemeUpdate(data);
-                    break;
-                case "salesforce-data":
-                    this.#handleDataUpdate(data);
-                    break;
-                case "salesforce-shell-ready":
-                    this.#handleConnectionReady(event.origin, id);
-                    break;
-            }
-        }
-        #handleThemeUpdate(themeData) {
-            this.#currentTheme = { ...themeData };
-            this.#applyThemeToDocument(themeData);
-            // use super to escape the override
-            super.dispatchEvent(new CustomEvent("theme", { detail: themeData }));
-        }
-        #handleDataUpdate(payload) {
-            this.#currentData = { ...payload };
-            // use super to escape the override
-            super.dispatchEvent(new CustomEvent("data", { detail: payload }));
-        }
-        #handleConnectionReady(origin, id) {
-            this.#connected = true;
-            this.#hostAppOrigin = origin;
-            this.#instanceId = id;
-            // use super to escape the override
-            super.dispatchEvent(new CustomEvent("connected"));
-        }
-        #applyThemeToDocument(themeData) {
-            const documentElement = document.documentElement;
-            requestAnimationFrame(() => {
-                Object.entries(themeData).forEach(([property, value]) => {
-                    if (property.startsWith("--")) {
-                        documentElement.style.setProperty(property, String(value));
-                    }
-                });
-            });
-        }
-        #setupErrorCapture() {
-            // this allows salesforce to collect telemetry about errors in your app
-            window.addEventListener("error", (event) => {
-                this.#sendToHost("bridge-error", {
-                    type: "javascript-error",
-                    message: event.message,
-                    filename: event.filename,
-                    lineno: event.lineno,
-                    colno: event.colno,
-                    stack: event.error?.stack,
-                    timestamp: Date.now(),
-                });
-            });
-            window.addEventListener("unhandledrejection", (event) => {
-                this.#sendToHost("bridge-error", {
-                    type: "unhandled-rejection",
-                    reason: event.reason?.toString?.() || "Unknown rejection",
-                    stack: event.reason?.stack,
-                    timestamp: Date.now(),
-                });
-            });
-        }
-        #setupResizeObserver() {
-            this.#resizer = new EmbeddingResizer({
-                targetElement: document.body,
-                onResize: (height) => {
-                    this.#sendToHost("bridge-event", { eventType: "resize", detail: { height } });
-                },
-                onReady: () => {
-                    this.#sendToHost("bridge-event", {
-                        eventType: "widget-ready",
-                        detail: { bridge: "ExternalEmbedBridge", version: "1.0.0", timestamp: Date.now() },
-                    });
-                },
-                waitForDOMReady: true,
-            });
-            this.#resizer.start();
-        }
-        #getHostAppOrigin(type) {
-            return this.#hostAppOrigin || (type === "bridge-ready" ? "*" : null);
-        }
-        #sendToHost(type, data) {
-            const origin = this.#getHostAppOrigin(type);
-            if (!origin)
-                return;
-            try {
-                const message = this.#instanceId ? { type, data, id: this.#instanceId } : { type, data };
-                // eslint-disable-next-line no-console
-                console.log("[Bridge] Sending message to host:", message);
-                window.parent.postMessage(message, origin);
-            }
-            catch (error) {
-                // eslint-disable-next-line no-console
-                console.warn("[Bridge] Failed to send message to host:", error);
-            }
-        }
-        // Override dispatchEvent to forward custom events to the host via post message
-        dispatchEvent(event) {
-            const result = super.dispatchEvent(event);
-            this.#sendToHost("custom-event", {
-                eventType: event.type,
-                detail: event.detail,
-            });
-            return result;
-        }
-        getTheme() {
-            return { ...this.#currentTheme };
-        }
-        getData() {
-            return { ...this.#currentData };
-        }
-        get instanceId() {
-            return this.#instanceId;
-        }
-        isConnected() {
-            return this.#connected;
-        }
-    }
-
-    /**
-     * Bridge Package Entry Point
-     * Exports the bridge singleton for iframe ↔ host communication
-     */
-    // Create and export a singleton instance for convenience
-    const bridge = new ExternalEmbedBridge();
-
-    exports.default = bridge;
-
-    Object.defineProperty(exports, '__esModule', { value: true });
-
-    return exports;
-
-})({});
-//# sourceMappingURL=index.iife.js.map

package/dist/index.iife.prod.js

@@ -1,3 +0,0 @@
-/*! @lightning-out/bridge v2.2.0-rc.1 (2026-03-11) */
-var LightningBridge=function(e){"use strict";class t{#e=null;#t;#s;#n;#i;#r=-1;#a=!1;#o=!1;constructor(e){this.#t=e.targetElement||document.body,this.#s=e.onResize,this.#n=e.onReady,this.#i=e.waitForDOMReady??!0}start(){this.#o||(this.#i&&"loading"===document.readyState?document.addEventListener("DOMContentLoaded",()=>this.#d(),{once:!0}):this.#d())}stop(){this.#e&&(this.#e.disconnect(),this.#e=null),this.#o=!1,this.#r=-1,this.#a=!1}getLastHeight(){return this.#r}isObserving(){return this.#o}#d=()=>{this.#e=new ResizeObserver(e=>{this.#h(e)}),this.#e.observe(this.#t,{box:"border-box"}),this.#o=!0,this.#n&&this.#n()};#h=e=>{if(!e||0===e.length)return;const t=e[0],s=this.#c(t),n=Math.max(0,Math.ceil(Number(s)));Number.isFinite(n)&&n!==this.#r&&(this.#r=n,this.#a||(this.#a=!0,requestAnimationFrame(()=>{this.#a=!1,this.#s(n)})))};#c=e=>e.borderBoxSize?Array.isArray(e.borderBoxSize)?e.borderBoxSize[0]?.blockSize||0:e.borderBoxSize.blockSize||0:e.contentRect&&"number"==typeof e.contentRect.height?e.contentRect.height:e.target&&"function"==typeof e.target.getBoundingClientRect?e.target.getBoundingClientRect().height:0}class s extends EventTarget{#l=!1;#g=null;#u=null;#p={};#m={};#b=null;constructor(){super(),window.addEventListener("message",e=>this.#v(e)),this.#y(),this.#w("bridge-ready"),this.#R(),console.log("[Bridge] Initialized and ready for communication")}#v(e){if(e.source!==window.parent)return;if(this.#g&&e.origin!==this.#g)return;const t=e.data||{},{type:s,data:n,id:i}=t;if("string"==typeof s&&s.startsWith("salesforce-")&&(!this.#u||i===this.#u))switch(console.log("[Bridge] host->widget",s,n),s){case"salesforce-theme":this.#O(n);break;case"salesforce-data":this.#E(n);break;case"salesforce-shell-ready":this.#z(e.origin,i)}}#O(e){this.#p={...e},this.#T(e),super.dispatchEvent(new CustomEvent("theme",{detail:e}))}#E(e){this.#m={...e},super.dispatchEvent(new CustomEvent("data",{detail:e}))}#z(e,t){this.#l=!0,this.#g=e,this.#u=t,super.dispatchEvent(new CustomEvent("connected"))}#T(e){const t=document.documentElement;requestAnimationFrame(()=>{Object.entries(e).forEach(([e,s])=>{e.startsWith("--")&&t.style.setProperty(e,String(s))})})}#y(){window.addEventListener("error",e=>{this.#w("bridge-error",{type:"javascript-error",message:e.message,filename:e.filename,lineno:e.lineno,colno:e.colno,stack:e.error?.stack,timestamp:Date.now()})}),window.addEventListener("unhandledrejection",e=>{this.#w("bridge-error",{type:"unhandled-rejection",reason:e.reason?.toString?.()||"Unknown rejection",stack:e.reason?.stack,timestamp:Date.now()})})}#R(){this.#b=new t({targetElement:document.body,onResize:e=>{this.#w("bridge-event",{eventType:"resize",detail:{height:e}})},onReady:()=>{this.#w("bridge-event",{eventType:"widget-ready",detail:{bridge:"ExternalEmbedBridge",version:"1.0.0",timestamp:Date.now()}})},waitForDOMReady:!0}),this.#b.start()}#f(e){return this.#g||("bridge-ready"===e?"*":null)}#w(e,t){const s=this.#f(e);if(s)try{const n=this.#u?{type:e,data:t,id:this.#u}:{type:e,data:t};console.log("[Bridge] Sending message to host:",n),window.parent.postMessage(n,s)}catch(e){console.warn("[Bridge] Failed to send message to host:",e)}}dispatchEvent(e){const t=super.dispatchEvent(e);return this.#w("custom-event",{eventType:e.type,detail:e.detail}),t}getTheme(){return{...this.#p}}getData(){return{...this.#m}}get instanceId(){return this.#u}isConnected(){return this.#l}}const n=new s;return e.default=n,Object.defineProperty(e,"__esModule",{value:!0}),e}({});
-//# sourceMappingURL=index.iife.prod.js.map