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

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

@@ -355,11 +355,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;
@@ -376,14 +379,22 @@ class CMicroAppGuest {
       );
     }
     this.props.host = host;
-    const module2 = await host.getObject("module");
-    if (!module2) {
-      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 module2 = await host.getObject("module");
+      if (module2) {
+        params = await module2.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 module2.getParameters();
-    this.#applyModuleParams(params);
     if (this.onInit) this.onInit(this.props);
     return params;
   }

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

@@ -51,6 +51,7 @@ class CMicroAppHost {
   scriptingObjects;
   #ssfHostRef;
   #appBridge = null;
+  #selfInitialize;
   // eslint-disable-next-line max-statements
   constructor(params) {
     this.appId = (0, import_config.getAppConfigValue)("appId");
@@ -58,6 +59,7 @@ class CMicroAppHost {
     this.logger = params?.logger || import_console_logger.consoleLogger;
     (0, import_logger.setLogger)(this.logger);
     this.onRenewSessionTimer = params?.onRenewSessionTimer;
+    this.#selfInitialize = params?.selfInitialize ?? false;
     this.props = {
       systemVersion: params?.version ?? "latest",
       history: params?.history ?? import_history2.browserHistory,
@@ -89,15 +91,17 @@ class CMicroAppHost {
         leading: true
       }
     );
-    (0, import_app_config.loadAppConfig)().then(() => {
-      (0, import_app_bridge.getAppBridge)().then((appBridge) => {
-        this.#appBridge = appBridge;
-        if (this.onInit) this.onInit(this.props);
-      }).catch((ex) => {
-        throw ex;
+    if (!this.#selfInitialize) {
+      (0, import_app_config.loadAppConfig)().then(() => {
+        (0, import_app_bridge.getAppBridge)().then((appBridge) => {
+          this.#appBridge = appBridge;
+          if (this.onInit) this.onInit(this.props);
+        }).catch((ex) => {
+          throw ex;
+        });
+      }).catch(() => {
       });
-    }).catch(() => {
-    });
+    }
     (0, import_pui_analytics_so.updateBAEventParameters)({ appId: this.appId });
   }
   static getInstance(params) {
@@ -109,6 +113,19 @@ class CMicroAppHost {
   static isInitialized() {
     return !!this.instance;
   }
+  /**
+   * Host-initiated lifecycle: loads app config, initializes the app bridge,
+   * and calls the onInit callback. Call this instead of relying on the
+   * automatic constructor chain when `selfInitialize: true`.
+   * @returns host options (systemVersion, history, theme)
+   */
+  async initialize() {
+    await (0, import_app_config.loadAppConfig)();
+    const appBridge = await (0, import_app_bridge.getAppBridge)();
+    this.#appBridge = appBridge;
+    if (this.onInit) this.onInit(this.props);
+    return this.props;
+  }
   getProps() {
     return this.props;
   }

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

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

package/dist/cjs/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/cjs/view/tests/constants.js

@@ -26,6 +26,7 @@ __export(constants_exports, {
   LATEST_VERSION: () => LATEST_VERSION,
   LOAN_APP_ID: () => LOAN_APP_ID,
   LOAN_SAVED_EVENT: () => LOAN_SAVED_EVENT,
+  LOAN_SELF_INIT_APP_ID: () => LOAN_SELF_INIT_APP_ID,
   PRE_COMMIT_EVENT: () => PRE_COMMIT_EVENT,
   RELEASE_VERSION: () => RELEASE_VERSION,
   SSF_APP_ID: () => SSF_APP_ID,
@@ -35,6 +36,7 @@ module.exports = __toCommonJS(constants_exports);
 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";

package/dist/esm/index.js

@@ -64,7 +64,9 @@ import {
   CMicroAppGuest,
   CMicroAppGuest as CMicroAppGuest2
 } from "./utils/micro-frontend/guest.js";
-import { CMicroAppHost } from "./utils/micro-frontend/host.js";
+import {
+  CMicroAppHost
+} from "./utils/micro-frontend/host.js";
 import {
   buildModuleParams,
   createGuestModule,

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/utils/micro-frontend/host.js

@@ -36,6 +36,7 @@ class CMicroAppHost {
   scriptingObjects;
   #ssfHostRef;
   #appBridge = null;
+  #selfInitialize;
   // eslint-disable-next-line max-statements
   constructor(params) {
     this.appId = getAppConfigValue("appId");
@@ -43,6 +44,7 @@ class CMicroAppHost {
     this.logger = params?.logger || consoleLogger;
     setLogger(this.logger);
     this.onRenewSessionTimer = params?.onRenewSessionTimer;
+    this.#selfInitialize = params?.selfInitialize ?? false;
     this.props = {
       systemVersion: params?.version ?? "latest",
       history: params?.history ?? browserHistory,
@@ -74,15 +76,17 @@ class CMicroAppHost {
         leading: true
       }
     );
-    loadAppConfig().then(() => {
-      getAppBridge().then((appBridge) => {
-        this.#appBridge = appBridge;
-        if (this.onInit) this.onInit(this.props);
-      }).catch((ex) => {
-        throw ex;
+    if (!this.#selfInitialize) {
+      loadAppConfig().then(() => {
+        getAppBridge().then((appBridge) => {
+          this.#appBridge = appBridge;
+          if (this.onInit) this.onInit(this.props);
+        }).catch((ex) => {
+          throw ex;
+        });
+      }).catch(() => {
       });
-    }).catch(() => {
-    });
+    }
     updateBAEventParameters({ appId: this.appId });
   }
   static getInstance(params) {
@@ -94,6 +98,19 @@ class CMicroAppHost {
   static isInitialized() {
     return !!this.instance;
   }
+  /**
+   * Host-initiated lifecycle: loads app config, initializes the app bridge,
+   * and calls the onInit callback. Call this instead of relying on the
+   * automatic constructor chain when `selfInitialize: true`.
+   * @returns host options (systemVersion, history, theme)
+   */
+  async initialize() {
+    await loadAppConfig();
+    const appBridge = await getAppBridge();
+    this.#appBridge = appBridge;
+    if (this.onInit) this.onInit(this.props);
+    return this.props;
+  }
   getProps() {
     return this.props;
   }

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/index.d.ts

@@ -30,7 +30,8 @@ export { subscribeToSessionExpiryWarning, subscribeToSessionExpiry, subscribeToR
 export { waitMessage as waitMessageAction } from './data/wait-message/actions.js';
 export { initServiceWorker } from './utils/service-worker.js';
 export { CMicroAppGuest, CMicroAppGuest as CMicroApp, } from './utils/micro-frontend/guest.js';
-export { CMicroAppHost } from './utils/micro-frontend/host.js';
+/** @deprecated Use CMicroApp with selfInitialize: true instead */
+export { CMicroAppHost, type HostOptions, } from './utils/micro-frontend/host.js';
 export { buildModuleParams, createGuestModule, GuestModule, } from './utils/micro-frontend/module-so.js';
 export type { HostProvidedParams, ModuleOverrides, } from './utils/micro-frontend/module-so.js';
 export { enableReactAppForHostIntegration } from './utils/app-host-integration/react.js';

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/host.d.ts

@@ -6,7 +6,7 @@ import { BAEvent, ScriptingObjectTypes, Events } from '@elliemae/pui-scripting-o
 import type { ScriptingObjects, EventListeners, AddScriptingObjectParams, DispatchEventParam, EventOptions } from '@elliemae/microfe-common';
 import { Analytics } from '@elliemae/pui-analytics-so';
 import { MicroFrontEndLogger } from '../types.js';
-type HostOptions = {
+export type HostOptions = {
     systemVersion: string;
     history: History;
     theme: DefaultTheme;
@@ -22,11 +22,18 @@ type ConstructorParams = {
     onInit?: OnInitCallback;
     ssfHostRef?: SSFHost<ScriptingObjectTypes, Events> | null;
     analytics?: Analytics;
+    /**
+     * When true the host drives its own lifecycle via {@link CMicroAppHost.initialize}.
+     * The constructor skips the automatic loadAppConfig → getAppBridge → onInit chain.
+     */
+    selfInitialize?: boolean;
 };
 /**
  * Micro-frontend host application class (singleton).
  * Manages hosting and coordination of multiple micro-frontend guest applications.
  * Provides shared services like navigation, theming, analytics, and state management.
+ * @deprecated Use {@link CMicroAppGuest | CMicroApp} instead. CMicroApp now supports
+ * both guest and host use cases via `selfInitialize: true` and `initialize()`.
  * @template AppObjects - Type of custom scripting objects
  * @template AppEvents - Type of custom event listeners
  * @example
@@ -57,6 +64,13 @@ export declare class CMicroAppHost<AppObjects extends ScriptingObjects = Partial
     private constructor();
     static getInstance<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events>(params?: ConstructorParams): CMicroAppHost<AppObjects, AppEvents>;
     static isInitialized(): boolean;
+    /**
+     * Host-initiated lifecycle: loads app config, initializes the app bridge,
+     * and calls the onInit callback. Call this instead of relying on the
+     * automatic constructor chain when `selfInitialize: true`.
+     * @returns host options (systemVersion, history, theme)
+     */
+    initialize(): Promise<HostOptions>;
     getProps(): HostOptions;
     getLogger(): MicroFrontEndLogger;
     getItem(key: string): string | null;

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";