@lightning-out/containers 2.2.0-rc.0

package/dist/modules/force/lightningOutBaseContainer/lightningOutBaseContainer.html

@@ -0,0 +1,7 @@
+<template lwc:render-mode="light">
+    <lwc:component
+        lwc:is={embeddedCmpCtor}
+        lwc:ref="embeddedCmp"
+        lwc:spread={embeddedCmpProps}
+    ></lwc:component>
+</template>

package/dist/modules/force/lightningOutBaseContainer/lightningOutBaseContainer.js

@@ -0,0 +1,226 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import { api, LightningElement, track } from "lwc";
+
+import { MSG } from "./utils/contants";
+
+import { createEnvContext } from "./utils/env";
+import { createGlobalError } from "./utils/errorHandling";
+
+import { createInstrumentation } from "./utils/instrumentation";
+import { applyCustomStyleProperties } from "./utils/style";
+
+// These settings are important for layout and sizing.
+document.documentElement.style.height = "100%";
+document.documentElement.style.display = "block";
+document.body.style.margin = "0px";
+document.body.style.height = "100%";
+document.body.style.display = "block";
+
+export default class LightningOutBaseContainer extends LightningElement {
+    static renderMode = "light";
+
+    #embeddedCmp;
+    embeddedCmpCtor;
+    embeddedCmpName;
+    @track embeddedCmpProps;
+    embeddedCmpType = "lwc";
+
+    #env;
+    #eventListeners = new Map();
+    #renderActivity;
+    #renderActivityStopped = false;
+
+    #globalError;
+    isError = false;
+    #instrumentation;
+
+    constructor() {
+        super();
+        this.#env = createEnvContext();
+        this.#instrumentation = createInstrumentation(
+            "LightningOutLWRApp",
+            this.#env.componentNameParam,
+            this.#env.loAppOrigin,
+        );
+        this.#globalError = createGlobalError(this.#env.parentPostMessage, this.#instrumentation.logError);
+        window.addEventListener("message", this.#messageListener);
+    }
+
+    @api
+    get embeddedCmp() {
+        return this.refs?.embeddedCmp;
+    }
+
+    getEnv() {
+        return this.#env;
+    }
+
+    getInstrumentation() {
+        return this.#instrumentation;
+    }
+
+    #messageListener = (event) => {
+        // Page must be in an <iframe> unless testMode
+        if (!this.#env.testMode && window.top === window.self) {
+            window.console.trace("Lightning Out: This page is not in an <iframe>");
+            return;
+        }
+        if (event.origin !== this.#env.loAppOrigin) {
+            window.console.log(
+                `Lightning Out: Message ignored due to different origin: ${event.origin} vs ${this.#env.loAppOrigin}`,
+            );
+            return;
+        }
+        switch (event.data.type) {
+            case MSG.ADD_EVENT_LISTENER: {
+                const eventName = event.data.name;
+                const eventOptions = event.data.options;
+                const listenerKey = event.data.listenerKey;
+                const listener = (evt) => {
+                    this.#env.parentPostMessage({
+                        name: eventName,
+                        detail: structuredClone(evt.detail),
+                        type: MSG.DISPATCH_EVENT,
+                    });
+                };
+                this.#embeddedCmp.addEventListener(eventName, listener, eventOptions);
+                this.#eventListeners.set(listenerKey, listener);
+                break;
+            }
+            case MSG.DISPATCH_EVENT: {
+                const customEvent = new CustomEvent(event.data.name, {
+                    detail: event.data.detail,
+                });
+                this.#embeddedCmp.dispatchEvent(customEvent);
+                break;
+            }
+            case MSG.REMOVE_EVENT_LISTENER: {
+                const eventName = event.data.name;
+                const eventOptions = event.data.options;
+                const listenerKey = event.data.listenerKey;
+                const listener = this.#eventListeners.get(listenerKey);
+                if (listener) {
+                    this.#embeddedCmp.removeEventListener(eventName, listener, eventOptions);
+                    this.#eventListeners.delete(listenerKey);
+                }
+                break;
+            }
+            case MSG.SET_COMPONENT_DATA: {
+                this.renderComponent(event.data.componentData);
+                break;
+            }
+            case MSG.SET_COMPONENT_PROPS: {
+                this.setComponentProps(event.data.componentProps);
+                break;
+            }
+            case MSG.RELOAD: {
+                window.location.reload();
+                break;
+            }
+            default: {
+                // noop
+            }
+        }
+    };
+
+    async renderComponent(componentData) {
+        this.embeddedCmpId = componentData.id;
+        this.embeddedCmpName = componentData.name;
+        this.embeddedCmpProps = componentData.props;
+        if (!this.embeddedCmpName || !this.embeddedCmpProps) {
+            this.#globalError(`Missing 'componentName' or 'componentProps,' both must be specified.`);
+        }
+
+        const { specifier, type } = this.resolveEmbeddedCmpSpecifier(this.embeddedCmpName);
+        this.embeddedCmpType = type;
+
+        this.#renderActivity = this.#instrumentation.startRenderActivity({
+            componentName: specifier,
+            componentType: type,
+            loAppOrigin: this.#env.loAppOrigin,
+        });
+
+        try {
+            const { default: ctor } = await import(specifier);
+            this.embeddedCmpCtor = ctor;
+        } catch (err) {
+            this.isError = true;
+            this.#instrumentation.errorRenderActivity(this.#renderActivity, err, {
+                componentName: specifier,
+                componentType: type,
+                componentProps: JSON.stringify(this.embeddedCmpProps || {}),
+                message: err?.message,
+                hasError: this.isError,
+                loAppOrigin: this.#env.loAppOrigin,
+            });
+            this.#globalError(err);
+        } finally {
+            if (this.isError && this.#renderActivity && !this.#renderActivityStopped) {
+                this.#instrumentation.stopRenderActivity(this.#renderActivity, {
+                    componentName: specifier,
+                    componentType: type,
+                    hasError: this.isError,
+                    loAppOrigin: this.#env.loAppOrigin,
+                });
+                this.#renderActivityStopped = true;
+            }
+        }
+    }
+
+    setComponentProps(componentProps) {
+        if (componentProps.style && this.embeddedCmp) {
+            applyCustomStyleProperties(componentProps.style, this.embeddedCmp.style);
+            delete componentProps.style;
+        }
+        if (Object.keys(componentProps).length) {
+            this.embeddedCmpProps = componentProps;
+        }
+    }
+
+    resolveEmbeddedCmpSpecifier(embeddedCmpName) {
+        const [name] = embeddedCmpName.split("/v/");
+        const type = name.includes(":") ? "aura" : "lwc";
+        if (type === "aura") {
+            this.#globalError("Aura components require using 'lightningOutOneRuntimeContainer' instead.");
+        }
+        return { specifier: name, type };
+    }
+
+    connectedCallback() {
+        this.#env.parentPostMessage({ type: MSG.LOADED });
+        const componentData = this.#env.testMode ? this.#env.getComponentData() : null;
+        if (componentData) {
+            this.renderComponent(componentData);
+        } else {
+            this.#env.parentPostMessage({ type: MSG.GET_COMPONENT_DATA });
+        }
+    }
+
+    renderedCallback() {
+        if (!this.#embeddedCmp && this.refs?.embeddedCmp) {
+            this.#embeddedCmp = this.refs.embeddedCmp;
+            this.#embeddedCmp.addEventListener("message", (evt) => {
+                this.#env.parentPostMessage({
+                    name: evt.type,
+                    detail: structuredClone(evt.detail),
+                    type: MSG.DISPATCH_EVENT,
+                });
+            });
+            this.#env.parentPostMessage({ type: MSG.READY });
+            if (this.#renderActivity && !this.#renderActivityStopped) {
+                this.#instrumentation.stopRenderActivity(this.#renderActivity, {
+                    componentName: this.embeddedCmpName,
+                    componentType: this.embeddedCmpType,
+                    hasError: this.isError,
+                    loAppOrigin: this.#env.loAppOrigin,
+                });
+                this.#renderActivityStopped = true;
+            }
+        }
+    }
+}

package/dist/modules/force/lightningOutBaseContainer/lightningOutBaseContainer.js-meta.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
+    <isExposed>false</isExposed>
+</LightningComponentBundle>

package/dist/modules/force/lightningOutBaseContainer/utils/contants.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+export const MSG = {
+    LOADED: "lo.loaded",
+    READY: "lo.ready",
+    ADD_EVENT_LISTENER: "lo.addEventListener",
+    REMOVE_EVENT_LISTENER: "lo.removeEventListener",
+    DISPATCH_EVENT: "lo.dispatchEvent",
+    SET_COMPONENT_DATA: "lo.setComponentData",
+    SET_COMPONENT_PROPS: "lo.setComponentProps",
+    RELOAD: "lo.reload",
+    GET_COMPONENT_DATA: "lo.getComponentData",
+};

package/dist/modules/force/lightningOutBaseContainer/utils/env.js

@@ -0,0 +1,56 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+const urlSearchParams = new URLSearchParams(window.location.search);
+
+export function createEnvContext() {
+    const loAppOrigin = urlSearchParams.get("loAppOrigin");
+    const parentElementId = urlSearchParams.get("parentElementId");
+    const componentNameParam = urlSearchParams.get("componentName");
+    const testMode = urlSearchParams.get("testMode") === "true";
+
+    try {
+        const isInBuilder = window.self !== window.top && window.name === "sitePreviewFrame";
+        const isInBuilderContext =
+            urlSearchParams.get("app") === "commeditor" && urlSearchParams.get("view") === "editor";
+        if (!isInBuilder && !isInBuilderContext) {
+            (() => new URL(loAppOrigin))();
+        }
+    } catch (err) {
+        throw new Error(`${err.message} (loAppOrigin: ${loAppOrigin})`);
+    }
+
+    function parentPostMessage(message) {
+        if (typeof message !== "string") {
+            message.id = parentElementId;
+        }
+        window.parent.postMessage(message, loAppOrigin);
+    }
+
+    function getComponentData() {
+        const componentProps = urlSearchParams.get("componentProps");
+        if (!componentProps) {
+            return null;
+        }
+        try {
+            return {
+                name: componentNameParam,
+                props: JSON.parse(componentProps),
+            };
+        } catch {
+            throw new Error(`Invalid component properties: ${componentProps}`);
+        }
+    }
+
+    return {
+        loAppOrigin,
+        parentElementId,
+        componentNameParam,
+        testMode,
+        parentPostMessage,
+        getComponentData,
+    };
+}

package/dist/modules/force/lightningOutBaseContainer/utils/errorHandling.js

@@ -0,0 +1,16 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+export function createGlobalError(parentPostMessage, logError) {
+    return function globalError(err) {
+        const msg = err?.message || `${err}`;
+        const fullMsg = `Lightning-Out Container Error: ${msg}`;
+        logError(fullMsg);
+        window.console.error(fullMsg);
+        parentPostMessage(fullMsg);
+        throw new Error(fullMsg);
+    };
+}

package/dist/modules/force/lightningOutBaseContainer/utils/instrumentation.js

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import { getInstrumentation } from "o11y/client";
+import { lightningOutComponentRenderSchema } from "o11y_schema/sf_lightningOut";
+
+export function createInstrumentation(channelName, componentName, loAppOrigin) {
+    const instrumentation = getInstrumentation(channelName);
+
+    function logError(error) {
+        if (instrumentation) {
+            instrumentation.error(error, lightningOutComponentRenderSchema, {
+                componentName,
+                message: error.message || String(error),
+                hasError: true,
+                loAppOrigin,
+            });
+        }
+    }
+
+    function startRenderActivity(instrumentationContext) {
+        return instrumentation.startActivity("component-render", {
+            instrumentationContext,
+        });
+    }
+
+    function errorRenderActivity(activity, err, details) {
+        if (activity) {
+            activity.error(err, lightningOutComponentRenderSchema, details);
+        }
+    }
+
+    function stopRenderActivity(activity, details) {
+        if (activity) {
+            activity.stop(lightningOutComponentRenderSchema, details);
+        }
+    }
+
+    return {
+        logError,
+        startRenderActivity,
+        errorRenderActivity,
+        stopRenderActivity,
+    };
+}

package/dist/modules/force/lightningOutBaseContainer/utils/style.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+export function applyCustomStyleProperties(componentPropsStyle, embeddedCmpStyle) {
+    for (let i = 0, len = embeddedCmpStyle.length; i < len; i++) {
+        const prop = embeddedCmpStyle.item(i);
+        if (prop && prop.startsWith("--")) {
+            embeddedCmpStyle.removeProperty(prop);
+        }
+    }
+    const allStyles = componentPropsStyle.split(";");
+    allStyles.forEach((style) => {
+        const [prop, val] = style.split(":");
+        if (prop && prop.trim().startsWith("--")) {
+            embeddedCmpStyle.setProperty(prop.trim(), val ?? "");
+        }
+    });
+}

package/dist/modules/force/lightningOutLWRAuraContainer/lightningOutLWRAuraContainer.html

@@ -0,0 +1,17 @@
+<template lwc:render-mode="light">
+    <div lwc:if={includeBeacon}>
+        <aura-interop
+            descriptor="instrumentation:beacon"
+            config={config}
+        ></aura-interop>
+    </div>
+    <lwrlex-instrumentation></lwrlex-instrumentation>
+    
+    <div lwc:if={componentName}>
+    <aura-interop
+        descriptor={componentName}
+        lwc:ref="embeddedCmp"
+        lwc:spread={embeddedCmpProps}>
+    </aura-interop>
+   </div>
+</template>

package/dist/modules/force/lightningOutLWRAuraContainer/lightningOutLWRAuraContainer.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import LightningOutBaseContainer from "force/lightningOutBaseContainer";
+
+import { createErrorHooks } from "./utils/errorHandling";
+import { isBeaconEnabled } from "./utils/gater";
+
+export default class LightningOutLWRAuraContainer extends LightningOutBaseContainer {
+    #includeBeacon = false;
+    componentName = null;
+    config = {
+        usePageTransactions: false,
+        disableAvroValidation: false,
+    };
+    #renderActivity;
+    #renderActivityStopped = false;
+    constructor() {
+        super();
+        this.#includeBeacon = isBeaconEnabled();
+        createErrorHooks(this.getEnv().parentPostMessage, this.getInstrumentation().logError);
+    }
+
+    get includeBeacon() {
+        return this.#includeBeacon;
+    }
+
+    async renderComponent(componentData) {
+        if (!componentData.name) {
+            const error = new Error("LightningOutLWRAuraContainer requires 'componentName'.");
+            this.getInstrumentation().logError(error);
+            throw error;
+        }
+
+        const isAura = componentData.name.includes(":");
+        this.embeddedCmpType = isAura ? "aura" : "lwc";
+        this.embeddedCmpId = componentData.id || "componentId";
+        this.embeddedCmpName = componentData.name;
+        this.embeddedCmpProps = componentData.props || {};
+        this.componentName = componentData.name;
+        this.isError = false;
+
+        this.#renderActivityStopped = false;
+        this.#renderActivity = this.getInstrumentation().startRenderActivity(this._getInstrumentationContext());
+
+        try {
+            this.getEnv().parentPostMessage({ type: "lo.ready" });
+        } catch (err) {
+            this.isError = true;
+            this._handleRenderError(err);
+        }
+    }
+
+    setComponentProps(componentProps) {
+        if (!componentProps) {
+            return;
+        }
+        this.embeddedCmpProps = componentProps;
+    }
+
+    resolveEmbeddedCmpSpecifier(embeddedCmpName) {
+        const [, version] = embeddedCmpName.split("/v/");
+        const calculatedVersion = version || "0_0_1";
+
+        return { specifier: `aura/interop/v/${calculatedVersion}`, type: "aura" };
+    }
+
+    renderedCallback() {
+        super.renderedCallback();
+        if (this.refs?.embeddedCmp) {
+            this._stopRenderActivity();
+        }
+    }
+
+    _handleRenderError(err) {
+        this.getInstrumentation().errorRenderActivity(this.#renderActivity, err, {
+            ...this._getInstrumentationContext(),
+            componentProps: JSON.stringify(this.embeddedCmpProps || {}),
+            message: err?.message,
+            hasError: true,
+        });
+        this._stopRenderActivity({ hasError: true });
+    }
+
+    _stopRenderActivity(details = {}) {
+        if (!this.#renderActivity || this.#renderActivityStopped) {
+            return;
+        }
+        this.getInstrumentation().stopRenderActivity(this.#renderActivity, {
+            ...this._getInstrumentationContext(),
+            hasError: this.isError,
+            ...details,
+        });
+        this.#renderActivityStopped = true;
+    }
+
+    _getInstrumentationContext() {
+        return {
+            componentName: this.embeddedCmpName,
+            componentType: this.embeddedCmpType,
+            loAppOrigin: this.getEnv().loAppOrigin,
+        };
+    }
+}

package/dist/modules/force/lightningOutLWRAuraContainer/lightningOutLWRAuraContainer.js-meta.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
+    <isExposed>false</isExposed>
+</LightningComponentBundle>

package/dist/modules/force/lightningOutLWRAuraContainer/utils/errorHandling.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import {
+    CLIENT_ERROR_TYPES,
+    onError,
+    onHttpError,
+    onInvalidSession,
+    onUnhandledRejection,
+} from "@lwrjs/globalErrorHandler";
+
+export function createErrorHooks(parentPostMessage, logError) {
+    function post(type, payload) {
+        parentPostMessage({ type: "lo.error", error: { ...payload, type } });
+        logError(payload);
+        return { handled: true };
+    }
+
+    onError((error, type) => post(type, { message: `Error: ${error.message}` }));
+    onUnhandledRejection((error, type) =>
+        post(type, {
+            message: `Unhandled Promise Rejection: ${error.message}`,
+        }),
+    );
+    onInvalidSession((error, type) => post(type, { message: `Invalid Session: ${error.message}` }));
+    onHttpError((error, type) => {
+        if (type === CLIENT_ERROR_TYPES.HTTP_ERROR) {
+            const status = error.status || (error.response && error.response.status);
+            if (status) {
+                let message = "";
+                switch (status) {
+                    case 401:
+                        message = "Session expired or unauthorized. Please log in again.";
+                        break;
+                    case 429:
+                        message = "Too many requests. Please try again later.";
+                        break;
+                    default:
+                        if (status >= 500) {
+                            message = "A server error occurred. Please try again later.";
+                        }
+                        break;
+                }
+                return post(type, {
+                    status,
+                    message: `HTTP Error: ${message}`,
+                });
+            }
+        }
+        return { handled: false };
+    });
+}

package/dist/modules/force/lightningOutLWRAuraContainer/utils/gater.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import disableBeaconGate from "@salesforce/gate/org.salesforce.lo2.lwr.disableBeacon";
+
+/**
+ * @returns {boolean} Checks if the beacon feature is enabled.
+ */
+export function isBeaconEnabled() {
+    return !disableBeaconGate.isOpen({ fallback: false });
+}

package/dist/modules/force/lightningOutLWRContainer/lightningOutLWRContainer.html

@@ -0,0 +1,7 @@
+<template lwc:render-mode="light">
+    <lwc:component
+        lwc:is={embeddedCmpCtor}
+        lwc:ref="embeddedCmp"
+        lwc:spread={embeddedCmpProps}
+    ></lwc:component>
+</template>

package/dist/modules/force/lightningOutLWRContainer/lightningOutLWRContainer.js

@@ -0,0 +1,7 @@
+/*
+ * Copyright 2024 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+export { default } from "force/lightningOutBaseContainer";

package/dist/modules/force/lightningOutLWRContainer/lightningOutLWRContainer.js-meta.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
+    <isExposed>true</isExposed>
+    <targets>
+        <target>lightningCommunity__Page</target>
+        <target>lightningCommunity__Default</target>
+    </targets>
+</LightningComponentBundle>

package/dist/modules/force/lightningOutOneRuntimeContainer/lightningOutOneRuntimeContainer.html

@@ -0,0 +1,14 @@
+<template lwc:render-mode="light">
+    <div lwc:if={includeBeacon}>
+        <aura-interop
+            descriptor="instrumentation:beacon"
+            config={config}
+        ></aura-interop>
+    </div>
+    <lwrlex-instrumentation></lwrlex-instrumentation>
+    <lwc:component
+        lwc:is={embeddedCmpCtor}
+        lwc:ref="embeddedCmp"
+        lwc:spread={embeddedCmpProps}
+    ></lwc:component>
+</template>

package/dist/modules/force/lightningOutOneRuntimeContainer/lightningOutOneRuntimeContainer.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import LightningOutBaseContainer from "force/lightningOutBaseContainer";
+
+import { createErrorHooks } from "./utils/errorHandling";
+import { isBeaconEnabled } from "./utils/gater";
+
+export default class LightningOutOneRuntimeContainer extends LightningOutBaseContainer {
+    #includeBeacon = false;
+    config = {
+        usePageTransactions: false,
+        disableAvroValidation: false,
+    };
+
+    constructor() {
+        super();
+        createErrorHooks(this.getEnv().parentPostMessage, this.getInstrumentation().logError);
+        this.#includeBeacon = isBeaconEnabled();
+    }
+
+    get includeBeacon() {
+        return this.#includeBeacon;
+    }
+
+    resolveEmbeddedCmpSpecifier(embeddedCmpName) {
+        const [name, version] = embeddedCmpName.split("/v/");
+        const type = name.includes(":") ? "aura" : "lwc";
+        const calculatedVersion = version || "0_0_1";
+        if (type === "aura") {
+            return { specifier: `aura/interop/v/${calculatedVersion}`, type };
+        }
+        return { specifier: `${name}/v/${calculatedVersion}`, type };
+    }
+}

package/dist/modules/force/lightningOutOneRuntimeContainer/lightningOutOneRuntimeContainer.js-meta.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
+    <isExposed>false</isExposed>
+</LightningComponentBundle>

package/dist/modules/force/lightningOutOneRuntimeContainer/utils/errorHandling.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import {
+    CLIENT_ERROR_TYPES,
+    onError,
+    onHttpError,
+    onInvalidSession,
+    onUnhandledRejection,
+} from "@lwrjs/globalErrorHandler";
+
+export function createErrorHooks(parentPostMessage, logError) {
+    function post(type, payload) {
+        parentPostMessage({ type: "lo.error", error: { ...payload, type } });
+        logError(payload);
+        return { handled: true };
+    }
+
+    onError((error, type) => post(type, { message: `Error: ${error.message}` }));
+    onUnhandledRejection((error, type) =>
+        post(type, {
+            message: `Unhandled Promise Rejection: ${error.message}`,
+        }),
+    );
+    onInvalidSession((error, type) => post(type, { message: `Invalid Session: ${error.message}` }));
+    onHttpError((error, type) => {
+        if (type === CLIENT_ERROR_TYPES.HTTP_ERROR) {
+            const status = error.status || (error.response && error.response.status);
+            if (status) {
+                let message = "";
+                if (status === 401) {
+                    message = "Session expired or unauthorized. Please log in again.";
+                } else if (status === 429) {
+                    message = "Too many requests. Please try again later.";
+                } else if (status >= 500) {
+                    message = "A server error occurred. Please try again later.";
+                }
+                return post(type, {
+                    status,
+                    message: `HTTP Error: ${message}`,
+                });
+            }
+        }
+        return { handled: false };
+    });
+}

package/dist/modules/force/lightningOutOneRuntimeContainer/utils/gater.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright 2025 salesforce.com, inc.
+ * All Rights Reserved
+ * Company Confidential
+ */
+
+import disableBeaconGate from "@salesforce/gate/org.salesforce.lo2.lwr.disableBeacon";
+
+/**
+ * @returns {boolean} Checks if the beacon feature is enabled.
+ */
+export function isBeaconEnabled() {
+    return !disableBeaconGate.isOpen({ fallback: false });
+}

package/package.json

@@ -0,0 +1,18 @@
+{
+    "name": "@lightning-out/containers",
+    "version": "2.2.0-rc.0",
+    "private": false,
+    "description": "Lightning Out 2.0 Container Components",
+    "type": "module",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "node scripts/build.mjs",
+        "typecheck": "tsc --noEmit",
+        "clean": "rimraf dist"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}