feat: add getModule and getContainer to utilities

packages/utilities/src/types/index.ts

@@ -85,3 +85,9 @@ export type Loader = Extract<RuleSetRule['use'], { loader?: string }>;
 export type EventTypes = 'loadStart' | 'loadComplete' | 'loadError';
 type NextRoute = string;
 export type PageMap = Record<NextRoute, ModulePath>;
+
+export type GetModuleOptions = {
+  modulePath: string
+  exportName?: string
+  remoteContainer: string | RemoteData
+}

packages/utilities/src/utils/common.ts

@@ -6,6 +6,8 @@ import type {
   RuntimeRemotesMap,
   RuntimeRemote,
   WebpackRemoteContainer,
+  RemoteData,
+  GetModuleOptions
 } from '../types';
 
 type RemoteVars = Record<
@@ -57,7 +59,7 @@ const getRuntimeRemotes = () => {
     }
     return acc;
   },
-  {} as RuntimeRemotesMap);
+    {} as RuntimeRemotesMap);
 
   return runtimeRemotes;
 };
@@ -87,7 +89,7 @@ export const injectScript = (
       typeof reference.asyncContainer.then === 'function'
         ? reference.asyncContainer
         : // @ts-ignore
-          reference.asyncContainer();
+        reference.asyncContainer();
   } else {
     // This casting is just to satisfy typescript,
     // In reality remoteGlobal will always be a string;
@@ -205,3 +207,56 @@ export const createRuntimeVariables = (remotes: Remotes) => {
     return acc;
   }, {} as Record<string, string>);
 };
+
+/**
+   * Returns initialized webpack RemoteContainer.
+   * If its' script does not loaded - then load & init it firstly.
+   */
+export const getContainer = async (remoteContainer: string | RemoteData): Promise<WebpackRemoteContainer | undefined> => {
+
+  if (!remoteContainer) {
+    throw Error(`Remote container options is empty`);
+  }
+  if (typeof remoteContainer === 'string') {
+    if (window[remoteContainer]) {
+      return window[remoteContainer];
+    }
+  } else {
+    if (window['uniqueKey' as keyof typeof remoteContainer]) {
+      return window['uniqueKey' as keyof typeof remoteContainer];
+    }
+    const container = await injectScript({
+      global: remoteContainer.global,
+      url: remoteContainer.url,
+    });
+
+    if (container) {
+      return container;
+    }
+    throw Error(`Remote container ${remoteContainer.url} is empty`);
+  }
+}
+
+/**
+* Return remote module from container.
+* If you provide `exportName` it automatically return exact property value from module.
+*
+* @example
+*   remote.getModule('./pages/index', 'default')
+*/
+export const getModule = async ({ remoteContainer, modulePath, exportName }: GetModuleOptions) => {
+  const container = await getContainer(remoteContainer);
+  try {
+    const modFactory = await container?.get(modulePath);
+    if (!modFactory) return undefined;
+    const mod = modFactory();
+    if (exportName) {
+      return mod && typeof mod === 'object' ? mod[exportName] : undefined;
+    } else {
+      return mod;
+    }
+  } catch (error) {
+    console.log(error)
+    return undefined
+  }
+}