@module-federation/runtime-core 0.14.3 → 0.16.0

package/README.md

@@ -6,7 +6,7 @@
 
 ## Documentation
 
-See [https://module-federation.io/guide/basic/runtime.html](https://module-federation.io/guide/basic/runtime.html) for details.
+See [https://module-federation.io/guide/basic/runtime/runtime.html](https://module-federation.io/guide/basic/runtime/runtime.html) for details.
 
 ## License
 

package/dist/index.cjs.cjs

@@ -196,7 +196,7 @@ function getGlobalFederationConstructor() {
 function setGlobalFederationConstructor(FederationConstructor, isDebug = sdk.isDebugMode()) {
     if (isDebug) {
         CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR__ = FederationConstructor;
-        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.14.3";
+        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.16.0";
     }
 }
 // eslint-disable-next-line @typescript-eslint/ban-types
@@ -639,40 +639,93 @@ function satisfy(version, range) {
     if (!version) {
         return false;
     }
-    const parsedRange = parseRange(range);
-    const parsedComparator = parsedRange.split(' ').map((rangeVersion)=>parseComparatorString(rangeVersion)).join(' ');
-    const comparators = parsedComparator.split(/\s+/).map((comparator)=>parseGTE0(comparator));
+    // Extract version details once
     const extractedVersion = extractComparator(version);
     if (!extractedVersion) {
+        // If the version string is invalid, it can't satisfy any range
         return false;
     }
     const [, versionOperator, , versionMajor, versionMinor, versionPatch, versionPreRelease] = extractedVersion;
     const versionAtom = {
+        operator: versionOperator,
         version: combineVersion(versionMajor, versionMinor, versionPatch, versionPreRelease),
         major: versionMajor,
         minor: versionMinor,
         patch: versionPatch,
         preRelease: versionPreRelease == null ? void 0 : versionPreRelease.split('.')
     };
-    for (const comparator of comparators){
-        const extractedComparator = extractComparator(comparator);
-        if (!extractedComparator) {
-            return false;
+    // Split the range by || to handle OR conditions
+    const orRanges = range.split('||');
+    for (const orRange of orRanges){
+        const trimmedOrRange = orRange.trim();
+        if (!trimmedOrRange) {
+            // An empty range string signifies wildcard *, satisfy any valid version
+            // (We already checked if the version itself is valid)
+            return true;
+        }
+        // Handle simple wildcards explicitly before complex parsing
+        if (trimmedOrRange === '*' || trimmedOrRange === 'x') {
+            return true;
         }
-        const [, rangeOperator, , rangeMajor, rangeMinor, rangePatch, rangePreRelease] = extractedComparator;
-        const rangeAtom = {
-            operator: rangeOperator,
-            version: combineVersion(rangeMajor, rangeMinor, rangePatch, rangePreRelease),
-            major: rangeMajor,
-            minor: rangeMinor,
-            patch: rangePatch,
-            preRelease: rangePreRelease == null ? void 0 : rangePreRelease.split('.')
-        };
-        if (!compare(rangeAtom, versionAtom)) {
-            return false; // early return
+        try {
+            // Apply existing parsing logic to the current OR sub-range
+            const parsedSubRange = parseRange(trimmedOrRange); // Handles hyphens, trims etc.
+            // Check if the result of initial parsing is empty, which can happen
+            // for some wildcard cases handled by parseRange/parseComparatorString.
+            // E.g. `parseStar` used in `parseComparatorString` returns ''.
+            if (!parsedSubRange.trim()) {
+                // If parsing results in empty string, treat as wildcard match
+                return true;
+            }
+            const parsedComparatorString = parsedSubRange.split(' ').map((rangeVersion)=>parseComparatorString(rangeVersion)) // Expands ^, ~
+            .join(' ');
+            // Check again if the comparator string became empty after specific parsing like ^ or ~
+            if (!parsedComparatorString.trim()) {
+                return true;
+            }
+            // Split the sub-range by space for implicit AND conditions
+            const comparators = parsedComparatorString.split(/\s+/).map((comparator)=>parseGTE0(comparator))// Filter out empty strings that might result from multiple spaces
+            .filter(Boolean);
+            // If a sub-range becomes empty after parsing (e.g., invalid characters),
+            // it cannot be satisfied. This check might be redundant now but kept for safety.
+            if (comparators.length === 0) {
+                continue;
+            }
+            let subRangeSatisfied = true;
+            for (const comparator of comparators){
+                const extractedComparator = extractComparator(comparator);
+                // If any part of the AND sub-range is invalid, the sub-range is not satisfied
+                if (!extractedComparator) {
+                    subRangeSatisfied = false;
+                    break;
+                }
+                const [, rangeOperator, , rangeMajor, rangeMinor, rangePatch, rangePreRelease] = extractedComparator;
+                const rangeAtom = {
+                    operator: rangeOperator,
+                    version: combineVersion(rangeMajor, rangeMinor, rangePatch, rangePreRelease),
+                    major: rangeMajor,
+                    minor: rangeMinor,
+                    patch: rangePatch,
+                    preRelease: rangePreRelease == null ? void 0 : rangePreRelease.split('.')
+                };
+                // Check if the version satisfies this specific comparator in the AND chain
+                if (!compare(rangeAtom, versionAtom)) {
+                    subRangeSatisfied = false; // This part of the AND condition failed
+                    break; // No need to check further comparators in this sub-range
+                }
+            }
+            // If all AND conditions within this OR sub-range were met, the overall range is satisfied
+            if (subRangeSatisfied) {
+                return true;
+            }
+        } catch (e) {
+            // Log error and treat this sub-range as unsatisfied
+            console.error(`[semver] Error processing range part "${trimmedOrRange}":`, e);
+            continue;
         }
     }
-    return true;
+    // If none of the OR sub-ranges were satisfied
+    return false;
 }
 
 function formatShare(shareArgs, from, name, shareStrategy) {
@@ -1257,7 +1310,8 @@ let Module = class Module {
             });
             if (typeof (remoteEntryExports == null ? void 0 : remoteEntryExports.init) === 'undefined') {
                 error(errorCodes.getShortErrorMsg(errorCodes.RUNTIME_002, errorCodes.runtimeDescMap, {
-                    remoteName: name,
+                    hostName: this.host.name,
+                    remoteName: this.remoteInfo.name,
                     remoteEntryUrl: this.remoteInfo.entry,
                     remoteEntryKey: this.remoteInfo.entryGlobalName
                 }));
@@ -1691,9 +1745,12 @@ function snapshotPlugin() {
     return {
         name: 'snapshot-plugin',
         async afterResolve (args) {
-            const { remote, pkgNameOrAlias, expose, origin, remoteInfo } = args;
+            const { remote, pkgNameOrAlias, expose, origin, remoteInfo, id } = args;
             if (!isRemoteInfoWithEntry(remote) || !isPureRemoteEntry(remote)) {
-                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo(remote);
+                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo({
+                    moduleInfo: remote,
+                    id
+                });
                 assignRemoteInfo(remoteInfo, remoteSnapshot);
                 // preloading assets
                 const preloadOptions = {
@@ -1952,7 +2009,7 @@ const generatePreloadAssetsPlugin = function() {
 
 function getGlobalRemoteInfo(moduleInfo, origin) {
     const hostGlobalSnapshot = getGlobalSnapshotInfoByModuleInfo({
-        name: origin.options.name,
+        name: origin.name,
         version: origin.options.version
     });
     // get remote detail info from global
@@ -1977,23 +2034,8 @@ function getGlobalRemoteInfo(moduleInfo, origin) {
     };
 }
 class SnapshotHandler {
-    async loadSnapshot(moduleInfo) {
-        const { options } = this.HostInstance;
-        const { hostGlobalSnapshot, remoteSnapshot, globalSnapshot } = this.getGlobalRemoteInfo(moduleInfo);
-        const { remoteSnapshot: globalRemoteSnapshot, globalSnapshot: globalSnapshotRes } = await this.hooks.lifecycle.loadSnapshot.emit({
-            options,
-            moduleInfo,
-            hostGlobalSnapshot,
-            remoteSnapshot,
-            globalSnapshot
-        });
-        return {
-            remoteSnapshot: globalRemoteSnapshot,
-            globalSnapshot: globalSnapshotRes
-        };
-    }
     // eslint-disable-next-line max-lines-per-function
-    async loadRemoteSnapshotInfo(moduleInfo) {
+    async loadRemoteSnapshotInfo({ moduleInfo, id, expose }) {
         const { options } = this.HostInstance;
         await this.hooks.lifecycle.beforeLoadRemoteSnapshot.emit({
             options,
@@ -2080,6 +2122,8 @@ class SnapshotHandler {
             }
         }
         await this.hooks.lifecycle.afterLoadSnapshot.emit({
+            id,
+            host: this.HostInstance,
             options,
             moduleInfo,
             remoteSnapshot: mSnapshot
@@ -2617,7 +2661,9 @@ class RemoteHandler {
         await Promise.all(preloadOps.map(async (ops)=>{
             const { remote } = ops;
             const remoteInfo = getRemoteInfo(remote);
-            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo(remote);
+            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo({
+                moduleInfo: remote
+            });
             const assets = await this.hooks.lifecycle.generatePreloadAssets.emit({
                 origin: host,
                 preloadOptions: ops,
@@ -2978,7 +3024,7 @@ class FederationHost {
             // maybe will change, temporarily for internal use only
             initContainer: new AsyncWaterfallHook('initContainer')
         });
-        this.version = "0.14.3";
+        this.version = "0.16.0";
         this.moduleCache = new Map();
         this.loaderHook = new PluginSystem({
             // FIXME: may not be suitable , not open to the public yet

package/dist/index.esm.js

@@ -195,7 +195,7 @@ function getGlobalFederationConstructor() {
 function setGlobalFederationConstructor(FederationConstructor, isDebug = isDebugMode()) {
     if (isDebug) {
         CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR__ = FederationConstructor;
-        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.14.3";
+        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.16.0";
     }
 }
 // eslint-disable-next-line @typescript-eslint/ban-types
@@ -638,40 +638,93 @@ function satisfy(version, range) {
     if (!version) {
         return false;
     }
-    const parsedRange = parseRange(range);
-    const parsedComparator = parsedRange.split(' ').map((rangeVersion)=>parseComparatorString(rangeVersion)).join(' ');
-    const comparators = parsedComparator.split(/\s+/).map((comparator)=>parseGTE0(comparator));
+    // Extract version details once
     const extractedVersion = extractComparator(version);
     if (!extractedVersion) {
+        // If the version string is invalid, it can't satisfy any range
         return false;
     }
     const [, versionOperator, , versionMajor, versionMinor, versionPatch, versionPreRelease] = extractedVersion;
     const versionAtom = {
+        operator: versionOperator,
         version: combineVersion(versionMajor, versionMinor, versionPatch, versionPreRelease),
         major: versionMajor,
         minor: versionMinor,
         patch: versionPatch,
         preRelease: versionPreRelease == null ? void 0 : versionPreRelease.split('.')
     };
-    for (const comparator of comparators){
-        const extractedComparator = extractComparator(comparator);
-        if (!extractedComparator) {
-            return false;
+    // Split the range by || to handle OR conditions
+    const orRanges = range.split('||');
+    for (const orRange of orRanges){
+        const trimmedOrRange = orRange.trim();
+        if (!trimmedOrRange) {
+            // An empty range string signifies wildcard *, satisfy any valid version
+            // (We already checked if the version itself is valid)
+            return true;
+        }
+        // Handle simple wildcards explicitly before complex parsing
+        if (trimmedOrRange === '*' || trimmedOrRange === 'x') {
+            return true;
         }
-        const [, rangeOperator, , rangeMajor, rangeMinor, rangePatch, rangePreRelease] = extractedComparator;
-        const rangeAtom = {
-            operator: rangeOperator,
-            version: combineVersion(rangeMajor, rangeMinor, rangePatch, rangePreRelease),
-            major: rangeMajor,
-            minor: rangeMinor,
-            patch: rangePatch,
-            preRelease: rangePreRelease == null ? void 0 : rangePreRelease.split('.')
-        };
-        if (!compare(rangeAtom, versionAtom)) {
-            return false; // early return
+        try {
+            // Apply existing parsing logic to the current OR sub-range
+            const parsedSubRange = parseRange(trimmedOrRange); // Handles hyphens, trims etc.
+            // Check if the result of initial parsing is empty, which can happen
+            // for some wildcard cases handled by parseRange/parseComparatorString.
+            // E.g. `parseStar` used in `parseComparatorString` returns ''.
+            if (!parsedSubRange.trim()) {
+                // If parsing results in empty string, treat as wildcard match
+                return true;
+            }
+            const parsedComparatorString = parsedSubRange.split(' ').map((rangeVersion)=>parseComparatorString(rangeVersion)) // Expands ^, ~
+            .join(' ');
+            // Check again if the comparator string became empty after specific parsing like ^ or ~
+            if (!parsedComparatorString.trim()) {
+                return true;
+            }
+            // Split the sub-range by space for implicit AND conditions
+            const comparators = parsedComparatorString.split(/\s+/).map((comparator)=>parseGTE0(comparator))// Filter out empty strings that might result from multiple spaces
+            .filter(Boolean);
+            // If a sub-range becomes empty after parsing (e.g., invalid characters),
+            // it cannot be satisfied. This check might be redundant now but kept for safety.
+            if (comparators.length === 0) {
+                continue;
+            }
+            let subRangeSatisfied = true;
+            for (const comparator of comparators){
+                const extractedComparator = extractComparator(comparator);
+                // If any part of the AND sub-range is invalid, the sub-range is not satisfied
+                if (!extractedComparator) {
+                    subRangeSatisfied = false;
+                    break;
+                }
+                const [, rangeOperator, , rangeMajor, rangeMinor, rangePatch, rangePreRelease] = extractedComparator;
+                const rangeAtom = {
+                    operator: rangeOperator,
+                    version: combineVersion(rangeMajor, rangeMinor, rangePatch, rangePreRelease),
+                    major: rangeMajor,
+                    minor: rangeMinor,
+                    patch: rangePatch,
+                    preRelease: rangePreRelease == null ? void 0 : rangePreRelease.split('.')
+                };
+                // Check if the version satisfies this specific comparator in the AND chain
+                if (!compare(rangeAtom, versionAtom)) {
+                    subRangeSatisfied = false; // This part of the AND condition failed
+                    break; // No need to check further comparators in this sub-range
+                }
+            }
+            // If all AND conditions within this OR sub-range were met, the overall range is satisfied
+            if (subRangeSatisfied) {
+                return true;
+            }
+        } catch (e) {
+            // Log error and treat this sub-range as unsatisfied
+            console.error(`[semver] Error processing range part "${trimmedOrRange}":`, e);
+            continue;
         }
     }
-    return true;
+    // If none of the OR sub-ranges were satisfied
+    return false;
 }
 
 function formatShare(shareArgs, from, name, shareStrategy) {
@@ -1256,7 +1309,8 @@ let Module = class Module {
             });
             if (typeof (remoteEntryExports == null ? void 0 : remoteEntryExports.init) === 'undefined') {
                 error(getShortErrorMsg(RUNTIME_002, runtimeDescMap, {
-                    remoteName: name,
+                    hostName: this.host.name,
+                    remoteName: this.remoteInfo.name,
                     remoteEntryUrl: this.remoteInfo.entry,
                     remoteEntryKey: this.remoteInfo.entryGlobalName
                 }));
@@ -1690,9 +1744,12 @@ function snapshotPlugin() {
     return {
         name: 'snapshot-plugin',
         async afterResolve (args) {
-            const { remote, pkgNameOrAlias, expose, origin, remoteInfo } = args;
+            const { remote, pkgNameOrAlias, expose, origin, remoteInfo, id } = args;
             if (!isRemoteInfoWithEntry(remote) || !isPureRemoteEntry(remote)) {
-                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo(remote);
+                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo({
+                    moduleInfo: remote,
+                    id
+                });
                 assignRemoteInfo(remoteInfo, remoteSnapshot);
                 // preloading assets
                 const preloadOptions = {
@@ -1951,7 +2008,7 @@ const generatePreloadAssetsPlugin = function() {
 
 function getGlobalRemoteInfo(moduleInfo, origin) {
     const hostGlobalSnapshot = getGlobalSnapshotInfoByModuleInfo({
-        name: origin.options.name,
+        name: origin.name,
         version: origin.options.version
     });
     // get remote detail info from global
@@ -1976,23 +2033,8 @@ function getGlobalRemoteInfo(moduleInfo, origin) {
     };
 }
 class SnapshotHandler {
-    async loadSnapshot(moduleInfo) {
-        const { options } = this.HostInstance;
-        const { hostGlobalSnapshot, remoteSnapshot, globalSnapshot } = this.getGlobalRemoteInfo(moduleInfo);
-        const { remoteSnapshot: globalRemoteSnapshot, globalSnapshot: globalSnapshotRes } = await this.hooks.lifecycle.loadSnapshot.emit({
-            options,
-            moduleInfo,
-            hostGlobalSnapshot,
-            remoteSnapshot,
-            globalSnapshot
-        });
-        return {
-            remoteSnapshot: globalRemoteSnapshot,
-            globalSnapshot: globalSnapshotRes
-        };
-    }
     // eslint-disable-next-line max-lines-per-function
-    async loadRemoteSnapshotInfo(moduleInfo) {
+    async loadRemoteSnapshotInfo({ moduleInfo, id, expose }) {
         const { options } = this.HostInstance;
         await this.hooks.lifecycle.beforeLoadRemoteSnapshot.emit({
             options,
@@ -2079,6 +2121,8 @@ class SnapshotHandler {
             }
         }
         await this.hooks.lifecycle.afterLoadSnapshot.emit({
+            id,
+            host: this.HostInstance,
             options,
             moduleInfo,
             remoteSnapshot: mSnapshot
@@ -2616,7 +2660,9 @@ class RemoteHandler {
         await Promise.all(preloadOps.map(async (ops)=>{
             const { remote } = ops;
             const remoteInfo = getRemoteInfo(remote);
-            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo(remote);
+            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo({
+                moduleInfo: remote
+            });
             const assets = await this.hooks.lifecycle.generatePreloadAssets.emit({
                 origin: host,
                 preloadOptions: ops,
@@ -2977,7 +3023,7 @@ class FederationHost {
             // maybe will change, temporarily for internal use only
             initContainer: new AsyncWaterfallHook('initContainer')
         });
-        this.version = "0.14.3";
+        this.version = "0.16.0";
         this.moduleCache = new Map();
         this.loaderHook = new PluginSystem({
             // FIXME: may not be suitable , not open to the public yet

package/dist/src/plugins/snapshot/SnapshotHandler.d.ts

@@ -33,6 +33,8 @@ export declare class SnapshotHandler {
             from: "global" | "manifest";
         }>;
         afterLoadSnapshot: AsyncWaterfallHook<{
+            id?: string;
+            host: FederationHost;
             options: Options;
             moduleInfo: Remote;
             remoteSnapshot: ModuleInfo;
@@ -41,11 +43,11 @@ export declare class SnapshotHandler {
     loaderHook: FederationHost['loaderHook'];
     manifestLoading: Record<string, Promise<ModuleInfo>>;
     constructor(HostInstance: FederationHost);
-    loadSnapshot(moduleInfo: Remote): Promise<{
-        remoteSnapshot: GlobalModuleInfo[string] | undefined;
-        globalSnapshot: ReturnType<typeof getGlobalSnapshot>;
-    }>;
-    loadRemoteSnapshotInfo(moduleInfo: Remote): Promise<{
+    loadRemoteSnapshotInfo({ moduleInfo, id, expose, }: {
+        moduleInfo: Remote;
+        id?: string;
+        expose?: string;
+    }): Promise<{
         remoteSnapshot: ModuleInfo;
         globalSnapshot: GlobalModuleInfo;
     }> | never;

package/dist/src/type/config.d.ts

@@ -20,6 +20,7 @@ export type LoadShareExtraOptions = {
     resolver?: (sharedOptions: ShareInfos[string]) => Shared;
 };
 export interface RemoteInfo {
+    alias?: string;
     name: string;
     version?: string;
     buildVersion?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@module-federation/runtime-core",
-  "version": "0.14.3",
+  "version": "0.16.0",
   "type": "module",
   "author": "zhouxiao <codingzx@gmail.com>",
   "main": "./dist/index.cjs.cjs",
@@ -52,7 +52,7 @@
     }
   },
   "dependencies": {
-    "@module-federation/sdk": "0.14.3",
-    "@module-federation/error-codes": "0.14.3"
+    "@module-federation/sdk": "0.16.0",
+    "@module-federation/error-codes": "0.16.0"
   }
 }