@elliemae/pui-app-sdk 5.40.0-beta.1 → 5.40.0-beta.2

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

@@ -322,11 +322,14 @@ class CMicroAppGuest {
     if (route) this.props.history.push(route);
   }
   /**
-   * Guest-initiated lifecycle: discovers the host, pulls module parameters,
-   * and applies them. After this resolves the guest is ready to render.
+   * Guest-initiated lifecycle: discovers the host and applies module
+   * parameters if available. After this resolves the guest is ready to render.
    * Requires selfInitialize: true in the constructor so the bridge
    * skips calling init() / mount() on this guest.
-   * @returns module parameters provided by the host
+   *
+   * The module scripting object is optional — if the host did not register
+   * one, a warning is logged and the guest proceeds with its own config.
+   * @returns module parameters provided by the host, or a minimal object with moduleId
    */
   async initialize() {
     const isStandalone = window.top === window.self && !window.opener;
@@ -343,14 +346,22 @@ class CMicroAppGuest {
       );
     }
     this.props.host = host;
-    const module = await host.getObject("module");
-    if (!module) {
-      throw new Error(
-        `Host did not register a module scripting object for guest "${this.appId}". Ensure the host registers a module SO before rendering GuestMicroApp.`
+    let params = { moduleId: this.appId };
+    try {
+      const module = await host.getObject("module");
+      if (module) {
+        params = await module.getParameters();
+        this.#applyModuleParams(params);
+      } else {
+        this.logger.warn(
+          `Host did not register a module scripting object for "${this.appId}". Proceeding without host-provided parameters (history, theme, initialRoute).`
+        );
+      }
+    } catch (ex) {
+      this.logger.warn(
+        `Failed to retrieve module parameters for "${this.appId}". Proceeding without host-provided parameters.`
       );
     }
-    const params = await module.getParameters();
-    this.#applyModuleParams(params);
     if (this.onInit) this.onInit(this.props);
     return params;
   }

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

@@ -60,6 +60,7 @@ const useAppRenderer = (props) => {
           hostUrl,
           title,
           name,
+          selfInitialize: configSelfInitialize,
           ssfAppOptions: configSsfAppOptions = {}
         } = getConfig();
         const mergedSsfAppOptions = {
@@ -107,6 +108,7 @@ const useAppRenderer = (props) => {
           if (isMounted) {
             instanceId = await appBridge.openApp({
               id,
+              selfInitialize: configSelfInitialize,
               frameOptions: {
                 containerId,
                 queryParams: buildLogRocketQueryParams()

package/dist/esm/view/tests/app.config.json

@@ -25,6 +25,17 @@
         "style": "border: 2px solid red;"
       }
     },
+    "loanapp-selfinit": {
+      "name": "Loan Self Init",
+      "hostUrl": "./loan",
+      "selfInitialize": true,
+      "development": {
+        "files": ["index.js"]
+      },
+      "production": {
+        "files": ["index.js"]
+      }
+    },
     "taskapp": {
       "name": "Task",
       "hostUrl": "./task",

package/dist/esm/view/tests/constants.js

@@ -1,6 +1,7 @@
 const LATEST_VERSION = "latest";
 const RELEASE_VERSION = "23.1.0";
 const LOAN_APP_ID = "loanapp";
+const LOAN_SELF_INIT_APP_ID = "loanapp-selfinit";
 const SSF_APP_ID = "ssfapp";
 const TASK_APP_ID = "taskapp";
 const FLIGHTS_APP_ID = "flights";
@@ -19,6 +20,7 @@ export {
   LATEST_VERSION,
   LOAN_APP_ID,
   LOAN_SAVED_EVENT,
+  LOAN_SELF_INIT_APP_ID,
   PRE_COMMIT_EVENT,
   RELEASE_VERSION,
   SSF_APP_ID,

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

@@ -96,11 +96,14 @@ export declare class CMicroAppGuest<AppObjects extends ScriptingObjects = Partia
     private findHost;
     get uuid(): string;
     /**
-     * Guest-initiated lifecycle: discovers the host, pulls module parameters,
-     * and applies them. After this resolves the guest is ready to render.
+     * Guest-initiated lifecycle: discovers the host and applies module
+     * parameters if available. After this resolves the guest is ready to render.
      * Requires selfInitialize: true in the constructor so the bridge
      * skips calling init() / mount() on this guest.
-     * @returns module parameters provided by the host
+     *
+     * The module scripting object is optional — if the host did not register
+     * one, a warning is logged and the guest proceeds with its own config.
+     * @returns module parameters provided by the host, or a minimal object with moduleId
      */
     initialize(): Promise<ModuleParameters>;
     init(options: InitOptions<AppObjects, AppEvents>): Promise<void>;

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

@@ -127,6 +127,12 @@ export type MicroAppConfig = {
      * options for ssf based micro-frontend applications.
      */
     ssfAppOptions?: SSFAppOptions<Record<string, string | number | boolean>>;
+    /**
+     * When true the guest drives its own lifecycle via `initialize()` and
+     * the bridge skips calling `init()` / `mount()` on the guest.
+     * Set this in the `microFrontendApps` section of `app.config.json`.
+     */
+    selfInitialize?: boolean;
     /**
      * The Document object associated with the micro-frontend application.
      */

package/dist/types/lib/view/tests/constants.d.ts

@@ -1,6 +1,7 @@
 export declare const LATEST_VERSION = "latest";
 export declare const RELEASE_VERSION = "23.1.0";
 export declare const LOAN_APP_ID = "loanapp";
+export declare const LOAN_SELF_INIT_APP_ID = "loanapp-selfinit";
 export declare const SSF_APP_ID = "ssfapp";
 export declare const TASK_APP_ID = "taskapp";
 export declare const FLIGHTS_APP_ID = "flights";