@elliemae/pui-app-bridge 2.28.7-alpha.0 → 2.29.0-alpha.0

package/dist/cjs/appBridge.js

@@ -123,12 +123,13 @@ class CAppBridge {
    * @param value
    * @returns
    */
-  #isProxyEvent = (value) => (
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    value instanceof import_microfe_common.ProxyEvent || // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    typeof value?.subscribe === "function"
-  );
-  // support v1 scripting objects
+  #isProxyEvent = (value) => {
+    if (value instanceof import_microfe_common.ProxyEvent) return true;
+    if (typeof value === "object" && value !== null && "subscribe" in value) {
+      return typeof value.subscribe === "function";
+    }
+    return false;
+  };
   /**
    * format error message for app not found
    * @param id app id
@@ -267,7 +268,7 @@ class CAppBridge {
         appId: options.id,
         exception: err
       });
-      throw new Error(message);
+      throw new Error(message, { cause: err });
     }
   };
   #unloadApp = ({ id, instanceId, hostUrl, documentEle }) => {
@@ -463,9 +464,7 @@ class CAppBridge {
           eventOptions
         }) => this.dispatchEvent({
           event,
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
           eventParams,
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
           eventOptions
         });
         const token = propValue.subscribe(listener);
@@ -475,7 +474,8 @@ class CAppBridge {
       } else if (this.#isFunction(propValue)) {
         Object.defineProperty(so, propName, {
           value: async (...args) => {
-            const callerCtx = so[propName]?.callContext;
+            const soMethod = so[propName];
+            const callerCtx = soMethod?.callContext;
             if (callerCtx?.guest) {
               const existingChain = callerCtx.callChain ?? [];
               const guestId = callerCtx.guest.id;
@@ -681,10 +681,7 @@ class CAppBridge {
     if (iframeWindow) {
       iframeWindow.emui = iframeWindow.emui ?? {};
       iframeWindow.emui.__host = microFEHost;
-      iframeWindow.emui.getHost = () => (
-        // eslint-disable-next-line no-underscore-dangle
-        iframeWindow.emui?.__host ?? null
-      );
+      iframeWindow.emui.getHost = () => iframeWindow.emui?.__host ?? null;
     }
     const preconnect = frameDoc.createElement("link");
     preconnect.rel = "preconnect";

package/dist/cjs/config/app.js

@@ -123,9 +123,7 @@ class CAppConfig {
         await this.load(`${this.#baseUrl}latest/app.config.json`);
         return;
       }
-      throw new Error("Failed to fetch app config", {
-        cause: err
-      });
+      throw new Error("Failed to fetch app config", { cause: err });
     }
     if (response.ok) {
       try {
@@ -134,10 +132,7 @@ class CAppConfig {
       } catch (err) {
         if (!configUrl && this.#version !== import_constant.LATEST_VERSION) {
           await this.load(`${this.#baseUrl}latest/app.config.json`);
-        } else
-          throw new Error("Failed to parse app config", {
-            cause: err
-          });
+        } else throw new Error("Failed to parse app config", { cause: err });
       }
     } else {
       if (!configUrl && this.#version !== import_constant.LATEST_VERSION) {

package/dist/cjs/config/microFE.js

@@ -59,36 +59,38 @@ const isFileListValid = (files) => {
   if (!files || !files.length) return false;
   return files.every((file) => typeof file === "string");
 };
+const isLaunchMode = (mode, expected) => String(mode).toLowerCase() === expected.toLowerCase();
+const isAppSdkManager = (manager) => String(manager).toLowerCase() === import_app.MicroAppManager.APPSDK.toLowerCase();
+const validateMode = (id, mode) => {
+  if (!isLaunchMode(mode, import_app.LaunchMode.PRODUCTION) && !isLaunchMode(mode, import_app.LaunchMode.DEVELOPMENT)) {
+    throw new Error(`invalid mode '${String(mode)}' for ${id}`);
+  }
+};
+const validateAppSdkEnvFiles = (id, envSection, envName) => {
+  if (!envSection) {
+    throw new Error(
+      `microFrontendApps.${id} is missing ${envName} section in app.config.json`
+    );
+  }
+  if (!isFileListValid(envSection.files)) {
+    throw new Error(`invalid value for ${envName}.files`);
+  }
+};
+const validateAppSdkConfig = (id, mode, mfeConfig) => {
+  const { production, development } = mfeConfig;
+  if (isLaunchMode(mode, import_app.LaunchMode.PRODUCTION)) {
+    validateAppSdkEnvFiles(id, production, "production");
+  }
+  if (isLaunchMode(mode, import_app.LaunchMode.DEVELOPMENT)) {
+    validateAppSdkEnvFiles(id, development, "development");
+  }
+};
 const validate = (id, mfeConfig) => {
   const { mode = import_app.LaunchMode.PRODUCTION } = mfeConfig;
-  if (String(mode).toLowerCase() !== import_app.LaunchMode.PRODUCTION.toLowerCase() && String(mode).toLowerCase() !== import_app.LaunchMode.DEVELOPMENT.toLowerCase())
-    throw new Error(`invalid mode '${String(mode)}' for ${id}`);
-  const {
-    production,
-    development,
-    microappManager = import_app.MicroAppManager.APPSDK
-  } = mfeConfig;
-  if (String(microappManager).toLowerCase() === import_app.MicroAppManager.APPSDK.toLowerCase()) {
-    if (String(mode).toLowerCase() === import_app.LaunchMode.PRODUCTION.toLowerCase()) {
-      if (!production) {
-        throw new Error(
-          `microFrontendApps.${id} is missing production section in app.config.json`
-        );
-      }
-      if (!isFileListValid(production.files)) {
-        throw new Error(`invalid value for production.files`);
-      }
-    }
-    if (String(mode).toLowerCase() === import_app.LaunchMode.DEVELOPMENT.toLowerCase()) {
-      if (!development) {
-        throw new Error(
-          `microFrontendApps.${id} is missing development section in app.config.json`
-        );
-      }
-      if (!isFileListValid(development.files)) {
-        throw new Error(`invalid value for development.files`);
-      }
-    }
+  validateMode(id, mode);
+  const { microappManager = import_app.MicroAppManager.APPSDK } = mfeConfig;
+  if (isAppSdkManager(microappManager)) {
+    validateAppSdkConfig(id, mode, mfeConfig);
   }
 };
 const getConfig = ({

package/dist/cjs/eventManager.js

@@ -94,12 +94,13 @@ class EventManager {
         }
       }
       return this.#asyncCallwithTimeout(
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-        listener.callback({
-          obj: scriptingObject,
-          eventName,
-          eventParams
-        }),
+        Promise.resolve(
+          listener.callback({
+            obj: scriptingObject,
+            eventName,
+            eventParams
+          })
+        ),
         feedbackWaitTime
       );
     });

package/dist/cjs/frame.js

@@ -99,11 +99,14 @@ const create = ({
     frame.setAttribute("src", buildFrameSrc(options));
     const FRAME_LOAD_TIMEOUT_MS = 1e4;
     let settled = false;
-    let timeoutId;
-    let onAbort;
+    const frameLoadRefs = {
+      timeoutId: void 0,
+      onAbort: (() => {
+      })
+    };
     const cleanup = () => {
-      clearTimeout(timeoutId);
-      signal?.removeEventListener("abort", onAbort);
+      if (frameLoadRefs.timeoutId) clearTimeout(frameLoadRefs.timeoutId);
+      signal?.removeEventListener("abort", frameLoadRefs.onAbort);
     };
     const rejectIfAborted = () => {
       if (!signal?.aborted) return false;
@@ -115,12 +118,12 @@ const create = ({
       }
       return true;
     };
-    onAbort = () => {
+    frameLoadRefs.onAbort = () => {
       rejectIfAborted();
     };
     if (rejectIfAborted()) return;
-    signal?.addEventListener("abort", onAbort);
-    timeoutId = setTimeout(() => {
+    signal?.addEventListener("abort", frameLoadRefs.onAbort);
+    frameLoadRefs.timeoutId = setTimeout(() => {
       if (!settled) {
         settled = true;
         cleanup();

package/dist/cjs/loaders/manifest.js

@@ -27,7 +27,7 @@ const isValidHttpUrl = (fileName) => {
   let url;
   try {
     url = new URL(fileName);
-  } catch (_) {
+  } catch {
     return false;
   }
   return url.protocol === "http:" || url.protocol === "https:";

package/dist/cjs/microfeHost.js

@@ -74,7 +74,8 @@ class CMicroFEHost {
         } else if ((0, import_microfe_common.isPublicFunction)(propValue, propName)) {
           Object.defineProperty(proxy, propName, {
             value: (...args) => {
-              const existingCallChain = proxy[propName]?.callContext?.callChain;
+              const proxyMethod = proxy[propName];
+              const existingCallChain = proxyMethod?.callContext?.callChain;
               Object.defineProperty(propValue, "callContext", {
                 value: {
                   guest: this.#guest,
@@ -94,7 +95,9 @@ class CMicroFEHost {
       });
       return Promise.resolve(proxy);
     } catch (err) {
-      return Promise.reject(err);
+      return Promise.reject(
+        err instanceof Error ? err : new Error(String(err))
+      );
     }
   };
   /**

package/dist/cjs/tests/scriptingObjects/analytics.js

@@ -26,31 +26,16 @@ class Analytics extends import_microfe_common.ScriptingObject {
   constructor() {
     super("analytics");
   }
-  deleteTimingEventSamplingRatio = (names) => {
-    console.log("Analytics.deleteTimingEventSamplingRatio", names);
+  deleteTimingEventSamplingRatio = (_names) => {
   };
-  getAllTimingEventSamplingRatios = () => {
-    console.log("Analytics.getAllTimingEventSamplingRatios");
-    return {};
-  };
-  getTimingEventSamplingRatio = (names) => {
-    console.log("Analytics.getTimingEventSamplingRatio", names);
-    return {};
-  };
-  setTimingEventSamplingRatio = (ratios) => {
-    console.log("Analytics.setTimingEventSamplingRatio", ratios);
-  };
-  sendBAEvent = (event) => {
-    console.log("Analytics.sendBAEvent", event);
-    return Promise.resolve();
-  };
-  startTiming = (name, options) => {
-    console.log("Analytics.perfMarkStart", name);
-    return Promise.resolve(performance.mark(name, { detail: options }));
+  getAllTimingEventSamplingRatios = () => ({});
+  getTimingEventSamplingRatio = (_names) => ({});
+  setTimingEventSamplingRatio = (_ratios) => {
   };
+  sendBAEvent = (_event) => Promise.resolve();
+  startTiming = (name, options) => Promise.resolve(performance.mark(name, { detail: options }));
   endTiming = (start, options) => {
     const name = typeof start === "string" ? start : start.name;
-    console.log("Analytics.perfMarkEnd", name);
     performance.measure(name, {
       detail: options,
       start: name

package/dist/cjs/tests/scriptingObjects/appraisalServiceModule.js

@@ -72,10 +72,7 @@ class AppraisalService extends import_microfe_common.ScriptingObject {
   delete = () => {
     throw new Error("Not implemented");
   };
-  log = async (message, level) => {
-    console.log(message, level);
-    return Promise.resolve();
-  };
+  log = async (_message, _level) => Promise.resolve();
   unload = async () => {
   };
 }

package/dist/cjs/tests/utils.js

@@ -28,16 +28,91 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var utils_exports = {};
 __export(utils_exports, {
+  clearWindowEmui: () => clearWindowEmui,
+  createTestModuleSO: () => createTestModuleSO,
+  expectInitHistoryShape: () => expectInitHistoryShape,
+  expectInitLoggerShape: () => expectInitLoggerShape,
+  expectInitThemeShape: () => expectInitThemeShape,
+  getEmuiApps: () => getEmuiApps,
+  getIframeWindow: () => getIframeWindow,
   getMajorMinorVersion: () => getMajorMinorVersion,
   logger: () => logger,
   releaseJSThread: () => releaseJSThread,
   sendJS: () => sendJS,
-  sendJSText: () => sendJSText
+  sendJSText: () => sendJSText,
+  setEmuiAppEntry: () => setEmuiAppEntry,
+  snapshotInitOptionsPayload: () => snapshotInitOptionsPayload
 });
 module.exports = __toCommonJS(utils_exports);
 var import_promises = require("fs/promises");
 var import_node_path = __toESM(require("node:path"), 1);
 var import_pui_diagnostics = require("@elliemae/pui-diagnostics");
+var import_microfe_common = require("@elliemae/microfe-common");
+const getIframeWindow = (frame) => {
+  const view = frame.contentDocument?.defaultView;
+  if (!view) {
+    throw new Error("iframe content window is not available");
+  }
+  return view;
+};
+const getEmuiApps = (emui, appId) => {
+  const entry = emui[appId];
+  if (Array.isArray(entry)) return entry;
+  return entry ? [entry] : [];
+};
+const setEmuiAppEntry = (emui, appId, entry) => {
+  emui[appId] = entry;
+};
+const clearWindowEmui = () => {
+  Reflect.deleteProperty(window, "emui");
+};
+const createTestModuleSO = () => {
+  const moduleSO = new import_microfe_common.ScriptingObject("module");
+  Object.defineProperty(moduleSO, "getParameters", {
+    value: () => Promise.resolve({ moduleId: "urn:test", homeRoute: "/test" }),
+    enumerable: true
+  });
+  return moduleSO;
+};
+const expectInitHistoryShape = (history) => {
+  expect(history).toBeDefined();
+  expect(history?.action).toBe("POP");
+  expect(typeof history?.push).toBe("function");
+  expect(typeof history?.replace).toBe("function");
+};
+const expectInitThemeShape = (theme) => {
+  expect(theme).toBeDefined();
+  expect(theme?.breakpoints).toBeDefined();
+  expect(theme?.colors).toBeDefined();
+  expect(typeof theme?.media.large).toBe("function");
+  expect(typeof theme?.media.medium).toBe("function");
+};
+const expectInitLoggerShape = (initLogger) => {
+  expect(initLogger).toBeDefined();
+  expect(typeof initLogger?.audit).toBe("function");
+  expect(typeof initLogger?.debug).toBe("function");
+  expect(typeof initLogger?.error).toBe("function");
+};
+const snapshotInitOptionsPayload = (initOptions) => ({
+  ...initOptions,
+  logger: void 0,
+  history: initOptions.history ? {
+    action: initOptions.history.action,
+    location: initOptions.history.location
+  } : void 0,
+  theme: initOptions.theme ? {
+    breakpoints: initOptions.theme.breakpoints,
+    colors: initOptions.theme.colors,
+    fontSizes: initOptions.theme.fontSizes,
+    fontWeights: initOptions.theme.fontWeights,
+    fonts: initOptions.theme.fonts,
+    letterSpacings: initOptions.theme.letterSpacings,
+    lineHeights: initOptions.theme.lineHeights,
+    shadows: initOptions.theme.shadows,
+    space: initOptions.theme.space,
+    zIndex: initOptions.theme.zIndex
+  } : void 0
+});
 const getMajorMinorVersion = (version) => version.split(".").slice(0, 2).join(".");
 const sendJS = async (res, ctx, filePath) => {
   const fileContent = await (0, import_promises.readFile)(import_node_path.default.join(__dirname, filePath), "utf-8");

package/dist/cjs/typings/window.js

@@ -28,7 +28,7 @@ const getWindow = () => {
   try {
     window.parent.document;
     return window.parent;
-  } catch (err) {
+  } catch {
     return window;
   }
 };

package/dist/esm/appBridge.js

@@ -98,12 +98,13 @@ class CAppBridge {
    * @param value
    * @returns
    */
-  #isProxyEvent = (value) => (
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    value instanceof ProxyEvent || // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    typeof value?.subscribe === "function"
-  );
-  // support v1 scripting objects
+  #isProxyEvent = (value) => {
+    if (value instanceof ProxyEvent) return true;
+    if (typeof value === "object" && value !== null && "subscribe" in value) {
+      return typeof value.subscribe === "function";
+    }
+    return false;
+  };
   /**
    * format error message for app not found
    * @param id app id
@@ -242,7 +243,7 @@ class CAppBridge {
         appId: options.id,
         exception: err
       });
-      throw new Error(message);
+      throw new Error(message, { cause: err });
     }
   };
   #unloadApp = ({ id, instanceId, hostUrl, documentEle }) => {
@@ -438,9 +439,7 @@ class CAppBridge {
           eventOptions
         }) => this.dispatchEvent({
           event,
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
           eventParams,
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
           eventOptions
         });
         const token = propValue.subscribe(listener);
@@ -450,7 +449,8 @@ class CAppBridge {
       } else if (this.#isFunction(propValue)) {
         Object.defineProperty(so, propName, {
           value: async (...args) => {
-            const callerCtx = so[propName]?.callContext;
+            const soMethod = so[propName];
+            const callerCtx = soMethod?.callContext;
             if (callerCtx?.guest) {
               const existingChain = callerCtx.callChain ?? [];
               const guestId = callerCtx.guest.id;
@@ -656,10 +656,7 @@ class CAppBridge {
     if (iframeWindow) {
       iframeWindow.emui = iframeWindow.emui ?? {};
       iframeWindow.emui.__host = microFEHost;
-      iframeWindow.emui.getHost = () => (
-        // eslint-disable-next-line no-underscore-dangle
-        iframeWindow.emui?.__host ?? null
-      );
+      iframeWindow.emui.getHost = () => iframeWindow.emui?.__host ?? null;
     }
     const preconnect = frameDoc.createElement("link");
     preconnect.rel = "preconnect";

package/dist/esm/config/app.js

@@ -88,9 +88,7 @@ class CAppConfig {
         await this.load(`${this.#baseUrl}latest/app.config.json`);
         return;
       }
-      throw new Error("Failed to fetch app config", {
-        cause: err
-      });
+      throw new Error("Failed to fetch app config", { cause: err });
     }
     if (response.ok) {
       try {
@@ -99,10 +97,7 @@ class CAppConfig {
       } catch (err) {
         if (!configUrl && this.#version !== LATEST_VERSION) {
           await this.load(`${this.#baseUrl}latest/app.config.json`);
-        } else
-          throw new Error("Failed to parse app config", {
-            cause: err
-          });
+        } else throw new Error("Failed to parse app config", { cause: err });
       }
     } else {
       if (!configUrl && this.#version !== LATEST_VERSION) {

package/dist/esm/config/microFE.js

@@ -29,36 +29,38 @@ const isFileListValid = (files) => {
   if (!files || !files.length) return false;
   return files.every((file) => typeof file === "string");
 };
+const isLaunchMode = (mode, expected) => String(mode).toLowerCase() === expected.toLowerCase();
+const isAppSdkManager = (manager) => String(manager).toLowerCase() === MicroAppManager.APPSDK.toLowerCase();
+const validateMode = (id, mode) => {
+  if (!isLaunchMode(mode, LaunchMode.PRODUCTION) && !isLaunchMode(mode, LaunchMode.DEVELOPMENT)) {
+    throw new Error(`invalid mode '${String(mode)}' for ${id}`);
+  }
+};
+const validateAppSdkEnvFiles = (id, envSection, envName) => {
+  if (!envSection) {
+    throw new Error(
+      `microFrontendApps.${id} is missing ${envName} section in app.config.json`
+    );
+  }
+  if (!isFileListValid(envSection.files)) {
+    throw new Error(`invalid value for ${envName}.files`);
+  }
+};
+const validateAppSdkConfig = (id, mode, mfeConfig) => {
+  const { production, development } = mfeConfig;
+  if (isLaunchMode(mode, LaunchMode.PRODUCTION)) {
+    validateAppSdkEnvFiles(id, production, "production");
+  }
+  if (isLaunchMode(mode, LaunchMode.DEVELOPMENT)) {
+    validateAppSdkEnvFiles(id, development, "development");
+  }
+};
 const validate = (id, mfeConfig) => {
   const { mode = LaunchMode.PRODUCTION } = mfeConfig;
-  if (String(mode).toLowerCase() !== LaunchMode.PRODUCTION.toLowerCase() && String(mode).toLowerCase() !== LaunchMode.DEVELOPMENT.toLowerCase())
-    throw new Error(`invalid mode '${String(mode)}' for ${id}`);
-  const {
-    production,
-    development,
-    microappManager = MicroAppManager.APPSDK
-  } = mfeConfig;
-  if (String(microappManager).toLowerCase() === MicroAppManager.APPSDK.toLowerCase()) {
-    if (String(mode).toLowerCase() === LaunchMode.PRODUCTION.toLowerCase()) {
-      if (!production) {
-        throw new Error(
-          `microFrontendApps.${id} is missing production section in app.config.json`
-        );
-      }
-      if (!isFileListValid(production.files)) {
-        throw new Error(`invalid value for production.files`);
-      }
-    }
-    if (String(mode).toLowerCase() === LaunchMode.DEVELOPMENT.toLowerCase()) {
-      if (!development) {
-        throw new Error(
-          `microFrontendApps.${id} is missing development section in app.config.json`
-        );
-      }
-      if (!isFileListValid(development.files)) {
-        throw new Error(`invalid value for development.files`);
-      }
-    }
+  validateMode(id, mode);
+  const { microappManager = MicroAppManager.APPSDK } = mfeConfig;
+  if (isAppSdkManager(microappManager)) {
+    validateAppSdkConfig(id, mode, mfeConfig);
   }
 };
 const getConfig = ({

package/dist/esm/eventManager.js

@@ -71,12 +71,13 @@ class EventManager {
         }
       }
       return this.#asyncCallwithTimeout(
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-        listener.callback({
-          obj: scriptingObject,
-          eventName,
-          eventParams
-        }),
+        Promise.resolve(
+          listener.callback({
+            obj: scriptingObject,
+            eventName,
+            eventParams
+          })
+        ),
         feedbackWaitTime
       );
     });

package/dist/esm/frame.js

@@ -65,11 +65,14 @@ const create = ({
     frame.setAttribute("src", buildFrameSrc(options));
     const FRAME_LOAD_TIMEOUT_MS = 1e4;
     let settled = false;
-    let timeoutId;
-    let onAbort;
+    const frameLoadRefs = {
+      timeoutId: void 0,
+      onAbort: (() => {
+      })
+    };
     const cleanup = () => {
-      clearTimeout(timeoutId);
-      signal?.removeEventListener("abort", onAbort);
+      if (frameLoadRefs.timeoutId) clearTimeout(frameLoadRefs.timeoutId);
+      signal?.removeEventListener("abort", frameLoadRefs.onAbort);
     };
     const rejectIfAborted = () => {
       if (!signal?.aborted) return false;
@@ -81,12 +84,12 @@ const create = ({
       }
       return true;
     };
-    onAbort = () => {
+    frameLoadRefs.onAbort = () => {
       rejectIfAborted();
     };
     if (rejectIfAborted()) return;
-    signal?.addEventListener("abort", onAbort);
-    timeoutId = setTimeout(() => {
+    signal?.addEventListener("abort", frameLoadRefs.onAbort);
+    frameLoadRefs.timeoutId = setTimeout(() => {
       if (!settled) {
         settled = true;
         cleanup();

package/dist/esm/loaders/manifest.js

@@ -4,7 +4,7 @@ const isValidHttpUrl = (fileName) => {
   let url;
   try {
     url = new URL(fileName);
-  } catch (_) {
+  } catch {
     return false;
   }
   return url.protocol === "http:" || url.protocol === "https:";

package/dist/esm/microfeHost.js

@@ -55,7 +55,8 @@ class CMicroFEHost {
         } else if (isPublicFunction(propValue, propName)) {
           Object.defineProperty(proxy, propName, {
             value: (...args) => {
-              const existingCallChain = proxy[propName]?.callContext?.callChain;
+              const proxyMethod = proxy[propName];
+              const existingCallChain = proxyMethod?.callContext?.callChain;
               Object.defineProperty(propValue, "callContext", {
                 value: {
                   guest: this.#guest,
@@ -75,7 +76,9 @@ class CMicroFEHost {
       });
       return Promise.resolve(proxy);
     } catch (err) {
-      return Promise.reject(err);
+      return Promise.reject(
+        err instanceof Error ? err : new Error(String(err))
+      );
     }
   };
   /**