@elliemae/pui-app-sdk 5.40.3 → 5.40.5

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

@@ -506,11 +506,12 @@ class CMicroAppGuest {
   /**
    * removes scripting object from child microapp use
    * @param objectId unique id of the scripting object
+   * @param guestId optional guest id when removing a guest-scoped object
    */
-  removeScriptingObject(objectId) {
+  removeScriptingObject(objectId, guestId) {
     if (this.#appBridge) {
-      this.#appBridge.removeScriptingObject(objectId);
+      this.#appBridge.removeScriptingObject(objectId, guestId);
     }
-    this.#ssfHostRef.removeScriptingObject(objectId);
+    this.#ssfHostRef.removeScriptingObject(objectId, guestId);
   }
 }

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

@@ -254,11 +254,12 @@ class CMicroAppHost {
   /**
    * removes scripting object from child microapp use
    * @param objectId unique id of the scripting object
+   * @param guestId optional guest id when removing a guest-scoped object
    */
-  removeScriptingObject(objectId) {
+  removeScriptingObject(objectId, guestId) {
     if (this.#appBridge) {
-      this.#appBridge.removeScriptingObject(objectId);
+      this.#appBridge.removeScriptingObject(objectId, guestId);
     }
-    this.#ssfHostRef.removeScriptingObject(objectId);
+    this.#ssfHostRef.removeScriptingObject(objectId, guestId);
   }
 }

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

@@ -58,6 +58,7 @@ const getVersionedPath = (path) => {
     majorMinorVersion && majorMinorVersion[0] || "latest"
   );
 };
+const appendTrailingSlash = (path) => path?.replace?.(/\/?$/, "/");
 const getMicroFrontEndAppConfig = (appInfo) => {
   const microFEAppConfig = (0, import_config.getAppConfigValue)(
     `microFrontendApps.${appInfo.id}`
@@ -84,6 +85,8 @@ const getMicroFrontEndAppConfig = (appInfo) => {
   microFEConfig.hostUrl = (0, import_helpers.convertRelativeToAbsoluteUrl)(
     microFEConfig.hostUrl.replace(/\/?$/, "/")
   );
-  microFEConfig.manifestPath = getVersionedPath(microFEConfig.manifestPath);
+  microFEConfig.manifestPath = appendTrailingSlash(
+    getVersionedPath(microFEConfig.manifestPath)
+  );
   return microFEConfig;
 };

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%;
@@ -48,6 +49,7 @@ const Div = import_styled_components.default.div`
   flex-direction: column;
   overflow: hidden;
 `;
+const isAbortError = (error) => error instanceof DOMException ? error.name === "AbortError" : error instanceof Error && error.name === "AbortError";
 const useAppRenderer = (props) => {
   const {
     id,
@@ -58,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
@@ -77,8 +88,10 @@ const useAppRenderer = (props) => {
     let ssfHost = null;
     let unloadInProgress = Promise.resolve();
     let instanceId = null;
+    const abortController = new AbortController();
     (async () => {
       await unloadInProgress;
+      if (!isMounted || abortController.signal.aborted) return;
       if (!disableWaitMessage) {
         dispatch(import_actions.waitMessage.open());
       }
@@ -101,7 +114,7 @@ const useAppRenderer = (props) => {
             throw new Error(`Failed to load ${id}, SSFHost not initialized`);
           if (!hostUrl)
             throw new Error(`Failed to load ${id}, hostUrl not configured`);
-          if (isMounted) {
+          if (isMounted && !abortController.signal.aborted) {
             const { searchParams, ...guestOptions } = mergedSsfAppOptions;
             const ssfUrlObj = new URL(hostUrl);
             if (initialRoute) {
@@ -133,18 +146,25 @@ const useAppRenderer = (props) => {
           appBridge = await (0, import_app_bridge.getAppBridge)();
           if (!appBridge)
             throw new Error(`Failed to load ${id}, AppBridge not initialized`);
-          if (isMounted) {
+          if (isMounted && !abortController.signal.aborted) {
             instanceId = await appBridge.openApp({
               id,
               selfInitialize: configSelfInitialize,
               frameOptions: {
+                ...resolvedFrameOptions,
                 containerId,
-                queryParams: (0, import_pui_logrocket.buildLogRocketQueryParams)()
+                queryParams: (0, import_pui_logrocket.buildLogRocketQueryParams)(),
+                signal: abortController.signal
               },
-              history,
+              history: guestHistory,
               homeRoute,
               initialRoute
             });
+            if (!isMounted || abortController.signal.aborted) {
+              await appBridge.closeApp(instanceId);
+              instanceId = null;
+              return;
+            }
             setTimeout(() => {
               try {
                 onLoadComplete?.(instanceId);
@@ -158,6 +178,7 @@ const useAppRenderer = (props) => {
           }
         }
       } catch (ex) {
+        if (isAbortError(ex)) return;
         (0, import_micro_frontend.getLogger)().error({
           message: `Failed to load ${id}`,
           exception: ex
@@ -167,7 +188,6 @@ const useAppRenderer = (props) => {
           unloadInProgress = appBridge.closeApp(instanceId);
         if (ssfHost && instanceId)
           unloadInProgress = Promise.resolve(ssfHost.unloadGuest(instanceId));
-        throw ex;
       } finally {
         if (!disableWaitMessage) {
           dispatch(import_actions.waitMessage.close());
@@ -175,6 +195,7 @@ const useAppRenderer = (props) => {
       }
     })();
     return () => {
+      abortController.abort();
       isMounted = false;
       if (ssfHost && instanceId) {
         unloadInProgress = Promise.resolve(ssfHost.unloadGuest(instanceId));
@@ -203,7 +224,7 @@ const useAppRenderer = (props) => {
   }, [
     containerId,
     dispatch,
-    history,
+    guestHistory,
     homeRoute,
     initialRoute,
     id,
@@ -211,7 +232,8 @@ const useAppRenderer = (props) => {
     onUnloadComplete,
     getConfig,
     stableSsfAppOptions,
-    disableWaitMessage
+    disableWaitMessage,
+    resolvedFrameOptions
   ]);
 };
 const GuestMicroApp = (0, import_react.memo)(

package/dist/cjs/view/tests/__snapshots__/micro-iframe-app.test.tsx.snap

@@ -156,7 +156,7 @@ exports[`MicroIFrameApp should close previous instance of app before loading new
   
   
   <base
-    href="http://localhost:3111/loan/latest"
+    href="http://localhost:3111/loan/latest/"
   />
   <link
     crossorigin="anonymous"
@@ -286,7 +286,7 @@ exports[`MicroIFrameApp should open loanapp and call init and mount methods 1`]
   
   
   <base
-    href="http://localhost:3111/loan/latest"
+    href="http://localhost:3111/loan/latest/"
   />
   <link
     crossorigin="anonymous"

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

@@ -473,12 +473,13 @@ class CMicroAppGuest {
   /**
    * removes scripting object from child microapp use
    * @param objectId unique id of the scripting object
+   * @param guestId optional guest id when removing a guest-scoped object
    */
-  removeScriptingObject(objectId) {
+  removeScriptingObject(objectId, guestId) {
     if (this.#appBridge) {
-      this.#appBridge.removeScriptingObject(objectId);
+      this.#appBridge.removeScriptingObject(objectId, guestId);
     }
-    this.#ssfHostRef.removeScriptingObject(objectId);
+    this.#ssfHostRef.removeScriptingObject(objectId, guestId);
   }
 }
 export {

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

@@ -239,12 +239,13 @@ class CMicroAppHost {
   /**
    * removes scripting object from child microapp use
    * @param objectId unique id of the scripting object
+   * @param guestId optional guest id when removing a guest-scoped object
    */
-  removeScriptingObject(objectId) {
+  removeScriptingObject(objectId, guestId) {
     if (this.#appBridge) {
-      this.#appBridge.removeScriptingObject(objectId);
+      this.#appBridge.removeScriptingObject(objectId, guestId);
     }
-    this.#ssfHostRef.removeScriptingObject(objectId);
+    this.#ssfHostRef.removeScriptingObject(objectId, guestId);
   }
 }
 export {

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

@@ -21,6 +21,7 @@ const getVersionedPath = (path) => {
     majorMinorVersion && majorMinorVersion[0] || "latest"
   );
 };
+const appendTrailingSlash = (path) => path?.replace?.(/\/?$/, "/");
 const getMicroFrontEndAppConfig = (appInfo) => {
   const microFEAppConfig = getAppConfigValue(
     `microFrontendApps.${appInfo.id}`
@@ -47,7 +48,9 @@ const getMicroFrontEndAppConfig = (appInfo) => {
   microFEConfig.hostUrl = convertRelativeToAbsoluteUrl(
     microFEConfig.hostUrl.replace(/\/?$/, "/")
   );
-  microFEConfig.manifestPath = getVersionedPath(microFEConfig.manifestPath);
+  microFEConfig.manifestPath = appendTrailingSlash(
+    getVersionedPath(microFEConfig.manifestPath)
+  );
   return microFEConfig;
 };
 export {

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%;
@@ -20,6 +24,7 @@ const Div = styled.div`
   flex-direction: column;
   overflow: hidden;
 `;
+const isAbortError = (error) => error instanceof DOMException ? error.name === "AbortError" : error instanceof Error && error.name === "AbortError";
 const useAppRenderer = (props) => {
   const {
     id,
@@ -30,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
@@ -49,8 +63,10 @@ const useAppRenderer = (props) => {
     let ssfHost = null;
     let unloadInProgress = Promise.resolve();
     let instanceId = null;
+    const abortController = new AbortController();
     (async () => {
       await unloadInProgress;
+      if (!isMounted || abortController.signal.aborted) return;
       if (!disableWaitMessage) {
         dispatch(waitMessage.open());
       }
@@ -73,7 +89,7 @@ const useAppRenderer = (props) => {
             throw new Error(`Failed to load ${id}, SSFHost not initialized`);
           if (!hostUrl)
             throw new Error(`Failed to load ${id}, hostUrl not configured`);
-          if (isMounted) {
+          if (isMounted && !abortController.signal.aborted) {
             const { searchParams, ...guestOptions } = mergedSsfAppOptions;
             const ssfUrlObj = new URL(hostUrl);
             if (initialRoute) {
@@ -105,18 +121,25 @@ const useAppRenderer = (props) => {
           appBridge = await getAppBridge();
           if (!appBridge)
             throw new Error(`Failed to load ${id}, AppBridge not initialized`);
-          if (isMounted) {
+          if (isMounted && !abortController.signal.aborted) {
             instanceId = await appBridge.openApp({
               id,
               selfInitialize: configSelfInitialize,
               frameOptions: {
+                ...resolvedFrameOptions,
                 containerId,
-                queryParams: buildLogRocketQueryParams()
+                queryParams: buildLogRocketQueryParams(),
+                signal: abortController.signal
               },
-              history,
+              history: guestHistory,
               homeRoute,
               initialRoute
             });
+            if (!isMounted || abortController.signal.aborted) {
+              await appBridge.closeApp(instanceId);
+              instanceId = null;
+              return;
+            }
             setTimeout(() => {
               try {
                 onLoadComplete?.(instanceId);
@@ -130,6 +153,7 @@ const useAppRenderer = (props) => {
           }
         }
       } catch (ex) {
+        if (isAbortError(ex)) return;
         getLogger().error({
           message: `Failed to load ${id}`,
           exception: ex
@@ -139,7 +163,6 @@ const useAppRenderer = (props) => {
           unloadInProgress = appBridge.closeApp(instanceId);
         if (ssfHost && instanceId)
           unloadInProgress = Promise.resolve(ssfHost.unloadGuest(instanceId));
-        throw ex;
       } finally {
         if (!disableWaitMessage) {
           dispatch(waitMessage.close());
@@ -147,6 +170,7 @@ const useAppRenderer = (props) => {
       }
     })();
     return () => {
+      abortController.abort();
       isMounted = false;
       if (ssfHost && instanceId) {
         unloadInProgress = Promise.resolve(ssfHost.unloadGuest(instanceId));
@@ -175,7 +199,7 @@ const useAppRenderer = (props) => {
   }, [
     containerId,
     dispatch,
-    history,
+    guestHistory,
     homeRoute,
     initialRoute,
     id,
@@ -183,7 +207,8 @@ const useAppRenderer = (props) => {
     onUnloadComplete,
     getConfig,
     stableSsfAppOptions,
-    disableWaitMessage
+    disableWaitMessage,
+    resolvedFrameOptions
   ]);
 };
 const GuestMicroApp = memo(

package/dist/esm/view/tests/__snapshots__/micro-iframe-app.test.tsx.snap

@@ -156,7 +156,7 @@ exports[`MicroIFrameApp should close previous instance of app before loading new
   
   
   <base
-    href="http://localhost:3111/loan/latest"
+    href="http://localhost:3111/loan/latest/"
   />
   <link
     crossorigin="anonymous"
@@ -286,7 +286,7 @@ exports[`MicroIFrameApp should open loanapp and call init and mount methods 1`]
   
   
   <base
-    href="http://localhost:3111/loan/latest"
+    href="http://localhost:3111/loan/latest/"
   />
   <link
     crossorigin="anonymous"

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

@@ -134,7 +134,8 @@ export declare class CMicroAppGuest<AppObjects extends ScriptingObjects = Partia
     /**
      * removes scripting object from child microapp use
      * @param objectId unique id of the scripting object
+     * @param guestId optional guest id when removing a guest-scoped object
      */
-    removeScriptingObject(objectId: Extract<keyof AppObjects, string>): void;
+    removeScriptingObject(objectId: Extract<keyof AppObjects, string>, guestId?: string): void;
 }
 export {};

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

@@ -116,7 +116,8 @@ export declare class CMicroAppHost<AppObjects extends ScriptingObjects = Partial
     /**
      * removes scripting object from child microapp use
      * @param objectId unique id of the scripting object
+     * @param guestId optional guest id when removing a guest-scoped object
      */
-    removeScriptingObject(objectId: Extract<keyof AppObjects, string>): void;
+    removeScriptingObject(objectId: Extract<keyof AppObjects, string>, guestId?: string): void;
 }
 export {};

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

@@ -73,14 +73,16 @@ 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 CMicroAppHost.addScriptingObject}
- * or {@link CMicroAppGuest.addScriptingObject} (not directly on the app
- * bridge) so it is added to both the App Bridge and the SSF Host.
+ * Register the returned object via {@link CMicroApp.addScriptingObject}
+ * (not directly on the app bridge) so it is added to both the App Bridge
+ * and the SSF Host.
  * @param guestId - App id as defined in app.config.json (e.g. 'loanapp')
  * @param params - Host-provided values (theme, history, initialRoute, custom keys)
  * @param overrides - Method overrides / additions (e.g. custom getCapabilities)
- * @returns IModule scripting object ready for CMicroAppHost/CMicroApp.addScriptingObject()
+ * @returns IModule scripting object ready for {@link CMicroApp.addScriptingObject}
  */
 export declare const createGuestModule: (guestId: string, params?: HostProvidedParams, overrides?: ModuleOverrides) => IModule;

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;