@elliemae/pui-app-sdk 6.0.0-alpha.3 → 6.0.0-alpha.4

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

@@ -1,10 +1,11 @@
 import { History, To } from 'history';
 import { DefaultTheme } from 'styled-components';
 import { IMicroAppHost, ResizeEventHandler, BreakpointChangeEventHandler, SubscriptionListener } from '@elliemae/pui-micro-frontend-base';
-import ssfHost from '@elliemae/em-ssf-host';
-import { BAEvent } from '@elliemae/pui-scripting-object';
+import { SSFHost } from '@elliemae/ssf-host';
+import { BAEvent, ScriptingObjectTypes, Events } from '@elliemae/pui-scripting-object';
+import type { ScriptingObjects, EventListeners, AddScriptingObjectParams, DispatchEventParam, EventOptions } from '@elliemae/microfe-common';
+import { Analytics } from '@elliemae/pui-analytics-so';
 import { MicroFrontEndLogger } from '../types.js';
-import { Analytics } from './scripting-objects/analytics.js';
 type HostOptions = {
     systemVersion: string;
     history: History;
@@ -19,10 +20,30 @@ type ConstructorParams = {
     scriptingObjects?: Record<string, any>;
     onRenewSessionTimer?: () => void;
     onInit?: OnInitCallback;
-    ssfHostRef?: typeof ssfHost.Host;
+    ssfHostRef?: SSFHost<ScriptingObjectTypes, Events> | null;
     analytics?: Analytics;
 };
-export declare class CMicroAppHost implements IMicroAppHost {
+/**
+ * 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.
+ * @template AppObjects - Type of custom scripting objects
+ * @template AppEvents - Type of custom event listeners
+ * @example
+ * ```typescript
+ * const host = new CMicroAppHost({
+ *   version: '1.0.0',
+ *   history: browserHistory,
+ *   onInit: ({ history, theme }) => {
+ *     console.log('Host initialized');
+ *   },
+ *   scriptingObjects: {
+ *     customService: new CustomService()
+ *   }
+ * });
+ * ```
+ */
+export declare class CMicroAppHost<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events> implements IMicroAppHost<AppObjects, AppEvents> {
     #private;
     private static instance;
     private readonly logger;
@@ -31,27 +52,28 @@ export declare class CMicroAppHost implements IMicroAppHost {
     activeGuests: Record<string, unknown>;
     private readonly onInit?;
     private readonly onRenewSessionTimer?;
+    private readonly throttleRenewSessionTimer;
     scriptingObjects: Record<string, any>;
     private constructor();
-    static getInstance(params?: ConstructorParams): CMicroAppHost;
+    static getInstance<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events>(params?: ConstructorParams): CMicroAppHost<AppObjects, AppEvents>;
     static isInitialized(): boolean;
-    getProps(this: CMicroAppHost): HostOptions;
-    getLogger(this: CMicroAppHost): MicroFrontEndLogger;
+    getProps(): HostOptions;
+    getLogger(): MicroFrontEndLogger;
     getItem(key: string): string | null;
     setItem(key: string, value: string): void;
-    getGuests(this: CMicroAppHost): Record<string, unknown>;
+    getGuests(): Record<string, unknown>;
     getGuest<T>(id: string): T | null;
     publish<Type>(message: string | symbol, data?: Type): boolean;
     subscribe<T>(message: string | symbol, func: SubscriptionListener<T>): string;
     unsubscribe(token: string): void;
-    navigate(this: CMicroAppHost, url: To, state?: any): void;
+    navigate(url: To, state?: any): void;
     openWaitMessage(): void;
     closeWaitMessage(): void;
     openErrorBanner(message: string): void;
     getAuthToken(): string;
     renewAuthToken(): string;
     logout(): void;
-    renewSessionTimer(this: CMicroAppHost): Promise<void>;
+    renewSessionTimer(): Promise<void>;
     getBreakpoint(): keyof import("@elliemae/pui-theme").BreakPoints;
     getViewportSize(): {
         width: number;
@@ -62,5 +84,22 @@ export declare class CMicroAppHost implements IMicroAppHost {
     setSystemVersion(version?: string): void;
     sendBAEvent(data: BAEvent): void;
     getObject<T>(name: string): Promise<T>;
+    /**
+     * add scripting object for child microapp to use
+     * @param so - The scripting object to be added.
+     * @param params - Optional parameters for adding the scripting object.
+     */
+    addScriptingObject<SO extends AppObjects[keyof AppObjects]>(so: SO, params?: AddScriptingObjectParams): void;
+    /**
+     * dispatch event to child microapp
+     * @param {DispatchEventParams<EventId, Params>} 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 | unknown[]>;
+    /**
+     * removes scripting object from child microapp use
+     * @param objectId unique id of the scripting object
+     */
+    removeScriptingObject(objectId: Extract<keyof AppObjects, string>): void;
 }
 export {};

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

@@ -0,0 +1,82 @@
+import { History, To } from 'history';
+import { DefaultTheme } from 'styled-components';
+import { ScriptingObject, Event } from '@elliemae/ssf-host';
+import { IModule, ModuleParameters, Events, LogLevels, LogMessage } from '@elliemae/pui-scripting-object';
+/**
+ * Host-provided values that can't be read from the app config.
+ */
+export type HostProvidedParams = {
+    /** Host-provided history object (by reference, App Bridge only — not for SSF) */
+    history?: History;
+    /** Styled-components theme */
+    theme?: DefaultTheme;
+    /** Route to navigate to on open (only when useParentHistory is false) */
+    initialRoute?: To;
+    /** Additional host-defined key-value pairs */
+    [key: string]: unknown;
+};
+/**
+ * Build a {@link ModuleParameters} object for a self-initializing guest.
+ *
+ * Reads `hostUrl`, `manifestPath`, and `homeRoute` from the app config
+ * for the given guest id. The host only provides values the config
+ * doesn't have: `theme`, `history`, and optionally `initialRoute`.
+ * @param guestId - App id as defined in app.config.json (e.g. 'loanapp')
+ * @param params - Host-provided values (theme, history, initialRoute, custom keys)
+ * @returns ModuleParameters ready for getParameters()
+ */
+export declare const buildModuleParams: (guestId: string, params?: HostProvidedParams) => ModuleParameters;
+/**
+ * Default IModule implementation backed by a static parameters object.
+ * Hosts can instantiate this directly or use the {@link createGuestModule}
+ * factory for a terser API.
+ */
+export declare class GuestModule extends ScriptingObject implements IModule {
+    #private;
+    constructor(guestId: string, params?: HostProvidedParams);
+    readonly Close: Event<Events>;
+    readonly Unloading: Event<Events>;
+    /**
+     * Bind the teardown logic that runs when the guest calls unload().
+     * Prefixed with _ so SSF's for…in discovery skips it.
+     * The App Bridge auto-binds this in openApp().
+     * @param handler
+     */
+    _setUnloadHandler(handler: () => Promise<void>): void;
+    getParameters(): Promise<ModuleParameters>;
+    getCapabilities(): Promise<Record<string, unknown>>;
+    log(message: LogMessage | string, logLevel: keyof typeof LogLevels): Promise<void>;
+    unload(): Promise<void>;
+}
+/**
+ * Optional method overrides the host can supply to customise
+ * the module scripting object beyond the defaults.
+ *
+ * Typed keys shadow the corresponding {@link GuestModule} methods.
+ * The index signature allows adding host-specific methods that the
+ * guest can discover through the scripting object protocol.
+ *
+ * Overrides are applied via Object.assign so they become own
+ * enumerable properties on the instance — required for SSF's
+ * _toJSON discovery (for…in enumeration).
+ */
+export type ModuleOverrides = {
+    getCapabilities?: () => Promise<Record<string, unknown>>;
+    log?: (message: LogMessage | string, logLevel: keyof typeof LogLevels) => Promise<void>;
+    unload?: () => Promise<void>;
+    [method: string]: ((...args: any[]) => any) | undefined;
+};
+/**
+ * Create a module scripting object for a guest micro-app.
+ * The host registers this before rendering GuestMicroApp so the guest
+ * can pull its init parameters via module.getParameters().
+ *
+ * Internally calls {@link buildModuleParams} to merge the app config
+ * values (hostUrl, manifestPath, homeRoute) with host-provided values
+ * (theme, history, initialRoute).
+ * @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 addScriptingObject()
+ */
+export declare const createGuestModule: (guestId: string, params?: HostProvidedParams, overrides?: ModuleOverrides) => IModule;

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/tests/guest-initialize.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,39 @@
+export type SSFMessage = {
+    data: {
+        requestId: number;
+        type: string;
+        body: {
+            eventFeedback: boolean;
+            objectId: string;
+            functionName: string;
+            functionParams?: Array<unknown>;
+        };
+        source: string;
+    };
+};
+type PostMessageOptions = {
+    srcWindow: Window;
+    targetWindow: Window;
+    message: any;
+};
+export declare const applicationScriptingObject: {
+    object: {
+        events: never[];
+        functions: string[];
+        objectId: string;
+        objectType: string;
+    };
+    type: string;
+};
+export declare const authScriptingObject: {
+    object: {
+        events: never[];
+        functions: string[];
+        objectId: string;
+        objectType: string;
+    };
+    type: string;
+};
+export declare const postMessage: ({ srcWindow, targetWindow, message, }: PostMessageOptions) => void;
+export declare const setupHost: (hostWindow: Window) => () => void;
+export {};

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

@@ -1,17 +1,135 @@
 import { InitOptions } from '@elliemae/pui-micro-frontend-base';
+import { Events, ScriptingObjectTypes } from '@elliemae/pui-scripting-object';
+import { IFrameSandboxValues, WindowFeatures, OpenMode } from '@elliemae/ssf-host';
+/**
+ * Files specific to the mode of the micro-frontend application.
+ */
 type EnvConfig = {
+    /**
+     * Array of file paths specific to the environment (development or production).
+     * relative or absolute URLs
+     */
     files: Array<string>;
 };
+/**
+ * Modes in which a micro-frontend application can operate.
+ */
+export declare enum LaunchMode {
+    DEVELOPMENT = "development",
+    PRODUCTION = "production"
+}
+/**
+ * Library that manages the micro-frontend application.
+ */
+export declare enum MicroAppManager {
+    SSF = "ssf",
+    APPSDK = "appsdk"
+}
+/**
+ * additional options for ssf based micro-frontend applications.
+ */
+export type SSFAppOptions<SearchParams> = {
+    /**
+     * individual query parameters indicating guest application's url parameter string
+     */
+    searchParams?: SearchParams;
+    /**
+     * mode of opening the guest application, popup or embed
+     * @default OpenMode.Embed
+     */
+    openMode?: OpenMode;
+    /**
+     * flag to disable sandboxing for iframe
+     * @default false
+     */
+    disableSandbox?: boolean;
+    /**
+     * sandbox values for iframe
+     * @default [IFrameSandboxValues.AllowScripts, IFrameSandboxValues.AllowPopups, IFrameSandboxValues.AllowModals, IFrameSandboxValues.AllowForms, IFrameSandboxValues.AllowDownloads, IFrameSandboxValues.AllowSameOrigin ]
+     */
+    sandboxValues?: Array<IFrameSandboxValues>;
+    /**
+     * resize the iframe to fit the content inside
+     * @default true
+     */
+    fitToContent?: boolean;
+    /**
+     * css style for the microapp iframe
+     */
+    style?: string;
+    /**
+     * features for the popup window
+     * @default { width: 800, height: 600, top: 100, left: 100 }
+     */
+    popupWindowFeatures?: WindowFeatures;
+    /**
+     * permission policy for the guest iframe
+     * check https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe#allow for more details
+     * @example "microphone 'self' https://example.com; geolocation 'none'"
+     */
+    permissionPolicy?: string;
+};
+/**
+ * Configuration object for a micro-frontend application.
+ */
 export type MicroAppConfig = {
+    /**
+     * Unique identifier for the micro-frontend application.
+     */
     id: string;
+    /**
+     * Human-readable name for the micro-frontend application.
+     */
     name: string;
-    mode?: string;
+    /**
+     * Optional title for the micro-frontend application.
+     */
+    title?: string;
+    /**
+     * Mode in which the micro-frontend operates (e.g., 'development', 'production').
+     */
+    mode?: LaunchMode;
+    /**
+     * Base URL where the micro-frontend is hosted.
+     */
     hostUrl?: string;
+    /**
+     * Path to the manifest file for the micro-frontend.
+     */
     manifestPath?: string;
+    /**
+     * Route to the home page of the micro-frontend application.
+     */
     homeRoute: string;
+    /**
+     * If true, the micro-frontend is treated as a JavaScript module.
+     */
+    isJsModule?: boolean;
+    /**
+     * Library that manages the micro-frontend application (e.g., 'ssf', 'appsdk').
+     * @default 'appsdk'
+     */
+    microappManager?: MicroAppManager;
+    /**
+     * Array of file paths required by the micro-frontend application.
+     * relative or absolute URLs
+     */
     files?: Array<string>;
+    /**
+     * files specific to the development build.
+     */
     development?: EnvConfig;
+    /**
+     * files specific to the production build.
+     */
     production?: EnvConfig;
+    /**
+     * options for ssf based micro-frontend applications.
+     */
+    ssfAppOptions?: SSFAppOptions<Record<string, string | number | boolean>>;
+    /**
+     * The Document object associated with the micro-frontend application.
+     */
     documentEle: Document;
-} & InitOptions;
+} & InitOptions<Partial<ScriptingObjectTypes>, Events>;
 export {};

package/dist/types/lib/utils/redact-pii.d.ts

@@ -1 +1,25 @@
+/**
+ * Redacts personally identifiable information (PII) from data objects.
+ * Removes sensitive data like credit cards, SSNs, emails, passwords, addresses, etc.
+ * @template T - Type of the data object
+ * @param data - Object containing potential PII to redact
+ * @returns New object with PII fields replaced with '****'
+ * @example
+ * ```typescript
+ * const userData = {
+ *   name: 'John Doe',
+ *   email: 'john@example.com',
+ *   ssn: '123-45-6789',
+ *   address: '123 Main St'
+ * };
+ *
+ * const sanitized = redactPii(userData);
+ * // {
+ * //   name: 'John Doe',
+ * //   email: '****',
+ * //   ssn: '****',
+ * //   address: '****'
+ * // }
+ * ```
+ */
 export declare const redactPii: <T>(data: T) => T;

package/dist/types/lib/utils/session.d.ts

@@ -9,20 +9,95 @@ type LISTENER = {
     (): void;
 };
 /**
- * reset the UI idle time counter
- * @param resetWarningModal - reset the warning modal
+ * Resets the user idle time counter.
+ * Call this when user performs an action to extend their session.
+ * @param resetWarningModal - If true, also resets the warning modal state (default: false)
+ * @example
+ * ```typescript
+ * // Reset idle time on user interaction
+ * document.addEventListener('click', () => {
+ *   resetUserIdleTime();
+ * });
+ *
+ * // Reset and close warning modal
+ * resetUserIdleTime(true);
+ * ```
  */
 export declare const resetUserIdleTime: ResetUserIdleTimeFn;
 /**
- * Extend the PSS session (Encompass session) by introspecting the token
- * also reset the UI idle time counter
+ * Extends the PSS session (Encompass session) by introspecting the token.
+ * Also resets the UI idle time counter.
+ * @throws Error if authorization token is not found
+ * @example
+ * ```typescript
+ * // Manually renew session
+ * await renewSession();
+ * ```
+ * @internal
  */
 export declare const renewSession: () => Promise<void>;
 export declare const stopSessionMonitoring: () => void;
 export declare const addEventListeners: () => void;
 export declare const initSessionMonitoring: () => void;
+/**
+ * Subscribes to session expiry warning events.
+ * The callback is invoked when the session is about to expire (based on warning interval).
+ * @param onSessionExpiryWarn - Callback function that receives the warning timestamp
+ * @returns Unsubscribe function to remove the listener
+ * @example
+ * ```typescript
+ * const unsubscribe = subscribeToSessionExpiryWarning((warningTime) => {
+ *   console.log('Session expiring at:', warningTime);
+ *   showWarningModal();
+ * });
+ *
+ * // Later, to unsubscribe
+ * unsubscribe();
+ * ```
+ */
 export declare const subscribeToSessionExpiryWarning: (onSessionExpiryWarn: WARNLISTENER) => () => void;
+/**
+ * Subscribes to session expiry events.
+ * The callback is invoked when the session has expired.
+ * @param onSessionExpiry - Callback function invoked on session expiry
+ * @returns Unsubscribe function to remove the listener
+ * @example
+ * ```typescript
+ * const unsubscribe = subscribeToSessionExpiry(() => {
+ *   console.log('Session expired');
+ *   window.location.href = '/login';
+ * });
+ * ```
+ */
 export declare const subscribeToSessionExpiry: (onSessionExpiry: LISTENER) => () => void;
+/**
+ * Subscribes to session reset events.
+ * The callback is invoked when the session idle time is reset.
+ * @param onResetListener - Callback function that receives reset modal flag
+ * @returns Unsubscribe function to remove the listener
+ * @example
+ * ```typescript
+ * subscribeToResetSession((shouldResetModal) => {
+ *   if (shouldResetModal) {
+ *     closeWarningModal();
+ *   }
+ * });
+ * ```
+ */
 export declare const subscribeToResetSession: (onResetListener: RESETLISTENER) => () => void;
+/**
+ * Starts tracking user activity for session management.
+ * Monitors user interactions on the specified element and invokes callback.
+ * @param element - DOM element to track activity on (typically document)
+ * @param cb - Callback function to invoke on user activity
+ * @returns Cleanup function to stop tracking
+ * @example
+ * ```typescript
+ * const cleanup = trackActivity(document, renewSession);
+ *
+ * // Later, stop tracking
+ * cleanup();
+ * ```
+ */
 export declare const trackActivity: (element: Document | null, cb: (...args: unknown[]) => unknown) => () => void;
 export {};

package/dist/types/lib/utils/testing/index.d.ts

@@ -1,4 +1,60 @@
 import { RenderOptions } from '@testing-library/react';
-declare const customRender: (ui: React.ReactElement, options?: Omit<RenderOptions, "queries">) => import("@testing-library/react").RenderResult<typeof import("@testing-library/dom/types/queries.js"), HTMLElement, HTMLElement>;
-export * from '@testing-library/react';
+declare const customRender: (ui: React.ReactElement, options?: Omit<RenderOptions, "queries">) => {
+    container: HTMLElement;
+    baseElement: HTMLElement;
+    debug: (baseElement?: Element | DocumentFragment | Array<Element | DocumentFragment>, maxLength?: number, options?: import("pretty-format").OptionsReceived) => void;
+    rerender: (ui: React.ReactNode) => void;
+    unmount: () => void;
+    asFragment: () => DocumentFragment;
+    getByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement;
+    getAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    queryByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement | null;
+    queryAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    findByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement;
+    getAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    queryByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement | null;
+    queryAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    findByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement;
+    getAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement[];
+    queryByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement | null;
+    queryAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement[];
+    findByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    user: import("@testing-library/user-event").UserEvent;
+};
+export { screen, waitFor, waitForElementToBeRemoved, within, fireEvent, act, cleanup, renderHook, } from '@testing-library/react';
 export { customRender as render };

package/dist/types/lib/utils/testing/performance-mock.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared Performance API mock utilities for testing
+ */
+export declare class MockPerformanceObserver {
+    callback: PerformanceObserverCallback;
+    constructor(callback: PerformanceObserverCallback);
+    observe(): void;
+    disconnect(): void;
+}
+export declare const mockMarks: Map<string, PerformanceMark>;
+export declare const mockMeasures: PerformanceMeasure[];
+export declare const originalPerformance: Performance;
+/**
+ * Setup Performance API mock
+ * Call this in beforeEach or beforeAll
+ */
+export declare function setupPerformanceMock(): void;
+/**
+ * Clear performance mock data
+ * Call this in afterEach to reset state between tests
+ */
+export declare function clearPerformanceMock(): void;
+/**
+ * Restore original performance object
+ * Call this in afterEach or afterAll
+ */
+export declare function restorePerformance(): void;

package/dist/types/lib/utils/tests/logrocket.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/lib/utils/window.d.ts

@@ -1,27 +1,43 @@
 import { IMicroAppGuest, IMicroAppHost, BAEvent } from '@elliemae/pui-micro-frontend-base';
+import { ScriptingObjectTypes, Events } from '@elliemae/pui-scripting-object';
+import { ScriptingObjects, EventListeners } from '@elliemae/microfe-common';
+import { SSFGuest } from '@elliemae/ssf-guest';
 import { BreakPoint } from '@elliemae/pui-theme';
 import { Logger } from '@elliemae/pui-diagnostics';
+import { IMicroFEHost } from '@elliemae/pui-app-bridge';
+import type LogRocket from 'logrocket';
 import { LoginParams } from './auth/types';
-export type EMUI = {
-    [key: string]: IMicroAppGuest | IMicroAppGuest[];
+export type EMUI<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events> = {
+    [key: string]: IMicroAppGuest<AppObjects, AppEvents> | IMicroAppGuest<AppObjects, AppEvents>[];
 } & {
     _BASE_PATH: string;
     _ASSET_PATH: string;
     version: string;
-    MicroAppHost?: IMicroAppHost;
+    MicroAppHost?: IMicroFEHost<AppObjects, AppEvents> | IMicroAppHost | SSFGuest<AppObjects, AppEvents>;
+    __host?: IMicroFEHost<AppObjects, AppEvents>;
     logger?: Logger;
+    logRocket?: typeof LogRocket;
+    logRocketConfig?: {
+        appId: string;
+        childDomains?: string[];
+        parentDomain?: string;
+        rootHostname?: string;
+    };
     appId: string;
     uuid: string;
     app?: IMicroAppGuest;
     loginParams: LoginParams;
 };
 declare global {
-    interface Window {
+    interface Window<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events> {
         gtmDataLayer: BAEvent[];
-        emui: EMUI;
+        emui: EMUI<AppObjects, AppEvents>;
+        __TEST__: {
+            [key: string]: unknown;
+        };
     }
 }
-export declare const getWindow: () => Window;
+export declare const getWindow: () => WindowProxy;
 export declare const getViewportSize: () => {
     width: number;
     height: number;