@elliemae/pui-app-sdk 5.30.2 → 5.31.0-beta.1

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

@@ -1,10 +1,14 @@
 import { jsx } from "react/jsx-runtime";
-import { memo, useLayoutEffect, useRef } from "react";
+import { memo, useLayoutEffect, useRef, useCallback } from "react";
 import styled from "styled-components";
 import { useDispatch } from "react-redux";
 import { getAppBridge } from "../utils/micro-frontend/app-bridge.js";
+import { getSSFHost } from "../utils/micro-frontend/ssf-host.js";
 import { waitMessage } from "../data/wait-message/actions.js";
-import { getLogger } from "../utils/micro-frontend/index.js";
+import {
+  getLogger,
+  getMicroFrontEndAppConfig
+} from "../utils/micro-frontend/index.js";
 const Div = styled.div`
   display: flex;
   width: 100%;
@@ -23,32 +27,56 @@ const useAppRenderer = (props) => {
     containerId
   } = props;
   const dispatch = useDispatch();
+  const getConfig = useCallback(
+    () => getMicroFrontEndAppConfig({
+      id
+    }),
+    [id]
+  );
   useLayoutEffect(() => {
     let isMounted = true;
     let appBridge = null;
+    let ssfHost = null;
     let unloadInProgress = Promise.resolve();
     let instanceId = null;
     (async () => {
       await unloadInProgress;
       dispatch(waitMessage.open());
       try {
-        appBridge = await getAppBridge();
-        if (!appBridge)
-          throw new Error(`Failed to load ${id}, AppBridge not initialized`);
-        if (isMounted) {
-          instanceId = await appBridge.openApp({
-            id,
-            frameOptions: { containerId },
-            history,
-            homeRoute,
-            initialRoute
-          });
-          setTimeout(() => {
-            try {
-              onLoadComplete?.(instanceId);
-            } catch (ex) {
-            }
-          }, 0);
+        const { ssfOnly, hostUrl, name } = getConfig();
+        if (ssfOnly) {
+          ssfHost = getSSFHost();
+          if (!ssfHost)
+            throw new Error(`Failed to load ${id}, SSFHost not initialized`);
+          if (isMounted) {
+            const guest = ssfHost.loadGuest({
+              id,
+              url: hostUrl,
+              title: name,
+              targetElement: document.getElementById(containerId),
+              onLoad: onLoadComplete
+            });
+            instanceId = guest.id;
+          }
+        } else {
+          appBridge = await getAppBridge();
+          if (!appBridge)
+            throw new Error(`Failed to load ${id}, AppBridge not initialized`);
+          if (isMounted) {
+            instanceId = await appBridge.openApp({
+              id,
+              frameOptions: { containerId },
+              history,
+              homeRoute,
+              initialRoute
+            });
+            setTimeout(() => {
+              try {
+                onLoadComplete?.(instanceId);
+              } catch (ex) {
+              }
+            }, 0);
+          }
         }
       } catch (ex) {
         getLogger().error({
@@ -58,6 +86,8 @@ const useAppRenderer = (props) => {
         isMounted = false;
         if (appBridge && instanceId)
           unloadInProgress = appBridge.closeApp(instanceId);
+        if (ssfHost && instanceId)
+          unloadInProgress = Promise.resolve(ssfHost.unloadGuest(instanceId));
         throw ex;
       } finally {
         dispatch(waitMessage.close());
@@ -65,19 +95,21 @@ const useAppRenderer = (props) => {
     })();
     return () => {
       isMounted = false;
-      if (appBridge) {
+      if (ssfHost) {
+        unloadInProgress = Promise.resolve(ssfHost.unloadGuest(instanceId));
+      } else if (appBridge) {
         unloadInProgress = appBridge.closeApp(instanceId);
-        unloadInProgress.then(() => {
-          instanceId = null;
-          setTimeout(() => {
-            try {
-              onUnloadComplete?.();
-            } catch (ex) {
-            }
-          }, 0);
-        }).catch(() => {
-        });
       }
+      unloadInProgress.then(() => {
+        instanceId = null;
+        setTimeout(() => {
+          try {
+            onUnloadComplete?.();
+          } catch (ex) {
+          }
+        }, 0);
+      }).catch(() => {
+      });
     };
   }, [
     containerId,
@@ -87,7 +119,8 @@ const useAppRenderer = (props) => {
     initialRoute,
     id,
     onLoadComplete,
-    onUnloadComplete
+    onUnloadComplete,
+    getConfig
   ]);
 };
 const GuestMicroApp = memo(

package/dist/esm/view/tests/__snapshots__/guest-microapp.test.tsx.snap

@@ -1,5 +1,21 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`GuestMicroApp with SSFHost should open ssfapp 1`] = `
+"<html lang="en"><head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>SSFApp</title>
+    <!-- <script src="https://cdn.mortgagetech.q1.ice.com/ssf-guest"></script> -->
+</head>
+<body>
+    <h1>SSF App</h1>
+    <output id="output">ssfapp starting
+ssfapp loaded</output>
+    <script src="./latest/index.js"></script>
+
+</body></html>"
+`;
+
 exports[`MicroAppV2 should open loanapp and call init and mount methods 1`] = `
 Document {
   "location": Location {

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

@@ -15,6 +15,17 @@
         "files": ["index.js"]
       }
     },
+    "ssfapp": {
+      "name": "SSF App",
+      "hostUrl": "./ssfapp",
+      "ssfOnly": 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 SSF_APP_ID = "ssfapp";
 const TASK_APP_ID = "taskapp";
 const FLIGHTS_APP_ID = "flights";
 const HOTELS_APP_ID = "hotels";
@@ -20,5 +21,6 @@ export {
   LOAN_SAVED_EVENT,
   PRE_COMMIT_EVENT,
   RELEASE_VERSION,
+  SSF_APP_ID,
   TASK_APP_ID
 };

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

@@ -172,6 +172,21 @@ const serverHandlers = [
     "/loan/latest/manifest.json",
     (req, res, ctx) => res(ctx.json(loanAppManifest))
   ),
+  rest.get("/ssfapp/", async (req, res, ctx) => {
+    const fileContent = await readFile(
+      path.join(__dirname, "ssfapp/index.html"),
+      "utf-8"
+    );
+    return res(
+      ctx.status(200),
+      ctx.set("Content-Type", "text/html"),
+      ctx.body(fileContent)
+    );
+  }),
+  rest.get("/ssfapp/latest/index.js", async (req, res, ctx) => {
+    const newRes = await sendJS(res, ctx, "./ssfapp/latest/index.js");
+    return newRes;
+  }),
   ...getServerHandlers()
 ];
 export {

package/dist/esm/view/tests/ssfapp/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>SSFApp</title>
+    <!-- <script src="https://cdn.mortgagetech.q1.ice.com/ssf-guest"></script> -->
+</head>
+<body>
+    <h1>SSF App</h1>
+    <output id="output"></output>
+    <script src="./latest/index.js"></script>
+</body>
+</html>

package/dist/esm/view/tests/ssfapp/latest/index.js

@@ -0,0 +1,15 @@
+const appId = "ssfapp";
+const output = document.getElementById("output");
+output.textContent = `${appId} starting`;
+window.addEventListener("beforeunload", () => {
+  if (output) {
+    output.textContent += `
+${appId} unloading`;
+  }
+});
+document.addEventListener("load", () => {
+  if (output) {
+    output.textContent += `
+${appId} loaded`;
+  }
+});

package/dist/esm/view/tests/ssfapp/latest/manifest.json

@@ -0,0 +1,3 @@
+{
+  "index.js": "latest/index.js"
+}

package/dist/types/lib/communication/http-client/index.d.ts

@@ -5,12 +5,14 @@ export type RequestConfig = {
     Authorization?: string;
 } & AxiosRequestHeaders;
 export { getAuthorizationHeader };
-export declare const getHTTPClient: ({ baseURL, headers, }?: {
+export declare const getHTTPClient: ({ baseURL, headers, sendLogRocketSessionHeader, }?: {
     baseURL?: string;
     headers?: RequestConfig;
+    sendLogRocketSessionHeader?: boolean;
 }) => AxiosInstance;
-export declare const getAuthHTTPClient: ({ baseURL, headers, ...rest }?: {
+export declare const getAuthHTTPClient: ({ baseURL, headers, sendLogRocketSessionHeader, ...rest }?: {
     baseURL?: string;
     headers?: RequestConfig;
+    sendLogRocketSessionHeader?: boolean;
     rest?: any[];
 }) => AxiosInstance;

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

@@ -1,6 +1,7 @@
 import { DefaultTheme } from 'styled-components';
 import { History, To } from 'history';
 import type { IMicroAppGuest, IMicroAppHost, InitOptions, MountOptions } from '@elliemae/pui-micro-frontend-base';
+import { SSFHost } from '@elliemae/ssf-host';
 import { ScriptingObjectTypes, Events } from '@elliemae/pui-scripting-object';
 import { IMicroFEHost } from '@elliemae/pui-app-bridge';
 import type { ScriptingObjects, EventListeners, SubscribeParam, UnsubscribeParam, DispatchEventParam, EventOptions, AddScriptingObjectParams } from '@elliemae/microfe-common';
@@ -24,6 +25,7 @@ interface ConstructorParams {
     onUnmount?: OnUnMountCallback;
     onGetRef?: OnGetRefCallback;
     history?: History;
+    ssfHostRef?: SSFHost<ScriptingObjectTypes, Events> | null;
 }
 export declare class CMicroAppGuest<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events> implements IMicroAppGuest<AppObjects, AppEvents> {
     #private;
@@ -73,10 +75,11 @@ export declare class CMicroAppGuest<AppObjects extends ScriptingObjects = Partia
      */
     addScriptingObject<SO extends AppObjects[keyof AppObjects]>(so: SO, params?: AddScriptingObjectParams): void;
     /**
-     * dispatch event to child microapp
-     * @param {DispatchEventParams<EventId, Params>} params - event parameters
+     * Dispatches an event to the child microapp.
+     * @param {DispatchEventParam<EventId, Params, Options>} params - Event parameters.
+     * @returns {Promise<any[]>} A promise that resolves with the combined results of dispatched events.
      */
-    dispatchEvent<EventId extends Extract<keyof AppEvents, string>, Params extends Parameters<AppEvents[EventId]>[0]['eventParams'], Options extends EventOptions>(params: DispatchEventParam<EventId, Params, Options>): Promise<void>;
+    dispatchEvent<EventId extends Extract<keyof AppEvents, string>, Params extends Parameters<AppEvents[EventId]>[0]['eventParams'], Options extends EventOptions>(params: DispatchEventParam<EventId, Params, Options>): Promise<void | any[]>;
     /**
      * removes scripting object from child microapp use
      * @param objectId unique id of the scripting object

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

@@ -76,7 +76,7 @@ export declare class CMicroAppHost<AppObjects extends ScriptingObjects = Partial
      * dispatch event to child microapp
      * @param {DispatchEventParams<EventId, Params>} params - event parameters
      */
-    dispatchEvent<EventId extends Extract<keyof AppEvents, string>, Params extends Parameters<AppEvents[EventId]>[0]['eventParams'], Options extends EventOptions>(params: DispatchEventParam<EventId, Params, Options>): Promise<void>;
+    dispatchEvent<EventId extends Extract<keyof AppEvents, string>, Params extends Parameters<AppEvents[EventId]>[0]['eventParams'], Options extends EventOptions>(params: DispatchEventParam<EventId, Params, Options>): Promise<void | any[]>;
     /**
      * removes scripting object from child microapp use
      * @param objectId unique id of the scripting object

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

@@ -0,0 +1,5 @@
+import { SSFHost } from '@elliemae/ssf-host';
+import { ScriptingObjectTypes, Events } from '@elliemae/pui-scripting-object';
+import type { ScriptingObjects, EventListeners } from '@elliemae/microfe-common';
+export declare const getSSFHost: <AppObjects extends ScriptingObjects = ScriptingObjectTypes, AppEvents extends EventListeners = Events>() => SSFHost<AppObjects, AppEvents>;
+export declare const setSSFHost: (host: SSFHost<any, any>) => void;

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

@@ -11,6 +11,10 @@ export type MicroAppConfig = {
     manifestPath?: string;
     homeRoute: string;
     isJsModule?: boolean;
+    /**
+     * If true, application will only be loaded via SSFHost and not AppBridge.
+     */
+    ssfOnly?: boolean;
     files?: Array<string>;
     development?: EnvConfig;
     production?: EnvConfig;

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 SSF_APP_ID = "ssfapp";
 export declare const TASK_APP_ID = "taskapp";
 export declare const FLIGHTS_APP_ID = "flights";
 export declare const HOTELS_APP_ID = "hotels";

package/dist/types/lib/view/tests/ssfapp/latest/index.d.ts

@@ -0,0 +1,2 @@
+declare const appId: "ssfapp";
+declare const output: HTMLElement | null;