@elliemae/pui-app-sdk 5.40.4 → 5.41.0

package/demo/project.json

@@ -1 +1 @@
-{"generatedAt":1780016084078,"builder":{"name":"webpack5"},"hasCustomBabel":false,"hasCustomWebpack":true,"hasStaticDirs":false,"hasStorybookEslint":false,"refCount":0,"packageManager":{"type":"pnpm","version":"8.15.9"},"typescriptOptions":{"check":false,"checkOptions":{},"reactDocgen":false,"reactDocgenTypescriptOptions":{"shouldExtractLiteralValuesFromEnum":true,"compilerOptions":{"allowSyntheticDefaultImports":false,"esModuleInterop":false}}},"features":{"fastRefresh":true,"storyStoreV7":true},"language":"javascript","storybookPackages":{},"framework":{"options":{"fastRefresh":true,"strictMode":true,"legacyRootApi":true}},"addons":{"@storybook/addon-docs":{"options":{"sourceLoaderOptions":{"injectStoryParameters":false}},"version":"6.5.16"},"@storybook/addon-essentials":{"options":{"docs":false},"version":"6.5.16"},"@storybook/addon-storysource":{"version":"6.5.16"},"@storybook/addon-links":{"version":"6.5.16"},"@storybook/addon-events":{"version":"6.2.9"},"@storybook/addon-interactions":{"version":"6.5.16"},"@storybook/addon-a11y":{"version":"6.5.16"},"storybook-addon-turbo-build":{"options":{"optimizationLevel":2,"esbuildMinifyOptions":{"target":"es2022"}},"version":"1.1.0"}}}
+{"generatedAt":1782148675244,"builder":{"name":"webpack5"},"hasCustomBabel":false,"hasCustomWebpack":true,"hasStaticDirs":false,"hasStorybookEslint":false,"refCount":0,"packageManager":{"type":"pnpm","version":"8.15.9"},"typescriptOptions":{"check":false,"checkOptions":{},"reactDocgen":false,"reactDocgenTypescriptOptions":{"shouldExtractLiteralValuesFromEnum":true,"compilerOptions":{"allowSyntheticDefaultImports":false,"esModuleInterop":false}}},"features":{"fastRefresh":true,"storyStoreV7":true},"language":"javascript","storybookPackages":{},"framework":{"options":{"fastRefresh":true,"strictMode":true,"legacyRootApi":true}},"addons":{"@storybook/addon-docs":{"options":{"sourceLoaderOptions":{"injectStoryParameters":false}},"version":"6.5.16"},"@storybook/addon-essentials":{"options":{"docs":false},"version":"6.5.16"},"@storybook/addon-storysource":{"version":"6.5.16"},"@storybook/addon-links":{"version":"6.5.16"},"@storybook/addon-events":{"version":"6.2.9"},"@storybook/addon-interactions":{"version":"6.5.16"},"@storybook/addon-a11y":{"version":"6.5.16"},"storybook-addon-turbo-build":{"options":{"optimizationLevel":2,"esbuildMinifyOptions":{"target":"es2022"}},"version":"1.1.0"}}}

package/dist/cjs/utils/micro-frontend/guest-host-context.js

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var guest_host_context_exports = {};
+__export(guest_host_context_exports, {
+  resolveGuestOpenHistory: () => resolveGuestOpenHistory,
+  resolveNestedGuestFrameOptions: () => resolveNestedGuestFrameOptions
+});
+module.exports = __toCommonJS(guest_host_context_exports);
+var import_config = require("../app-config/config.js");
+var import_history = require("../history.js");
+var import_guest = require("./guest.js");
+const resolveGuestOpenHistory = (explicitHistory) => {
+  const hostUsesParentHistory = (0, import_config.getAppConfigValue)(
+    "useParentHistory",
+    true
+  );
+  if (hostUsesParentHistory && typeof window !== "undefined" && window.self !== window.top && import_guest.CMicroAppGuest.isInitialized()) {
+    return import_guest.CMicroAppGuest.getInstance().getProps().history;
+  }
+  return explicitHistory ?? import_history.browserHistory;
+};
+const resolveNestedGuestFrameOptions = (userFrameOptions) => {
+  if (typeof window === "undefined" || window.self === window.top) {
+    return userFrameOptions;
+  }
+  const versionSegment = window.location.hostname === "localhost" ? "latest" : window.emui?.version?.match(/^(\d+\.\d+)/)?.[1] ?? "latest";
+  return {
+    src: `${window.location.origin}/${versionSegment}/frame.html`,
+    ...userFrameOptions
+  };
+};

package/dist/cjs/utils/micro-frontend/guest.js

@@ -83,6 +83,7 @@ class CMicroAppGuest {
    */
   #useV2Guest;
   #selfInitialize;
+  #embeddedWithoutHost;
   /**
    * AppBridge instance
    */
@@ -97,7 +98,7 @@ class CMicroAppGuest {
   onMount;
   onUnmount;
   onGetRef;
-  // eslint-disable-next-line max-statements
+  // eslint-disable-next-line max-statements, complexity
   constructor(params) {
     window.emui.uuid = window.emui.uuid || (0, import_uuid.v4)();
     this.appId = window.emui?.appId || (0, import_config.getAppConfigValue)("appId");
@@ -118,10 +119,16 @@ class CMicroAppGuest {
     this.#ssfHostRef = (0, import_ssf_host2.getSSFHost)();
     this.#useV2Guest = params?.useV2Guest !== false;
     this.#selfInitialize = params?.selfInitialize ?? false;
+    this.#embeddedWithoutHost = params?.embeddedWithoutHost ?? false;
     this.onInit = params?.onInit;
     this.onMount = params?.onMount;
     this.onUnmount = params?.onUnmount;
     this.onGetRef = params?.onGetRef;
+    if (this.#embeddedWithoutHost && !this.#selfInitialize) {
+      this.logger.warn(
+        "embeddedWithoutHost requires selfInitialize: true \u2014 the flag only applies to initialize()"
+      );
+    }
     this.getHost = this.getHost.bind(this);
     this.getLogger = this.getLogger.bind(this);
     this.getProps = this.getProps.bind(this);
@@ -317,6 +324,10 @@ class CMicroAppGuest {
     if (window.emui?.__host) {
       return window.emui.__host;
     }
+    if (!isCrossDomain()) {
+      const legacyHost = window.parent?.emui?.MicroAppHost ?? null;
+      if (legacyHost) return legacyHost;
+    }
     if (this.#useV2Guest) {
       const ssfGuest = new import_ssf_guest.SSFGuest({ appLogger: this.logger });
       const failed = await (0, import_helpers.abortPromise)({
@@ -370,6 +381,33 @@ class CMicroAppGuest {
     const route = typeof params.initialRoute === "string" ? params.initialRoute : params.initialRoute.pathname;
     if (route) this.props.history.push(route);
   }
+  async #loadConfigAndBridge() {
+    await (0, import_app_config.loadAppConfig)();
+    await this.#initAppBridge();
+  }
+  #trackAnalyticsAndOnInit() {
+    const instanceId = this.getSessionStorageItem("instanceId") || "";
+    const userId = this.getSessionStorageItem("userId") || "";
+    (0, import_pui_analytics_so.updateBAEventParameters)({ appId: this.appId, instanceId, userId });
+    if (this.onInit) this.onInit(this.props);
+  }
+  #completeWithoutHost(mode) {
+    if (mode === "standalone") {
+      this.logger.info("Running in standalone mode \u2014 skipping host discovery");
+      this.#exposeGetHost();
+      this.#resolveHistory();
+    } else if (mode === "embeddedWithoutHost") {
+      this.logger.info("embeddedWithoutHost enabled \u2014 skipping host discovery");
+      this.#exposeGetHost();
+    } else {
+      this.logger.warn(
+        "Unable to discover host. Proceeding with app.config.json values. Host-provided parameters (history, theme, initialRoute) will not be available."
+      );
+      this.#exposeGetHost();
+    }
+    this.#trackAnalyticsAndOnInit();
+    return { moduleId: this.appId };
+  }
   /**
    * Guest-initiated lifecycle: discovers the host and applies module
    * parameters if available. After this resolves the guest is ready to render.
@@ -385,20 +423,19 @@ class CMicroAppGuest {
     (0, import_webpack_public_path.syncWebpackPublicPathFromAssetPath)();
     const isStandalone = window.top === window.self && !window.opener;
     if (isStandalone) {
-      await (0, import_app_config.loadAppConfig)();
-      await this.#initAppBridge();
-      this.logger.info("Running in standalone mode \u2014 skipping host discovery");
-      if (this.onInit) this.onInit(this.props);
-      return { moduleId: this.appId };
+      await this.#loadConfigAndBridge();
+      return this.#completeWithoutHost("standalone");
+    }
+    if (this.#embeddedWithoutHost) {
+      await this.#loadConfigAndBridge();
+      return this.#completeWithoutHost("embeddedWithoutHost");
     }
     const [host] = await Promise.all([
       this.#discoverHost(),
-      (0, import_app_config.loadAppConfig)().then(() => this.#initAppBridge())
+      this.#loadConfigAndBridge()
     ]);
     if (!host) {
-      throw new Error(
-        "Unable to discover host. Ensure the host uses an updated pui-app-sdk and pui-microfe, or use the host-initiated model (onInit/onMount)."
-      );
+      return this.#completeWithoutHost("discoveryFallback");
     }
     this.props.host = host;
     this.#exposeGetHost();
@@ -418,10 +455,7 @@ class CMicroAppGuest {
         `Failed to retrieve module parameters for "${this.appId}". Proceeding without host-provided parameters.`
       );
     }
-    const instanceId = this.getSessionStorageItem("instanceId") || "";
-    const userId = this.getSessionStorageItem("userId") || "";
-    (0, import_pui_analytics_so.updateBAEventParameters)({ appId: this.appId, instanceId, userId });
-    if (this.onInit) this.onInit(this.props);
+    this.#trackAnalyticsAndOnInit();
     return params;
   }
   async init(options) {

package/dist/cjs/utils/micro-frontend/module-so.js

@@ -25,6 +25,7 @@ __export(module_so_exports, {
 module.exports = __toCommonJS(module_so_exports);
 var import_ssf_host = require("@elliemae/ssf-host");
 var import_index = require("./index.js");
+var import_guest_host_context = require("./guest-host-context.js");
 var import_const = require("../../view/micro-app/const.js");
 const LOG_LEVEL_METHOD = {
   DEBUG: "debug",
@@ -84,7 +85,10 @@ class GuestModule extends import_ssf_host.ScriptingObject {
   };
 }
 const createGuestModule = (guestId, params = {}, overrides = {}) => {
-  const mod = new GuestModule(guestId, params);
+  const mod = new GuestModule(guestId, {
+    ...params,
+    history: (0, import_guest_host_context.resolveGuestOpenHistory)(params.history)
+  });
   Object.assign(mod, overrides);
   return mod;
 };

package/dist/cjs/utils/micro-frontend/tests/guest-test-utils.js

@@ -0,0 +1,27 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var guest_test_utils_exports = {};
+__export(guest_test_utils_exports, {
+  resetCMicroAppGuestInstance: () => resetCMicroAppGuestInstance
+});
+module.exports = __toCommonJS(guest_test_utils_exports);
+var import_guest = require("../guest.js");
+const resetCMicroAppGuestInstance = () => {
+  Reflect.set(import_guest.CMicroAppGuest, "instance", null);
+};

package/dist/cjs/view/guest-microapp.js

@@ -41,6 +41,7 @@ var import_app_bridge = require("../utils/micro-frontend/app-bridge.js");
 var import_ssf_host2 = require("../utils/micro-frontend/ssf-host.js");
 var import_actions = require("../data/wait-message/actions.js");
 var import_micro_frontend = require("../utils/micro-frontend/index.js");
+var import_guest_host_context = require("../utils/micro-frontend/guest-host-context.js");
 const Div = import_styled_components.default.div`
   display: flex;
   width: 100%;
@@ -59,13 +60,22 @@ const useAppRenderer = (props) => {
     onUnloadComplete,
     containerId,
     ssfAppOptions,
-    disableWaitMessage = false
+    disableWaitMessage = false,
+    frameOptions: userFrameOptions
   } = props;
   const dispatch = (0, import_react_redux.useDispatch)();
   const stableSsfAppOptions = (0, import_react.useMemo)(
     () => ssfAppOptions ?? {},
     [ssfAppOptions]
   );
+  const guestHistory = (0, import_react.useMemo)(
+    () => (0, import_guest_host_context.resolveGuestOpenHistory)(history),
+    [history]
+  );
+  const resolvedFrameOptions = (0, import_react.useMemo)(
+    () => (0, import_guest_host_context.resolveNestedGuestFrameOptions)(userFrameOptions),
+    [userFrameOptions]
+  );
   const getConfig = (0, import_react.useCallback)(
     () => (0, import_micro_frontend.getMicroFrontEndAppConfig)({
       id
@@ -141,11 +151,12 @@ const useAppRenderer = (props) => {
               id,
               selfInitialize: configSelfInitialize,
               frameOptions: {
+                ...resolvedFrameOptions,
                 containerId,
                 queryParams: (0, import_pui_logrocket.buildLogRocketQueryParams)(),
                 signal: abortController.signal
               },
-              history,
+              history: guestHistory,
               homeRoute,
               initialRoute
             });
@@ -213,7 +224,7 @@ const useAppRenderer = (props) => {
   }, [
     containerId,
     dispatch,
-    history,
+    guestHistory,
     homeRoute,
     initialRoute,
     id,
@@ -221,7 +232,8 @@ const useAppRenderer = (props) => {
     onUnloadComplete,
     getConfig,
     stableSsfAppOptions,
-    disableWaitMessage
+    disableWaitMessage,
+    resolvedFrameOptions
   ]);
 };
 const GuestMicroApp = (0, import_react.memo)(

package/dist/cjs/view/tests/scriptingObjects/loan.js

@@ -61,6 +61,10 @@ class Loan extends import_pui_app_bridge.ScriptingObject {
     name: "editmodechange",
     objectId: "loan"
   });
+  ExternallyModified = new import_pui_app_bridge.Event({
+    name: "externallyModified",
+    objectId: "loan"
+  });
   FieldChangeSync = new import_pui_app_bridge.Event({
     name: "fieldChangeSync",
     objectId: "loan"

package/dist/esm/utils/micro-frontend/guest-host-context.js

@@ -0,0 +1,27 @@
+import { getAppConfigValue } from "../app-config/config.js";
+import { browserHistory } from "../history.js";
+import { CMicroAppGuest } from "./guest.js";
+const resolveGuestOpenHistory = (explicitHistory) => {
+  const hostUsesParentHistory = getAppConfigValue(
+    "useParentHistory",
+    true
+  );
+  if (hostUsesParentHistory && typeof window !== "undefined" && window.self !== window.top && CMicroAppGuest.isInitialized()) {
+    return CMicroAppGuest.getInstance().getProps().history;
+  }
+  return explicitHistory ?? browserHistory;
+};
+const resolveNestedGuestFrameOptions = (userFrameOptions) => {
+  if (typeof window === "undefined" || window.self === window.top) {
+    return userFrameOptions;
+  }
+  const versionSegment = window.location.hostname === "localhost" ? "latest" : window.emui?.version?.match(/^(\d+\.\d+)/)?.[1] ?? "latest";
+  return {
+    src: `${window.location.origin}/${versionSegment}/frame.html`,
+    ...userFrameOptions
+  };
+};
+export {
+  resolveGuestOpenHistory,
+  resolveNestedGuestFrameOptions
+};

package/dist/esm/utils/micro-frontend/guest.js

@@ -50,6 +50,7 @@ class CMicroAppGuest {
    */
   #useV2Guest;
   #selfInitialize;
+  #embeddedWithoutHost;
   /**
    * AppBridge instance
    */
@@ -64,7 +65,7 @@ class CMicroAppGuest {
   onMount;
   onUnmount;
   onGetRef;
-  // eslint-disable-next-line max-statements
+  // eslint-disable-next-line max-statements, complexity
   constructor(params) {
     window.emui.uuid = window.emui.uuid || uuidv4();
     this.appId = window.emui?.appId || getAppConfigValue("appId");
@@ -85,10 +86,16 @@ class CMicroAppGuest {
     this.#ssfHostRef = getSSFHost();
     this.#useV2Guest = params?.useV2Guest !== false;
     this.#selfInitialize = params?.selfInitialize ?? false;
+    this.#embeddedWithoutHost = params?.embeddedWithoutHost ?? false;
     this.onInit = params?.onInit;
     this.onMount = params?.onMount;
     this.onUnmount = params?.onUnmount;
     this.onGetRef = params?.onGetRef;
+    if (this.#embeddedWithoutHost && !this.#selfInitialize) {
+      this.logger.warn(
+        "embeddedWithoutHost requires selfInitialize: true \u2014 the flag only applies to initialize()"
+      );
+    }
     this.getHost = this.getHost.bind(this);
     this.getLogger = this.getLogger.bind(this);
     this.getProps = this.getProps.bind(this);
@@ -284,6 +291,10 @@ class CMicroAppGuest {
     if (window.emui?.__host) {
       return window.emui.__host;
     }
+    if (!isCrossDomain()) {
+      const legacyHost = window.parent?.emui?.MicroAppHost ?? null;
+      if (legacyHost) return legacyHost;
+    }
     if (this.#useV2Guest) {
       const ssfGuest = new SSFGuest({ appLogger: this.logger });
       const failed = await abortPromise({
@@ -337,6 +348,33 @@ class CMicroAppGuest {
     const route = typeof params.initialRoute === "string" ? params.initialRoute : params.initialRoute.pathname;
     if (route) this.props.history.push(route);
   }
+  async #loadConfigAndBridge() {
+    await loadAppConfig();
+    await this.#initAppBridge();
+  }
+  #trackAnalyticsAndOnInit() {
+    const instanceId = this.getSessionStorageItem("instanceId") || "";
+    const userId = this.getSessionStorageItem("userId") || "";
+    updateBAEventParameters({ appId: this.appId, instanceId, userId });
+    if (this.onInit) this.onInit(this.props);
+  }
+  #completeWithoutHost(mode) {
+    if (mode === "standalone") {
+      this.logger.info("Running in standalone mode \u2014 skipping host discovery");
+      this.#exposeGetHost();
+      this.#resolveHistory();
+    } else if (mode === "embeddedWithoutHost") {
+      this.logger.info("embeddedWithoutHost enabled \u2014 skipping host discovery");
+      this.#exposeGetHost();
+    } else {
+      this.logger.warn(
+        "Unable to discover host. Proceeding with app.config.json values. Host-provided parameters (history, theme, initialRoute) will not be available."
+      );
+      this.#exposeGetHost();
+    }
+    this.#trackAnalyticsAndOnInit();
+    return { moduleId: this.appId };
+  }
   /**
    * Guest-initiated lifecycle: discovers the host and applies module
    * parameters if available. After this resolves the guest is ready to render.
@@ -352,20 +390,19 @@ class CMicroAppGuest {
     syncWebpackPublicPathFromAssetPath();
     const isStandalone = window.top === window.self && !window.opener;
     if (isStandalone) {
-      await loadAppConfig();
-      await this.#initAppBridge();
-      this.logger.info("Running in standalone mode \u2014 skipping host discovery");
-      if (this.onInit) this.onInit(this.props);
-      return { moduleId: this.appId };
+      await this.#loadConfigAndBridge();
+      return this.#completeWithoutHost("standalone");
+    }
+    if (this.#embeddedWithoutHost) {
+      await this.#loadConfigAndBridge();
+      return this.#completeWithoutHost("embeddedWithoutHost");
     }
     const [host] = await Promise.all([
       this.#discoverHost(),
-      loadAppConfig().then(() => this.#initAppBridge())
+      this.#loadConfigAndBridge()
     ]);
     if (!host) {
-      throw new Error(
-        "Unable to discover host. Ensure the host uses an updated pui-app-sdk and pui-microfe, or use the host-initiated model (onInit/onMount)."
-      );
+      return this.#completeWithoutHost("discoveryFallback");
     }
     this.props.host = host;
     this.#exposeGetHost();
@@ -385,10 +422,7 @@ class CMicroAppGuest {
         `Failed to retrieve module parameters for "${this.appId}". Proceeding without host-provided parameters.`
       );
     }
-    const instanceId = this.getSessionStorageItem("instanceId") || "";
-    const userId = this.getSessionStorageItem("userId") || "";
-    updateBAEventParameters({ appId: this.appId, instanceId, userId });
-    if (this.onInit) this.onInit(this.props);
+    this.#trackAnalyticsAndOnInit();
     return params;
   }
   async init(options) {

package/dist/esm/utils/micro-frontend/module-so.js

@@ -1,5 +1,6 @@
 import { ScriptingObject, Event } from "@elliemae/ssf-host";
 import { getMicroFrontEndAppConfig } from "./index.js";
+import { resolveGuestOpenHistory } from "./guest-host-context.js";
 import { APP_CONTAINER_ID_PREFIX } from "../../view/micro-app/const.js";
 const LOG_LEVEL_METHOD = {
   DEBUG: "debug",
@@ -59,7 +60,10 @@ class GuestModule extends ScriptingObject {
   };
 }
 const createGuestModule = (guestId, params = {}, overrides = {}) => {
-  const mod = new GuestModule(guestId, params);
+  const mod = new GuestModule(guestId, {
+    ...params,
+    history: resolveGuestOpenHistory(params.history)
+  });
   Object.assign(mod, overrides);
   return mod;
 };

package/dist/esm/utils/micro-frontend/tests/guest-test-utils.js

@@ -0,0 +1,7 @@
+import { CMicroAppGuest } from "../guest.js";
+const resetCMicroAppGuestInstance = () => {
+  Reflect.set(CMicroAppGuest, "instance", null);
+};
+export {
+  resetCMicroAppGuestInstance
+};

package/dist/esm/view/guest-microapp.js

@@ -13,6 +13,10 @@ import {
   getLogger,
   getMicroFrontEndAppConfig
 } from "../utils/micro-frontend/index.js";
+import {
+  resolveGuestOpenHistory,
+  resolveNestedGuestFrameOptions
+} from "../utils/micro-frontend/guest-host-context.js";
 const Div = styled.div`
   display: flex;
   width: 100%;
@@ -31,13 +35,22 @@ const useAppRenderer = (props) => {
     onUnloadComplete,
     containerId,
     ssfAppOptions,
-    disableWaitMessage = false
+    disableWaitMessage = false,
+    frameOptions: userFrameOptions
   } = props;
   const dispatch = useDispatch();
   const stableSsfAppOptions = useMemo(
     () => ssfAppOptions ?? {},
     [ssfAppOptions]
   );
+  const guestHistory = useMemo(
+    () => resolveGuestOpenHistory(history),
+    [history]
+  );
+  const resolvedFrameOptions = useMemo(
+    () => resolveNestedGuestFrameOptions(userFrameOptions),
+    [userFrameOptions]
+  );
   const getConfig = useCallback(
     () => getMicroFrontEndAppConfig({
       id
@@ -113,11 +126,12 @@ const useAppRenderer = (props) => {
               id,
               selfInitialize: configSelfInitialize,
               frameOptions: {
+                ...resolvedFrameOptions,
                 containerId,
                 queryParams: buildLogRocketQueryParams(),
                 signal: abortController.signal
               },
-              history,
+              history: guestHistory,
               homeRoute,
               initialRoute
             });
@@ -185,7 +199,7 @@ const useAppRenderer = (props) => {
   }, [
     containerId,
     dispatch,
-    history,
+    guestHistory,
     homeRoute,
     initialRoute,
     id,
@@ -193,7 +207,8 @@ const useAppRenderer = (props) => {
     onUnloadComplete,
     getConfig,
     stableSsfAppOptions,
-    disableWaitMessage
+    disableWaitMessage,
+    resolvedFrameOptions
   ]);
 };
 const GuestMicroApp = memo(

package/dist/esm/view/tests/scriptingObjects/loan.js

@@ -38,6 +38,10 @@ class Loan extends ScriptingObject {
     name: "editmodechange",
     objectId: "loan"
   });
+  ExternallyModified = new Event({
+    name: "externallyModified",
+    objectId: "loan"
+  });
   FieldChangeSync = new Event({
     name: "fieldChangeSync",
     objectId: "loan"

package/dist/types/lib/utils/micro-frontend/guest-host-context.d.ts

@@ -0,0 +1,40 @@
+import type { History } from 'history';
+type NestedGuestFrameOptions = {
+    src?: string;
+};
+/**
+ * History object to use when **opening** a child guest via {@link GuestMicroApp}.
+ * {@link createGuestModule} applies the same resolution for module scripting
+ * objects automatically.
+ *
+ * This only affects what the **host** passes into app-bridge `openApp`. The
+ * **child guest** still decides its final router history during
+ * {@link CMicroAppGuest.initialize} from **its own** `app.config.json`
+ * `useParentHistory` flag:
+ *
+ * - `useParentHistory: true` (default) — uses the history received from the host
+ * - `useParentHistory: false` — uses independent `memoryHistory` inside the
+ *   iframe and ignores the host-provided history
+ *
+ * When this host runs inside a parent iframe and shares parent history itself
+ * (`useParentHistory: true`, the default), the exported `browserHistory`
+ * singleton tracks the iframe shell URL (e.g. `/latest/frame.html`), not the
+ * shared grandparent route (e.g. `/prospects/incomplete-apps`). In that case
+ * the history bound during {@link CMicroAppGuest.initialize} is returned
+ * automatically so shared-history children receive the correct object.
+ *
+ * Hosts with `useParentHistory: false` are unchanged: callers keep passing
+ * `explicitHistory ?? browserHistory`, and guests that want their own URL space
+ * opt out via their own config.
+ * @param explicitHistory
+ */
+export declare const resolveGuestOpenHistory: (explicitHistory?: History) => History;
+/**
+ * Frame options for nested hosts whose bundled frame.html URL targets the
+ * guest dev-server origin while JS executes in the parent iframe document.
+ * App Bridge rewrites cross-origin frame shells; this supplies an explicit
+ * same-origin src when callers pass custom frameOptions.
+ * @param userFrameOptions
+ */
+export declare const resolveNestedGuestFrameOptions: (userFrameOptions?: NestedGuestFrameOptions) => NestedGuestFrameOptions | undefined;
+export {};

package/dist/types/lib/utils/micro-frontend/guest.d.ts

@@ -40,6 +40,12 @@ interface ConstructorParams {
      * the bridge will not call these methods.
      */
     selfInitialize?: boolean;
+    /**
+     * When true, the guest is embedded in an iframe but not hosted by PUI app
+     * bridge or SSF. Skips host discovery and initializes from app.config.json
+     * with in-memory history. Ignored when running standalone (top-level window).
+     */
+    embeddedWithoutHost?: boolean;
 }
 /**
  * Micro-frontend guest application class (singleton).

package/dist/types/lib/utils/micro-frontend/module-so.d.ts

@@ -73,7 +73,9 @@ export type ModuleOverrides = {
  *
  * Internally calls {@link buildModuleParams} to merge the app config
  * values (hostUrl, manifestPath, homeRoute) with host-provided values
- * (theme, history, initialRoute).
+ * (theme, history, initialRoute). When nested under a parent iframe,
+ * {@link resolveGuestOpenHistory} is applied to `params.history` automatically
+ * (same behavior as {@link GuestMicroApp}).
  *
  * Register the returned object via {@link CMicroApp.addScriptingObject}
  * (not directly on the app bridge) so it is added to both the App Bridge

package/dist/types/lib/utils/micro-frontend/tests/guest-host-context.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/lib/utils/micro-frontend/tests/guest-test-utils.d.ts

@@ -0,0 +1,2 @@
+/** Clears the guest singleton between tests. */
+export declare const resetCMicroAppGuestInstance: () => void;

package/dist/types/lib/view/guest-microapp.d.ts

@@ -37,6 +37,10 @@ export type GuestMicroAppParams = OpenAppParams & {
  * this component, and remove it on teardown. Host-provided `theme` and
  * `history` for self-initializing guests belong on that module SO — not on
  * {@link GuestMicroApp} / {@link OpenAppParams}.
+ *
+ * When this app is itself a nested guest (running inside a parent iframe),
+ * {@link GuestMicroApp} automatically forwards the shared grandparent history
+ * to child guests — callers do not need to pass `history` explicitly.
  * @param props - The props for the MicroApp component.
  */
 export declare const GuestMicroApp: import("react").NamedExoticComponent<Omit<GuestMicroAppParams, "containerId">>;

package/dist/types/lib/view/tests/scriptingObjects/loan.d.ts

@@ -8,6 +8,7 @@ export declare class Loan extends ScriptingObject implements ILoan {
     readonly Change: Event<Events>;
     readonly Committed: Event<Events>;
     readonly EditModeChange: Event<Events>;
+    readonly ExternallyModified: Event<Events>;
     readonly FieldChangeSync: Event<Events>;
     readonly MilestoneCompleted: Event<Events>;
     readonly Open: Event<Events>;