@elliemae/pui-app-bridge 2.28.3 → 2.28.5

package/dist/types/lib/frame.d.ts

@@ -34,6 +34,11 @@ export type FrameOptions = {
      * @example "microphone 'self' https://example.com; geolocation 'none'"
      */
     permissionPolicy?: string;
+    /**
+     * Optional signal to abort iframe creation (e.g. when the host unmounts
+     * before the iframe finishes loading).
+     */
+    signal?: AbortSignal;
 };
 export declare const FRAME_APP_CONTAINER_ID_PREFIX = "pui-app-container-";
 export declare const Frame: {

package/dist/types/lib/loaders/script.d.ts

@@ -49,18 +49,18 @@ export declare class ScriptLoader {
      * @returns A promise that resolves with an array of script element IDs when all scripts are loaded
      * @remarks
      * This method:
-     * - Preserves manifest order (CDN and local scripts stay in their original sequence)
+     * - Stages external (CDN) scripts before local guest-host scripts
+     * - Preserves manifest order within each origin group
      * - Creates modulepreload links for all assets for performance optimization
-     * - Inserts script tags synchronously in batches so the browser can fetch in parallel
-     * - Relies on module script execution order (document order) within each batch
-     * - Waits for global.js before inserting dependent bundles, then syncs webpack public path
+     * - Inserts script tags synchronously per stage so the browser can fetch in parallel
+     * - Syncs webpack public path from hostUrl (or guest _ASSET_PATH) before local scripts run
      * @example
      * ```typescript
      * const scriptIds = await scriptLoader.load(
      *   ['https://cdn.example.com/lib.js', 'global.js', 'runtime~app.js'],
      *   {
      *     name: 'myApp',
-     *     hostUrl: 'https://example.com',
+     *     hostUrl: 'https://example.com/my-app/',
      *     documentEle: document,
      *     isESMModule: true
      *   }

package/dist/types/lib/tests/utils/script-origin.test.d.ts

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

package/dist/types/lib/typings/host.d.ts

@@ -57,8 +57,8 @@ export type OpenAppParams = {
 };
 /**
  * Interface to connect and communicate with parent host
- * @typeParam AppObjects - type of the scripting objects that the application supports
- * @typeParam AppEvents - type of the events that the application supports
+ * @template AppObjects type of the scripting objects that the application supports
+ * @template AppEvents type of the events that the application supports
  */
 export interface IMicroFEHost<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events> {
     /**
@@ -78,13 +78,13 @@ export interface IMicroFEHost<AppObjects extends ScriptingObjects = Partial<Scri
     setAppWindowSize(appSize: AppWindowSize): void;
     /**
      * add listener to the scripting object event
-     * @param {SubscribeParam<EventId, EventType>} params - parameters to add event listener
+     * @param params parameters to add event listener
      * @returns subscription id
      */
     subscribe: <EventId extends Extract<keyof AppEvents, string>>(params: SubscribeParam<EventId, AppEvents[EventId]>) => string;
     /**
      * removes listener from the scripting object event
-     * @param {UnsubscribeParam<EventId>} params - parameters to remove event listener
+     * @param params parameters to remove event listener
      */
     unsubscribe: <EventId extends Extract<keyof AppEvents, string>>(params: UnsubscribeParam<EventId>) => void;
 }

package/dist/types/lib/utils/script-origin.d.ts

@@ -0,0 +1,22 @@
+export type ScriptRef = {
+    id: string;
+    href: string;
+};
+/**
+ * True when href is an absolute URL outside the guest app's hostUrl origin.
+ * @param {string} href - Resolved script URL.
+ * @param {string} hostUrl - Guest application base URL.
+ * @returns {boolean} Whether the script is hosted outside the guest app.
+ */
+export declare const isExternalScriptHref: (href: string, hostUrl: string) => boolean;
+/**
+ * Splits scripts into external (CDN) and local (guest host) groups while
+ * preserving manifest order within each group.
+ * @param {ScriptRef[]} scripts - Ordered script entries to partition.
+ * @param {string} hostUrl - Guest application base URL.
+ * @returns {{ external: ScriptRef[]; local: ScriptRef[] }} Partitioned script groups.
+ */
+export declare const partitionScriptsByOrigin: (scripts: ScriptRef[], hostUrl: string) => {
+    external: ScriptRef[];
+    local: ScriptRef[];
+};

package/dist/types/lib/utils/webpack-public-path.d.ts

@@ -2,5 +2,16 @@
  * @param {Window | null | undefined} [targetWindow] - Guest document defaultView whose webpack runtime should be synced.
  */
 export declare const syncWebpackPublicPathFromAssetPath: (targetWindow?: Window | null) => void;
-/** Matches guest global.js / global-prod.js URLs. */
-export declare const GLOBAL_SCRIPT_PATTERN: RegExp;
+/**
+ * Derives webpack public path from the guest hostUrl when _ASSET_PATH is not yet available.
+ * @param {Window | null | undefined} [targetWindow] - Guest document defaultView.
+ * @param {string} [hostUrl] - Guest application base URL from load options.
+ */
+export declare const syncWebpackPublicPathFromHost: (targetWindow?: Window | null, hostUrl?: string) => void;
+/**
+ * Prefers guest _ASSET_PATH when present, otherwise falls back to hostUrl.
+ * @param {Window | null | undefined} [targetWindow] - Guest document defaultView.
+ * @param {string} [hostUrl] - Guest application base URL from load options.
+ * @returns {void}
+ */
+export declare const syncWebpackPublicPath: (targetWindow?: Window | null, hostUrl?: string) => void;

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

@@ -2,5 +2,7 @@ export declare const removeDoubleSlash: (url: string) => string;
 export declare const getAbsoluteUrl: (url: string) => string;
 export declare const appendTrailingSlash: (url: string) => string;
 export declare const appendPath: (base: string, path: string) => string;
+export declare const resolveManifestBaseUrl: (hostUrl: string, manifestPath: string) => string;
+export declare const resolveManifestUrl: (hostUrl: string, manifestPath: string) => string;
 export declare const isJSDOM: () => boolean;
 export declare const escapeRegExp: (str: string) => string;