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

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